Iridium Edge Communication Protocol: Difference between revisions

(18 intermediate revisions by 5 users not shown)

Line 1:

__TOC__

==Iridium Configuration Parameters==

Information here includes the naming of the configurable parameter in accordance to it's number.

{| class="wikitable"

|+

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Parameter ID'''

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Parameter Type'''

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Default Values'''

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Min Value'''

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Max Value'''

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Value'''

! rowspan="1" style="width: 400px; background: #000000; color: white;" |'''Description'''

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99420

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Uint8

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0 - OFF 1 - ON

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx125/FMx225) TSM232 and Iridium edge (FMx6xx) Short Burst data settings TSM232 and Iridium edge

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99421

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Uint16

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1440

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1440

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Minutes

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Save/Send period

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99422

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Uint16

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1574

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0 - Nothing 2 - DIN1 4 - DIN2 32 - DOUT1 512 - Speed 1024 - Crash

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Save/Send period

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99423

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Uint16

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |8000

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |3000

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Bytes

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |SBD Upload Limit (B)

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx6xx) 99424

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Unit8

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |4

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" | 0 - None 1 - None 2 - DOUT1 3 - DOUT2 4 - DOUT3 5 - DOUT4

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx6xx) Power Control DOUT

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |150

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Unit8

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |2

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" | 0 - Disable '''1 - RS232''' 2 - RS485

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" | (valid only for FMx125/FMx225) Enable RS232 mode for the Iridium terminal

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |151

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Unit8

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |26

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |FMx125 7 - Satellite backup FMx650 16 - Satellite backup

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx125/FMx225) RS232 Mode Satellite backup (Fmx6xx) RS232 Settings COM2 Settings Satellite backup

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx6xx) 152

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Uint24

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |128000

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1920 kbps

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Baudrate required for Satellite backup is 1920 kbps

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx6xx) 173

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Unit8

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |26

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |FMx650 - 16

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |RS232 Settings COM2 Settings Satellite backup

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |(FMx6xx) 174

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Uint24

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |128000

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1920 kbps

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Baudrate required for Satellite backup is 1920 kbps

|-

|}

==Communication Protocol==

Line 23:

Line 118:

|}

~~'''Definitions'''~~

Data Sending Parameters

* Timestamp – Indicates when record was generated

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

* 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==~~

'''Parsing of the Iridium SBD record'''

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

“Hercules” Software or similar is required to listen your pc port.

