0x82xx¶

0x8200 - Accelerometer Configuration¶

Name: accelerometer-configuration (1)

Configuration of accelerometer (IIS2DH).

Offset	Type	Description
0	u8	Bit3 to Bit0 – for ODR setting (See ODR settings table) Bit5 to Bit4 – for FS setting (00: ±2 g; 01: ±4 g; 10: ±8 g; 11: ±16 g) Bit6 – Interrupt 1 enable (1) / disable (0) Bit7- Interrupt 2 enable (1) / disable (0)
1	u8	Interrupt 1 threshold. Refer Interrupt threshold section
2	u8	Interrupt 1 duration. Refer Interrupt duration section
3	u8	Interrupt 1 blocking time. Avoid all interrupt for (X * 100 ms) after occurrence of interrupt.
4	u8	Interrupt 1 counter to switch in use to not in use and vice versa.
5	u8	Interrupt 2 threshold. Refer Interrupt threshold section
6	u8	Interrupt 2 duration. Refer Interrupt duration section

ODR Settings:

ODR3	ODR2	ODR1	ODR0	Power mode selection
0	0	0	0	Power-down mode
0	0	0	1	HR / Normal / Low-power mode (1 Hz)
0	0	1	0	HR / Normal / Low-power mode (10 Hz)
0	0	1	1	HR / Normal / Low-power mode (25 Hz)
0	1	0	0	HR / Normal / Low-power mode (50 Hz)
0	1	0	1	HR / Normal / Low-power mode (100 Hz)
0	1	1	0	HR / Normal / Low-power mode (200 Hz)
0	1	1	1	HR / Normal / Low-power mode (400 Hz)
1	0	0	0	Low-power mode (1.620 kHz)
1	0	0	1	HR/ Normal (1.344 kHz) Low-power mode (5.376 kHz)

Interrupt Threshold:

Bit	Description
0:6	1 LSB = 16 mg @ FS = 2 g 1 LSB = 32 mg @ FS = 4 g 1 LSB = 62 mg @ FS = 8 g 1 LSB = 186 mg @ FS = 16 g
7	always 0

Interrupt Duration:

Bit	Description
0:6	1 LSB = 1/ODR
7	always 0

Note

Bits 0 to 6 set the minimum duration of the interrupt event to be recognized. Duration steps and maximum values depend on the ODR chosen. Duration time is measured in N/ODR, where N is the content of duration register.

Example:

Offset	Value	Description
0	D3	Both interrupt enabled, ±4g, 25 Hz ODR
1	20	1024 mg
2	00	0 ms
3	03	blocking time is 3 * 100 = 300 ms
4	05	Switch device status after 5 interrupt detections (do not count interrupt during blocking time). Duration between each interrupt must be less than 30 second, else reset counter.
5	18	768 mg
6	19	1000 ms

JSON

{
  "odr": ["powerdown"|"1Hz"|"10Hz"|"25Hz"|"50Hz"|"100Hz"|"200Hz"|"400Hz"|"low-power"|"mixed"],
  "fs": ["2g"|"4g"|"8g"|"16g"],
  "int1":
  {
     "enable": [boolean],
     "threshold": [number],
     "duration": [number],
     "blockingTime": [number],
     "motionCount": [number]
  },
  "int2":
  {
     "enable": [boolean],
     "threshold": [number],
     "duration": [number]
  }
}

0x8201 - Debug¶

Type: u32

Name: debug (10)

Set to a non-zero value to enable debug features.

Warning

This is intended for internal use by Meshtech and may alter device operation. Use with caution.

Bit	Description
1	Blink
0	Debug

0x8202 - Demo Mode¶

Type: bool

Name: demo-mode (1)

Devices supporting Demo Mode will have this property.

0x8203 - Heartbeat Interval¶

Type: u16

Name: heartbeat-interval (1)

Heartbeat interval in seconds.

Default Value for all devices is 10 minutes.

0x8204 - Motion to Not In Motion Timeout¶

Type: u16

Name: motion-to-not-in-motion-timeout (1)

Device will switch from motion to not in motion state if no motion event occurred for this time. Value is in seconds.

Default Value for all devices: 60 seconds

0x8210 - Downlink Configuration¶

Name: downlink-configuration (1)

