# PLC-Tracer: бесплатный браузерный визуализатор лестничной логики Allen-Bradley

🔗 GitHub: wisesokol/PLC-Tracer · v1.60 · MIT · Aleksei Sokolov, 2026

🎬 PLC-Tracer — Intro

🎬 PLC-Tracer — демонстрация работы

Теги: PLC Allen-Bradley ladder logic промышленная автоматизация open source Python WebSocket

Зачем это нужно

Если вы работаете с оборудованием на базе Allen-Bradley и вам нужно разобраться в логике программы — найти, почему не срабатывает реле, почему выход не включается, какие условия заблокированы — вы сталкиваетесь с одной и той же проблемой.

Нужно дорогое лицензионное ПО.

Программа	Цена лицензии
Studio 5000 (Rockwell Automation)	$3 000 — $10 000+
RSLogix 5000	аналогично
RSLinx Classic	отдельная строка бюджета

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

Результат: инженеры работают наугад, используют пиратское ПО, тратят очень много времени чтобы разобраться в иногда огромной и сложной логике программы, прыгая по подпрограммам и рутинам в разных частях проекта. Да и есть ли человек который сможет подключиться к PLC и произвести качественную диагностику. Как показывает практика, на этом часто экономят.

PLC-Tracer создавался именно для этого сценария — бесплатный, браузерный, не требующий установки инструмент для визуализации лестничной логики Allen-Bradley в офлайн-режиме и в реальном времени. Единственная оговорка, единожды нужно сделать экспорт проекта в необходимый формат, что в принципе можно сделать и на стороне.

⚠️ Безопасность прежде всего
PLC-Tracer работает строго на чтение. Инструмент не имеет возможности записи значений или изменения логики контроллера. Bridge открывает теги через libplctag API только в режиме read. Это принципиальное архитектурное решение для безопасной работы с промышленным оборудованием.

Архитектура

Проект состоит из трёх независимых компонентов:

┌─────────────────────────────────────────────────────────┐
│                      PLC-Tracer                         │
│                                                         │
│  ┌──────────────────────┐   ┌────────────────────────┐  │
│  │  Ladder Visualizer   │   │    Session Player      │  │
│  │  plc-tracer-*.html   │   │  PLC_Tracer_Player.html│  │
│  │  офлайн + онлайн     │   │  воспроизведение .ndrec│  │
│  └──────────┬───────────┘   └────────────────────────┘  │
│             │ WebSocket :8765                            │
│  ┌──────────┴───────────────────────────────────────┐   │
│  │               PLC Bridge                         │   │
│  │  plc_bridge_500.py  ←→  plc_bridge_ui.py         │   │
│  └──────────┬───────────────────────────────────────┘   │
└─────────────┼───────────────────────────────────────────┘
              │ EtherNet/IP · PCCC · DH+
         ┌────┴────┐
         │   ПЛК   │  SLC / MicroLogix / ControlLogix
         └─────────┘

Структура репозитория:

plc-tracer-500-v160.html        — основной визуализатор
PLC_Tracer_Player.html          — плеер записей
Bridge/
  plc_bridge_500.py             — headless Python-мост
  plc_bridge_ui.py              — GUI-мост (Tkinter)
  libplctag_2.6.16_windows_x64/ — нативная DLL
  install.txt                   — инструкция по установке
requirements.txt
LICENSE                         — MIT

Модуль 1 — Ladder Visualizer

Файл: plc-tracer-500-v160.html

Один HTML-файл, никаких зависимостей, никакой сборки — открывается в любом браузере.

Поддерживаемые форматы файлов

Формат	Откуда берётся	Семейство ПЛК
`.SLC`	Экспорт RSLogix 500	SLC 5/xx, MicroLogix
`.PRN`	Таблицы данных RSLogix	Офлайн-анализ переменных
`.SY6` / `.CSV`	Экспорт описаний тегов	Подписи адресов
`.L5X`	Экспорт Studio 5000	ControlLogix, CompactLogix

Трассировка тегов

Ключевая функция визуализатора. Клик по любому тегу строит граф связанных рангов: все ранги, которые читают этот тег, и все, которые его записывают, соединяются кривыми Безье.

  [Тег: B3/5]
       │
       ├── LAD 0 / Rung 4  ──── читает ──── (XIC B3/5)
       ├── LAD 2 / Rung 11 ──── читает ──── (XIO B3/5)
       └── LAD 1 / Rung 7  ──── пишет  ──── (OTE B3/5)
                │
                └── связанные теги: N7:0, T4:2.DN ...

То, что вручную занимает 30–40 минут кросс-референсного поиска, решается за несколько секунд. История навигации Back / Forward позволяет прыгать между тегами не теряя контекст.

Живой режим (Live Mode)

При подключённом Bridge визуализатор принимает данные по WebSocket и подсвечивает ранги в реальном времени:

🟢 Зелёный — условие выполнено (TRUE)
🔴 Красный — условие не выполнено (FALSE)

Вы видите не статическую схему, а живую картину состояния контроллера. Все таймеры тикают, все переменные, выстроенные на графе обновляются.

Запись сессий — REC

Кнопка ⏺ REC запускает запись в файл .ndrec. Формат содержит временны́е метки и значения всех отслеживаемых переменных. Запись можно передать коллеге или открыть позже в Player. Запись производится только для выстроенного графа, так что не стоит что-то добавлять на граф в режиме записи. Формат записи довольно хорошо оптимизирован и занимает мало места, возможно использование в роли регистратора для отслеживания работы оборудования.

Встроенный справочник инструкций

