Skema ThermostatTemperatureSetpoint

Nest Thermostat 

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.