Changes for page Updating Firmware

Last modified by Alexander Mott on 2024/10/15 14:55
From version 2.10
edited by Alexander Mott
on 2023/12/11 19:14
Change comment: (Autosaved)
To version 34.2
edited by Alexander Mott
on 2024/10/15 13:57
Change comment: There is no comment for this version

Summary

Details

Page properties
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -2,36 +2,97 @@
2 2  {{toc/}}
3 3  {{/box}}
4 4  
5 -ShowRunnerCLC™ is tested against the latest Crestron firmware releases, and as such it is recommended to update all device firmware whenever starting up a job. While firmware updates can be performed at any time, it is typically recommended to update network devices after their network settings have been configured (to take advantage of increased file transfer speed over Ethernet compared to USB), but before loading the ShowRunnerCLC™ program and starting up the job (to avoid any potential bugs that may result from using outdated firmware).
5 +ShowRunnerCLC™ is tested against the latest Crestron firmware releases, and as such it is recommended to update all device firmware whenever starting up a job. While firmware updates can be performed at any time, it is recommended to update network devices after their network settings have been configured but before loading the ShowRunnerCLC™ program and starting up the job in order to avoid any potential bugs that may result from using outdated firmware. Controlled hardware should be updated once all devices on any given Cresnet/ZUMLINK bus or wireless gateway are online and uniquely addressed. Any communication issues on the bus or gateway should also be resolved prior to updating firmware.
6 6  
7 +Current Crestron firmware can be downloaded from [[Crestron's website>>https://www.crestron.com/Support/Search-Results?c=4]]. Old firmware releases can be downloaded using an SFTP client (such as FileZilla or WinSCP) and connecting to "ftp.crestron.com" using your Crestron credentials.
8 +
7 7  = Network Devices =
8 8  
9 -Networked devices (i.e. devices connected to the LAN or Control Subnet)
11 +Networked devices (i.e. devices connected via Ethernet to the LAN or Control Subnet) should always be updated when starting up a job. You can check the current firmware version of most network devices by running the ##ver## command in Text Console or by exporting a Device Summary using the Device Discovery Tool.
10 10  
11 -== Sub 1 ==
13 +While these devices can be updated over USB, it is recommended to update these devices over Ethernet whenever possible in order to take advantage of increased file transfer speed of Ethernet and to enable updating multiple devices at once. Since most network devices will reboot as a part of the firmware update process, **it is important to be mindful of the order in which devices are updated to avoid losing connection to a device while in the middle of a file transfer**. For example, if you have several CEN-GWEXERs that are connected to a CEN-SWPOE-16, it is important to either update the CEN-SWPOE-16 //before// starting the update for any of the CEN-GWEXERs, **or** wait to update the CEN-SWPOE-16 until //after// all of the CEN-GWEXERs are done updating. If you update all devices simultaneously, you risk damage to the CEN-GWEXERs as a result of losing power mid-update due to the CEN-SWPOE-16 rebooting.
12 12  
13 -Lorem
15 +== SFTP and SSH (Processors) ==
14 14  
15 -== Sub 2 ==
17 +Due to the large file size for processor firmware, the most efficient method of updating firmware is to use dedicated third-party SFTP and SSH clients rather than built-in Toolbox functions. This allows for rapidly transferring the large firmware file to the device and then running the update without locking up Toolbox and preventing you from working on other devices while the firmware update is performed.
16 16  
17 -Lorem
19 +* Open an SFTP client such as FileZilla or WinSCP (pictured) and connect to the processor at port 22
20 +[[image:sftp1.png||height="309" width="507"]]
21 +* Transfer the firmware file to the "firmware" folder on the processor
22 +[[image:sftp2.png||height="307" width="505"]]
23 +* Connect to the processor using Text Console or an SSH client such as PuTTY and run the command ##puf## or ##puf -d##
24 +[[image:sftp3.png||height="307" width="502"]]
25 +* Once the ##puf## command is run, you should see messages appear in the console indicating the status of the firmware update
18 18  
19 -== Sub 2 ==
27 +== Package Update Tool (.puf) ==
20 20  
21 -Lorem
29 +Crestron's Package Update Tool is the most convenient way of performing firmware updates for devices that use .puf files for firmware. The Package Update Tool can be opened from Toolbox, but doing this will lock Toolbox and only allow updating one device at a time, so we recommend closing Toolbox (or at least closing any Toolbox connections to devices that you intend to update) and double-clicking the .puf file to open the Package Update Tool in a separate window. Double-clicking a .puf file will allow you to open multiple instance of the Package Update Tool and enable updating multiple devices simultaneously. **Exercise caution when updating firmware for multiple devices simultaneously, as some devices will reboot as part of the update process which may disrupt connection to downstream devices.**
22 22  
31 +* Locate the firmware .puf file in Windows Explorer
32 +* Double-click the .puf file to open the Package Update Tool
33 +[[image:put1.png||height="386" width="416"]]
34 +* Use the Address Book or the Pencil icon to connect to your processor and wait for it to connect
35 +* Verify that the correct .puf and target device are selected
36 +** Verify the information under "Package Info" matches what is expected for the desired firmware, and re-select the .puf using the "Select..." button if the information is incorrect
37 +** Verify that the information under "Target" matches the device to be updated, and re-select the device using the Address Book or Pencil icon if it is incorrect
38 +[[image:put2.png||height="365" width="393"]]
39 +* Once you have verified all the information is correct and the Package Update Tool has run its check to see that the firmware is compatible with the device, click the "Update" button to begin the update
40 +[[image:put3.png||height="340" width="366"]]
41 +* The Package Update Tool will notify you of when it is safe to close, but it is recommended to stay connected if possible in order to verify that the firmware update has been completed successfully
42 +[[image:put4.png||height="336" width="362"]]
43 +
44 +== Firmware Update Function ==
45 +
46 +While most networked devices will use .puf files for firmware updates, some devices (such as DIN-DALI-2) will use .zip files. In these instances, the Package Update Tool will not work to update the firmware and you must instead use the "Functions..." menu to select and load the firmware.
47 +
48 +* Connect to the device to be updated in Toolbox using a tool such as Text Console and open the Firmware dialog using one of the methods below: 
49 +** Click the Quick Functions lighting bolt icon and select "Firmware..." from the dropdown menu
50 +** At the top of the Toolbox window, navigate to Functions > Firmware... > Firmware...
51 +* Click the "Browse..." button and select the firmware .zip file
52 +[[image:fuf1.png||height="222" width="547"]]
53 +* Click the "Send" button to begin the firmware update
54 +[[image:fuf2.png||height="218" width="540"]]
55 +* The firmware update should be mostly complete once you see the "Please Wait... Rebooting" message disappear
56 +* Click the "Close" button to close the firmware button and run the ##ver## console command to verify the update was successful
57 +
23 23  = Controlled Hardware =
24 24  
25 -Lorem
60 +Controlled hardware such as Cresnet and infinetEX devices are less frequently updated, but nonetheless will occasionally require firmware updates. ZUMLINK devices should always be updated, but these devices are automatically updated whenever their host ZUMNET device is updated as long as the ZUMLINK device is online and uniquely addressed.
26 26  
27 -== Sub 1 ==
62 +== Network Device Tree View ==
28 28  
29 -Lorem
64 +Updating individual devices can be accomplished in Toolbox using Network Device Tree View, provided that the devices are uniquely addressed and there are no Cresnet wiring or wireless gateway connectivity issues:
30 30  
31 -== Sub 2 ==
66 +* Open Network Device Tree View in Toolbox and connect to the host device (i.e. the processor, DIN-CENCN-2, or gateway) for the devices that need to be updated
67 +[[image:ndtv1.png||height="299" width="416"]]
68 +* Locate the device you want to update and ensure that it is addressed uniquely
69 +** The device should have a yellow "OK" circle icon
70 +** If there is a red "Duplicate Network ID" icon, resolve the duplicate network ID by changing the device address
71 +** If there is a black "Invalid TSID" or "Duplicate TSID" icon, verify that there are no wiring issues on the Cresnet bus and resolve the duplicate/invalid TSID
72 +* Right-click the device to be updated to open the Firmware Update window
73 +[[image:ndtv2.png||height="463" width="415"]]
74 +* Click the "Browse" button on the lower right or the "Verified" checkbox under the "Status" column to open a file selection prompt and select the downloaded firmware .zip file
75 +[[image:ndtv3.png||height="257" width="513"]]
76 +* Once the correct firmware file is selected and the "Verified" checkbox has a checkmark in it, click the "Update" button on the lower right
77 +[[image:ndtv4.png||height="257" width="513"]]
78 +* The progress bar in the "Progress" column should slowly fill up as the firmware update is executed
79 +** The progress bar should read 100% if the firmware update is completed successfully
80 +** If the progress bar does not get to 100% completion and reports failed, you can try again
81 +** If the firmware fails to update multiple times, then it may be necessary to try restarting the host device, isolating the device to be updated, or performing other troubleshooting to ensure that there are no wiring issues or issues with the specific device caused by poor installation, damage during shipping, or factory defects
32 32  
33 -Lorem
83 += Zūm Wired Specific Notes =
34 34  
35 -== Sub 2 ==
85 +Zūm Wired devices are unique among Crestron devices in the fact that the Zūm Link (controlled hardware) device firmware is built into the Zūm Net (networked device) firmware files, and these Zūm Link devices will be updated whenever the host Zūm Net device is updated (with a few caveats mentioned below). While the firmware files for individual Zūm Link devices can be extracted from the "zum-wired_XXX.puf" file using archive tools such as 7-Zip, it is still generally recommended to update Zūm Link firmware using the Package Update Tool whenever possible.
36 36  
37 -Lorem
87 +Caveats for updating Zūm Wired devices:
88 +
89 +* **All Zūm Link devices must be uniquely addressed**
90 +** Setting the Zūm Net device to primary mode using the command ##zwps primary## will allow it to discover all connected Zūm Link devices
91 +** Setting the Zūm Net device to App/Zūm mode using the command ##zwmode zum## will cause it to reboot and re-address all connected Zūm Link devices
92 +* **All Zūm Link devices should be online before performing firmware updates**
93 +** Ensuring that all devices are online saves time by allowing you to perform the firmware update only once as well as avoids any issues that may be caused by incorrect Zūm Link wiring
94 +** Any Zūm Link wiring issues on a given Zūm Net device must be resolved prior to updating the Zūm Wired firmware
95 +* ZUMNET-JBOX-* devices will reboot as part of the firmware update process; since ZUMNET-JBOX-* devices are typically daisy chained, this means that connectivity with downstream devices will be lost momentarily
96 +** While we have not seen damage to devices as a result of this, it does mean that sometimes the firmware fails to transfer and the firmware update needs to be restarted on the devices where connectivity was lost
97 +* Zūm Link devices can still be updated directly (without updating firmware for the Zūm Net box) using the Network Device Tree View method mentioned above
98 +** Note that the individual Zūm Link firmware will need to be extracted from the "zum-wired_XXX.puf" file in order to load it
1702319634460-252.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,1 +1,0 @@
1 -12.4 KB
Content
1702330126400-306.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +11.7 KB
Content
fuf1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +6.7 KB
Content
fuf2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +9.9 KB
Content
ndtv1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +33.1 KB
Content
ndtv2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +56.0 KB
Content
ndtv3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +16.3 KB
Content
ndtv4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +15.4 KB
Content
put1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +9.5 KB
Content
put2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +12.4 KB
Content
put3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +11.7 KB
Content
put4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +11.7 KB
Content
sftp1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +44.9 KB
Content
sftp2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +32.6 KB
Content
sftp3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +23.4 KB
Content