Esquema ThermostatEco
sdm.devices.traits.ThermostatEco
Essa característica pertence aos tipos de dispositivo de TERMOSTATO que oferecem suporte a modos ECO.
Campos
Campo | Descrição | Tipo de dados |
---|---|---|
availableModes |
Lista dos modos Eco compatíveis. | array(string) Valor: ["MANUAL_ECO", "OFF"] |
mode |
O modo Eco atual do termostato. | string Valores: "MANUAL_ECO", "OFF" |
heatCelsius |
É a temperatura mais baixa em Celsius em que o termostato inicia o aquecimento no modo Eco. | number Exemplo: 20.0 |
coolCelsius |
Temperatura máxima em graus Celsius em que o termostato começa a resfriar no modo Eco. | number Exemplo: 22.0 |
Exemplo de solicitação e resposta GET
Solicitação
GET /enterprises/project-id/devices/device-id
Resposta
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatEco
" : {
"availableModes" : ["MANUAL_ECO", "OFF"],
"mode" : "MANUAL_ECO",
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Comandos
SetMode
Mudar o modo Eco do termostato.
Para mudar o modo do termostato para HEAT, COOL ou HEATCOOL, use o comando SetMode da característica ThermostatMode.
Esse comando afeta outras características com base no status atual ou nas mudanças no modo Eco:
- Se o modo Eco estiver DESLIGADO, o modo do termostato vai usar o último modo padrão (HEAT, COOL, HEATCOOL ou OFF) que estava ativo.
- Se o modo Eco for MANUAL_ECO:
- Os comandos para o recurso ThermostatTemperatureSetpoint são rejeitados.
- As temperaturas programadas não são retornadas pela característica ThermostatTemperatureSetpoint .
Solicitação e resposta SetMode
Solicitação
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
Resposta
{}
Campos de solicitação SetMode
Campo | Descrição | Tipo de dados |
---|---|---|
mode |
O modo Eco para o qual o termostato será alterado. | string Valores: "MANUAL_ECO", "OFF" |
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 atual do termostato. | FAILED_PRECONDITION |
Alguns modelos de termostato não são compatíveis com a mudança do modo Eco quando o modo do termostato está DESLIGADO, de acordo com o atributo ThermostatMode . O modo do termostato precisa ser mudado para AQUECER, RESFRIAR ou AQUECER/RESFRIAR antes de mudar para o modo Eco. |
O comando não é permitido quando o termostato está no modo MANUAL_ECO. | FAILED_PRECONDITION |
Não é possível definir o ponto de ajuste de temperatura quando o termostato está no modo Eco manual. |
Consulte a Referência de códigos de erro da API para conferir a lista completa de códigos de erro da API.