Giản đồ ThermostatEco

Máy điều nhiệt Nest 

sdm.devices.traits.ThermostatEco

Đặc điểm này thuộc các loại thiết bị của MÁY ĐIỀU NHIỆT có hỗ trợ các chế độ Tiết kiệm năng lượng.

Các trường

Trường Nội dung 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 ở độ C mà 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 (độ C) mà 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 GET mẫu và phản hồi

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ế độ của máy điều nhiệt thành HEAT, COOL hoặc HEATCOOL, hãy sử 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 của chế độ Tiết kiệm năng lượng:

  • Nếu chế độ Tiết kiệm năng lượng đang TẮT, thì theo mặc định, chế độ dành cho máy điều nhiệt sẽ chuyển sang chế độ tiêu chuẩn gần đây nhất (SƯỞI ẤM, MỞ RỘNG, 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:

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 Nội dung 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

Liên quan đến đặc điểm này, có thể trả về(các) mã lỗi sau:

Thông báo lỗi RPC Khắc phục sự cố
Không cho phép 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 đang TẮT, theo thuộc tính ThermostatMode . Bạn phải thay đổi chế độ của 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 ra lệnh khi máy điều nhiệt ở chế độ MANUAL_ECO. FAILED_PRECONDITION Bạn không thể đặt điểm đặt nhiệt độ khi máy điều nhiệt đang ở 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.