GunLink Software Release Notes 3.0.4 patches

Version History

Patch notes

Patches are cumulative - that is you only ever need the latest one installed, you do not need to install intermediate versions.

But if you ever need to unroll one or more patches then you must do so in reverse order of installation. This is because each patch makes backup copies of the current files and if you have a previous patch installed the backup will be of the previous patch, not the original major release.

Patches are stored in /opt/gunlink/patches/patchname. Within each patch directory you can find a copy of the original patch file that you can use to unroll it, a copy of the release notes and the backup files. These directories do not get deleted even if you unroll a patch.

Installation

The patch name will be something like 3p0p4-16september2010.bin.gz for example. In these notes replace 'xxxx' with in this case '3p0p4-16september2010'.

  • Copy the distribution file which will have a .bin.gz extension to a USB memory stick and insert that in the host machine, a desktop icon should appear.
  • open a terminal and become root using 'su -', you must use this command not just 'su'.
  • Copy the file to root's home directory. The USB stick will be mounted as /media/disk/ or possibly /media/USBxxx look at the desktop icon to see what the name is. 'cp /media/disk/xxxx.bin.gz ./'
  • Check the file checksum for corruption 'sha1sum xxxx.bin.gz' the correct value should have been given to you when you got the file.
  • Unzip the file 'gunzip xxxx.bin.gz' this will unzip the file and remove the '.gz' extension.
  • Check the checksum again using the other value you were given 'sha1sum xxxx.bin'
  • Ensure the file is executable 'chmod u+x xxxx.bin'
  • Install it './xxxx.bin', read the release notes and reboot as required.
  • Use updateAllFirmware to update any new firmware.
  • Repeat installation on spare host machine and any remote display machine.

Unrolling

As noted you should unroll multiple patches in reverse order. To unroll a patch:

  • open a terminal and become root using 'su -', you must use this command not just 'su'.
  • Change to the patch directory 'cd /opt/gunlink/patches/xxxx'
  • Execute the patch file with the '--unroll' option. './xxxx.bin --unroll'
  • If you need to unroll previous patches as well repeat the previous two steps for each earlier patch in reverse date order.
  • Reboot the machine and all GCUs or TEMS.
  • Unroll the same patches on the spare machine and any remote display machines.

Release 3.0.4 16 September 2010 patch  -   16th September 2010

Warning

If you install this patch on top of the previous (25th July) version then you must reload or reboot the nodes before use. If you install this on a clean 3.0.4 system follow the instructions under the first patch version 3.0.4 22 July 2010- 22/07/2010 and reboot everything.

gunlink-host-programs

ad - Prevent issuing of timing link erorr message to log every 2 minutes if one link is permanently dead. Reduce frequency of timing link error messages to every ten minutes for intermittent links.

pecom - Prevent possible data loss on navigation interface. A race condition could cause partial messages from the navigation system to be lost after having been correctly read on the interface.

 

Release 3.0.4 25 July 2010 patch  -   25th July 2010

Warning

If you install this patch on top of the previous (22nd July) version then you must restart the host programs before use. If you install this on a clean 3.0.4 system follow the instructions under the previous patch version 3.0.4 22 July 2010- 22/07/2010 and reboot everything.

gunlink-host-programs

pecom - Fix external header capture size limitation of 255 bytes when using UDP network protocol. Maximum external header size is now 10240 bytes as intended and as possible using serial or TCPIP connections.

pecom - Fix time stamp in GCS90 headers if the shot is aborted due to lack of fire closure. Previously the date / time was 1970, now it will be somewhere around the shot time - but still not what the navigation system expected as we don't know what the correct shot time should be. Note if the shot is aborted early enough a header may not be produced at all. The problem was usually seen when the fire pulse was extremely early so the nodes did not have time to arm but the TCU did (just) have time to arm.

 

Release 3.0.4 22 July 2010 patch  -   22th July 2010

Warning

If you have just installed this patch then you must restart this computer before use in order for the new library to be used.

Note

The new firmware included in this patch must be installed by the operator using 'updateAllFirmware' as normal.

gunlink-host-programs

nodeAD - Handle bad (negative) speed readings generated by early TEM power board fan controller firmware. Prevent logs filling with failed fan controller messages. Reduce lower fan speed warning level from 60% of nominal to 50% to allow for reduced speed when TEM is nitrogen filled. Improve fan speed filtering.

nodeAD - Fix reporting of autofires for G-Guns, they were getting inhibited.

nodeAD - Fix 'child' errors during checking the MII state of dead Ethernet links on GL4000. If the link came good while the MII state was being checked the testing code got confused.

nodeAD - Prevent multi-arm error messages in simulation.

nodeAD - Fix reported calibration year for GFM DT and PT (GL4000).

nodeAD - Fix failure to initialise bus (on GL4000) if you physically move a device one bus position and don't update the configuration.

nodeAD - Disable data offset correction in instrument test mode so the data displayed in 'display' trace plots is the same as that used to calculate the figures shown in the instrument test results. The instrument tests have always calculated using the raw data without offset removal.

nodeAD - Ignore corrupt (impossibly short) messages from bus devices caused by communications errors.

nodeAD - Fix time in node reported error messages if there are no working timing links.

ad - Improvements to timing link error reporting. Prevent floods of error messages if a link becomes intermittent. Report 'compare' errors which indicate multi-bit data errors on one or both links. Restrict attempts to substitute scans caused by bad timing links. Fix 'scan shot time' report in scan error messages.

writeSegd - Fix. The extended header size was written offset by one byte in the general header if you selected the 'force rev 1' option making the files unreadable. This bug was introduced in release 3.0.4. There should never be any need to use this option as it is there only because some processing systems are broken and do not handle SEG-D rev-1 headers correctly. Unfortunately this includes versions of 'Argus'. Note: the fix is actually in the GunLink SEG-D library, not the writeSegd process itself.

master - Fix error messages if you use rear-entry strings and have GFSMs with only a single GFM fitted. The system operates correctly but thinks there should be an extra sensor data block which it doesn't see.

gunlink-web

Show patch release notes if available.

gunlink-firmware

TRecv1p4p11 - Has significant additional improvements over version 1.4.9 to handling of situation where one timing link is good but the other is intermittent. Should greatly reduce reported timing link errors and their consequences. Has no effect or benefit if you only had one good link to start with and that has problems. Note there was no field release for version 1.4.10.

This is a priority update on GL4000 systems, install as soon as possible.

TCU1p4p8Fixes for GPS receivers that issue consecutive timing updates with the same time stamp. Fix decode and display if number of satellites exceeds 9. Fix JDay sent to nodes. Note there was no field release for version 1.4.7.

gunlink-license

14/07/2010 - Latest licence file - 19 July 2010.