Broadlink2 | ioBroker

Интеграция беспроводных устройств (RM++, SP++, A1, T1, S1C, Beok313, Floureon, LB+)

Адаптер для различных беспроводных устройств, совместимых с Broadlink (RM++, SP++, A1, Floureon, S1C, LB1).

Это адаптер ioBroker для нескольких коммутаторов Broadlink, таких как RM2, RM3, RM Plus, SP1, SP2, SP3, Honeywell SP2, SPMini, SPMini2, SPMiniPlus, а также некоторых OEM-продуктов этой компании. Поддерживаются также пульты дистанционного управления, такие как RM2, RM Mini, RM Pro Phicomm, RM2 Home Plus, RM2 Home Plus GDT, RM2 Pro Plus, RM2 Pro Plus2 и RM2 Pro Plus BL. Для нескольких контроллеров будут создаваться собственные записи, и их необходимо будет обучать отдельно. Адаптер сканирует сеть для поиска совместимых устройств и устанавливает их (в настоящее время только коммутаторы типа SP?).

Если вы изучили штаты для RM*, а затем переименовали их, идентификатор штата также изменится на новое имя!

Вы также можете создавать свои собственные новые команды в LearnedStates, используя в качестве значения 'code' + ваш код (с 'CODE_' перед кодом) или, что еще лучше (поскольку он сохранится, если вы переименуете состояние), добавьте поле 'code' в native с помощью admin.object pencil и поместите туда шестнадцатеричный код (без 'CODE_'!).

Адаптер имеет фиксированные состояния для отправки кодов с RM-устройств или для их обучения. Он также может отправлять отдельные сценарии (действия на нескольких устройствах).

Если устройства, настроенные на определенный IP-адрес, не будут обнаружены повторно, им будет присвоена пометка «недоступно»! После повторного подключения они будут доступны для нормального использования.

Если устройство не отвечает в течение 5 минут подряд, оно помечается как недоступное. Устройства с пометкой notReachable будут выдавать предупреждение в журнале каждые x сканирований. После нескольких сканирований адаптер попытается найти их снова по тому же MAC-адресу, что и раньше.

Пожалуйста, удалите старые устройства из файла admin.objects, если вы удалили их навсегда или переименовали в настройках маршрутизатора!

Адаптер сначала пытается найти устройство по его имени, а затем по MAC-адресу. Если имя меняется, например, из-за изменения IP-адреса, а MAC-адрес остается прежним, устройство продолжит использовать старое имя. Если устройство меняется на новое с новым MAC-адресом, вы можете использовать команду переименования устройства в конфигурации, чтобы использовать старое имя устройства.

Примечание по поводу опросов общественного мнения

Опрос устройств SP1 невозможен.
Если вы используете только устройства RM, частоту опроса можно установить на 2 минуты (120 секунд), но не следует устанавливать более высокое значение, поскольку в противном случае повторная авторизация может не состояться.
Если вы используете переключатели, которые можно переключать вручную, то время отклика должно составлять от 30 секунд до 1 минуты, чтобы изменения отражались в течение минуты.

Конфигурация

Введите префикс сетевого адреса в конфигурации, который следует удалить при генерации имен устройств.
Введите количество секунд между опросами. При каждом опросе у всех устройств SP*, кроме SP1, запрашивается состояние переключателя. Эту функцию можно отключить, установив задержку опроса равной 0. На некоторых устройствах RM с отображением температуры температура также будет обновляться.
Теперь вы можете добавлять IP-адреса устройств, которые находятся в другой сети, отличной от сети адаптера, и которые будут включены в список. В этом случае необходимо убедиться, что компьютер, на котором работает адаптер, знает по внутренним или внешним таблицам маршрутизации, как подключиться к этой другой сети.
Онuse IP interface Можно установить параметр для использования адреса конкретного интерфейса. Это может быть полезно, если в системе, где работает iobroker, есть LAN и WLAN, и вы не хотите сканировать только WLAN, а только локальный интерфейс. Это также может помочь, если локальный интерфейс отличается от внешнего в некоторых средах Docker или виртуальных машин. Необходимо ввести IPv4-адрес интерфейса, который будет использоваться в качестве исходного адреса, иначе адаптер будет использовать 0.0.0.0 и прослушивать только локальные интерфейсы.

Как изучить коды на RM

