MUMA Box z ESPHome w Home Assistant. Kompletny poradnik instalacji, konfiguracji i rozwiązywania problemów

Opublikowano przez

Chcesz zamienić MUMA Box w satelitę głosowego dla Home Assistanta z lokalnym rozpoznawaniem komend i wybudzaniem hasłem OK NABU lub Alexa? Poniżej znajdziesz praktyczny, krok po kroku opis oparty na Twojej transkrypcji i na projekcie xiaozhi-esphome. Repozytorium z gotowymi konfiguracjami YAML: https://github.com/RealDeco/xiaozhi-esphome

Wymagania wstępne

Potrzebujesz działającego Home Assistanta, dodatku ESPHome oraz przeglądarki zgodnej z WebSerial do pierwszego flashowania przez USB. Voice Assistant w ESPHome wymaga aktualnego HA i ESPHome. Do pierwszej instalacji najwygodniejszy jest ESPHome Web Installer.

Krok 1. Flashowanie MUMA Box przez przeglądarkę

  1. Podłącz MUMA Box kablem USB do komputera.

  2. Otwórz ESPHome Web, wybierz właściwy port COM. Jeśli połączenie nie startuje użyj przycisku PWR, odłącz i podłącz ponownie, po czym spróbuj jeszcze raz.

  3. Kliknij Install i poczekaj aż urządzenie się zrestartuje.

  4. Po flashu połącz się z siecią Wi-Fi utworzoną przez urządzenie, wpisz dane swojej sieci 2,4 GHz i zapisz.

Krok 2. Dodanie urządzenia do ESPHome w Home Assistant

  1. Wejdź w ESPHome w HA. Urządzenie powinno zostać wykryte automatycznie.

  2. Przejmij kontrolę, nadaj nazwę i otwórz edycję pliku.

  3. Wejdź do repozytorium xiaozhi-esphome, zakładka devices, wybierz wariant dla MUMA Box i skopiuj pełny YAML.

  4. Wklej YAML w edytorze ESPHome i zapisz. Spróbuj instalacji OTA. Jeśli OTA się nie powiedzie zbuduj binarkę i wgraj ją przez przeglądarkę z pliku.

Co daje xiaozhi-esphome

Projekt przygotowuje urządzenia pokrewne Xiaozhi i MUMA Box do pracy jako satelity głosowe HA. Zyskujesz integrację z HA Assist, wybudzanie hasłem i interfejs na ekranie urządzenia. W repo znajdziesz gotowe konfiguracje dla kilku wariantów sprzętu oraz rozwijane funkcje.

Kluczowe ustawienia w YAML

  • Nazwa urządzenia i sekcja api: z kluczem szyfrującym.

  • Parametry mikrofonu i głośnika pod odsłuch i TTS.

  • Konfiguracja komponentu voice_assistant, słowa wybudzającego i mapowania przycisków.

  • Motyw graficzny interfejsu na ekranie.

Motywy graficzne i interfejs

Motyw ekranu ustawiasz w YAML. Zmiana motywu to podmiana odpowiedniej sekcji i ponowna instalacja. Dzięki temu przełączysz się między prostym a rozbudowanym wyglądem bez grzebania w kodzie źródłowym.

Słowa wybudzające i wybór asystenta

W Home Assistancie definiujesz aktywnego asystenta i język rozpoznawania. Z poziomu urządzenia możesz przełączać słowo wybudzające, regulować głośność, uruchomić latarkę ekranu, wyciszyć mikrofon i wygasić wyświetlacz.

Rozwiązywanie problemów

  • Błąd przy OTA. Zbuduj binarkę i wgraj przez ESPHome Web z pliku.

  • Komenda „Włącz lampę lewą” kończy się „Brak obszaru”. Przypisz encję lampy do obszaru i uprość nazwy. Polski ma odmiany, co bywa problemem dla rozpoznawania.

  • Brak odpowiedzi głosowej po aktualizacji. Sprawdź zgodność wersji ESPHome i HA oraz dzienniki po stronie urządzenia i HA.

Dodatkowe wskazówki

  • Do pierwszego flashu użyj Chrome lub Edge, które wspierają WebSerial.

  • Jeśli masz inny wariant sprzętu z rodziny Xiaozhi, w repo znajdziesz podobne konfiguracje i wskazówki.

Link do projektu

Pełna dokumentacja i pliki YAML: https://github.com/RealDeco/xiaozhi-esphome