CTHINGS.CO Edge IoT Gateway XS 2032

Description

CTHINGS.CO Edge IoT Gateway XS 2032 is a gateway for the Meshtech BLE network. It contains the CTHINGS.CO nRF52840 connectivity card.

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

  • Firmware Model Number: 0x2032

  • Downlinks: Up to 18

Normal Operation Procedure

Power up the gateway (PoE or 12-24VDC). Device need to get IP/network settings by DHCP on the 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. If it is the first time powering up gateway, wait for LED A to light Green before claiming it. BLE MAC address will be used as gateway’s ID. Use gateway ID or CTHINGS.CO serial number (SN) for claiming.

LED Indication

There are two LEDs on the device. One system LED ON blink blue to indicate system is running, amber when shutdown. The other LED A is configured like this:

Name

Pattern

Description

Notes

A

Blink red two times at the end of every second

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

A

No green LED

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

A

Blink green two times at the end of every second

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

A

Constant green light

Gateway is running and connected to device management.

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

Note

After system upgrade LED A 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

-

0x800B - Network ID

Yes

0x0000000000

0x800C - Network Fingerprint

No

-

0x800D - Provision Legacy

No

-

0x8020 - Power Source

Yes

-

0x8030 - Add Root Certificate

No

-

0x8031 - Remove Root Certificate

No

-

0x8032 - Root Certificates

No

[ ]

0x8033 - Root Certificate Fingerprints

No

[ ]

0x8101 - Uptime

No

-

0x8102 - Reset Cause

No

-

9.5.0

0x8104 - Time

No

-

0x8106 - CPU Temperature

Yes

-

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

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

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 % will negatively affect throughput from extenders or devices connected (connected mode, or temporarily connected).

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. You will also need to activate and send required configuration (typically backend.json) to use it again.

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

CTHINGS.CO Edge IoT Gateway XS 2032

0x00

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

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-openembedded

MIT

arping

GPLv2