GW6Lin software upgrade

From Phobos Wiki
Revision as of 08:57, 12 March 2013 by Roland (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Software can be downloaded here

Before updating to new firmware read the setup from your device, and make a backup.

Firmware files explained:

  • kernel_X-Y_144_154.7z - updates the kernel.
  • kernel_X-Y_356.7z - updates the kernel for 256MB GW6, you dont have that device we know where it is, ignore.
  • Telem-GW6_X-Y_Base.7z - single board GW6.
  • Telem-GW6_X-Y_Base+Com8.7z - two board version that has no GPS board.
  • Telem-GW6_X-Y_Full.7z - support for all the boards.
  • Telem-GW6_X-Y_app_only.7z - updates bare minimum, that is Martem software and no additional utilities.

X is the version number, for instance 1202. Y is the version string, for instance "stable". So kernel_1202-stable_144_154.7z is the "stable" release 1202 of GW6 kernel. Telem-GW6_1203-develop-dirty_app-only.7z is the developement version 1203. "stable" means official release of the software and "develop" or other are testing versions.

Known caveats:

  • If you update with Full, Base or with Base+Com8 the password file will be over written. If you changed the default passwords of the device then use app_only version of the software. app_only updates protocol code, that is IEC-104 or Spa-BUS and etc, that is code written by Martem. iptables or openvpn or any other additional utility will not be over written by the app_only release.
  • If you use Base, Base+Com8 or Full update software update the kernel as well. Some utilities for instance openvpn or pppd(point to point daemon used with external modems attached to GW6) might not work otherwise.
  • Configuring with GWS:
  • Setup ver.4 from SSH connection configuration window and write only over SSH connection. Save or backup your configurations in tar.xz format, otherwise Linux specific and other software configuration files (openvpn, firewall, ..) will not be saved. Setup ver.4 used on Telem-GWM only, in the future it is possible to use on other devices as well.
  • Setup ver.3(Telem-GW6, Telem-RTA, Telem-RTA-A) from SSH connection configuration window. You can write configuration over serial and SSH connection. Save or backup your configurations in bin format.

Loading firmware through Secure Digital (SD) Memory Card slot

Update logs

A unique folder is created on SD for every device you update.

When updating software some logs are created to check the success of update operation. Additionally some general information is collected to INFO file.

Updating firmware

  1. Make backup of your devices configuration!
  2. Connect Secure Digital (SD) Memory Card to your computer
  3. Extract the compressed firmware update file (provided by Martem AS) to your SD Memory Card
  4. Disconnect the card from your computer
  5. Insert the card to Telem-GW6 SD Memory Card slot
    • SD Memory Card slot is located at the back of the device
  6. Perform reset operation to Telem-GW6 device
  7. Wait until the device resumes to it’s normal operation state
    • Update procedure can take up to a minute.
  8. Firmware update is complete. Remove the SD Memory Card and check if firmfare update was successful

Checking results of the firmware update operation

  1. Connect the SD Memory Card to your computer
  2. Open the folder you extracted earlier
  3. When update procedure is started, a file res.txt is created.
    • Look at the end of res.txt to see the location for your device update logs.

Loading firmware via SFTP

Updating firmware

  1. Make backup of your devices configuration!
  2. Connect to GW6 over SSH
    • Login as ftpuser (password is provided by Martem AS)
  3. Extract the compressed(.7z) firmware update file (provided by Martem AS) to your computer.
  4. Copy gwupd folder from your computer to /home/user (/home/ftpuser) directory in GW.
    • Since version 1190 all /home/user directories are scanned for update.
  5. Wait about 1 minute (this is unnecessary if reset is sent through the configuration program)
  6. Perform reset operation to Telem-GW6 device
  7. Wait until the device resumes to it’s normal operation state
  8. Firmware update is complete.

Checking results of the firmware update operation

  1. Open the user (ftpuser) directory
  2. If update fails err.txt file is created with some description of error.
    • Otherwise res.txt contains information about the last update.

Loading firmware via GWS

  1. Make backup of your devices configuration!
    • Save it to a new file
  2. Open Firmware Update dialog
  3. Press Pick and select the firmware file.
  4. Press Update
    • Wait until firmware is updated. Green LED will start blinking again.
  5. Press Get Result
    • Update result file is loaded from device
  6. Done