0x81xx¶

0x8100 - Battery Level¶

Type: u8

Name: battery-level (1)

Battery level in percent.

0x8101 - Uptime¶

Type: u32

Name: uptime (1)

Seconds since boot.

0x8102 - Reset Cause¶

Type: u8

Name: reset-cause (3)

Reset cause.

0x8103 - VDD¶

Type: u16

Name: vdd (6)

System voltage (VDD) in mV.

0x8104 - Time¶

Type: u64

Name: time (11)

Unix time in milliseconds.

A value of 0 is returned if time is unknown (not sync’ed).

0x8105 - Last Time Sync¶

Type: s32

Name: last-time-sync (11)

Seconds elapsed since last time sync.

A value of -1 is returned if time has not yet been synced.

0x8106 - CPU Temperature¶

Type: s16

Name: cpu-temperature (15)

CPU temperature. Unit is centi degrees Celsius.

When converted to JSON, the type is number with unit in degrees Celsius.

0x8110 - Device Mode¶

Type: u8

Name: device-mode (1)

JSON

"dfu" | "connected" | "storage" | "unconnected"

Device will use this to report its device mode.

When the mode changes, the device will report the new mode to make sure it’s updated.

In storage mode, all the device will report is a storage heartbeat. This is picked up by the network extenders. The gateway will then update this to Storage.

In DFU mode, the device will advertise with Nordic DFU. This will be picked up by the network extenders. The gateway will then update this property to DFU.

0x8111 - Legacy Device Mode Switch¶

Name: legacy-device-mode-switch (1)

JSON

{
  "mac": [hex-string(12)],
  "mode": [number]
}

Connect to device and switch device mode using phone/raw command.

0x8112 - Storage Mode Event¶

Name: storage-mode-event (1)

JSON

{
  "modelNumber": 5,
  "variant": 4,
  "secureFlags": 1,
  "networkId": "0000000000"
}

While a device is in storage mode, the gateway will generate events using this identifier.

0x8113 - Watchdog Reset Event¶

Type: void

Name: watchdog-reset-event (3)

Indicates last reset was watchdog reset.

0x8120 - Firmware Update State¶

Type: u8

Name: firmware-update-state (1)

The range 129 - 254 is used to abort error states.

Extensions

JSON

{
  "broadcast": [boolean]
}

0x8121 - Start Firmware Update¶

Name: start-firmware-update (1)

JSON

{
  "version": "{major}.{minor}.{patch}" | "{major}.{minor}.{patch}-beta.{beta}",
  "type": [number],
  "timeout": [number]
}

A device that is not connected must establish a temporary connection to download the firmware. Gateways and extenders should reserve at least one slot for such temporary connections. This is configured using 0x8210 - Downlink Configuration

Timeout must be set long enough for the device to be able to downloading the firmware from the gateway. The time needed depends on the number devices being upgraded simultaneously. The gateway will fetch the firmware automatically from Meshtech Management when it is requested by a device.

If a device does not support this type of firmware update, it will not support this property and hence respond with an error code indicating this.

0x8122 - Firmware Update Control¶

Type: u8

Name: firmware-update-control (1)

0x8123 - Start Firmware Update with Model Number¶

Name: start-firmware-update-with-model-number (1)

JSON

{
  "version": "{major}.{minor}.{patch}" | "{major}.{minor}.{patch}-beta.{beta}",
  "type": [number],
  "timeout": [number],
  "modelNumber": [number]
}

This command works like 0x8121, but allows for switching to another model number. The device will check if it supports switching to the specified model number.

0x8124 - Start Firmware Broadcast¶

Name: start-firmware-broadcast (7)

JSON

{
  "modelNumber": [number],
  "version": "{major}.{minor}.{patch}" | "{major}.{minor}.{patch}-beta.{beta}",
  "type": [number],
  "packetInterval": [number],   // Optional. Default: 0
  "force": [boolean],           // Optional. Default: false
  "priority": [number],         // Optional. Default: 2
  "b160": [boolean]             // Optional. Default: false (v10+),
  "b128": [boolean]             // Optional. Default: false (v13+)
}

0x8125 - Firmware Broadcast State¶

Type: u8

Name: firmware-broadcast-state (7)

The range 129 - 254 is used to abort error states.

0x8126 - Firmware Broadcast Control¶

Type: u8

Name: firmware-broadcast-control (7)

To apply, there can be no ongoing broadcast.

After aborting firmware broadcast and no more firmware blocks are being sent, the devices will time out after 60 seconds.

0x8127 - Firmware Update Info¶

Name: firmware-update-info (13)

Nullable: Yes

JSON Example

{
  "modelNumber": 64,
  "version": "2.0.1",
  "type": 1
}

0x8130 - Nordic DFU State¶

Type: u8

Name: nordic-dfu-state (1)

The range 129 - 254 is used to abort error states.

0x8131 - Start Nordic DFU¶

Name: start-nordic-dfu (1)

JSON

{
  "mac": [hex-string(12)],
  "modelNumber": [number],
  "version": "{major}.{minor}.{patch}" | "{major}.{minor}.{patch}-beta.{beta}"
}

Gateway/network extender will try to connect to the device in DFU mode and start upgrading the application image.

The device that is to be upgraded must be in DFU mode. Devices that use secure mode (nRF52) will change MAC address by +1 when switched to DFU mode.

0x8132 - Nordic DFU Control¶

Type: u8

Name: nordic-dfu-control (2)

0x8150 - Motion Detection Sensitivity¶

Type: u8

Name: motion-detection-sensitivity (3)

0x8160 - Ping Counter¶

Type: u16

Name: ping-counter (3)

The remaining number of times to ping, counting downwards.

The ping counter is advertised and generates RSSI measurements when picked up by nearby access points.

The device will stop pinging when the count reaches 0. This property can be used to control device pinging. 0xFFFF is reserved. Writing 0 will stop pinging.

The device will only ping while in Connected mode and while being connected. If the device is disconnected it will stop pinging and then resume pinging when reconnected.