The IO driver provides access to the physical inputs and outputs of the Weble gateway hardware. It exposes digital inputs, digital outputs, analog inputs, analog outputs, LEDs, and 1-Wire temperature sensors as routable gateway addresses.
All IO addresses are automatically discovered from the hardware — no manual address insertion is needed. The driver detects the available IO points and creates the corresponding addresses. The driver adapts automatically to the underlying hardware platform.
¶ 1. Getting started
¶ 1.1 Gateway configuration
Create a new gateway and select the WBox IO driver. Once started, the driver automatically detects all available IO points on the gateway hardware and creates the addresses.
Note: The IO driver is not available on Windows.
¶ 1.2 IO address types
After startup, the following address types are automatically created depending on the hardware:
| Prefix | Type | Description | Writable |
|---|---|---|---|
%DI<n> |
Digital Input | Physical digital input (0 or 1). | No |
%DO<n> |
Digital Output | Relay or digital output (0 or 1). | Yes |
%AI<n> |
Analog Input | Analog input (voltage 0-10V or current 0-20mA). | No |
%AO<n> |
Analog Output | Analog output (voltage 0-10V, current 0-20mA, or resistance 0-2kΩ). | Yes |
%LED<n> |
LED | On-board LED indicator (0 or 1). | Yes |
%TEMP<n> |
Temperature | 1-Wire temperature sensor (°C). | No |
¶ 1.3 Using IO with routes
IO addresses are routable like any other protocol address. Typical use cases:
- Read a digital input → route to BACnet or MQTT to expose the input status to a BMS or cloud.
- Control a relay → write to a
%DOaddress from a route (e.g. triggered by a Modbus value or a Cron schedule). - Log temperature → route a
%TEMP1-Wire sensor to CSV for historical logging. - LED indicator → route an alarm condition to a
%LEDaddress to visually indicate a status on the gateway.
¶ 2. Gateway parameters
| Label | JSON Key | Description |
|---|---|---|
| Name | name | A descriptive name for this IO gateway instance. |
| Cluster ID | cluster | Cluster identifier. Use 0 for single-gateway setups. |
| Description | description | Optional description. |
¶ 3. Addresses
¶ 3.1 Address format
IO addresses use a prefix indicating the IO type followed by the channel number:
%DI1,%DI2, ... — digital inputs%DO1,%DO2, ... — digital outputs / relays%AI1,%AI2, ... — analog inputs%AO1,%AO2, ... — analog outputs%LED1,%LED2, ... — LEDs%TEMP1,%TEMP2, ... — 1-Wire temperature sensors
¶ Sub-addresses
Some IO points have configurable sub-addresses:
| Sub-address | Applies to | Description |
|---|---|---|
<address>/mode |
AI, AO | Measurement mode. For analog inputs: Voltage 0-10V or Current 0-20mA. For analog outputs: Voltage 0-10V, Current 0-20mA, or Resistance 0-2kΩ. |
<address>/debounce |
DI | Debounce time for digital inputs (in 100µs units). Filters out rapid switching noise. |
<address>/trigger |
DI | Enable/disable edge trigger for digital inputs. |
¶ 3.2 Address parameters
| Label | JSON Key | Description |
|---|---|---|
| Description | description | Optional description (auto-generated with board and channel info). |
| Log | log | Logging mode: never, on update, always, or a duration in milliseconds. |
Additional metadata is shown in the grid:
| Column | Description |
|---|---|
| Extension | Extension board identifier (for expandable hardware). |
| Device | Device type (di, do, ai, ao, led, temp). |
| Circuit | Circuit/channel identifier on the board. |
¶ 3.3 Writing values
| Address type | Write behavior |
|---|---|
%DO<n> |
Write 1 to activate the relay/output, 0 to deactivate. |
%AO<n> |
Write a numeric value (0-10 for voltage mode). |
%LED<n> |
Write 1 to turn on, 0 to turn off. |
%DI<n> |
Read-only — cannot be written. |
%AI<n> |
Read-only — cannot be written. |
%TEMP<n> |
Read-only — cannot be written. |
¶ 3.4 Address properties
| Property | Inputs (DI, AI, TEMP) | Outputs (DO, AO, LED) |
|---|---|---|
| Readable | No (values are pushed by the hardware) | No |
| Writable | No | Yes |
| Routable | Yes | Yes |
| Loggable | Yes | Yes |
| Auto-creation | Yes — all IO points are automatically discovered |