Ruta guiada: Automatizar finca¶
Guía paso a paso para desplegar la capa IoT de 
SmallCountry: sensores, actuadores, mensajería MQTT, flujos de automatización y gestión agrícola con farmOS.
¿Para quién es esta ruta?¶
Para quien gestiona una finca, huerto o explotación agrícola y quiere monitorizar y automatizar con tecnología propia, sin depender de plataformas en la nube. Necesitas acceso a los contenedores LXC del bridge vmbr3 (IoT) y tener ya la infraestructura base funcionando. No se asume experiencia con electrónica, pero ayuda tener curiosidad por los ESP32.
1. Entender IoT en SmallCountry¶
La capa IoT conecta el mundo físico (sensores de humedad, temperatura, balanzas de colmenas) con el mundo digital (dashboards, alertas, bases de datos).
Sistema de Infraestructura — El bridge vmbr3 (10.10.40.0/24) está dedicado a IoT y dispositivos de campo.
Revisa también el ADR-008 sobre por qué se eligió ESP32 como microcontrolador y el ADR-009 sobre comunicación de largo alcance para sensores remotos.
2. Desplegar Mosquitto MQTT¶
MQTT es el protocolo de mensajería ligera que conecta todos los dispositivos de campo. Mosquitto es el broker que enruta los mensajes.
Mosquitto — Ficha con configuración del broker, tópicos estándar, autenticación y bridge MQTT entre nodos.
Define una convención de tópicos clara. Por ejemplo: finca/colmenas/colmena3/peso, finca/clima/temperatura, finca/gallinero/puerta.
3. Configurar Node-RED¶
Node-RED es el cerebro de la automatización. Conecta MQTT con bases de datos, dashboards, APIs externas y actuadores mediante flujos visuales.
Node-RED — Ficha con flujos de ejemplo, nodos personalizados, autenticación y backup de flujos.
Crea tu primer flujo: sensor de temperatura → MQTT → Node-RED → InfluxDB → Grafana. Que sea sencillo pero completo de extremo a extremo.
4. Conectar sensores ESP32¶
Los ESP32 son los microcontroladores que recogen datos del campo: temperatura, humedad, peso de colmenas, apertura de puertas, nivel de agua.
ESP32 — Ficha con firmware recomendado (ESPHome / Tasmota), pines, alimentación solar y conectividad WiFi/LoRa.
Empieza con un sensor de temperatura y humedad DHT22 en un ESP32 con ESPHome. Es el "hola mundo" del IoT de campo. Cuando funcione, escala a sensores más complejos.
5. Instalar actuadores Shelly¶
Los Shelly son relés WiFi que permiten encender y apagar cosas desde el sistema: riego, luces, extractores, calefactores de colmenas.
Shelly — Ficha con modelos (1PM, 2.5, Pro), integración MQTT y modo local sin nube.
Configura cada Shelly en modo MQTT local (sin pasar por la nube del fabricante). El tópico MQTT shellies/shelly-riego/relay/0/command te permitirá activar el riego desde Node-RED.
6. Desplegar farmOS¶
farmOS es la plataforma de gestión agrícola: registro de cultivos, rotaciones, insumos, cosechas y mapas de la finca. Elegido por ADR-012.
farmOS — Ficha con configuración, módulos, API REST e integración con sensores vía MQTT.
Carga el mapa de tu finca, define las parcelas y vincula los sensores ESP32 a cada zona. farmOS expone una API REST que Node-RED y Hermes Agent pueden consultar.
7. Crear dashboards en Grafana¶
Los datos de campo necesitan visualizarse. Grafana unifica métricas de sensores, estado de actuadores y datos de farmOS en un solo panel.
Grafana — Ficha con fuentes de datos, dashboards de ejemplo y exportación como código.
Crea un dashboard "Finca" con: - Gráfico de temperatura y humedad del suelo (últimas 24h) - Estado de los Shelly (encendido/apagado) - Mapa de parcelas con indicadores de salud del suelo - Estado de batería de los sensores solares
8. Configurar alertas con ntfy¶
Cuando algo se sale de lo normal —una colmena pierde peso bruscamente, el riego no se activa, la temperatura del gallinero baja de 5°C— necesitas saberlo al instante.
ntfy — Ficha con configuración de tópicos, prioridades y suscripción desde Android.
Crea alertas para los umbrales críticos de tu finca. ntfy te enviará una notificación push al móvil sin depender de Google Firebase ni servicios externos.
¿Ya terminaste? Ver también¶
- Proyectos de campo — Conecta tu finca automatizada con los proyectos activos: El Salto, Corral del Viento, Gallinero, Proyecto Clima.
- Energía — Si tus sensores y actuadores funcionan con energía solar, integra Geb (Victron Cerbo GX) para monitorizar producción y consumo.
- Home Assistant — Para automatización doméstica que complementa la automatización de finca.