Modules
Add, configure, and manage Modbus RTU module instances in your workspaces.
What is a Module? §
A module is an instance of a physical Modbus RTU device placed inside a workspace. Think of it as the software representation of one hardware device on your RS485 bus.
Adding a Module §
-
Select the workspace
Click the workspace in the sidebar to make it active.
-
Click Add Module
Press
Aor click the button in the top toolbar. A modal opens and immediately scans the RS485 bus. -
Select from scan results
Modules that responded on the bus are listed by Slave ID and serial number. Check the ones you want to add. If the bus is offline, use the Manual entry form to add a module by Slave ID.
-
Enter a name
Give each selected module a recognizable name like "Pump Controller" or "HVAC Unit 2".
-
Click Add Selected
The modules appear in the grid, ready to connect.
The slave ID is set at power-up via hardware DIP switches ID2, ID3, ID4. ID 1 is the factory default (all switches ON).
| ID 2 | ID 3 | ID 4 | Slave ID |
|---|---|---|---|
| ON | ON | ON | 1 (default) |
| OFF | ON | ON | 2 |
| ON | OFF | ON | 3 |
| ON | ON | OFF | 4 |
| OFF | OFF | ON | 23 |
| ON | OFF | OFF | 34 |
| OFF | ON | OFF | 24 |
| OFF | OFF | OFF | 234 |
Module Card §
Each module appears as a card in the grid showing:
- Connection status (green dot = polling)
- Module name and slave ID
- Section cells — DI, DO, AI, AO, CFG, PWR, DEV (see Module Sections)
- Live values inside each section
Connecting & Disconnecting §
Click Connect on a module card to start polling. The card border lights up and values begin updating within seconds.
Click Disconnect to stop polling that module.
Editing Modules §
Administrators can edit module properties:
- Change the module name
- Change the slave ID (update DIP switches on hardware first)
- Delete the module (removes it from the workspace)
Hiding Sections §
Administrators can hide specific sections (e.g., CFG, DEV) from operators. Open the section detail panel, go to Settings, and toggle "Visible to operators".