Полный справочник инструкций для SLC 500 и Logix 5000 прямо в интерфейсе. TON, CTU, MOV, EQU, PID, JSR — описание под рукой без открытия мануала. Оно конечно краткое, но решил что этого будет достаточно. Чтобы Help был доступен, соотвествующий файл нужно подгрузить по необходимости.

Модуль 2 — PLC Bridge

Файл: Bridge/plc_bridge_500.py

Асинхронный Python-сервис: устанавливает соединение с ПЛК и транслирует значения тегов в браузер через WebSocket на порту 8765.

Поддерживаемое оборудование

Семейство	Адресация	Протокол	Библиотека
SLC 5/05	`N7:0`, `B3/5`, `T4:2.ACC`	ETH-PCCC	libplctag
MicroLogix 1100 / 1200 / 1400 / 1500	SLC-адресация	ETH-PCCC	libplctag
ControlLogix	именованные теги `MotorRun`, `T1.ACC`	EtherNet/IP (CIP)	libplctag
CompactLogix	именованные теги	EtherNet/IP (CIP)	libplctag

Подключение к PLC производится через Ethernet. Поддержку RS протоколов не реализовывал, но это возможно.

Внутреннее устройство

Bridge построен на asyncio + websockets + aiohttp. Для работы с ПЛК используется нативная библиотека libplctag через ctypes — прямые вызовы DLL без дополнительных Python-обёрток.

Поддерживаемые типы данных:

INT8 · INT16 · INT32 · INT64
UINT8 · UINT16 · UINT32 · UINT32
FLOAT32 · FLOAT64
BIT
STRING  (Logix: LEN int32 + DATA[82] bytes)
UDT     (через raw bytes)

В памяти ведётся кольцевой буфер лога (500 записей) — состояние подключения видно в GUI в реальном времени.

GUI-версия (plc_bridge_ui.py) — тёмный Tkinter-интерфейс: старт / стоп / переподключение, цветовая индикация статуса, выбор папки для сохранения записей.

Поток данных

Физический ПЛК (SLC / MicroLogix / ControlLogix)
          │
          │  EtherNet/IP · PCCC · 
          ▼
  plc_bridge_500.py  ←──────►  plc_bridge_ui.py
    (asyncio core)               (Tkinter GUI)
          │
          │  WebSocket  ws://localhost:8765
          ▼
  PLC Tracer (браузер)
  live rung glow 🟢🔴

Модуль 3 — Session Player

Файл: PLC_Tracer_Player.html

Автономный плеер для воспроизведения записей .ndrec. Открывается в браузере, не требует Bridge и подключения к ПЛК.

Возможности

Функция	Описание
Timeline	Цветовые дорожки ON/OFF для каждого тега
Скорость	×0.5 · ×1 · ×2 · ×4 · ×8
Шаг кадра	← / → — покадровый разбор инцидента
Зум	Масштабирование временно́й шкалы
Оверлей	Состояния из записи накладываются на схему рангов
Клавиатура	`Space` = Play/Pause · `←` `→` = шаг · ПКМ = управление каналами

Типичный сценарий: что-то произошло на линии → записали сессию → открыли в Player → прошли по кадрам → нашли момент сбоя → установили причину.

Сценарии применения

🔌 Офлайн-отладка

Экспортировать программу из RSLogix / Studio 5000 → загрузить .SLC или .L5X в визуализатор → трассировать зависимости тегов → анализировать .PRN-снимки таблиц данных (для SLC Проектов).

ПЛК и Bridge не нужны.

📡 Онлайн-мониторинг

Запустить Bridge → подключиться к ПЛК → наблюдать живую подсветку рангов → при необходимости нажать REC и записать сессию.

🔍 Разбор инцидента (Post-Mortem)

Открыть .ndrec в Player → перемотать к моменту сбоя → покадрово восстановить последовательность событий → соотнести состояния рангов с временно́й шкалой.

Установка и запуск

Требования

Python 3.10+ (добавить в PATH)
Windows (Bridge тестировался на Windows; HTML-часть кроссплатформенна)
Любой современный браузер

Bridge

# Установка зависимостей
pip install -r requirements.txt

# GUI-мост (рекомендуется)
python Bridge/plc_bridge_ui.py

Визуализатор и Player

Просто открыть HTML-файл в браузере. Установка не нужна.

Зависимости Python

websockets
aiohttp
aiohttp-cors

Нативная библиотека libplctag (.dll) включена в репозиторий — отдельная установка не нужна.

Технические ограничения

Bridge тестировался на Windows x64. Для Linux потребуется скачать libplctag под целевую платформу.
Только чтение — запись значений в ПЛК не реализована намеренно.
Bridge работает локально и не требует открытия портов вовне.
HTML-часть не использует фреймворки и не требует интернета.

Для кого этот проект

🔧 Сервисные инженеры и наладчики на небольших производствах
🏭 Предприятия, которым не по карману Rockwell-лицензии
🎓 Студенты и обучающиеся в области промышленной автоматизации
🌍 Инженеры из стран, где лицензионное ПО недоступно по цене
🕵️ Все, кому нужно быстро разобраться в чужой программе без установки ПО

PLC-Tracer не претендует на замену Studio 5000. Он закрывает одну конкретную задачу: читать, понимать и диагностировать логику Allen-Bradley без финансового барьера.

Ссылки

📦 GitHub: wisesokol/PLC-Tracer
📄 Лицензия: MIT
🔗 libplctag: github.com/libplctag/libplctag (нативная библиотека, лицензируется отдельно)

Проект полностью создан с помощью Claude (Anthropic). Буду рад вопросам, замечаниям и pull request’ам.

PLC-Tracer — новый взгляд на Ladder логику