Update the DAL OS system firmware

Digi’s DAL OS firmware for Digi devices provides a managed, secure embedded operating system foundation that supports scheduled and ad-hoc updates to ensure device integrity and performance over time. DAL OS firmware can be updated locally using the device’s DAL OS Web UI console or the CLI console. Devices can be updated locally or remotely using Digi Remote Manager, which enables local updates on individual devices through the DAL OS Web UI or CLI consoles, and remote updates across multiple devices simultaneously using templates. For more information about updating firmware using Digi Remote Manager, see About the DAL OS firmware in the Cellular documentation portal.

The Connect EZ operating system firmware images consist of a single file with the following naming convention:

platform-version.bin

For example, Connect EZ-25.2.54.xxx

Updating from EZ01-M000 revision Z or earlier

All Digi Connect EZ devices built as EZ01-M000 rev Z or earlier must have the bootloader updated in order to update to firmware 24.12.153.123 (or beyond). Rev Z units were built with firmware 24.9.79.162.

To update the bootloader, load the firmware image 24.12.153.1 (82004807_A.bin) following the standard OS firmware update mechanism. This update changes only the “bootloader version” of the device (to 24.12.153.0). The running OS and all settings on the device remain the same.

To get the firmware image 24.12.153.1 (82004807_A.bin), navigate to the Connect EZ Mini firmware support page.

Python and DAL OS firmware updates

Make sure to check the Python version you are using and that it is compatible with the DAL OS firmware version to which you want to update. You may need to update any Python scripts you have so they are compatible with the Python running on the DAL OS firmware version you choose. See Python versions and corresponding DAL OS firmware versions.

Certificate management for firmware images

The system firmware files are signed to ensure that only Digi-approved firmware load onto the device. The Connect EZ device validates the system firmware image as part of the update process and only successfully updates if the system firmware image can be authenticated.

Downgrading

Downgrading to an earlier release of the firmware may result in the device configuration being erased.

Downgrading from firmware version 22.2.9.x

Beginning with firmware version 22.2.9.x, the Connect EZ device uses certificate-based communication for enhanced security when connecting to Digi Remote Manager. If you downgrade your firmware from version 22.2.9.x to version 21.11.x or previous, your device will no longer be able to communicate with Remote Manager.

To remedy this issue, select the device in Remote Manager and select Actions > Reset Device Certificate.



  Web

  1. Download the Connect EZ operating system firmware from the Digi Support FTP site to your local machine.

    2. Log into the WebUI as a user with full Admin access rights.

  2. On the main menu, click System. Under Administration, click Firmware Update.

  3. Click Choose file.
  4. Browse to the location of the firmware on your local file system and select the file.
  5. Click Update Firmware.

  1. Download the Connect EZ operating system firmware from the Digi Support FTP site to your local machine.
  2. Select the device in Remote Manager and click Actions > Open Console, or log into the Connect EZ local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  3. Load the firmware image onto the device. We recommend using the /tmp directory.
    4. > scp host hostname-or-ip user username remote remote-path local local-path to local

    where:

    • hostname-or-ip is the hostname or IP address of the remote host.
    • username is the name of the user on the remote host.
    • remote-path is the path and filename of the file on the remote host that will be copied to the Connect EZ device.
    • local-path is the location on the Connect EZ device where the copied file will be placed.

    For example: 

    > scp host 192.168.4.1 user admin remote /home/admin/bin/Connect EZ-26.10.48.00.bin local /tmp/ to local
admin@192.168.4.1's password: adminpwd 
Connect EZ-26.10.48.00.bin			100%	36MB	11.1MB/s	00:03
>
  4. Verify that the firmware file has been successfully uploaded to the device:
    > ls /tmp
-rw-r--r--    1 root     root      37511229 May 16 20:10 Connect EZ-26.10.48.00.bin
-rw-r--r--    1 root     root          2580 May 16 16:44 blank.json
...
>
  5. Update the firmware by entering the system firmware update command, specifying the path and file name to the firmware file:
    > system firmware update file /tmp/Connect EZ-26.10.48.00.bin
36632K
netflash: got "/tmp/Connect EZ-26.10.48.00.bin", length=37511229
netflash: authentication successful
netflash: programming FLASH device /dev/flash/image
36633K 100%
Firmware update completed, reboot device
>
  6. Reboot the device to run the new firmware image using the reboot command. 
    > reboot
Rebooting system
>
  7. Once the device has rebooted, log into the Connect EZ's command line as a user with Admin access and verify the running firmware version by entering the show system command. 
    > show system

 Hostname                 : Connect EZ
 FW Version               : 26.10.48.00
 MAC                      : 0040FF800120
 Model                    : Digi Connect EZ
 Current Time             : Thu, Jan 11, 2024 12:10:00 +0000
 Uptime                   : 42 seconds (42s)

>