Schema setpoint temperatura termostato
sdm.devices.traits.ThermostatTemperatureSetpoint
Questo tratto appartiene ai tipi di dispositivi TERMOSTATO che supportano l'impostazione della temperatura ottimale e dell'intervallo di temperatura.
Campi
Campo | Descrizione | Tipo di dati |
---|---|---|
heatCelsius |
Temperatura ottimale in Celsius per le modalità HEAT e HEATCOOL del termostato. | number Esempio: 20,0 |
coolCelsius |
Temperatura ottimale in Celsius per le modalità COOL e HEATCOOL del termostato. | number Esempio: 22,0 |
Esempio di richiesta e risposta GET - 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
Il termostato deve trovarsi nella modalità corrispondente al comando che viene chiamato prima di modificare i set-point di temperatura. Il comando e i campi per modificare i set-point variano a seconda della modalità del termostato.
Ad esempio, per inviare il comando SetHeat, il termostato deve essere prima in modalità Caldo:
Modalità | Comando | Campo/i |
---|---|---|
RISCALDAMENTO | SetHeat | heatCelsius |
FREDDO | SetCool | coolCelsius |
RISCALDAMENTO | SetRange | heatCelsius , coolCelsius |
Tieni presente che i comandi del set-point utilizzano solo i gradi Celsius come parametro, anche se Google Nest Thermostat può visualizzare la temperatura in gradi Celsius o Fahrenheit.
SetHeat
Imposta la temperatura ottimale 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
{}
Campi di richiesta SetHeat
Campo | Descrizione | Tipo di dati |
---|---|---|
heatCelsius |
La temperatura ottimale da impostare quando il termostato è in modalità Caldo. | number Esempio: 22,0 |
SetCool
Imposta la temperatura ottimale 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 di richiesta SetCool
Campo | Descrizione | Tipo di dati |
---|---|---|
coolCelsius |
La temperatura ottimale da impostare quando il termostato è in modalità FREDDO. | number Esempio: 20,0 |
SetRange
Imposta la temperatura minima e la temperatura massima quando il termostato è in modalità HEATCOOL.
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 di richiesta SetRange
Campo | Descrizione | Tipo di dati |
---|---|---|
heatCelsius |
La temperatura ottimale minima da impostare quando il termostato è in modalità HEATCOOL. | number Esempio: 20,0 |
coolCelsius |
La temperatura ottimale da impostare quando il termostato è in modalità Caldo. | number Esempio: 22,0 |
Errori
In relazione a questa caratteristica, potrebbero essere restituiti i seguenti codici di errore:
Messaggio di errore | RPC | Risolvere i problemi |
---|---|---|
Comando non consentito nell'attuale modalità termostato. | FAILED_PRECONDITION |
Alcuni modelli di termostato non supportano la modifica della modalità Eco quando la modalità del termostato è disattivata, a seconda del trait ThermostatMode . Prima di cambiare la modalità Eco, è necessario impostare la modalità del termostato in Caldo, Freddo o Caldo. |
Il valore del raffreddamento deve essere maggiore del valore del calore. | INVALID_ARGUMENT |
Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius nel comando. |
Comando non consentito quando il termostato è in modalità MANUAL_ECO. | FAILED_PRECONDITION |
Il set-point della temperatura non può essere impostato quando il termostato è in modalità Eco manuale. |
Consulta la pagina Riferimento sui codici di errore delle API per l'elenco completo dei codici di errore delle API.