Compulab IOT-GATE-IMX8PLUS 2031

Note

For most deployments, we recommend using CTHINGS.CO Edge IoT Gateway XS 2032. It offers better range and a smaller form factor at a lower cost.

Description

Compulab IOT-GATE-IMX8PLUS 2031 is a gateway host. To work as a gateway for the Meshtech BLE network it needs to be paired with a USB BLE adapter, for example a Raytac MDBT50Q-RX 0040.

This hardware is sourced from Compulab. See Compulab IOT-GATE-IMX8PLUS for hardware details.

Configuration and monitoring of the gateway is available through Meshtech Device Management Portal.

  • Firmware Model Number: 0x2031

  • Downlinks: Up to 18

Normal Operation Procedure

Start by inserting a Raytac MDBT50Q-RX 0040 into the USB port. Use the USB port on the back, furthest toward the edge:

Make sure Raytac MDBT50Q-RX 0040 is not already configured. If you are unsure, you can always perform a factory reset of Raytac MDBT50Q-RX 0040 first. Apply power (PoE support in ETH2) by PoE or 12V power plug. Device need to get IP/network settings by DHCP on the ETH2 ethernet port. If properly configured and able to reach the internet (MQTT with TLS port 8883, and DNS query) it will provision itself towards iot.meshtech.no. There you can log in, claim, activate and configure it. Raytac MDBT50Q-RX 0040 BLE MAC address will be used as gateway’s ID. Use gateway ID or Compulab IOT-GATE-IMX8PLUS serial number for claiming.

LED Indication

There are two LEDs on the front side of the device; LED 1 and LED 2.

Name

Pattern

Description

Notes

LED 2

Blink red two times at the end of every second

Device is installing upgrade. Avoid cutting power while it is blinking if possible.

Added in version 7.1.0

LED 1

Off

Gateway host is not in contact with BLE interface, not ready or not running.

Added in version 9.0.0

LED 1

Blink green two times at the end of every second

Gateway is running and in contact with BLE interface but no management connection established.

Added in version 9.0.0

LED 1

Constant green light

Gateway is running and connected to device management.

Added in version 9.0.0. Changed in version 9.2.0 to show management connection status instead of BLE activated state.

Note

After system upgrade LED 1 will be off while BLE interface is upgrading. This is normal and can take up to a few minutes.

Properties

Property

Reported

Default Value

From Version

0x8000 - Model Number

Yes

-

0x8001 - Firmware Version

Yes

-

0x8002 - Hardware Version

Yes

-

0x8003 - MAC Address

No

-

0x8005 - Production Info Extended

No

-

0x8007 - Variant

Yes

-

0x8008 - Public Key

No

-

0x8009 - Host Public Key

No

-

0x8010 - Activated

No

-

0x8011 - Device Management Connected

Yes

-

9.2.0

0x8012 - Device Management Enabled

Yes

0x01

9.4.0

0x800A - Provision

No

-

8.0.0

0x800B - Network ID

Yes

0x0000000000

8.0.0

0x800C - Network Fingerprint

No

-

8.0.0

0x800D - Provision Legacy

No

-

8.0.0

0x8020 - Power Source

Yes

-

0x8030 - Add Root Certificate

No

-

8.0.0

0x8031 - Remove Root Certificate

No

-

8.0.0

0x8032 - Root Certificates

No

[ ]

8.0.0

0x8033 - Root Certificate Fingerprints

No

[ ]

8.0.0

0x8101 - Uptime

No

-

0x8102 - Reset Cause

No

-

9.5.0

0x8104 - Time

No

-

8.0.0

0x8106 - CPU Temperature

No

-

9.4.0

0x8110 - Device Mode

Yes

0x02

0x8120 - Firmware Update State

Yes

0x8121 - Start Firmware Update

-

0x8122 - Firmware Update Control

-

0x8124 - Start Firmware Broadcast

-

0x8125 - Firmware Broadcast State

Yes

0x8126 - Firmware Broadcast Control

-

0x8201 - Debug

No

0x00000000

0x8211 - RSSI Throttling Limit

Yes

0x00

0x8212 - Downlink Configuration 2

Yes

0x03000112

0x8220 - Property Throttling

Yes

0x00

