Device/DAU Management

Overview

A DAU (Data Acquisition Unit) is any device that captures data from the real-world and relays that data to Busroot in the form of signals or raw data. This could be an IoT sensor, a PLC or any other device on the shop floor.

In order for DAUs to communicate with the Busroot MQTT broker, they must use valid credentials consisting of a Device ID and Access Token.

The Device ID is made up of the account ID followed by a / and a unique value for that device.

MQTT Communication

When using these credentials with the MQTT broker, a username, password and client ID must be provided as follows:

MQTT Field	Value
Username	Device ID
Password	Access Token
Client ID	Device ID + / + [optional string]

After MQTT authentication, the device is connected but can only publish and subscribe to specific topics:

Busroot Signals Topic: busroot/v1/ + Device ID Raw Data Topic: busroot/v1/dau/ + Device ID

Data published to the Busroot Signals topic will be processed directly by Busroot according to the signals mentioned here.

Data published to the topic starting with busroot/v1/dau/ will not be processed by Busroot. The purpose of this topic is to allow raw data to be sent from the device and processed in a second stage (e.g. using Node-RED) which will then re-publish that data to the Busroot Signals topic.

Registering a New Device

The 'Add New' button will create a new device with a unique Device ID and Access Token.

Removing Access for a Device

When it is required that a device no longer be able to send data to Busroot, the device ID should be deleted from Busroot. This will cause that device to be immediately disconnected from the MQTT broker.