Volver al resumen Guía

Integrar un RuuviTag en Home Assistant: el clima de la autocaravana desde cualquier lugar

Tiempo de lectura: 6 min
CampMatic

Este artículo también está disponible en: Deutsch · English · Français · Italiano · Polski · Čeština · Svenska · Nederlands

Integrar un RuuviTag en Home Assistant: el clima de la autocaravana desde cualquier lugar

Un RuuviTag en tu autocaravana o camper mide la temperatura, la humedad y la presión del aire. Mientras estás al lado, es fácil. Pero si Home Assistant funciona en casa y el vehículo pasa el invierno guardado o está en un área de autocaravanas, no llega nada: el Bluetooth solo alcanza unos metros.

Este artículo explica cómo llegan los valores igualmente a tu Home Assistant y qué entidades obtienes. Los pasos detallados están en nuestra guía de Home Assistant, que está en inglés.

Lo esencial

  • El camino: una caja CampMatic en el vehículo lee el RuuviTag por Bluetooth y envía los valores por WiFi o 4G mediante MQTT a tu Home Assistant, esté donde esté.
  • Qué llega: temperatura, humedad, presión del aire y el voltaje de la pila del sensor.
  • Esfuerzo: configurar un puente MQTT y crear una vez los sensores Ruuvi en YAML. Nosotros damos las plantillas; tú solo cambias los marcadores.
  • Coste: sin suscripción. La app y el servidor son gratuitos.

¿Por qué no directamente por Bluetooth?

Home Assistant solo lee sensores Bluetooth dentro del alcance de radio de su propio hardware Bluetooth. Eso funciona mientras la autocaravana y Home Assistant están juntos. Si el vehículo está en otro sitio, guardado en invierno, en un área o de viaje, hace falta algo a bordo que lea el sensor y reenvíe los valores.

Ese es el trabajo de la caja CampMatic. Lee el RuuviTag en el vehículo y entrega los valores mediante MQTT a tu Home Assistant. Además los ves en la app CampMatic y en Telegram, aunque Home Assistant esté apagado. No necesitas un Ruuvi Gateway (Integraciones: RuuviTag).

Qué necesitas

  • Una caja CampMatic en el vehículo. Todas las cajas leen el RuuviTag: CampMatic Guard (solo sensores, para cualquier vehículo, alimentación por USB), CampMatic para Truma CP Plus y CampMatic para Truma iNet X. Cada caja admite hasta ocho sensores Bluetooth (FAQ), también varios RuuviTag.
  • Un RuuviTag. No está incluido.
  • Home Assistant con acceso de administrador y el complemento Mosquitto broker.
  • Internet en el vehículo: WiFi para la variante WiFi, tu propia tarjeta SIM para la variante 4G (no incluida; SIM IoT desde unos 2 € al mes).

Los pasos

  1. Emparejar el RuuviTag. Configura el sensor una vez con la app Ruuvi del fabricante. Después, en la app CampMatic, ve a Settings → Devices → Add device y elige el sensor de entorno Ruuvi. Los sensores dentro del alcance suelen aparecer en pocos segundos. Se empareja en la app CampMatic, no en Home Assistant (Ayuda: Dispositivos externos).
  2. Obtener las credenciales. La página Status de la app CampMatic tiene la tarjeta «MQTT Bridge (Home Assistant)» con broker, puerto, usuario, contraseña y prefijo de tema; el bloque «Device Status» muestra el Device ID (capítulo 2).
  3. Instalar Mosquitto. Instala el complemento, crea la carpeta /share/mosquitto y solo después activa la opción customize. Al revés, el complemento ya no arranca (capítulo 3).
  4. Crear el puente. El archivo /share/mosquitto/campmatic.conf une tu broker con el nuestro. Cambia los marcadores, reinicia el complemento y en el registro debe aparecer «Connecting bridge». Si no quieres accionar nada desde Home Assistant, pon in en lugar de both en la línea del tema (capítulo 4).
  5. Leer el número de posición. En la integración MQTT, escucha el tema campmatic/<GERAETE_ID>/+/config. En la línea ruuvi/config, el número tras slot es el de tu sensor. Los números se reparten entre todos los tipos de sensor y no se pueden adivinar (capítulo 8).
  6. Crear los sensores. Los sensores Ruuvi ya preparados van en el archivo /config/packages/campmatic.yaml, bajo mqtt: sensor:. Cambia <GERAETE_ID> y <SLOT_RUUVI>, comprueba la configuración y reinicia Home Assistant (capítulo 10). La carpeta packages se activa una sola vez, como explica el capítulo 6.

