{"id":15655037,"url":"https://github.com/thecode/ha-onewire-sysbus","last_synced_at":"2026-03-06T08:03:21.626Z","repository":{"id":37940386,"uuid":"496755553","full_name":"thecode/ha-onewire-sysbus","owner":"thecode","description":"Home Assistant 1-Wire via sysbus","archived":false,"fork":false,"pushed_at":"2025-04-01T06:11:05.000Z","size":267,"stargazers_count":28,"open_issues_count":3,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-15T21:17:21.867Z","etag":null,"topics":["1-wire","custom-component","hacktoberfest","home-assistant","homeassistant","raspberry-pi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thecode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://paypal.me/levyshay"]}},"created_at":"2022-05-26T19:59:35.000Z","updated_at":"2025-04-12T12:40:08.000Z","dependencies_parsed_at":"2023-09-23T20:35:29.534Z","dependency_job_id":"24fec7bd-77ca-4008-8397-819d13d737f2","html_url":"https://github.com/thecode/ha-onewire-sysbus","commit_stats":{"total_commits":243,"total_committers":7,"mean_commits":"34.714285714285715","dds":0.09053497942386834,"last_synced_commit":"73ad2755318f62c0cd3e0923e3dd99ce187a01c4"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecode%2Fha-onewire-sysbus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecode%2Fha-onewire-sysbus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecode%2Fha-onewire-sysbus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thecode%2Fha-onewire-sysbus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thecode","download_url":"https://codeload.github.com/thecode/ha-onewire-sysbus/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249153953,"owners_count":21221330,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["1-wire","custom-component","hacktoberfest","home-assistant","homeassistant","raspberry-pi"],"created_at":"2024-10-03T12:55:38.132Z","updated_at":"2026-03-06T08:03:16.572Z","avatar_url":"https://github.com/thecode.png","language":"Python","funding_links":["https://paypal.me/levyshay"],"categories":[],"sub_categories":[],"readme":"# Home Assistant 1-Wire via Sys Bus custom integration\n\n**This is a spin-off from the original Home Assistant integration, which was removed in Home Assistant Core version 2022.6.**\n\n**NOTE: This integration does not support connection via `owserver` [owfs 1-Wire file system](https://owfs.org/). For connection via `owserver`, use [Home Assistant 1-Wire integration](https://www.home-assistant.io/integrations/onewire/), both integrations can be used at the same time.**\n\nThe `onewire_sysbus` integration supports sensors which that using the One wire (1-wire) bus for communication.\n\nEvery 1-wire device has a (globally) unique ID that identifies the device on the bus. The first two digits identify a device family and the last 14 digits are a globally unique number given to it during manufacturing.\n\nDifferent families have different functionality and can measure different quantities.\n\nEach 1-wire component data sheet describes the different properties the component provides.\n\n## Installation\n\n### HACS\n\nThe recommend way to install `onewire_sysbus` is through [HACS](https://hacs.xyz/).\nAfter installation restart Home Assistant and add the integration:\nNavigate to **Settings** --\u003e **Devices \u0026 Services** --\u003e **ADD INTEGRATION** and select the `1-Wire SysBus` integration.\n\n### Manual installation\n\nCopy the `onewire_sysbus` folder and all of its contents into your Home Assistant's `custom_components` folder. This folder is usually inside your `/config` folder. If you are running Hass.io, use SAMBA to copy the folder over. You may need to create the `custom_components` folder and then copy the `onewire_sysbus` folder and all of its contents into it.\nAfter installation restart Home Assistant and add the integration:\nNavigate to **Settings** --\u003e **Devices \u0026 Services** --\u003e **ADD INTEGRATION** and select the `1-Wire SysBus` integration.\n\n### Supported sensors\n\n| Family | Device           | Physical Quantity  |\n| -------|:-----|:-----|\n| 10     | [DS18S20](https://www.maximintegrated.com/en/products/sensors/DS18S20.html)  | Temperature                     |\n| 22     | [DS1822](https://datasheets.maximintegrated.com/en/ds/DS1822.pdf)            | Temperature                     |\n| 28     | [DS18B20](https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf)          | Temperature                     |\n| 3B     | [DS1825](https://datasheets.maximintegrated.com/en/ds/DS1825.pdf)            | Temperature                     |\n| 42     | [DS28EA00](https://datasheets.maximintegrated.com/en/ds/DS28EA00.pdf)        | Temperature                     |\n\n## Interfacing with the 1-wire bus\n\nThe 1-Wire bus can be connected directly to the IO pins of Raspberry Pi or by using a dedicated interface adapter, for example\n[DS9490R](https://datasheets.maximintegrated.com/en/ds/DS9490-DS9490R.pdf) or adapters based on [DS2482-100](https://datasheets.maximintegrated.com/en/ds/DS2482-100.pdf) that can be directly attached to the IO pins on the Raspberry Pi.\n\n### Raspberry Pi set up\n\nIn order to setup 1-Wire support on Raspberry Pi, you'll need to edit `/boot/config.txt`. This file can not be edited through ssh. You have to put your SD card to a PC, and edit the file directly.\nTo edit `/boot/config.txt` on the Home Assistant Operating System, use [this documentation](https://developers.home-assistant.io/docs/operating-system/debugging.html) to enable SSH and edit `/mnt/boot/config.txt` via `vi`.\n\nIf you use an external pull-up resistor and the default GPIO 4 for the data line, add the following line:\n\n```txt\ndtoverlay=w1-gpio\n```\n\nIf you don't want to use an external resistor, you can use a built-in one using the following line:\n\n```txt\ndtoverlay=w1-gpio-pullup\n```\n\nIt is also possible to use a different GPIO pin like this to change it to pin 15:\n\n```txt\ndtoverlay=w1-gpio-pullup,gpiopin=15\n```\n\nFurthermore, it is also possible to have multiple GPIOs as one-wire data channel by adding multiple lines like this:\n\n```txt\ndtoverlay=w1-gpio-pullup,gpiopin=15\ndtoverlay=w1-gpio-pullup,gpiopin=16\n```\n\nYou can read about further parameters in this documentation: [Raspberry Pi Tutorial Series: 1-Wire DS18B20 Sensor](https://www.waveshare.com/wiki/Raspberry_Pi_Tutorial_Series:_1-Wire_DS18B20_Sensor#Enable_1-Wire).\n\nWhen using the GPIO pins on Raspberry Pi directly as a 1-wire bus, the description above uses two kernel modules. `1w_gpio`, that implements the 1-wire protocol, and `1w_therm`, that understands the DS18B20 (family 28) components inner structure and reports temperature.\nThere is no support for other device types (families) and hence this onewire platform only supports temperature measurements from family 28 devices.\n\n### Raspberry Pi checking connected devices via ssh\n\nIf you set up ssh, you can check the connected one-wire devices in the following folder: /sys/bus/w1/devices\nThe device IDs begin with `28-`.\n\n### Entities\n\nUpon startup of the platform, the 1-wire bus is searched for available 1-wire devices creates entities based on the sensor unique id:\n\n`sensor.28.FF5C68521604_temperature`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecode%2Fha-onewire-sysbus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecode%2Fha-onewire-sysbus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecode%2Fha-onewire-sysbus/lists"}