Zum Hauptinhalt springen
CloudStudio

Dimmer

Endpoint-Status melden

The integration por MQTT de dimmers y otros dispositivos similares (variadores de velocidad, etc.) uses the following structure:

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

Parameter

NameDescriptionData Type
accessTokenAccess token with permissions to update endpoint information. See this page for more information.text
endpointIDUnique endpoint identifier or combination of device address and endpoint address in format [deviceAddress]:endpointAddress (e.g.: [device-1234]:1). These values can be found on the endpoint management page.text
isOnIndica si el artefacto está encendido (true) o apagado (false)bool
dimValueIndica el nivel de dimerización, como porcentaje entre 1 y 100.numeric
timestampOptional value indicating the UTC date and time corresponding to the measurement. The date format must match one of those specified in the date formats section. If the field is omitted, the platform will assume the measurement corresponds to the current date and time.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

Statusmeldung im „raw"-Format

Der Endpoint-Status kann als folgendes gemeldet werden: Rohwert, mit dem Ausdruckskonverter. Diese Option ist sinnvoll, wenn das Gerät keine Konvertierungen vornehmen kann und Werte ausgibt, die transformiert werden müssen, bevor sie in die Plattform eingespeist werden.

Nachfolgend ein Beispiel einer Anfrage im raw-Format:

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

Parameter

NameDescriptionData Type
accessTokenAccess token with permissions to update endpoint information. See this page for more information.text
endpointIDUnique endpoint identifier, which can be found on the endpoint management page.numeric
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.text
timestampOptional value indicating the UTC date and time corresponding to the measurement. The date format must match one of those specified in the date formats section. If the field is omitted, the platform will assume the measurement corresponds to the current date and time.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

Zuletzt aktualisiert am

Auf dieser Seite