Иияма Дисплей

Адаптер дисплея Iiyama

Текущий релиз
0.1.6
Разработчик
Alan Paris
Лицензия
MIT

Адаптер iiyama для ioBroker

Управляйте профессиональными дисплеями iiyama ProLite через последовательный порт RS232 или соединение TCP/IP (LAN), используя официальный протокол связи iiyama. iiyama — производитель дисплеев — см. iiyama.com .

Функции

  • Поддержка двух типов подключения : управление дисплеями через последовательный порт RS232 или сетевое соединение TCP/IP.
  • Комплексное управление : питание, источник входного сигнала, громкость, параметры видео и аудио.
  • Мониторинг в реальном времени : автоматический опрос состояния дисплея с настраиваемыми интервалами.
  • Поддержка нескольких моделей дисплеев : поддерживаются дисплеи серии ProLite LH (см. список совместимости).
  • Очередь команд : последовательное выполнение команд предотвращает ошибки связи.

Поддерживаемые модели дисплеев

  • ProLite LH3252HS-B1
  • ProLite LH4352UHS-B1
  • ProLite LH5052UHS-B1
  • ProLite LH5552UHS-B1
  • ProLite LH6552UHS-B1
  • ProLite LH9852UHS-B2
  • ProLite LH4342UHS-B1/B3
  • ProLite LH5042UHS-B1/B3
  • ProLite LH5542UHS-B1/B3
  • ProLite LH6542UHS-B1/B3
  • ProLite LH7542UHS-B1/B3
  • ProLite LH8642UHS-B1/B3

Установка

  1. Установите адаптер из репозитория адаптеров ioBroker.
  2. Настройте параметры подключения в конфигурации адаптера.

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

Настройки подключения

Тип подключения : выберите между TCP/IP (LAN) или последовательным (RS232) соединением.

TCP/IP-соединение

  • IP-адрес : IP-адрес дисплея
  • TCP-порт : Обычно 5000 (по умолчанию для дисплеев Iiyama)

Последовательное соединение

  • Последовательный порт : путь к последовательному устройству (например,/dev/ttyUSB0 в Linux илиCOM1 (в Windows)
  • Скорость передачи данных :
    • 9600 для большинства моделей
    • 115200 только для серии LHxx42UHS-B1

Настройки дисплея

  • Идентификатор монитора : идентификатор, заданный на дисплее (1-255). Значение по умолчанию — 1.
  • Интервал опроса : Как часто обновлять отображаемый статус (5-300 секунд). По умолчанию — 30 секунд.
  • Режим энергосбережения : режим энергосбережения, настроенный на вашем дисплее (1-4). Он влияет на то, как можно управлять дисплеем в выключенном состоянии:
    • Режим 1 : WOL выключен, пробуждение от источника входного сигнала выключено, подсветка выключена.
      • TCP-соединение обрывается при выключении дисплея.
      • Не удается разбудить по сети (функция WOL отключена).
      • Для пробуждения необходимо использовать ИК-пульт дистанционного управления или кнопку на передней панели.
    • Режим 2 : WOL выключен, пробуждение от источника входного сигнала включено, подсветка выключена.
      • TCP-соединение обрывается при выключении дисплея.
      • Не удается разбудить по сети (функция WOL отключена).
      • Может автоматически включаться при обнаружении сигнала источника HDMI.
    • Режим 3 : WOL включен, пробуждение от источника сигнала выключено.
      • Можно разбудить устройство с помощью функции Wake-on-LAN (требуется настройка MAC-адреса).
      • Адаптер отправляет магический пакет WOL, а затем команду включения питания.
    • Режим 4 : WOL включен, пробуждение от источника включено ( рекомендуется для управления по сети ).
      • Можно разбудить устройство с помощью функции Wake-on-LAN (требуется настройка MAC-адреса).
      • Адаптер отправляет магический пакет WOL, а затем команду включения питания.
      • Также может автоматически включаться при обнаружении сигнала источника HDMI.
  • MAC-адрес (необходим для режимов 3 и 4): MAC-адрес сетевого интерфейса дисплея, используемый для функции Wake-on-LAN.
  • Широковещательный адрес WOL (необязательно): Широковещательный адрес подсети для пакета WOL. Если поле пустое, адрес определяется на основе IP-адреса хоста (например,192.168.1.100 →192.168.1.255 ).

Использование

Доступные состояния

Управление питанием

  • power - Включение/выключение дисплея (логическое значение)

Источники ввода

  • inputSource - Выберите источник входного сигнала:
    • HDMI, HDMI 2, HDMI 3, HDMI 4
    • DVI-D
    • DisplayPort, DisplayPort 2
    • VGA
    • USB, USB 2

Объем

  • volume.main - Громкость основного динамика (0-100%)
  • volume.audioOut - Громкость аудиовыхода (0-100%)

Настройки видео

  • video.brightness - Яркость (0-100%)
  • video.contrast - Контрастность (0-100%)
  • video.color - Насыщенность цвета (0-100%)
  • video.sharpness - Острота (0-100%)
  • video.tint - Оттенок/цвет (0-100%)
  • video.blackLevel - Уровень черного (0-100%)
  • video.gamma - Выбор гамма-кривой
  • video.colorTemperature - Предустановленная цветовая температура
  • video.pictureFormat - Формат изображения/соотношение сторон

Настройки звука

  • audio.treble - Высокий уровень (0-100)
  • audio.bass - Уровень басов (0-100)

Информация (только для чтения)

  • info.connection - Состояние подключения
  • info.standby - Дисплей находится в режиме ожидания/недоступен, пока адаптер продолжает работать.
  • info.operatingHours - Общее количество часов работы
  • info.serialCode - Отобразить серийный номер

Команды

  • commands.autoAdjust - Запуск автоматической настройки VGA (запись)true )

