Skip to content

Latest commit

 

History

History
89 lines (65 loc) · 2.29 KB

DOCS.md

File metadata and controls

89 lines (65 loc) · 2.29 KB

owserver

The addon provides owserver enabling access to 1-Wire sensors over serial, i2c, usb, w1, pbm, ha7net fake devices.

Configuration

Note: Remember to restart the add-on whenever configuration change.

Example add-on configurations:

devices:
  - device_type: serial
    device: /dev/ttyUSB0
owhttpd: bool
temperature_scale: Celsius
debug: false
devices:
  - device_type: ha7net
    ha7net_server: 192.168.50.1
  - device_type: ha7net
    ha7net_server: 192.168.50.2
owhttpd: bool
temperature_scale: Celsius
debug: false

Note, these are just example configurations, don't copy, please create your own.

Option: devices

This option allows you to specify list of 1-Wire devices.

Sub-option: device_type

Specify the owserver device type from the following options:

  • serial
  • passive (passive serial device)
  • i2c
  • usb
  • pbm (ElabNET's Professioinal Bumster PBM-01)
  • ha7net
  • w1 (direct access via GPIO on RasPi)
  • fake (random simulated device)

Sub-option: device

Specify the device. This is mandatory option only for following device_type:

  • serial
  • passive
  • i2c
  • pbm

Sub-option: ha7net_server

Specify the address of the ha7net device. This is mandatory option only for following device_type:

  • ha7net

Option: owhttpd

Enable to start the embedded owhttpd server (Default true). owhttpd server is exposed via Ingress (Open Web UI)

Option: temperature_scale

Specify temperature scale used by owserver from the options below:

  • Celsius default
  • Fahrenheit
  • Kelvin
  • Rankine

Option: debug

Specify debug mode for owserver. Please note that once DEBUG mode is enabled you will not be able to connect to the owserver. Use debug mode only to troubleshoot issues with 1-Wire connectivity

Home Assistant integration

  1. Configure and start addon. With default configuration addon starts with fake (mocked) devices.
  2. Add to Home Assistant through the Integrations. Go to Integrations, Add Integration, Choose 1-Wire
    • Host: provide add-on's hostname (from add-on details page)
    • Port: 4304 (default)
  3. ... or use Home Asistant auto discovery (since 2025.2.0). Go to Integrations, find discovered addon and Add it.
  4. That's it. On the integrations page wou will find 1-Wire integration with 1-Wire devices.