Giản đồ ThermostatEco
sdm.devices.traits.ThermostatEco
Đặc điểm này thuộc về các loại thiết bị của MÁY ĐIỀU NHIỆT hỗ trợ các chế độ ECO.
Trường
Trường | Mô tả | Loại dữ liệu |
---|---|---|
availableModes |
Danh sách các chế độ Tiết kiệm năng lượng được hỗ trợ. | array(string) Giá trị: ["MANUAL_ECO", "OFF"] |
mode |
Chế độ Tiết kiệm năng lượng hiện tại của máy điều nhiệt. | string Giá trị: "MANUAL_ECO", "OFF" |
heatCelsius |
Nhiệt độ thấp nhất tính theo độ C mà máy điều nhiệt bắt đầu sưởi ấm ở chế độ Tiết kiệm điện. | number Ví dụ: 20.0 |
coolCelsius |
Nhiệt độ cao nhất tính bằng độ C khi máy điều nhiệt bắt đầu làm mát ở chế độ Tiết kiệm năng lượng. | number Ví dụ: 22.0 |
Yêu cầu và phản hồi GET mẫu
Yêu cầu
GET /enterprises/project-id/devices/device-id
Phản hồi
{
"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
}
}
}
Lệnh
SetMode
Thay đổi chế độ Tiết kiệm năng lượng của máy điều nhiệt.
Để thay đổi chế độ máy điều nhiệt thành HEAT (Sưởi ấm), COOL (Làm mát) hoặc HEATCOOL (Sưởi ấm – Làm mát), hãy sử dụng lệnh SetMode của thuộc tính ThermostatMode.
Lệnh này ảnh hưởng đến các đặc điểm khác, dựa trên trạng thái hiện tại hoặc các thay đổi đối với chế độ Tiết kiệm pin:
- Nếu chế độ Tiết kiệm năng lượng đang TẮT, thì chế độ máy điều nhiệt sẽ mặc định là chế độ tiêu chuẩn gần đây nhất (SƯỞI, LÀM MÁT, SƯỞI LÀM MÁT hoặc TẮT) đang hoạt động.
- Nếu chế độ Tiết kiệm là MANUAL_ECO:
- Các lệnh cho thuộc tính ThermostatTemperatureSetpoint bị từ chối.
- Điểm đặt nhiệt độ không được trả về bởi thuộc tính ThermostatTemperatureSetpoint .
Yêu cầu và phản hồi SetMode
Yêu cầu
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
Phản hồi
{}
Các trường yêu cầu SetMode
Trường | Mô tả | Loại dữ liệu |
---|---|---|
mode |
Chế độ Tiết kiệm năng lượng để chuyển máy điều nhiệt sang. | string Giá trị: "MANUAL_ECO", "OFF" |
Lỗi
(Các) mã lỗi sau đây có thể được trả về liên quan đến đặc điểm này:
Thông báo Lỗi | RPC | Khắc phục sự cố |
---|---|---|
Không dùng được lệnh ở chế độ máy điều nhiệt hiện tại. | FAILED_PRECONDITION |
Một số mẫu máy điều nhiệt không hỗ trợ thay đổi chế độ Tiết kiệm năng lượng khi chế độ máy điều nhiệt TẮT, theo tính năng ThermostatMode . Bạn phải thay đổi chế độ máy điều nhiệt thành SƯỞI, LÀM MÁT hoặc SƯỞI LÀM MÁT trước khi thay đổi chế độ Tiết kiệm năng lượng. |
Không được phép thực hiện lệnh khi máy điều nhiệt ở chế độ MANUAL_ECO. | FAILED_PRECONDITION |
Không thể đặt điểm đặt nhiệt độ khi máy điều nhiệt ở chế độ Tiết kiệm điện thủ công. |
Hãy xem Tài liệu tham khảo về mã lỗi API để biết danh sách đầy đủ các mã lỗi API.