Соединяет светодиодные лампы Philips Hue, светодиодные лампы и ленты Friends of Hue и другие устройства, поддерживающие SmartLink (LivingWhites, некоторые LivingColors) через Philips Hue Bridges

[!ВАЖНО] Этот адаптер нельзя установить из GitHub

Этот адаптер использует сервис Sentry.io для автоматического сообщения мне, как разработчику, об исключениях, ошибках в коде и новых схемах устройств. Подробнее см. ниже!

Что такое Sentry.io и какая информация передается на серверы этой компании?

Sentry.io — это сервис для разработчиков, позволяющий получать обзор ошибок в их приложениях. Именно это и реализовано в данном адаптере.

Когда адаптер зависает или возникает другая ошибка в коде, это сообщение об ошибке, которое также появляется в журнале ioBroker, отправляется в Sentry. Если вы разрешили ioBroker GmbH собирать диагностические данные, то в них также включается ваш идентификатор установки (это просто уникальный идентификатор без какой-либо дополнительной информации о вас, электронной почте, имени и т. д.). Это позволяет Sentry группировать ошибки и показывать, сколько уникальных пользователей затронуто такой ошибкой. Все это помогает мне предоставлять безошибочные адаптеры, которые практически никогда не зависают.

Английский :gb:

Этот адаптер подключает ваши мосты Philips Hue к ioBroker для управления светодиодными лампами Philips Hue, светодиодными лампами Friends of Hue, светодиодными лентами, розетками, например, от Osram, и другими устройствами, поддерживающими SmartLink (например, LivingWhites и некоторыми моделями LivingColors).

Настраивать

После установки этого адаптера в ioBroker создайте соответствующий экземпляр адаптера. Затем вам нужно подключить ваш мост Hue к ioBroker в настройках адаптера:

Если вы используете другой мост, отличный от версии 2, настройте порт на 80 (без HTTPS), в противном случае следует использовать порт 443 (с HTTPS).
Нажмите кнопку «Найти мост», чтобы получить IP-адрес вашего моста. Будет выполнен поиск всех мостов в вашей сети. Затем выберите мост, к которому хотите подключиться. Поле «Адрес моста» будет заполнено IP-адресом выбранного вами моста Hue.
Далее нажмите кнопку «Создать пользователя» в настройках, затем подойдите к вашему устройству Hue Bridge и нажмите на его круглую кнопку. У вас будет 30 секунд, чтобы продолжить. После нажатия кнопки поле «Пользователь Bridge» должно быть заполнено сгенерированной строкой.
Измените все остальные параметры в настройках адаптера, а затем выберите «Сохранить и закрыть».
В итоге, все должно быть готово: адаптер сгенерирует все необходимые объекты для управления вашими устройствами Hue.

Обратите внимание: кнопка настроек адаптера «Найти мост» будет неактивна, если заполнено поле «Адрес моста», а кнопка «Создать пользователя» будет неактивна, если заполнено поле «Пользователь моста».

Настройки

