Get/Set Gateway Info

Get or set the gateway info through the /cassia/info API, called via Call the RESTful API.

• GET /cassia/info: Get the overall gateway status, including model, firmware version, feature list, cellular module (dongle) configuration, GPS state, etc.

• POST /cassia/info: Set the gateway configuration. The body only needs the changed fields; the other fields are preserved.

Note

• The gateway reboots when the configuration changes, and the new configuration takes effect after the reboot. Posting the same configuration as the current one does not trigger a reboot.

• After the gateway reboots, the APP resumes automatically only if Run at Startup is enabled.

Example

import asyncio
import json

import cassiablue


async def get_info():
    ok, ret = await cassiablue.send_cmd("/cassia/info")
    print("get info done:", ok)
    if not ok:
        print("get info failed:", ret)
        return None
    return json.loads(ret)


async def enable_gps_startup(info):
    dongle = info.get("dongle") or {}
    if str(dongle.get("gps_startup")) == "1":
        print("gps_startup already enabled, skip")
        return

    body = json.dumps({"dongle": {"gps_startup": "1"}})
    ok, ret = await cassiablue.send_cmd("/cassia/info", "POST", None, body)
    print("set gps_startup done:", ok, ret)


async def main():
    info = await get_info()
    if not info:
        return

    print("model:", info.get("model"))
    print("version:", info.get("version"))
    print("features:", info.get("features"))

    await enable_gps_startup(info)


asyncio.run(main())

API

Get Gateway Info

ok, result = await cassiablue.send_cmd("/cassia/info")
info = json.loads(result)

The response is the overall gateway status. The following is an excerpt (unrelated fields are omitted):

{
  "model": "M2000",
  "version": "2.2.0.2608241151",
  "features": ["gps", "microapp"],
  "dongle": {
    "imsi": "",
    "operator": "",
    "band": "",
    "ICCID": "",
    "signal": 0,
    "apn": "",
    "gps_startup": "1"
  },
  "gps": {
    "TIME": "",
    "LON": "",
    "LAT": "",
    "NS": "",
    "WE": "",
    "SATELLITE1": 0,
    "SATELLITE1_SNR": 0
  }
}

Common Fields

Field	Type	Description
model	str	Gateway model
version	str	Gateway firmware version
features	list	Features supported by the gateway (e.g. gps microapp)
dongle	dict	Cellular module configuration and status (including gps_startup etc.)
gps	dict	GPS state (refer to GPS Positioning)

Set Gateway Info

body = json.dumps({"dongle": {"gps_startup": "1"}})
ok, result = await cassiablue.send_cmd("/cassia/info", "POST", None, body)

The body only needs to contain the changed fields. On success, result returns OK.