Перейти к содержанию

LightingArea🔗

Объект для управления и контроля уровня освещенности в световой зоне.

Топик🔗

Spread/{Topic_Type}/{Project_ID}/Equipment/LightingArea/{LightingArea_ID}/{Property}

Параметры топика🔗

Параметр Значение
Topic_Type Тип топика:
  • Set — топик изменения. Используется в запросах публикации (publish).
  • State — топик информации (статуса). Используется в запросах подписки (subscribe).
Project_ID ID проекта AWADA.
LightingArea_ID ID объекта
Property Свойство, которое нужно изменить (или узнать текущий статус). Возможные параметры:
  • Buttons — пресеты кнопок панелей управления
  • CurrentProfile — текущий профиль зоны
  • Discovery — включен или выключен режим обнаружения оборудования, входящего в зону освещения.
  • HoldTime — через какое время выключаются светильники, если в помещении никого нет (время задержки).
  • Hysteresis — гистерезис целевого уровня яркости (зона нечувствительности к изменению текущей яркости), в процентах от TargetLuminosity
  • Luminosity — текущая освещенность
  • OccupancyAction — действие при обнаружении движения
  • OccupancyLevel — уровень яркости при обнаружении движения
  • OccupancyScene — номер сцены, включаемой при обнаружении движения
  • On — включение или выключение световой зоны
  • Pause — редактирует ли сейчас кто-то настройки световой зоны
  • Presence — текущее наличие движения в зоне освещения
  • Profiles — настройки профилей световой зоны
  • TargetLuminosity — целевая освещенность
  • TuningSpeed — скорость подстройки яркости в зоне освещения (частота посылки команд светильникам)
  • TuningType — тип алгоритма подстройки яркости
  • VacancyAction — действие при отсутствии движения
  • VacancyLevel — уровень яркости при отсутствии движения
  • VacancyScene — номер сцены, включаемой при отсутствии движения

Описание свойств🔗

Свойство Тип Значения (value)
Buttons QJsonArray Допустимые значения:
{
"index": {Uint8},
"preset": {Uint8}
}
CurrentProfile Enum Допустимые значения:
  • Profile1
  • Profile2
  • Profile3
  • Profile4
  • Profile5
Discovery Bool
  • true — режим обнаружения включен
  • false — режим обнаружения выключен
HoldTime Uint8 От 0 до 2550 с
Hysteresis Uint8 От 0 до 100
Luminosity Uint16 От 0 до максимально возможного значения освещенности у датчика.
OccupancyAction Enum Допустимые значения:
  • LastLevel — предыдущая яркость
  • MaxLevel — максимальная яркость
  • Level — уровень яркости
  • Scene — сцена
OccupancyLevel Qreal От 0 до 100
OccupancyScene Uint8 От 0 до 255
On Bool
  • true — световая зона включена
  • false — световая зона выключена
Pause Bool
  • true — световая зона на паузе (автоматизация не работает, пользователь настраивает световую зону в клиентском приложении)
  • false — световая зона работает
Presence Bool
  • true — движение есть
  • false — движения нет
Profiles QJsonObject Допустимые значения:
{
"TuningType": {Enum},
"OccupancyLevel": {Qreal},
"VacancyLevel": {Qreal},
"TargetLuminosity": {Uint16},
"Hysteresis": {Uint8},
"TuningSpeed": {Qreal},
"OccupancyAction": {Enum},
"OccupancyScene": {Uint8},
"VacancyAction": {Enum},
"VacancyScene": {Uint8},
"HoldTime": {Uint8},
"OccupancySceneLevels": [{"id": {Uint32 (DaliDimmerID)}, "level": {Uint8}}, {"id": {Uint32 (DaliDimmerID)}, "level": {Uint8}}],
"VacancySceneLevels": [{"id": {Uint32 (DaliDimmerID)}, "level": {Uint8}}, {"id": {Uint32 (DaliDimmerID)}, "level": {Uint8}}]
}
TargetLuminosity Uint16 От 0 до максимально возможного значения освещенности у датчика.
TuningSpeed Qreal От 0 до 5000 мс
TuningType Enum Допустимые значения:
  • Combo — комбинированный (яркость регулируется с помощью датчиков освещенности и присутствия)
  • Presence — яркость регулируется только по датчику присутствия
  • Luminosity — яркость регулируется только по датчику освещенности
  • Idle — не задан
