0x83xx

0x8300 - Soft Reset

Type: void

Name: soft-reset (1)

0x8301 - Factory Reset

Type: void

Name: factory-reset (1)

0x8302 - Request Property Reporting

Type: void

Name: request-property-reporting (1)

Upon receiving this command, a device will start reporting all its reportable properties. If a device receives this command while a reporting operation is in progress, it will report a busy error response.

0x8303 - Start Upstream Throughput Test

Name: start-upstream-throughput-test (5)

Offset

Type

Default

JSON

Description

0

u16

packets

Number of Packets (n)

2

u16

interval

Interval (in ms)

4

u8

burst

Burst size

5

u8

priority

Priority. Allowed range: [0, 4]. Default priority is 2.

6

u8

20

msgSize (v10+)

Message Size (optional)

JSON Example:

{
  "packets": 1000,
  "interval": 250,
  "burst": 3,
  "priority": 2
}

Upon receiving this command, the device will send n throughput test packets upstream (to the gateway) at the specified interval and priority. Burst size is the number of packets sent back-to-back each interval. Burst size must be greater than 0 and the maximum burst size is device dependent. The gateway will increment 0x8305 - Throughput Test Packet Counter for every test-packet received.

To stop an ongoing throughput test, set n to 0. Starting a new throughput test (n > 0) while there is an ongoing test will fail.

Note

Not all firmware versions support Message Size. In order to use Messages Size greater than 20, make sure all devices support larger messages sizes.

0x8304 - Start Downstream Throughput Test

Name: start-downstream-throughput-test (5)

Offset

Type

Default

JSON

Description

0

u16

packets

Number of Packets (n)

2

u16

interval

Interval (in ms)

4

u8

burst

Burst size

5

u8

priority

Priority. Allowed range: [0, 4]. Default priority is 2.

6

mac-address

target

Target Device. Set to 0 to broadcast to all devices.

12

u8

20

msgSize (v10+)

Message Size (optional)

JSON Example:

{
  "packets": 1000,
  "interval": 250,
  "burst": 3,
  "priority": 2,
  "target": "AABBCCDDEEFF"
}

Upon receiving this command, the gateway will send n throughput test packets downstream to the target device at the specified interval and priority. Burst size is the number of packets sent back-to-back each interval. Burst size must be greater than 0 and the maximum burst size is device dependent. The target device will increment 0x8305 - Throughput Test Packet Counter for every test-packet received.

Note

Gateway versions prior to 6.1.0 does not support broadcasting, i.e. target = 0.

Note

Not all firmware versions support Message Size. In order to use Messages Size greater than 20, make sure all devices in the network support larger messages sizes.

0x8305 - Throughput Test Packet Counter

Type: u32

Name: throughput-test-packet-counter (5)

This counter will be incremented for each throughput test packet received.

Name: start-uplink-quality-test (17)

Offset

Type

Name

Description

0

u8

duration

Number of seconds to run

1

u8

flags

Flags

flags bit

Name

Description

7:2

-

Reserved

1

up

Measure upstream

0

down

Measure downstream

JSON Example:

{
  "duration": 10,
  "flags": {
    "up": true,
    "down": false  
  }
}

Name: uplink-quality-test-result (17)

Offset

Type

Name

Description

0

s16

up

Bytes/s upstream. Value will be -1 if upstream was not measured.

2

s16

down

Bytes/s downstream. Value will be -1 if downstream was not measured.

JSON Example:

{
    "up": 970,
    "down": 950
}

0x8308 - Try Ethernet

Type: void

Name: try-ethernet (5)

Upon receiving this command, a gateway on LTE/3G will reboot and try to establish connection using Ethernet.

This command will only work when the gateway is not already connected using Ethernet.

0x8309 - Try LTE

Type: void

Name: try-lte (6)

Upon receiving this command, a gateway on Ethernet will reboot and try to establish connection using LTE.

This command will only work when the gateway is not already connected using LTE.

Name: run-uplink-quality-tests (17)

Offset

Type

Name

Description

0

u8

duration

Number of seconds to run

1

u8

flags

Flags

flags bit

Name

Description

7:4

-

Reserved

