Connection Status API

note

Minimum version v0.10.0

Local devices attached to the LAN may need to check when the RockREMOTE is ready to receive data to for the WAN (Iridium or cellullar connection). For example, when using the sleep pin to wake up the RockREMOTE from low-power mode, it can take around a minute to fully start and establish a WAN connection.

It may also be desirable to check the the RockREMOTE is currently connected to ceullular or has failed over to Iridium, as this may affect the amount of data that gets sent.

Devices can make a HTTP GET request on port 8080 to the local IP address of the RockREMOTE (default 192.168.250.1), as follows:

http://<rockremote ip:8080>/api/public/connection

The response will be one of the following plain text strings:

disconnected
cellular
iridium

Any response code other than 200 should be treated as disconnected.

Do not check signal strength before sending

The Iridium Certus 9704 and 9770 transceivers in RockBLOCK and RockREMOTE products are configured in firmware to transmit only when signal strength is at least 1 bar. Do not duplicate this check in your application. Do not delay, block or skip a transmission based on a signal reading; send the data and the transceiver will transmit it when conditions allow.

Signal readings remain useful for diagnostics, installation checks and monitoring.