Tags
Tags are declared in TOML files under a project's tags/ folder — any structure, loaded recursively. Each entry names a point, types it, binds it to a device address, and optionally opts into history.
A tag file.
# projects/press-line/tags/hydraulics.toml [[tags]] name = "HeadPressure" path = "press/hydraulics/HeadPressure" data_type = "f32" device = "press-plc" address = "DB2.DBD26" scan_group = "fast" description = "Hydraulic head pressure at the platen" eng_units = "psi" history = { enabled = true, deadband_mode = "absolute", deadband_value = 0.5 } [[tags]] name = "PumpRunning" path = "press/hydraulics/PumpRunning" data_type = "bool" device = "press-plc" address = "DB1.DBX0.0" scan_group = "normal"
Field reference.
Tag paths are per-project — two projects can both define plant/Temperature. Within one project a duplicate path (even across files) is rejected at publish.
Data types.
bool, i16, u16, i32, i64, f32, f64, string. Choose a type supported by the adapter's conversion rules. Supported conversions can widen or narrow values; unsupported combinations can produce null or bad readings. For example: a BACnet Binary object's present-value is an enumerated 0/1 on the wire, so declare it i16, not bool.
Address grammar by driver.
BACnet properties: present-value (pv), units, object-name, description, status-flags, reliability, out-of-service, priority-array, relinquish-default, event-state, object-identifier, device-type, location, object-list, object-type, vendor-identifier, vendor-name, protocol-services-supported, protocol-revision, property-list; numeric codes or property-<code> also work. Connection settings are on Devices & drivers.
Tags without a device.
Omit device and address and the gateway holds the value itself — useful for operator inputs, recipe staging, and inter-screen state. Memory tags are readable, writable, and historizable like any other tag.
[[tags]] name = "TargetPressure" path = "press/recipe/TargetPressure" data_type = "f32" eng_units = "psi"
Per-tag history.
With the historian feature on and a PostgreSQL connection configured (see Server configuration), add a history block to each tag you want recorded. Tags without that block are not recorded. Aggregation is computed at query time — there are no rollup jobs to configure.
[[tags]] name = "OvenTemperature" path = "oven/Temperature" data_type = "f64" device = "oven-plc" address = "DB6.DBD8" [tags.history] enabled = true sample_mode = "on_change" sample_rate_ms = 1000 # throttle: at most one sample per second deadband_mode = "absolute" deadband_value = 0.5