Updating Firmware

Version 27.1 by Alexander Mott on 2023/12/11 21:28

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. 

Current Crestron firmware can be downloaded from Crestron's website. Old firmware releases can be downloaded using an SFTP client (such as FileZilla or WinSCP) and connecting to "ftp.crestron.com" 

Network Devices

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.

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. 

SFTP and SSH (Processors)

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. 

  • Open an SFTP client such as FileZilla or WinSCP (pictured) and connect to the processor at port 22
    sftp1.png
  • Transfer the firmware file to the "firmware" folder on the processor
    sftp2.png
  • Connect to the processor using Text Console or an SSH client such as PuTTY and run the command puf or puf -d
    sftp3.png
  • Once the puf command is run, you should see messages appear in the console indicating the status of the firmware update

Package Update Tool (.puf)

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 instead that you double-click the .puf file directly. Double-clicking a .puf file will allow you to open multiple instance of the Package Update Tool and enable updating multiple devices simultaneously. Once again, be careful when updating multiple devices simultaneously not to do anything that would disrupt your connection to a device while transferring the .puf file, nor should you do anything that could result in the device rebooting while it is mid-update.

  • Locate the firmware .puf file in Windows Explorer
  • Double-click the .puf file to open the Package Update Tool
    put1.png
  • Use the Address Book or the Pencil icon to connect to your processor and wait for it to connect
  • Verify that the correct .puf and target device are selected
    • 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
    • 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
      put2.png
  • 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
    put3.png
  • 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

Firmware Update Function

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.

  • 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: 
    • Click the Quick Functions lighting bolt icon and select "Firmware..." from the dropdown menu
    • At the top of the Toolbox window, navigate to Functions > Firmware... > Firmware...
  • Click the "Browse..." button and select the firmware .zip file
    fuf1.png
  • Click the "Send" button to begin the firmware update
    fuf2.png
  • The firmware update should be mostly complete once you see the "Please Wait... Rebooting" message disappear
  • Click the "Close" button to close the firmware button and run the ver console command to verify the update was successful

Controlled Hardware

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. 

Sub 1

Lorem

Sub 2

Lorem

Sub 2

Lorem

Zūm Wired Specific Notes

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