This repository provides a guide on how to run EMQX, a MQTT broker, Neuron from EMQX and a MQTT random data generator with balena.
The combination of EMQX and balena.io allows to enable MQTT messaging in IoT applications deployed on edge devices such as Raspberry Pi or Intel NUCs.
This project is for educational purposes only. Do not deploy it into your premises without understanding what you are doing. USE THE SOFTWARE AT YOUR OWN RISK. THE AUTHORS AND ALL AFFILIATES ASSUME NO RESPONSIBILITY FOR YOUR SECURITY.
We strongly recommend you to have some coding and networking knowledge. Do not hesitate to read the source code and understand the mechanism of this project or contact the authors.
- Intel devices
- USB drive
- Power supply and (optionally) ethernet cable
- A balenaCloud account (sign up here)
- balenaEtcher
You have two options here. You can deploy this project to a new balenaCloud application in one click using the button below:
Or, you can create an application in your balenaCloud dashboard and balena push this code to it the traditional way with the balena CLI.
EMQX is a modern MQTT broker that not only accepts MQTT data but others such as Websockets, QUIC or LWM2M. Once the device has deployed the application successfully (EMQX, Neuron and the MQTT random data generator services) you should be able to see the balenaCloud running with these services.
To access to the EMQX broker type your local IP address on a browser. The EMQX is mapped in the port 80. Alternatively you can use the Public Device URL to access to the EMQX dashboard.
To log in use the credentials admin and public.
Once logged in, you will see something similar, with 3 MQTT connections sending data to the EMQX MQTT broker. If there are not MQTT connections and you see on the balenaCloud Logs errors from the data-generator service, restart this service.
Neuron is a service that gets industrial data from PLCs, sensors and others. Neuron is able to collect data from Modbus TCP, Modbus Serial, OPC UA and more and it sends the collected data to northbound connections such as the MQTT broker that we have at the emqx service or to another MQTT broker. In this case, the main idea is to use the emqx MQTT broker as a single source of truth in the edge, so any data collected from Modbus TCP. DISCLAIMER the free version of Neuron only allows to collect data from Modbus TCP.
To log in use the credentials admin and 0000. In case the interface appears in Chinese, log in and go to the last option of the menu and the last option to change the language on the dropdown form.
And then start defining the Southbound devices.
And the Northbound Apps to the emqx service.
From here it will be great to see your innovation.
Contributions to this project are welcome! If you encounter any issues, have suggestions, or would like to improve the integration guide, please submit a pull request or open an issue on this repository and write to the balena forums.