Saltar al contenido principal
CloudStudio

Dimmers

Reporte de estado del endpoint

La integración por MQTT de dimmers y otros dispositivos similares (variadores de velocidad, etc.) lleva la siguiente estructura:

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"isOn": true,
	"dimValue"; 75,
	"timestamp": "2021-02-23T14:55:03",
	"mqttMethod": "UpdateDimmerStatus",
	"mqttRID": "tkrs34"
}

Parámetros

NombreDescripciónTipo de datos
accessTokenToken de acceso con permisos para actualizar información del endpoint. Vea esta página para más información.texto
endpointIDIdentificador único del endpoint o combinación de dirección del dispositivo y dirección del endpoint con formato [deviceAddress]:endpointAddress (Ej: [device-1234]:1). Estos valores pueden verse en la página de administración de endpoints.texto
isOnIndica si el artefacto está encendido (true) o apagado (false)bool
dimValueIndica el nivel de dimerización, como porcentaje entre 1 y 100.numérico
timestampValor opcional indicando la fecha y hora UTC correspondiente a la medición. El formato en que se indique esta fecha debe coincidir con alguno de los indicados en la sección formatos de fecha. En caso de que el campo sea omitido, la plataforma asumirá que la medición corresponde a la fecha y hora actuales.text
mqttMethodCorresponding method of the service, in this case UpdateDimmerStatusstring
mqttRIDOptional identifier for the request, in case you want to get a confirmation response.string

Reporte de estado en formato "raw"

El estado del endpoint puede ser reportado como un valor crudo (raw), utilizando el conversor de expresiones. Esta opción es conveniente cuando el dispositivo no es capaz de realizar conversiones, y emite valores que necesitan ser transformados antes de inyectarse en la plataforma.

A continuación, se muestra un ejemplo de una petición en formato raw:

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"rawData": "true/75",
	"timestamp": "2021-02-23T14:55:03",
	"mqttMethod": "UpdateDimmerStatusRaw",
	"mqttRID": "tkrs34"
}

Parámetros

NombreDescripciónTipo de datos
accessTokenToken de acceso con permisos para actualizar información del endpoint. Vea esta página para más información.texto
endpointIDIdentificador único del endpoint, que puede verse en la página de administración de endpoints.numérico
rawDataValor reportado por el sensor, como texto. Deben indicarse dos expresiones en el conversor de expresiones:La primera expresión debe devolver un valor booleano indicando si el artefacto está encendido (true) o apagado (false).La segunda expresión debe devolver un valor numérico indicando el nivel de dimerización del aparato, como porcentaje entre 1 y 100.texto
timestampValor opcional indicando la fecha y hora UTC correspondiente a la medición. El formato en que se indique esta fecha debe coincidir con alguno de los indicados en la sección formatos de fecha. En caso de que el campo sea omitido, la plataforma asumirá que la medición corresponde a la fecha y hora actuales.text
mqttMethodCorresponding method of the service, in this case UpdateDimmerStatusRawstring
mqttRIDOptional identifier for the request, in case you want to get a confirmation response.string

Última actualización

En esta página