สคีมา ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

ลักษณะนี้เป็นของประเภทอุปกรณ์ตัวควบคุมอุณหภูมิที่รองรับโหมดอีโค

ช่อง

ช่อง	คำอธิบาย	ประเภทข้อมูล
availableModes	รายการโหมดอีโคที่รองรับ	array(string) ค่า: ["MANUAL_ECO", "OFF"]
mode	โหมดอีโคปัจจุบันของตัวควบคุมอุณหภูมิ	string ค่า: "MANUAL_ECO", "OFF"
heatCelsius	อุณหภูมิต่ำสุดในหน่วยเซลเซียสที่ตัวควบคุมอุณหภูมิเริ่มทำความร้อนในโหมดอีโค	number ตัวอย่าง: 20.0
coolCelsius	อุณหภูมิสูงสุดในหน่วยเซลเซียสที่ตัวควบคุมอุณหภูมิเริ่มทำความเย็นในโหมดอีโค	number ตัวอย่าง: 22.0

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

ส่งคำขอ

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

คำตอบ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

คำสั่ง

SetMode

เปลี่ยนโหมดอีโคของตัวควบคุมอุณหภูมิ

หากต้องการเปลี่ยนโหมดตัวควบคุมอุณหภูมิเป็น HEAT, COOL หรือ HEATCOOL ให้ใช้คำสั่ง SetMode ของลักษณะ ThermostatMode

คำสั่งนี้จะส่งผลต่อลักษณะอื่นๆ ตามสถานะปัจจุบันของหรือการเปลี่ยนแปลงในโหมดอีโค

• หากโหมดอีโคปิดอยู่ โหมดตัวควบคุมอุณหภูมิจะใช้ค่าเริ่มต้นเป็นโหมดมาตรฐานล่าสุด (ทำความร้อน ทำความเย็น ทำความร้อน หรือปิด) ที่ใช้งานอยู่
• หากโหมดอีโคคือ MANUAL_ECO:
• คำสั่งสำหรับลักษณะ ThermostatTemperatureSetpoint ถูกปฏิเสธ
• ระบบจะไม่แสดงผลค่าอุณหภูมิที่กำหนดโดยลักษณะ ThermostatTemperatureSetpoint

ตัวควบคุมอุณหภูมิบางรุ่นไม่รองรับการเปลี่ยนโหมดอีโคเมื่อโหมดตัวควบคุมอุณหภูมิปิดอยู่ โดยเป็นไปตามลักษณะ ThermostatMode ต้องเปลี่ยนเป็นโหมดตัวควบคุมอุณหภูมิเป็นทำความร้อน ทำความเย็น หรือทำความร้อน ก่อนที่จะเปลี่ยนโหมดอีโค

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

ส่งคำขอ

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

คำตอบ

{}

ช่องคำขอ SetMode

ช่อง	คำอธิบาย	ประเภทข้อมูล
mode	โหมดอีโคที่จะเปลี่ยนตัวควบคุมอุณหภูมิ	string ค่า: "MANUAL_ECO", "OFF"

ข้อผิดพลาด

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

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

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