Cloud live (MQTT JSON) data [Alpha]

Real-time data (position data, tag/anchor statuses, sensor data, etc.) can be received over MQTT (Message Queuing Telemetry Transport, pub/sub), either direct over TCP or over Websocket.

1. Connection protocol

You can publish data to your own Mosquitto (MQTT) broker by configuring the Desktop application:

2. Data Format

Each message has the following base format:

{
  "time": "", // Time: GPS time of anchor if available, otherwise PC time
  "meta": { // Meta information
    "data_source": "live",
    ...
  },
  "value": { // Value: message data
    ...
  }
}

These are the message types and their associated topics:

Sort by
Type Tag-data	Description Tag sensor data. Can contain: positions, distances, speed, acceleration, IMU, etc (as configured in the software and available from the hardware)	Topic data/devices/tag-data/frame
Type Tag-data-int	Description Slower (interval) tag data	Topic data/devices/tag-data/int
Type Tag-list	Description List of all tags	Topic data/devices/tag-list
Type Anchor-list	Description List of all anchors	Topic data/devices/anchor-list
Type Statuses	Description Device statuses: battery voltage, firmware version, etc.	Topic data/devices/statuses
Type Fast	Description List of tags (IDs) with a fast slot (detected fast right now)	Topic data/devices/fast
Type Events	Description Events (as activated)	Topic data/events
Type Race	Description Race data (standing, timing)	Topic data/sports/race/frame
Type Race-int	Description Slower (interval) race data	Topic data/sports/race/int
Type Start	Description Start signal - from hw (impulse) or sw (button or algo)	Topic data/signal/start
Type Zones	Description Zone presence per zone	Topic data/zones
Type Params	Description Data parameters	Topic data/params

Example tag-data message:

{
  "time":"2022-02-26T10:07:19.128Z",
  "meta":{
    "msg_type":"tag-data",
    "data_source":"replay-cx"
  },
  "value": {
      "frame": 658885,
      "tags": {
        "2012": {
            "pos": {"x": 9356,"y": 23872,"z": 0},
            "speed": {
              "value": 4.61,
              "dir": {"x": 0.94174,"y": 0.33634}
            }
          },
        "2014": {
            "pos":{"x": 12437,"y": 23806,"z": 0},
            "speed": {
              "value": 5.07,
              "dir":{"x": 0.89907,"y": -0.43781}
            }
          },
        ...
      }
  }

The messages received can be inspected interactively in our app: