Click or drag to resize

17.8 How to update the card's Firmware

There are several ways to update the SP-ICE-3 Card's firmware, including:

Requirements and Preparations
Important note  Important

The card's RTC must be set to the correct date and time.

If it is not, please refer to 17.9 How to set the card's Date and Time for further instructions.

Special Notes on Firmware Downgrades

If you wish to downgrade the firmware on your SP-ICE-3 Card to an earlier API version, please be sure to use only the compatible Firmware Revisions shown in the following table, all of which are available for download from www.raylase.com.

Contact RAYLASE GmbH if your target downgrade API version is not listed.

Firmware Downgrade Compatibility

Target API
Version

Firmware
Revision

1.38 onwards

1.38.0 (or later)

1.37

1.37.2 (or later)

1.36

1.36.2 (or later)

1.35

1.35.4 (or later)

1.34

1.34.5 (or later)

1.33 or earlier

Contact RAYLASE GmbH.

Update via the card's Web Interface

  1. Locate or otherwise obtain your Firmware Update Package.

  2. Open the card's Web Interface by following the procedure 17.2 How to Open the Card's Web Interface.

  3. Select the UPDATE page.

    SP-ICE-3 Web Interface-Update

  4. Click the Browse... button, use the ensuing Upload File dialog to select the Firmware Update Package.

  5. Click the Start update button to transfer the Firware Update Package to the card and begin the update process.

  6. On the card, the update process will now run for about 25 minutes.

  7. If you see the following error message, click OK to return to the update package selection dialog.

    SP-ICE-3 Web Interface-Unable To Update

When the update process has finished, the card will automatically reboot and run the updated firmware.

Update via SFTP/SSH-Login

  1. Locate or otherwise obtain your Firmware Update Package.

  2. Using your favourite SFTP-Client, transfer the Update Package to the card's /var/updates directory.

  3. Rename the package file to update.tar.bz2 (if necessary).

  4. Using your favourite SSH-Client, log in on the card:

    login as: spice3
    Password: raylase

  5. Retrieve the PID of the Update-Daemon by issuing the following command:

    spice3card:~$ cat /media/fat/log/update.spice3.log | grep -i "PID of Update Daemon" | tail -n 1

    Choose the PID value shown at the end of the last (or only) line containing PID of Update Daemon = .

  6. Trigger the update procedure with the following command:

    spice3card:~$ sudo kill -HUP PID

    If you are prompted for a password:

    Password: raylase

  7. The actual update process on the card will now run for several minutes.

    You can follow its progress by issuing this command:

    spice3card:~$ tail -f /media/fat/log/update.spice3.log

When the update process has finished, the card will automatically reboot and run the updated firmware.

Update by SD-Card Replacement

  1. Locate or otherwise obtain the replacement SD-Card containing updated firmware.

  2. Power off the SP-ICE-3 Card.

  3. Remove the existing SD-Card from the slot on the SP-ICE-3 Card.[Note 1]

  4. Insert the replacement SD-Card in the slot.

  5. Power up the SP-ICE-3.

The card will boot and run the updated firmware.

Notes

  1. Bearing in mind that all custom data are stored on the SD-Card's DATA partition, you might want to consider your backup or transfer options before simply committing the old SD-Card to the bit-bucket.