Protocolo de Interoperabilidad Digital

Propósito

Este protocolo define cómo se comunica el subsistema electrónico de Orbita — entre sensores, actuadores, el software de monitorización y dispositivos de terceros. Siguiendo esta especificación, cualquier dispositivo compatible puede integrarse con una unidad Orbita.

Protocolo de comunicación

MQTT es el protocolo de mensajería principal. Es ligero, adecuado para dispositivos IoT con recursos limitados y soporta patrones pub/sub para datos de sensores en tiempo real.

• Broker: cada unidad Orbita ejecuta un broker MQTT local
• QoS: nivel 1 (al menos una vez) para lecturas de sensores; nivel 2 (exactamente una vez) para comandos de actuadores
• TLS: obligatorio para cualquier conexión no local

Estructura de topics

orbita/{unit_id}/sensors/{sensor_type}
orbita/{unit_id}/actuators/{actuator_type}
orbita/{unit_id}/status

Ejemplos:

• orbita/unit-001/sensors/temperature
• orbita/unit-001/sensors/humidity
• orbita/unit-001/actuators/ventilation
• orbita/unit-001/status

Formato de payload

Todos los mensajes utilizan JSON. Ejemplo de payload de sensor:

{
  "timestamp": "2026-03-09T12:00:00Z",
  "value": 22.5,
  "unit": "celsius",
  "sensor_id": "temp-01"
}

Ejemplo de comando de actuador:

{
  "command": "set",
  "value": true,
  "actuator_id": "vent-01"
}

Sensores

Pendiente — el subsistema electrónico está en fase inicial de planificación.

Tipos de sensores previstos:

• Temperatura (interior/exterior)
• Humedad
• Producción energética (salida del panel solar)
• Consumo energético
• Nivel de agua (depósito de agua de lluvia)
• Calidad del aire (CO2, COV)

REST API

Pendiente de definir — se concretará junto con el software de monitorización.

La aplicación de monitorización Orbita expondrá una REST API para:

• Consultar datos históricos de sensores
• Enviar comandos a actuadores
• Obtener el estado y la configuración de la unidad

Integración con terceros

Los dispositivos pueden integrarse con una unidad Orbita mediante:

1. Conexión al broker MQTT de la unidad
2. Publicación/suscripción a la estructura de topics indicada anteriormente
3. Uso del formato de payload JSON especificado en este documento

Los mecanismos de autenticación, registro de dispositivos y descubrimiento se definirán en futuras versiones.