SIM Firmware and Cargo Update from Removable Media (v5.0)

From Serious Documentation
Revision as of 22:01, 16 November 2017 by CarltonHeyer (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

File Names and Locations

These are the files involved in a Cargo and/or Firmware Update via removable media. All files must be in root directory of the removable media. The names are fixed as follows:

File Name Description
SHIPCARG.car The GUI definition file parsed by SHIPEngine
SHIPBOOT.shi Booting splash image in a Serious Image Format from SHIPTide
SHIPAPPL.shi Application/GUI loading splash image in a Serious Image Format from SHIPTide
SHIPUPDT.shi Firmware updating splash image in a Serious Image Format from SHIPTide
SHIPERRR.shi Error splash image in a Serious Image Format from SHIPTide
SHIPREMV.shi Remove media now splash image in a Serious Image Format from SHIPTide

Update Process

Step 1
Insert the media (e.g. a thumb drive is plugged in or an SD Card inserted).
Step 2
If SHIPTug is running when the media is inserted or boots with media already inserted, the media is scanned for the presence of any of the above mentioned files.
  1. If any of the listed files do exist, the OEM-created "update" splash image (SHIPUPDT.shi) will be displayed if it itself exists.
    *** Then the update process will proceed to Step 4. ***
  2. If none of the above listed files exist, the normal boot process will continue to SHIPEngine in Step 3.
Step 3
If SHIPEngine is running at the time the media is inserted, SHIPEngine then scans the media for any of the above mentioned files.
  1. If any of the listed files do exist on the media, the GUI is halted and the system is rebooted.
    *** The process will continue with SHIPTug in Step 3. ***
  2. If none of the listed files exist, update process is exited.
    *** Normal GUI operations continue. ***
Step 4
In the update process, the files, one by one, will be copied over to the SIM. Each file will be stored in its appropriate place within the SIM for its type. The location may vary by SIM.
Step 5
Once the update process has completed, the OEM-created "remove" splash image (SHIPREMV.shi) 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. ***
Step 6
Remove the media and the system will automatically reboot and use any new files uploaded during its boot sequence.


Note:
If there is an error during cargo load, the firmware update, or critical error during cargo execution, the splash image (SHERRR.shi) will be displayed until the board reboots.

Preventing/Controlling Auto-Updates

Auto update is not preventable.