Devices & drivers
Devices are declared in config/server.toml: a [[devices]] entry names the connection, picks a driver, and passes driver-specific settings in [devices.config]. Tags bind to a device by name. Seven drivers ship in the runtime.
Every device entry looks the same.
[[devices]] name = "press-plc" # unique — tags reference this name driver = "modbus" # sim | s7 | cip | modbus | opcua | mqtt | bacnet enabled = true # connect at startup (default true) [devices.config] # driver-specific keys — tables below host = "192.168.0.10"
How a tag names a point on each device — the address grammar — is covered per driver on Tags.
Simulated device
Generates read-only values without hardware. Tag addresses are patterns: Sine_Wave, Cosine_Wave, Triangle_Wave (f64), Square_Wave (bool), Sawtooth (i32), Random_Float (f64), Static_String (string). Use memory tags for writable gateway values.
[[devices]] name = "sim-plc" driver = "sim" [devices.config] update_rate_ms = 500
Modbus TCP
Polls coils, discrete inputs, and holding/input registers over Modbus TCP.
[[devices]] name = "modbus-io" driver = "modbus" [devices.config] host = "192.168.0.10" unit_id = 1 poll_rate_ms = 250
Addressing
HR100, HR100:f32, IR50:i16, C0, HR300:str8 — register prefix plus optional type suffix.
Siemens S7
Reads and writes S7 data blocks over ISO-on-TCP (port 102).
[[devices]] name = "s7-plc" driver = "s7" [devices.config] host = "192.168.0.1" rack = 0 slot = 1
Addressing
DB1.DBX0.0 (bit), DB2.DBD26 (f32/f64 at byte offset), DB8.DBB54,S20 (string).
EtherNet/IP (CIP)
Reads and writes controller tags by symbolic name — Allen-Bradley Logix-class controllers.
[[devices]] name = "line-plc" driver = "cip" [devices.config] host = "192.168.0.20" slot = 0
Addressing
Symbolic controller paths: Motor.Speed, Tank_Level, Program:MainProgram.Counter.
OPC UA
Polls and writes OPC UA server nodes. The integrated adapter uses security_mode = "none" and security_policy = "none"; it has no client certificate/key configuration for signed or encrypted sessions.
[[devices]] name = "press-opcua" driver = "opcua" [devices.config] endpoint_url = "opc.tcp://192.168.0.30:4840" security_policy = "none" security_mode = "none"
Addressing
NodeId strings: ns=2;s=Tank_Level or ns=0;i=2258.
MQTT
Subscribes to broker topics and maps payloads to tags. A tag's address is its topic; with the default json codec the payload is parsed as a JSON value matching the tag's data_type.
[[devices]] name = "broker" driver = "mqtt" [devices.config] url = "mqtt://192.168.0.5:1883" client_id = "thermite-gw-01" qos = 1
Addressing
The broker topic, e.g. plant/line1/temperature.
BACnet/IP
Reads and writes BACnet objects over BACnet/IP (UDP), addressing one controller directly by IP. Today the driver is unicast-to-a-known-IP: it does not run Who-Is discovery or register as a BBMD foreign device, so controllers behind a BACnet router (e.g. MS/TP segments) are not addressable through this adapter.
[[devices]] name = "ahu-1" driver = "bacnet" [devices.config] host = "192.168.1.50" poll_rate_ms = 1000 write_priority = 8
Addressing
AV,1 · AI,2:units · BV,3 — object type, instance, optional property (defaults to present-value).
Connection status and polling.
- Drivers expose connection status and tag quality. Polling adapters publish bad quality on failed reads. For MQTT, monitor broker connection state as well as the last tag update.
- S7, EtherNet/IP, Modbus, and BACnet use the device's poll_rate_ms. MQTT is event-driven and the simulator ticks at update_rate_ms. OPC UA additionally supports per-tag intervals through scan groups.
- Set enabled = false to keep a device configured but disconnected — useful while commissioning.