Имя	Описание
Адрес моста	Вы можете попробовать определить IP-адрес вашего моста Hue, нажав... `Find Bridge` кнопка.
Порт	Порт вашего моста Hue, обычно 443 (SSL) и 80 (без SSL).
SSL	Если этот параметр отмечен, соединение защищено протоколом SSL, порт автоматически изменится на 443 (настоятельно рекомендуется использовать SSL).
Пользователь	Имя пользователя для вашего моста. Вы можете создать его, нажав... `Create User` нажимайте кнопку и следуйте инструкциям на экране.
Игнорировать сцены	Если этот флажок установлен, сцены не будут отображаться/управляться адаптером.
Игнорировать группы	Если этот флажок установлен, группы не будут отображаться/управляться адаптером.
«Устаревшая» структура	Для обеспечения обратной совместимости в ioBroker можно хранить старую структуру объектов. Эта старая структура представляет собой `hue.<instance_number>.<bridge_name_channel>.<light_or_group_channel>.<state>` Новая структура устраняет `<bridge_name_channel>` и, следовательно, возникает необходимость адаптации старых скриптов и т. д. Если адаптер обнаружит существующую старую структуру, она будет использоваться без установки флажка. Однако, если требуется миграция со старой структуры на новую, удалите всю структуру целиком. `hue.<instance_number>` пространство имен один раз.
Естественное поведение включения/выключения	Если этот параметр отмечен, адаптер будет включать/выключать свет так же, как и встроенное приложение Hue. В противном случае, при включении лампы будут устанавливаться на уровень яркости 100%. Кроме того, если группа ламп уже включена, изменение уровня яркости повлияет только на уже включенные лампы и не включит лампы, которые в данный момент выключены.
Синхронизация программных датчиков	Также синхронизируйте программные датчики. Это виртуальные датчики, например, созданные сценами Hue Labs. Управляя ими... `status` С помощью данных, полученных от такого датчика, можно запускать/останавливать сценарии, которые следуют этой логике. В большинстве случаев `0` выключает сцену и `1` включает его.
Проявляйте инициативу в общении с другими.	Включите свет, также с указанием состояния CT, состояния цвета и т. д. Установите значение... `false` и включаться только при включении питания и поддержании уровня яркости.
Опрос	Если этот параметр включен, адаптер будет отслеживать изменения состояния, в противном случае его можно использовать только для управления лампами, а не для отображения их состояния.
Интервал опроса	Определяет, как часто будут опрашиваться состояния и, следовательно, обновляться в ioBroker. Низкие интервалы опроса могут вызывать проблемы с производительностью в некоторых условиях. Поэтому минимально допустимый интервал опроса составляет 2 секунды. Если интервал опроса установлен менее чем на 2 секунды, он будет установлен на 2 секунды во время выполнения.

Команды

Командные состояния (например) hue.0.All.command) можно использовать для установки нескольких команд для моста. Это позволяет установить группу или источник света в определенное состояние, например, с помощью времени перехода.

setState('hue.0.All.command', { "bri": 50, "transitiontime": 30 }, false);

Для групп, содержащих сцены, например: hue.0.Wohnzimmer.scene_hell Сцены также можно активировать с задержкой между переходами. Для этого передайте аргумент scene соответствующей команде.

setState('hue.0.All.Wohnzimmer', { "scene": "hell", "transitiontime": 30 }, false);

Дополнительная информация

В версии 3.3.0 группа заявляет: anyOn и allOn стали управляемыми, но имейте в виду, что они просто будут вести себя как обычно. on Состояние, когда оно контролируется. В некоторых случаях может быть желательно иметь контролируемое состояние. anyOn укажите это в своей визуализации.

Deutsch :de:

Повязка Philips Hue / LivingColors / LivingWhites Lampen ein. В настройках адаптера необходимо указать IP-адрес Hue Bridge, чтобы настроить имя пользователя. Чтобы активировать пользователя, необходимо создать пользователя и включить его в течение 30 секунд после нажатия кнопки и перехода через оттенок Hue. Это позволит автоматизировать работу пользователя.

План действий/Список задач

Автоматическое обнаружение мостов
Автоматическая настройка пользователя через кнопку мостового соединения

Changelog

3.17.4 (2026-09-15))

(mcm1957) support to install from github has been dropped

3.17.2 (2026-09-15)

(copilot) Fixed user creation not updating configuration field automatically- #776

3.17.1 (2026-09-15)

(a-i-ks) fixed: ct object min/max being stricter than the adapter's supported color temperature range, causing "less than min"/"greater than max" warnings (closes #586)
(copilot) Adapter requires node.js >= 22 now
(copilot) Adapter requires admin >= 7.7.22 now
(copilot) Adapter requires js-controller >= 6.0.11 now

3.16.2 (2025-04-12)

(@foxriver76) do not try to use v2 functionality on legacy Hue bridges (closes #720)

3.16.1 (2025-03-07)

(@foxriver76) fix if no tamper report is present on state creation

License

Apache 2.0