สคีมา ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

ลักษณะการทำงานนี้เป็นของอุปกรณ์ประเภท THERMOSTAT ที่รองรับโหมดอีโค

ช่อง

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

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

  • หากโหมดอีโคเป็น OFF โหมดตัวควบคุมอุณหภูมิจะเปลี่ยนเป็นโหมดมาตรฐานล่าสุด (HEAT, COOL, HEATCOOL หรือ OFF) ที่ใช้งานอยู่โดยค่าเริ่มต้น
  • หากโหมดอีโคเป็น 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
Values: "MANUAL_ECO", "OFF"

ข้อผิดพลาด

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

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

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