Updating your SIM Firmware & Cargo from Removable Media

From Serious Documentation
Jump to: navigation, search

Supported Platforms by Release

Starting with the 5.0.211 firmware release, Serious began introducing the ability to upgrade firmware, splash images, and GUI cargo file via removable media -- not just from the SHIPTide tools.

Platform SIM115 SIM225 SIM231 SIM243 SIM535 SIM543 SIM553 SIM853
USB Host x x x x x x x x
SD Card x
microSD Card x x

File Names and Locations

All files must be in the proper path of the removable media. The names are fixed as follows:

File Name Content Type
SHIPAPPL.shp SHIPEngine or installer application .shp SHIP Firmware Executable
SHIPTUGB.shp SHIPTug full-featured boot loader .shp SHIP Firmware Executable
SHIPPADD.shp SHIPPaddle early stage boot loader .shp SHIP Firmware Executable
SHIPBOOT.shp Booting splash image Serious Image Format from SHIPTide
SHIPAPPL.shp Application/GUI loading splash image Serious Image Format from SHIPTide
SHIPUPDT.shp Firmware updating splash image Serious Image Format from SHIPTide
SHIPERRR.shp Error splash image Serious Image Format from SHIPTide
SHIPREMV.shp Remove media now splash image Serious Image Format from SHIPTide

Update Process

Removable media updates can only be performed from the SHIPTug boot loader.

In SHIPEngine, when media is inserted (e.g. a thumb drive is plugged in or an SD Card inserted), SHIPEngine scans the media for any of these files. If any of these files exist on the media, the GUI is halted and the system is rebooted. As part of the SHIPv5 Boot System, the SHIPTug boot loader is then executed.

In SHIPTug any inserted media is (re)scanned for the presence of any update files. If they do not exist, the normal boot process will continue.

If any of the named files exist, the OEM-created "update" splash image (SHIPUPDT.shp) will be displayed if it exists, then the update process will proceed.

In the update process, the files, one by one, will be copied over to the SIM. Each file will be stored in the appropriate place on the SIM for its type, which may vary by SIM.

When the update process is complete, the OEM-created "remove" splash image (SHIPREMV.shp) will be displayed if it exists, otherwise a fixed English language only prompt will be displayed, indicating to the operator to remove the media. The system will not continue until this is performed.

When the media is removed, the system will automatically reboot and use any new files uploaded.

Preventing/Controlling Auto-Updates

Since Bridge Version 2, locked files will not be considered for update.