VacancyAction Enum Допустимые значения:
  • MinLevel — минимальная яркость
  • Off — выключение
  • Level — уровень яркости
  • Scene — сцена
VacancyLevel Qreal От 0 до 100
VacancyScene Uint8 От 0 до 15

Примеры🔗

Публикация🔗

Установить:

  • для первого профиля — комбинированный алгоритм и целевую освещенность 55;
  • для второго профиля — гистерезис 10%.

Spread/Set/1315/Equipment/LightingArea/395447/Profiles

{
  "value": {
    "Profile1": {
      "TuningType": "Combo",
      "TargetLuminosity": 55
    },
    "Profile2": {
      "Hysteresis": 10
    }
  }
}

Подписка🔗

Узнать текущие настройки профилей световой зоны:

Spread/State/1315/Equipment/LightingArea/395447/Profiles

Пример ответа:

 {
  "value": {
    "Profile1": {
      "TuningType": "Combo",
      "OccupancyLevel": 65,
      "VacancyLevel": 3,
      "TargetLuminosity": 55,
      "Hysteresis": 5,
      "TuningSpeed": 3000,
      "OccupancyAction": "Scene",
      "OccupancyScene": 255,
      "VacancyAction": "Off",
      "VacancyScene": 6,
      "HoldTime": 600,
      "OccupancySceneLevels": [
        {
          "id": 161557,
          "level": 100
        },
        {
          "id": 161558,
          "level": 100
        },
        {
          "id": 161559,
          "level": 100
        }
      ],
      "VacancySceneLevels": [
        {
          "id": 161557,
          "level": 12
        },
        {
          "id": 161558,
          "level": 56
        },
        {
          "id": 161559,
          "level": 78
        }
      ]
    },
    "Profile2": {
      "TuningType": "Idle",
      "OccupancyLevel": 100,
      "VacancyLevel": 0,
      "TargetLuminosity": 0,
      "Hysteresis": 10,
      "TuningSpeed": 500,
      "OccupancyAction": "MaxLevel",
      "OccupancyScene": 2,
      "VacancyAction": "Off",
      "VacancyScene": 1,
      "HoldTime": 10
    },
    "Profile3": {
      "TuningType": "Combo",
      "OccupancyLevel": 100,
      "VacancyLevel": 0,
      "TargetLuminosity": 1,
      "Hysteresis": 10,
      "TuningSpeed": 500,
      "OccupancyAction": "MaxLevel",
      "OccupancyScene": 2,
      "VacancyAction": "Off",
      "VacancyScene": 1,
      "HoldTime": 10
    },
    "Profile4": {
      "TuningType": "Combo",
      "OccupancyLevel": 100,
      "VacancyLevel": 0,
      "TargetLuminosity": 0,
      "Hysteresis": 10,
      "TuningSpeed": 500,
      "OccupancyAction": "MaxLevel",
      "OccupancyScene": 2,
      "VacancyAction": "Off",
      "VacancyScene": 1,
      "HoldTime": 10
    },
    "Profile5": {
      "TuningType": "Combo",
      "OccupancyLevel": 100,
      "VacancyLevel": 0,
      "TargetLuminosity": 0,
      "Hysteresis": 10,
      "TuningSpeed": 500,
      "OccupancyAction": "MaxLevel",
      "OccupancyScene": 2,
      "VacancyAction": "Off",
      "VacancyScene": 1,
      "HoldTime": 10
    }
  },
  "timestamp": "2023-03-09T12:54:08.715438+03:00"
}