В разделе «Объекты» ioBroker вы можете найти «broadlink2.[devicename].Learn или LearnRF для устройств типа '+'».
Для устройств RM(x)+ (Plus) также предусмотрена специальная кнопка обучения RS-sweep (_LearnRF), которая позволяет обучать больше устройств, чем на обычных устройствах с частотой 433 МГц.
Установите для этого объекта значение true. (Вы можете нажать на кнопку в окне просмотра объекта)
Теперь в течение 30 секунд нажмите какую-нибудь кнопку на пульте дистанционного управления. В обычном режиме нажимайте их коротко, с небольшими перерывами, пока не выучите их.
В режиме обучения RF-sweep необходимо сначала удерживать кнопку в течение ~10-20 секунд, затем отпустить ее и подождать 2-3 секунды, после чего снова нажать на нее на очень короткое время.
Теперь внутри объекта "broadlink.[n].[devicename].LearnedState" должен появиться новый объект с именем ">>> Переименовать learned @ YYYYMMDDTHHmmSS"
Для отправки кода вы можете нажать на кнопку в окне просмотра объекта.
Чтобы переименовать элемент, щелкните по его названию (начинающемуся с...)._Rename_learned_ ) и изменить название. Оно не должно включать, ,. или; а также некоторые другие символы, они будут заменены на '_';

Также можно использовать коды из RM-Bridge . Просто создайте объект (состояние, тип кнопка) со значением, перед которым вы добавите "CODE_" или нативный элемент ввода.code без какого-либо 'CODE_'.

Примечание к новым устройствам RM4/LB1

Некоторые новые устройства Broadlink поддерживают новый протокол Broadlink-Cloud, который автоматически выбирается при использовании новых приложений Broadlink для подключения устройства к вашей сети Wi-Fi. Этот новый протокол Broadlink несовместим с адаптером Broadlink2, и вы не сможете использовать устройства, использующие этот новый протокол.
Чтобы избежать этой проблемы, подключите устройство к сети, используя старые приложения Broadlink, например...e smart home илиe-control И убедитесь, что ваш телефон подключен к той же сети Wi-Fi 2,4 ГГц, в которой вы собираетесь его использовать!
Более новые устройства также требуют повторной аутентификации каждые 5-10 минут, что адаптер делает автоматически.

Используйте сцены

Сцены могут содержать идентификаторы или имена, а также номера, разделённые символом ., Обычно идентификаторы обрабатываются/отправляются с задержкой в 100 мс, но если вам нужна более длительная пауза, вы можете указать число, отражающее количество миллисекунд ожидания. Например:SP:dose=1, 1000, RM:your.L.StereoEin, 1000, RM:your.L.TVEin Включите беспроводной адаптер с названием «SP:dose», затем подождите одну секунду (фактически 1,1 секунды), включите стереосистему, а через секунду — телевизор. Вы также можете переключать устройства с других адаптеров, например...hm-rpc.0.MEQ1435726.1.STATE=true Включу это устройство Homematic! Состояния Boolsche можно переключать с помощью '=1/=on/=true/=ein', если оставить его без этого параметра.= Тогда будет использоваться значение true. Чтобы выключить устройство, нужно добавить в конце '=0/=false/=aus/=off', что необходимо для выключения!

Используйте состояния

Вы также можете создавать состояния для своих устройств, которые объединяют команды включения и выключения в одно состояние, переключаемое, как и у любого другого устройства.
Необходимо перечислить команды для включения и выключения состояния в отдельных столбцах; их может быть несколько, чтобы система State знала, когда ваше устройство включается/выключается любой из этих способов.
Если вы установите состояние только в положение «вкл.» или «выкл.», будет отправлена первая команда включения/выключения.
Если присутствуют только одна команда, переключатель отправит соответствующую команду с числовым значением -1, что означает, что он отправит первую команду, если получит первую.0 , второй, если он получит1 Таким образом, вы можете моделировать несколько состояний в рамках одного состояния.
Если в качестве команды выключения используется только символ '+', то необходимо указать 10 команд включения, разделенных запятой (','), которые соответствуют номерам.0-9 на пульте дистанционного управления. Вы можете отправить состояние, а затем число, например:123 (максимум 9999), и это отправит1 ,2 и3 с задержкой в 1/3 секунды между ними! Таким образом, вы можете, например, установить канал на телевизоре на «33», просто написав «TVchannel=33», если название штата — TVchannel.
Если вы используете-number как команда выключения, например-17 Затем можно сохранить число в состоянии, из которого будет вычтено 17, и будет отправлен (x-17)-й элемент в состоянии «включено». Таким образом, можно установить разные фиксированные температуры для устройств, которые имеют разные коды для каждой температуры.

