Czujki 1-Wire
Jak podłączyć i skonfigurować czujniki temperatury 1-Wire (DS18B20) w boneIO Black.
Sterownik boneIO Black obsługuje czujniki temperatury Dallas DS18B20 przez protokół 1-Wire. Czujniki są automatycznie wykrywane przez kernel Linuxa.
Czujniki 1-Wire są automatycznie wykrywane - po podłączeniu czujnika wystarczy odświeżyć listę w interfejsie webUI, aby zobaczyć dostępne adresy.
Lista czujników 1-Wire
Przejdź do Ustawienia → Sensors aby zobaczyć listę skonfigurowanych czujników 1-Wire.
Podłączanie czujnika DS18B20
Czujnik DS18B20 ma 3 wyprowadzenia:
- VCC (czerwony) - zasilanie 3.3V lub 5V
- GND (czarny) - masa
- DATA (żółty/biały) - linia danych 1-Wire
Schemat podłączenia:
- Podłącz czujnik do sterownika boneIO Black
- Między linię DATA a VCC podłącz rezystor pull-up 4.7kΩ
- Czujnik zostanie automatycznie wykryty przez kernel Linuxa
Rezystor pull-up jest wymagany! Bez rezystora 4.7kΩ między DATA a VCC czujnik może nie działać poprawnie.
Dodawanie czujnika 1-Wire
- Przejdź do Ustawienia → Sensors
- Kliknij Dodaj (przycisk +)
- Wypełnij formularz:
Ustawienia podstawowe
| Pole | Opis | Wymagane |
|---|---|---|
| Display Name | Nazwa wyświetlana w Home Assistant | Nie |
| Area | Obszar/pomieszczenie | Nie |
| Address | Adres czujnika 1-Wire (np. 28-0000098c7df0) | ✅ Tak |
| Platform | Platforma: gpio_onewire (domyślnie) lub ds2482 | Nie |
| ID | Własny identyfikator (opcjonalnie) | Nie |
| Update Interval | Interwał odczytu temperatury (domyślnie 60s) | Nie |
| Unit of Measurement | Jednostka: °C lub °F (domyślnie °C) | Nie |
| Show in HA | Czy pokazywać w Home Assistant (domyślnie tak) | Nie |
Adres czujnika jest automatycznie wykrywany przez system. Po podłączeniu czujnika kliknij przycisk odświeżania przy polu Address, aby zobaczyć dostępne czujniki.
Przykład konfiguracji
- Display Name:
Temperatura salon - Area:
Salon - Address:
28-0000098c7df0(wybierz z listy wykrytych) - Platform:
gpio_onewire - Update Interval:
30s(odczyt co 30 sekund) - Unit of Measurement:
°C
Filtry dla czujników
Możesz dodać filtry do przetwarzania odczytów temperatury:
| Filtr | Opis |
|---|---|
| round | Zaokrąglenie do N miejsc po przecinku (domyślnie 2) |
| offset | Dodanie stałej wartości (kalibracja czujnika) |
| multiply | Mnożenie przez wartość |
| filter_out | Odfiltrowanie konkretnej wartości |
| filter_out_greater | Odfiltrowanie wartości większych niż N |
| filter_out_lower | Odfiltrowanie wartości mniejszych niż N |
Przykład użycia filtrów:
Jeśli czujnik pokazuje temperaturę o 0.5°C za niską:
- Dodaj filtr offset z wartością
0.5
Czujnik nie jest wykrywany?
Jeśli po podłączeniu czujnika nie widzisz go na liście dostępnych adresów:
- Sprawdź połączenia - upewnij się, że czujnik jest poprawnie podłączony
- Sprawdź rezystor pull-up - czy jest podłączony rezystor 4.7kΩ między DATA a VCC
- Zrestartuj urządzenie - przejdź do Ustawienia → System → Reboot Device
Nigdy nie restartuj urządzenia przez wyjęcie wtyczki! Zawsze używaj funkcji System → Reboot Device w interfejsie webUI. Nagłe odcięcie zasilania może uszkodzić system plików.
Moduł R4DCB08 - hub dla wielu czujników
Jeśli chcesz podłączyć wiele czujników 1-Wire w topologii gwiazdy, możesz użyć modułu R4DCB08 przez Modbus. Zobacz sekcję Urządzenia Modbus aby dowiedzieć się więcej.
Weryfikacja w Home Assistant
Po dodaniu czujnika 1-Wire:
- Czujnik automatycznie pojawi się w Home Assistant przez MQTT Discovery
- Przejdź do Ustawienia → Urządzenia i usługi → MQTT
- Znajdź urządzenie boneIO Black - czujniki temperatury będą widoczne jako encje
Dane z czujników są automatycznie publikowane do MQTT i dostępne w Home Assistant do tworzenia automatyzacji, wykresów historycznych i dashboardów.