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 có 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 bằng độ C khi máy điều nhiệt bắt đầu sưởi ấm ở chế độ Tiết kiệm năng lượng. | 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 |
Phản hồi và yêu cầu 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, COOL hoặc HEATCOOL, hãy dùng lệnh SetMode của trait ThermostatMode.
Lệnh này tác độ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 năng lượng:
- Nếu bạn TẮT chế độ Tiết kiệm năng lượng, thì chế độ máy điều nhiệt sẽ ở chế độ tiêu chuẩn gần đây nhất (SƯỞI ẤM, LÀM MÁT, SƯỞI ẤM hoặc TẮT) đang hoạt động.
- Nếu chế độ Tiết kiệm năng lượng là MANUAL_ECO:
- Các lệnh cho tính năng ThermostatNhiệtSetpoint bị từ chối.
- Các điểm đặt nhiệt độ không được trả về theo trait 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
{}
Trường yêu cầu SetMode
Trường | Mô tả | Loại dữ liệu |
---|---|---|
mode |
Bạn có thể chuyển máy điều nhiệt sang Chế độ Tiết kiệm năng lượng. | 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 chuyển máy điều nhiệt thành SƯỞI ẤM, LÀM MÁT hoặc SƯỞI ẤM trước khi chuyển sang chế độ Tiết kiệm năng lượng. |
Không được phép dùng 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 năng lượng 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.