ThermostatEco 스키마
sdm.devices.traits.ThermostatEco
이 특성은 ECO 모드를 지원하는 온도 조절기의 기기 유형에 속합니다.
필드
필드 | 설명 | 데이터 유형 |
---|---|---|
availableModes |
지원되는 절전 모드 목록입니다. | array(string) 값: ["MANUAL_ECO", "OFF"] |
mode |
온도 조절기의 현재 절전 모드입니다. | string 값: 'MANUAL_ECO', 'OFF' |
heatCelsius |
절전 모드에서 온도 조절기가 난방을 시작하는 최저 온도(섭씨)입니다. | number 예: 20.0 |
coolCelsius |
절전 모드에서 온도 조절기가 냉방을 시작하는 최고 온도(섭씨) | number 예: 22.0 |
샘플 GET 요청 및 응답
요청
GET /enterprises/project-id/devices/device-id
응답
{
"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
}
}
}
명령어
SetMode
온도 조절기 절전 모드를 변경합니다.
온도 조절기 모드를 HEAT, COOL 또는 HEATCOOL로 변경하려면 ThermostatMode 트레잇의 SetMode 명령어를 사용합니다.
이 명령은 절전 모드의 현재 상태 또는 변경에 따라 다른 특성에 영향을 미칩니다.
- 절전 모드가 꺼져 있는 경우 온도 조절기는 작동 중이었던 마지막 표준 모드 (난방, 냉방, 난방 또는 꺼짐)로 기본 설정됩니다.
- 절전 모드가 MANUAL_ECO인 경우:
- ThermostatTemperatureSetpoint 특성의 명령어가 거부됩니다.
- 온도 설정값은 ThermostatTemperatureSetpoint 특성에서 반환되지 않습니다.
SetMode 요청 및 응답
요청
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
응답
{}
SetMode 요청 필드
필드 | 설명 | 데이터 유형 |
---|---|---|
mode |
온도 조절기를 변경할 절전 모드입니다. | string 값: 'MANUAL_ECO', 'OFF' |
오류
이 트레잇과 관련하여 다음 오류 코드가 반환될 수 있습니다.
오류 메시지 | RPC | 문제 해결 |
---|---|---|
현재 온도 조절기 모드에서는 명령을 사용할 수 없습니다. | FAILED_PRECONDITION |
ThermostatMode 특성에 따라 일부 온도 조절기 모델은 온도 조절기 모드가 꺼져 있을 때 절전 모드 변경을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 난방, 냉방 또는 난방으로 변경해야 합니다. |
온도 조절기가 MANUAL_ECO 모드일 때는 명령어가 허용되지 않습니다. | FAILED_PRECONDITION |
온도 조절기가 수동 절전 모드일 때는 온도 설정값을 설정할 수 없습니다. |
API 오류 코드의 전체 목록은 API 오류 코드 참조를 확인하세요.