Dmx512-setup

DMX512 в XIOT — это выходной драйвер для управления совместимым световым и сценическим оборудованием с XIOT-PLC. Настройка выполняется в XIOT-EDITOR в разделе Драйверы на вкладке DMX512.

Сверено по опубликованным файлам: описание ниже соответствует публичному редактору и пакету XIOT-PLC версии 14.1-1-1, доступным 13 сентября 2026 года. Проверка на конкретном контроллере, интерфейсе и приборе всё равно обязательна.

Что поддерживает текущая версия

Параметр	Текущее поведение XIOT
Линия	Одна линия DMX0. Дополнительные линии в текущей публичной версии не запускаются.
Каналы	Каналы с 1 по 255. Число 512 в названии протокола не означает, что редактор XIOT сейчас предоставляет 512 каналов.
Значение канала	Целое число от 0 до 255. Его назначение определяется картой каналов конкретного прибора; 0 не всегда означает «выключено», а 255 — не всегда «обычная максимальная яркость».
Передача	XIOT-PLC циклически пытается формировать выходные кадры с заданной частотой; фактическая частота может быть ниже из-за времени передачи и нагрузки. Текущий драйвер не опрашивает приборы и не выполняет RDM-обмен.

Важно: один из каналов прибора может включать движение, стробоскоп или другой специальный эффект. Не проверяйте неизвестный канал значением 255. Сначала найдите в документации прибора его начальный DMX-адрес, режим работы и точную карту каналов, затем обеспечьте безопасные условия проверки.

Перед началом

Определите, какой физический интерфейс контроллера формирует DMX-сигнал и как называется его устройство в Linux.
Убедитесь, что этот порт поддерживает требуемый режим и не занят Modbus, консолью или другим драйвером.
Проверьте питание, начальный DMX-адрес и режим каналов прибора по документации его производителя.
Выполняйте физическое подключение по документации точной модели передатчика и прибора. Не переносите распиновку, назначение общего провода или схему экрана с другого оборудования.

Путь вида /dev/ttyRS485-1 или /dev/ttyMOD2, показанный в примере или интерфейсе по умолчанию, нельзя копировать наугад: фактическое имя зависит от контроллера и занятого слота.

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

Откройте Драйверы → DMX512.
В поле Порт укажите фактический свободный порт DMX-интерфейса.
Для первого запуска оставьте FPS равным 30, Шаг fade равным 8 и Break mode равным baud, если для вашего интерфейса не подтверждены другие значения.
Включите переключатель Активен.
Добавьте комментарии только к используемым каналам: укажите прибор и функцию, например «Прожектор 1 — красный».
Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
Дождитесь завершения загрузки и снова откройте вкладку DMX512.

Переключатель Активен, порт, FPS, шаг fade и режим break относятся к конфигурации проекта. Их изменение в редакторе само по себе не перестраивает уже работающий драйвер на контроллере; для применения нужна загрузка конфигурации.

Параметры

Активен: Разрешает запуск DMX0 при загрузке конфигурации на XIOT-PLC. Если параметр выключен, выходной поток не запускается.

Порт: Путь к последовательному интерфейсу, через который контроллер передаёт DMX. Ошибка в пути или занятый порт не дают драйверу начать нормальную передачу.

FPS: Заданная частота формирования кадров. Интерфейс принимает значения от 1 до 120; штатное начальное значение — 30. Фактическая частота может быть ниже заданной. Меняйте параметр только с учётом возможностей контроллера, интерфейса и прибора.

Шаг fade: Максимальное изменение значения канала за один кадр, от 1 до 255. Поэтому длительность перехода зависит одновременно от разницы между старым и новым значением, FPS и шага fade. При шаге 255 целевое значение достигается за один кадр; меньший шаг растягивает переход на несколько кадров.

Break mode: Способ, которым драйвер формирует начало DMX-кадра. Доступны baud и condition. Сначала используйте baud; переключайте режим только при диагностике совместимости конкретного последовательного интерфейса и обязательно повторно проверяйте физический выход.

Адреса каналов

В таблице показана основа адреса /dmx/N, где N — номер от 1 до 255. Для привязки используются полные теги:

