ThermostatEco Schema
sdm.devices.traits.ThermostatEco
Esse traço pertence a tipos de dispositivos TERMOSTATO que oferecem suporte a modos ECO.
Campos
Campo | Descrição | Tipo de dados |
---|---|---|
availableModes |
Lista de modos econômicos 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 graus Celsius em que o termostato começa a aquecer no modo econômico. | number Exemplo: 20,0 |
coolCelsius |
A temperatura mais alta em Celsius em que o termostato começa a resfriar no modo econômico. | 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 outros traços com base no status atual ou nas mudanças no modo econômico:
- Se o modo Eco estiver DESATIVADO, o modo do termostato será definido como o último modo padrão (AQUECER, RESFRIAR, AQUECER • RESFRIAR ou DESATIVADO) que estava ativo.
- Se o modo Eco for MANUAL_ECO:
- Os comandos para o traço ThermostatTemperatureSetpoint são rejeitados.
- Os pontos de ajuste de temperatura não são retornados pela característica ThermostatTemperatureSetpoint .
Solicitação e resposta de 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 mudar o termostato. | string Valores: "MANUAL_ECO", "OFF" |
Erros
Os seguintes códigos de erro podem ser retornados em relação a esse traço:
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 permitem mudar o modo Eco quando o modo do termostato está DESATIVADO, de acordo com a característica ThermostatMode . O modo do termostato precisa ser mudado para AQUECER, RESFRIAR ou AQUECERRESFRIAR antes de mudar o modo econômico. |
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.