Giản đồ ThermostatNhiệt độSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Đặ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ợ đặt nhiệt độ mục tiêu và phạm vi nhiệt độ mục tiêu.
Các trường
Trường | Nội dung mô tả | Loại dữ liệu |
---|---|---|
heatCelsius |
Nhiệt độ mục tiêu theo độ C cho các chế độ SƯỞI ẤM và SƯỞI ẤM của máy điều nhiệt. | number Ví dụ: 20.0 |
coolCelsius |
Nhiệt độ mục tiêu theo độ C cho máy điều nhiệt ở chế độ COOL và HEATCOOL. | number Ví dụ: 22.0 |
Yêu cầu GET mẫu và phản hồi – 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 đang đượ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ụ: để 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 |
THOÁT | SetCool | coolCelsius |
SƯỞI ẤM | 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
{}
Trường yêu cầu SetHeat
Trường | Nội dung 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ế độ COOL.
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
{}
Trường yêu cầu SetCool
Trường | Nội dung 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ế độ HEATCOOL.
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
{}
Trường yêu cầu SetRange
Trường | Nội dung 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ế độ SƯỞI ẤM. | 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ế độ SƯỞI ẤM. | number Ví dụ: 22.0 |
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. |
Giá trị nhiệt độ làm mát phải lớn hơn giá trị nhiệt. | INVALID_ARGUMENT |
Hãy đảm bảo trường heatCelsius nhỏ hơn trường coolCelsius trong lệnh. |
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.