Devices

Context:

Devices are the IoT units that send data to Busroot over MQTT. Each device has a system-generated Device ID and Access Token which it uses to authenticate with the Busroot MQTT broker.

Importance:

Credentials can only be generated by Busroot - they cannot be chosen or set by hand. A device must be registered here before it is able to connect and publish data.

Managing Devices

The Devices list shows the Device ID, Type, Description and Created At date for every registered device.

Adding a Device

The Add New button creates a new device with a unique Device ID and Access Token. The Device ID is made up of the account ID, followed by a /, followed by a unique value for that device.

Viewing Credentials

Selecting View on a device shows its Device ID and Access Token. These are the values that must be configured on the device itself - see MQTT for how they are used to connect.

Type and Description

Selecting Edit allows a Type and a Description to be set. The Type defaults to Unknown and can be set to the correct device type after the device has been provisioned. The Description is free text, useful for recording where the device is installed.

Removing a Device

When a device should no longer be able to send data to Busroot, Delete it from this page. Its credentials will no longer authenticate, so the device cannot reconnect to the MQTT broker.