Используйте функцию отправки сообщений адаптеру.

Адаптер также распознает команды 'sendTo'.

debug :sendTo('broadlink2.0','debug','on') (также 0,1,on,off,ein,aus,true,false) включат режим отладки.
get :sendTo('broadlink2.0','get', 'RM2:RMPROPLUS.Temperature' мог бы запросить данные с такого устройства, как{ val: 29.9, ack: true, ts: 1505839335870, q: 0, from: 'system.adapter.broadlink2.0', lc: 1505839335870 } цюрюк
switch : может включать и выключать вилку:sendTo('broadlink2.0','switch','SP:your device id=on')
switch_on /switch_off : sendTo('broadlink2.0','switch_on','SP:your device id')`
send :sendTo('broadlink2.0','send','RM:yourdev._Learn') начнёт учиться иsendTo('broadlink2.0','send','RM:yourdev.L.yourid') Отправлю код.
send_scene :sendTo('broadlink2.0','send_scene','scene xxx ') würde den als message angebenen Text als Szene ausführen
send_code :sendTo('broadlink2.0','send_code','RM:your remote.CODE_xxxxx') введите CODE_xxxx от R: отправлено ваше имя.

Термостаты Floureon или Beok313

Большинство данных можно установить, время можно задать, введя любой параметр._setTime В этом случае время устройства будет установлено на системное время ioBroker. Это также будет происходить автоматически при запуске адаптера.

Настройка дополнительных новых устройств

Вы можете добавлять новые устройства, использующие тот же протокол, указывая их идентификатор устройства (в шестнадцатеричном или десятичном формате) и класс устройства (указанный там: class = A1,MP1,RM,RMP,S1C,SP1,SP2,SP3P,T1). Таким образом, вы можете добавить в список RM новый пульт дистанционного управления, который адаптер обнаруживает только как неизвестное устройство с шестнадцатеричным идентификатором 0x1234, указав 0x01234=RMP.

Переименовать устройства

Обычно устройства получают в качестве имени сетевое имя хоста или комбинацию типа устройства, идентификатора и MAC-адреса, при этом первые две буквы типа стоят с двоеточием. Переименовать такое устройство можно с помощью...T1:BroadLink-OEM-T1-fa-83-7c=Beok313 В этом случае будет использоваться не исходное имя, а новое.Beok313 .

режим отладки

Если вы добавите! В конце списка добавленных новых устройств (даже если он пуст) вы можете перевести адаптер в режим отладки, в котором он будет записывать много дополнительной информации, даже если в административной панели не установлен режим «информация».

Известные проблемы

Если вы обучаете один и тот же сигнал несколько раз, код каждый раз может быть разным. Этого изменить нельзя.
Иногда система не находит устройства, если они не отвечают на поиск. Для перезапуска нового экземпляра выполните повторное сканирование или перезагрузите адаптер.

Установка

С помощью административной панели ioBroker выполните команду `npm install iobroker.broadlink2` или скачайте её с https://github.com/frankjoke/ioBroker.broadlink2

Changelog

WORK IN PROGRESS

(copilot) Adapter requires node.js >= 22 now
(copilot) Adapter requires admin >= 7.7.22 now
(mcm1957) Adapter requires node.js >= 20 now
(copilot) Adapter requires js-controller >= 6.0.11 now
(copilot) Adapter requires admin >= 7.6.17 now

(mattreim) Several issues reported by adapter checker have been fixed

2.3.0 (2024-05-21)

(mattreim) Adapter migrated to jsonConfig
(mcm1957) Adapter requires admin >= 6 now
(mcm1957) Dependencies have been updated

2.2.0 (2024-04-05)

(mcm1957) Adapter requires node.js 18 and js-controller >= 5 now
(mcm1957) Dependencies have been updated

2.1.5

beta to try to make 0x5f36 working

2.1.4

bug corrections for RM4 temperatures & Humidity

2.1.2

bug corrections for States and Scenes
Names are now taken from DNS end which mean you may rename devices in router and set their fixed IP address there

Todo for later revisions

config of devices and codes in separate config tool

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.