This guide explains how to connect the Delta Controls O3 Edge Sensor Hub to Blocks. It is assumed that the O3 Edge Sensor Hub has been set up and that the internal MQTT broker has been enabled according to the official instructions (found here).

You will need the ConfigurableMQTT driver available in the PIXILAB blocks-script GitHub repo, as well as the JSON configuration file for the O3 Edge. See this wiki page for information on installing drivers. It is assumed that you are running a Mosquitto MQTT broker, such as the one pre-installed on our Linux server image, that has been configured according to this guide.

The O3 Edge currently only supports publishing values to its internal MQTT broker. In this guide, we will configure the Mosquitto broker (e.g., the one included on our Linux server image) to bridge MQTT topics from the O3's internal broker. This will then let us access the O3 through the regular Mosquitto broker.

1. Open the Mosquitto configuration file (e.g., "/etc/mosquitto/conf.d/pixi.conf") in a text editor.
2. Add the following lines:

   connection CONNECTIONNAME
   address IPADDRESS:PORT
   topic # both 0 TOPICBASE/ ""
   cleansession false
   notifications false
   remote_clientid CLIENTID
   remote_password O3EDGEPASSWORD
   remote_username O3EDGEUSER
   start_type automatic
   try_private true

3. Replace CONNECTIONNAME, TOPICBASE and CLIENTID with strings of your choice. The values must be unique for each O3 Edge device, if connecting multiple devices.
4. Replace IPADDRESS and PORT with the ip address and port number of the internal MQTT broker of the O3 Edge.
5. Replace O3EDGEUSER and O3EDGEPASSWORD with the username and password for the internal MQTT broker of the O3 Edge.
6. Save the file and close the editor. Restart mosquitto (e.g., "sudo systemctl restart mosquitto").

Additional configuration may be required when using encrypted connections. This is not covered in this guide.

In case you need it, the MQTT API documentation for the O3 Edge can be found here.

1. Add a new MQTT device on the Manage page according to the instructions in the Blocks manual, giving the device a name.
2. Set the Topic Base to the TOPICBASE chosen in step 3 under Configure broker.
3. Select the ConfigurableMQTT driver.
4. Paste the configuration for the O3 Edge in the Custom Options field.
5. The O3 Edge has now been added to Blocks.

To connect multiple O3 Edge devices, follow the steps above for each device. There must be one entry per device in Mosquitto's configuration file, and the CONNECTIONNAME, TOPICBASE and CLIENTID must be unique for each device.