Ejemplo: enchufe inteligente

Crea comandos de encendido y apagado para un enchufe inteligente de principio a fin — carga útil, codificador, verificación y ejecución desde la pestaña Estados.

Este recorrido crea dos comandos en un dispositivo y verifica que funcionaron. Utiliza un enchufe inteligente alimentado por la red que informa si su relé está encendido o apagado, pero la misma secuencia se aplica a cualquier actuador: una válvula, una luminaria, un calentador.

Síguelo en orden — cada sección produce algo que la siguiente necesita.

Antes de empezar

• El enchufe está registrado y transmitiendo. Clase C para LoRaWAN, o un dispositivo MQTT.

• Puedes ver sus lecturas en la Métricas pestaña (Asignación para MQTT).

1. Descubre cómo informa el dispositivo de su estado

Abre el dispositivo y ve a la Métricas pestaña. Revisa la tabla de claves del conector en busca del campo que transporta el estado del relé, y anota dos cosas: el nombre del campo y el valor que muestra ahora mismo.

Para este enchufe:

Clave del conector	Valor actual
socket_status	apagado

Ese valor es lo que una comprobación de verificación comparará más adelante, así que anótalo exactamente como aparece — apagado, no APAGADO o falso.

Si el campo aún no está asignado a una métrica, asígnalo ahora: el editor de comandos selecciona sensores por su nombre de métrica, así que un campo sin asignar no puede usarse para verificar nada. Consulta Decodificación de la carga útil y claves del conector.

En este ejemplo socket_status está asignado a una métrica llamada Estado del socket.

2. Crea el comando Encender

Abra Comandos y estados → Comandos y haz clic en Añadir nuevo comando.

1. Identidad

• Nombre del comando — Encender

2. Enrutamiento

• Para LoRaWAN: establece el fPort que espera el dispositivo, y activa Downlink confirmado encendido.

• Para MQTT: introduce el tema al que el enchufe se suscribe para los comandos.

3. Carga útil

Este comando no lleva parámetros — siempre envía lo mismo — así que no añadas ninguno y define la carga útil que debe construir el codificador. El enchufe espera tres bytes: canal 0x08, tipo 0x70, y el estado, 0x01 para encendido.

Usa Probar codificador para comprobar el resultado antes de guardar. Muestra la salida codificada en hex y base64 con su tamaño en bytes, así puedes confirmar que la carga útil es 08 70 01 antes de que el comando llegue al dispositivo.

4. Verificación

Elija Espera la siguiente subida — el enchufe informa de su estado en cada mensaje rutinario, así que no hace falta consultarlo por sondeo.

Bajo Estados esperados del sensor, haz clic en Añadir estado:

• Métrica — Estado del socket

• Valor esperado — on

Escribe el valor tal como lo informa el dispositivo. Aquí no importa el uso de mayúsculas, así que on también coincide con un dispositivo que informa ENCENDIDO — pero el texto y los números no son intercambiables, así que 1 no coincidiría. Consulta Confirmación de comandos.

Haz clic en Guardar.

3. Crea el comando Apagar

Repite los pasos anteriores con tres cambios:

• Nombre del comando — Apagar

• Carga útil — los mismos tres bytes con el byte de estado establecido en 0x00

• Valor esperado — apagado

Todo lo demás sigue igual.

4. Ejecútalos y comprueba el resultado

Vaya a la pestaña Estados pestaña, busca Encender en la lista de comandos disponibles, y haz clic en Ejecutar.

Observa cómo aparece la entrada en Ejecuciones recientes:

1. Comienza como Pendiente mientras el enlace descendente está en camino.

2. Cuando llegue el siguiente mensaje del enchufe informando socket_status: encendido, la ejecución pasa a Confirmado — la plataforma ha visto el dispositivo en el estado que pediste.

Ejecuta Apagar y lo mismo ocurre a la inversa.

Si la ejecución nunca se confirma

Una ejecución que permanece sin confirmar hasta que se cierra su ventana se marca como Advertencia suave — entregada, pero no confirmada. Revisa esto en orden:

1. Comprueba el valor. Abre la pestaña Métricas y lee lo que socket_status informa ahora. Si el enchufe cambió pero informa 1 en lugar de on, el valor esperado tiene que coincidir con esa forma — y un literal escrito siempre es texto, así que usa una {{ parameterName }} referencia a un parámetro Booleano o Entero en su lugar.

2. Comprueba la métrica. Asegúrate de que la Métrica que seleccionaste sea la alimentada por socket_status, y de que esté asignada y recibiendo lecturas.

3. Comprueba la ventana. La ventana predeterminada es 1.5 × el intervalo de envío de datos del dispositivo. Si ese intervalo no está configurado en el dispositivo, configúralo — consulta Tiempo de espera de convergencia.

4. Comprueba la carga útil. Ejecuta Probar codificador de nuevo y compara los bytes con la documentación del fabricante.

Siguiente

• Coloca los dos comandos en un panel con un Widget de control para que el equipo pueda cambiar el enchufe sin abrir el dispositivo.

• Deja que una regla opere el enchufe por sí sola — consulta Ejecución de comandos de dispositivos.