Holt deine smartCamper-Box in Home Assistant: alle provisionierten Funk-Sensoren
(Ruuvi, Mopeka, Victron, LiTime, BTHome, Neigung) als Sensor-Entities, den
Online-Status der Box und die Fahrzeug-Position als device_tracker — z. B.
für Automationen wie „Kühlschrank über 8 °C → Benachrichtigung" oder eine
Camper-Karte im Dashboard.
Funktionsweise: Cloud-Polling (alle 60 s) gegen die offizielle smartCamper-API — dieselben Endpunkte, die auch die iOS-App nutzt. Kein lokaler Zugriff nötig; die Box darf also unterwegs sein, während dein Home Assistant zuhause steht.
HACS (empfohlen): Dieses Repository in HACS als Custom Repository (Kategorie „Integration") hinzufügen → „smartCamper" installieren → Home Assistant neu starten.
Manuell: Den Ordner custom_components/smartcamper/ in dein
HA-Konfigurationsverzeichnis unter custom_components/ kopieren und
Home Assistant neu starten.
Einstellungen → Geräte & Dienste → Integration hinzufügen → smartCamper,
dann mit E-Mail und Passwort deines smartCamper-Kontos anmelden.
Gespeichert wird nur ein Zugriffs-Token, nie das Passwort. Die Cloud-URL
bleibt im Normalfall auf https://cloud.smartcamper.app.
| Entity | Quelle |
|---|---|
Je Sensor & Messwert ein sensor (z. B. „Kühlschrank Temperatur") |
letzter Cloud-Payload der Box |
binary_sensor Online |
Box hat sich in den letzten 45 min gemeldet |
device_tracker Position |
GNSS-Fix des letzten Sende-Zyklus |
Diagnose: Uplink (wifi/lte, mit SSID/RSSI-Attributen), LTE-Signal (Standard deaktiviert) |
Verbindungs-Infos der Box |
Frische: Veraltete Messwerte (Sensor außer Reichweite, leere Knopfzelle)
machen die Entity nicht verfügbar, statt den letzten Wert ewig
weiterzumelden — dieselbe Politik wie App und Web-Dashboard. Das Alter der
Messung steht als Attribut messwert_alter_s an jeder Entity.
Es werden nur Messwerte angelegt, die dein Sensor tatsächlich liefert (ein Victron Orion-Tr bekommt z. B. keine tote „Strom"-Entity). Nach dem Provisionieren neuer Sensoren die Integration einmal neu laden.
- Die Werte sind so frisch wie der Sende-Takt der Box: alle 5 min über WLAN, alle 30 min über LTE, ~1×/min solange die App per Bluetooth verbunden ist.
- Bei Token-Ablauf meldet sich Home Assistant mit einer Re-Authentifizierungs-Aufforderung (Passwort erneut eingeben).
- Fehler & Wünsche: bitte als GitHub-Issue in diesem Repository.