Schema ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Questa caratteristica appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura target e dell'intervallo di temperatura.
Campi
Campo | Descrizione | Tipo di dati |
---|---|---|
heatCelsius |
Temperatura target in gradi Celsius per le modalità RISCALDAMENTO e RISCALDAMENTO/RAFFREDDAMENTO del termostato. | number Esempio: 20.0 |
coolCelsius |
Temperatura target in gradi Celsius per le modalità FREDDO e CALDO/FREDDO del termostato. | number Esempio: 22.0 |
Esempio di richiesta GET e risposta - HEAT
Richiesta
GET /enterprises/project-id/devices/device-id
Risposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
Esempio di richiesta e risposta GET - COOL
Richiesta
GET /enterprises/project-id/devices/device-id
Risposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"coolCelsius" : 22.0
}
}
}
Esempio di richiesta e risposta GET - HEATCOOL
Richiesta
GET /enterprises/project-id/devices/device-id
Risposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Comandi
Prima di modificare i setpoint di temperatura, il termostato deve essere nella modalità corrispondente al comando chiamato. Il comando e i campi per modificare i set-point variano in base alla modalità del termostato.
Ad esempio, per eseguire il comando SetHeat, il termostato deve essere prima in modalità HEAT:
Modalità | Comando | Campo/i |
---|---|---|
RISCALDAMENTO | SetHeat | heatCelsius |
COOL | SetCool | coolCelsius |
HEATCOOL | SetRange | heatCelsius , coolCelsius |
Tieni presente che i comandi di setpoint accettano solo gradi Celsius come parametro, anche se Google Nest Thermostat può visualizzare la temperatura in gradi Celsius o Fahrenheit.
SetHeat
Imposta la temperatura target quando il termostato è in modalità CALDO.
Richiesta e risposta SetHeat
Richiesta
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat
",
"params" : {
"heatCelsius" : 22.0
}
}
Risposta
{}
Imposta i campi della richiesta SetHeat
Campo | Descrizione | Tipo di dati |
---|---|---|
heatCelsius |
La temperatura target da impostare quando il termostato è in modalità RISCALDAMENTO. | number Esempio: 22.0 |
SetCool
Imposta la temperatura target quando il termostato è in modalità FREDDO.
Richiesta e risposta SetCool
Richiesta
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
Risposta
{}
Campi della richiesta SetCool
Campo | Descrizione | Tipo di dati |
---|---|---|
coolCelsius |
La temperatura target da impostare quando il termostato è in modalità FREDDO. | number Esempio: 20.0 |
SetRange
Imposta le temperature minima e massima quando il termostato è in modalità Riscaldamento e raffreddamento.
Richiesta e risposta SetRange
Richiesta
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange
",
"params" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
Risposta
{}
Campi della richiesta SetRange
Campo | Descrizione | Tipo di dati |
---|---|---|
heatCelsius |
La temperatura target minima da impostare quando il termostato è in modalità CALDO • FREDDO. | number Esempio: 20.0 |
coolCelsius |
La temperatura target massima da impostare quando il termostato è in modalità CALDO • FREDDO. | number Esempio: 22.0 |
Errori
Per questo attributo potrebbero essere restituiti i seguenti codici di errore:
Messaggio di errore | RPC | Risoluzione dei problemi |
---|---|---|
Il comando non è consentito nella modalità termostato attuale. | FAILED_PRECONDITION |
Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità termostato è OFF, in base all'attributo ThermostatMode . Prima di modificare la modalità Eco, la modalità del termostato deve essere impostata su HEAT, COOL o HEATCOOL. |
Il valore di raffreddamento deve essere maggiore del valore di riscaldamento. | INVALID_ARGUMENT |
Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius nel comando. |
Il comando non è consentito quando il termostato è in modalità MANUAL_ECO. | FAILED_PRECONDITION |
Il setpoint di temperatura non può essere impostato quando il termostato è in modalità Eco manuale. |
Consulta i riferimenti ai codici di errore dell'API per l'elenco completo dei codici di errore dell'API.