Communications
SBD Relaying
Feature Summary
SBD (Short Burst Data) Relaying is a GSatTrack API that transmits messages from your application to the Iridium network via a simple HTTP POST. It returns instant status feedback on the ground-station message queue, and avoids the binary parser and static-IP whitelisting that direct Iridium integration would otherwise require.
Additional Information
SBD Relaying Communication
To easily transmit messages from your application to the Iridium network, GSatTrack has created a simple-to-use API mechanism to communicate directly with the Iridium gateway. This API allows users to receive instantaneous information regarding the message queue status at the ground station.
To communicate directly with the Iridium ground station, users would typically need to develop a binary parser and submit a static IP address for whitelisting at Iridium, a process that takes approximately 2-3 weeks.
Iridium SBD relay requests are sent using an HTTP POST to the following URL format:
https://www.gsattrack.com/Services/IridiumSBDRelay.ashx
These HTTP POSTs must include the following fields:
| Parameter | Name | Type | Description |
|---|---|---|---|
| key | SBD Key | String | The SBD Key that was set up for the customer. This identifies the customer making the request. |
| imei | IMEI | String | The IMEI of the device to receive the SBD message. |
| messageid | Message Identifier | Integer | The unique message identifier to associate with the SBD message. This identifier should be unique across your SBD messages. |
| message | Message | String (Base 64 encoded) | The binary SBD message you wish to send, encoded as a base-64 string. |
Successful submissions will return an HTTP status of 200 and include debugging information text. Submissions that encounter errors will return a non-HTTP status of 200 and provide text describing the error, such as missing input parameters.
- <form action="https://www.gsattrack.com/Services/IridiumSBDRelay.ashx" method="post">
- <fieldset>
- <div><label for="key">Client key:</label></div>
- <div><input type="text" id="key" name="key" /></div>
- <div><label for="messageid">Message Id:</label></div>
- <div><input type="text" id="messageid" name="messageid" /></div>
- <div><label for="imei">IMEI:</label></div>
- <div><input type="text" id="imei" name="imei" /></div>
- <div><label for="message">Message (base64 string):</label></div>
- <div><textarea id="message" name="message" rows="5" cols="30"></textarea></div>
- <button>Submit Message</button>
- </fieldset>
- </form>
Key Features
- Simple API Integration — send messages with a single HTTP POST, no binary parser or static-IP whitelisting required.
- Instant Feedback — message submissions return immediate ground-station queue status for quick verification and troubleshooting.
- Direct Iridium Communication — relays directly through the Iridium gateway to connected devices.
- Base64 Message Support — send binary SBD messages as base64-encoded strings.
- Error Handling — failed submissions return descriptive error text, such as missing input parameters.
Use Cases
- Remote Asset Monitoring — relay status from remote devices to your application for real-time monitoring.
- Emergency Alerts — send time-critical alerts or notifications over the Iridium network.
- Data Collection — gather operational metrics from field devices for analysis.
- Logistics and Fleet Management — track fleet movements and push real-time instructions to drivers.