Пример использования в Blockly/JavaScript

// Turn display on
setState('iiyama-prolite.0.power', true);

// Switch to HDMI input
setState('iiyama-prolite.0.inputSource', 13); // 13 = HDMI

// Set volume to 50%
setState('iiyama-prolite.0.volume.main', 50);
setState('iiyama-prolite.0.volume.audioOut', 50);

// Adjust brightness
setState('iiyama-prolite.0.video.brightness', 75);

Технические характеристики

Реализация протокола

Данный адаптер реализует протокол последовательной связи RS232 iiyama, описанный в официальном примечании к применению. Протокол использует:

  • Формат пакета : Заголовок (0xA6), Идентификатор монитора, Категория, Страница, Код функции, Длина, Управление данными, Данные, Контрольная сумма
  • Контрольная сумма : операция XOR над всеми байтами, кроме контрольной суммы.
  • Время ожидания ответа : 5000 мс
  • Задержка выполнения команд : 100 мс между командами для предотвращения переполнения буфера.

Управление соединениями

  • Автоматическое переподключение : до 10 попыток с задержкой в 5 секунд.
  • Очередь команд : обеспечивает последовательную отправку команд.
  • Опрос состояния : Регулярное обновление всех параметров отображения.

Поиск неисправностей

Дисплей не отвечает

  1. Проверьте физическое соединение : убедитесь, что кабель правильно подключен.
  2. Проверьте IP-адрес/порт (TCP) или последовательный порт (RS232).
  3. Проверьте идентификатор монитора : он должен совпадать с идентификатором, настроенным на дисплее.
  4. Проблемы с последовательным соединением :
    • Проверьте скорость передачи данных (9600 или 115200 для серии B1).
    • Проверка прав доступа к последовательному порту в Linux:sudo usermod -a -G dialout iobroker
  5. Проблемы с TCP-соединением :
    • Для управления питанием по сети настройте дисплей в режим энергосбережения 3 или 4.
    • Режим 1 или 2: TCP-соединение обрывается при выключении дисплея — невозможно разбудить устройство по сети.
    • Режим 3: Требуется функция Wake-on-LAN — настройте MAC-адрес в параметрах адаптера.
    • Режим 4: Рекомендуемый — TCP остается активным, команды управления питанием работают напрямую.
    • Проверьте настройки брандмауэра.

