Illuminance-sensor - История изменений

Admin: Admin переименовал страницу Виртуальное устройство "Датчик освещенности" в Illuminance-sensor: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T20:28:54Z

Admin переименовал страницу Виртуальное устройство "Датчик освещенности" в Виртуальное устройство "Датчик освещенности": Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия	Версия от 20:28, 2 октября 2026
(нет различий)

Admin: Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

2026-10-02T20:28:52Z

Английский адрес статьи, русский заголовок и сохранение истории по поручению владельца

← Предыдущая версия		Версия от 20:28, 2 октября 2026
Строка 1:		Строка 1:
			{{DISPLAYTITLE:Виртуальное устройство "Датчик освещенности"}}
	''Актуально начиная с версии прошивки v13.6''		''Актуально начиная с версии прошивки v13.6''

Admin: COR-06: единый словарь действий и адресов управления/состояния

2026-08-23T16:10:36Z

COR-06: единый словарь действий и адресов управления/состояния

← Предыдущая версия		Версия от 16:10, 23 августа 2026
Строка 1:		Строка 1:
	~~__NOTOC__~~

	''Актуально начиная с версии прошивки v13.6''		''Актуально начиная с версии прошивки v13.6''

	~~= {{xioticon\|LightSensor}} Датчик освещённости =~~

	== Назначение ==		== Назначение ==
	'''Датчик освещённости''' измеряет уровень света в помещении и передаёт значение в люксах или процентах, в зависимости от типа устройства.		{{xioticon\|LightSensor}} '''Датчик освещённости''' измеряет уровень света в помещении и передаёт значение в люксах или процентах, в зависимости от типа устройства.

	Используется для:		Используется для:
Строка 19:		Строка 15:
	Уточните, в каком формате физический датчик передаёт значение:		Уточните, в каком формате физический датчик передаёт значение:

	* Если датчик отправляет '''в люксах''' — свяжите ~~тэг~~ с характеристикой '''Освещённость (люксы)'''		* Если датчик отправляет '''в люксах''' — свяжите адрес состояния с характеристикой '''Освещённость (люксы)'''
	* Если датчик сразу отправляет значение '''в процентах''' — свяжите с характеристикой '''Освещённость (%)'''		* Если датчик сразу отправляет значение '''в процентах''' — свяжите с характеристикой '''Освещённость (%)'''

	⚠️ '''Важно:''' ~~мы всегда связываем только~~ '''~~тэг~~ состояния'''. ~~Управление освещённостью~~ не ~~предполагается —~~ XIOT получает данные от датчика, но не отправляет в него команды.		⚠️ '''Важно:''' для входного показания датчика задайте '''адрес состояния'''. Адрес управления для измерения освещённости не нужен: XIOT получает данные от датчика, но не отправляет в него команды. Возможность ручного изменения характеристики отдельно определяется её типом и правами.

	=== 🔢 Порог максимальной освещённости ===		=== 🔢 Порог максимальной освещённости ===
Строка 38:		Строка 34:
	=== 💡 Приём значения от физического датчика ===		=== 💡 Приём значения от физического датчика ===

	* XIOT получает значение по ~~тэгу~~ состояния		* XIOT получает значение по адресу состояния
	* В зависимости от настройки:		* В зависимости от настройки:
	* либо сохраняется в характеристику '''Освещённость (люксы)'''		* либо сохраняется в характеристику '''Освещённость (люксы)'''
Строка 81:		Строка 77:

	* Характеристика '''Освещённость (%)''' необязательна — используется при необходимости		* Характеристика '''Освещённость (%)''' необязательна — используется при необходимости
	* ~~Мы связываем только тэг '''~~состояния~~''',~~ независимо от формата		* Для входного показания связывается адрес состояния независимо от формата данных
	* Значения автоматически передаются в комнату, к которой относится устройство		* Значения автоматически передаются в комнату, к которой относится устройство

