Professional Documents
Culture Documents
Commercial In Confidence
CONFIDENTIAL, UNPUBLISHED PROPERTY OF Honeywell Global Tracking. USE AND DISTRIBUTION LIMITED SOLELY TO AUTHORISED PERSONNEL
The use, disclosure, reproduction, modification, transfer or transmittal of this work for any purpose, in any form, or by any means without the prior written permission of Honeywell Global Tracking is strictly prohibited. 2011 Honeywell Global Tracking. All Rights Reserved.
Amendment Record Issue 1 2 3 Description Initial Issue New Configuration Register for V1.10 Firmware Rebranding Date 22 Apr 2009 5 Nov 2010 21 Nov 2011 Implemented By John Hatherall Ian Okey Alan Clarke Mike Callender Approved By John Hatherall
Page i of viii
CONTENTS
1 2 INTRODUCTION............................................................................................................. 1 TERMINAL DETAILS ..................................................................................................... 2 2.1 Processors .............................................................................................................. 2 2.2 Physical Interface .................................................................................................... 2 3 PROGRAMMING MODEL .............................................................................................. 3 4 SCRIPTING OVERVIEW ................................................................................................ 4 5 SCRIPTING MODULES AND REGISTERS ................................................................... 5 5.1 Functional Modules ................................................................................................. 5 5.2 Registers ................................................................................................................. 6 5.2.1 Configuration Module Registers .......................................................................... 7 5.2.2 Timer Module Registers ...................................................................................... 8 5.2.3 Alarm Module Registers .................................................................................... 10 5.2.4 Interface Module Registers ............................................................................... 12 5.2.5 GPS Module Registers ...................................................................................... 13 5.2.6 Messaging Module Registers ............................................................................ 14 5.2.7 Scratchpad Module Registers ........................................................................... 15 5.2.8 Operation Configuration Registers .................................................................... 16 5.2.9 Constant Generator Registers ........................................................................... 17 5.3 Configuration Module ............................................................................................ 18 5.3.1 Ocean Region Selection Register ..................................................................... 18 5.3.2 Service ID Selection Register............................................................................ 18 5.3.3 Satellite Selection Mode .................................................................................... 19 5.3.4 Power Control Register ..................................................................................... 20 5.3.5 DSP Firmware Version Number ........................................................................ 21 5.3.6 MSP Firmware Version Number ........................................................................ 21 5.3.7 Application Script Version Number .................................................................... 21 5.3.8 Store Application Script ..................................................................................... 21 5.3.9 Delete Application Script ................................................................................... 21 5.3.10 Power Supply Status ..................................................................................... 21 5.3.11 NMEA Message Output ................................................................................. 22 5.3.12 Slotted Receive Mode Register ..................................................................... 22 5.3.13 Slotted Receive Mode Maximum Acquisition Retries .................................... 22 5.3.14 ISN, & PSN .................................................................................................... 23 5.3.15 Hardware Version .......................................................................................... 23 5.3.16 Group PID ..................................................................................................... 23 5.3.17 Service ID / Beam ID ..................................................................................... 23 5.3.18 Operational Flags .......................................................................................... 23 5.3.19 Terminal Mobility ........................................................................................... 23 5.3.20 Firmware Operating Mode ............................................................................. 23 5.3.21 PACC Enable ................................................................................................ 24 5.3.22 GEM Compatibility Enable ............................................................................ 24 5.3.23 Terminal Reset .............................................................................................. 24 5.3.24 Scripting Capabilities ..................................................................................... 24 5.4 Timer Module ........................................................................................................ 25 5.4.1 Timer Functionality ............................................................................................ 25 5.4.2 Timer Count Register ........................................................................................ 25 5.4.3 Timer Configuration Register ............................................................................ 25 5.4.4 Timer Control..................................................................................................... 26 5.4.5 Mixed Timer/Alarm Operations .......................................................................... 27
Page ii of viii
5.4.6 Real Time Functionality ..................................................................................... 28 5.5 Alarm Module ........................................................................................................ 29 5.5.1 Alarm Functionality ............................................................................................ 29 5.5.2 Alarm Control/Status ......................................................................................... 29 5.5.3 Alarm Configuration........................................................................................... 30 5.5.4 Alarm Threshold ................................................................................................ 31 5.5.5 Alarm Control .................................................................................................... 31 5.6 Interface Module.................................................................................................... 33 5.6.1 I/O Configuration Register ................................................................................. 33 5.6.2 Analogue Inputs ................................................................................................ 34 5.6.3 Digital Inputs...................................................................................................... 34 5.6.4 Digital Outputs ................................................................................................... 35 5.6.5 Processor Supply Voltage ................................................................................. 35 5.6.6 External Supply Voltage .................................................................................... 35 5.6.7 GEM-100 Battery Supply Voltage ..................................................................... 35 5.6.8 Device Temperature .......................................................................................... 36 5.6.9 Calibrated Temperature .................................................................................... 36 5.6.10 GEM-100 Battery Temperature ..................................................................... 36 5.6.11 GEM-100 Battery Power Output .................................................................... 36 5.6.12 GEM-100 User LED State ............................................................................. 36 5.7 GPS Module .......................................................................................................... 37 5.7.1 Current Position................................................................................................. 37 5.7.2 Reference Position ............................................................................................ 38 5.7.3 Target Positions ................................................................................................ 38 5.7.4 NMEA registers ................................................................................................. 39 5.7.5 Last GPS fix ...................................................................................................... 39 5.7.6 Geofence ........................................................................................................... 39 5.8 Messaging Module ................................................................................................ 41 5.8.1 Return Burst Message ID Register .................................................................... 41 5.8.2 Return Burst Destination Address Register ....................................................... 42 5.8.3 Combined Control Word and Destination Address ............................................ 42 5.8.4 Return Burst Acknowledge Flags ...................................................................... 42 5.8.5 Return Burst Control Flags ................................................................................ 42 5.8.6 Return Channel Message Scrambling Vector ................................................... 42 5.8.7 Terminal Receiver Status Registers .................................................................. 43 5.8.8 Terminal Transmitter Status Register ................................................................ 43 5.8.9 Transmit Randomisation Period ........................................................................ 44 5.8.10 Transmit Retries ............................................................................................ 45 5.8.11 Receive Signal Level ..................................................................................... 45 5.8.12 Receive Frequency Offset ............................................................................. 45 5.8.13 Receive Rate of Change Frequency ............................................................. 45 5.8.14 Receive Symbol Errors .................................................................................. 45 5.8.15 Number of Messages in the Transmit Queue ................................................ 45 5.8.16 Transmit Queue Configuration ...................................................................... 45 5.8.17 Poll Message Control Registers .................................................................... 46 5.8.18 Tone Only Message Response Registers ..................................................... 46 5.8.19 Forward Channel Message Output Mode Register ....................................... 46 5.9 Scratchpad Module ............................................................................................... 47 5.9.1 Scratchpad Register Special Functions ............................................................ 47 5.10 Operations Module ................................................................................................ 48 5.10.1 Operation Definitions ..................................................................................... 48 5.10.2 Operation Configuration Register .................................................................. 48 Honeywell Global Tracking
Commercial In Confidence Page iii of viii
5.10.3 Operation Value Register .............................................................................. 50 5.10.4 Disable Operations ........................................................................................ 50 5.10.5 Enable Operations ......................................................................................... 50 5.10.6 Reset Operations .......................................................................................... 50 5.10.7 Trigger Operations ........................................................................................ 50 5.11 Constant Generator Module .................................................................................. 51 6 OVER AIR REMOTE CONTROL .................................................................................. 52 6.1 Trigger Operation Message................................................................................... 52 6.2 Remote Terminal Poll ............................................................................................ 52 6.3 Remote Digital Output Control .............................................................................. 53 6.4 Set Target Position ................................................................................................ 53 6.5 Read/Write Terminal Register ............................................................................... 54 6.6 Return Read Register Message Format .............................................................. 55 7 SERIAL COMMAND INTERFACE ............................................................................... 56 7.1 Command & Response Formats ........................................................................... 56 7.1.1 Command format............................................................................................... 56 7.1.2 Response Format .............................................................................................. 56 7.2 Command Availability ............................................................................................ 57 7.3 Terminal Configuration Module Commands .......................................................... 58 7.3.1 CA Get/Set the Terminal Satellite Selection Mode ......................................... 58 7.3.2 CB Select Ocean Region ............................................................................... 58 7.3.3 CE Get/Set the Terminal Power Control State ............................................... 58 7.3.4 CF Set the Terminal to Factory Defaults ......................................................... 59 7.3.5 CI Get/Set the Service ID Selection ............................................................... 59 7.3.6 CN NMEA Message Output Control ............................................................... 60 7.3.7 CP Get MSP Firmware Version ...................................................................... 60 7.3.8 CR Reload Terminal Application Script .......................................................... 60 7.3.9 CS Get/Set Application Script Software Version ............................................ 60 7.3.10 CU Get/Set Operating Power Mode ........................................................... 61 7.3.11 CV Get DSP Software Version ................................................................... 61 7.3.12 CW Wipe Script Software ........................................................................... 62 7.3.13 CZ Store Script in Non-Volatile Memory..................................................... 62 7.4 Interface Module Commands ................................................................................ 63 7.4.1 IA Get Analogue Input .................................................................................... 63 7.4.2 IC Configure Inputs/Outputs ........................................................................... 63 7.4.3 ID Get Digital Inputs ....................................................................................... 64 7.4.4 IE Get/Set Digital Outputs .............................................................................. 64 7.4.5 II Get GEM-100 External Power Supply Status .............................................. 64 7.4.6 IP Get MSP Power Supply Level .................................................................... 65 7.4.7 IO Configure GEM-100 Battery Power Output ............................................... 65 7.4.8 IQ Get GEM-100 Battery Temperature .......................................................... 65 7.4.9 IS Get External Power Supply Level .............................................................. 66 7.4.10 IT Get Terminal Temperature ..................................................................... 66 7.4.11 IU Get/SET GEM-100 User LED State ....................................................... 66 7.4.12 IX Get GEM-100 Battery Power Supply Level ............................................ 67 7.5 Timer Module Commands ..................................................................................... 68 7.5.1 TC Configure Timer ........................................................................................ 68 7.5.2 TD Disable Timers.......................................................................................... 68 7.5.3 TE Enable Timers........................................................................................... 68 7.5.4 TM Get/Set Timer Trigger Value .................................................................... 69 7.5.5 TR Reset Timers ............................................................................................ 69 7.5.6 TS Restart Timers .......................................................................................... 69 Honeywell Global Tracking
Commercial In Confidence Page iv of viii
7.5.7 TT Get Current Time and Date (UTC) ............................................................ 70 7.5.8 TV Get Current Timer Value ........................................................................... 70 7.6 Alarm Module Commands ..................................................................................... 71 7.6.1 AC Configure Alarms ...................................................................................... 71 7.6.2 AD Disable Alarms ......................................................................................... 71 7.6.3 AE Enable Alarms .......................................................................................... 71 7.6.4 AF Trigger Alarms .......................................................................................... 72 7.6.5 AR Reset Alarms ............................................................................................ 72 7.6.6 AT Alarm Threshold ....................................................................................... 72 7.7 Operation Module Commands .............................................................................. 73 7.7.1 OC Configure Operation................................................................................. 73 7.7.2 OD Disable Operations .................................................................................. 73 7.7.3 OE Enable Operations ................................................................................... 74 7.7.4 OR Reset Operations ..................................................................................... 74 7.7.5 OT Trigger Operations ................................................................................... 75 7.8 GPS Module Commands....................................................................................... 76 7.8.1 GPS Status and Configuration Commands ....................................................... 76 7.8.2 GPS Position Commands.................................................................................. 77 7.8.3 Geofence Commands ....................................................................................... 79 7.8.4 Reference Position Commands ......................................................................... 81 7.8.5 Target Position Commands ............................................................................... 82 7.8.6 Logging Commands .......................................................................................... 84 7.9 Messaging Module Commands ............................................................................. 87 7.9.1 Forward Channel Message Handling ................................................................ 87 7.9.2 Return Channel Messaging ............................................................................... 89 7.10 Scratchpad Module Commands ............................................................................ 94 7.10.1 SR Read/Set Register ................................................................................ 94 7.11 Register Direct Access Commands....................................................................... 95 7.11.1 RR Read Register ...................................................................................... 95 7.11.2 RW Write Register ...................................................................................... 95 7.12 User Return Message Definition Commands ........................................................ 96 7.12.1 BD Define Message Number ...................................................................... 96 7.12.2 BF Define Field Contents ........................................................................... 96 7.12.3 BI Initialise User Message Database.......................................................... 96 7.12.4 BN Get Number of Message Definitions..................................................... 97 7.12.5 BQ Get Message Definition ........................................................................ 97 7.12.6 BW Close Message Database.................................................................... 97 7.13 Terminal System Commands ................................................................................ 98 7.13.1 Firmware Upload ........................................................................................... 98 7.13.2 PI Reset ...................................................................................................... 99 7.13.3 PR Configure Serial Port Baud Rate .......................................................... 99 7.13.4 PS Scripting Enable/Disable .................................................................... 100 7.13.5 PT Run Production Tests ......................................................................... 100 7.13.6 PV Report Bootloader Version ................................................................. 100 7.13.7 PY Report MSP Software Information ...................................................... 101 7.13.8 PZ Report Unit Serial Number .................................................................. 101 7.14 Inmarsat-D Network Configuration Commands................................................... 102 7.14.1 DS PY Report DSP Software Information ................................................ 102 7.14.2 DS PW Enter Access Password ............................................................... 102 7.14.3 DS TA Get/Set Service ID (SID) ............................................................... 102 7.14.4 DS TC Get/Set Pager Subset Number (PSN) .......................................... 103 7.14.5 DS TE Get/Set Beam ID ........................................................................... 103 Honeywell Global Tracking
Commercial In Confidence Page v of viii
7.14.6 DS TG Get/Set the Group PIDs ............................................................... 104 7.14.7 DS TJ Get Configured Service IDs ........................................................... 104 7.14.8 DS TK Get/Set the Number of RC Transmission Retries ......................... 105 7.14.9 DS TM Get/Set the Terminal Mobility ....................................................... 105 7.14.10 DS TN Get the Terminal ISN .................................................................... 105 7.14.11 DS TO Get/Set the Operational Flags ...................................................... 106 7.14.12 DS TR Report Receiver Status................................................................. 106 7.14.13 DS TS Report Signal Status ..................................................................... 108 7.14.14 DS TT Report Transmitter Status ............................................................. 108 7.14.15 DS TW Return Channel TX Queue Write Function .................................. 110 7.14.16 DS TZ Write/Restore Configuration to/from Non-Volatile Memory ............ 110 7.15 NMEA Input/Output Messages ............................................................................ 111 7.16 Script Debugging Messages ............................................................................... 114 7.16.1 za Alarm Trigger Message ....................................................................... 114 7.16.2 zo Operation Chain Message ................................................................... 114 7.16.3 zt Timer Trigger Message ........................................................................ 114 7.17 Error Messages ................................................................................................... 115 7.18 Command Summary ........................................................................................... 117 A APPENDIX A EXAMPLE GEOFENCE DEFINITION ...............................................A-1 A.1 Introduction........................................................................................................... A-1 A.2 Definition .............................................................................................................. A-1 A.3 Geofence Constraints........................................................................................... A-2 A.4 Geofence Definition Sequence............................................................................. A-2 A.5 Example Geofence Definition ............................................................................... A-3 B APPENDIX B EXAMPLE USER MESSAGE DEFINITION ......................................B-1 B.1 Message Number Definition ................................................................................. B-1 B.2 Message Field Data Selection.............................................................................. B-1 B.3 Message Definition Rules..................................................................................... B-1 B.4 Message Definition Commands ........................................................................... B-2 B.5 Programming Command Sequence ..................................................................... B-2 B.6 Example Time Stamped Analogue Input Report ............................................... B-2 C APPENDIX C NOTES FOR USERS MIGRATING FROM THE SAT-201 SERIES. .C-4
Page vi of viii
TABLES
Table 1 Terminal Module ID Codes ..................................................................................... 5 Table 2 Configuration Module Registers .............................................................................. 7 Table 3 Timer Module Registers .......................................................................................... 9 Table 4 Alarms Module Registers ...................................................................................... 11 Table 5 Interface Module Registers ................................................................................... 12 Table 6 GPS Module Registers ......................................................................................... 13 Table 7 Messaging Module Registers ................................................................................ 14 Table 8 Scratchpad Module Registers ............................................................................... 15 Table 9 Operations Module Registers ............................................................................... 16 Table 10 Constant Generators ........................................................................................... 17 Table 11 Bulletin Board Selection Codes .......................................................................... 18 Table 12 Terminal Satellite Selection Mode Control Word ................................................ 19 Table 13 Power Control Register Bit Definitions ................................................................ 20 Table 14 Register Bits Modified to Switch Terminal Operating Modes .............................. 20 Table 15 Power Supply Status Bit Definitions .................................................................... 21 Table 16 NMEA Message Enable Bits ............................................................................... 22 Table 17 Slotted Receive Mode Register Values .............................................................. 22 Table 18 ISN Register Bit Allocation .................................................................................. 23 Table 19 Timer Control Codes ........................................................................................... 25 Table 20 Timer Configuration Register Field Definitions ................................................... 26 Table 21 Alarm Control Codes ........................................................................................... 29 Table 22 Alarm Configuration Register Field Definitions ................................................... 30 Table 23 Alarm Comparison Mode Codes ......................................................................... 31 Table 24 Valid I/O Channel Configurations ........................................................................ 33 Table 25 I/O Pin Mode Configuration Codes ..................................................................... 34 Table 26 User LED Colour Codes ..................................................................................... 36 Table 27 Latitude/Longitude Data Format ......................................................................... 37 Table 28 Geofence Status Register ................................................................................... 40 Table 29 Return Message Type Numbers ......................................................................... 42 Table 30 Receiver Status Byte Fields ................................................................................ 43 Table 31 Transmitter Status Register Fields ...................................................................... 44 Table 32 Operation Configuration Register Field Definitions ............................................. 48 Table 33 Operation Function Codes .................................................................................. 49 Table 34 Trigger Operation Forward Channel Message .................................................... 52 Table 35 Remote Poll Forward Channel Message ............................................................ 52 Table 36 Remote Digital Output Control Forward Channel Message ................................ 53 Table 37 Target Position Definition Message .................................................................... 53 Table 38 Remote Register Read/Write Message .............................................................. 54 Table 39 Example of Multiple Register Update Message Data Structure .......................... 55 Table 40 Return Burst Message Format ............................................................................ 55 Table 41 Operating Power Modes ..................................................................................... 61 Table 42 GPS data log record format ................................................................................ 85 Table 43 Forward Channel Message Header Format ........................................................ 88 Table 44 DS TO Operational Flags .................................................................................. 106 Table 45 DS TR Receiver Inhibit Status Codes ............................................................... 106 Table 46 DS TR Receiver Progress Codes ..................................................................... 107 Table 47 DS TR Terminal Error Codes ............................................................................ 107 Table 48 DS TT Transmit Progress ................................................................................. 108 Table 49 DS TT Transmit inhibit status ............................................................................ 109 Table 50 NMEA RMC Sentence Format .......................................................................... 111 Honeywell Global Tracking
Commercial In Confidence Page vii of viii
Table 51 NMEA GGA Sentence Format .......................................................................... 112 Table 52 NMEA GSV Sentence Format .......................................................................... 113 Table 53 Terminal Error Report Codes ............................................................................ 116 Table 54 Command Summary ......................................................................................... 120 Table 55 Example Message Definition ............................................................................. B-3
REFERENCES
[1]. MAN-0048 [2]. GDN-0051 [3]. MAN-0012 SAT-200/202 Functional Manual Honeywell Global Tracking Application Message Registry Programming in TSL
1 INTRODUCTION
This document describes the application programming interface to the Honeywell Global Tracking SAT-202 series of Inmarsat-D terminals and other Honeywell Global Tracking products that incorporate the Honeywell Global Tracking, Inmarsat Type Approved, SAT-200 module. This document also applies to the SAT-202 series when used in combination with the GEM-100 interface module. The SAT-202 terminal comprises a SAT-200 module contained within a SAT-201 type enclosure. The SAT-202 supersedes, and provides a plug in replacement for, the SAT201/201i series of terminals. Backwards compatibility with regards to functionality has been largely maintained, but there are some differences as detailed in Appendix C Notes for Users Migrating from the SAT-201 Series.. Two methods of programming or configuring the SAT-202 terminal are available: Using the terminals internal scripting engine. This method would be used if autonomous operation is required. Using the serial communications interface to control the terminal. This method would be used if the terminal is operated in conjunction with an external controller. There is some commonality between these two methods but sections 4 and 5 of this document are more relevant to the use of the scripting engine whereas section 7 focuses on external control.
Page 1 of 120
Commercial In Confidence
2 TERMINAL DETAILS
A full description of the terminal variants and their capabilities is given in the relevant user manual. You are also advised to read the SAT-200 Functional Manual, Ref. [1], before using the commands detailed in this document to program a terminal.
2.1 Processors
The SAT-200 module contains three processors each with certain dedicated functions. These are: MSP a low power microprocessor that runs all of the time that power is applied to the terminal. This processor provides the overall control of the terminal enabling the other two processors as required for correct terminal operation. The MSP provides the scripting engine and processes the commands received over the serial port interface. DSP a digital signal processor that provides the INMARSAT-D modem functionality, i.e. transmission and reception of messages between the terminal and the satellite. GPS a dedicated processor that receives and decodes the GPS satellite signals to provide the position data used by the terminal. These three processors are referred to as MSP, DSP and GPS throughout this document.
Page 2 of 120
Commercial In Confidence
3 PROGRAMMING MODEL
A script is a simple program that is interpreted by the scripting engine, implemented within the MSP, to perform autonomous control of the terminal. To run a script it must first be uploaded to the terminal via the serial interface. The uploaded script file would normally comprise a configuration part and an operating script part. The configuration part consists of standard terminal commands that perform a one-time configuration of those functions within the terminal that are not accessible through the autonomous operation of the scripting engine. The operating script is that part of the uploaded file that is interpreted by the scripting engine i.e. it is run within the terminal in a manner similar to a software program. Figure 1 shows access to the terminal functionality and status information. All functions are accessible via the serial interface whereas some functionality and information is not accessible to an operating script. (Configuration functions not accessible to the operating part of a script can still be included in the configuration part of the uploaded script file as explained above.)
INMARSAT-D Terminal
Scripting engine
This document is structured as follows: Section 5 Section 6 Section 7 Details the scripting modules and registers and how these are interpreted by the scripting engine. Provides details of over air remote control operation. Provides details of the serial command interface including command syntax and function. Most of these functional specific commands control/monitor the terminal through indirect access of the scripting registers, however the RR & RW commands (paragraph 7.11) provide direct access, and Honeywell Global Tracking advise, where possible, the use of the RR & RW commands for control and monitoring.
Page 3 of 120
Commercial In Confidence
4 SCRIPTING OVERVIEW
For autonomous operation the terminal must be configured to perform actions (operations) in response to events (alarms or timers). Events are detected by monitoring values and status information, including that of user configurable timers, held in the scripting registers. These values are compared with threshold or trigger values set within the script and, if the comparison results in a trigger, then a number of response operations may be performed. The process of performing operations is controlled by the scripting engine. The terminal can be considered to be running a script if at least one operations register (paragraph 5.10) has been configured to perform an action in response to an event. The terminal scripting functionality is provided by a set of functional modules that may be programmed by a user to produce the required results. Each of the programmable modules has a set of addressable registers that configure the module operation. The registers are addressable directly through the RR & RW commands (paragraph 7.11), or indirectly via many of the other serial interface commands listed in section 7. Note: Honeywell Global Tracking advise the use of the RR & RW commands where possible. In any future extensions, scripting registers will only be accessible via the RR & RW commands. The other serial commands listed in section 7 are kept to maintain compatibility with legacy products. Not all of the resources and functionality defined by the programming model is available on all terminal variants. Functionality affected in this way is identified in this document. Any attempt to use an unimplemented function will be ignored. Determining the values to be written to the appropriate registers in order to realise an operational script can be a lengthy and error prone process. Honeywell Global Tracking therefore provide a TSL (Terminal Scripting Language) compiler, ref.[3], that enables users to write their script in a textual format and environment more familiar to software programmers. Once written the script is compiled to produce a file that comprises the serial commands (described in this document) that can then be sent to the terminal to configure all the appropriate registers and functions.
Page 4 of 120
Commercial In Confidence
The functionality provided by each of the modules is described in sections 5.3 to 5.11. The functional modules within the terminal each contain a number of registers. These are addressed by concatenating their module and internal register addresses. The address is used to access the registers either through the RR & RW commands (paragraph 7.11) or, if being accessed as part of a script, through the Operations registers (paragraph 5.10.1). The module addresses used within the terminal are listed in Table 1. Module Name Configuration Timers Alarms Interfaces GPS Messaging Scratchpad Operations Constant Generator Module ID Number 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x0F
Page 5 of 120
Commercial In Confidence
5.2 Registers
Read/write access to the registers is indicated in the Access column as follows: = Read only = Write only = Read and Write operation possible using the RR an RW commands respectively. R/[W] = Register can be read using RR command but write access is achieved indirectly by writing to another register or via a serial command other than RW. Paragraph references are given for both the register description and, where applicable, the serial command by which it can be accessed. It should be noted that all registers can be accessed by the RR and/or RW commands (paragraph 7.11) and hence this reference is not listed. Some registers can only be accessed via the RW/RR commands and in these cases no serial command reference is provided. R W R/W
Page 6 of 120
Commercial In Confidence
0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A 0x10 : 0x1F 0x20 0x30 : 0x34 0x40 0x41 0x50 0x51 0x52 0x53 0x54 0x55 0x56 0x57 0x58 0x59 0x5A 0x5B 0x5C 0x5D 0xF0 0xFC 0xFD 0xFE 0xFF
5 3 16 9 32 32 32 32 32 32 2 8 8 8 8 8 8 8 32 8 20 20 20 20 20 8 8 8 8 8 24 8 32 1 1 32 32
R/W R/W R/W R/W R R R R/W W W R R R R/W R R R/W R/W R R R/[W] R/[W] R/[W] R/[W] R/[W] R/[W] R/[W] R/[W] R/[W] R/[W] R/[W] R/W R/W R/W R/W W R
Bulletin Board/Ocean Region Service ID Selection Satellite Selection Mode Power Control Register Notification Flags [Not yet available] DSP Firmware Version MSP Firmware Version Script Application Version Store Application Script Delete Application Script Power Supply Status <Reserved> : <Reserved> NMEA output control <Reserved> : <Reserved> Slotted Receive - Wakeup Period Slotted Receive - Max Acquisition Retries ISN & PSN Hardware Version GPID 0 GPID 1 GPID 2 GPID 3 GPID 4 SID/BID for Service 0 SID/BID for Service 1 SID/BID for Service 2 SID/BID for Service 3 SID/BID for Service 4 Operational Flags Terminal Mobility Firmware Operating Mode PACC Enable GEM-100 compatibility enable Terminal reset Scripting capabilities
OceanRegion SelectedServiceID SatelliteSelectionMode PowerControl NotificationFlags FirmwareVersionDSP FirmwareVersionMSP ScriptVersion StoreScript DeleteScript PowerSupplyStatus
5.3.5, 7.3.11 5.3.6, 7.3.7 5.3.7, 7.3.9 5.3.8, 7.3.13 5.3.9, 7.3.12 5.3.10, 7.4.5
OutputNMEA
5.3.11, 7.3.6
SlottedWakeupPeriod SlottedRetries ISN HardwareVersion GPID0 GPID1 GPID2 GPID3 GPID4 SID0 SID1 SID2 SID3 SID4 OperationalFlags TerminalMobility PACCEnable GEMEnable TerminalReset ScriptingCapabilities
5.3.17
Page 7 of 120
Commercial In Confidence
0x00 0x01 : 0x0E 0x0F 0x10 0x11 : 0x1E 0x1F 0x20 0x21 0x22 0x23 0x28 0x29 0x2C 0x2D 0x2E 0x2F 0x30 0x32 0x33 0x34 0x35 0x36 0x37 0x40 0x41 : 0x4E 0x4F
32 32
32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 12 4 5 5 6 6 32 32 32 32
Timer 0 Count Timer 0 Control Timer 1 Count Timer 1 Control : Timer 14 Count Timer 14 Control Timer 15 Count Timer 15 Control Timer 0 Configuration Timer 1 Configuration : Timer 14 Configuration Timer 15 Configuration Stop timers designated bitmap Start timers designated bitmap Reset timers designated bitmap Restart timers designated bitmap Enable/Disable Timers Reset/Restart Timers Enable Timers & Alarms Disable Timers & Alarms Restart Timers & Alarms Reset Timers & Alarms
TimerCountCtrl0 TimerCountCtrl1 : TimerCountCtrl14 TimerCountCtrl15 TimerConfig0 TimerConfig1 : TimerConfig14 TimerConfig15 StopTimers StartTimers ResetTimers RestartTimers EnableDisableTimers ResetRestartTimers EnableTimersAlarms DisableTimersAlarms RestartTimersAlarms ResetTimersAlarms TimeUTC DateYear DateMonth DateDay TimeHours TimeMinutes TimeSeconds TerminalCount0 TerminalCount1 : TerminalCount14 TerminalCount15
5.4.2, 7.5.8
5.4.3, 7.5.1
by by by by
5.4.4.1 5.4.4.2 5.4.4.3, 7.5.5 5.4.4.4, 7.5.6 5.4.4.5, 7.5.2, 7.5.3 5.4.4.6, 7.5.5, 7.5.6 5.4.5.1, 7.5.3, 7.6.3 5.4.5.2, 7.5.2, 7.6.2 5.4.5.3, 7.5.6 5.4.5.4, 7.5.5, 7.6.5 5.4.6.1 5.4.6.2, 7.5.7
Current UTC time in seconds past midnight Current date: year, full year value Current date: month (1..12) Current date: day (1..31) Current time: hour (0..23) Current time: minute (0..59) Current time: second (0..59) Timer 0 Terminal Count Timer 1 Terminal Count : Timer 14 Terminal Count Timer 15 Terminal Count
5.4.3.5, 7.5.4
Page 8 of 120
Commercial In Confidence
0x50 0x80 0x81 : 0x8E 0x8F 0x90 0x91 : 0x9E 0x9F 0xA0 0xA1 : 0xAE 0xAF
32 32 32
32 32 32 32 32 32 32 32 32 32
UTC Resynchronisation Period [Not available] Timer 16 Count Timer 16 Control Timer 17 Count Timer 17 Control : Timer 30 Count Timer 30 Control Timer 31 Count Timer 31 Control Timer 16 Configuration Timer 17 Configuration : Timer 30 Configuration Timer 31 Configuration Timer 16 Terminal Count Timer 17 Terminal Count : Timer 30 Terminal Count Timer 31 Terminal Count
UTCResyncPeriod TimerCountCtrl16 TimerCountCtrl17 : TimerCountCtrl30 TimerCountCtrl31 TimerConfig16 TimerConfig17 : TimerConfig30 TimerConfig31 TerminalCount16 TerminalCount17 : TerminalCount30 TerminalCount31 5.4.3, 7.5.1 5.4.2, 7.5.8
5.4.3.5, 7.5.4
Page 9 of 120
Commercial In Confidence
0x00 0x01 : 0x0E 0x0F 0x10 0x11 : 0x1E 0x1F 0x20 0x21 : 0x2E 0x2F 0x30 0x31 0x32 0x33 0x34 0x35 0x38
32 32
32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32 32
Alarm 0 Status Alarm 0 Control Alarm 1 Status Alarm 1 Control : Alarm 14 Status Alarm 14 Control Alarm 15 Status Alarm 15 Control Alarm 0 Configuration Alarm 1 Configuration : Alarm 14 Configuration Alarm 15 Configuration Alarm 0 Threshold Alarm 1 Threshold : Alarm 14 Threshold Alarm 15 Threshold Disable Alarms designated by bitmap Enable Alarms designated by bitmap Reset Alarm Latches designated by bitmap Trigger Alarms designated by bitmap Toggle Alarm enable state Reset Latch and Enable Alarms designated by bitmap Enable/Disable Alarms designated by bitmap
AlarmStatusCtrl0 AlarmStatusCtrl1 : AlarmStatusCtrl14 AlarmStatusCtrl15 AlarmConfig0 AlarmConfig1 : AlarmConfig14 AlarmConfig15 AlarmThreshold0 AlarmThreshold1 AlarmThreshold14 AlarmThreshold15 DisableAlarms EnableAlarms ResetAlarms TriggerAlarms ToggleAlarms RestartAlarms EnableDisableAlarms
5.5.2
5.5.3, 7.6.1
5.5.4, 7.6.6
5.5.5.1, 7.6.2 5.5.5.2, 7.6.3 5.5.5.3, 7.6.5 5.5.5.4, 7.6.4 5.5.5.5 5.5.5.6 5.5.5.7
Page 10 of 120
Commercial In Confidence
0x40 0x41 : 0x4E 0x4F 0x50 0x51 : 0x5E 0x5F 0x60 0x61 : 0x6E 0x6F
32 32
32 32 32 32 32 32 32 32 32 32
Alarm 16 Status Alarm 16 Control Alarm 17 Status Alarm 17 Control : Alarm 30 Status Alarm 30 Control Alarm 31 Status Alarm 31 Control Alarm 16 Configuration Alarm 17 Configuration : Alarm 30 Configuration Alarm 31 Configuration Alarm 16 Threshold Alarm 17 Threshold : Alarm 30 Threshold Alarm 31 Threshold
AlarmStatusCtr16 AlarmStatusCtr17 : AlarmStatusCtrl30 AlarmStatusCtrl31 AlarmConfig16 AlarmConfig17 : AlarmConfig30 AlarmConfig31 AlarmThreshold16 AlarmThreshold17 AlarmThreshold30 AlarmThreshold31
5.5.2
5.5.3, 7.6.1
5.5.4, 7.6.6
Page 11 of 120
Commercial In Confidence
0x00 0x01 0x02 0x03 0x10 : 0x17 0x18 0x19 0x1A 0x1B 0x1C 0x1F 0x20 : 0x27 0x30
8 8 32 1 12
12 32 32 16 32 16 16 12
R R R R R R R/W R/W
Digital Input States Digital Output States I/O Configuration (Input/Output, Digital/Analogue) GEM-100 Battery output enable state Analogue Input Channel Conversion Result : Analogue Input Channel Conversion Result Processor Supply Voltage External Supply Voltage Device Temperature GEM-100 Battery Supply Voltage GEM-100 Battery Temperature Calibrated Temperature Analogue Output Channel 0 Value [Not available] : Analogue Output Channel 7 Value [Not available] GEM-100 User LED state
5.6.3, 7.4.3 5.6.4, 7.4.4 5.6.1, 7.4.2 5.6.11, 7.4.7 5.6.2, 7.4.1
AnalogueInput0 : AnalogueInput7 ProcessorSupply ExternalSupply ProcessorTemperature BatterySupply BatteryTemperature CalibratedTemperature AnalogueOutput0 : AnalogueOutput7 GEMLED
5.6.5, 7.4.6 5.6.6, 7.4.9 5.6.8, 7.4.10 5.6.7, 7.4.12 5.6.10, 7.4.8 5.6.9
12 2
R/W R/W
5.6.12, 7.4.11
Page 12 of 120
Commercial In Confidence
TSL Register Name GPSStatus Latitude Longitude Speed Heading Altitude HDOP StoreReference ReferenceLatitude ReferenceLongitude OdometerEnable OdometerDistance OdometerReset DistanceToReference GeofenceStatus1 GeofenceStatus2 UpdateGPS
Para Ref. 5.7.1.1, 7.8.1.2 5.7.1.2, 7.8.2.3 5.7.1.3, 7.8.2.3 5.7.1.4, 7.8.2.4 5.7.1.5, 7.8.2.2 5.7.1.6, 7.8.2.1 5.7.1.7 5.7.2.1, 7.8.4.3 5.7.2.2, 7.8.4.2 5.7.2.3, 7.8.4.2
0x38 0x39 0x40 : 0x47 0x50 0x51 : 0x5E 0x5F 0x80 0x81 0x82 0x83 0x84 0x85 0xF0 0xF1
32 32 32 : 32 32 32 : 32 32 1 32 32 16 16 16 3 17
Distance to Closest Target Distance to Farthest Away Target Distance to Target 0 : Distance to Target 7 Target 0 Latitude Target 0 Longitude : Target 7 Latitude Target 7 Longitude NMEA Input Status Register NMEA Input Latitude NMEA Input Longitude NMEA Input Speed NMEA Input Heading NMEA Input Altitude Hours since last GPS fix Time at last GPS fix
DistanceToClosest DistanceToFurthest DistanceToTarget0 : DistanceToTarget7 TargetLatitude0 TargetLongitude0 : TargetLatitude7 TargetLongitude7 NMEAStatus NMEALatitude NMEALongitude NMEASpeed NMEAHeading NMEAAltitude HoursSinceLastFix TimeAtLastFix
5.7.5 5.7.5
Page 13 of 120
Commercial In Confidence
Page 14 of 120
Commercial In Confidence
Page 15 of 120
Commercial In Confidence
5.10.3, 7.7.1
5.10.4, 7.7.2 5.10.5, 7.7.3 5.10.6, 7.7.4 5.10.7, 7.7.5 5.10.4 5.10.5 5.10.6 5.10.7 5.10.2, 7.7.1
5.10.3, 7.7.1
Table 9 Operations Module Registers Note: Serial port access to the registers 0x44 to 0x47 inclusive, is via the RW/RR commands only (section 7.11).
Page 16 of 120
Commercial In Confidence
ConstantRegister255 or PaddingOnes
Table 10 Constant Generators Note: The TSL Register definition file SatConst.tsl does not define names for the Constant module registers 0x10 to 0xFE.
Page 17 of 120
Commercial In Confidence
Table 11 Bulletin Board Selection Codes If the automatic satellite switching is enabled (section 5.3.3) then selecting an ocean region by writing to the Ocean Region register may not result in the terminal using the selected ocean region. For example, consider a terminal that is located in Brazil and configured in follow best mode. In this location two satellites are visible; AORE and AORW, with the latter being higher in the sky. If a value of 02 is written to this register then the terminal will switch to use AORE but, on the next GPS update, the follow best algorithm will switch the terminal back to AORW.
Page 18 of 120
Commercial In Confidence
3 4 5 6 7 8..15
Commercial In Confidence
the terminal attempts to switch to the bulletin board frequency, it cannot detect the satellite signal.
4 5 6 7 8
9..31
Page 20 of 120
Commercial In Confidence
5.3.10
If no GEM-100 unit is connected, this register will always be read as 1; i.e. external supply present and no solar panel supply. If a GEM-100 is utilised, this register reports the status of the power supplies connected to the GEM-100. Bit 0 1 2..31 Function External dc power supply present Solar panel supply present Reserved for future use. Write as 0
Page 21 of 120
Commercial In Confidence
5.3.11
The terminal can output NMEA-0183 type sentences over the serial port. The NMEA sentences supported are RMC, GGA and GSV. The sentences to be output are enabled by setting individual bits in the NMEA output control register as detailed in Table 16. Bit 0 1 2 3..31 Function Enable output of RMC sentence Enable output of GGA sentence Enable output of GSV sentence Reserved for future use. Write as 0 Table 16 NMEA Message Enable Bits One set of enabled NMEA sentences is output on each GPS position update (i.e. once per second). If GPS is not enabled then the output of NMEA sentences is inhibited. The GSV sentence only holds information for up to four satellites, therefore if more satellites are in view multiple GSV sentences might be output at each update. See paragraph 7.15 for details on the RMC, GGA and GSV sentences. Primary Information Time, 2D location, heading, speed Time, 3D location Satellites in view: azimuth, elevation, signal strength
5.3.12
The terminal can be programmed to wake at intervals so that it can listen to the forward channel traffic channel frame header and receive any messages that are being sent to it. The slotted receive mode register sets the interval between terminal wakeup events. The values that can be written to the register are shown in Table 17 below. Value 0,1 2 3 4 5 6 Interval in Frames 0 (Continuous Operation) 4 8 16 32 64 Interval in Minutes 0 (Continuous Operation) 2 4 8 16 32
Table 17 Slotted Receive Mode Register Values If a forward message is received that is a poll and/or requires an acknowledgement, then the terminal will remain awake to transmit the response.
5.3.13
When the terminal is operating in slotted receive mode it may fail to acquire the satellite signal due to either the terminal having an obstructed view of the sky or the terminal having moved out of the satellite coverage area. If the terminal wakes up but cannot acquire either GPS or the Traffic Channel it will assume that it has a totally blocked sky-view and will go back to sleep until the next wake up slot. If the Traffic Channel cannot be acquired but GPS can then, if this condition persists for n wake up slots, the terminal will stay awake and perform a satellite search. The value n is held in this Maximum Acquisition Retries register. Honeywell Global Tracking Page 22 of 120
Commercial In Confidence
5.3.14
This is a read only register containing the terminal ISN and PSN. Bits 0..23 24..27 28..31 Contents Terminal ISN (not including the DSTxxx part) Spare (zeros) Terminal PSN Table 18 ISN Register Bit Allocation
5.3.15
Hardware Version
This is a read only register containing the terminal hardware build configuration value. Bits 0..3 hold the build number and Bits 4..7 hold the Printed Circuit Board (PCB) issue number..
5.3.16
Group PID
These read only registers contain the terminals Group PIDs. A zero indicates that a Group PID has not been configured. The Inmarsat-D Service provides for messages to be sent to a group of terminals. This service is achieved by programming terminals with a further PID (i.e. Group PID), which is identical for all terminals in one group. The terminal can be programmed with up to 5 Group PIDs. Contact Honeywell Global Tracking for more information or to obtain a Group PID. Programming of GPIDs is done via the password protected DS TG command (paragraph 7.14.6).
5.3.17
Service ID / Beam ID
These read only registers contain the pre-programmed Service ID / Beam ID pairings. A specific pairing is selected via the Service ID Selection register (see paragraph 5.3.2).
5.3.18
Operational Flags
This read only register reflects the value of the Operational flags as configured via the DS TO command (paragraph 7.14.11).
5.3.19
Terminal Mobility
This read only register reflects the value of the Terminal Mobility flag as configured via the DS TM command (paragraph 7.14.9).
5.3.20
This register is only present in SAT-200 firmware versions 1.10 and later. The value written to this register configures the operating mode of the terminal firmware. Normal operation is configured by writing the value 0x00. Other values configure the firmware to operate in special modes required for specific products. Honeywell Global Tracking
Page 23 of 120
Commercial In Confidence
5.3.21
PACC Enable
Writing a 1 to this register enables the PACC satellite to be used as a candidate for selection by the satellite roaming algorithm. If disabled, then a terminal that is within the coverage area for PACC will choose either POR or AOR-W when it is selecting the best satellite using the GPS position information. The state of this register is stored in non volatile memory and is not erased when the processor firmware is updated. The default setting is PACC enabled.
5.3.22
This bit must be set to 1 if the terminal is connected to a GEM-100, otherwise the bit should be cleared to 0 (default). The GEM-100 provides additional interfaces and battery back up capability. When the GEM-100 interface is enabled, interface channels 4 and 5 on the terminal are disabled (see paragraph 5.6).
5.3.23
Terminal Reset
Write only register. Writing to this register will cause the terminal to perform a reset. If a value of 0 is written, the terminal reset is delayed until the transmit queue is empty so that a reset request sent over the forward channel may be acknowledged. If any other value is written then the terminal reset will be performed immediately with no acknowledgement (even if requested) being transmitted.
5.3.24
Scripting Capabilities
This read only register provides details on the total number of scripting operations, timers and alarms that are available within this particular terminal product. Bits 0..7 8..15 16..23 Information Number of alarms Number of timers Number of operations
Page 24 of 120
Commercial In Confidence
Page 25 of 120
Commercial In Confidence
Field Width 1 1 1 5 24
Function Timer Enable Timer Repeat Mode Timer Mode Operation Number Timer Trigger Value
Table 20 Timer Configuration Register Field Definitions 5.4.3.1 Enable When this bit is set the timer channel is enabled, when cleared the timer channel is disabled. 5.4.3.2 Repeat When this bit is clear the timer channel operates in single shot mode, when the timer reaches its terminal count the operation is triggered and the timer is automatically disabled. When the bit is set the timer operates in repeat mode; when it reaches its terminal count the operation is triggered, the count register is reset to zero and the count restarts. 5.4.3.3 Mode The mode bit sets the timer to operate in either interval (bit clear) or time of day (bit set) modes. In interval mode the terminal count value represents the number of seconds that the timer is to count before the event trigger. In the time of day mode the terminal count value indicates the time, in seconds past midnight UTC, at which the event is to be triggered. 5.4.3.4 Operation Number The operation number field is a 5 bit number (0..31) indicating the operation that is to be triggered when the timer reaches its terminal count. This field size limits the operations that the timer channels can trigger, i.e. a timer channel cannot trigger operations in the range 32 to 63. 5.4.3.5 Terminal Count Value The terminal count value is a 24-bit number representing the trigger value for the timer. The maximum value that can be stored is 16777215 seconds or just over 194 days. The terminal count value may also be set by writing to the terminal count value register for the channel. This provides an easy way to modify a timer trigger value from within a script without having to preserve the least significant bits of the configuration register.
Page 26 of 120
Commercial In Confidence
timer 31 by the MSB. Writing a 1 to the channel control bit causes the timer to stop counting. The value reached in the timer count register is held. 5.4.4.2 Start Timers The start timers register is a 32-bit write only register. The value written to this register is a bit mask of the channels to be started. Timer 0 is indicated by the LSB of the value and timer 31 by the MSB. Writing a 1 to the channel control bit causes the timer to start counting from the current value in the count register. 5.4.4.3 Reset Timers The reset timers register is a 32-bit write only register. The value written to this register is a bit mask of the channels to be reset. Timer 0 is indicated by the LSB of the value and timer 31 by the MSB. Writing a 1 to the channel control bit causes the timer to stop counting and the count register to be set back to zero. 5.4.4.4 Restart Timers The restart timers register is a 32-bit write only register. The value written to this register is a bit mask of the channels to be restarted. Timer 0 is indicated by the LSB of the value and timer 31 by the MSB. Writing a 1 to the channel control bit causes the timer to restart its count from zero without triggering an operation. 5.4.4.5 Combined Operation to Enable and Disable Timer Channels This function is only available for timer channels 0 to 15. The timer channels to be enabled are defined by the bits set within the 16 most significant bits of the 32-bit operation parameter value. The timer channels to be disabled are defined by the bits set in the bottom 16 bits of the 32-bit operation parameter value. 5.4.4.6 Combined Operation to Restart and Reset Timer Channels This function is only available for timer channels 0 to 15. The timer channels to be restarted are defined by the bits set within 16 most significant bits of the 32-bit operation parameter value. The timer channels to be reset are defined by the bits set in the bottom 16 bits of the 32-bit operation parameter value.
Page 27 of 120
Commercial In Confidence
The timer channels to be disabled are defined by the bits set within 16 most significant bits of the 32-bit operation parameter value. The alarm channels to be disabled are defined by the bits set in the bottom 16 bits of the 32-bit operation parameter value. 5.4.5.3 Mixed Operation to Restart Timer and Alarm Channels This function is only available for timer and alarm channels 0 to 15. The timer channels to be restarted are defined by the bits set within 16 most significant bits of the 32-bit operation parameter value. The alarm channels to be restarted are defined by the bits set in the bottom 16 bits of the 32-bit operation parameter value. 5.4.5.4 Mixed Operation to Reset Timer and Alarm Channels This function is only available for timer and alarm channels 0 to 15. The timer channels to be reset are defined by the bits set within 16 most significant bits of the 32-bit operation parameter value. The alarm channels to be reset are defined by the bits set in the bottom 16 bits of the 32-bit operation parameter value.
Page 28 of 120
Commercial In Confidence
The alarm channels in the terminal are divided into two groups that respond to an update of the threshold value in slightly different ways. If the threshold value on any of the alarm channels 0 to 11 or 16 to 31 is updated as the result of a script operation then, if the terminal is restarted following a power down, the alarm threshold value will reset to the value defined in the original script. Channels 12 to 15 operate slightly differently following a system reset. These four channels will restart with the updated threshold value that was set by the script operation.
Page 29 of 120
Commercial In Confidence
Field Width 1 1 1 5 4 4 3 1 8 4
Function Alarm Enable Latch Alarm Auto Latch Release Operation Number (Low Part) Threshold Comparison Mode Reserved - Leave as Zero Operation Number (High Part) Reserved - Leave as Zero Target Register Number Target Module Number
Table 22 Alarm Configuration Register Field Definitions 5.5.3.1 Enable When this bit is set the alarm channel is enabled, when cleared the alarm channel is disabled. 5.5.3.2 Latch Mode In latch mode an alarm will trigger once when the alarm condition is first detected. The alarm will not be raised again until it has been reset using the reset alarm command in the control register or by setting the channel bit in the reset register. 5.5.3.3 Auto Latch Release If the alarm is in latch mode then when the auto latch release bit is set, the latch will be removed automatically when the alarm condition is removed. As an example, if an alarm is set to trigger when an I/O line goes high then the alarm will trigger on the first detection of the bit going high. The latch will be set so that the alarm does not trigger on the next alarm polling cycle. On a later polling cycle the I/O line is low again and, if the auto release bit is set, the latch will be removed allowing the alarm to re-trigger the next time that the I/O line goes high. This removes the need to issue a reset alarm command to clear the latch manually. 5.5.3.4 Operation Number The operation number field is an 8 bit number indicating the operation number that is to be triggered when the comparison function raises the alarm. The value is split into two parts in the register; the original 5 bits (Low Part), used in legacy terminals where only 32 operations were available, has been extended by 3 bits (High Part) to cater for the 64 operations currently available, and to allow for possible future expansion to 256 operations.
Page 30 of 120
Commercial In Confidence
Table 23 Alarm Comparison Mode Codes 5.5.3.6 Target Register ID The target register for the alarm is defined by a 12-bit address, made up from a 4 bit module ID and an 8 bit register address. These register addresses are defined in the separate module description sections within this document.
Page 31 of 120
Commercial In Confidence
5.5.5.3 Reset Alarms The reset alarms register is a 32-bit write only register. The value written is a bit mask of the channels to have their latches reset. Alarm 0 is indicated by the LSB of the value and alarm 31 by the MSB. Writing a 1 to the channel control bit causes the alarm latch to be reset. 5.5.5.4 Trigger Alarms The trigger alarms register is a 32-bit write only register. The value written to this register is a bit mask of the channels to be triggered. Alarm 0 is indicated by the LSB of the value and alarm 31 by the MSB. Writing a 1 to the channel control bit causes the alarm to be triggered. 5.5.5.5 Toggle Alarms The toggle alarms register is a 32-bit write only register. The value written to this register is a bit mask of the channels for which the enable state is to be toggled. Alarm 0 is indicated by the LSB of the value and alarm 31 by the MSB. Writing a 1 to the channel control bit causes a disabled alarm to be enabled and an enabled alarm to be disabled. 5.5.5.6 Restart Alarms The restart alarms register is a 32-bit write only register. Writing to this register allows a simultaneous clearing of the alarm latch and enabling the alarm if it was previously disabled. The value written to this register is a bit mask of the channels to be unlatched and enabled. Alarm 0 is indicated by the LSB of the value and alarm 31 by the MSB. Writing a 1 to the channel control bit causes that channel to be affected. 5.5.5.7 Combined Operation to Enable and Disable Alarm Channels This function is only available for alarm channels 0 to 15. The alarm channels to be enabled are defined by the bits set within 16 most significant bits of the 32-bit operation parameter value. The alarm channels to be disabled are defined by the bits set in the bottom 16 bits of the 32 bit operation parameter value.
Page 32 of 120
Commercial In Confidence
IO4, IO5 (Internal channels 4 & 5) GEM-100 IO4 to IO7 (Internal channels 4 to 7)
Analogue Input High Volt Digital Input (Polled or Interrupt) Digital Input (Polled or Interrupt) Alert Digital Input (Polled or Interrupt) Digital Output Analogue Input Digital Input (Polled) Digital Output Analogue Input Digital Input (Polled or Interrupt) Alert Digital Input (Polled or Interrupt) Digital Output
Table 24 Valid I/O Channel Configurations The register contains eight 4-bit fields, one for each channel. The pin mode is defined by the code written in the field associated with that pin. The codes are described in Table 25 below.
Bit 31 Bit 30 Bit 29 Bit 28 Bit 27 Bit 26 Bit 25 Bit 24 Bit 23 Bit 22 Bit 21 Bit 20 Bit 19 Bit 18 Bit 17 Bit 16
Channel 3 Mode
Channel 2 Mode
Channel 1 Mode
Channel 0 Mode
Page 33 of 120
Commercial In Confidence
I/O Pin Configuration Analogue Input High Volt Digital Input Digital Input Alert Digital Input High Volt Digital Input Interrupt Digital Input Interrupt Alert Digital Input Interrupt Digital Output Open Drain Out 4-20mA Current Loop Analogue Output
Value = Voltage
4096 2 .5
Channels not configured as analogue inputs will always return a conversion result of 0. Important: There is a short delay between setting an I/O to an analogue input, and the associated register being updated with the first valid conversion result. Scripts that compare analogue input values with a threshold should therefore allow 10 seconds, following I/O configuration (i.e. normally only after initial power on), for the first conversion to complete.
Chan 0
Page 34 of 120
Commercial In Confidence
Chan 0
Page 35 of 120
Commercial In Confidence
5.6.10
When a GEM-100 is utilised, its battery pack temperature is stored in a 16-bit wide, signed integer format. The value is the temperature x 10. (i.e. steps of 0.1 degree Celsius) except; a value of 2550 indicates battery pack not fitted, and a value of 0 is always returned if a nonrechargeable battery is fitted. If a GEM-100 is not used, this register will always return the value 2550 (decimal) indicating battery pack not fitted.
5.6.11
The GEM-100 can output its battery supply voltage on I/O pin 7. This is controlled by a 1-bit value in the battery output enable state register. Writing a 1 to this register enables the battery output, zero returns the I/O line to its normal use as defined by the I/O configuration register.
5.6.12
The GEM-100 unit has a second, user programmable LED indicator. The state of this LED is controlled by a two bit value written to this register. The LED colours displayed are shown in Table 26 below. Value 0 1 2 3 Colour Off Red Green Orange
Page 36 of 120
Commercial In Confidence
Table 27 Latitude/Longitude Data Format 5.7.1.3 Longitude The GPS longitude register contains the last value for the terminal position as read from the GPS receiver. The format of the value is shown in Table 27. 5.7.1.4 Speed The GPS speed register contains the last value for terminal unit speed as read from the GPS receiver. The speed is stored as a value in the range 0..32767 with a resolution of 0.1 m/s. 5.7.1.5 Heading The GPS heading register contains the last value for the terminal heading as read from the GPS receiver. The heading is stored as a value in the range 0..3599 and with a resolution of 0.1 degrees.
Page 37 of 120
Commercial In Confidence
5.7.1.6 Altitude The GPS Altitude register contains the last value for the terminal altitude as read from the GPS receiver. The altitude is stored as a value in metres. 5.7.1.7 Horizontal Dilution of Precision (HDOP) The HDOP provides an indication of positional accuracy; the lower the HDOP the better. The HDOP register provides an integer value which is the HDOP * 100. The 16 bit register is set to 0xFFFF if the GPS reading is invalid. For example a register value of 0x00FA would indicate a HDOP of 2.5.
Page 38 of 120
Commercial In Confidence
5.7.3.1 Distance from Target There are 8 independent read only distance from target registers. These contain the calculated distance, in metres, between the relevant target position and the current GPS position. These registers may be used by the alarms module to generate an event based on the terminals position relative to the target. If the target definition has not been initialised then the register cannot generate an alarm. 5.7.3.2 Distance to Closest Target This register contains the distance, in metres, from the current position to the closest valid target position. If there are no valid targets defined then the value returned will be 0xFFFFFFFF. 5.7.3.3 Distance to the Farthest Away Target This register contains the distance, in metres, from the current position to the farthest away valid target position. If there are no valid targets defined in the terminal then the value returned will be 0. 5.7.3.4 Target Latitude There are 8 independent read only registers each of which contain the latitude value of one of the target positions. The value is stored in the format defined in Table 27. 5.7.3.5 Target Longitude There are 8 independent read only registers each of which contain the longitude value of one of the target positions. The value is stored in the format defined in Table 27.
5.7.6 Geofence
The terminal allows for the definition of two geofence areas. These areas are each defined by a sequence of up to 40 points. These areas are used to determine whether or not the terminal location is within the selected global regions. Geofence definition and configuration uses the operator commands defined in section 7.8.3. An example of Geofence definition is described in APPENDIX A Example Geofence Definition.
Page 39 of 120
Commercial In Confidence
5.7.6.1 Geofence Status The geofence status registers 1 and 2 contain the result of comparing the current GPS position with geofences 1 and 2 respectively. The values read from these registers are defined in Table 28. Register Value 0x00 0x01 0xFF Meaning Point Outside the defined area Point inside defined area Area not defined
Page 40 of 120
Commercial In Confidence
Page 41 of 120
Commercial In Confidence
Table 29 Return Message Type Numbers 5.8.1.1 Creating User Defined Messages In addition to the standard messages that may be transmitted by the terminal it is possible to define custom message formats that are built up from data values extracted from the terminals internal registers. User message definition uses the operator commands defined in section 7.12. Details of how to construct a user-defined message is provided in Appendix B Example User Message Definition.
Page 42 of 120
Commercial In Confidence
a value of zero to this data register turns off the message scrambling feature. Contact Honeywell Global Tracking for more details on message scrambling.
Value =
5.8.7.3 Receiver Status
This register contains the receiver status byte as returned by the terminal. The fields within the byte are shown in Table 30 below. Bits 0 1 2 3 4..6 Meaning Condition (0 = Normal, 1 = Abnormal) BB Alarm (0 = Normal, 1 = Alarm) BB/Traffic Indicator (0 = BB, 1 = TC) Reserved Receiver Status Code: 0 = DSP Reset 1 = Configuring 2 = Wideband Acquisition 3 = Narrowband BB 4 = BB Tracking and Demodulation 5 = Narrowband Traffic 6 = Traffic Tracking and Demodulation 7 = Reserved Reserved
Table 30 Receiver Status Byte Fields An abnormal condition on the bulletin board can be one of the following: Bulletin board does not contain an entry for the configured terminal service ID. Bulletin board does not contain an entry for the configured terminal Beam Number. Bulletin board does not contain an entry for the configured terminal pager subset number.
Commercial In Confidence
The format of the fields in this register is as shown in Table 31 below. Bits Meaning 0..2 Transmission state 0 = Reserved 1 = Tx Acceptance 2 = Waiting to Transmit 3 = Transmitting 4 = Transmission complete 3 PLL Unlocked 4 Transmission Waiting 5..7 Transmit Inhibit Reason 0 = Transmission enabled 1 = TX Inhibit by PLL unlock 2 = TX Inhibit by RX condition 3 = TX Inhibit by System Message 4 = TX Inhibit by Waiting for ACK 8..9 Traffic Control 10..11 Burst Type 0 = ACK burst 2 = Long Burst (or part of Double Burst) 12..15 Reserved 16..19 Minutes(1) 20..23 Minutes(10) 24..27 Hours(1) 28..31 Hours(10) Table 31 Transmitter Status Register Fields The time value reported is the time of last message transmission or 00:00 if the terminal has not sent a message. The time is reset each time that the terminal is powered down or enters sleep mode.
Commercial In Confidence
between terminal transmissions and hence data loss. Collisions can be minimised by ensuring an even spread (in time) of transmissions from the terminal population. This can be achieved by specifying a larger number for the slot randomisation. If an application has a large number of terminals configured to transmit at a single time of day then that application might suffer a high message loss, but because the transmissions generated by this application occur over a small period of time the effect upon other applications, that spread their transmissions more evenly, is negligible.
5.8.10
Transmit Retries
For messages transmitted with a request for an LES acknowledgement, the terminal can be configured to re-send the message if an LES acknowledgement is not received. The Transmit Retries register sets the number of retries (0 to 15) to be attempted. There will be at least 90 seconds (three frames) between each retransmission to allow time for an LES acknowledgement to be received.
5.8.11
Inmarsat-D received signal level multiplied by -100. E.g. a value of 0x109E (=decimal 4254) would equate to a signal level of -42.54dBm.
5.8.12
Inmarsat-D received signal frequency offset, in Hz, from the nominal channel frequency.
5.8.13
5.8.14
Provides the number of corrected errors in the data portion of the most recently received Inmarsat-D frame. As the data portion of the frame is variable in size, depending on the amount of data traffic, this parameter should be used for indication purposes only if used to gauge quality of service.
5.8.15
This is a read only register that contains the number of return channel messages that are awaiting transmission that was reported by the DSP at the last update. The value reported is that received from the DSP as the transmit messages pending parameter in the TT message report.
5.8.16
This is a read only register that contains, in the bottom 4 bits, the length of the return channel transmit message queue and, in the next bit the queue message insertion mode as these were reported by the DSP at the last update. The values reported are those received from the DSP in the TW message report.
Page 45 of 120
Commercial In Confidence
5.8.17
These two registers are used to control the regular reporting capability of the terminal. The terminal can produce regularly timed return message bursts containing any of the standard format messages defined in paragraph 5.8.1. 5.8.17.1 Poll Message ID The poll message ID register contains the message number to be transmitted in the regular return burst from the terminal. This may be one of the standard message ID numbers as defined in Table 29 or the number of one of the user defined message formats programmed into the terminal. 5.8.17.2 Poll Message Repeat Rate The poll message repeat rate defines the interval between message transmissions in seconds. The message transmission interval will not take place at the exact second spacing defined by this message due to space network limitations and the protocol for transmissions used by the terminal. The interval specified is the time between the requests to the terminal transmitter to send the message. There are a number of limitations to the values that can be written to this register. 0 1 .. 60 61..599 600 up Disables Poll messages Transmits a single poll report Transmits messages at 600 second (10 minute) intervals, the value written to the register is automatically rounded up to 600. Transmits messages at the requested intervals
5.8.18
These four registers contain the return burst numbers to be transmitted by the terminal in response to a tone only forward channel message. This message number may be one of the standard messages or a valid user defined message number. If the value stored is zero then the terminal will not respond to the tone only message but will output the message data over the serial port in the normal way using the unsolicited mf message or the user polled mc and mn messages.
5.8.19
The forward channel message output control register controls whether or not messages received over the satellite by the terminal are output as unsolicited mf messages. If the LSB of the register is clear (default) then the terminal will pass any user forward channel messages received out of the serial port as an mf message paragraph 7.9.1.3). If the bit is set then the message output is disabled and the messages must be read out by polling the terminal using the MC and MN commands (paragraphs 7.9.1.2 and 7.9.1.4 respectively).
Page 46 of 120
Commercial In Confidence
Page 47 of 120
Commercial In Confidence
5.10.1
Operation Definitions
An operation within the terminal takes a pre-programmed value and applies it to one of the registers available in the functional module. An operation is triggered by an alarm, a timer or another operation (a chained operation). Each operation is defined by two registers; the configuration register and the value register. The first of these defines the target of the operation and the operation to be performed on that target register. It also defines whether or not another operation is to be performed after this one, whether the operation is part of a chain. The second, or value register, contains the value that is to be used in calculating the value to be written to the target register. This may be a value to be written directly to the target, an up or down increment to be applied to the current value or it may be a binary bit mask to be applied to the target register value.
5.10.2
There is one operation configuration register for each of the 64 operations provided by the terminal. The register is a 32-bit value divided up into fields as shown in the table below. Bits 0 1 7..3 11..8 12 13 15..12 18..16 19 27..20 31..28 Field Width 1 1 5 4 1 1 4 3 1 8 4 Function Operation Enable Operation Chaining Enable Chained Operation (Low Part) Operation Function Update Stored Script Do Not Update Running Script Reserved leave as zero Chained Operation (High Part) Reserved Leave as zero Target Register Number Target Module Number
Table 32 Operation Configuration Register Field Definitions 5.10.2.1 Operation Enable Operations are enabled by setting the Operation Enable bit of the relevant operation configuration register. (Also see paragraph 5.10.5) 5.10.2.2 Operation Chaining Operations may be configured so that they operate in a sequence. This is called a chain and is enabled by setting the Operation Chaining Enable bit of the relevant operation configuration register. If chaining is enabled then once an operation is complete the next operation in the chain will be performed. The next operation in the chain is defined in the Chained Operation field (split into a Low part and High part).
Page 48 of 120
Commercial In Confidence
5.10.2.3 Operation Function Codes The 4 bit operation function code defines the operation to be performed on the target register. The codes used to define the operations are listed in Table 33.
Function Code 0x0 0x1 0x2 0x3 0x4 0x5 0x6 0x7 0x8 0x9 0xA 0xB Operation No Operation Store Value Bitwise And Bitwise Invert And Bitwise Or Bitwise Invert Or Bitwise Exclusive-Or Unsigned Add <reserved> Unsigned Subtract <reserved> Last Operation Result of Operation Target not written Target = Value Target = Target & Value Target = Target & ~Value Target = Target | Value Target = Target | ~Value Target = Target ^ Value Target = Target + Value <undefined> Target = Target - Value <undefined> Target = Trigger Value (1st operation in chain) or Result of last operation Target = Target << Value Target = Target >> Value <undefined> <undefined> TSL Syntax myTarget NOP myTarget = myValue myTarget AND myValue myTarget AND NOT myValue myTarget OR myValue myTarget OR NOT myValue myTarget XOR myValue myTarget += myValue myTarget -= myValue myTarget LASTOP
Table 33 Operation Function Codes If an operation is performed on a write only register then the value of the target register before the operation is performed will always be zero. This means that operations 2, 3 and 9 will always write 0 to the target register, 1, 4 and 7 will write value to the target, 5 and 6 will write the complement of value to the target. The result value for each operation performed is written to Scratchpad register 0 as well as the target specified in the operation. Performing a NOP on a register reads its value into scratchpad register 0 so that its value can be used by the LASTOP function. 5.10.2.4 Update Stored Script Scripts are stored in non-volatile memory within the terminal and copied into and run from RAM following power on. Operations can be configured such that any modifications to scripting registers (e.g. timer value changes) either: 1. Survive a power cycle or; 2. Be lost on a power cycle or reset, with the script reverting to its originally uploaded state. If the Update Stored Script bit in the operation control word is set then the value written to the Target register will also be stored to non volatile memory so that the changes to the script will survive a power cycle or reset. This is primarily intended to allow the updating of timer and alarm trigger values but may be used to set other terminal configuration values. 5.10.2.5 Do Not Update Running Script (See also 5.10.2.4.) When this bit is set the value written by the operation is not written to the active Target register. But, if the Update Stored Script bit is set then the copy of the
Page 49 of 120
Commercial In Confidence
Target register stored in non volatile memory will be updated, causing the operation of the script to be modified from the next terminal power cycle or reset. 5.10.2.6 Target Register ID The target register for the operation is defined by a 12 bit address, made up from a 4 bit module ID and an 8 bit register address. These addresses are defined in the separate module description sections within this document.
5.10.3
The operation value register contains a 32 bit unsigned integer value that is used by the function defined in the operation configuration register to modify the value stored in the operations target register.
5.10.4
Disable Operations
Two 32-bit write only registers provide the ability to disable multiple operations. One register affects operations 0 (LSB) to 31 (MSB), the other affects operations 32 (LSB) to 63 (MSB). Writing a 1 to the relevant bit causes the operation to be disabled. On being disabled, the values stored in the operation registers are held at their current state until the operation is re-enabled.
5.10.5
Enable Operations
Two 32-bit write only registers provide the ability to enable multiple operations. One register affects operations 0 (LSB) to 31 (MSB), the other affects operations 32 (LSB) to 63 (MSB). Writing a 1 to the relevant bit causes the operation to be enabled.
5.10.6
Reset Operations
Two 32-bit write only registers provide the ability to reset multiple operations. One register affects operations 0 (LSB) to 31 (MSB), the other affects operations 32 (LSB) to 63 (MSB). Writing a 1 to the relevant bit causes the operation to be reset. A reset causes the operation configuration and value registers to be cleared and these must be reconfigured before they can be re-enabled.
5.10.7
Trigger Operations
Two 32-bit write only registers provide the ability to trigger multiple operations. One register affects operations 0 (LSB) to 31 (MSB), the other affects operations 32 (LSB) to 63 (MSB). Writing a 1 to the relevant bit causes the operation to be triggered. When an operation is triggered any other operations that are chained after the triggered operation will also be triggered. If more than one operation is triggered then the lowest numbered operation (or operation chain) will be triggered first.
Page 50 of 120
Commercial In Confidence
Page 51 of 120
Commercial In Confidence
Table 34 Trigger Operation Forward Channel Message The 32-bit parameter value is written into scratchpad register 0 from where it may be used by the first operation in the programmed chain. If the parameter value is omitted then a value of zero is assumed by the terminal. NOTE Operations that have to be triggered over the air must be defined within the first 32 of the 64 available. It is not possible to trigger operations 32 to 63 directly using a trigger operation forward channel message.
Page 52 of 120
Commercial In Confidence
Page 53 of 120
Commercial In Confidence
Module ID Register Address Do Not Update Running Script Update Stored Script Number of Data Bytes
Variable
Data
Table 38 Remote Register Read/Write Message To reduce the amount of data that is transmitted to the terminal the message contains a number of data bytes field that allows the data to be sent as zero, one, two or four bytes depending upon the size of the target register or the data value to be written. Any bits not included in the data value sent are assumed by the terminal to be zero. If the number of data bytes is set to zero then no data field is required and, if a write function has been selected, a value of zero will be written to the target scripting register. If the message command ID is 0xC5 then the terminal will transmit a return channel message for each target register. If the Do Not Update Running Script bit is set then the value returned will be the unmodified contents of the running script register. If the Do Not Update Running Script bit is clear the value returned will be the updated running script copy of the register, providing confirmation that the change has occurred. Multiple register updates are performed by repeating the Module ID to Data fields for each of the registers to be updated. This is demonstrated by the example below which writes to three registers using a single forward channel message:
Page 54 of 120
Commercial In Confidence
Field Command ID Module Register RAM EEPROM Payload Size Payload Data Module Register RAM EEPROM Payload Size Payload Data Module Register RAM EEPROM Payload Size
Data Value 0xC4 0x1 0x43 0 0 1 0x64 0x2 0x24 1 1 2 0x2317 0x7 0x26 0 1 0
Description 0xC4 Write Register Timer module number Register address being accessed within the module Update value in RAM Not update EEPROM store 8 bit payload data Data value written to the script register Alarm module number Register address being accessed within the module Not update value in RAM Update EEPROM store 16 bit payload data Data value written to the script register Operation module number Register address being accessed within the module Update value in RAM Update EEPROM store 0 bit payload data
Table 39 Example of Multiple Register Update Message Data Structure The data structure shown in Table 39 is then built into the message payload: c4 1 43 1 64 2 24 E 2317 7 26 4
Page 55 of 120
Commercial In Confidence
The <carriage_return> character on a command may be followed by a <line-feed> character. In the following Command description sections the following conventions apply <SP> is the ASCII code for a space character (0x20) <CR> is the ASCII code for a carriage return (0x0D) <LF> is the ASCII code for a line feed character (0x0A) Note: The maximum number of characters in any command, from the first <char> to the <carriage_return> is 39. If this length is exceeded, for example by adding extra <optional_space> characters then an error message will be generated and the command will be ignored.
Page 56 of 120
Commercial In Confidence
These commands allow the user to put the terminal into another mode where the required command is active, to reset the terminal operation to a default state and to turn off the script operation within the terminal to allow recovery from a scripting fault when the terminal is continuously being switched back into sleep mode.
Page 57 of 120
Commercial In Confidence
Page 58 of 120
Commercial In Confidence
The CF? command is used to determine whether the terminal has been configured to transmit its position report message on power up: Command Format Response Format <state> CF?<CR> cf<SP><state><CR><LF> single ASCII digit; 1 if the terminal is configured to transmit on power up and 0 if it is not.
Page 59 of 120
Commercial In Confidence
Response Format
<control_flags> 2 digit ASCII hex representation of a byte value. The value is stored in the NMEA output control register (module 0x0, register 0x20) see paragraph 5.3.11.
Response Format
<script_version> 4 ASCII characters comprising the script version string. The meaning of the 4 characters is defined by the user. The version string is stored in the Script application version register (module 0x0, register 0x07) see paragraph 5.3.7.
Page 60 of 120
Commercial In Confidence
7.3.10
The CU command provides a shorthand method of setting the operating power mode. Bits within the Power Control register (module 0x0, register 0x03) are set/cleared according to the power mode selected (see paragraph 5.3.4). This will therefore affect the value returned by the CE? command. Similarly, using the CE command to set/clear bits in the Power Control register can change the operating power mode and therefore the value returned by the CU? command. Command Format CU<power_mode><CR> CU?<CR> cu<SP><power_mode><CR><LF> single ASCII digit string containing the operating power mode. Valid values are shown in Table 41 below.
Value 0 1 2 3 4
Minimum
power
consumption
GPS off, Inmarsat-D off GPS on, Inmarsat-D off GPS off, Inmarsat-D on GPS on, Inmarsat-D on
7.3.11
The CV command is used to get the DSP software version number. Command Format Response Format <DSP_version> CV?<CR> cv<SP><DSP_version><CR><LF> 4 ASCII characters comprising the DSP version string. The value is read from the DSP firmware version register (module 0x0, register 0x05) see paragraph 5.3.5.
Page 61 of 120
Commercial In Confidence
7.3.12
The CW command is used to wipe the terminal script. The script is cleared from the RAM and all timers, alarms and operations are reset. If a script has been stored in the nonvolatile memory then this is NOT cleared and will be reloaded if the processor is reset or a CR command is issued. The version string set for the script via the CS command is used as a password to prevent inadvertent program erasure. If the password is entered incorrectly then the stored script is not overwritten and the version string returned will be set to ****. Command Format Response Format CW<script_version><CR> cw<SP><script_version><CR><LF>
7.3.13
This command writes the current script application to non-volatile memory and has the equivalent effect as writing to the Store Application Script scripting register see paragraph 5.3.8. The script version string is used as a password to prevent inadvertent overwriting of the stored script. If the password is entered incorrectly then the stored script is not overwritten and the version string returned will be set to ****. Command Format Response Format CZ<script_version><CR> cz<SP><script_version><CR><LF>
<script_version> 4 ASCII characters comprising the script version string. The first two characters are the major version and the second two characters the minor version number.
Page 62 of 120
Commercial In Confidence
<value>
Response Format
<configuration> 8 ASCII hex characters representing a 32-bit word value. The value is stored in the I/O Configuration register (module 0x03, register 0x02) see paragraph 5.6.1 for valid i/o configurations. If an invalid configuration is entered for any of the channels, no change in any of the channel configurations will occur, and an error will be reported,
Page 63 of 120
Commercial In Confidence
Page 64 of 120
Commercial In Confidence
If no GEM-100 unit is connected, this command will always reply with the response ii 1 indicating that the external supply is present and that there is no solar panel supply.
Page 65 of 120
Commercial In Confidence
If no GEM-100 is connected, this command will always reply with the response iq 255 indicating that no battery is fitted.
If a GEM-100 is used the value returned is the external supply voltage applied to the GEM100.
7.4.10
The IT command is used to read the temperature sensor in the terminal. The value returned is for indication only. The associated scripting registers are module 0x03, registers 0x1A and 0x1F see paragraphs 5.6.8 and 5.6.9. Command Format Response Format <temp_value> IT?<CR> it<SP><temp_value><CR><LF> signed ASCII string containing the measured temperature value in Celsius. The format of the temperature value is +dd
7.4.11
The IU command is only available if a GEM-100 is utilised and is used to set or read the state of the user LED on the GEM front panel. Command Format IU<SP><colour><CR> IU?<CR> IU<SP><colour><CR> single decimal number (0 to 3) representing the colour of the user LED. The value is stored in the User LED state register (module 0x03, register 0x30) - see paragraph 5.6.12.
Page 66 of 120
Commercial In Confidence
7.4.12
The IX command is used to read the measured battery supply voltage of the GEM-100. The associated scripting register is module 0x03, register 0x1B see paragraph 5.6.7 Command Format Response Format <value> IX?<CR> ix<SP><value><CR><LF> 5 character decimal number representing the battery supply voltage in mV.
If a GEM-100 is not utilised this command will always respond with ix 00000.
Page 67 of 120
Commercial In Confidence
<config_value>
Commercial In Confidence
2 character ASCII hex representation of the timer channel number (00..1F) 6 character ASCII hex representation of the 24 bit timer trigger value.
<trig_value>
Page 69 of 120
Commercial In Confidence
<timer_value>
Page 70 of 120
Commercial In Confidence
<config_value>
Page 71 of 120
Commercial In Confidence
<threshold>
Page 72 of 120
Commercial In Confidence
2 digit hex number in the range 0x00..0x3F 8 digit ASCII hex number representing a 32 bit configuration value for the operation number. 8 character ASCII hex number value that is used in performing the operation.
<value>
<operation_mask> 8 character ASCII hex representation of a 32 bit mask value. Bits 0 (LSB) to 32 (MSB) represent operation channels 0 to 32 respectively. If a bit is set, the corresponding operation channel is disabled.
Page 73 of 120
Commercial In Confidence
<operation_mask> 8 character ASCII hex representation of a 32 bit mask value. Bits 0 (LSB) to 32 (MSB) represent operation channels 0 to 32 respectively. If a bit is set, the corresponding operation channel is enabled.
<operation_mask> 8 character ASCII hex representation of a 32 bit mask value. Bits 0 (LSB) to 32 (MSB) represent operation channels 0 to 32 respectively. If a bit is set, the corresponding operation channel is reset.
Page 74 of 120
Commercial In Confidence
<operation_mask> 8 character ASCII hex representation of a 32 bit mask value. Bits 0 (LSB) to 32 (MSB) represent operation channels 0 to 32 respectively. If a bit is set, the corresponding operation channel is triggered.
Page 75 of 120
Commercial In Confidence
<satellite_data> set of 16 groups of the form ss-nn each separated by a space. ss Satellite ID number in hexadecimal. xx Signal C/N0 (dBHz) in hexadecimal. For an initial position fix the GPS needs to acquire and track 5 satellites. Once the position fix has been obtained the GPS can maintain a latitude/longitude position with just 3 satellites visible. The satellites will normally track with a C/N0 value of 1E (30 decimal) or higher. Strong satellites have C/N0 values above 28 (40 decimal). 7.8.1.2 GS Get GPS Status The GS command is used to get the validity of the GPS position report data. Command Format Response Format <valid_flag> GS?<CR> gs<SP><valid_flag><CR><LF> 2 character ASCII hex representation of a byte. 0x00 GPS data invalid 0x01 GPS data valid. The value is obtained from the GPS Status register (module 0x04, register 0x00) see paragraph 5.7.1.1.
Page 76 of 120
Commercial In Confidence
7.8.1.3 GE Get GPS Software Version Number The GE Command requests the firmware version report message from the GPS unit. Command Format Response Format GE?<CR> ge<SP><version_string><CR><LF>
<version_string> ASCII character string containing the GPS chip set version identifier. The following is an example: 4.00 (25682)
7.8.2.2 GH Get Current GPS Heading The GH command is used to read the current course over the ground as reported by the GPS. Command Format Response Format GH?<CR> gh<SP><heading_value><CR><LF>
<heading_value> 4 character ASCII decimal number giving the heading in 0.1 degree steps. The heading value reported is calculated by the GPS based on the motion seen during the fix calculation and from the last position fix. The specification for the heading accuracy is: < 0.5 degree of error (User velocity=30m/s [60 mph], 50% probability, open sky) Note that with speed over ground <0.75m/s or where the terminal is stationary, the heading value returned will be random due to the very small difference between position samples.
Page 77 of 120
Commercial In Confidence
7.8.2.3 GP Get Current GPS Position The GP command is used to read the current position reported by the terminal GPS unit. Command Format Response Format <latitude> GP?<CR> gp<SP><latitude><SP><longitude><CR><LF> 13 character ASCII string reporting the latitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS 13 character ASCII string reporting the longitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS
<longitude>
7.8.2.4 GV Get Current GPS Speed The GV command is used to read the current speed reported by the terminal GPS unit. Command Format Response Format <speed_value> GV?<CR> gv<SP>< speed_value ><CR><LF> 4 character ASCII decimal number giving speed in units of 0.1m/s.
The speed value reported is calculated by the GPS chipset based on the motion seen during the fix calculation and from the last position fix.
Page 78 of 120
Commercial In Confidence
<points>
<zones>
7.8.3.2 GF Define Geofence Point The GF command is used to define a single point that forms a corner of the geofence being defined. Command Format Response Format <fence>
GF<fence><SP><point><SP><lat><SP><long><CR> GF<fence><SP><point>?<CR>
gf<SP><fence><SP><point><SP><lat><SP><long><CR><LF>
single ASCII digit, either 1 or 2 indicating the fence number to be defined. 2 character ASCII decimal number indicating the number of the point in the geofence being defined. 13 character ASCII string reporting the latitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS 13 character ASCII string reporting the longitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS
<point>
<lat>
<long>
Page 79 of 120
Commercial In Confidence
7.8.3.3 GW Store Geofence Data The GW command validates the geofence data that has been defined using the GF, GD and GZ commands and if it is complete, enables the fence for use. Command Format Response Format <fence> GW<fence><SP><points><SP><zones><CR> gw<SP><fence><SP><points><SP><zones><CR><LF> single ASCII digit (1 or 2) indicating the fence number to be defined. 2 character ASCII decimal number indicating the number of points in the geofence being defined. 2 character ASCII decimal number indicating the number of zones in the geofence being defined.
<points>
<zones>
7.8.3.4 GZ Define Geofence Zone The GZ command defines the zones available within the overall fenced area. Each zone definition has at least 3 point numbers indicating the co-ordinate sets that are used as the corners of the zone. The points used to define the zone must run in an anti-clockwise direction around the zone with the internal angle at each corner being less than 180. It is the responsibility of the programmer to check that the zone definition is valid. The terminal does not validate the zone definition against these rules. Command Format GZ<fence><SP><zone><SP><num_points><SP> <point_1><SP><point_2><SP><point_n><CR> GZ<fence><SP><zone>?<CR> Response Format gz<SP><fence><SP><zone><SP><num_points><SP> <point_1><SP><point_2><SP><point_n><CR><LF> single ASCII digit (1 or 2) indicating the fence number to be defined. 2 character ASCII decimal number indicating the zone number in the geofence being defined. 2 character ASCII decimal number indicating the number of points in the zone being defined
<fence>
<zone>
<num_points>
n x 2 character ASCII decimal numbers indicating the number of the point to be included in the geofence zone being defined.
Page 80 of 120
Commercial In Confidence
7.8.4.2 GR Define Reference Point The GR command is used to set or interrogate the reference point stored in the terminal. Associated scripting registers are module 0x04, registers 0x11 and 0x12 see paragraphs 5.7.2.2 and 5.7.2.3. Command Format GR<latitude><SP><longitude><CR> GR?<CR> gr<SP><latitude><SP><longitude><CR><LF> 13 character ASCII string reporting the latitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS 13 character ASCII string reporting the longitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS
<longitude>
Page 81 of 120
Commercial In Confidence
7.8.4.3 GX Store Current Position as Reference The GX command takes the current position as read from the terminal GPS receiver and stores it as the terminal reference position. Command Format Response Format <latitude> GX<CR> gx<SP><latitude><SP><longitude><CR><LF> 13 character ASCII string reporting the latitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS 13 character ASCII string reporting the longitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS
<longitude>
<distance>
<undefined>
Page 82 of 120
Commercial In Confidence
7.8.5.2 GT Define Target Position The GT command is used to set or interrogate one of the target points stored in the terminal. Command Format GT<point_id><SP><lat><SP><long><CR> GT<point_id>?<CR> gt<SP><point_id><SP><lat><SP><long><CR><LF> er<SP><undefined><CR><LF> <point_id> single ASCII decimal number in the range 0..7 identifying the target point required. 13 character ASCII string reporting the latitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS 13 character ASCII string reporting the longitude value to 0.01 seconds. The format of the string is: +DDD MM SS.SS 2 digit ASCII hex error code for a target point not defined.
Response Format
<lat>
<long>
<undefined>
Page 83 of 120
Commercial In Confidence
These fields are defined as follows: Type: Defines the type of entry: 1 = Acknowledgement burst 2 = Long burst 3 = Double Burst part 1 4 = Double Burst part 2 5 = Long Burst 6 = Double Burst part 1 7 = Double Burst part 2 8 = GPS record. Date: Defines the day/year that the data record was created. The day of the year is stored in the lower 9 bits (1 356/366) and the Year since 2000 is stored in the top 7 bits (0 to 127). For example a value of 0x102b would be 12th Feb 2008. Time: Defines the time of day that the data record was created. The time after 00:00 is stored with 2s resolution. For example, a value of 0x176E (decimal 5,998) represents a time of 5,998 x 2 seconds after 00:00, i.e. 3:19:56. Transmit time: Defines the frame and slot in which the transmission occurred. The bottom 4 bits (1 to 12) define the slot number and the top 12bits (1 to 2880) the frame number. Frames are 30s long and numbered from midnight. Frame number 1 indicates the frame starting at 00:00:00 hrs; frame number 2880 indicates the frame starting at 23:59:30 hrs. Frames are divided into 2.5s slots. The slot number is the slot in which the transmission began. The transmit frame and slot can be converted to seconds past midnight as follows. Seconds past Midnight = ((frame-1)*30) + ((Slot-1)*2.5) The value is only valid for transmit log records where the message is transmitted. If a message is not transmitted this field will contain 0xffff. Data (type = 1, Acknowledgement burst): For acknowledgement burst records, the data field will be zero. Data (types = 2 to 7, Message data): For message data records, only the most significant 86 bits of the data field are used. The data (whether transmitted or just logged) corresponds to the transmit data Honeywell Global Tracking Page 84 of 120 (Transmitted and logged) (Transmitted and logged) (Transmitted and logged) (Transmitted and logged) (Log only record) (Log only record) (Log only record) (Log only record)
Commercial In Confidence
message format. The format for pre-defined messages (listed in Table 29, paragraph 5.8.1) is defined in the Message Registry Document, ref.[2]. The creation of user defined messages is described in paragraph 5.8.1.1. Data (type = 8, GPS): For GPS data records, only the most significant 84 bits of the data field are used. The format is shown in Table 42. No logging of GPS data will occur if the GPS is turned off.
Bits (Size) 0..19 (20) 20..40 (21) 41..49 (9) 50..59 (10) 60..75 (16) 76 (1) 77..83 (7) Name Latitude Longitude Heading Speed Altitude GPS Status HDOP Details 0: Hemisphere N|S (0 = North; 1 = South) 1..19: Latitude in seconds 20: Hemisphere E|W (0 = East; 1 = West) 21..40: Longitude in seconds Degrees 0.1 m/s Signed 2s Complement value in metres 0 = Invalid; 1 = Valid Geometric Dilution of Precision
Table 42 GPS data log record format CRC: A Checksum used internally by the terminal to validate the logged records 7.8.6.1 GI Set GPS Logging Interval The GI command sets the interval between logged GPS positions stored in non-volatile memory. If the interval is set to 0 then GPS positions will not be logged. If the logging interval is set to a value between 1 and 10080 minutes (the maximum allowed) then GPS information (position, course, speed, altitude and status) will be logged in non-volatile memory after the defined number of minutes. Command Format GI<interval><CR> GI?<CR> gi<SP><interval><CR><LF> 4 character ASCII hex value containing the time between logged positions in minutes. A value of zero turns logging off.
Page 85 of 120
Commercial In Confidence
7.8.6.2 LN Get Number of Logged Positions The LN command requests the number of logged entries or records in the terminal. Command Format Response Format <records> LN?<CR> ln<SP><records><CR><LF> 4 character ASCII hex value containing the number of logged records stored in the terminal.
7.8.6.3 LR Get Logged Record The LR command is used to interrogate the logged records stored in the terminal and can be used with or without the index parameter. Multiple LR? commands without an index will return consecutive records starting with the most recent. To restart interrogating from the most recent record, an LN? command should be issued. Sending a LR <index>? command will return the log entry for the specified index. Command Format LR?<CR> LR<index>?<CR> lr<SP><index><SP><type><SP><date><SP><time> <SP><transmit_time><SP><data> <CR><LF> 4 character ASCII hex value. The index of the record stored. A value of 1 represents the oldest record in the log. The index of the newest record in the log is found using the LN? command. Note that the index is NOT unique to each record. It is simply an indication of the relative position of each record in the log file. As records are added to the log and older records removed the index of the records will change periodically. It is advised that GPS logging and Script operation is halted when reading large numbers of records. See sections 7.8.6.1 and 7.13.4 for use of the GI 0 and the PS 0 commands. The time stamp stored with the logged data (described below) should be used to uniquely identify records. For more details on the following fields see paragraph 7.8.6: <type> <date> <time> single ASCII hex character defining the record type stored: 4 character ASCII hex value of the date that the entry was recorded in the log. 4 character ASCII hex value of the time past midnight, with 2s resolution, that the entry was recorded in the log.
Response Format
<index>
<transmit_time> 4 character ASCII hex value. The value contains the slot and frame number in which the transmission occurred. If a message is not transmitted this field will contain 0xffff. <data> 22 character ASCII hex value representing the logged data. Page 86 of 120
Commercial In Confidence
7.9.1.3 mf Forward Channel Message Data The mf data message is the only message that is not generated in response to a message received over the serial port. The mf message is generated in response to an incoming forward channel, user message being received over the satellite. The format of the message depends upon the type of forward channel message received by the terminal. Message Format <header> mf<SP><header><data_block><CR><LF> 22 character ASCII string containing the burst header information reported by the terminal. The format and length of the data_block field will vary depending upon the message type.
<data_block>
Page 87 of 120
Commercial In Confidence
Character 1..2 3..4 5..6 7..8 9..10 11..12 13..15 16..17 18 19 20..21 22
Field Flags Year Month Day Hour Minute Transmitting Earth Station ID Message Number Category Tone Number Service ID Information type
Format 2 hex digits 2 decimal digits 2 decimal digits 2 decimal digits 2 decimal digits 2 decimal digits 3 decimal digits 2 decimal digits T, N, A or D 1, 2, 3 or 4 2 decimal digits Hex digit
Table 43 Forward Channel Message Header Format The format of the data_block field will vary depending upon the message category field in the header record. If the category is T (tone only) then the data_block field is empty. If the category is N (numeric data) or A (alphanumeric data) then the data_block field contains the message data as an ASCII character string. If the category is D (transparent binary data) then the data_block field contains the message data as a sequence of ASCII hex byte values. 7.9.1.4 MN Get Next Forward Message from the Buffer The MN command returns the earliest forward channel message held within the terminal. Once the data has been output it is deleted from the database in the terminal. If the forward channel message buffer is empty no parameters are returned Command Format Response Format <header> MN?<CR> mn<SP><header><data_block><CR><LF> same format as header field in the mf response (paragraph 7.9.1.3) same format as data_block field in mf response (paragraph 7.9.1.3)
<data_block>
Page 88 of 120
Commercial In Confidence
7.9.1.5 MO Configure Forward Channel Message Output The MO command enables or disables the output of unsolicited mf report messages in response to the reception of forward channel messages by the terminal. When mf messages are disabled the forward channel messages can be read by interrogating the terminal for the number of received messages using the MC? command and reading them using the MN? Command Format MO<mode><CR> MO?<CR> mo<SP><mode><CR><LF> single ASCII character either 0 or 1. A 0 enables the output of the mf messages and a 1 disables their output. The mode is stored in the Forward Channel Message Output Mode register (module 0x05, register 0x40) paragraph 5.8.19.
7.9.2.2 MB Transmit a Return Message The MB command instructs the terminal to transmit a pre-defined or user defined return burst. The pre-defined message codes are listed in Table 29, paragraph 5.8.1, and details of their format is described in the Message Registry Document, ref.[2]. User defined messages use codes 0x80 to 0xBF for 64 bit messages, and codes 0xC0 to 0xFE for 80 bit messages. The creation of user defined messages is described in paragraph 5.8.1.1. Command Format Response Format <msg_code> MB<msg_code><CR> mb<SP><msg_code><CR><LF> 2 character ASCII hex representation of message identifier number.
If the message code is not defined then no message will be transmitted. This command is equivalent to writing the message code to the Return Burst Message ID code register (module 0x05, register 0x10) see paragraph 5.8.1. Honeywell Global Tracking Page 89 of 120
Commercial In Confidence
7.9.2.3 MK Get/Set Return Message Acknowledge Flags The MK command sets the value to be used in the message acknowledgement flags field of any subsequent bursts to be transmitted in response to MB commands. The flags field is a 2 bit value. Bit 0 (LSB) requests an application acknowledge and Bit 1 requests an automatic LES acknowledge. Command Format MK<ack_flags><CR> MK?<CR> mk<SP><ack_flags><CR><LF> single character ASCII hex representation of the 2 bit acknowledge flags value (module 0x05, register 0x14) see paragraph 5.8.4.
7.9.2.4 ML Get/Set Return Message Control Flags Field The ML command sets the value to be used in the message control flags field of any subsequent bursts to be transmitted in response to MB commands. The flags field is a 4 bit value. Command Format ML<message_flags><CR> ML?<CR> ml<SP><control_flags><CR><LF>
Response Format
<control_flags> single character ASCII hex representation of the 4 bit control flags value (module 0x05, register 0x15) see paragraph 5.8.5.
Page 90 of 120
Commercial In Confidence
7.9.2.5 MM Transmit Return Message The MM command causes the terminal to transmit a return burst message using the message data contained in the command. Command Format Response Format <length> MM<SP><length><SP><data_block><CR> mm<SP><length><SP><data_block><CR><LF> single ASCII character defining the message length being defined: L for a long or D for double (IsatM2M) ASCII hex representation of payload data to be transmitted. Long message: 22 character field. Bits 0 (LSB) and 1 of the last character are the application and LES acknowledgement request bits respectively. Double message (IsatM2M only): 43 character field. Bits 0 (LSB) and 1 of the last character are the application acknowledge bits for the first part and second part of the message respectively. Bit 2 of the last character is the LES acknowledge request bit. Note that confirmation of receipt of an LES acknowledgement by the terminal is confirmation that both parts of the Double message were received at the LES. 7.9.2.6 MP Configure Automatic Poll The MP command configures the automatic return message generation by the terminal. The message takes two parameters. The first is a message repeat rate in minutes. If set to zero then the terminal will stop sending messages. If set to 1 then a single message is transmitted. All other values are treated as repeat rates and the messages will be sent out at the intervals requested except that values from 2 to 9 are rounded up to 10. Command Format MP<SP><period><SP><msg_code><CR> MP?<CR> mp<SP><period><SP><msg_code><CR><LF> 4 character ASCII hex number containing the time between message transmission in minutes. 2 character ASCII hex number containing the message type to be sent in the poll transmission. The msg_code is stored in the Poll Message ID code register (module 0x05, register 0x30) paragraph 5.8.17.1.
<data_block>
<msg_code>
The message code used may be one of the values for a standard return message format listed in Table 29 or it may be a user defined 64 or 80 bit message. If the message code is not defined in the terminal then no message will be transmitted.
Page 91 of 120
Commercial In Confidence
7.9.2.7 MQ Get/Set Response to a Tone only Message The MQ command is used to set the response of a terminal to a tone only type forward channel message. There are four tone only messages that may be sent to a terminal and, using this command, it is possible to configure the terminal to use these messages as remote poll requests. Command Format MQ<tone><SP><msg_code><CR> MQ <tone>?<CR> mq<SP><tone><SP><msg_code><CR><LF> single character ASCII hex representation of the tone number (0..3). 2 character ASCII hex representation of the message number to be returned by the terminal. If the value is zero, subsequent tone only forward messages will be treated as normal, i.e. the terminal will not respond with a return channel message.
<msg_code>
The message code used may be one of the values for a standard return message format listed in Table 29 or it may be a user defined message. The message code is stored in the appropriate messaging module register module 0x05, registers 0x38 to 0x3B see paragraph 5.8.18. 7.9.2.8 MR Report Receiver Status The MR command reports the latest receiver status values as reported by the terminal. Command Format Response Format <chan> MR?<CR> mr<SP><chan><SP><quality><SP><status><CR><LF> 4 character ASCII hex representation of the receiver channel number. 4 character ASCII hex representation of the receive signal quality. The value returned is the Receive Signal Quality register (module 0x05, register 0x21) - see paragraph 5.8.7.2 2 character ASCII hex representation of the receiver status code returned by the terminal. The value returned is the Receive Status register (module 0x05, register 0x22) - see paragraph 5.8.7.3.
<quality>
<status>
Page 92 of 120
Commercial In Confidence
7.9.2.9 MS Get/Set Return Message Transmission Slot Randomisation The value set by the MS command sets the number of traffic channel frames over which slot randomisation occurs, e.g. if a value of 3 is used then the transmission will occur in a return channel slot some time in the next 3 traffic frames. If a value of zero is used then the message will be transmitted in the next available slot. Command Format MS<randomisation><CR> MS?<CR> ms<SP><randomisation><CR><LF>
Response Format
<randomisation> 2 character ASCII hex representation of the number of traffic frames to be used in the range 0 to 0x1F. The value is stored in the Transmit Randomisation Period register (module 0x05, register 0x24) see paragraph 5.8.9. 7.9.2.10 MT Report Transmitter Status The MT command reports the latest terminal transmitter status as reported to the terminal. Command Format Response Format <status> MT?<CR> mt<SP><status><CR><LF> 8 character ASCII hex representation of the transmitter status. The value returned is the Transmit Status register (module 0x05, register 0x23) - see paragraph 5.8.8.
Page 93 of 120
Commercial In Confidence
7.10.1
SR Read/Set Register
The SR command is used to set or read one of the scratchpad registers (module 0x06) see section 5.9. Command Format SR<register><SP><value><CR> SR<register>?<CR> sr<SP><register><SP><value><CR><LF> single character ASCII hex representation of the scratchpad register number (0..F). 8 character ASCII hex representation of the 32 bit value to be stored in the register.
<value>
Page 94 of 120
Commercial In Confidence
7.11.1
RR Read Register
The RR command allows the value of one of the scripting module registers (see section 5) to be read directly. Command Format Response Format <module> RR<module><SP><reg>?<CR> rr<SP><module><SP><reg><SP><value><CR><LF> single character ASCII hex representation of the module number. 2 character ASCII hex representation of the register number. 8 character ASCII hex representation of the 32 bit value to be stored in the register.
<reg> <value>
7.11.2
RW Write Register
The RW command allows the value of one of the scripting module registers (see section 5) to be written to directly. Command Format Response Format <module> RW<module><SP><reg><SP><value><CR> rw<SP><module><SP><reg><SP><value><CR><LF> single character ASCII hex representation of the module number. 2 character ASCII hex representation of the register number. 8 character ASCII hex representation of the 32 bit value to be stored in the register.
<reg> <value>
Page 95 of 120
Commercial In Confidence
Add a message number definition to the user message database. Command Format Response Format <message_ID> BD<message_ID><SP><field_count><CR> bd<SP><message_ID><SP><field_count><CR>LF> 2 character ASCII hex representation of the message number being defined. This must have a value in the range 0x80 to 0xFE. Message ID of 0xFF is not allowed 2 character ASCII hex representation of the number of field definitions used to produce the message.
<field_count>
7.12.2
Add a message data field definition to the user message database. Command Format Response Format <register> BF<register><SP><mask><CR> bf<SP><register><SP><mask><CR><LF> 3 character ASCII hex representation of the register address including its module number. 8 character ASCII hex representation of the 32 bit mask value to be used to extract the data bits from the register.
<mask>
7.12.3
Erases any existing message definitions from the user message database and prepares the terminal to receive new message definitions in the form of BD and BF commands. Command Format Response Format BI<CR> bi<CR><LF>
Page 96 of 120
Commercial In Confidence
7.12.4
Reports the number of user message definitions that have been programmed into the terminal. Command Format Response Format BN?<CR> bn<SP><message_count><CR><LF>
<message_count> 2 character ASCII hex representation of the number of message definitions programmed into the terminal.
7.12.5
Returns one of the user message definitions that have been programmed into the terminal. Command Format Response Format BQ<message_number>?<CR> bq<SP><message_number><SP><message_ID><SP> <field_def>[..<SP><field_def>]<CR><LF>
<message_number> 2 character ASCII hex representation of the message definition number in the user message database. <message_ID> 2 character ASCII hex representation of the message number to be used to identify this message format, as programmed by the BD command. 3 character ASCII hex representation of the register address including its module number followed by a space and an 8 character ASCII hex representation of the 32 bit mask value to be used to extract the data bits from the register. These values are as used in the BF command sequence to define the message. The response contains one field_definition pair for each BF command used in the message generation.
<field_def>
7.12.6
The BW command closes the message database so that no further message definitions can be written. Command Format Response Format BW<CR> bw<CR><LF>
Page 97 of 120
Commercial In Confidence
The firmware to be loaded into the terminal is delivered as an XML format file. This is read by the Honeywell Global Tracking supplied uploader software and the required images extracted for transfer to the terminal. To prevent upload of incompatible firmware, the terminal rejects any attempt to upload firmware that it does not recognise as being compatible. The file upload into the MSP is initiated by a PD command. The program image is then transferred in Motorola S-record format, one record at a time, over the serial link. Each record is acknowledged with either a pa (success) or pn (failure) response. Once the last record has been sent to the terminal the MSP calculates and stores a checksum value for its internal image. 7.13.1.1 PD Program Upload The PD command is used to upload a new version of the terminal application firmware into the processor memory over the serial port. The PD command is followed by the program data file in Motorola S-Record format. Each record of the program file is acknowledged by a pa<LF><CR> response. The first record of the program file must not be sent until the pd acknowledge has been returned. Subsequent records must wait until the previous record has been acknowledged with a pa. Command Format Response Format <rate_select> PD[<rate_select>]<CR> pd<LF><CR> Optional parameter, selecting the upload speed: 1 = 9600 baud 2 = 19200 baud 3 = 38400 baud 4 = 57600 baud 5 = 115200 baud If the parameter is omitted then the upload will continue at the normal serial port rate of 9600 baud.
The baud rate change occurs once the pd response has been sent out of the terminal. All further communications following receipt of the pd command must be performed at the new baud rate. Following an upload to the MSP the terminal will automatically return to the default baud rate of 9600. Following an upload to the DSP the terminal can be set back to the default baud rate by sending command PR9600 to the unit. 7.13.1.2 pa Program Record Acknowledge The pa response is sent from the terminal in response to a valid S-record during the upload process. The response is sent by the terminal when it has received the record, decoded it and stored the contents in the program FLASH memory. It indicates that it is ready to receive another record. Honeywell Global Tracking
Page 98 of 120
Commercial In Confidence
7.13.1.3 pn Program Record NAK The terminal responds with a pn message when it detects an error in the received S-record. Errors may include an invalid character in the record or an invalid checksum. If the error is detected in the file header (S0) record then the unit returns a pn 0 response, otherwise it returns pn 1.
7.13.2
PI Reset
The PI command is used to reset the terminal application firmware or to get the results of the terminal self tests. The command sends its response before performing the processor reset. Command Format PI<CR> PI?<CR> (Reset command) (Test result request)
Response Format
pi<CR><LF> (Reset command) pi<SP><test_result><CR><LF> (Test result request) 4 digit ASCII hex representation of a 16 bit value containing the self test result code.
<test_result>
This command causes the reset of the GPS processor and Inmarsat-D modem, and the terminal configuration and script are reloaded with their restart state from the non volatile data store. The GPS and Inmarsat-D functions will be restarted as required by the terminal configuration, and the script operation (timers and alarms) subsequently started. (Note that if the GEM-100 is utilised there will be a 32 second delay before the script operation starts.)
7.13.3
The PR command selects the baud rate to be used by the terminal for serial communications. There are two options; 9600 or 4800 baud. The 4800 baud option is provided so that the NMEA format output data can be passed to external devices at a standard NMEA data rate. Command Format Response Format <rate> PR<rate><CR> pr<SP><rate><CR><LF> 4 digit ASCII decimal value. If the value supplied is 4800 then the serial port will be configured to operate at 4800 baud. Any other value will set the port to 9600 baud.
Note: Following a firmware upload (paragraph 7.13.1.1) the terminal will return to the default baud rate of 9600.
Page 99 of 120
Commercial In Confidence
7.13.4
PS Scripting Enable/Disable
The PS command is used to enable or disable scripting functions. This command is required when programming the script functions so that the initial values for any of the function registers do not become corrupted during the load as a result of part of the script operating during the load. The command also switches on and off the script debugging output messages. Command Format PS<enable><CR> PS?<CR> ps<SP><enable><CR><LF> single ASCII character: 0 or 2 = disable 1 = enable 3 = enable with debug messages
7.13.5
THIS COMMAND IS FOR FACTORY USE ONLY AND MUST NOT BE ISSUED WHEN THE I/O LINES ARE CONNECTED TO ANY EXTERNAL DEVICE.
7.13.6
The PV command is used to read the version ID for the Bootloader code held in the terminal. The Bootloader code is a separate piece of software that is loaded into the terminal at manufacture and is used to update the main software contained in the MSP. Command Format Response Format PV?<CR> pv<SP><version_string><CR><LF>
<version_string> 4 character ASCII string containing the software version. The first two characters are the major version and the second two characters the minor version number.
Commercial In Confidence
7.13.7
The PY command returns MSP software information such as software number, version, date and time of build etc.. Command Format Response Format <date_string> PY?<CR>
py<SP><date_string><SP><hardware><SP><variant><CR><LF>
ASCII string containing the date and time of compilation of the code. The format of the string is hh:mm:ss Mmm dd yyyy ASCII string containing the hardware revision that the MSP software was built to support. ASCII string containing the variant description for the software build.
<hardware>
<variant>
Extended information is returned through use of the following PY command format: Command Format Response Format <report_type> PY <report_type>?<CR> py<SP><report_type><SP><version_info><CR><LF> single ASCII character specifying the report type as follows: 1 = full MSP code version information 2 = Bootloader version information 3 = MSP code, version and build numbers only ASCII string containing version information.
<version_info>
Examples of responses from the PY?, PY1?, PY2? and PY3? Commands are: py 13:28:51 Feb 2 2009 P042_G01 Rev A GEM-100 Build. Build 647 py 1 SWN-0091-20 SAT-200 MSP Application Software - Version 01.00 py 2 SWN-0091-21 SAT-200 MSP Bootloader Software - Version 01.95 py 3 01.00 00647
7.13.8
The PZ command is used to read the production serial number of the unit. Command Format Response Format <serial_no> PZ?<CR> pz<SP><serial_no><CR><LF> 5 character serial number. (The serial number is also labelled the unit.)
Commercial In Confidence
This command is the DSP equivalent of the PY command see paragraph 7.13.7 for command and response formats.
7.14.2
The DS PW command is used to enter the access control password. This password allows write access to specific configuration parameters not available to the end user. Password protected parameters can normally still be read back without the need for a password. Command Format Response Format <access_level> <password> <response> DS<SP>PW<SP><access_level><SP><password><CR> ds<SP>pw<access_level><SP><response><CR><LF> single ASCII character defining the access level required. ASCII string containing the password for the access level. ASCII sting returning the result of the password access request. This is either GRANTED or DENIED.
7.14.3
Set/Get one of the 5 stored Service IDs (SIDs). The terminal has 5 pre-programmed SIDs each with a corresponding Beam ID (BID). The SID and BID are the primary parameters that the terminal uses to connect to the Inmarsat-D network. Use the DS TE command to set the corresponding BID and the DS TJ command to read back the SID/BID pairs. If this value is changed the service provider must be informed to ensure that forward channel messages are delivered to the correct channel. Command Format DS<SP>TA<SP><service><SP><service_ID><CR> DSTA<service>?<CR> ds<SP>ta<service><SP><service_ID><CR><LF> single ASCII digit in the range 0..4 representing the preprogrammed service number. 2 digit ASCII hex number of the stored Service ID corresponding to the specified service.
<service_ID>
Commercial In Confidence
7.14.4
The DS TC command is used to get or set the terminal Pager Subset Number (PSN). A particular service may utilise a number of Traffic channels and the PSN provides a method of distributing the terminal population associated with this service over these Traffic channels. By default the PSN of every terminal is set to the last character of the terminal ISN (see command TN in section 7.14.10) giving the terminal population an even distribution of PSNs between 0 and F. If this value is changed from the default setting the service provider must be informed to ensure that forward channel messages are delivered to the correct channel. Command Format DS<SP>TC<SP><PSN><CR> DSTC?<CR> ds<SP>tc<PSN><CR><LF> single ASCII hex character 0 to F
7.14.5
DS TE Get/Set Beam ID
Set/Get one of the 5 stored Beam IDs (BIDs). Also refer to the DS TA command, paragraph 7.14.3. If the BID is changed the service provider must be informed to ensure that forward channel messages are delivered to the correct channel Command Format DS<SP>TE<SP><service><SP><beam_ID><CR> DSTE<service>?<CR> ds<SP>te<service><beam_ID><CR><LF> single ASCII digit in the range 0..4 representing the preprogrammed service number. 2 digit ASCII hex number of the stored Beam ID corresponding to the specified service.
<beam_ID>
Commercial In Confidence
7.14.6
The DS TG command is used to get or set up to 5 group PIDs for the terminal. GPIDs provide the ability for service providers to broadcast forward channel messages to multiple terminals. Contact your service provider for more information. Command Format DS<SP>TG<SP><gpid_no><SP><gpid><CR> DSTG?<CR> ds<SP>tg<SP><gpid0><SP><gpid1><SP><gpid2><SP> <gpid3><SP><gpid4><CR><LF> single character ASCII hex value in the range 0..4 representing the 5 stored GPIDs 5 character ASCII hex value of the 20bit GPID
Response Format
<gpid_no>
<gpid>
7.14.7
The DS TJ command is a read only command used to get the 5 stored Services with a Service ID and Beam ID held in the terminal. The terminal has 5 pre-programmed Service IDs each with a corresponding Beam ID. The service ID and Beam ID are the primary parameters that the terminal uses to connect to the Inmarsat-D network. Command Format Response Format DSTJ?<CR> ds<SP>tj<SP><service_ID0><SP><beam_ID0><SP>, <service_ID1><SP><beam_ID1><SP>, <service_ID2><SP><beam_ID2><SP>, <service_ID3><SP><beam_ID3><SP>, <service_ID4><SP><beam_ID4><CR><LF> 2 digit hexadecimal number representing the stored Service ID to be used with the specified service. 2 digit decimal number reporting the stored beam ID to be used with the specified service.
<service_ID>
<beam_ID>
Commercial In Confidence
7.14.8
The DS TK command is used to set the number of transmission retries for messages that have been configured to request an LES acknowledge but where no acknowledgement has been received. Each retry occurs if the expected acknowledgement has not been received within 3 frames of the transmission. The message remains at the top of the transmit queue until either an acknowledgment is received or the re-try count has expired. By default the number of re-tries is set to 1. Command Format DS<SP>TK<SP><retries><CR> DSTK?<CR> ds<SP>tk<SP><retries><CR><LF> single ASCII hex character (0 to F) representing the number of retries
7.14.9
Get/set the mobility of the terminal. If the terminal is expected to be used in aircraft this value should be set to 1. If it is to be used in a static or vehicular installation then it should be set to zero. Command Format DS<SP>TM<SP><mobility><CR> DSTM?<CR> ds<SP>tm<SP><mobility><CR><LF> single ASCII digit, either 0 or1.
7.14.10
Get the terminals unique Inmarsat Serial Number (ISN) identifier. Command Format Response Format <ISN> DSTN?<CR> ds<SP>tn<SP><ISN><CR><LF> 12 ASCII character representation of the ISN
Commercial In Confidence
7.14.11
Get/set the state of 24 SET ONLY flags. These flags are set to enable or disable additional functionality within the terminal. WARNING: These flags should only be set following consultation with Honeywell Global Tracking. Once these flags are set they cannot be cleared. The unit must be returned to Honeywell Global Tracking to clear the flags. Bit Number 0 1 2-23 Function Enable terminal for use in (USA) FCC controlled areas. All units deployed in (USA) FCC controlled areas should have this flag set Set to 1 indicating IsatM2M operation Reserved Table 44 DS TO Operational Flags Command Format DS<SP>TO<SP><flags><CR> DSTO?<CR> ds<SP>to<SP><flags><CR><LF> 6 ASCII hex character representing the 24bit flags thus command DS TO 01 would set bit zero
7.14.12
The DS TR command reports the latest receiver status values from the terminal. Command Format Response Format DSTR?<CR> ds<SP>tr<SP><channel><SP><rx_Inhibit><SP> <rx_progress><SP><errors><CR><LF> 4 character ASCII hex representation of the receiver channel number. 4 character ASCII hex representation of any receiver inhibiting factors as described in Table 45. If the inhibiting factor is cleared then the status will return to Receive OK
<channel> <rx_Inhibit>
Value 0 1 2 3
Usage Receive OK Forward channel has a low signal quality. Check the positioning of the antenna BB Allocation Table not matched. The SID, BID, PSN in the terminal are not setup correctly. Contact your service provider HW failure. Contact your service provider Table 45 DS TR Receiver Inhibit Status Codes
Commercial In Confidence
<rx_progress>
2 character ASCII hex representation of the receiver progress returned by the terminal as described in Table 46
Valid Values 00 01 02 03 04 0A 0B 0C 0D
Status Config BB Wide band BB Narrow Band BB Track and Demod BB Track and Demod No Match Found TC Narrow Band TC Track and Demod TC RF Off TC Rx Errors (TC could not be decoded correctly due to poor signal quality) Table 46 DS TR Receiver Progress Codes
<errors>
4 character ASCII hex representation of 16 error flags (see Table 47). These error bits are only cleared on a power cycle. Usage HW Error Internal non-volatile memory CRC failure Forward Channel Ack not received Rx message buffer overflow Rx message buffer error Tx message buffer overflow Tx message buffer error Table 47 DS TR Terminal Error Codes
Bit 0 1 2 3 5 6 7
Commercial In Confidence
7.14.13
The DS TS command reports the latest receiver status from the DSP. Command Format Response Format DSTS?<CR>
ds<SP>ts<SP><SNR><SP><level><SP><freq><SP><doppler> <SP><symbol_errors><SP><rx_progress><CR><LF>
4 character ASCII hex representation of received Signal to Noise Ratio multiplied by 10dBHz. 4 character ASCII hex representation of received signal level at the ADC input multiplied by 100dBm. 6 character ASCII hex representation of received signal frequency. 4 character ASCII hex representation of received signal rate of change of frequency
<symbol_errors> 4 character ASCII hex representation of the number of corrected symbol errors this frame. <rx_progress> 2 character ASCII hex representation of the receiver progress returned by the terminal as described in Table 46
7.14.14
The DS TT command requests the latest transmitter status from the DSP. Command Format Response Format DSTT?<CR> ds<SP>tt<SP><msg_buf><SP><tx_progress><SP> <tx_inhibit><SP><last_tx_type><SP> <last_tx_time><SP>0<CR><LF> 2 character ASCII hex representation of the number of return channel messages waiting to be transmitted. 2 character ASCII hex representation of the progress of the current message being transmitted. The progress is described in Table 48. Usage Message buffer empty Waiting for a FC acknowledgement (Tx inhibited) Waiting for FC frame header Waiting for Transmit slot Transmitting Table 48 DS TT Transmit Progress Honeywell Global Tracking Page 108 of 120
<msg_buf> <tx_progress>
Value 0 1 2 3 4,5 or 6
Commercial In Confidence
<tx_inhibit>
4 character ASCII hex representation of the status of any inhibiting factors to the current burst being transmitted. The status is described in Table 49. If the inhibiting factor is cleared then the status will return to Transmit OK Usage
Value 0 1 2 3
Transmit OK Hardware Error. Contact your service provider System Message. The unit has been stopped from transmitting by a system message. Contact your service provider Waiting for a Forward Channel (FC) Acknowledgment. While waiting for a FC Ack no further transmissions will be made to ensure that the FC Ack is received Poor signal quality on FC. Before every transmission the terminal determines whether a transmission is likely to be successful by monitoring the FC signal quality. While signal quality is poor transmissions will be inhibited. Receiving a FC message. A transmission was due to go out in a frame that contained a forward channel message for the terminal. The transmission has been re-scheduled Table 49 DS TT Transmit inhibit status
<last_tx_type> <last_tx_time>
single character ASCII representation of the last message type transmitted L Long, D Double, A Acknowledgement. 4 character ASCII decimal representation of the UTC time of the last transmission. The first two characters are the hours the second two characters are the minutes. A value of 9999 indicates that no transmission has taken place since the terminal was last turned on or came out of sleep mode
Commercial In Confidence
7.14.15
The DS TW command is used to setup the way that return messages are written to the return channel transmission queue. By default these values are set to size=9 and write=0. Further information on the return channel queue can be found in reference [1]. Command Format DS<SP>TW<SP><size><SP><write><CR> DSTW?<CR> ds<SP>tw<SP><size><SP><write><CR><LF> single digit ASCII hex character in the range 2 to 9 that represents the maximum number of messages that can be stored in the return channel transmit queue at any time. single digit ASCII hex flag that describes the way messages are handled when the transmit queue is full. If the flag is set to zero no messages can be added to the transmit queue when it is full. If the flag is set to 1 a new messages will overwrite the oldest message in the transmit queue when it is added.
<write>
<success>
Commercial In Confidence
*0B
Commercial In Confidence
GGA sentences are of the form: $GPGGA,110039,5200.28,N,00207.48,W,1,,,64.00,M,,,,,*0D Where the message fields, separated by commas, have the following functions. Field Number 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Contents GPGGA 123519 5200.28 N 00207.48 W 1 Meaning Message header/identifier Time hhmmss Latitude value DDMM.MM Hemisphere N = North, S = South Longitude Value DDDMM.MM Hemisphere E = East, W = West Fix quality Number of satellites being trackedNote 1 Horizontal Dilution of Precision Note 1 Altitude (WGS-84 ellipsoid) Altitude units - Metres Geoid separation Note 1 Separation units - Metres Note 1 Time since last DGPS update Note 1 DGPS station ID number Note 1 Message Checksum. 2 hex digits after the * character.
64.00 M
*0B
Note 1: The terminal does not use these fields. On output they are always empty, on input they are ignored
Table 51 NMEA GGA Sentence Format GSV sentences (output only) are of the form: $GPGSV,4,1,14,03,84,155,23,06,72,118,16,07,17,280,25,08,16,320,19*70 Where the message fields, separated by commas, have the following functions.
Commercial In Confidence
Field Number 1 2 3 4
5 6 7 8 . . . 21 (max)
Contents Meaning GPGSV Message header/identifier 4 Number of sentences for full data 1 Sentence 1 of 4 (in this example) 14 Number of satellites in view Then, the following information is provided for up to 4 satellites per sentence: 03 Satellite PRN number 84 Elevation, degrees 155 Azimuth, degrees 23 SNR
*0B
Message Checksum. 2 hex digits after the * character. Table 52 NMEA GSV Sentence Format
Commercial In Confidence
7.16.1
The za message is output each time that an alarm triggers. The message identifies the alarm channel that has been triggered. The message follows the operation chain message that was triggered by the alarm. Message Format <alarm> za<SP><alarm><CR><LF> single ASCII hex character identifying the alarm channel that was triggered.
7.16.2
A zo message is output each time that an operation chain is triggered. contains a list of all of the operations that have been triggered in the chain. Message Format <Op_X>
zo<SP><Op_1><SP><Op_2><SP><Op_N><CR><LF> 2 digit ASCII hex number identifying the operation step that has been performed.
7.16.3
The zt message is output each time that a timer triggers. The message identifies the timer channel that has been triggered. The message follows the operation chain message that was triggered by the timer. Message Format <timer> zt<SP><timer><CR><LF> single ASCII hex character identifying the timer channel that was triggered.
Commercial In Confidence
Meaning Invalid Command, Command not recognised Response from the DSP not recognised Bad Parameter entered for command, unable to decode the parameter value or the parameter outside the legal range An invalid ocean region selected An invalid Service ID selected Bad Serial Number (corrupted memory) Stored script error (corrupted EEROM) Error defining a Geofence Invalid Geofence point entered The requested target position has not been defined The message database is not open for new message definitions Bad message number definition supplied (BD Command) Bad message field definition supplied (BF Command) Unable to communicate with the GPS module MSP clock failure Timeout on heartbeat message from the DSP. The terminal will go into sleep mode before trying to restart the terminal operation. GPS Communications error DSP Invalid Command, Command not recognised DSP Bad Arguments, The number of arguments given with the command was not as expected Out of range update to the DSP Real Time Clock The DSP has not received a heartbeat message from the MSP in the last 3 seconds. The DSP peripherals will be held low and this error message sent out every second. MSP will attempt a terminal reboot. DSP Bad Parameter entered for command. The value of one or more of the arguments was out of range DSP invalid ocean region selected DSP invalid Service ID selected Invalid command used Page 115 of 120
A0 A1 A2 A3
Commercial In Confidence
Error Code A4 A5 A6 C0 C1 C2 C3 D0 D1 D2 D3 D4 D5 D6 D7 E0 E1 E2 F0 F1 F2 F3 F4
Meaning DSP invalid satellite selection mode selected Invalid Tx Frequency Invalid Rx Frequency Access to command denied. Password required. FLASH read error FLASH write error PID corrupted Contact Honeywell Global Tracking Transmit Queue error Transmit queue full Transmit Acknowledgement error Unexpected forward channel acknowledgement received Transmit inhibit message received from the LES Contact Honeywell Global Tracking Data Log is empty Data Log Error Cannot transmit as no valid UTC time has been set Forward channel message buffer overflow Forward channel message buffer empty Forward channel message buffer no more data Hardware RF failure Hardware RF OK Hardware RF failure switching Inmarsat-D off DSP Task scheduler overflow contact Honeywell Global Tracking DSP Task scheduler error contact Honeywell Global Tracking Table 53 Terminal Error Report Codes
Commercial In Confidence
Some explanation of the columns in Table 54 is provided below: Command: The serial command without parameters Associated Scripting Register Address(es): The scripting registers that are associated with or modified by the serial command. The registers are indicated by their hexadecimal module and register numbers. Where possible direct access of the scripting registers using the RR/RW command should be used in preference to the indirect serial command access. Where no scripting register is provided, the function cannot be accessed via a script. Description: A brief description of the command function R/W: Indicates whether the command is Read only, Write only or Read/Write. (Also see note 1 at the end of the table.) Non-volatile: = Not applicable or not stored in non-volatile memory 1 = Parameters stored to non-volatile memory, or their default values restored from non-volatile memory, through the DS TZ command. See paragraph 7.14.16. 2 = Parameters stored to non-volatile memory by the CZ command (paragraph 7.3.13) 3 = Parameters stored to non-volatile memory by the GW command (paragraph 0) 4 = Parameters stored to non-volatile memory by the BW command (paragraph 7.12.6) Auto = Automatically stored to non-volatile memory Default Value: Factory/Operational default values as applicable. Password (See paragraph 7.14.2): = No password required 1 = Application Service Provider (ASP) level. 2 = Service ID Level ** = Local (serial port) access to these commands (includes all DS prefixed commands) can be disabled by an Over the air password command.
Commercial In Confidence
DS -DS PW DS TA DS TC DS TE DS TG DS TK DS TM DS TN DS TO DS TR DS TS DS TT DS TW DS TZ
All DS prefixed commands Enter access password Service ID PSN Beam ID Group IDs Transmission retries Mobility ISN Operational Flags Receiver status Signal status Transmitter status Tx Queue Configuration Write or restore configuration to/from non-volatile memory Satellite selection mode Ocean Region Power control state Factory defaults Service ID index NMEA output control Firmware version (MSP) Reload script from FLASH Script Application version Operating power mode Firmware version (DSP) Erase script from RAM Store script to FLASH Analog input Configure inputs/outputs
1 1 1 1 1 1 Auto 1 -
2,22,23,24,25 Last Char ISN 0,0,0,0,0 All zero 1 Non-Aero See unit base 0
R R R R/W W
9,0
CA CB CE CF CI CN CP CR CS CU CV CW CZ IA IC
0 02 0 00 0 03 0 01 0 20 0 06 0 07 0 03 0 05
2 2 2 Auto 2 2 2 2 2
Mobile
** ** ** ** ** ** ** ** ** ** **
3 10 to 3 17 3 02
SAT-202 I/O: HV digital in SAT-202 Output: Disabled SAT-200 extended I/O: Digital out
ID IE II IO IP IQ IS IT IU IX TC TD TE
3 00 3 01 0 0A 3 03 3 18 3 1C 3 19 3 1A 3 30 3 1B 1 10 to 1 1F and 1 90 to 1 9F 1 28 1 28
Digital inputs Digital outputs [GEM-100] Ext power supply status [GEM-100] Battery power output IO7 MSP supply voltage level [GEM-100] Battery pack temperature External power supply voltage level MSP temperature [GEM-100] User LED Control [GEM-100] Battery voltage level Configure timer Disable timers Enable timers
2 2 2 -
0 0
** ** ** ** ** **
Stopped
Commercial In Confidence
TM
TR TS TT TV
Timer trigger value (timers 0 to 11 and 16 to 31) Timer trigger value (timers 12 to 15) Reset timers Restart timers Current time and date (UTC) Current timer value
R/W R/W W W R R
AC AD AE AF AR AT
Configure alarms Disable alarms Enable alarms Trigger alarms Reset alarms Alarm threshold (alarms 0 to 11 and 16 to 31) Alarm threshold (alarms 12 to 15) Configure operation Disable operations Enable operations Reset operations Trigger operations GPS satellites signal strengths GPS status GPS altitude GPS heading GPS position GPS speed Define Geofence initialisation Define Geofence point Store Geofence to FLASH Define Geofence Zone
2 2 Auto
Clear
** ** ** ** ** ** **
OC OD OE OR OT GM GS GA GH GP GV GD GF GW GZ GK GL GR GT GX
2 3 3 3 Auto -
Reset
** ** ** ** ** ** -
4 01 4 05 4 04 4 01 and 4 02 4 03
Invalid
Invalid
** ** ** ** ** ** ** ** **
4 40 to 4 47 4 20 4 11 and 4 12 4 50 to 4 5F 4 10
Distance to Target position Distance to Reference point Define Reference point Define Target position Set Reference point to current position GPS Software version GPS Position logging rate Number of logged records Get log record
GE GI LN LR MA MB 5 11 and 5 13 5 10
R R/W R R R/W W
Auto 2 -
** ** ** ** ** **
Commercial In Confidence
MC MK ML MM MN MO MP MQ MR MS MT SR RR RW BD BF BI BN BQ BW PD PI PR PS PT PV PY PZ XC XD XE XM XT mf pa pn za zo zt $A $G 5 14 5 13 and 5 15
Number of messages in receive buffer Tx message acknowledge flags field Tx message Control flags field Transmit a message Get received message Enable/disable unsolicited output of received messages Configure automatic transmit Response to tone only message Receiver status Transmit slot randomisation Transmitter status Scratchpad registers Read Register Write register Define user message number Define user message field contents Initialise user message database Number of user message definitions User message definition Close the user message database Program upload Reset Serial baud rate Enable/disable scripting Run production tests Bootloader version number Date/time of software build Serial Number [MODBUS] configuration register [MODBUS] slave data register [MODBUS] Error counter [MODBUS] slave message register [MODBUS] Target Action Register Inmarsat-D received message Program record acknowledge Program record NAK Script debug alarm triggered Script debug timer triggered Script debug operation performed NMEA input NMEA input
R R/W R/W W R R/W R/W R/W R R/W R R/W R W W W W R R W W W W R/W R R R R/W R/W R/W R/W R/W -
4 4 4 Auto Auto 2 2 2 2 2 -
0 FE
9600 1
Note 1: Write access to these scripting register parameters is only available through the use of the password protected DS prefixed command.
Commercial In Confidence
A.1 Introduction
The terminal allows for the definition of two complex geofenced areas. A geofence is an area defined by a number of points on the earths surface joined together by straight lines. The terminal tests the current position returned by the GPS module in the terminal against these defined areas and reports whether the terminal is currently inside or outside the fenced area.
A.2 Definition
The geofence algorithm used in the terminal divides the complex fenced area up into a number of zones. The testing algorithm then checks each of the zones in turn.
D E
Figure 4 - Zoned Geofence In Figure 4 the fenced area ABCDEF is split into two zones ABEF and BCDE. The point X will be detected in the first of these zones. The geofence definition method uses a two-stage definition process. The first stage is to have a table of all of the corner positions. This table is defined to have 40 entries. These table entries may be in any order, and need not all be used. The second stage is to have a zone definition table. This starts with the number of zone definition entries there are. Each entry in the zone definition table has the following structure: Number of points in zone definition Point ID 1 Point ID 2 : : Point ID n The Point ID values indicate which of the entries in the corner position table are used to define the zone. There may be a total of 188 values stored in this table. The definition for the fence shown in Figure 4 would be as follows: Honeywell Global Tracking Page A-1 of 5
Commercial In Confidence
Number of zones = 2 Number of points in zone = 4 Point ID = A Point ID = B Point ID = E Point ID = F Number of points in zone = 4 Point ID = B Point ID = C Point ID = D Point ID = E Zone Definition Table
Page A-2 of 5
Commercial In Confidence
Page A-3 of 5
Commercial In Confidence
// Declare the Geofence to have two zones defined by the // Locations already defined. DECLARE Fence { ZONE { POINT POINT POINT POINT } ZONE { POINT POINT AS GEOFENCE USE 1
Point_5 Point_6
Page A-4 of 5
Commercial In Confidence
Page A-5 of 5
Commercial In Confidence
The terminal allows the user to define the contents of the user data field in a return channel message by taking blocks of one or more bits from its internal registers and concatenating these into the data block to be transmitted. This allows, for example, the data block being transmitted in a single message to contain the states of selected digital input lines, a timestamp, the top N bits of one of the analogue input values and the external supply voltage. This is all defined by the user in a set of message configuration commands and stored in non-volatile memory so that the message format is not lost if the terminal power is removed. The message definition procedure starts by defining the identifier number to be used for the message and the number of field definitions to be used in generating the user data block. The message data fields are then defined in terms of the data source register and the bits to be extracted from that register.
Page B-1 of 4
Commercial In Confidence
Message numbers must be between 0x80 and 0xFE (128 and 254). Message numbers below 128 are reserved for the built in message formats used by the terminal. The message field definitions for a message must define exactly 64, 80 or 148 bits. If an incorrect number of bits are defined then the message will not be generated for transmission. It is not possible to reduce the number of field definitions used by sharing individual data field definitions between messages. It is possible to have multiple message numbers sharing the same payload definition. This is done by issuing a number of message number definition commands before the first field definition command. The data field definitions for a message are packed into the user data block in the order that their definitions are sent to the terminal. The fields used to define the message block are the N field definitions sent after the message number definition command. If less than N field definitions are sent then the results are undefined. The terminal does not check this condition.
If it is required to have more than one message number with the same data format then step 2 should be repeated for all of the message number definitions before moving on to step 3.
Page B-2 of 4
Commercial In Confidence
sufficient for the end application to deduce the actual time of message generation from the value and the time of delivery of the message. The analogue values being transmitted are three analogue input channels each limited to 10-bit resolution. The resolution is selected by the mask value used. In this case the mask value has bits set for the 10 most significant bits of the 12-bit analogue conversion result. This has the effect of discarding the two least significant data bits, performing a truncation operation on the data value. The remaining bits in the message are transmitted as zeros. The field definitions for the message format are shown in Table 55. Field No 1 2 3 4 5 6 Field Data UTC Minutes UTC Seconds Analogue Input 2 Analogue Input 5 Analogue Input 7 Constant Zeros Module ID 0x1 0x1 0x3 0x3 0x3 0xF Register ID 0x36 0x37 0x12 0x15 0x17 0x00 Mask Value 0x3F 0x3F 0xFFC 0xFFC 0xFFC 0x3FFFFF Bits Used 6 (6) 6 (12) 10 (22) 10 (32) 10 (42) 22 (64)
Table 55 Example Message Definition This message definition uses 6 field definitions and is being allocated a message number of 160 (0xA0). The command sequence used to define this message is shown below.
BI BD BF BF BF BF BF BF BW A0 06 136 0000003F 137 0000003F 312 00000FFC 315 00000FFC 317 00000FFC F00 003FFFFF
The BQ response for the message format defined in this example is shown below (assuming that this is the first message stored in the message database):
bq 1 A0 136 0000003F 137 0000003F 312 00000FFC 315 00000FFC 317 00000FFC F00 003FFFFF
Page B-3 of 4
Commercial In Confidence
The following differences between the SAT-202 and SAT-201/201i series should be noted:
SAT-201/201i D+ & IsatM2M 2 2 SAT-202 IsatM2M only 3 1 Important: When configuring the I/O via a script, RW command or IC command, this output must be configured as Open Drain (mode 9 see 5.6.1). Any SAT-201/201i script that configures this output as mode 1 must be changed such that the output is configured to mode 9. Indication only Selectable up to 115 kbaud 50 Channel uBlox Single, integrated log for GPS, Transmissions and Data Module 0x0 Registers 0x50 to 0xFE Module 0x3 Register 0x1F Module 0x5 Registers 0x28 to 0x2E See 5.2.1 and 5.2.6 for details HDOP DS DO Get Tx log size DS DR Get Tx log record DS TJ Get SIDs and BIDs IB Set Analog outputs GU GPS update rate GY UTC synchronisation period GN Get GPS log size GO Get GPS log record position GQ Get GPS log record - motion PG GPS Boot control LN Get number of logged records LR Get log record PZ Get Serial Number PY? (requires question mark) RW 4 15 0 (write instead of read function) Any script that uses a GEM-100 will need to be modified to include the following configuration command; RW 0 FD 1 See 5.3.22
Temperature sensor Firmware upgrade speed GPS engine Data logger Additional scripting registers (Accessible via script and RR/RW command) Script register changes: Module 0x4 Register 0x08 Commands no longer available or supported
2C 9600 baud 20 channel SiRF Star III Separate GPS & Transmission logs
GDOP
New commands
PY RR 4 15?
GEM-100 operation
Page C-4 of 4
Commercial In Confidence