Wróć do przeglądu Poradnik

Jak dodać RuuviTag do Home Assistant: klimat w kamperze z każdego miejsca

Czas czytania: 6 min
CampMatic

Ten artykuł jest dostępny także w wersjach: Deutsch · English · Français · Español · Italiano · Čeština · Svenska · Nederlands

Jak dodać RuuviTag do Home Assistant: klimat w kamperze z każdego miejsca

RuuviTag w kamperze lub kampervanie mierzy temperaturę, wilgotność i ciśnienie powietrza. Gdy stoisz obok, to proste. Ale jeśli Home Assistant działa w domu, a kamper zimuje na parkingu albo stoi na kempingu, nic nie dociera: Bluetooth sięga tylko kilku metrów.

Ten artykuł pokazuje, jak wartości mimo to trafiają do twojego Home Assistant i jakie encje otrzymasz. Szczegółowe kroki są w naszej instrukcji dla Home Assistant, napisanej po angielsku.

Najważniejsze w skrócie

  • Droga: moduł CampMatic w pojeździe odczytuje RuuviTag przez Bluetooth i wysyła wartości przez WiFi lub 4G za pomocą MQTT do twojego Home Assistant, gdziekolwiek działa.
  • Co dociera: temperatura, wilgotność, ciśnienie powietrza i napięcie baterii czujnika.
  • Nakład pracy: skonfigurować most MQTT i raz założyć czujniki Ruuvi w YAML. Szablony dostarczamy my, ty tylko podmieniasz symbole zastępcze.
  • Koszty: bez abonamentu. Aplikacja i serwer są bezpłatne.

Dlaczego nie bezpośrednio przez Bluetooth?

Home Assistant odczytuje czujniki Bluetooth tylko w zasięgu radiowym własnego sprzętu Bluetooth. To działa, dopóki kamper i Home Assistant są obok siebie. Gdy pojazd stoi gdzie indziej, na zimowym postoju, na kempingu albo w trasie, potrzebne jest coś na pokładzie, co odczyta czujnik i przekaże wartości dalej.

To zadanie modułu CampMatic. Odczytuje RuuviTag w pojeździe i dostarcza wartości przez MQTT do twojego Home Assistant. Widzisz je też w aplikacji CampMatic i na Telegramie, nawet gdy Home Assistant jest wyłączony. Ruuvi Gateway nie jest potrzebny (Integracje: RuuviTag).

Czego potrzebujesz

  • Moduł CampMatic w pojeździe. RuuviTag odczytuje każdy moduł: CampMatic Guard (tylko czujniki, do każdego kampera, zasilanie przez USB), CampMatic dla Truma CP Plus i CampMatic dla Truma iNet X. Każdy moduł obsługuje do ośmiu czujników Bluetooth (FAQ), także kilka RuuviTagów.
  • RuuviTag. Nie wchodzi w skład zestawu.
  • Home Assistant z dostępem administratora i dodatkiem Mosquitto broker.
  • Internet w pojeździe: WiFi dla wersji WiFi, własna karta SIM dla wersji 4G (nie wchodzi w skład zestawu, karta SIM IoT od ok. 2 € miesięcznie).

Krok po kroku

  1. Sparuj RuuviTag. Skonfiguruj czujnik raz w aplikacji Ruuvi producenta. Potem w aplikacji CampMatic otwórz Settings → Devices → Add device i wybierz czujnik otoczenia Ruuvi. Tagi w zasięgu pojawiają się zwykle po kilku sekundach. Parowanie odbywa się w aplikacji CampMatic, nie w Home Assistant (Pomoc: Urządzenia zewnętrzne).
  2. Pobierz dane dostępowe. Strona Status w aplikacji CampMatic zawiera kartę „MQTT Bridge (Home Assistant)” z brokerem, portem, użytkownikiem, hasłem i prefiksem tematów, a blok „Device Status” pokazuje Device ID (rozdział 2).
  3. Zainstaluj Mosquitto. Zainstaluj dodatek, utwórz folder /share/mosquitto i dopiero potem włącz opcję customize. W odwrotnej kolejności dodatek przestaje się uruchamiać (rozdział 3).
  4. Utwórz most. Plik /share/mosquitto/campmatic.conf łączy twój broker z naszym. Podmień symbole zastępcze, uruchom dodatek ponownie; w dzienniku musi pojawić się „Connecting bridge”. Jeśli nie chcesz niczego przełączać z Home Assistant, w linii tematu wpisz in zamiast both (rozdział 4).
  5. Odczytaj numer slotu. W integracji MQTT nasłuchuj tematu campmatic/<GERAETE_ID>/+/config. W linii ruuvi/config liczba po slot to numer twojego czujnika. Numery są nadawane wspólnie dla wszystkich typów czujników i nie da się ich zgadnąć (rozdział 8).
  6. Załóż czujniki. Gotowe czujniki Ruuvi trafiają do pliku /config/packages/campmatic.yaml pod mqtt: sensor:. Podmień <GERAETE_ID> i <SLOT_RUUVI>, sprawdź konfigurację, uruchom Home Assistant ponownie (rozdział 10). Folder packages włączasz jednorazowo, jak opisano w rozdziale 6.

