ThermostatTemperatureSetpoint Şeması

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Bu özellik, hedef sıcaklık ve sıcaklık aralığı ayarını destekleyen TERMOSTAT cihaz türlerine aittir.

Alanlar

Alan Açıklama Veri Türü
heatCelsius Termostat HEAT ve HEATCOOL modları için Santigrat cinsinden hedef sıcaklık. number
Örnek: 20,0
coolCelsius Termostat SOĞUTMA ve ISITMASOĞUTMA modları için santigrat derece cinsinden hedef sıcaklık. number
Örnek: 22,0

Örnek GET isteği ve yanıtı - HEAT

İstek

GET /enterprises/project-id/devices/device-id

Yanıt

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Örnek GET isteği ve yanıtı - COOL

İstek

GET /enterprises/project-id/devices/device-id

Yanıt

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Örnek GET isteği ve yanıtı - HEATCOOL

İstek

GET /enterprises/project-id/devices/device-id

Yanıt

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Komutlar

Sıcaklık ayar noktaları değiştirilmeden önce termostat, çağrılan komuta karşılık gelen modda olmalıdır. Ayar noktalarını değiştirmek için kullanılan komut ve alanlar, termostat moduna göre değişir.

Örneğin, SetHeat komutunu göndermek için termostatın önce ISITMA modunda olması gerekir:

Mod Komut Alanlar
ISITMA SetHeat heatCelsius
SOĞUK SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Google Nest Thermostat sıcaklığı santigrat veya fahrenhayt cinsinden gösterse de ayar noktası komutlarının parametre olarak yalnızca santigrat dereceyi kabul ettiğini unutmayın.

SetHeat

Termostat ISITMA modundayken hedef sıcaklığı ayarlar.

SetHeat isteği ve yanıtı

İstek

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Yanıt

{}

SetHeat istek alanları

Alan Açıklama Veri Türü
heatCelsius Termostat ISITMA modundayken ayarlanacak hedef sıcaklık. number
Örnek: 22,0

SetCool

Termostat SOĞUTMA modundayken hedef sıcaklığı ayarlar.

SetCool isteği ve yanıtı

İstek

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

Yanıt

{}

SetCool istek alanları

Alan Açıklama Veri Türü
coolCelsius Termostat SOĞUTMA modundayken ayarlanacak hedef sıcaklık. number
Örnek: 20,0

SetRange

Termostat ISITMASÜRÜĞE Modu'ndayken minimum ve maksimum sıcaklıkları belirler.

SetRange isteği ve yanıtı

İstek

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

Yanıt

{}

SetRange istek alanları

Alan Açıklama Veri Türü
heatCelsius Termostat HEATCOOL modundayken ayarlanacak minimum hedef sıcaklık. number
Örnek: 20,0
coolCelsius Termostat HEATCOOL modundayken ayarlanacak maksimum hedef sıcaklık. number
Örnek: 22,0

Hatalar

Bu özellikle ilgili olarak aşağıdaki hata kodları döndürülebilir:

Hata Mesajı TBG Sorun giderme
Mevcut termostat modunda komuta izin verilmiyor. FAILED_PRECONDITION Bazı termostat modelleri, ThermostatMode özelliğine göre termostat modu KAPALI iken Eko modunun değiştirilmesini desteklemez. Eko modu değiştirilmeden önce termostat modu ISITMA, SOĞUTMA veya ISITMASOGUTMA olarak değiştirilmelidir.
Soğutma değeri, ısıtma değerinden büyük olmalıdır. INVALID_ARGUMENT heatCelsius alanının, komutunuzdaki coolCelsius alanından küçük olduğundan emin olun.
Termostat MANUAL_ECO modundayken komuta izin verilmez. FAILED_PRECONDITION Termostat manuel Eko modundayken sıcaklık ayar noktası ayarlanamaz.

API hata kodlarının tam listesi için API Hata Kodu Referansı'na bakın.