• Встроенная функция импорта файлов .knxproj (ETS4, ETS5, ETS6) с поддержкой паролей.
• Чтение/запись/передача/обновление флагов из объектов ETS ComObject.
• Вывод DPT из ComObjects при отсутствии DPT на уровне GA.
• Распределение комнат (перечисление комнат) в соответствии со структурой здания ETS.
• Импорт адресов групп в формате XML в качестве резервного варианта
• Защищенное туннелирование KNX IP через файл ключа .knxkeys или пароль
• Стабильный и надежный стек KNX на базе KNXUltimate
• Автоматическое кодирование/декодирование KNX-датаграмм для большинства DPT, чтение и запись в необработанном виде для остальных.
• Поддержка чтения, записи и ответа GroupValue
• Генерация псевдонимов для объединения значков действий и статусов в единый объект ioBroker.
• Прямая связь: подключите любое состояние ioBroker к адресу группы KNX.
• Поддерживает все стили адресации групп (3-уровневый, 2-уровневый, свободный).
• Бесплатный открытый исходный код, не зависит от облачных сервисов, работает в автономном режиме.

• Обнаружение — сканирует сеть на наличие всех доступных IP-шлюзов KNX. Рекомендуется сначала выбрать локальный сетевой интерфейс, а затем запустить обнаружение — IP-адрес, порт и физический адрес шлюза заполняются автоматически.
• Локальный сетевой интерфейс IPv4 — сетевой интерфейс сервера ioBroker, который может взаимодействовать с IP-шлюзом KNX. Выберите его перед запуском обнаружения.
• IP-адрес шлюза KNX -- IP-адрес вашего шлюза KNX. Заполняется автоматически при обнаружении.
• Порт -- обычно 3671. Заполняется автоматически по результатам обнаружения.
• Протокол -- тип подключения к IP-шлюзу KNX. Туннелирование UDP является методом по умолчанию для большинства IP-интерфейсов и маршрутизаторов KNX (например, Weinzierl, MDT, ABB). Туннелирование TCP обеспечивает более надежное соединение и поддерживается более новыми шлюзами — рекомендуется, если доступно. Многоадресная маршрутизация подключается через маршрутизацию KNXnet/IP (многоадресная группа 224.0.23.12) и предназначена для IP-маршрутизаторов KNX, выступающих в качестве линейных соединителей — туннельное соединение не устанавливается, и несколько клиентов могут одновременно получать доступ.
• Физический KNX-адрес — индивидуальный адрес, используемый адаптером на шине KNX (например, 1.1.250). Должен быть настроен как дополнительный адрес в IP-интерфейсе в ETS и не должен использоваться другим устройством.
• Минимальная задержка отправки между двумя кадрами [мс] -- защищает шину KNX от перегрузки слишком быстрыми телеграммами. Увеличьте это значение, если в журнале появляются ошибки DISCONNECT_REQUEST (например, до 80-150 мс).
• Используйте common.type boolean для однобитного перечисления вместо number -- DPT-1 (переключение) представляется в ioBroker как логический тип (true/false) вместо number (0/1). Включите эту опцию для лучшей совместимости с виджетами VIS и скриптами, которые ожидают логические значения.
• Считывание значений KNX при запуске -- все объекты с флагом авточтения считываются с шины KNX при первом подключении после запуска адаптера для синхронизации текущих состояний.
• не выдавать предупреждения по неизвестным адресам групп KNX -- подавлять записи предупреждений в журнале при получении телеграмм для групп KNX, не настроенных в адаптере. Полезно в системах с большим количеством групп KNX, где в адаптере используется только их подмножество.
• Стиль группового адреса — определяет представление группового адреса в соответствии с вашей конфигурацией ETS. Поддерживаются все 3 стиля, которые преобразуются в 3-уровневый формат для хранения: 3-уровневый (1/3/5), 2-уровневый (1/25) или свободный (300). Объединенное имя группового адреса и группы должно быть уникальным в дереве объектов ioBroker.

Импорт .knxproj (рекомендуется)

1. В ETS сохраните свой проект (Файл > Сохранить). Файл .knxproj находится в каталоге вашего проекта ETS.
2. Если проект защищен паролем, введите пароль проекта в поле «Пароль» рядом с кнопкой импорта.
3. Загрузите файл .knxproj в адаптер через диалоговое окно импорта.
4. Импорт начинается немедленно и отображает приблизительный ход выполнения в зависимости от размера файла.

• Флаги чтения/записи/передачи/обновления из объектов ComObject (вместо значений по умолчанию read=true, write=true)
• Вывод DPT из ComObjects, если DPT не назначен для GA.
• Назначение комнат из структуры здания/местоположения ETS (автоматически создает перечисление комнат)
• Флаг автоматического чтения, полученный из флага ComObject ReadOnInit.
• Поддерживает проекты ETS4, ETS5 и ETS6 (включая проекты, защищенные паролем)
• В будущих версиях ETS все будет работать автоматически — обновление адаптера не требуется для новых патчей/минорных релизов ETS.

Импорт XML (резервный вариант)

1. В ETS перейдите в раздел «Групповые адреса», выберите «Экспорт групповых адресов» и выберите «Экспорт XML в последней версии формата».