Тег	Назначение
`/dmx/N/range`	Установка числового значения 0–255. Используйте этот тег, когда требуется предсказуемое значение канала.
`/dmx/N/switch`	Команда 0 задаёт каналу 0. Команда 1 возвращает последнее сохранённое драйвером значение выше 5, а если его ещё нет — 255.

Например, для второго канала используются /dmx/2/range и /dmx/2/switch. Показанный в колонке Адрес текст /dmx/2 — только общая часть, а не полный адрес характеристики.

Оба тега доступны для чтения и записи и могут выбираться как адрес управления или адрес состояния с учётом типа характеристики виртуального устройства. Если включение значением 255 для прибора небезопасно, используйте range и заранее задайте допустимое значение вместо switch.

Комментарий помогает читать проект, но не меняет DMX-адрес прибора и не влияет на выходной сигнал.

Что означает статус

Статус ПОДКЛЮЧЕН означает только, что XIOT-PLC смог открыть указанный последовательный порт и записывает в него DMX-кадры без обнаруженной ошибки.

Этот статус не подтверждает:

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

Текущий драйвер XIOT не получает от обычного DMX-прибора обратную связь. Поэтому окончательная проверка — это наблюдаемая безопасная реакция нужного прибора на заранее известный канал.

Безопасная проверка в ручном режиме

Ручное управление — временный режим работающего драйвера. Пока он включён, обычные команды /dmx/N/range и /dmx/N/switch от устройств и логики проекта игнорируются.

Убедитесь, что загружена актуальная конфигурация, драйвер активен и редактор связан с нужным XIOT-PLC.
По документации прибора выберите один известный и безопасный канал. Не перебирайте неизвестные каналы.
Обеспечьте безопасное положение движущегося оборудования и исключите опасное воздействие света или специальных эффектов на людей.
Включите Ручное управление. Поля значений станут доступны.
Введите допустимое для выбранной функции значение. Оно становится целевым; фактический выход может прийти к нему постепенно в соответствии с Шагом fade и FPS.
Проверьте физическую реакцию именно ожидаемого прибора и запишите назначение канала в комментарии.
Верните безопасное значение и обязательно выключите Ручное управление.
Проверьте тот же канал командой из привязанного виртуального устройства или логики проекта.

У ручного режима нет автоматического тайм-аута. Не оставляйте его включённым после пусконаладки: пока он активен, штатная автоматизация DMX не управляет каналами.

Если оборудование не реагирует

Наблюдение	Что проверить
НЕТ ПОДКЛЮЧЕНИЯ	Загружена ли конфигурация после включения драйвера; существует ли указанный порт; не занят ли он другим драйвером; есть ли ошибка последовательного порта в журнале XIOT-PLC.
ПОДКЛЮЧЕН, но прибор не реагирует	Питание прибора, его начальный адрес и режим каналов, совместимость интерфейса, физическое соединение и требования производителя. Зелёный статус не является ответом прибора.
Реагирует другая функция	Начальный адрес, выбранный режим прибора и его карту каналов. Не продолжайте перебор значений, если результат может быть опасным.
Команды устройств или сценариев не работают	Выключено ли Ручное управление. В этом режиме обычные программные команды намеренно игнорируются.
Значение меняется слишком медленно или рывком	Совместное влияние FPS и Шага fade. После изменения параметров снова загрузите конфигурацию и повторите безопасную проверку.

Если причина остаётся неясной, приложите к обращению в поддержку модель контроллера и интерфейса, фактический путь порта, версию XIOT-PLC, время проверки и фрагмент журнала. Не публикуйте пароли и другие данные доступа.

Границы этой инструкции

Эта страница описывает настройку выходного драйвера XIOT, но не заменяет проект кабельной линии, распиновку конкретного оборудования и требования к стационарной прокладке. Для физической части используйте актуальную документацию производителя и применимые документы ESTA Technical Standards Program, включая действующие редакции ANSI E1.11 и серии E1.27.

Следующие шаги

Обзор интеграционных модулей: Настройка драйверов.
Значение адресов управления и состояния: Механизм работы тегов в XIOT.
Привязка к виртуальному устройству: Привязка реальных устройств к виртуальным.
Настройка автоматизации: Создание сценариев.