La guía calcula una media hora para el recorrido completo. Allí tienes también todos los archivos en una sola descarga.

Qué valores llegan

Cada valor tiene su propio tema MQTT con el patrón campmatic/<GERAETE_ID>/ruuvi/tag_<SLOT_RUUVI>/…. Los nombres de la derecha son los de la plantilla inglesa:

ValorEl tema termina enSensor en la plantilla
Temperatura (°C)temp_cIndoor Temperature
Humedad (%)humidityIndoor Humidity
Presión (hPa)pressure_hpaIndoor Pressure
Pila del sensor (V)battery_vIndoor Sensor Battery (diagnóstico)
Intensidad de señalrssiIndoor Signal (en el paquete de descarga)

El Ruuvi envía además la aceleración en tres ejes (accel_x, accel_y, accel_z), un contador de movimientos (moves) y un número de secuencia (seq). Si los necesitas, créalos con el mismo patrón. Con varios RuuviTag, por ejemplo en la zona de estar y en el frigorífico, creas los sensores una vez por número de posición, cada uno con su nombre.

Tres cosas que conviene saber:

  • Los valores llegan a intervalos. Los sensores Bluetooth suelen informar solo cada 6 minutos y los valores no se guardan en memoria. Tras un reinicio faltan unos minutos. Para comprobarlo, escucha campmatic/<GERAETE_ID>/ruuvi/# durante al menos 10 minutos.
  • Sin valores viejos: si no llega nada en 45 minutos, las plantillas muestran el sensor como «no disponible» en lugar de mantener el último valor.
  • Presión local. El Ruuvi mide la presión donde está. En la montaña el valor es, por tanto, bastante más bajo que el del parte meteorológico.

Ideas para automatizaciones

  • Aviso de heladas: si Indoor Temperature se queda un rato por debajo de unos pocos grados, Home Assistant te envía un mensaje. Con la caja para Truma CP Plus, la misma automatización puede encender también la calefacción (capítulo 7); en ese caso comprueba el estado de funcionamiento de la calefacción, no solo el interruptor. Con la caja para Truma iNet X, la calefacción se controla en la app CampMatic.
  • Vigilar el frigorífico: un segundo sensor dentro del frigorífico avisa si sube la temperatura.
  • Humedad durante días: el historial muestra si la vivienda sigue demasiado húmeda.

Para un aviso sencillo no necesitas Home Assistant: la app CampMatic te avisa por la app, Telegram o correo electrónico en cuanto se alcanza un umbral. Home Assistant merece la pena para tus propias reglas y para unir la autocaravana con el resto de tu casa.

Panel y solución de problemas

El panel ya preparado del capítulo 14 incluye un grupo «Indoor Climate» con temperatura, humedad, presión y gráfico de historial, sin tarjetas adicionales. Borra las tarjetas de los sensores que no tengas.

Si un valor sigue vacío, suele ser por una de estas causas (capítulo 15):

  • Respuesta vacía en +/config: no hay ningún sensor emparejado. Eso se hace en la app CampMatic.
  • Un solo sensor sin valor: casi siempre un número de posición incorrecto. Puede cambiar tras volver a emparejar.
  • Varios sensores siempre «no disponibles»: comprueba si mqtt: aparece más de una vez en tu archivo de paquete. En ese caso solo cuenta el último bloque.
  • Sensores nuevos sin valor: reinicia Home Assistant de verdad. Recargar la configuración no basta.

Preguntas frecuentes

No tengo calefacción Truma. ¿Funciona igualmente?
Sí. Para eso está CampMatic Guard: vigila el gas, la batería auxiliar y el clima interior, pero no controla ninguna calefacción. No necesita conexión a Truma.

¿Y la batería auxiliar?
Un monitor de batería BM2 llega a Home Assistant por el mismo camino: Integrar el monitor de batería BM2 en Home Assistant.

→ CampMatic Guard · WiFi — 89 €

→ CampMatic Guard · 4G — 129 €