Skema ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Sifat ini termasuk dalam jenis perangkat THERmostAT yang mendukung setelan suhu dan rentang suhu target.
Kolom
Kolom | Deskripsi | Jenis Data |
---|---|---|
heatCelsius |
Targetkan suhu dalam Celsius untuk mode HEAT dan HEATCOOL termostat. | number Contoh: 20.0 |
coolCelsius |
Targetkan suhu dalam Celsius untuk mode COOL dan HEATCOOL termostat. | number Contoh: 22.0 |
Contoh permintaan dan respons GET - HEAT
Permintaan
GET /enterprises/project-id/devices/device-id
Respons
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
Contoh permintaan dan respons GET - COOL
Permintaan
GET /enterprises/project-id/devices/device-id
Respons
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"coolCelsius" : 22.0
}
}
}
Contoh permintaan dan respons GET - HEATCOOL
Permintaan
GET /enterprises/project-id/devices/device-id
Respons
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Perintah
Termostat harus dalam mode yang sesuai dengan perintah yang dipanggil sebelum pengubahan titik penyetelan suhu. Perintah dan kolom untuk mengubah setpoint bervariasi menurut termostat mode.
Misalnya, untuk menerbitkan SetHeat termostat harus berada dalam mode HEAT terlebih dahulu:
Mode | Perintah | Kolom |
---|---|---|
Hangat | SetHeat | heatCelsius |
KEREN | SetCool | coolCelsius |
{i>HEATCOOL<i} | SetRange | heatCelsius , coolCelsius |
Perhatikan bahwa perintah {i>setpoint<i} hanya mengambil derajat dalam Celcius sebagai parameter, meskipun Google Nest Thermostat dapat menampilkan suhu dalam derajat Celsius atau Fahrenheit.
SetHeat
Menetapkan suhu target saat termostat dalam mode HEAT.
Permintaan dan respons SetHeat
Permintaan
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat
",
"params" : {
"heatCelsius" : 22.0
}
}
Respons
{}
Kolom permintaan SetHeat
Kolom | Deskripsi | Jenis Data |
---|---|---|
heatCelsius |
Suhu target yang akan disetel saat termostat dalam mode HEAT. | number Contoh: 22.0 |
SetCool
Menyetel suhu target saat termostat dalam mode COOL.
Permintaan dan respons SetCool
Permintaan
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
Respons
{}
Kolom permintaan SetCool
Kolom | Deskripsi | Jenis Data |
---|---|---|
coolCelsius |
Suhu target yang akan disetel saat termostat dalam mode COOL. | number Contoh: 20.0 |
SetRange
Menyetel suhu minimum dan maksimum saat termostat dalam mode HEATCOOL.
Permintaan dan respons SetRange
Permintaan
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange
",
"params" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
Respons
{}
Kolom permintaan SetRange
Kolom | Deskripsi | Jenis Data |
---|---|---|
heatCelsius |
Suhu target minimum yang akan disetel saat termostat dalam mode HEATCOOL. | number Contoh: 20.0 |
coolCelsius |
Suhu target maksimum yang akan disetel saat termostat dalam mode HEATCOOL. | number Contoh: 22.0 |
Error
Kode error berikut mungkin ditampilkan sehubungan dengan fitur ini:
Pesan Error | PPK | Pemecahan masalah |
---|---|---|
Perintah tidak diizinkan dalam mode termostat saat ini. | FAILED_PRECONDITION |
Beberapa model termostat tidak mendukung perubahan mode Hemat Energi saat mode termostat NONAKTIF, sesuai dengan karakteristik ThermostatMode . Mode termostat harus diubah ke HEAT, COOL, atau HEATCOOL sebelum mengubah mode Hemat Energi. |
Nilai dingin harus lebih besar dari nilai panas. | INVALID_ARGUMENT |
Pastikan kolom heatCelsius lebih kecil dari kolom coolCelsius di perintah Anda. |
Perintah tidak diizinkan saat termostat dalam mode MANUAL_ECO. | FAILED_PRECONDITION |
Titik penyetelan suhu tidak dapat disetel saat termostat dalam mode Hemat Energi manual. |
Lihat Referensi Kode Error API untuk daftar lengkap kode error API.