0x8221 - RSSI Reporting

Yes

0x01 (true)

0x8222 - Measurement Reporting

Yes

0x01 (true)

0x8223 - Event Reporting

Yes

0x01 (true)

0x8228 - Network Mode

Yes

0x00

0x8230 - General Advertisement Reporting

No

0x000000

0x8250 - Log to Disk

Yes

0x00

0x8251 - Log Debug

Yes

0x00

0x8252 - Log RX

Yes

0x00

0x8253 - Log TX

Yes

0x00

0x8254 - Log RX Encrypted

Yes

0x00

0x8255 - Log TX Encrypted

Yes

0x00

0x8300 - Soft Reset

-

-

0x8301 - Factory Reset

-

-

0x8302 - Request Property Reporting

-

-

0x8304 - Start Downstream Throughput Test

-

-

0x8305 - Throughput Test Packet Counter

No

0x00000000

0x830A - Run Uplink Quality Tests

-

-

9.5.0

0x8311 - Shutdown

-

-

9.0.0

0x8320 - Destroy Network Below

-

-

0x8321 - Destroy Network Below Child

-

-

0x8322 - Network Tree

No

-

0x8330 - Flush Property Cache

-

0x8400 - Performance Counter Reporting Interval

Yes

0x0000

0x8401 - Performance Counter Reporting Priority

Yes

0x02

0x8410 - Upstream Packets Sent

No

0x00000000

0x8411 - Upstream Packets Lost

No

0x00000000

0x8412 - Downstream Packets Sent

No

0x00000000

0x8413 - Downstream Packets Lost

No

0x00000000

0x8414 - Advertisement Counter

No

NULL

9.5.0

0x8850 - EnOcean Config (BETA)

Yes

0x0002

0x8860 - Salto Config

No

NULL

8.0.0

0x8865 - Salto Sync

-

-

9.5.0

0x9000 - Scan Window

Yes

0x18 (24 %)

0x9002 - Network Lock

Yes

0x00 (0)

0x9020 - Offer RSSI Threshold

Yes

0xA6 (-90)

0x9817 - Skyresponse Config

No

NULL

9.4.0

0xFF00 - Scan Mode

-

-

Note

Scan Window range is 5 - 95 %. It is highly recommended to not increase scan-window above 24 % (default). Increases beyond 24 % can negatively affect throughput.

Note

After performing factory-reset (by writing 0x8301 - Factory Reset command property) it is necessary to “Clear token” in Device Management before gateway can provision itself if you use same USB BLE adapter. You will also need to activate and send required configuration (typically backend.json) to use it again.

Note

Performing factory reset of a paired Raytac MDBT50Q-RX 0040 (by pressing button while applying power, then additional button press for 5+sec) will also cause host to factory reset.

Measurements

Measurement

0x8410 - Upstream Packets Sent

0x8411 - Upstream Packets Lost

0x8412 - Downstream Packets Sent

0x8413 - Downstream Packets Lost

Events

Event

From Version

0x8102 - Reset Cause

9.5.0

Variants

Product Name

Variant

Description

Compulab IOT-GATE-IMX8PLUS 2031-01

0x01

Ethernet

Root Certificates Management

Additional root certificates (in PEM format) can be added using 0x8030 - Add Root Certificate or removed using 0x8031 - Remove Root Certificate.
The current set of additional root certificates can be read using 0x8032 - Root Certificates and 0x8033 - Root Certificate Fingerprints.

Root Certificates are needed for accessing HTTPS endpoints that present a certificate not signed by an official trusted certificate authority (CA).

History

Version

Description

9.2.0

0x8861 - Salto Endpoint (BETA) removed

9.1.0

0x8862 - Salto Rssi Threshold (BETA) removed

9.1.0

0x8863 - Salto Office Mode Rssi Threshold (BETA) removed

9.1.0

0x8864 - Salto Office Mode Rssi Hysteresis (BETA) removed

Release Notes

Licenses

Component

License(s)

MQTTnet

MIT

Newtonsoft.Json

MIT

protobuf-net

Apache-2.0

.NET

MIT, Apache-2.0

poky

MIT, GPLv2

meta-mender

Apache-2.0

meta-openembedded

MIT

arping

GPLv2