↑

Для интеграторов

Плеер, который участвует в сценариях дома.

Готовые драйверы для Control4 и RTI, KNX через RTI и открытый IP-протокол для остальных систем. Драйверы и протокол одинаковы для всех плееров dorpo.

  • Control4
  • RTI
  • KNX
  • IP · RS‑232

Интеграция по моделям.

МодельЧем управляется
X3IP, RS‑232, CEC, Control4, RTI, KNX через RTI
UHP‑3001IP, RS‑232, CEC, Control4, RTI, KNX через RTI, триггер, ИК-вход
UHP‑3003SE ToroidyIP, RS‑232, CEC, Control4, RTI, KNX через RTI, триггер

Системы управления

СистемаЧем подключаетсяЧто умеет
Control4драйвер для Composerпульт, уведомление на экран, запуск файла
RTIдрайвер для Integration Designerпульт, громкость, запуск файла и приложений, обратная связь, до 10 плееров в драйвере
KNXдрайвер RTI + KNX-IP драйвер Activesurroundingкоманды из шины KNX и статусы плеера в шину
Crestron, Savant, Home AssistantHTTP на порт 9527, события по TCP 9528кнопки пульта, запуск файла, текст на экран, статус воспроизведения

Драйверы и протоколы

Control4

готовый драйвер

Готовый драйвер для Composer. Плеер появляется в проекте как медиаустройство.

  • Только проводная сеть; IP плеера закрепить за MAC в роутере
  • Composer → Connections → Network: IP плеера
  • Actions → Get Authorization, затем «Confirm» на экране плеера
  • Все кнопки пульта, текст на экран на 15 секунд, запуск файла из папки Movies во внутренней памяти

Control4 Control Manual 1.0

RTI

готовый драйвер

Драйвер для Integration Designer с подробной обратной связью. Один драйвер ведёт до 10 плееров, каждый — в своей комнате.

  • Каждый плеер — по сети (TCP) или по RS‑232
  • Все кнопки пульта, громкость 0–25, переход на позицию 0–100 %
  • Запуск файла, текст на экран, открытие приложений из списка установленных
  • Обратная связь: название, альбом, исполнитель, время и прогресс, HDR или SDR, цветовой формат (например, 4:2:0/8bit), выходной режим (например, 3840x2160p59.94hz), постер

Инструкция к RTI-драйверу Dorpo

KNX

через RTI

Плеером управляют из шины KNX через процессор RTI: драйвер Dorpo работает в паре с KNX-IP драйвером Activesurrounding.

  • Нужен физический KNX-IP шлюз; KNX-IP драйвер Activesurrounding KNXIP 4.1.8 Pro ходит к нему с процессора RTI, UDP 4001 и 4002 — порты драйвера
  • Команды из шины: громкость в процентах (DPT 5.001) и шагами (DPT 3.007, 1.008), питание, mute, плей, пауза, стоп, треки (DPT 1.001)
  • Статусы в шину: громкость, питание, транспорт; mute — при связи по RS‑232; название, исполнитель, альбом (DPT 16) — по IP
  • Запрос всех статусов: одна телеграмма на адрес запроса — плеер присылает всё разом
  • Групповые адреса вписываются только для нужных команд и статусов; к каждой команде заведите статус, иначе клавишу нажимают дважды

Раздел KNX в инструкции к RTI-драйверу

IP-команды · HTTP

порт 9527

Для систем без готового драйвера — Crestron, Savant, Home Assistant, собственные скрипты. Обычные GET-запросы.

  • Авторизация один раз: запрос connect при открытом TCP-соединении с портом 9528, подтверждение на экране, ответ "is_allowed": 1
  • Кнопки пульта по коду; Power (26) и Wake (224) по IP не работают — включение через Wake-on-LAN
  • Запуск файла по абсолютному пути (URL-encode): NFS, SMB, внутренняя память, USB
  • Текст на экран на 15 секунд

TCP/IP Control Protocol 1.1 · полный путь запросов — в документации

Обратная связь · TCP

порт 9528

Система управления держит TCP-соединение с плеером, плеер сообщает о состоянии.

  • При подключении — сообщение handle_shake
  • Система периодически шлёт heart_beat; ответ значит, что плеер в сети
  • В ответе — что играет и в каком состоянии: playStatus 1 — играет, 2 — пауза, −1 — стоп
  • Через TCP приходит и решение по авторизации: authCode 1 или 0

TCP/IP Control Protocol 1.1

Включение по сети

Wake-on-LAN

Кнопка Power по IP выключенный плеер не будит. Включение — стандартным magic packet.

  • 6 байт 0xFF и 16 повторов MAC-адреса
  • UDP-порт 9, широковещательно в сегменте сети: между подсетями и VLAN пакет не проходит, отправитель должен быть в сегменте плеера
  • Рекомендуется 5 пакетов подряд
  • Выключение — KEYCODE_SLEEP (223) по HTTP

