Agente propio

Si no usás ESP32/TPDeviceLib, podés implementar un agente (p. ej. Windows o Linux) que cumpla el mismo contrato HTTP + MQTT.

Contrato mínimo

1. Register — POST /devices/register con presetId, manufacturerId, hw_uid, customerId, params, etc.
2. Guardar deviceId, deviceSecret, mqtt_*.
3. Conectar MQTT v3.1.1 con esas credenciales.
4. Publicar telemetría en mqtt_telemetry_topic (formatos en MQTT).
5. Suscribirse a broker/{deviceId} y responder ACK en mqtt_trigger_topic.
6. Mantener status/{deviceId} + LWT y ping periódico HTTPS.

Provisión

• En PC/servidor suele haber red ya configurada: el “alta” es register + UI de instalación, no BLE.
• Si tu hardware es embebido sin TPDeviceLib, implementá el GATT BLE o un flujo de fábrica equivalente (serial/launcher) antes del register de cliente.

Referencias de agentes

Existen agentes de telemetría de referencia (Windows/Linux) en el ecosistema AlertIA que siguen este patrón: los topics no se configuran a mano en producción; salen del register.

Errores frecuentes

Síntoma	Revisar
Broker rechaza login	mqtt_user / mqtt_pass del último register
Telemetría no aparece	Topic exacto de la respuesta; formato v/did/ts/data
Trigger queda colgado	ACK con el mismo id y status canónico
Ping founded: false	DID incorrecto o dispositivo borrado

Seguí ejemplos de telemetría y triggers.