Instrukcja zakłada około pół godziny na całość. Wszystkie pliki znajdziesz tam też w jednym pakiecie do pobrania.

Jakie wartości docierają

Każda wartość ma własny temat MQTT według wzoru campmatic/<GERAETE_ID>/ruuvi/tag_<SLOT_RUUVI>/…. Nazwy po prawej pochodzą z angielskiego szablonu:

WartośćTemat kończy się naCzujnik w szablonie
Temperatura (°C)temp_cIndoor Temperature
Wilgotność (%)humidityIndoor Humidity
Ciśnienie (hPa)pressure_hpaIndoor Pressure
Bateria czujnika (V)battery_vIndoor Sensor Battery (diagnostyka)
Siła sygnałurssiIndoor Signal (w pakiecie do pobrania)

Ruuvi wysyła też przyspieszenie w trzech osiach (accel_x, accel_y, accel_z), licznik ruchów (moves) i numer kolejny (seq). Jeśli ich potrzebujesz, załóż je według tego samego wzoru. Przy kilku RuuviTagach, np. w części mieszkalnej i w lodówce, zakładasz czujniki raz na każdy numer slotu, każdy z własną nazwą.

Trzy rzeczy warto wiedzieć:

  • Wartości przychodzą w odstępach. Czujniki Bluetooth odzywają się zwykle tylko co 6 minut, a wartości nie są buforowane. Po ponownym uruchomieniu brakuje ich więc przez kilka minut. Aby sprawdzić, nasłuchuj campmatic/<GERAETE_ID>/ruuvi/# przez co najmniej 10 minut.
  • Bez starych wartości: jeśli przez 45 minut nic nie przyjdzie, szablony pokazują czujnik jako „niedostępny”, zamiast trzymać ostatnią wartość.
  • Ciśnienie lokalne. Ruuvi mierzy ciśnienie tam, gdzie leży. W górach wartość jest więc wyraźnie niższa niż w prognozie pogody.

Pomysły na automatyzacje

  • Ostrzeżenie przed mrozem: gdy Indoor Temperature przez dłuższą chwilę spada poniżej kilku stopni, Home Assistant wysyła ci wiadomość. Z modułem dla Truma CP Plus ta sama automatyzacja może też włączyć ogrzewanie (rozdział 7); sprawdzaj wtedy stan pracy ogrzewania, a nie tylko przełącznik. Z modułem dla Truma iNet X ogrzewaniem sterujesz w aplikacji CampMatic.
  • Lodówka pod kontrolą: drugi tag w lodówce zgłosi, gdy temperatura w niej wzrośnie.
  • Wilgotność przez kilka dni: historia pokazuje, czy w zabudowie jest stale zbyt wilgotno.

Do prostego ostrzeżenia Home Assistant nie jest potrzebny: aplikacja CampMatic powiadomi cię w aplikacji, przez Telegram lub e-mailem, gdy zostanie osiągnięty próg. Home Assistant opłaca się przy własnych regułach i połączeniu kampera z resztą domu.

Pulpit i rozwiązywanie problemów

Gotowy pulpit z rozdziału 14 ma grupę „Indoor Climate” z temperaturą, wilgotnością, ciśnieniem i wykresem historii, bez dodatkowych kart. Karty czujników, których nie masz, po prostu usuń.

Gdy wartość pozostaje pusta, przyczyną jest zwykle jedna z tych rzeczy (rozdział 15):

  • Pusta odpowiedź na +/config: żaden czujnik nie jest sparowany. Robi się to w aplikacji CampMatic.
  • Pojedynczy czujnik bez wartości: najczęściej zły numer slotu. Może się zmienić po ponownym sparowaniu.
  • Kilka czujników stale „niedostępnych”: sprawdź, czy mqtt: nie występuje w pliku pakietu więcej niż raz. Wtedy liczy się tylko ostatni blok.
  • Nowe czujniki bez wartości: uruchom Home Assistant naprawdę od nowa. Samo przeładowanie konfiguracji nie wystarczy.

Częste pytania

Nie mam ogrzewania Truma. Czy to i tak zadziała?
Tak. Do tego służy CampMatic Guard: monitoruje gaz, akumulator pomocniczy i klimat wnętrza, ale nie steruje żadnym ogrzewaniem. Nie potrzebuje podłączenia do Truma.

A akumulator pomocniczy?
Monitor akumulatora BM2 trafia do Home Assistant tą samą drogą: Jak dodać monitor akumulatora BM2 do Home Assistant.

→ CampMatic Guard · WiFi — 89 €

→ CampMatic Guard · 4G — 129 €