History

Simon Stürz 930f8c780f Update license text and add SPDX identifier		2025-11-17 16:36:48 +01:00
..
translations	added temperature and humidity sensor	2021-04-13 21:56:31 +02:00
README.md	added temperature and humidity sensor	2021-04-13 21:56:31 +02:00
integrationpluginonewire.cpp	Update license text and add SPDX identifier	2025-11-17 16:36:48 +01:00
integrationpluginonewire.h	Update license text and add SPDX identifier	2025-11-17 16:36:48 +01:00
integrationpluginonewire.json	added temperature and humidity sensor	2021-04-13 21:56:31 +02:00
meta.json	More meta.json updating	2022-01-28 12:44:55 +01:00
onewire.png	added some more logos	2020-04-24 16:29:56 +02:00
onewire.pro	onewire: Add Qt6 support	2025-08-14 10:26:19 +02:00
owfs.cpp	Update license text and add SPDX identifier	2025-11-17 16:36:48 +01:00
owfs.h	Update license text and add SPDX identifier	2025-11-17 16:36:48 +01:00
w1.cpp	Update license text and add SPDX identifier	2025-11-17 16:36:48 +01:00
w1.h	Update license text and add SPDX identifier	2025-11-17 16:36:48 +01:00

README.md

One-Wire

This integration plugin allows to integrate one-wire devices like temperature sensors and switches.

Supported Things

OWFS Interface
- Gateway device
- Initializes OWFS
Temperature Sensors
- Family Code 10
  - DS18S20
  - DS1820
  - DS18S20-PAR
  - DS1920
- Family Code 22
  - DS1822
  - DS1822-PAR
- Family Code 28
  - DS18B20
  - DS18B20-PAR
  - DS18B20X
- Family Code 3B
  - DS1825
Temperature and Humidity Sensors
- Familiy Code 26 *DS2834
Switches
- Family Code 05
  - Single channel switch
  - DS2405
- Family Code 12
  - Dual channel switch
  - DS2406
  - DS2407
- Family Code 3A
  - Dual channel switch
  - DS2413
- Family Code 29
  - Eight channel switch
  - DS2408

Usage

OWFS Interface

First step is to setup the "One wire interface". During the device setup it is required to enter the OWFS init arguments. Default arguments are "--i2c=ALL:ALL", means OWFS is about to scan for one-wire bus masters on all I2C interfaces.

You can simulate one-wire device with following init argument: "--fake=10,22,28,05"

More about init arguments here: https://www.owfs.org

W1 Kernel Driver

Install the kernel driver w1. Raspberry Pi users can use rasp-config to enable 'one wire' which enables W1. There are not further steps necessary, temperature sensors will be discovered if the driver has been loaded successfully.

Requirements

The package “nymea-plugin-onewire” must be installed.

This plug-in uses "OWFS" the one-wire file system: https://owfs.org