{| class="wikitable"

Also, Iridium must be set up to send packets to your pc.

Run "Hercules":

#Select TCP server tab

#Insert your PC port

#Right click in “Sent Data” window

#Select Special characters/Hexadecimal

#This will enable the “HEX enable” selection, enable this option.

[[File:Iridium SBD test setup 1.png]] [[File:Iridium SBD test setup 2.png]]

Now Iridium packets can be captured by Hercules.

Hercules will receive the full Iridium packet, but '''only last 14 bytes are needed''':

[[File:Iridium packet example.png]]

Full packet looks like this:

{01}{00}{3E}{01}{00}{1C}{7F}{DA}{96}{A1}{33}{30}{30}{32}{33}{34}{30}{36}{34}{30}{37}{30}{38}{33}{30}{00}{0A}{E9}{00}{00}{63}{57}{6A}{E3}{03}{00}{0B}{00}{36}{A5}{A7}{19}{2F}{E9}{00}{00}{00}{04}{02}{00}{0E}{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

There blue part of record is satellite device generated data and green is actual record payload which was sent to server.

Only the green part (last 14 bytes) is needed for analysis:

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

==Packet Parsing==

'''Packet:'''

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

{| class="wikitable" style="width:50%;"

|+

! ~~rowspan~~="1" style="width: ~~400px; background: #0054A6~~; ~~color~~: white;~~" |'''Parameter ID'''~~

! colspan="7" style="width:50%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| SBD Packet structure

~~! rowspan="1" style="width: 400px; background~~: #0054A6~~; color: white;" |'''Parameter name'''~~

~~! rowspan="1" style="width: 400px~~; background~~: #0054A6; color~~: white~~;" |'''Min values'''~~

~~! rowspan="1" style="width: 400px; background: #0054A6; color: white;" |'''Max values'''~~

~~! rowspan="1" style="width: 400px; background: #0054A6~~; color~~: white;" |'''Default values'''~~

~~! rowspan="1" style="width: 400px; background~~: #0054A6; ~~color: white;" |'''Description'''~~

|-

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99420~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Iridium Edge~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |This parameter enables or disables Iridium Edge functionality~~

|-

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99421~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Save/Send period~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1440~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |This parameter lets to configure Iridium Edge sending period~~

|-

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99422~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |SBD IO source~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |6~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="~~text-align: ~~center; style=" width: 150px; background: white; color: black~~;" |SBD ~~IO elements which when enabled are included into the SBD record~~

|-

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |151~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |RS232 Mode~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |26~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Implement ability to select "Sattelite backup"~~

|-

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |99423~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |SBD Upload Limit~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |30000~~

~~| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |8000~~

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |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.

|}

~~[[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:~~

* Digital input 1

* Digital input 2

* Digital output 1

* Speed

~~ ~~

~~Configurator parameter IDs and their explanation:~~

~~{| class="nd-othertables_2" style="width:100%;"~~

~~|- style="font-weight:bold; text-align:center;"~~

~~! '''Parameter ID''' ~~

~~! '''Parameter name'''~~

~~! colspan="3" | '''Values'''~~

~~! '''Explanation'''~~

~~|- style="font-weight:bold; text-align:center;"~~

~~| style="font-weight:normal;" |~~

~~| '''Min'''~~

~~| '''Max'''~~

~~| '''Default'''~~

~~| style="font-weight:normal;" |~~

|-

| ~~99420~~

! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| Timestamp

| ~~Iridium Edge~~

! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| Longitude

| 0

! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| Latitude

| 1

! style="width:15%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| SBD AVL ID and flags

| 0

! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| DIN/DOUT info

| ~~This parameter enables or disables Iridium Edge functionality~~

! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| Reserved

! style="width:10%; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;"| Speed

|-

| ~~99421~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 4 bytes

| ~~Save/Send period~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 3 bytes

| 0

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 3 bytes

| ~~1440~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 1 bytes

| ~~1440~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 1 bytes

| ~~This parameter lets to configure Iridium Edge sending period~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 1 bytes

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 1 bytes

|-

| ~~99422~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | AD695763

| ~~SBD IO source~~'''*'''

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 91F6A0

~~| 0~~

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | CDCC64

| 8

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 00

| 0

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 00

~~| SBD~~ IO elements ~~which when enabled are included into the~~ SBD record

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | FF

| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: center; background: white;" | 00

|}

===Timestamp===

Indicates when record was generated

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

First 4 bytes are timestamp in hex:

'''AD695763'''

Converter: https://www.epochconverter.com/hex

Converted Data:

*'''GMT:''' ''Sunday, March 12, 2062 4:07:05 AM

*'''Your time zone:''' ''Sunday, March 12, 2062 6:07:05 AM GMT+02:00

*'''Decimal timestamp/epoch:''' ''2909362025

===Longitude===

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.

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

5-7th bytes are longitude:

91F6A0 convert to decimal -> 6525430

(6525430/46603.375) - 180= -39.9794542777

===Latitude===

Latitude - 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.

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

8-10th bytes are latitude:

CDCC64 convert to decimal -> 10538444

(10538444/93206.750)-90=23.0652447382

===SBD AVL ID And Flags===

SBD AVL ID and flags – Custom id that will indicate what caused the record to be generated (if periodic record are generated, id is not used).

From 03.28.06.Rev.320 supported all AVL ID's listed below.

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

11-th byte is SBD AVL ID

00 convert to decimal -> 0

===DIN/DOUT Info===

Din/Dout info - Displays configured IO elements in parameter id 99422

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

12-th byte is DIN\DOUT info

00 converted to binary is 00000000

00000000 -> bits presenting DINs and DOUTs state in 1 - high, 0 - low or turned off (if not configured to be sent in SBD record), DINs and DOUTs are represented in this order in DIN/DOUT info bits DIN1, DIN2, DIN3, DIN4, DOUT1, DOUT2, DOUT3, DOUT4

{| class="wikitable"

! Hex !! 00 !! Converted to binary = !! 0 !! 0 !! 0 !! 0 !! 0 !! 0 !! 0 !! 0

|-

| ~~99423~~

! colspan="3" |

| ~~SBD UploadLimit~~

| DIN1 || DIN2 || DIN3 || DIN4 || DOUT1 || DOUT2 || DOUT3 || DOUT4

| 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.~~

~~==SDB record structure==~~

Examples with a different value:

~~SDB Record which will be sent through the Iridium satellites network will be~~ different ~~than the regular record. It will contain 4 bytes timestamp, 3 bytes longitude, 3 bytes latitude, 1 byte record generation info, 1 byte DIN,DOUT info, 1 byte Speed~~ value.

{| class="~~nd-othertables_2" style="width:100%;~~"

{| class="wikitable"

~~|-style~~=~~"text-align:center"~~

! Hex !! 16 !! Converted to binary = !! 0 !! 0 !! 0 !! 1 !! 0 !! 1 !! 1 !! 0

!~~Timestamp~~

|-

!~~Longitude~~

! colspan="3" |

!~~Latitude~~

| DIN1 || DIN2 || DIN3 || '''DIN4''' || DOUT1 || '''DOUT2''' || '''DOUT3''' || DOUT4

!~~SDB AVL ID and flags~~

!~~DIN/DOUT info~~

!~~Reserved~~

!~~Speed~~

|- ~~style~~="~~font-weight:normal;~~"

|4B

|3B

|1B

|}

~~'''''Timestamp''''' - Indicates when record was generated.~~

{| class="wikitable"

~~ ~~

! Hex !! 69 !! Converted to binary = !! 0 !! 1 !! 1 !! 0 !! 1 !! 0 !! 0 !! 1

~~'''''Longitude'''''~~ - In this packet is encoded in 3 bytes data. The server that gets this data should divide the result from 46603,375 and subtract 180 to get the actual longitude value. This coefficient is got in the following way: 16777215(maximum 3 bytes value) divided by 360 (maximum longitude value then 180 is added). This calculation is used to fit negative and positive values to 3 bytes width variable.

|-

~~ ~~

! colspan="3 |

'''''Latitude''''' - Is calculated in the same way as longitude but since latitude maximum value is two times smaller than longitude it can produce a bit more accurate data. The coefficient for latitude is 93206,75. This coefficient is got in the following way: 16777215(maximum 3 bytes value) divided by 180 (maximum latitude value then 90 is added). This calculation is used to fit negative and positive values to 3 ~~bytes width variable.~~

| DIN1 || '''DIN2''' || '''DIN3''' || DIN4 || '''DOUT1''' || DOUT2 || DOUT3 || '''DOUT4'''

~~ ~~

|}

'''~~Din/Dout info~~''' ~~- Displays configured IO elements in parameter id 99422 (only din/dout). If IO is not set, it will send be replaced by 0.~~

~~ ~~

'''~~Reserved~~''' ~~- Not used anywhere.~~

~~ ~~

'''~~Speed~~''' ~~– Indicates the speed (from GNSS) of the vehicle if configured. If not (or in case of no gps) – will display 255.~~

~~ ~~

'''''~~SBD AVL ID and flags~~''~~''' – Custom ID that will indicate what caused the record to be generated~~

~~This byte is divided in two parts of four bits, as shown in table below:~~

{| class="~~nd-othertables_2~~" ~~style~~=~~"width:100%;"~~

{| class="wikitable"

! Hex !!42!! Converted to binary = !! 0 !! 1 !! 0 !! 0 !! 0 !! 0 !! 1 !! 0

|-

! colspan="~~4" style="font-weight:bold;~~" | ~~ Flags (not used yet)~~

! colspan="3"|

~~! colspan="4" style="font-weight:bold;"~~ | ~~ SBD AVL ID~~

| DIN1 || '''DIN2''' || DIN3 || DIN4 || DOUT1 || DOUT2 || '''DOUT3''' || DOUT4

|~~- style="color:#fe0000;"~~

| ~~ Bit 7~~

| ~~ Bit 6~~

| ~~ Bit 5~~

| ~~ Bit 4~~

| ~~style="color:#3531ff;"~~ | ~~ Bit 3~~

| ~~style="color:#3531ff;"~~ | ~~ Bit 2~~

| ~~style="color:#3531ff;"~~ | ~~ Bit 1~~

| ~~style="color:#3531ff;"~~ | ~~ Bit 0~~

|}

~~SBD AVL ID~~ is used ~~to show which IO element generated~~ the ~~Panic element~~. ~~The list of currently implemented possible values is described below~~:

===Reserved===

{| class="nd-~~othertables_2~~" style="width:~~100%~~;"~~font~~-~~weight~~:~~bold~~; ~~vertical~~-align:~~middle~~;"

Reserved - Not used anywhere, but left due to compatibility with fm6 project.

! style="~~font~~-~~weight~~:~~bold~~;" | ~~ ID~~

~~! 0~~

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

~~! ~~1

~~! ~~2

13-th byte is reserved for FM devices and on FMB platform not used, therefore it is always FF.

~~! ~~24

~~! ~~179

===Speed===

~~! 247~~

Speed – Indicates the speed of the vehicle if configured.

{AD}{69}{57}{63}{91}{F6}{A0}{CD}{CC}{64}{00}{00}{FF}{00}

14-th byte need to be converted from HEX to decimal, only GNSS Speed used, if no GNSS fix FF - 255 sent, if not configured to send as SBD IO element 0 sent.

===SBD AVL ID’s===

{| class="wikitable"

|+

! rowspan="1" style="width: 45px; background: #0054A6; color: white;" |'''ID'''

! rowspan="1" style="width: 120px; background: #0054A6; color: white;" | '''IO Element'''

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |0

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Periodic record

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |1

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Digital Input 1

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |2

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Digital Input 2

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |24

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Speed

|-

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |179

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Digital Output 1

|-

| style="~~font~~-~~weight~~:~~bold~~;" | ~~ IO element~~

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |247

| ~~ Periodic rec.~~

| rowspan="1" style="text-align: center; style=" width: 150px; background: white; color: black;" |Crash

~~| Digital Input~~ 1

~~| Digital input 2~~

~~| Speed~~

~~| DOUT1~~

| ~~ ~~Crash

|}

~~ ~~

~~Data from Bit 7 to Bit 4 are not used at the moment. The server should ignore this data part.~~

~~ ~~

'''''DIN/DOUT info''''' - Displays configured IO elements values of enabled IO elements in SBD IO source settings - (parameter ID 99422). Since digital inputs can contain only logic 1 or 0 they are bit masked in one byte.

==~~SBD packet example~~==

===Additional Information===

~~'''Unparsed~~ data~~:'''~~

*1 Iridium data packet uses 14 bytes of data, this means when using SBD8 service plan we get 8000/14=571 records, please keep this in mind when testing out the iridium terminal.

*The device is able to generate 1 record every minute. That is about 9,5 hours of continuous record generation (once every minute), which can deplete the plan.

~~''01004C01001CF99DD263333030323334303634303730383330000018000059282DBC03000B0036A2B8193D120000000302001C''~~

*Exceeding the plan will introduce overdraft fees, unless SBD upload limit is configured.

~~ ''59282BA391F5ABCDBFDD0180000059282BA891F5ABCDBFDD0180000059282BA391F5AB'' ~~

~~ ~~

~~{01} – Protocol revision number ~~

~~{00}{4C} – overall message length ~~

~~{01} – MO header IEI ~~

~~{00}{1C} – MO header length ~~

~~{F9}{9D}{D2}{63} – CDR Reference ~~

~~{33}{30}{30}{32}{33}{34}{30}{36}{34}{30}{37}{30}{38}{33}{30} – IMEI of~~ the ~~device ~~

~~{00} – Session status (Transfer OK in this case) ~~

~~{00}{18} – MOMSN ~~

~~{00}{00} – MTMSN ~~

~~{59}{28}{2D}{BC} – Time of session ~~

~~{03} – MO Location information IEI ~~

~~{00}{0B} – MO Location information length ~~

~~{00}{36}{A2}{B8}{19}{3D}{12} – MO latitude and longitude as described in Iridium documentation~~. ~~ ~~

~~{00}{00}{00}{03} – CEP radius ~~

~~{02} – Payload IEI ~~

~~{00}{1C} – Payload length ~~

~~{59}{28}{2B}{A3}{91}{F5}{AB}{CD}{BF}{DD}{01}{80}{00}{00} – Record 1 ~~

~~{59}{28}{2B}{A8}{91}{F5}{AB}{CD}{BF}{DD}{01}{80}{00}{00} – Record 2 ~~

~~There blue part of record is satellite~~ device ~~generated data and green is actual record payload which was sent to server from {{{device|}}}~~. ~~Information of the first record should be parsed like this:~~

*Once device reaches SBD limit it will stop sending records via Iridium terminal.

~~ ~~

~~{59}{28}{2B}{A3} – Timestamp of record generation in GMT0; ~~

~~{91}{F5}{AB} – Longitude (recalculated value is 25,255756) ~~

~~{CD}{BF}{DD} – Latitude (recalculated value is 54,832396) ~~

~~{01} – DIN1 generated event ~~

~~{80} – DIN1 on, while DIN2, DOUT1, – off ~~

~~{00} – Reserved byte ~~

~~{00} – Vehicle was stopped when the record was generated ~~