Integration with your application
Delivering MO messages to your application
HTTP Webhook API
This is the preferred method as it provides guaranteed delivery.
Full details are in the Reference section: Receiving MO messages via HTTP Webhook
👍 Don't forget to whitelist Ground Control's IP Addresses to receive data!
These are the IP addresses you will need to whitelist so that we can send data through your firewall:
109.74.196.135
212.71.235.32
Email delivery
Please note that this method of delivery can be less reliable than the HTTP POST method discussed above. Nonetheless, it can be a convenient, and human-readable way to deliver your messages.
You must first configure the email address(es) for delivery, which can be done by logging in to your RockBLOCK account.
When a message is sent by your RockBLOCK, we will send an email to your configured addresses. An example of the email format is shown below:
| Subject | 'Message 507 from RockBLOCK 300434065264590' |
| Body | IMEI: 300434065264590 MOMSN: 507 Transmit Time: 2022-06-21T09:31:18Z UTC Iridium Latitude: 31.3025 Iridium Longitude: 28.6838 Iridium CEP: 90.0 Data: 48656c6c6f21205468697320697320612074657374206d6573736167652066726f6d20526f636b424c4f434b21 Hello! This is a test message from RockBLOCK! |
| Attachment | 300434065264590-507.bin (45 bytes) |
Your message appears hex-encoded in the body of the email. The unencoded message data is also attached.
Please refer to the table above (HTTP POST parameters) for a description of the other fields.
ThingSpeak
Integrating with MathWork's ThingSpeak
📘 ThingSpeak
ThingSpeak is an Internet of Things (IoT) platform that lets you collect and store sensor data in the cloud and develop IoT applications. The ThingSpeak™ IoT platform provides apps that let you analyze and visualize your data in MATLAB®, and then act on the data.
In order for the RockBLOCK system to push data to ThingSpeak, you need to set one of your RockBLOCK delivery group destinations to:
https://api.thingspeak.com/update?api_key=XYZ
Where XYZ is your write key for the channel.
The transmission format that you need to send your data in is:
datetime,field1,field2,field3,field4,field5,field6,field7,field8,latitude,longitude,elevation
The datetime can be in either of the following formats:
- yyyy-MM-dd HH:mm:ss e.g. 2018-03-12 16:59:24
- seconds or milliseconds since Jan 1 1970, e.g. 1520873964 represents 2018-03-12 16:59:24
For example, this is a valid format (no datetime or position included):
,25.0,75.0,10.05,70.0,80.0,42850,1700
Sending MT messages from your application
HTTP API
The HTTP endpoint for sending MT messages is documented here:
From web console
When not using an API, log on to the Web Admin page so send admin messages to RockBLOCKS. See the RockBLOCK Management Page for more details.