Команды не работают

  • Ожидание ответа : Протокол требует ожидания подтверждения между командами.
  • Проверьте экранное меню (OSD) : гарантированно будут работать только команды, доступные в экранном меню дисплея.
  • Слишком частые опросы : увеличьте интервал опроса, если возникают ошибки связи.

Отказ от ответственности

iiyama и ProLite являются товарными знаками соответствующих владельцев. Этот адаптер является проектом сообщества и не связан с компанией iiyama, не одобрен ею и не поддерживается ею.

Торговые марки

iiyama и ProLite являются товарными знаками корпорации iiyama. Этот адаптер — независимый проект сообщества и не связан с корпорацией iiyama, не одобрен ею и не поддерживается ею. В иконке адаптера используется официальный товарный знак iiyama, опубликованный в пресс-материалах iiyama , который находится в общественном достоянии (ниже порога оригинальности).

Changelog

0.1.6 (2026-08-19)

  • (Alan Paris) Fixed protectedNative being placed inside common in io-package.json, where js-controller ignored it and the schema rejected it (repochecker E1105) - the MAC address is now genuinely protected

0.1.5 (2026-08-19)

  • (Alan Paris) Replaced the create-adapter placeholder icon with the official iiyama wordmark
  • (Alan Paris) Fixed polling stopping permanently when a Wake-on-LAN power command was not answered
  • (Alan Paris) Fixed the command queue hanging forever when the connection dropped mid-command
  • (Alan Paris) Status replies are now matched to the command that asked for them, so a timed-out poll can no longer write another command's value into a state
  • (Alan Paris) Repeated command failures are now logged once instead of on every poll cycle, and clear info.connection after three consecutive failures
  • (Alan Paris) Controls now snap back to the last confirmed value when a command is refused or cannot be delivered
  • (Alan Paris) State metadata is now applied with extendObject, so corrected roles reach existing installations on upgrade and not just new ones
  • (Alan Paris) Added macAddress to protectedNative so it is not readable by non-admin users
  • (Alan Paris) Fixed the connection status staying true after a reconnect to a display that answers nothing
  • (Alan Paris) Fixed overlapping reconnect attempts while a display was in standby, which could leave an unclosed socket behind
  • (Alan Paris) Power Save Mode 1/2 no longer reports the display as off when it is already on and reachable
  • (Alan Paris) The "display appears to be off" notice is now logged once per standby period instead of every 30 seconds
  • (Alan Paris) Serial connections now retry after a failed port open, so a dongle plugged in later (or a permissions fix) no longer needs an instance restart
  • (Alan Paris) Repeated connection errors are now logged once instead of on every retry

0.1.4 (2026-07-16)

  • (Alan Paris) Removed the manufacturer protocol PDF from the repository and its git history
  • (Alan Paris) Added a 10 s TCP connection timeout so an unreachable display no longer hangs the connect
  • (Alan Paris) Redacted MAC addresses in log output (only the last three octets are shown)
  • (Alan Paris) Changed the brightness state role to level.dimmer
  • (Alan Paris) Poll cycles are now skipped while the previous cycle is still processing, preventing command-queue backlog
  • (Alan Paris) Documented reserved protocol command/input-source codes that are not yet exposed as states

0.1.3 (2026-07-06)

  • (Alan Paris) Updated serialport dependency to 13.0.0

0.1.2 (2026-07-06)

  • (Alan Paris) Create channel objects for info/volume/video/audio/commands so every state has an intermediate parent object (fixes repochecker E3009)

0.1.1 (2026-07-05)

  • (Alan Paris) Enabled automated npm publishing via GitHub Actions trusted publishing (OIDC)

0.1.0 (2026-07-05)

  • (Alan Paris) Initial release: TCP/IP and serial (RS232) control of iiyama ProLite displays
  • (Alan Paris) Power, input source, volume, video and audio control with status polling
  • (Alan Paris) Wake-on-LAN support for Power Save Modes 3 and 4, with subnet-broadcast derivation
  • (Alan Paris) Automatic reconnection with slow standby polling to recover when a display is powered on

License

MIT License

Copyright (c) 2026 Alan Paris alan.paris@scottish.rugby

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.