Skema ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Sifat ini termasuk dalam jenis perangkat THERMOSTAT yang mendukung setelan suhu target dan rentang suhu.

Kolom

Kolom Deskripsi Jenis Data
heatCelsius Suhu target dalam derajat Celsius untuk mode PANAS dan PANAS-DINGIN termostat. number
Contoh: 20,0
coolCelsius Suhu target dalam derajat Celsius untuk mode COOL dan HEATCOOL termostat. number
Contoh: 22,0

Contoh permintaan dan respons GET - HEAT

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

Contoh permintaan dan respons GET - COOL

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

Contoh permintaan dan respons GET - HEATCOOL

PermintaanRespons
GET /enterprises/project-id/devices/device-id
 
{
  "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 mengubah titik setel suhu. Perintah dan kolom untuk mengubah titik penyetelan bervariasi menurut mode termostat.

Misalnya, untuk mengeluarkan perintah SetHeat, termostat harus dalam mode HEAT terlebih dahulu:

Mode Perintah Kolom
PANAS SetHeat heatCelsius
SEJUK SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Perhatikan bahwa perintah setpoint hanya menggunakan derajat dalam Celsius sebagai parameter, meskipun Google Nest Thermostat dapat menampilkan suhu dalam derajat Celsius atau Fahrenheit.

SetHeat

Menetapkan suhu target saat termostat dalam mode PANAS.

Permintaan dan respons SetHeat

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

{}

Menetapkan kolom permintaan SetHeat

Kolom Deskripsi Jenis Data
heatCelsius Suhu target yang akan disetel saat termostat dalam mode PANAS. number
Contoh: 22,0

SetCool

Menetapkan suhu target saat termostat dalam mode SEJUK.

Permintaan dan respons SetCool

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

{}

Kolom permintaan SetCool

Kolom Deskripsi Jenis Data
coolCelsius Suhu target yang akan disetel saat termostat dalam mode SEJUK. number
Contoh: 20,0

SetRange

Menetapkan suhu minimum dan maksimum saat termostat berada dalam mode HEATCOOL.

Permintaan dan respons SetRange

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

{}

Kolom permintaan SetRange

Kolom Deskripsi Jenis Data
heatCelsius Suhu target minimum yang akan ditetapkan saat termostat berada dalam mode HEATCOOL. number
Contoh: 20,0
coolCelsius Suhu target maksimum yang akan ditetapkan saat termostat berada dalam mode HEATCOOL. number
Contoh: 22,0

Error

Kode error berikut dapat ditampilkan sehubungan dengan karakteristik 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 sifat 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 kurang dari kolom coolCelsius dalam perintah Anda.
Perintah tidak diizinkan saat termostat dalam mode MANUAL_ECO. FAILED_PRECONDITION Setpoint suhu tidak dapat disetel saat termostat berada dalam mode Hemat Energi manual.

Lihat Referensi Kode Error API untuk mengetahui daftar lengkap kode error API.