Iridium Edge Communication Protocol: Difference between revisions
Appearance
MindaugasK (talk | contribs) No edit summary |
No edit summary |
||
| Line 81: | Line 81: | ||
|} | |} | ||
[[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: | |||
* Digital input 1 | |||
* Digital input 2 | |||
* Digital output 1 | |||
* Speed | |||
<br></br> | |||
Configurator parameter IDs and their explanation: | |||
{| class="nd-othertables_2" style="width:100%;" | |||
|- style="font-weight:bold; text-align:center;" | |||
! '''Parameter ID'''<br /> | |||
! '''Parameter name''' | |||
! colspan="3" | '''Values''' | |||
! '''Explanation''' | |||
|- style="font-weight:bold; text-align:center;" | |||
| style="font-weight:normal;" | | |||
| style="font-weight:normal;" | | |||
| '''Min''' | |||
| '''Max''' | |||
| '''Default''' | |||
| style="font-weight:normal;" | | |||
|- | |||
| 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 | |||
|} | |||
<br></br> | |||
'''*''' 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 | |||
<br></br> | |||
For example: to enable Din1, Din2 and Dout1: 0x01 + 0x02 + 0x10 = 0x13. | |||
Revision as of 08:38, 14 March 2023
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.