Puente MQTT para sensores de plantas
BetaReenvía las mediciones de tus sensores de plantas desde tu propio broker MQTT a la app.
- Imagen
- ghcr.io/koktaildotcom/urbanjungle-mqtt-bridge
- Funciona en
- Docker con Docker Compose, junto a tu broker MQTT
- Gateways
- OpenMQTTGateway, Theengs Gateway o cualquier publicador de mediciones en JSON
- Topic predeterminado
- urbanjungle/+/state, o home/+/BTtoMQTT/+ para los gateways
- Mediciones
- Humedad, luz, temperatura, nutrientes, batería
- Comprobación de estado
- GET /health en el puerto 8090
- Cuenta
- Vinculada con un código de dispositivo mediante OAuth 2.0, acceso solo a sensores
El puente MQTT de Urban Jungle Care es un pequeño contenedor Docker que reenvía las mediciones de tus sensores de plantas desde tu broker MQTT a tu cuenta de Urban Jungle Care. Tus plantas siguen al día mientras tu teléfono no está, sin Homey ni Home Assistant.
Qué hace el puente
- Se suscribe a un topic de tu broker y lee humedad, luz, temperatura, nutrientes y batería de cada mensaje.
- Envía esas mediciones a tu cuenta, para que la app las muestre junto con el resto del historial.
- Registra por sí mismo un sensor que tu cuenta aún no conoce. Luego lo asignas a una planta en la app.
- Ignora todo lo demás que publica un gateway, como termómetros, balizas y mensajes de estado.
Qué necesitas
- Un broker MQTT, por ejemplo Mosquitto.
- Un gateway que lea tus sensores de plantas por bluetooth y los publique en el broker, como OpenMQTTGateway o Theengs Gateway.
- Docker con Docker Compose en una máquina que llegue al broker.
- Una cuenta de Urban Jungle Care, la misma que en la app móvil.
Cómo configurarlo
-
Crea un
docker-compose.ymlcon el puente:services: mqtt-bridge: image: ghcr.io/koktaildotcom/urbanjungle-mqtt-bridge:latest restart: unless-stopped environment: MQTT_URL: mqtt://192.168.1.10:1883 MQTT_TOPIC: home/+/BTtoMQTT/+ volumes: - bridge-data:/data volumes: bridge-data: -
Arráncalo con
docker compose up -d. -
Lee el código de dispositivo con
docker compose logs mqtt-bridge. -
Abre la dirección del registro, inicia sesión con tu cuenta de Urban Jungle Care e introduce el código.
Después el registro indica que la autorización ha funcionado, y las mediciones empiezan a llegar a la app. Añade MQTT_USERNAME y MQTT_PASSWORD si tu broker pide un inicio de sesión.
Tu propio publicador
El puente no depende de ningún gateway. Publica un objeto JSON como {"moisture": 45, "temperature": 23} en urbanjungle/<dirección del sensor>/state y llega a tu cuenta. Un mensaje puede llevar solo una parte de los valores.
Revocar la vinculación
En la app, abre Integraciones, busca MQTT Bridge en Connected apps y elige Revoke access. El puente pierde el acceso al instante y escribe un código nuevo en su registro, que solo introduces si quieres volver a vincularlo.
Preguntas sobre esta integración
Un broker MQTT como Mosquitto, un gateway que publique en él tus sensores de plantas, Docker con Docker Compose y una cuenta de Urban Jungle Care.
OpenMQTTGateway y Theengs Gateway en un ESP32 o una Raspberry Pi. Pon MQTT_TOPIC en home/+/BTtoMQTT/+ y el puente recoge los sensores Mi Flora y otros sensores de plantas.
En el primer arranque escribe un código de dispositivo en su registro. Abre la dirección del registro en cualquier dispositivo, inicia sesión con tu cuenta de Urban Jungle Care e introduce el código. El puente nunca ve tu contraseña.
Solo a tus sensores. Lee y registra dispositivos y envía mediciones. No ve tus plantas, tus tareas ni tu perfil.
El puente guarda su token en /data. Monta /data como volumen, como en el ejemplo de esta página, y la vinculación sobrevive a reinicios y actualizaciones.
Un Mi Flora solo envía su nivel de batería en una conexión directa, no en las emisiones que lee un gateway. Las demás mediciones llegan de una en una, repartidas en varios mensajes.
El puente funciona, pero es nuevo y tiene menos usuarios que la app y la integración de Homey. Los problemas que comuniques le ayudan a salir antes de la beta.