Żeby wyciągnąć adapter Zigbee z metalowej szafki z serwerem, zwykle sięga się po przedłużacz USB albo koordynator sieciowy. Home Assistant rozwija trzecią możliwość: adapter USB wpina się do ESP32 z ESPHome, a Home Assistant łączy się z nim przez sieć. 26 października 2026 doszedł do tego element, dzięki któremu przenoszenie adaptera przestaje być kłopotem. Zmiana autorstwa użytkownika puddly, sprawdzona przez Paulusa Schoutsena, sprawia, że ZHA zauważa przeniesienie adaptera między lokalnym portem USB a ESPHome i sam poprawia swoje ustawienia. Jest w gałęzi rozwojowej i ma trafić do Home Assistanta 2026.11.

Jak to działa

ESPHome 2026.10.0, wydany 21 października, ma nowy typ portu USB_SERIAL w komponencie serial_proxy, czyli pośredniku portu szeregowego. ESP32 z obsługą USB w trybie hosta może obsłużyć szeregowe urządzenie USB i przekazać jego port do Home Assistanta. Dla każdego portu pośrednik wysyła informację o tożsamości urządzenia i powtarza ją przy każdym podłączeniu i odłączeniu. Ta tożsamość odpowiada temu, co Linux pokazuje w /dev/serial/by-id, na przykład usb-Nabu_Casa_ZBT-2_abcd1234-if00.

Konfiguracja ESPHome z opisu zmiany wygląda tak:

usb_host:

usb_uart:
  - type: CDC_ACM
    vid: 0x303A
    pid: 0x831A
    channels:
      - id: usb_serial_channel
        baud_rate: 460800

serial_proxy:
  - id: serial_proxy_usb
    uart_id: usb_serial_channel
    name: USB Serial Port
    port_type: USB_SERIAL

Po stronie Home Assistanta zmiana scalona 20 października dodaje takie porty do listy portów szeregowych, z których mogą korzystać integracje. Mają adres w postaci esphome-hass://<wpis konfiguracji>?udev_id=..., gdzie udev_id to ta sama nazwa, pod którą adapter widniałby w /dev/serial/by-id.

Co zmienia przenoszenie

Tożsamość jest taka sama bez względu na to, czy adapter siedzi w komputerze z Home Assistantem, czy w ESP32, więc ZHA może te dwa miejsca dopasować. Jeśli wyjmiesz adapter z lokalnego portu i podłączysz go do ESP32, albo odwrotnie, ZHA zaktualizuje ścieżkę w konfiguracji i będzie działać dalej. Nie trzeba usuwać integracji i konfigurować jej od nowa.

Są jednak warunki. ZHA musi już używać ścieżki z /dev/serial/by-id albo adresu pośrednika, a nie nazwy w rodzaju /dev/ttyUSB0. Adapter musi mieć niepowtarzalny numer seryjny i musi się znaleźć dokładnie jeden pasujący kandydat. Jeśli masz dwa identyczne adaptery bez unikalnych numerów seryjnych, ZHA nie będzie zgadywać, który jest właściwy.

Dla kogo to jest

Najbardziej skorzystają osoby, których komputer z Home Assistantem stoi w miejscu ze słabym zasięgiem radiowym, i te, które chcą wymienić komputer bez naruszania sieci Zigbee. Zmiana należy do punktu planu rozwoju Open Home Foundation poświęconego pośrednikom portów szeregowych. Pamiętaj tylko, że koordynator Zigbee podłączony przez ESP32 zależy od stabilnego połączenia Wi-Fi albo Ethernet z tym modułem.