HVAC / Thermostats
Reporting HVAC Device Status
The HTTP integration of HVAC devices uses the following structure:
POST /services/gear/DeviceIntegrationService.svc/UpdateHVACStatus HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"endpointID": 1,
"mode": 4,
"fanMode": 1,
"setpoint": 21,
"ambientTemperature": 21.5,
"timestamp": "2021-02-23T14:55:03"
}Parameters
| Name | Description | Data Type |
|---|---|---|
| accessToken | Access token with permissions to update endpoint information. See this page for more information. | text |
| endpointID | Unique 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. | numeric |
| mode | Modo actual del dispositivo:1: el dispositivo está apagado.2: el dispositivo está encendido en modo automático.3: el dispositivo está encendido en modo calor.4: el dispositivo está encendido en modo frío.5: el dispositivo está encendido en modo deshumidificación.6: el dispositivo está encendido en modo ventilador. | numeric |
| fanMode | Modo actual del ventilador:1: el ventilador está en modo automático.2: el ventilador está en velocidad baja.3: el ventilador está en velocidad media.4: el ventilador está en velocidad alta. | numeric |
| setpoint | Indica el valor de temperatura deseado, en grados Celsius. | numeric |
| ambientTemperature | Indica el valor de la temperatura ambiente, en grados Celsius. | numeric |
| timestamp | Optional 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 |