สคีมา ThermostatEco
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 ไม่แสดงผลค่าอุณหภูมิที่กำหนด
คำขอและการตอบกลับ 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