3

nd

Nodes will run test

2

ex

Extenders will run test

1

up

Measure upstream

0

down

Measure downstream

JSON Example:

{
  "duration": 10,
  "flags": {
    "ex": true,
    "up": true,
    "down": true
  }
}

This gateway command property is used to initiate link test for all extenders and/or nodes in the network tree. This is effectively a broadcast write of 0x8306 - Start Uplink Quality Test.

All cached 0x8307 - Uplink Quality Test Result property values are purged. As devices complete their link test, new result values are reported.

The time required to run all tests will be approximately equal to duration x max_children, where max_children is the maximum number of children of any extender in the network.

NOTE: ex and/or nd flag must be set.

0x8310 - Reset Battery Status

Type: void

Name: reset-battery-status (1)

This is used to reset the battery relay configuration when replacing batteries in MT AirMesh 1011.

0x8311 - Shutdown

Type: void

Name: shutdown (12)

Shutdown gateway.

0x8320 - Destroy Network Below

Type: void

Name: destroy-network-below (1)

0x8321 - Destroy Network Below Child

Type: mac-address

Name: destroy-network-below-child (1)

Destroy network below and including child with provided MAC address.

0x8322 - Network Tree

Type: UTF-8 encoded JSON object. Object structure is described below.

Name: network-tree (8)

Current network tree and unconnected devices.

The format of the returned object is as follows:

Property

Type

Version

Optional

Description

version

number

-

No

Version of retuned structure/object format. Latest version: 3.

networkTree

object

1

No

Root device object, children nested inside.

unconnected

array of objects

3

No

Unconnected devices

The networkTree devices are returned as a nested structure with the gateway as the root. Version is incremented if new properties and/or values are added to the device objects or other parts of the structure. All changes will be backwards compatible.

The networkTree device objects contain the following properties:

Property

Type

Version

Optional

Description

id

string

1

No

MAC Address. 6-byte uppercase hex string. “000000000000” if unknown.

type

string

1

No

Device Type. See table below.

children

array

1

Yes

Array of device objects. If there are no children, this property will be not present or null.

rssi

number

2

Yes

Uplink RSSI. Not present when unknown or not applicable.

type

Description

“unknown”

Unknown

“extender”

Extender

“node”

Node

“gateway”

Gateway

“temporary”

Temporary

The unconnected device objects contain the following properties:

Property

Type

Version

Optional

Description

id

string

3

No

MAC Address. 6-byte uppercase hex string.

lastSeen

ISO 8601 date string

3

No

Last seen timestamp (UTC).

Example

{
  "version": 3,
  "networkTree": 
    {
      "id": "E4EBC3F77F09",
      "type": "gateway",            
      "children": [
        {
          "id": "DD19D3F413E7",
          "type": "extender",
          "rssi": -70,
          "children": [
            {
              "id": "CFA724721A24",
              "type": "extender"
            }
          ]                 
        },
        {
          "id": "000000000000",
          "type": "unknown"                           
        },
        {
          "id": "E0E70B2EC9BF",
          "type": "node",
          "rssi": -84
        }
      ]      
    },
    "unconnected": [
        {
          "id": "C97C04CE99A8",
          "lastSeen": "2025-10-28T15:23:35Z"
        },
        {
          "id": "ED9D831F7569",
          "lastSeen": "2025-10-28T15:23:30Z"
        }
    ]
}

0x8330 - Flush Property Cache

Type: void

Name: flush-property-cache (1)

Flush device property cache.

When property throttling is enabled in gateways, the data-consumer client(s) must issue a flush at start-up to sync up. This will cause all gateways to send the next property updates even though the values might not have changed.

When property throttling is enabled (using 0x8220 property), property updates are normally only sent when the gateway detects the value has changed.

0x8331 - Flush Backfill

Type: void

Name: flush-backfill (15)

Flush backfill data samples.

0x8340 - Sleep

Type: u16

Name: sleep (1)

Go to sleep for a period of time. After the specified period, the device returns back to its previous mode of operation.

In sleep mode the device operates like in storage mode, but does not advertise.

The value is the sleep period in minutes. The values 0 and 65535 cannot be used.