Offset	Type	Description
0	u8	Bits[7:4] = Reserved Beacon Connections, Bits[3:0] = Reserved Node Connections
1	u8	Bits[7:4] = Reserved Temporary Connections, Bits[3:0] = Maximum Connections

JSON

{
  "beacons": [number],
  "nodes": [number],
  "temporary": [number],
  "max": [number]
}

Note

The sum of reserved Connections must be less than or equal to Maximum Connections.

Note

The max value for Maximum Connections is device dependent.

0x8211 - RSSI Throttling Limit¶

Type: s8

Name: rssi-throttling-limit (1)

Set to forward unconnected data only if RSSI is greater than or equal to a limit. Set to 0 to disable.

Example

When set to -80, a network extender will discard all unconnected data received with less than -80 dBm.

0x8212 - Downlink Configuration 2¶

Name: downlink-configuration-2 (6)

Offset	Type	Description
0	u8	Reserved Extender Connections (Maximum value: 15)
1	u8	Reserved Node Connections
2	u8	Reserved Temporary Connections
3	u8	Maximum Connections

JSON

{
  "extenders": [number],
  "nodes": [number],
  "temporary": [number],
  "max": [number]
}

Note

The sum of reserved Connections must be less than or equal to Maximum Connections.

Note

The max value for Maximum Connections is device dependent.

Warning

Do not change this configuration parameter unless you are have a good understanding of the consequences.

0x8213 - RSSI Throttling Mode¶

Name: rssi-throttling-mode (12)

The first byte indicates mode. Depending on the mode, additional configuration values may follow.

Mode = 0:

Offset	Type	Description
0	u8	No throttling (0)

Mode = 1:

Offset	Type	Description
0	u8	Salto door throttling (1)
1	u8	Interval (in seconds)
2	s8	Far RSSI threshold
3	s8	Near RSSI threshold

JSON

{
  "mode": [number],
  "interval": [number],
  "farRssiThreshold": [number],
  "nearRssiThreshold": [number]
}

0x8220 - Property Throttling¶

Type: bool

Name: property-throttling (1)

When set to true, property updates are only generated when the property value differs from the currently cached value. Since many device properties change state very infrequently, this can save a substantial amount of upstream traffic and reduce the load on the backend server/broker.

Note

When enabled, the property cache must be explicitly flushed to synchronize gateway property cache and backend property state.

Value	Description
0	Disabled
1	Enabled

0x8221 - RSSI Reporting¶

Type: bool

Name: rssi-reporting (1)

When set to false, all RSSI reporting is disabled. This can be useful to reduce upstream traffic from the gateway, but also limits tracking capability.

Value	Description
0	Disabled
1	Enabled

0x8222 - Measurement Reporting¶

Type: bool

Name: measurement-reporting (1)

When set to false, all measurement reporting is disabled. This can be useful to reduce upstream traffic from the gateway, when no measurements are needed.

Value	Description
0	Disabled
1	Enabled

0x8223 - Event Reporting¶

Type: bool

Name: event-reporting (1)

When set to false, all event reporting is disabled. This can be useful to reduce upstream traffic from the gateway, when no events are needed.

Note

This will also disable critical events, like Storage Mode Event.

Value	Description
0	Disabled
1	Enabled

0x8228 - Network Mode¶

Type: u8

Name: network-mode (9)

Value	Description
0	Scan
1	Power Saving
2	Power Saving Scan Hourly
3	Power Saving Scan Daily
4	Discovery

Scan

In Scan mode scanning is on permanently. This mode is required to interact with and continuously get data from Unconnected devices.

Power Saving

In Power Saving mode scanning is turned off when the network has been stable for 5 minutes. Scanning is turned on for 5 minutes if one or more devices are removed from the network (i.e. devices disconnect).

If a device disconnects, the parent extender will scan for reconnect advertisements to allow the child to reconnect. If the child is unable to reconnect in 20 seconds, the parent will give up and the child (and its children if any) will be removed from the network. This will trigger a full scan for the entire network for 5 minutes.

Power Saving mode is ideal for networks with battery powered extenders and connected sensors.

Note

This mode is not suited for systems where devices are moved in and out of the network range. If a device is moved out of the network range for more than 5 minutes, the network will turn off scanning and the device will not automatically join the network when it comes back into the network range. This can be handled by having the backend detect that devices expected to be in the network are missing and switch network-mode to Scan to get it back in.

Power Saving Scan Hourly