Документ «Интеграция в системы управления»

RS‑232

9600 8N1

Последовательный порт на задней панели: у X3 — 3,5 мм, у UHP‑3001 и UHP‑3003SE — DB9. Работает напрямую и через драйвер RTI.

  • Три линии — TXD, RXD, GND, без управления потоком; порт плеера — DCE
  • Команда: # + три буквы + возврат каретки, до 25 байт
  • Ответ: @ + команда + OK или ER
  • Следующую команду — после ответа; без ответа за 10 секунд — повторить
  • Коды: PON, POF, POW, MUT, VOP, VOD, NUP, NDN, NLT, NRT, ENT, RET, HOM, PLA, PAU, INF, SET
  • Долгое нажатие «влево» и «вправо» перематывает фильм назад и вперёд — с прошивок X3.2.2.123, UHP‑3001.3.1.40 и 3.1.42. В RS‑232 Control Protocol этих команд ещё нет, коды — у дистрибьютора

RS‑232 Control Protocol

ИК и Bluetooth

NEC · 43BC

Пульт RC05 работает по Bluetooth и ИК. Для универсальных пультов есть полный список кодов.

  • Отдельные коды «только включить» (0E) и «только выключить» (0F)
  • Протокол NEC, пользовательский код 43BC
  • Bluetooth HID: страницы 0x07 и 0x0C

Remote Control Code Value Definition 1.2

HDMI CEC и триггер

без программирования

Для простых систем: телевизор, ресивер и плеер договариваются сами, а у UHP‑3001 и UHP‑3003SE триггер включает усилитель или проектор.

  • CEC: синхронное включение и выключение, громкость ресивера
  • Триггер у UHP‑3001 и UHP‑3003SE: вход и выход; у UHP‑3003SE — 3,5 мм, напряжение уточняется

FAQ и паспорт производителя

Сценарии

Примеры сцен, которые инсталлятор собирает из драйверов dorpo. Сначала — что видит владелец, ниже — как это работает.

«Кино» одной кнопкой

Свет гаснет, экран опускается, проектор и ресивер включаются — плеер уже на стене постеров.

Как это сделаноWake-on-LAN будит плеер, триггер‑выход UHP‑3001 и UHP‑3003SE включает усилитель или проектор, у X3 телевизор и ресивер включает HDMI CEC, остальное — сцена в Control4, RTI или KNX.

  • WOL
  • Триггер
  • Control4
  • RTI

Пауза — и в комнате светлеет

Нажали паузу — свет поднимается до 30 %. Снова «плей» — комната темнеет.

Как это сделаноПлеер сообщает о паузе: TCP 9528 (playStatus), PlayMode в RTI, статус Play/Pause в шину KNX. Свет до 30 % включает сцена в системе управления, в KNX — значением DPT 5.001.

  • TCP 9528
  • RTI
  • KNX

Титры — свет плавно

Фильм закончился — свет поднимается медленно, а не вспыхивает разом. Финал вечера запоминается сильнее всего.

Как это сделаноСобытие «стоп» (playStatus −1, в KNX — статус Stop) вызывает сцену «после фильма». Плавность задаёт время перехода в диммере или DALI-шлюзе, а не плеер.

  • TCP 9528
  • RTI
  • KNX

Звонок в дверь

Фильм встаёт на паузу, на экране на 15 секунд — «Курьер у ворот».

Как это сделаноReminder в RTI, уведомление в Control4, команда /remind по IP.

  • RTI
  • Control4
  • IP

Панель знает, что идёт

На панели или в телефоне — постер, название, сколько осталось, HDR и формат 3840×2160p23.976.

Как это сделаноОбратная связь драйвера RTI: Title, Poster Path, Elapsed и Duration, HDR, Color Attributes, Out Solution FPS — выходной режим плеера.

  • RTI

Фильм с панели, без пульта

Выбрали фильм на панели — он сразу начинается на экране.

Как это сделаноЗапуск файла по пути: Play File в RTI и по IP; в Control4 — из папки Movies.

  • RTI
  • IP
  • Control4

Клавиша на стене

Обычный выключатель KNX: громкость, плей и пауза, следующий трек.

Как это сделаноKNX через RTI: громкость шагами DPT 1.008 или 3.007, транспорт и треки DPT 1.001.

  • KNX
  • RTI

«Всё выключить»

Одна кнопка у двери гасит всю систему, и плеер засыпает вместе с ней.

Как это сделаноОтдельные команды «только выключить», а не переключатель Power — уже выключенный плеер не проснётся: KEYCODE_SLEEP по IP, ИК-код 0F, POF по RS‑232.

  • IP
  • ИК
  • RS‑232

Подготовка объекта

Что сделать до пусконаладки, чтобы драйверы и сцены не теряли плеер.

