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
- 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).
- 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).
- Zainstaluj Mosquitto. Zainstaluj dodatek, utwórz folder
/share/mosquittoi dopiero potem włącz opcjęcustomize. W odwrotnej kolejności dodatek przestaje się uruchamiać (rozdział 3). - 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 wpiszinzamiastboth(rozdział 4). - Odczytaj numer slotu. W integracji MQTT nasłuchuj tematu
campmatic/<GERAETE_ID>/+/config. W liniiruuvi/configliczba poslotto numer twojego czujnika. Numery są nadawane wspólnie dla wszystkich typów czujników i nie da się ich zgadnąć (rozdział 8). - Załóż czujniki. Gotowe czujniki Ruuvi trafiają do pliku
/config/packages/campmatic.yamlpodmqtt: 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ę na | Czujnik w szablonie |
|---|---|---|
| Temperatura (°C) | temp_c | Indoor Temperature |
| Wilgotność (%) | humidity | Indoor Humidity |
| Ciśnienie (hPa) | pressure_hpa | Indoor Pressure |
| Bateria czujnika (V) | battery_v | Indoor Sensor Battery (diagnostyka) |
| Siła sygnału | rssi | Indoor 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.