CBOR Reference

Raw Wirepas CBOR message specification for Thingsee PRESENCE — for customers operating their own gateways and cloud infrastructure

Overview

This section documents the raw CBOR-encoded messages transmitted between Thingsee PRESENCE and the Wirepas mesh network. Most customers do not need this — the Haltian IoT platform handles CBOR encoding/decoding automatically.

Communication Basics

  • Wirepas endpoint: 21/21
  • Encoding: CBOR (Concise Binary Object Representation)
  • MQTT topic: haltian-iot/wirepas/gw-event/received_data/{gateway-id}/sink1/{network-id}/21/21

Each message is identified by a tsmId (message structure ID). The gateway adds metadata fields (tsmTs, tsmGw) before forwarding to your backend.

For general CBOR encoding/decoding guidance, see CBOR-JSON Conversion Reference.

Pages in This Section

PageDescription
Uplink MessagesMessages sent from the sensor (measurements, diagnostics)
Downlink CommandsMessages sent to the sensor (configuration, queries)

Common Header Fields

All CBOR messages share these header fields:

JSON PropertyCBOR IndexDescription
tsmId1Message structure identifier
tsmEv2Event type (see below)
tsmTs3UTC timestamp in seconds (added by gateway)
tsmTuid4Device unique identifier
tsmGw5Gateway identifier (added by gateway)

Event Types

tsmEvNameDirectionDescription
7State changeUplinkOccupancy state transition
10TimedUplinkPeriodic report at configured interval
11StartupUplinkDevice boot-up / power-on
29ErrorUplinkCritical error report
30CommandDownlinkConfiguration command from cloud
31ResponseUplinkDevice response to command

Uplink Messages

Raw CBOR uplink messages from Thingsee PRESENCE — measurement data, system info, and diagnostics transmitted over Wirepas mesh

Downlink Commands

Raw CBOR downlink commands for Thingsee PRESENCE — configuration messages sent to the sensor over Wirepas mesh