ThermostatTemperatureSetpoint Şeması

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Bu özellik, hedef sıcaklık ve sıcaklık aralığının ayarlanmasını destekleyen TERARAlet 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ın COOL ve HEATCOOL modları için Santigrat 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

Termostat, değiştirilmeden önce çağrılan komuta karşılık gelen modda olmalıdır istenen sıcaklık ayarlarını yapacaksınız. Ayar noktalarını değiştirmek için kullanılacak komut ve alanlar termostata göre değişir yatırım yapmanız önemlidir.

Örneğin, SetHeat komutuyla birlikte termostatın öncelikle ısıtma modunda olması gerekir:

Mod Komut Alanlar
ISITMA SetHeat heatCelsius
SÜPER SetCool coolCelsius
ISITMA Soğutma SetRange heatCelsius, coolCelsius

Ayar noktası komutlarının parametre olarak yalnızca Santigrat cinsinden derece aldığını unutmayın. Ancak Google Nest Thermostat, sıcaklığı Santigrat veya Fahrenhayt olarak gösterebilir.

SetHeat

Termostat, ısıtma 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, ısıtma 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, HEATCOOL modundayken minimum ve maksimum sıcaklıkları ayarlar.

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, Termostat Modu özelliğine göre termostat modu KAPALI olduğunda Eko modunun değiştirilmesini desteklemez. Eko modu değişmeden önce termostat modu HEAT, COOL veya HEATCOOL 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 bu komuta izin verilmez. FAILED_PRECONDITION Termostat, manuel Eko modundayken istenen sıcaklık ayarı ayarlanamaz.

Aşağıdakiler için API Hata Kodu Referansı'na bakın: API hata kodlarının tam listesini inceleyin.