Integration of SCADA FUXA with Wiren Board controllers
This guide describes the deployment and configuration of the web-based FUXA visualization system for use with Wiren Board equipment via the MQTT protocol.
About SCADA FUXA
SCADA FUXA is a modern web-based SCADA/HMI platform for automation, process visualization, and the Internet of Things (IoT).
Depending on your task, you can install the FUXA server directly on a Wiren Board controller or deploy it on an external PC/server and connect to the controllers remotely.
The main way to exchange data with Wiren Board controllers is through the built-in MQTT broker. In addition to MQTT, FUXA supports Modbus RTU/TCP, OPC UA, BACnet, Siemens S7, and work with databases (SQLite, InfluxDB, etc.).
The main advantages of this system compared with other SCADA systems:
- Integration with many protocols, including MQTT, for working with Wiren Board controllers
- Open source
- Free of charge
- Ease of use: dashboards, logic, and interface settings are all created directly in the browser (there is no need to install heavy desktop editors).
Getting started with FUXA consists of the following steps:
- Install FUXA on the controller.
- Perform the initial environment setup and connect to the local MQTT broker.
- Learn how to add tags and subscribe to topics.
- Create the first interactive control panel (display the CPU temperature and configure a buzzer control button).
Installation with Docker
By default, the FUXA installation package is not included with the Wiren Board controller.
It is best to use Docker for installation because it provides service isolation.
To do this, you first need to install Docker on the controller — you can read about it here:
Then install and start FUXA on port 1881 with a single command:
# docker run -d -p 1881:1881 frangoteam/fuxa:latest
After that, the solution will be running and ready to use — you can proceed to the Running the configurator and setup stage.
Running the configurator and setup
Once the installation is complete, open the configurator to continue creating the control panel.
Logging in to the interface
To configure the system, open a browser and enter your controller's IP address with port 1881:
Switching to Editor mode
By default, the viewer mode opens. To start creating a project:
- In the lower-left corner, click the "three lines" icon (main menu).
- In the list that opens, select Editor.
- The editor view will then appear, where you need to find the configuration button in the form of a gear:
Entering Editor mode
Editor view (gear button)
Creating a data source (MQTT broker connection)
To allow FUXA to interact with Wiren Board devices, you need to add a connection to the controller's MQTT broker.
- In the settings window, select Connections.
- Click the "+" button at the bottom of the screen to add a new connection.
- From the available connection types, select Mqtt client.
List of available connections
Specify the connection parameters:
| Parameter | Value |
|---|---|
| Name | Any name (for example, MQTT WirenBoard) |
| Type | MQTTclient |
| Enabled | Enable it (switch to ON) |
| Address (mqtt://[server]:[port]) | mqtt://127.0.0.1/:1883 (if FUXA is running on the controller) |
Click OK. If everything is configured correctly, a green indicator will appear next to the connection name.
Adding tags (subscribing to MQTT topics)
To receive data from sensors, you need to configure tags linked to Wiren Board MQTT topics.
Click the attach icon (paperclip/pencil) next to the connection you created.
Tag button — "Paperclip"
Search button
Click "+" to add a tag.
Tag for subscribing to a topic
Topic setup: To specify a topic, you can:
- Enter the topic path manually in the format /devices/ID/controls/CONTROL.
- Or use the search function: click the magnifying glass icon (Search topics on broker) and select the required parameter from the list of found topics.
In the Name field, keep the automatically entered full topic path or enter a clear name (for example, Hall_Temp or Buzzer_enable) — this name will be used later only within FUXA.
Next, it is important to click Subscribe so that this topic is saved.
Tag for publishing to a topic
To publish to a topic, you need to create an entry of a different type by selecting "Publish", using /on topics, for example /devices/buzzer/controls/enabled/on.
Tag for writing
If you want to use a toggle, you must specify a mask; for example, for /devices/buzzer/controls/enabled/on you need to set the mask for bit 0.
Creating a SCADA panel
Now that the tags are configured, move to the central canvas in the editor to create the visual interface.
Step 1: Adding a CPU temperature indicator
Let's display the current controller CPU temperature on the panel:
- In the left panel (component library), select the Circular Gauge widget and add it to the canvas. Note that drag-and-drop may not work.
- Select the added component by clicking it with the mouse.
- In the right panel, open the properties and find the Variable/Tag section.
- From the list, select the previously created MQTT tag responsible for temperature (for example, subscribed to the topic
/devices/hwmon/controls/CPU Temperature). - If necessary, configure the minimum and maximum scale values there as well (for example, Min: 0, Max: 100).
Step 2: Adding a switch for the buzzer
Now let's add an element to control the controller's built-in buzzer:
- In the component library, select the Switch widget and drag it onto the canvas.
- Select the switch and open its properties.
- In the Variable/Tag section, select the tag you created for publishing (topic
/devices/buzzer/controls/enabled/on). - Find the Bitmask parameter in the component properties and make sure to set it to 0. This will allow the switch to correctly send binary commands (1 and 0) to the topic.
Click event configuration
Launching and testing
To test the setup, click the "triangle" icon (Launch) in the top panel of the editor. The system will switch to runtime mode. Check that the indicators display real data and that the buttons control the devices. For permanent operation, use the Home tab.
Opening a page by URL
You can configure automatic opening of a specific page (View) through the address bar:
Please note: the standard page name (MainView) does not work in links. It is recommended to rename the page in the editor to a simple name (for example, NewPage).
Additional interface settings
Buttons on the side and top panels
Global navigation is configured in the layout section:
Go to Edit Project -> Layout. Navigation Side Menu tab: here you add buttons, choose icons, and link target pages (View). For stationary screens, set Side Mode to Fixed so that the menu is always visible. Header Navigation Bar tab: here you configure the display of alarm notifications (Alarms).
Buttons on a page
For navigation inside the interface, you can use standard buttons from the component library:
In the button properties, select Event -> Click -> Open Page.
Optimization for tablets
To make the interface look appropriate on a wall-mounted tablet, use the browser's "Add to Home screen" feature or specialized software.
Fully Kiosk Browser (Android)
Recommended app for creating professional control panels:
Start URL: Specify the direct link to your main FUXA page.
Kiosk Mode: Enable it to lock the tablet's system buttons.
Motion Detection: Configure the screen to turn on via the camera when a person approaches.