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 명령어를 사용합니다.

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

  • 절전 모드가 꺼져 있는 경우 온도 조절기는 작동 중이었던 마지막 표준 모드 (난방, 냉방, 난방 또는 꺼짐)로 기본 설정됩니다.
  • 절전 모드가 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 특성에 따라 일부 온도 조절기 모델은 온도 조절기 모드가 꺼져 있을 때 절전 모드 변경을 지원하지 않습니다. 절전 모드를 변경하기 전에 온도 조절기 모드를 난방, 냉방 또는 난방으로 변경해야 합니다.
온도 조절기가 MANUAL_ECO 모드일 때는 명령어가 허용되지 않습니다. FAILED_PRECONDITION 온도 조절기가 수동 절전 모드일 때는 온도 설정값을 설정할 수 없습니다.

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