Admin: Новая страница: «NOTOC ''Актуально начиная с версии прошивки v13.6'' = {{xioticon|LightSensor}} Датчик освещённости = == Назначение == '''Датчик освещённости''' измеряет уровень света в помещении и передаёт значение в люксах или процентах, в зависимости от типа устройства. Используется...»

2025-06-15T12:36:02Z

Новая страница: «__NOTOC__ ''Актуально начиная с версии прошивки v13.6'' = {{xioticon|LightSensor}} Датчик освещённости = == Назначение == '''Датчик освещённости''' измеряет уровень света в помещении и передаёт значение в люксах или процентах, в зависимости от типа устройства. Используется...»

Новая страница

__NOTOC__

''Актуально начиная с версии прошивки v13.6''

= {{xioticon|LightSensor}} Датчик освещённости =

== Назначение ==
'''Датчик освещённости''' измеряет уровень света в помещении и передаёт значение в люксах или процентах, в зависимости от типа устройства.

Используется для:
* управления освещением
* адаптации яркости светильников
* мониторинга света в комнатах и сценариях

== Что настраивает интегратор ==

=== 📏 Формат данных от датчика ===

Уточните, в каком формате физический датчик передаёт значение:

* Если датчик отправляет '''в люксах''' — свяжите тэг с характеристикой '''Освещённость (люксы)'''
* Если датчик сразу отправляет значение '''в процентах''' — свяжите с характеристикой '''Освещённость (%)'''

⚠️ '''Важно:''' мы всегда связываем только '''тэг состояния'''. Управление освещённостью не предполагается — XIOT получает данные от датчика, но не отправляет в него команды.

=== 🔢 Порог максимальной освещённости ===

Если используется формат '''люксы''', задайте порог максимального значения — это граница, при которой будет считаться 100%.

Пример:
* Порог = 200 люкс → при 200 и выше характеристика '''Освещённость (%)''' будет равна 100
* При 100 люкс → будет рассчитано 50%

Это значение используется для расчёта относительной яркости и может участвовать в логике комнаты или сценариях.

== Как это работает ==

=== 💡 Приём значения от физического датчика ===

* XIOT получает значение по тэгу состояния
* В зависимости от настройки:
* либо сохраняется в характеристику '''Освещённость (люксы)'''
* либо напрямую в '''Освещённость (%)'''

=== 📊 Расчёт процента яркости (если люксы) ===

Если подключен датчик в люксах и задан порог максимума — XIOT автоматически рассчитывает процент:

* Значение больше порога → 100%
* Ниже → пропорциональное значение от 0 до 100%
* Отрицательные и ошибочные значения → 0%

Результат сохраняется в характеристику '''Освещённость (%)'''

=== 🏠 Передача данных в комнату ===

'''Датчик всегда принадлежит комнате'''.
При изменении характеристик:

* Значение люксов → автоматически передаётся в комнату
* Значение процента (если используется) → также передаётся

Комната может использовать эти данные в своей логике освещения.

== Что увидит пользователь ==

=== 📱 Интерфейс приложения ===

* Отображается текущее значение освещённости:
* либо в люксах
* либо в процентах (если используется)
* Может отображаться на карточке комнаты или в сценарии

=== 📌 Рекомендации ===

* Для жилых помещений порог 100% обычно 150–300 люкс
* Для рабочих зон — 300–500 люкс
* Если датчик отдаёт проценты — расчёт внутри XIOT не нужен

== Примечания ==

* Характеристика '''Освещённость (%)''' необязательна — используется при необходимости
* Мы связываем только тэг '''состояния''', независимо от формата
* Значения автоматически передаются в комнату, к которой относится устройство

== 🔗 Типовые применения ==

* Комнаты — адаптация освещения по текущей яркости
* Сценарии — проверка условий: «если темно — включить свет»
* Интеграция с логикой: '''Адаптивное освещение''', диммирование, ночной режим