oBIX (Open Building Information Exchange) is a REST-based protocol for building automation systems. It provides a standardized way to access building data via HTTP/XML, making it interoperable with web technologies. oBIX is used by several building automation vendors including Tridium Niagara, Honeywell, and Siemens.
The Weble universal gateway oBIX driver acts as an oBIX client that connects to an oBIX server via HTTP to read and write building automation data points.
The driver supports:
Create a new gateway and select the Obix driver. Configure:
http://192.168.1.100).obix).Once connected, addresses can be manually created or discovered by browsing the oBIX topology.
| Label | JSON Key | Description |
|---|---|---|
| Name | name | A descriptive name. |
| Cluster ID | cluster | Cluster identifier. |
| Description | description | Optional description. |
| Username | username | oBIX server username. |
| Password | password | oBIX server password. |
| Host | host | oBIX server URL (e.g. http://192.168.1.100). |
| Servlet name | servletName | oBIX servlet path. Default: obix. The full URL is built as <host>/<servletName>/.... |
| Port | port | Optional port override. Leave empty to use the port from the host URL. |
| Parallel queries | parallelQueries | Number of simultaneous HTTP requests. Default: 10. |
| Default Polling | defaultPolling | Default polling interval in milliseconds for all addresses. 0 = no polling. |
| Topology refresh | refreshInterval | Interval in milliseconds for automatic topology refresh. 0 = disabled. |
| ASCII Path | asciiPath | If enabled (default), encodes address paths as ASCII for compatibility. |
Addresses use the prefix %obix: followed by the oBIX object path:
%obix:Building/Floor1/Room101/Temperature — a temperature point%obix:Building/Floor1/Room101/Setpoint — a writable setpointAddresses are displayed in a tree structure based on the / path separator.
| Label | JSON Key | Description |
|---|---|---|
| Name | name | The oBIX address path. |
| Polling | polling | Per-address polling interval in milliseconds. Overrides the gateway default. |
| Description | description | Optional description. |
| Log | log | Logging mode. |
| Tab | Description |
|---|---|
| Addresses | Building automation data points. |
| Driver | Driver system information and status. |
Writable addresses have json.writable = true. The value editor adapts automatically to the data type:
| Property | Value |
|---|---|
| Readable | Yes (for top-level addresses) |
| Writable | Depends on the oBIX object (json.writable) |
| Routable | Yes |
| Loggable | Yes |
oBIX addresses can be dragged onto a BACnet gateway grid to automatically create routes. The driver automatically maps oBIX metadata (unit, description, object name) to the corresponding BACnet object properties.