1. Загрузите XML-файл экспорта ETS в адаптер через диалоговое окно импорта.
2. Импорт начинается немедленно, и по завершении предоставляется отчет о состоянии.

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

• Не перезаписывать существующие объекты IOB — пропускать существующие объекты связи во время импорта, добавлять только новые.
• Удаление существующих объектов IOB, отсутствующих в файле импорта ETS -- удаление объектов из дерева ioBroker, которые больше не существуют в проекте ETS. Полезно для очистки после удаления GA в ETS.
• Удалите все существующие объекты KNX перед импортом (чистый повторный импорт) -- сначала удалите все объекты KNX, а затем импортируйте заново. Используйте это при реструктуризации проекта ETS.

1. Включить KNX Secure — установите флажок.
2. Файл ключей (.knxkeys) — вставьте содержимое файла .knxkeys в текстовое поле. Файл экспортируется в ETS через Дополнительно > Экспорт KNX-ключей.
3. Пароль файла ключа — пароль, устанавливаемый при экспорте связки ключей в ETS.
4. Альтернативный вариант: Пароль пользователя туннеля — вместо файла ключа пароль туннеля можно ввести напрямую (из конфигурации проекта ETS IP-интерфейса).
5. Пароль аутентификации устройства (ключ магистрали) — требуется только в ручном режиме (без файла ключа). Начиная с knxultimate 6.0, MAC-адрес SESSION_RESPONSE проверяется во время установления соединения; без этого пароля соединение понижается (соединение по-прежнему устанавливается, но в журнал записывается предупреждение). Если предоставлен файл ключа, это значение извлекается из него автоматически.
6. Интерфейс туннеля IA — при необходимости укажите индивидуальный адрес интерфейса туннеля (например, 1.1.254).
7. Идентификатор пользователя туннеля — значение по умолчанию 2. Изменяйте его только в том случае, если на одном интерфейсе настроено несколько туннельных соединений.

Вариант A: Псевдонимы (рекомендуется)

• Регулярное выражение для идентификации статусов GA — регулярное выражение для идентификации статуса GA по имени (например, с окончанием "status", "rm", "Rückmeldung"). Это же регулярное выражение используется как для генерации псевдонимов (Вариант A), так и для режима совместимости с KNX (Вариант B).
• Минимальное сходство — насколько строго алгоритм сопоставления фильтрует похожие записи (0 = приблизительное сходство, 1 = точное сходство).
• Путь к псевдонимам -- папка с объектами, где создаются псевдонимы (например, alias.0.KNX).
• Включить диапазон групп в поиск -- используйте полный путь, включая названия групп, для сопоставления, а не только название GA.
• Сгенерировать псевдонимы -- кнопка для запуска генерации псевдонимов. Адаптер должен быть запущен. По завершении отображается количество сгенерированных псевдонимов.

Вариант B: Миграция адаптера knx

• Режим совместимости ioBroker.knx -- внутренне связывает GA статуса с GA действия (как в старом адаптере knx) вместо создания псевдонимов. Использует то же регулярное выражение, что и вариант A.
• Целевое пространство имен -- установите значение knx.0, чтобы повторно использовать старые пути к объектам адаптера KNX, благодаря чему существующие скрипты, проекты VIS и панели мониторинга продолжат работать без изменений. Значение по умолчанию — openknx.0.

Режимы связи

• Прямой (1:1) — каждое изменение значения передается в шину KNX без изменений. Используется для датчиков, диммеров или ползунков.
• Триггер (только ВКЛ.) -- передаются только истинные значения (ВКЛ / true / ненулевое значение), ложные значения (ВЫКЛ / false / 0) игнорируются. Используется для триггеров сцен или дверных открывателей, где источник отправляет ВКЛ/ВЫКЛ (нажатие/отпускание).
• Переключение (инвертирование KNX в положении ВКЛ) -- при каждом истинном значении считывается текущее состояние KNX и отправляется инвертированное значение. Ложные значения игнорируются. Используйте для кнопок, которые должны включать/выключать индикатор KNX.

Порог

Преобразовать выражение

• !!value -- преобразует любое истинное/ложное значение в логическое.
• value*100 -- масштабирование числа с плавающей запятой от 0 до 1 в процентное значение от 0 до 100
• value>0?100:0 -- преобразование порогового значения в двоичный код
• Math.round(value) -- округляет значения с плавающей запятой

setState(myState, { val: false, ack: false, c: "GroupValue_Read" });
setState(myState, { val: false, ack: false, q: 0x10 });

{
    "_id": "path.and.name.to.object",
    "type": "state",
    "common": {
        "desc": "Basetype: 1-bit value, Subtype: switch",
        "name": "Aussen Melder Licht schalten",
        "read": true,
        "role": "state",
        "type": "boolean",
        "unit": "",
        "write": true
    },
    "native": {
        "address": "0/1/2",
        "answer_groupValueResponse": false,
        "autoread": true,
        "bitlength": 1,
        "dpt": "DPT1.001",
        "encoding": { "0": "Off", "1": "On" },
        "force_encoding": "",
        "signedness": "",
        "valuetype": "basic"
    }
}

msg.payload = { priority: 1, data: 0 };
return msg;

Включите экспертный режим для переключения между уровнями логирования. По умолчанию — информационный.

Ваше мнение важно!

Помогите нам улучшить эту документацию – оставьте отзыв или предложите изменение.