Skip to main content

Site Navigation

Your Account

Choose Language

Help

Revision to Installing and Updating Firmware

Tony

 
 
Note: some updates to the main firmware may require an update to the a compatible WiFi server firmware version as well, and vice versa. See the [[Installing and Updating Firmware#Section_Updating_WiFi_firmware_or_DuetWebControl_files|updating WiFi firmware or DuetWebControl files section]] below which explains how on how to do this. '''If== Notes before you download more than just the main firmware (DuetWiFiFirmware.bin/Duet2CombinedFirmware.bin) then please read the [[Installing and Updating Firmware#Section_Updating_more_than_one_firmware_at_a_time|updating more than one firmware at a time section]] below before proceeding as the firmware needs to be updated in a specific order. '''start ==
Note: some updates to the main firmware may require an update to the a compatible WiFi server firmware version as well, and vice versa. See the [[Installing and Updating Firmware#Section_Updating_WiFi_firmware_or_DuetWebControl_files|updating WiFi firmware or DuetWebControl files section]] below which explains how on how to do this. '''If== Notes before you download more than just the main firmware (DuetWiFiFirmware.bin/Duet2CombinedFirmware.bin) then please read the [[Installing and Updating Firmware#Section_Updating_more_than_one_firmware_at_a_time|updating more than one firmware at a time section]] below before proceeding as the firmware needs to be updated in a specific order. '''start ==
 
Check* Some updates to the main firmware may require an update to the a compatible WiFi server firmware version as well, and vice versa.
** See the [[Installing and Updating Firmware#Section_Updating_WiFi_firmware_or_DuetWebControl_files|updating WiFi firmware or DuetWebControl files section]] below which explains how on how to do this. ** '''If you download more than just the main firmware (DuetWiFiFirmware.bin/Duet2CombinedFirmware.bin) then please read the [[Installing and Updating Firmware#Section_Updating_more_than_one_firmware_at_a_time|updating more than one firmware at a time section]] below before proceeding as the firmware needs to be updated in a specific order. '''
* Check
you have [https://github.com/dc42/RepRapFirmware/releases|downloaded the correct firmware] before installing it. The DuetWiFiFirmware.bin file should be the same size as shown on the github (currently about 300 KB in size).
Check* Some updates to the main firmware may require an update to the a compatible WiFi server firmware version as well, and vice versa.
** See the [[Installing and Updating Firmware#Section_Updating_WiFi_firmware_or_DuetWebControl_files|updating WiFi firmware or DuetWebControl files section]] below which explains how on how to do this. ** '''If you download more than just the main firmware (DuetWiFiFirmware.bin/Duet2CombinedFirmware.bin) then please read the [[Installing and Updating Firmware#Section_Updating_more_than_one_firmware_at_a_time|updating more than one firmware at a time section]] below before proceeding as the firmware needs to be updated in a specific order. '''
* Check
you have [https://github.com/dc42/RepRapFirmware/releases|downloaded the correct firmware] before installing it. The DuetWiFiFirmware.bin file should be the same size as shown on the github (currently about 300 KB in size).
 
[image|421|size=large|align=center]
 
Make* Make sure you download and save the file as bin or zip and check the files sizes match.

Ensure

* Ensure
you read the "[https://github.com/dc42/RepRapFirmware/blob/dev/WHATS_NEW.md|Whats New]" notices for the new version of the firmware as it will contain information on changes that effect your configuration.
Make* Make sure you download and save the file as bin or zip and check the files sizes match.

Ensure

* Ensure
you read the "[https://github.com/dc42/RepRapFirmware/blob/dev/WHATS_NEW.md|Whats New]" notices for the new version of the firmware as it will contain information on changes that effect your configuration.
 
== Usual procedure ==
 
NOTE: Upgrading a Duet WiFi2 Wifi from 1.18.2 or earlier firmware to 1.19 or later firmware required a special procedure. See '''Upgrading to 1.19 or later''' lower down this page.
NOTE: Upgrading a Duet WiFi2 Wifi from 1.18.2 or earlier firmware to 1.19 or later firmware required a special procedure. See '''Upgrading to 1.19 or later''' lower down this page.
 
Upgrading a Duet WiFi2 Wifi or Duet 2 Ethernet from 1.20 or earlier firmware to 1.21 or later requires a file to be renamed. See '''Upgrading to 1.21 or later''' lower down this page.
Upgrading a Duet WiFi2 Wifi or Duet 2 Ethernet from 1.20 or earlier firmware to 1.21 or later requires a file to be renamed. See '''Upgrading to 1.21 or later''' lower down this page.
 
* Connect DuetWebControl.
* Take the on-board SD card out and put it in a computer,
* Copy the new '''DuetWiFiFirmware.bin''' file to the '''/sys''' folder. It must be called exactly '''DuetWiFiFirmware.bin''' on the SD card. Also make sure that file '''iap4e.bin''' is present in '''/sys'''.
* Replace the on-board SD card in the DuetWiFiDuet 2 WiFi
* Restart the DuetWiFiDuet 2 WiFi and connect with Pronterface
* Replace the on-board SD card in the DuetWiFiDuet 2 WiFi
* Restart the DuetWiFiDuet 2 WiFi and connect with Pronterface
* Send command '''M997 S0''' to install the firmware.
* Press the Disconnect button in Pronterface, then when the USB port disappears and reappears about 20 seconds later, press Connect.
* Use a text editor to comment out the '''M552 S1''' command in '''config.g'''.
* Save the file and eject the on-board SD card
* Put the on-board SD card back in the Duet WiFi2
* Start the Duet WiFi2 and see if you can connect Pronterface or a terminal emulator. If so, continue with Fallback Procedure #1.
* Put the on-board SD card back in the Duet WiFi2
* Start the Duet WiFi2 and see if you can connect Pronterface or a terminal emulator. If so, continue with Fallback Procedure #1.
 
== Fallback procedure #3 ==
 
'''Only use this if the firmware on the Duet WiFi2 has been corrupted, or if you have accidentally pressed the Erase button, so you can’t connect over USB with Pronterface even with WiFi disabled in config.g.'''
'''Only use this if the firmware on the Duet WiFi2 has been corrupted, or if you have accidentally pressed the Erase button, so you can’t connect over USB with Pronterface even with WiFi disabled in config.g.'''
 
Before proceeding, connect the Duet to your PC using a USB cable and check whether the Duet is visible in the port list. Under Windows you can do this by going to '''Device Manager''' and expanding '''Ports (COM and LPT)'''. If '''Duet 3D printer electronics''' is listed, you should be able to connect using Pronterface or YAT unless some other program is already using the port. If '''Bossa Port''' is listed then the firmware has already been erased. If neither is listed:
You will need a Windows or Linux PC.
 
* Download the main firmware file (DuetWiFiFirmware.binfrom https://github.com/dc42/RepRapFirmware/releases.:
** For version 1.20 and earlier use DuetWiFiFirmware.bin
for the Duet WiFi2 Wifi, DuetEthernetFirmware.bin for the Duet Ethernet) from https://github.com/dc42/RepRapFirmware/releases.2 Ethernet.
** For version 1.21 or later (recommended) use Duet2CombinedFirmware.bin for Duet 2 Wifi or Ethernet
* Download the main firmware file (DuetWiFiFirmware.binfrom https://github.com/dc42/RepRapFirmware/releases.:
** For version 1.20 and earlier use DuetWiFiFirmware.bin
for the Duet WiFi2 Wifi, DuetEthernetFirmware.bin for the Duet Ethernet) from https://github.com/dc42/RepRapFirmware/releases.2 Ethernet.
** For version 1.21 or later (recommended) use Duet2CombinedFirmware.bin for Duet 2 Wifi or Ethernet
* Verify that the downloaded firmware file has the correct size, as shown on the page you downloaded it from.
* Download and install SAM-BA version 2.17 from here http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=Atmel%20SAM-BA%20In-system%20Programmer
* Connect the Duet WiFi2 to your PC via USB. PressErase the '''Erase''' buttonfirmware on the Duet WiFi,2 by either:
** Pressing the '''Erase''' button for pcb revisions 1.03 or earlier

[image|1035|align=center]

* Jumpering the erase jumper for pcb revisions 1.04 and later.

[image|1036|align=center]

*
then the '''Reset''' button.
* Connect the Duet WiFi2 to your PC via USB. PressErase the '''Erase''' buttonfirmware on the Duet WiFi,2 by either:
** Pressing the '''Erase''' button for pcb revisions 1.03 or earlier

[image|1035|align=center]

* Jumpering the erase jumper for pcb revisions 1.04 and later.

[image|1036|align=center]

*
then the '''Reset''' button.
* Load SAM-BA. It usually detects the correct COM port automatically. Select board '''at91sam4e8-ek'''. Press '''Connect'''.
 
== Updating WiFi firmware or DuetWebControl files ==
 
'''Important:''' if you are also upgrading RepRapFirmware (which for the Duet 2 WiFi is the DuetWiFiFirmware.bin file DuetWiFiFirmware.bin for version 1.20 or earlier and Duet2CombinedFirmware.bin for 1.21 and later) you should normally upgrade that first.
'''Important:''' if you are also upgrading RepRapFirmware (which for the Duet 2 WiFi is the DuetWiFiFirmware.bin file DuetWiFiFirmware.bin for version 1.20 or earlier and Duet2CombinedFirmware.bin for 1.21 and later) you should normally upgrade that first.
 
'''Note''', this does not apply to the Duet 2 Ethernet.
'''Note''', this does not apply to the Duet 2 Ethernet.
 
=== Updating WiFi firmware ===
=== Updating DuetWebControl files ===
 
==== If your Duet 2 WiFi is running main firmware 1.19 or later: ====
==== If your Duet 2 WiFi is running main firmware 1.19 or later: ====
 
* Upload the new '''DuetWebControl.zip''' file through the General tab on the Settings page of DuetWebControl.
* If the web interface is not working, then move the SD card to a PC, delete or rename any existing /www folder, create a new one, and extract the contents of DuetWebControl.zip into it. Do not unzip the individual .gz files, leave them as they are on the SD card.
 
==== If your Duet 2 WiFi is running firmware 1.18 or earlier: ====

''Note we recommend upgrading to 1.21 or later stable firmware, these steps will work but later versions of DWC will have compatibility issues with older firmware''
==== If your Duet 2 WiFi is running firmware 1.18 or earlier: ====

''Note we recommend upgrading to 1.21 or later stable firmware, these steps will work but later versions of DWC will have compatibility issues with older firmware''
 
* Upload the new '''DuetWebControl.bin''' file to the /sys folder on the on-board SD card, either through the General tab on the Settings page of DuetWebControl or by moving the SD card to a PC.
== Updating more than one firmware at a time ==
 
If you need to upgrade more than one of DuetWiFiFirmware/DuetEthernetFirmware, DuetWiFiServer and Duet WebControlWeb Control, do them in this order:
If you need to upgrade more than one of DuetWiFiFirmware/DuetEthernetFirmware, DuetWiFiServer and Duet WebControlWeb Control, do them in this order:
 
# DuetWiFiFirmwareDuetWiFiFirmware, DuetEthernetFirmware (pre release 1.21) or DuetEthernetFirmwareDuet2CombinedFirmware (release 1.21 or later)
# DuetWiFiServer ''(Duet 2 WiFi only)''
# DuetWiFiFirmwareDuetWiFiFirmware, DuetEthernetFirmware (pre release 1.21) or DuetEthernetFirmwareDuet2CombinedFirmware (release 1.21 or later)
# DuetWiFiServer ''(Duet 2 WiFi only)''
# DuetWebControl
 
* Use the M997 command to install them all at once, specifying which firmwares you want to update in the S parameter. For example, M997 S0:1:2 will update all firmwares, provided that all the firmware files and iap4e.bin are present in /sys on the SD card.
 
== Upgrading a Duet WiFi2 Wifi to firmware 1.19 or later from 1.18.2 or earlier ==
== Upgrading a Duet WiFi2 Wifi to firmware 1.19 or later from 1.18.2 or earlier ==
 
In firmware version 1.19 for the Duet 2 WiFi the webserver functionality has been moved off the wifiWifi module onto the Duet main processor. This means that the updates to the main firmware and the wifiWifi firmware need to be synchronised, and the DuetWebControl files are read from the SD card instead of being uploaded to the WiFiWifi module. Also the network SSID and password are sent to the WiFi module using gcodes. So upgrading from earlier firmware versions is not as straightforward as usual.
In firmware version 1.19 for the Duet 2 WiFi the webserver functionality has been moved off the wifiWifi module onto the Duet main processor. This means that the updates to the main firmware and the wifiWifi firmware need to be synchronised, and the DuetWebControl files are read from the SD card instead of being uploaded to the WiFiWifi module. Also the network SSID and password are sent to the WiFi module using gcodes. So upgrading from earlier firmware versions is not as straightforward as usual.
 
If you are already running 1.19beta or RC version of DuetWiFiFirmware and DuetWiFiServer, you can upgrade them the 1.19 release individually through the web interface in the usual way.
=== Getting ready to upgrade ===
 
Get ready to upgrade the Duet 2 WiFi by putting the following files on the SD card:
Get ready to upgrade the Duet 2 WiFi by putting the following files on the SD card:
 
* The contents of DuetWebControl-1.19.zip, extracted into the '''/www''' folder. Existing versions of DWC won't let you upload a file called DuetWebControl*.zip to a Duet 2 WiFi, so you will either have to do this on a PC, or you can rename it to e.g. DWC.zip and then it should upload. If there is a '''/www''' folder already on the SD card, I recommend you delete it and create a new one.
* The contents of DuetWebControl-1.19.zip, extracted into the '''/www''' folder. Existing versions of DWC won't let you upload a file called DuetWebControl*.zip to a Duet 2 WiFi, so you will either have to do this on a PC, or you can rename it to e.g. DWC.zip and then it should upload. If there is a '''/www''' folder already on the SD card, I recommend you delete it and create a new one.
* DuetWiFiFirmware-1.19.bin, copied into '''/sys''' and renamed to exactly DuetWiFiFirmware.bin. If you wish, you can upload this through the web interface, but decline the offer to install it.
* DuetWiFiServer-1.19.bin, copied into '''/sys''' and renamed to exactly DuetWiFiServer.bin. If you wish, you can upload this through the web interface, but decline the offer to install it.
You will need to do a simultaneous installation of DuetWiFiFirmware-1.18.2.bin and DuetWiFiServer-1.03ch.bin. You should not need to re-install DuetWebControl.bin because it should still be resident on the WiFi module. You do not need to roll back the Windows USB driver, because the newer driver versions are compatible with older firmware versions too.
 
== Upgrading a Duet 2 WiFi or Ethernet to firmware 1.21 or later from 1.20 or earlier ==
== Upgrading a Duet 2 WiFi or Ethernet to firmware 1.21 or later from 1.20 or earlier ==
 
In firmware 1.21 and later, the Duet 2 WiFi and Duet 2 Ethernet use a common firmware binary file, which is named Duet2CombinedFirmware.bin. However, if the current firmware on your Duet is 1.20 or earlier then it won't recognise that name as being a valid firmware binary. Therefore, after downloading Duet2CombinedFirmware.bin, rename it to DuetWiFiFirmware.bin or DuetEthernetFirmware.bin (as appropriate for your board) and then upload it.
In firmware 1.21 and later, the Duet 2 WiFi and Duet 2 Ethernet use a common firmware binary file, which is named Duet2CombinedFirmware.bin. However, if the current firmware on your Duet is 1.20 or earlier then it won't recognise that name as being a valid firmware binary. Therefore, after downloading Duet2CombinedFirmware.bin, rename it to DuetWiFiFirmware.bin or DuetEthernetFirmware.bin (as appropriate for your board) and then upload it.
 
If you have an older Duet WiFi2 board then you should also upgrade the iap4e.bin file to the current version, to ensure that future firmware upgrades go smoothly.
If you have an older Duet WiFi2 board then you should also upgrade the iap4e.bin file to the current version, to ensure that future firmware upgrades go smoothly.
 
== How to recover if the main firmware and WiFi firmware versions get out of step on your Duet 2 WiFi ==
== How to recover if the main firmware and WiFi firmware versions get out of step on your Duet 2 WiFi ==
 
If you install incompatible main firmware (DuetWiFiFirmware.bin) and WiFi server (DuetWiFiServer.bin) versions, then you will not be able to connect over WiFi, and when the WiFi module is enabled you might not be able to communicate via USB either. Here's how to recover.
* Hopefully you will see "Duet 3D Printer electronics" and you can proceed to the next step.
* If instead you see "Bossa port" then you have pressed the Erase button, and you will need to install new main firmware via USB. See Fallback procedure #3 higher up.
* If you see no port at all, go to [guide|2|what to do if your Duet or Duet WiFi2 Wifi won't respond].
* If you see no port at all, go to [guide|2|what to do if your Duet or Duet WiFi2 Wifi won't respond].
 
=== Update main firmware, if needed ===

To undo the changes made by this version, click 'Revert Changes.' This will automatically restore the previous version of this guide.

Revert Changes