สคีมา ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

คุณสมบัตินี้เป็นของอุปกรณ์ประเภทตัวควบคุมอุณหภูมิที่รองรับการตั้งค่าอุณหภูมิและช่วงอุณหภูมิเป้าหมาย

ช่อง

ช่อง คำอธิบาย ประเภทข้อมูล
heatCelsius อุณหภูมิเป้าหมายเป็นเซลเซียสสำหรับโหมด HEAT และ HEATCOOL ของตัวควบคุมอุณหภูมิ number
ตัวอย่าง: 20.0
coolCelsius อุณหภูมิเป้าหมายเป็นเซลเซียสสำหรับโหมด COOL และ HEATCOOL ของตัวควบคุมอุณหภูมิ number
ตัวอย่าง: 22.0

ตัวอย่างคำขอและการตอบกลับ GET - HEAT

ส่งคำขอ

GET /enterprises/project-id/devices/device-id

คำตอบ

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

ตัวอย่างคำขอและการตอบกลับ GET - COOL

ส่งคำขอ

GET /enterprises/project-id/devices/device-id

คำตอบ

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

ตัวอย่างคำขอและการตอบกลับ GET - HEATCOOL

ส่งคำขอ

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
    }
  }
}

คำสั่ง

ตัวควบคุมอุณหภูมิต้องอยู่ในโหมดที่สอดคล้องกับคำสั่งที่เรียกใช้ก่อนที่จะเปลี่ยนแปลง อุณหภูมิที่กำหนด คำสั่งและฟิลด์สำหรับเปลี่ยนอุณหภูมิที่กำหนดแตกต่างกันไปตามตัวควบคุมอุณหภูมิ

ตัวอย่างเช่น ในการออก SetHeat ตัวควบคุมอุณหภูมิต้องอยู่ในโหมดทำความร้อนก่อน:

โหมด คำสั่ง ช่อง
เสริม SetHeat heatCelsius
เจ๋ง SetCool coolCelsius
ทำความร้อน SetRange heatCelsius coolCelsius

โปรดทราบว่าคำสั่ง setpoint จะใช้ค่าองศาเป็นเซลเซียสเป็นพารามิเตอร์เท่านั้น แม้ว่าฟังก์ชัน Google Nest Thermostat แสดงอุณหภูมิเป็นองศาเซลเซียสหรือฟาเรนไฮต์ได้

SetHeat

ตั้งอุณหภูมิเป้าหมายเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน

คำขอและการตอบกลับ SetHeat

ส่งคำขอ

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

คำตอบ

{}

ช่องคำขอ SetHeat

ช่อง คำอธิบาย ประเภทข้อมูล
heatCelsius อุณหภูมิเป้าหมายที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน number
ตัวอย่าง: 22.0

SetCool

ตั้งอุณหภูมิเป้าหมายเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมด COOL

คำขอและการตอบกลับ SetCool

ส่งคำขอ

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

คำตอบ

{}

ช่องคำขอ SetCool

ช่อง คำอธิบาย ประเภทข้อมูล
coolCelsius อุณหภูมิเป้าหมายที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมด COOL number
ตัวอย่าง: 20.0

SetRange

ตั้งอุณหภูมิต่ำสุดและสูงสุดเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน

คำขอและการตอบกลับ SetRange

ส่งคำขอ

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

คำตอบ

{}

ช่องคำขอ SetRange

ช่อง คำอธิบาย ประเภทข้อมูล
heatCelsius อุณหภูมิเป้าหมายขั้นต่ำที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน number
ตัวอย่าง: 20.0
coolCelsius อุณหภูมิเป้าหมายสูงสุดที่จะตั้งค่าเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดทำความร้อน number
ตัวอย่าง: 22.0

ข้อผิดพลาด

ระบบอาจแสดงรหัสข้อผิดพลาดต่อไปนี้ซึ่งเกี่ยวข้องกับลักษณะนี้

ข้อความแสดงข้อผิดพลาด RPC การแก้ปัญหา
ไม่อนุญาตให้ใช้คำสั่งในโหมดตัวควบคุมอุณหภูมิปัจจุบัน FAILED_PRECONDITION ตัวควบคุมอุณหภูมิบางรุ่นไม่รองรับการเปลี่ยนโหมดอีโคเมื่อโหมดตัวควบคุมอุณหภูมิปิดอยู่ตามลักษณะ ThermostatMode ต้องเปลี่ยนเป็นโหมดตัวควบคุมอุณหภูมิเป็นทำความร้อน ทำความเย็น หรือทำความร้อน ก่อนที่จะเปลี่ยนโหมดอีโค
ค่าความเย็นต้องมากกว่าค่าความร้อน INVALID_ARGUMENT ตรวจสอบว่าช่อง heatCelsius สั้นกว่าช่อง coolCelsius ในคำสั่ง
ไม่อนุญาตคำสั่งเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมด MANUAL_ECO FAILED_PRECONDITION ไม่สามารถตั้งอุณหภูมิที่กำหนดเมื่อตัวควบคุมอุณหภูมิอยู่ในโหมดอีโคด้วยตนเอง

ดูข้อมูลอ้างอิงรหัสข้อผิดพลาด API สำหรับ รายการรหัสข้อผิดพลาด API ทั้งหมด