Difference between revisions of "Iridium Edge Communication Protocol"

From Wiki Knowledge Base | Teltonika GPS
Line 82: Line 82:
 
[[Category: Iridium Edge]]
 
[[Category: Iridium Edge]]
  
'''''SBD IO source''''' configures IO source which can trigger SBD record saving.  9 elements can generate Alarm for SDB sending. These elements are:
+
==SBD IO source==
 +
Configures IO source which can trigger SBD record saving.  9 elements can generate Alarm for SDB sending. These elements are:
 
* Digital input 1
 
* Digital input 1
 
* Digital input 2
 
* Digital input 2

Revision as of 08:40, 14 March 2023

Main Page > Accessories > Iridium Edge > Iridium Edge Communication Protocol

Communication Protocol

SBD Packet structure
Timestamp Longitude Latitude SBD AVL ID and flags DIN/DOUT info Reserved Speed
4 bytes 3 bytes 3 bytes 1 bytes 1 bytes 1 bytes 1 bytes

Definitions

  • Timestamp – Indicates when record was generated
  • Longitude - encoded in 3 bytes data. Server which gets this data should divide result from 46603,375 and subtract 180 in order to get actual longitude value. This coefficient is got in following way: 16777215(maximum 3 bytes value) divided from 360 (maximum longitude value then 180 is added). This calculation is used to fit negative and positive values to 3 bytes width variable.
  • Latitude - Latitude is calculated in same way as longitude but since latitude maximum value is two times smaller than longitude it can produce a bit more accurate data. Coefficient for latitude is 93206,75. This coefficient is got in following way: 16777215(maximum 3 bytes value) divided from 180 (maximum latitude value then 90 is added). This calculation is used to fit negative and positive values to 3 bytes width variable.
  • SBD AVL ID and flags – Custom id that will indicate what caused the record to be generated (as only periodic records are generated, id is not used)
  • Din/Dout info - Displays configured IO elements in parameter id 99422
  • Reserved - Not used anywhere, but left due to compatibility with fm6 project.
  • Speed – Indicates the speed of the vehicle if configured. If not (or in case of no gps) – will display 255

Data Sending Parameters

Information here includes the data sending parameters which identifies the naming of the parameter in accordance to it's number.

Parameter ID Parameter name Min values Max values Default values Description
99420 Iridium Edge 0 1 0 This parameter enables or disables Iridium Edge functionality
99421 Save/Send period 0 1440 1440 This parameter lets to configure Iridium Edge sending period
99422 SBD IO source 0 6 0 SBD IO elements which when enabled are included into the SBD record
151 RS232 Mode 0 26 0 Implement ability to select "Sattelite backup"
99423 SBD Upload Limit 0 30000 8000 Limit to save user from exceeding the monthly plan. Max limit of 30000 due to 30KB plan. If set to 0 – limit will be off.

SBD IO source

Configures IO source which can trigger SBD record saving. 9 elements can generate Alarm for SDB sending. These elements are:

  • Digital input 1
  • Digital input 2
  • Digital output 1
  • Speed



Configurator parameter IDs and their explanation:

Parameter ID
Parameter name Values Explanation
Min Max Default
99420 Iridium Edge 0 1 0 This parameter enables or disables Iridium Edge functionality
99421 Save/Send period 0 1440 1440 This parameter lets to configure Iridium Edge sending period
99422 SBD IO source* 0 8 0 SBD IO elements which when enabled are included into the SBD record
99423 SBD UploadLimit 0 30000 8000 Limit to save user from exceeding the monthly plan. Max limit of 30000 due to 30KB plan. If set to 0 – limit will be off.
99424 Power control DOUT 1 5 0 Device DOUT which can control ON/OFF pin of the Iridium Edge
151 RS232 Mode 0 23 0 RS-232 mode selection. "Satellite backup" - 15



* SBD IO source parameter is configured with bitmasks (used for configuring I/O source elements via SMS/GPRS command) :

  • Disabled = 0x00,
  • Din1 = 0x01,
  • Din2 = 0x02,
  • Dout1 = 0x10,
  • Speed = 0x100



For example: to enable Din1, Din2 and Dout1: 0x01 + 0x02 + 0x10 = 0x13.