Проводная сеть и постоянный адресДрайверы и сцены привязаны к IP плеера. Подключайте кабелем — для Control4 это обязательно — и закрепите адрес за MAC в роутере, иначе после перезагрузки роутера связь пропадёт.
Wake-on-LAN — в одном сегментеMagic packet широковещательный и не проходит между подсетями и VLAN. Контроллер, который будит плеер, должен быть в том же сегменте; MAC плеера впишите в документацию объекта.
RS‑232 — короткая линияТри провода: TXD, RXD, GND. Порт плеера — DCE, поэтому к контроллеру обычно идёт прямой кабель, а не нуль‑модемный. RS‑232 рассчитан на линию около 15 м; дальше ставят преобразователь в RS‑485 или RS‑422.
KNX — шлюз и статусыНужен KNX-IP шлюз, к которому ходит процессор RTI. В групповых адресах к каждой команде заведите статус. Строка DPT 16 в KNX — не длиннее 14 байт: длинные названия фильмов показывайте на панели RTI, а как обрезается кириллица в шине — проверьте на объекте.
Коммерческие объекты и BMSBACnet и Modbus плеер не поддерживает. В систему диспетчеризации его заводят через контроллер или шлюз, который говорит с плеером по IP или RS‑232: питание, воспроизведение, громкость, название, HDR или SDR.
MatterMatter плеер не поддерживает и сам в Apple Home или Google Home не появится. Для умного дома — драйверы Control4 и RTI или IP-протокол.

Home Assistant

Готовой интеграции нет — плеер подключается через rest_command и Wake-on-LAN. Адрес, MAC и путь к файлу замените на свои, префикс пути запросов — из TCP/IP Control Protocol.

configuration.yaml

HTTP 9527 · WOL
wake_on_lan:

rest_command:
  dorpo_play_pause:
    url: "http://192.168.1.50:9527/<префикс>/sendKey?action=KEYCODE_MEDIA_PLAY_PAUSE&keyValue=85&from=homeassistant"
  dorpo_sleep:
    url: "http://192.168.1.50:9527/<префикс>/sendKey?action=KEYCODE_SLEEP&keyValue=223&from=homeassistant"
  dorpo_play_file:
    url: "http://192.168.1.50:9527/<префикс>/play?videoPath={{ path | urlencode }}&from=homeassistant"
  dorpo_remind:
    url: "http://192.168.1.50:9527/<префикс>/remind?content={{ text | urlencode }}&from=homeassistant"

script:
  dorpo_wake:
    sequence:
      - repeat:
          count: 5
          sequence:
            - action: wake_on_lan.send_magic_packet
              data:
                mac: "AA:BB:CC:DD:EE:FF"
                broadcast_address: "192.168.1.255"
            - delay: "00:00:00.2"
  • Один раз выдайте доступ: откройте TCP-соединение с портом 9528 плеера и в это время отправьте /<префикс>/connect?uniqueId=…&from=homeassistant&ip=…, затем нажмите «Confirm» на экране
  • События по TCP 9528 (пауза, стоп) Home Assistant сам не слушает — для сцен по состоянию нужен отдельный клиент, например Node-RED
  • Команда sendKey меняет состояние: при таймауте не повторяйте её автоматически, иначе плей/пауза переключится дважды

TCP/IP Control Protocol 1.1

Что передать заказчику

АдресаIP и MAC каждого плеера, привязка адреса в роутере.
Таблица групповых адресовАдрес, название, DPT и направление — команда или статус; экспорт проекта ETS.
Настройки драйверовIP процессора RTI и KNX-IP шлюза, порты, какие плееры в каком драйвере.
Где живут сценыВ акторе, в RTI, в Control4 или в Home Assistant — чтобы следующий инсталлятор не искал.
Страница для владельцаКак включить «Кино», как выключить всё и что делать, если панель не показывает, что идёт.

Источники: TCP/IP Control Protocol 1.1, Control4 Control Manual 1.0, инструкция к RTI-драйверу dorpo.

Для интеграторов

Протоколы и драйверы — в одном месте.

Плеер управляется по IP, RS‑232, IR и Bluetooth и сам сообщает системе, что играет: видео или музыка, игра, пауза или стоп.

Драйверы и описание IP-команд присылаем по запросу — напишите на info@digitalfruits.ru.

Контакты дистрибьютора

Документы производителя.
ДокументЧто внутри
TCP/IP Control ProtocolHTTP 9527, TCP 9528, коды кнопок
RS‑232 Control Protocol3,5 мм у X3, DB9 у UHP‑3001 и UHP‑3003SE; 9600 8N1, текстовые команды
Control4 · драйвер для Composerдрайвер для Composer
RTI · драйвер для Integration Designerдрайвер до 10 плееров, KNX через RTI
IR / Bluetooth codesNEC 43BC, отдельные вкл и выкл
Crestron · Savant · Home Assistantпо IP-протоколу, без драйвера
Прошивкичто менялось в каждой версии: X3, UHP‑3001, UHP‑3003SE