Lược đồ ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Đặc điểm này thuộc về các loại thiết bị THERMOSTAT (MÁY ĐIỀU NHIỆT) hỗ trợ việc đặt nhiệt độ mục tiêu và phạm vi nhiệt độ.

Trường

Trường Mô tả Loại dữ liệu
heatCelsius Nhiệt độ mục tiêu theo độ C cho chế độ SƯỞI ẤM và SƯỞI ẤM LÀM MÁT của máy điều nhiệt. number
Ví dụ: 20.0
coolCelsius Nhiệt độ mục tiêu theo độ C cho các chế độ LÀM MÁT và SƯỞI ẤM LÀM MÁT của máy điều nhiệt. number
Ví dụ: 22.0

Yêu cầu và phản hồi GET mẫu – HEAT

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.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Yêu cầu và phản hồi GET mẫu – COOL

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.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Yêu cầu và phản hồi GET mẫu – HEATCOOL

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.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Lệnh

Máy điều nhiệt phải ở chế độ tương ứng với lệnh được gọi trước khi thay đổi điểm đặt nhiệt độ. Lệnh và(các) trường để thay đổi(các) điểm đặt sẽ khác nhau tuỳ theo chế độ của máy điều nhiệt.

Ví dụ: để đưa ra lệnh SetHeat, trước tiên, máy điều nhiệt phải ở chế độ SƯỞI ẤM:

Chế độ Lệnh (Các) trường
BỔ SUNG SetHeat heatCelsius
LÀM MÁT SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Xin lưu ý rằng các lệnh điểm đặt chỉ lấy độ C làm tham số, mặc dù Google Nest Thermostat có thể hiển thị nhiệt độ theo độ C hoặc độ F.

SetHeat

Đặt nhiệt độ mục tiêu khi máy điều nhiệt ở chế độ SƯỞI ẤM.

Yêu cầu và phản hồi SetHeat

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Phản hồi

{}

Các trường yêu cầu SetHeat

Trường Mô tả Loại dữ liệu
heatCelsius Nhiệt độ mục tiêu cần đặt khi máy điều nhiệt ở chế độ SƯỞI ẤM. number
Ví dụ: 22.0

SetCool

Đặt nhiệt độ mục tiêu khi máy điều nhiệt ở chế độ LÀM MÁT.

Yêu cầu và phản hồi SetCool

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

Phản hồi

{}

Đặt các trường yêu cầu SetCool

Trường Mô tả Loại dữ liệu
coolCelsius Nhiệt độ mục tiêu cần đặt khi máy điều nhiệt ở chế độ LÀM MÁT. number
Ví dụ: 20.0

SetRange

Đặt nhiệt độ tối thiểu và tối đa khi máy điều nhiệt ở chế độ SƯỞI ẤM VÀ LÀM MÁT.

Yêu cầu và phản hồi SetRange

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

Phản hồi

{}

Các trường yêu cầu SetRange

Trường Mô tả Loại dữ liệu
heatCelsius Nhiệt độ mục tiêu tối thiểu cần đặt khi máy điều nhiệt ở chế độ HEATCOOL. number
Ví dụ: 20.0
coolCelsius Nhiệt độ mục tiêu tối đa cần đặt khi máy điều nhiệt ở chế độ HEATCOOL. number
Ví dụ: 22.0

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 được phép dùng lệnh này ở chế độ hiện tại của máy điều nhiệt. 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 là TẮT, theo đặc điểm ThermostatMode . Bạn phải thay đổi chế độ của máy điều nhiệt thành HEAT, COOL hoặc HEATCOOL trước khi thay đổi chế độ Tiết kiệm năng lượng.
Giá trị làm mát phải lớn hơn giá trị sưởi ấm. INVALID_ARGUMENT Đảm bảo rằng trường heatCelsius nhỏ hơn trường coolCelsius trong lệnh của bạn.
Không được phép dùng 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 ở 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.