ThermostatEco 스키마

Nest Thermostat 

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 명령어를 사용하세요.

이 명령어는 에코 모드의 현재 상태 또는 변경사항에 따라 다른 특성에 영향을 미칩니다.

  • 절전 모드가 꺼져 있으면 온도 조절기 모드가 마지막으로 활성화된 표준 모드 (HEAT, COOL, HEATCOOL 또는 OFF)로 기본 설정됩니다.
  • 절전 모드가 MANUAL_ECO인 경우:

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 특성에 따라 온도 조절기 모드가 OFF일 때 절전 모드 변경을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 HEAT, COOL 또는 HEATCOOL로 변경해야 합니다.
온도 조절 장치가 MANUAL_ECO 모드에 있을 때는 명령이 허용되지 않습니다. FAILED_PRECONDITION 온도 조절기가 수동 절전 모드에 있으면 온도 설정값을 설정할 수 없습니다.

전체 API 오류 코드 목록은 API 오류 코드 참조를 확인하세요.