Dokumentacja boneIO | Integracja Modbus przez Pakiety ESPHome

Dowiedz się, jak łatwo zintegrować urządzenia Modbus, takie jak pompy ciepła czy rekuperatory, z Home Assistant za pomocą gotowych pakietów ESPHome dla boneIO.

Jedną z najpotężniejszych funkcji boneIO jest możliwość komunikacji z zaawansowanymi urządzeniami zewnętrznymi, takimi jak pompy ciepła, rekuperatory czy liczniki energii. Urządzenia te często komunikują się za pomocą protokołu Modbus RTU.

Ręczna konfiguracja Modbus w ESPHome potrafi być skomplikowana. Aby maksymalnie uprościć ten proces, przygotowaliśmy Pakiety ESPHome – gotowe szablony konfiguracji, które wykonują za Ciebie całą złożoną pracę.

Jak to działa?

Pakiet ESPHome to po prostu plik YAML z gotową logiką. Zamiast pisać dziesiątki linii kodu, wystarczy, że dołączysz nasz pakiet i uzupełnisz kilka prostych zmiennych w sekcji substitutions (zastępstwa), takich jak adres Modbus Twojego urządzenia. To wszystko!

Konfiguracja Krok po Kroku

Poniższy przykład pokazuje, jak odczytać temperatury z urządzenia Modbus (np. pompy ciepła) i udostępnić je jako sensory w Home Assistant.

Wymagania Wstępne

Zainstalowany i działający dodatek ESPHome.
Urządzenie boneIO dodane ("adoptowane") w panelu ESPHome.
Umiejętność edycji pliku konfiguracyjnego YAML.

Krok 1: Dołącz pakiet Modbus

W swoim pliku konfiguracyjnym YAML dla boneIO, dodaj sekcję packages i wskaż na nasz gotowy plik np sdm630.yaml. To zaimportuje całą niezbędną logikę do obsługi magistrali RS485.

packages:
  remote_package:
    url: https://github.com/boneIO-eu/esphome-packages
    ref: main
    files: [sdm630.yaml]

Krok 2: Uzupełnij sekcję `substitutions`

Teraz dodaj sekcję substitutions. To tutaj "wypełniasz formularz" danymi Twojego urządzenia Modbus. Nie musisz rozumieć skomplikowanego kodu – wystarczy, że podasz wartości dla poniższych zmiennych.

substitutions:
  # --- Podstawowa konfiguracja magistrali Modbus ---
  modbus_update_interval: "60s" # Jak często odpytywać urządzenie, np. co 60 sekund.
  modbus_address: "1" # Adres Modbus Twojego urządzenia (sprawdź w jego instrukcji).

  # --- Konfiguracja przykładowych sensorów (rejestry odczytasz z instrukcji swojego urządzenia) ---
  temp_co_name: "Temperatura CO" # Nazwa sensora w Home Assistant
  temp_co_register: "30005" # Numer rejestru Modbus dla temperatury CO

  temp_cwu_name: "Temperatura CWU"
  temp_cwu_register: "30006"

  temp_zewnetrzna_name: "Temperatura Zewnętrzna"
  temp_zewnetrzna_register: "30007"

Krok 3: Zapisz i Wgraj

Po zapisaniu pliku, wgraj nową konfigurację na swoje urządzenie boneIO. Po pomyślnym restarcie, w Home Assistant automatycznie pojawią się nowe encje z odczytanymi temperaturami, gotowe do użycia w automatyzacjach i na dashboardach!

Pełne przykłady kodu znajdziesz w Readme w naszym repozytorium https://github.com/boneIO-eu/esphome_packages

Integracja Modbus przez Pakiety ESPHome