ThermostatTemperatureSetpoint Şeması
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 gereken 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ştirilmeden ö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ı değiştirilemez. |
Aşağıdakiler için API Hata Kodu Referansı'na bakın: API hata kodlarının tam listesini inceleyin.