This works the same Power Saving, but a 5 minutes scan period is scheduled every hour; 00:00, 01:00, 02:00 etc. This gives devices that have disconnected from the network and failed to connect during the 5 minutes automatic scan period an opportunity to join the network again every hour.

Note

Added in gateway version 7.1.0.

Power Saving Scan Daily

This works the same Power Saving, but a 5 minutes scan period is scheduled at 00:00 UTC. This gives devices that have disconnected from the network and failed to connect during the 5 minutes automatic scan period an opportunity to join the network again every midnight UTC.

Note

Added in gateway version 7.1.0.

Discovery

Same as Scan, but allows for discovery of new devices to be provisioned/accessed.

Note

Added in gateway version 8.0.0 (network version 1.12).

0x8230 - General Advertisement Reporting¶

Name: general-advertisement-reporting (3)

This is used to configure reporting of BLE advertisements from non-Meshtech devices.

Offset	Type	Description
0	u8	Type. Set to 0 to disable.
1	u8	Priority. Valid range: 0 - 4
2	u8	Allow private MAC address. 0 = no, 1 = yes

Type	Description
0	Disabled
1	Generate RSSI

0x8250 - Log to Disk¶

Type: bool

Name: log-to-disk (3)

Set to enable logging to disk.

Warning

Use with caution. Keeping disk logging on for extended periods can cause flash wear.

0x8251 - Log Debug¶

Type: bool

Name: log-debug (7)

Enable debug level logging.

0x8252 - Log RX¶

Type: bool

Name: log-rx (7)

Enable RX logging.

Warning

Enabling RX logging will cause all data received from the BLE network to be written to the log. This can expose sensitive information to entities that have access to the log. Use with caution and typically for debugging purposes.

0x8253 - Log TX¶

Type: bool

Name: log-tx (7)

Enable TX logging.

Warning

Enabling TX logging will cause all data written to the BLE network to be written to the log. This can expose sensitive information to entities that have access to the log. Use with caution and typically for debugging purposes.

0x8254 - Log RX Encrypted¶

Type: bool

Name: log-rx-encrypted (10)

Enable RX Encrypted logging.

0x8255 - Log TX Encrypted¶

Type: bool

Name: log-tx-encrypted (10)

Enable TX Encrypted logging.

0x8260 - Temperature Measurement Reporting¶

Type: bool

Name: temperature-measurement-reporting (4)

Enable/disable temperature measurement reporting.

0x8261 - Pressure Measurement Reporting¶

Type: bool

Name: pressure-measurement-reporting (4)

Enable/disable pressure measurement reporting.

0x8262 - Humidity Measurement Reporting¶

Type: bool

Name: humidity-measurement-reporting (4)

Enable/disable humidity measurement reporting.

0x8263 - Light Intensity Measurement Reporting¶

Type: bool

Name: light-intensity-measurement-reporting (4)

Enable/disable light intensity measurement reporting.

0x8264 - Vibration Notification¶

Type: bool

Name: vibration-notification (7)

Enable/disable vibration feedback/notification for alarms.

0x8265 - Sound Notification¶

Type: bool

Name: sound-notification (7)

Enable/disable buzzer sound feedback/notification for alarms.

0x8266 - Notify¶

Type: u8

Name: notify (11)

Device dependent notification. The value is used to select notification type.

Value	Description
0	Default

0x8267 - PIR Motion Filter¶

Type: u8

Name: pir-motion-filter (11)

Value	Description
0	Disabled (default)
1	Filter type 1

0x8268 - RPM Configuration¶

Name: rpm-configuration (12)

Enabling RPM reporting will disable reporting of 0x8831 - Hall Effect Counter property

Offset	Type	Description
0	u8	Mode: Disabled (0), Enabled (1)
1	u16	Reporting interval in seconds (10s-600s)

{
  "mode": 1,
  "interval": 100
}

0x8269 - Alarm Mode¶

Type: u8

Name: alarm-mode (12)

Value	Description
0	Disabled
1	Default
2	Timestamped

0x826A - Measurement Reporting Interval¶

Type: u16

Name: measurement-reporting-interval (14)

Measurement reporting interval.

Unit is seconds.

0x8270 - Backfill¶

Type: bool

Name: backfill (14)

Note

Deprecated. Replaced by individual enables in 0x8382xx range.

Set to true to enable measurement backfill.