Skip to main content

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