Esquema de ThermostatTemperaturaSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Essa característica pertence aos tipos de dispositivos do TERMOSTATO que oferecem suporte à definição de temperatura e faixa de temperatura desejadas.
Campos
Campo | Descrição | Tipo de dados |
---|---|---|
heatCelsius |
Temperatura-alvo em graus Celsius para os modos HEAT e HEATCOOL do termostato. | number Exemplo: 20,0 |
coolCelsius |
Temperatura-alvo em Celsius para os modos COOL e HEATCOOL do termostato. | number Exemplo: 22,0 |
Exemplo de solicitação e resposta GET: HEAT
Solicitação
GET /enterprises/project-id/devices/device-id
Resposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
Exemplo de solicitação e resposta GET - COOL
Solicitação
GET /enterprises/project-id/devices/device-id
Resposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"coolCelsius" : 22.0
}
}
}
Exemplo de solicitação e resposta GET - HEATCOOL
Solicitação
GET /enterprises/project-id/devices/device-id
Resposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Comandos
O termostato precisa estar no modo que corresponde ao comando que está sendo chamado antes da mudança das temperaturas programadas. O comando e os campos para mudar as temperaturas programadas variam de acordo com o modo do termostato.
Por exemplo, para emitir o comando SetHeat, o termostato precisa estar no modo Aquecer primeiro:
Modo | Comando | Campo(s) |
---|---|---|
Aquecimento | SetHeat | heatCelsius |
FRIO | SetCool | coolCelsius |
Aquecimento | SetRange | heatCelsius , coolCelsius |
Observe que os comandos de temperatura programada usam apenas graus em Celsius como parâmetro, embora o Google Nest Thermostat possa exibir a temperatura em graus Celsius ou Fahrenheit.
SetHeat
Define a temperatura-alvo quando o termostato está no modo Aquecer.
Solicitação e resposta SetHeat
Solicitação
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat
",
"params" : {
"heatCelsius" : 22.0
}
}
Resposta
{}
Campos de solicitação SetHeat
Campo | Descrição | Tipo de dados |
---|---|---|
heatCelsius |
É a temperatura-alvo a ser definida quando o termostato estiver no modo Aquecer. | number Exemplo: 22,0 |
SetCool
Define a temperatura-alvo quando o termostato está no modo COOL.
Solicitação e resposta de SetCool
Solicitação
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
Resposta
{}
Campos de solicitação SetCool
Campo | Descrição | Tipo de dados |
---|---|---|
coolCelsius |
É a temperatura-alvo a ser definida quando o termostato estiver no modo COOL. | number Exemplo: 20,0 |
SetRange
Define as temperaturas mínima e máxima quando o termostato está no modo HEATCOOL.
Solicitação e resposta de SetRange
Solicitação
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange
",
"params" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
Resposta
{}
Campos de solicitação SetRange
Campo | Descrição | Tipo de dados |
---|---|---|
heatCelsius |
A temperatura-alvo mínima a ser definida quando o termostato estiver no modo HEATCOOL. | number Exemplo: 20,0 |
coolCelsius |
A temperatura-alvo máxima a ser definida quando o termostato está no modo HEATCOOL. | number Exemplo: 22,0 |
Erros
Os seguintes códigos de erro podem ser retornados em relação a essa característica:
Mensagem de erro | RPC | Solução de problemas |
---|---|---|
O comando não é permitido no modo de termostato atual. | FAILED_PRECONDITION |
Alguns modelos de termostato não são compatíveis com a mudança do modo Eco quando ele está DESATIVADO, de acordo com a característica ThermostatMode . O modo do termostato precisa ser alterado para Aquecer, Resfriar ou HEATCOOL antes de alterar o modo Eco. |
O valor de resfriamento deve ser maior que o valor de aquecimento. | INVALID_ARGUMENT |
Verifique se o campo heatCelsius é menor que o campo coolCelsius no comando. |
O comando não é permitido com o termostato no modo MANUAL_ECO. | FAILED_PRECONDITION |
Não é possível definir a temperatura programada quando o termostato está no modo Eco manual. |
Consulte a Referência de código de erro da API para ver a lista completa de códigos de erro.