طرحواره نقطه تنظیم دما ترموستات

ترموستات نست

sdm.devices.traits.ThermostatTemperatureSetpoint

این ویژگی متعلق به انواع دستگاه‌های ترموستات است که از تنظیم دمای هدف و محدوده دما پشتیبانی می‌کنند.

فیلدها

نمونه درخواست و پاسخ GET - HEAT

GET /enterprises/project-id/devices/device-id

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

نمونه درخواست و پاسخ GET - عالی

GET /enterprises/project-id/devices/device-id

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

نمونه درخواست و پاسخ GET - HEATCOOL

GET /enterprises/project-id/devices/device-id

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

دستورات

ترموستات باید قبل از تغییر نقاط تنظیم دما، در حالتی باشد که با دستوری که فراخوانی می‌شود مطابقت داشته باشد. دستور و فیلد(های) لازم برای تغییر نقطه(های) تنظیم، بسته به حالت ترموستات متفاوت است.

برای مثال، برای صدور دستور SetHeat، ترموستات ابتدا باید در حالت HEAT باشد:

توجه داشته باشید که دستورات نقطه تنظیم فقط درجه سانتیگراد را به عنوان پارامتر در نظر می‌گیرند، اگرچه ترموستات Google Nest می‌تواند دما را هم بر حسب سانتیگراد و هم بر حسب فارنهایت نمایش دهد.

تنظیم گرما

دمای هدف را هنگامی که ترموستات در حالت HEAT است، تنظیم می‌کند.

درخواست و پاسخ SetHeat

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

{}

فیلدهای درخواست SetHeat

ست کول

دمای هدف را هنگامی که ترموستات در حالت خنک کننده (COOL) است، تنظیم می‌کند.

درخواست و پاسخ SetCool

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

{}

فیلدهای درخواست SetCool

محدوده تنظیم

وقتی ترموستات در حالت HEATCOOL است، حداقل و حداکثر دما را تنظیم می‌کند.

درخواست و پاسخ SetRange

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

{}

فیلدهای درخواست SetRange

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

برای مشاهده لیست کامل کدهای خطای API به مرجع کدهای خطای API مراجعه کنید.