engiAI

1. Почему engiAI и метод ЗОНА-ПАРА

engiAI Ethernet System — программа визуальной инспекции для производственной линии. Она берёт кадр с промышленной или обычной камеры, режет его на зоны, проверяет каждую зону обученной нейросетью и превращает результат в действие: сигнал на дискретный выход камеры, TCP-посылку роботу или ПЛК, запись в журнал. Метод ЗОНА-ПАРА создан для изделий, у которых «правильно» в каждом месте своё: печатные платы, сборки, наборы деталей в ложементе, упаковка с раскладкой.

1.1. Что даёт метод по сравнению с классификацией целого кадра

Обычный подход — одна модель с двумя классами «normal / anomaly» на весь кадр или на все зоны сразу. На плате он не работает: пустое место под мостом BR1 в зоне 2 — брак, а такое же пустое место в другом углу платы — норма. Одна пара классов этого выразить не может. Другая крайность — отдельная модель на каждую деталь — это десятки обучений и десятки файлов в памяти.

ЗОНА-ПАРА решает это так: модель одна, а классов столько, сколько зон. Зона — прямоугольник вокруг одной детали. Класс — папка с картинками, на которых учится сеть. У каждой зоны своя пара: zone_001 (норма зоны 1, в примере — конденсатор C30) и zone_001_anomaly (брак зоны 1); zone_002 и zone_002_anomaly — мост BR1. При проверке зоны 1 программа смотрит только на её пару, ответы про зону 2 не участвуют. Классы аномалий необязательны: брак меняет вид зоны, и уверенность в «норме» падает сама; но с синтетикой (раздел 4.6) они делаются в одно нажатие и заметно повышают надёжность.

1.2. Скорость: ИИ смотрит только на нужные вырезки

Нейросеть никогда не получает целый кадр. Для каждой зоны вырезается только её прямоугольник, а номер зоны выбирает пару классов. Зоны одного кадра считаются параллельно (до четырёх потоков), результат всех зон уходит на экран одним пакетом, а не по одной зоне.

• Темп анализа задаётся по времени. Ползунок «Анализов в секунду (AI)» на вкладке Camera означает ровно N анализов в секунду, а не «каждый N-й кадр». Потолок — частота камеры и время инференса.
• GPU по умолчанию. Инференс идёт через ONNX Runtime с CUDA; если видеокарты NVIDIA нет, программа сама переключается на процессор и пишет об этом в статусе (GPU (CUDA) или CPU).
• Буферы без мусора. Память под вырезки выделяется один раз на поток и переиспользуется; время анализа не скачет от кадра к кадру.
• Модель под задачу. Для ЗОНА-ПАРА программа сама ставит размер входа 128 px и сеть YOLO11 размера «s»: вырезка зоны почти не масштабируется, а сети хватает ёмкости на сотни пар классов.
• Живой конвейер экономит кадры. Кадр уходит в очередь ИИ не чаще периода поиска платы; плата ищется и выравнивается один раз, и только затем режутся зоны.
• Показ не мешает анализу. Плитка перерисовывается не чаще 25 раз в секунду и только по новому кадру камеры, картинка уменьшается до размера плитки до вывода на экран, а журнал пишется в файл фоновым потоком. Интерфейс остаётся отзывчивым при 8-мегапиксельном кадре и сотнях зон.

В строке состояния над видео видны реальные цифры: fps и миллисекунды последнего анализа, а также Eff — сколько анализов фактически прошло за секунду.

1.3. Какую точность ожидать: считаем по своей камере

Программа не обещает «0,5 мм» безотносительно камеры и объектива. Чувствительность к смещению определяется тем, сколько пикселей приходится на миллиметр изделия, и той границей, которой обучена модель. Считается это в две строки:

Число 5 px — нижняя граница синтетического сдвига в рекомендованных настройках аномалий (разброс нормы при этом 0–2 px). Настройки по умолчанию рассчитаны на 11 px/мм: при таком масштабе 0,5 мм — это 5–6 px, что и является целью, согласованной при разработке. Подставьте свои значения:

1.4. Быстрый старт: настройки подобраны, зоны и модель за несколько кликов

Метод рассчитан на то, чтобы технолог без опыта в машинном обучении получил рабочую модель за одну смену. Всё, что можно было подобрать заранее, уже подобрано и хранится в базе программы:

• Зоны за минуту. В редакторе ROI протяните рамку вокруг детали и укажите размер зоны (в примере 256 px). Если деталей много и они стоят ровно, протяните рамку по всей плате — программа сама посчитает строки и столбцы сетки.
• Синтетика нормы и брака преднастроена. Кнопки «По умолчанию», «Смещение элементов» и «Цвет и краска» переключают готовые профили. Число файлов, кадров с камеры и ожидаемое время показываются до нажатия «Снять».
• Параметры обучения выставляются сами. После первого снимка по зонам программа ставит Image Size 128, Model Size s, Epochs 50, Batch 64, а при обучении отключает аугментации, которые конфликтуют с классами аномалий.
• Камера настраивается кнопкой. «Авто-настройка для ИИ (по кадру)» подбирает выдержку, усиление, гамму и баланс белого; для USB-камер есть «Автоподбор под формы» и «Зафиксировать параметры».
• Наборы настроек камеры. Подобранные параметры сохраняются под именем и переключаются из списка, камера принимает их сразу и запоминает в своей памяти.
• Один ONNX-файл на выходе. Обученная модель экспортируется автоматически и сразу назначается на инспекцию, дополнительных шагов нет.

Путь целиком: подключить камеру → создать модель → отметить зоны → зафиксировать область привязки → «Снимок по зонам» на нескольких исправных платах → «Аномалии зон» → TRAIN AI MODEL → вкладка Inspect. Дальше остаётся повесить на зоны звук, выходы и TCP. Что нужно для старта: компьютер с Windows 10/11 (для быстрой инспекции — видеокарта NVIDIA), камера, одна исправная плата и один раз интернет для установки среды обучения. Бракованные платы не нужны.

2. Интерфейс программы за одну минуту

Главное окно разделено на две части. Слева — живое видео с камер и строка состояния над ним. Справа — панель с вкладками, где находится всё управление. Границу между частями можно перетаскивать; размеры, положение всех окон и раскладку программа запоминает в своей базе.

Кнопки над видео

Вкладки справа

Строка состояния

Над кнопками показано состояние активной камеры: LIVE (Android): 3264×2448 [HD USB Camera] — тип, разрешение и имя; AI: WAITING или AI: GPU (CUDA) — на чём считает модель и сколько миллисекунд занял последний анализ; Net: всего … активная … Мбит/с — нагрузка на сеть от GigE-камер (зелёный до 40 % линка, оранжевый до 70 %, дальше красный). Полоса Exp Load показывает, какую долю кадрового интервала занимает выдержка: если она упёрлась вправо, камера не удержит заявленную частоту.

Плитка каждой камеры имеет свою шапку с именем, статусом LIVE | AI:ON и кнопкой переподключения. Правый клик по кадру открывает меню зоны, правая кнопка с перетаскиванием — панорама по увеличенному кадру.

3. Камеры: подключение и настройка

3.1. Какие камеры поддерживаются

Жёсткого ограничения на число камер нет: плитки раскладываются сеткой любым числом; на реальных стендах работали восемь и девять камер одновременно. У каждой камеры свои модели, свои зоны, свой порог и свой темп анализа.

3.2. Окно КАМЕРЫ: добавить, переподключить, удалить

Галочки под списком действуют на выбранную камеру: Камера включена (иначе она отключается от устройства и пропадает с экрана), Показывать видео/зоны (только отрисовка, анализ работает всегда), AI включён для выбранной камеры. Кнопка Переподключить делает полное отключение и подключение с перезапуском потока ИИ и перезагрузкой моделей.

Правая часть окна показывает все параметры камеры, считанные с железа при подключении, с группами и единицами измерения: «Чьи параметры показать», Перечитать с камеры, Скопировать в буфер. Это только просмотр: изменить параметры можно на вкладке Camera.

3.3. Вкладка Camera для HIKROBOT и SICK

Вкладка работает с камерой, плитка которой выделена синей рамкой. Программа при подключении ничего не записывает в камеру: камера — источник истины, а ползунки подтягиваются к её значениям. Записать настройки можно только осознанно кнопкой Сохранить параметры.

Блок «Hikrobot: параметры камеры (GenICam)»

Показывается только то, что камера отдаёт. Строки: Авто-экспозиция (Off / Once / Continuous), Авто-усиление, Гамма и режим гаммы, Резкость, Оттенок, Насыщенность, Авто-баланс белого, Баланс белого по каналам, Цифровой сдвиг, Уровень чёрного включён, Ограничение FPS включено, Переворот по горизонтали и вертикали, GigE: размер пакета, GigE: межпакетная задержка, GigE: лимит полосы, Тестовое изображение. Кнопка Перечитать параметры с камеры перестраивает таблицу.

Блок «ЦВЕТ ИЗОБРАЖЕНИЯ»

Раскладка Байера (Авто / BGGR / RGGB / GRBG / GBRG), Saturation 0…200 %, Gamma 0,30…3,00, Contrast 50…200 %, кнопка сброса. Программная обработка применяется ко всем потребителям кадра: показ, запись, инференс и снимки для обучения, поэтому картинка при обучении и при инспекции одинакова. Для HIKROBOT раскладка берётся из формата пикселя камеры, для цветных SICK — с сенсора и уточняется по первому кадру.

3.4. Вкладка Camera для USB/веб-камеры

Для USB-камер вкладка показывает блок «USB-камера: разрешение, FPS и свойства». Свойства драйвера, которые камера не отдаёт, не показываются; границы полей заданы программой, потому что DirectShow диапазонов не сообщает.

3.5. Сохранённые настройки камеры (наборы)

Блок «Сохранённые настройки камеры» показывается для USB, SICK и HIKROBOT. Подобрав параметры под изделие, сохраните их под именем: под другую плату или другое освещение достаточно выбрать набор из списка.

• Сохранить как… — читает текущие значения с камеры и спрашивает имя набора. Если имя занято, предлагает перезаписать.
• Выбор набора в списке сразу пишет параметры в камеру и закрепляет их: для USB — в базу, для SICK и HIKROBOT — в файл параметров и в память камеры (UserSet1 / EEPROM). Затем панель перечитывает значения с железа и показывает, сколько параметров принято, а сколько отклонено.
• Пересохранить перезаписывает выбранный набор текущими значениями, Переименовать и Удалить действуют только на запись в базе, параметры в камере не меняются.

Что входит в набор: у USB — разрешение, FPS, свойства драйвера и авто-режимы; у SICK — усиление, выдержка, FPS, уровень чёрного, pixel clock, gain boost, баланс белого R/G/B, аппаратная гамма и программный цвет; у HIKROBOT — усиление, выдержка, FPS, уровень чёрного и все узлы GenICam. Размер кадра промышленных камер в набор не входит: его смена перезапускает захват. Наборы общие для всех камер одного типа, поэтому на стенде из одинаковых камер один набор ставится на каждую.

3.6. Сеть GigE и переподключение

• Размер GigE-пакета HIKROBOT выставляется автоматически оптимальным при открытии; вручную его можно поправить в блоке GenICam. Jumbo-кадры 8164–9000 снижают нагрузку, при рвущихся кадрах ставьте 1500 и увеличивайте межпакетную задержку.
• Строка Net считает нагрузку от каждой камеры по её собственным данным (размер полезной нагрузки × частота) и сверяет с фактическим входящим трафиком сетевых карт. Заметное расхождение означает потерю кадров или посторонний трафик. Виртуальные адаптеры и NDIS-фильтры (GigEVision, uEye, Npcap) из подсчёта исключены.
• Если камера видна, а поток не идёт, нажмите Переподключить (в окне КАМЕРЫ или на плитке). Обычно причина — пропускная способность сети или USB.
• SICK picoCam при закрытии дескриптора теряет настройки; если набора в самой камере нет, программа применяет файл параметров и предлагает нажать «Сохранить параметры», чтобы записать их в камеру.

4. Модель ЗОНА-ПАРА: от сетки до обученной модели

4.1. Как устроен метод: одна модель, класс на каждую зону

Модель ЗОНА-ПАРА — это обычная классификационная сеть YOLO11, у которой классов столько, сколько зон, плюс необязательные классы аномалий. Класс — это папка внутри train и val. Все папки программа формирует сама; вручную создавать ничего не нужно. Так выглядит папка модели из примера после обучения:

Файлы real_…jpg — настоящие вырезки с камеры (пишутся и в train, и в val), syn_…jpg — синтетика, edit_…jpg — снимки из редактора зоны. В примере после съёмки нескольких плат: zone_001 — 502 файла в train и 111 в val, zone_001_anomaly — 680 и 144, zone_002 — 813 и 181, zone_002_anomaly — 340 и 60.

Программа распознаёт модель как «плату» автоматически, по наличию классов вида zone_NNN. Номер класса — сквозной номер зоны в сетке (1…N). Отсюда главное правило метода:

4.2. Создать модель

4.3. Отметить зоны на плате

Красные зоны: исключить зону из синтетики одним щелчком

На вкладке AI Model щёлкните левой кнопкой по уже созданной зоне прямо на видео: зона станет красной и не будет участвовать в снимке по зонам и в аномалиях. Повторный щелчок возвращает её. Счётчики файлов в окнах синтетики пересчитываются сразу, а надпись «выкл N» над кадром показывает, сколько зон выключено. Список красных зон хранится по камере и модели; на вкладке Inspect эта же зона остаётся обычной (там свои, жёлтые зоны — раздел 5.5).

4.4. Зафиксировать оригинал: область привязки

Зоны инспекции размечены по одному положению платы. Чтобы на линии можно было подсунуть другую плату со сдвигом и поворотом, программа запоминает оригинал: живой кадр и область привязки — участок платы с деталями, по которому изделие ищется в каждом новом кадре. Найдя область, программа переносит на новую плату зоны инспекции. Так работает съёмка, синтетика и инспекция.

Кнопка Оригинал с зонами открывает сохранённый оригинал с сеткой и номерами зон (раздел 4.8). Найденная плата проверяется на здравый смысл: площадь от 0,5 до 2 площадей оригинала, выпуклый четырёхугольник, опорные точки должны занимать не меньше четверти области по каждой оси — иначе результат отбрасывается, и в консоли пишется «плата не найдена».

4.5. Снимок по зонам: норма и её синтетика

Кнопка ЗОНА-ПАРА: снимок по зонам делает главное: режет живой кадр на зоны, кладёт вырезку каждой зоны в её класс zone_NNN и добавляет синтетику нормы. Синтетика нормы — это разброс съёмки, а не дефект: плату положили чуть не так, свет чуть другой, сенсор шумит.

4.6. Синтетика брака в два нажатия: элемент смещается вместе с основанием

Два нажатия

Больше ничего настраивать не нужно: ни рисовать брак, ни искать дефектные платы. Дальше — TRAIN AI MODEL.

До и после: чего программа добивается

Папки аномалий такими, какими их видит пользователь

Сравните с папками нормы из раздела 4.5: разница только в положении детали относительно основания.

Маркировка деталей: почему царапина «жирная» и как это настраивается

На корпусах деталей есть маркировка — надписи и штрихи толщиной 1–2 px в кадре. От партии к партии она меняется: другой шрифт, надпись на конденсаторе повёрнута, часть символов стёрта. Если синтетический дефект «царапина» рисовать такой же тонкой линией, сеть не сможет отличить её от штриха маркировки и от шума сенсора и начнёт браковать исправные платы с другой партией деталей.

Синтетика ЗОНА-ПАРА закрывает это с двух сторон. Во-первых, основной брак — смещение элемента — переносит маркировку вместе с корпусом, поэтому надпись не становится признаком: она одинаково выглядит и в норме, и в аномалии. Во-вторых, рисованная линия / царапина по умолчанию жирная (⅛ зоны, не тоньше 3 px) и заведомо не похожа на штрих маркировки. Толщина теперь задаётся явно: поле Толщина линии, px (0 = авто) действует на линию и крест.

Рисованные дефекты (прямоугольник, круг, линия, «пропал элемент», размытое пятно и другие) собраны в сворачиваемой группе Синтетические дефекты поверх вырезки. По умолчанию она свёрнута и выключена: на плате главный брак — смещение. Включайте её для конкретных задач: залитая площадка, лишняя капля, стёртая маркировка.

4.7. Аномалии зон: окно настроек

Кнопка ЗОНА-ПАРА: аномалии зон создаёт классы zone_NNN_anomaly из вырезок нормы. Зоны берутся все, кроме красных (выключенных щелчком на кадре AI Model, раздел 4.3). Классы аномалий нужны не везде: добавляйте их для зон, где брак реально встречается, а остальные зоны модель проверит по узнаванию.

4.8. Оригинал с зонами: бляшки припоя и редактор зоны

Кнопка Оригинал с зонами открывает сохранённый оригинал платы с сеткой. Здесь синтетика делается без камеры: колесо — зум, правая кнопка — панорама, левая — выбор зон (Ctrl — добавить, протяжка — рамкой, Ctrl+A — все), двойной щелчок — редактор зоны.

• Бляшки припоя для выбранных зон… — окно «Бляшки припоя: замыкание между дорожками». Программа сама находит дорожки в зоне (порог Оцу, светлые полосы шириной ≥ 2 px), ставит каплю припоя в зазор между соседними дорожками цветом самих дорожек, с тёмной кромкой и бликом. Настройки: между вертикальными или горизонтальными дорожками, бляшек на снимок 1…3, размер 8…18 % зоны, снимков на зону (5), куда класть — в аномалию или в норму, освещение поверх, в val — новый снимок с другим освещением или точная копия.
• Редактор зоны: инструменты Кисть, Пипетка, Пятно цветом, Копировать область, Вставить, Штамп, Область бляшек; палитра «припой / площадка», «плата», «тень / маска», белый, чёрный; поле «Копий» и кнопка Создать снимок. Так рисуется брак, которого ещё не было на линии: залитая площадка, лишний элемент, отсутствующая маркировка.

Файлы редактора получают имена edit_… и попадают в класс зоны или её аномалии. На вкладке Inspect то же окно открывается только для просмотра.

4.9. Обучение модели

Группа Настройки обучения на вкладке AI Model заполняется сама после первого снимка по зонам: Image Size 128, Model Size s, Epochs 50, Batch 64. Это значения под зоны 108–137 px. Для зон 256 px, как в примере, поставьте Image Size 192 или 256 — вырезка тогда почти не сжимается (на снимке главного окна стоят Epochs 100 и Image Size 192). Проверьте значения и нажмите TRAIN AI MODEL.

5. Инспекция

Вся работа идёт на вкладке Inspect. Модель после обучения уже назначена; остаётся проверить зоны, выставить порог, выбрать источник темпа и, если плата приходит в любом положении, включить живой конвейер.

5.1. Назначить модель и проверить зоны

5.2. Порог узнавания зоны

Для каждой зоны сеть отдаёт вероятности всех классов, но решение принимается только внутри пары. Доля нормы q = p(zone_N) / (p(zone_N) + p(zone_N_anomaly)) умножается на «узнавание» — насколько пара вообще заняла выход сети (полное узнавание при 10 % и выше). Итоговая оценка 0…100 % сравнивается с порогом: выше — normal, ниже — anomaly.

Порог по умолчанию 50 %, хранится в board.json рядом с моделью и применяется сразу, без перезапуска. Ниже 50 % порог уходит в сторону нормы всё сильнее: 25 % → отсечка 6 %, 10 % → 0,4 %, 1 % → почти всё зелёное; 99 % пропускает только уверенные зоны. Такая шкала нужна, чтобы оператор видел разницу между 5 % и 99 %, а не сплошные красные зоны.

5.3. Живой конвейер: плата в любом положении

Галочка Живой конвейер: плата в любом положении включает поиск платы по области привязки перед каждым анализом: кадр совмещается с оригиналом, зоны режутся из совмещённого изображения, а на видео рисуются границы области привязки и зоны (зелёные — норма, красные — аномалия). Поле период, мс задаёт, как часто искать плату (по умолчанию 1000, на снимке 2000). Индикатор рядом: зелёный «норма · точек N», красный «АНОМАЛИЯ · точек N», оранжевый «плата не найдена» или «нет оригинала — зафиксируйте». Вердикт принимается по одному анализу, без накопления.

Оригинал и область привязки фиксируются той же кнопкой Зафиксировать оригинал, что и при съёмке (раздел 4.4); Оригинал с зонами открывает его для просмотра. На видео рисуются границы области привязки и голубые опорные точки, по которым сошлась плата. Зоны, вылезающие за края кадра после выравнивания, пропускаются с меткой SKIP.

5.4. По какому сигналу анализировать

Источник темпа всегда один: включая новый, программа снимает предыдущий.

5.5. Жёлтые зоны: выключить зону кликом

На линии часть зон бывает нужно временно вывести из контроля: элемент не установлен на этой партии, зона закрыта приспособлением, идёт отладка. Для этого не нужно править сетку или модель, зоны выключаются прямо на видео, только на вкладке Inspect.

Что делают жёлтые зоны, задаёт общий чекбокс Жёлтые (отключённые кликом) зоны молчат в окне OUTPUT на вкладке «Звук» (включён по умолчанию):

5.6. Что видно на экране и в консоли

• Над зоной подписан результат; рамка — цветом таблицы зон, при срабатывании по триггеру — красная. Когда зон больше 50, уверенная норма показывается только зелёной рамкой, подписи получают аномалии и неуверенные зоны: сотни подписей на каждом кадре мешали читать картинку и нагружали отрисовку. Жёлтые зоны выключены кликом (раздел 5.5).
• Панель «Анализ по триггеру» внизу вкладки показывает каждую сработку строкой [чч:мм:сс.ммм] Камера вход + ТРИГГЕР 4 мс | ИИ 12 мс #57 и результат по каждой зоне. В базу эти строки не пишутся.
• Правый клик по зоне на видео: «Класс обнаружения в этой зоне → считать это «…»» переименовывает ответ модели для этой зоны (не исправляет модель, но браковщик и журнал увидят новое имя); там же «Сделать браковщик для этой зоны» и счётчик правил.
• Галочка Сохранять снимки инспекции и папка: кадры с нарисованными зонами пишутся файлами inspect_….jpg, настройка своя у каждой камеры.
• Раз в 10 минут в подпапку diag модели пишется кадр живого конвейера и текстовый список зон, хранятся последние 20 снимков — для разбора спорных случаев без роста папки.

6. Триггеры: внешний датчик на вход камеры

Основной режим для конвейера: камера снимает кадр по электрическому сигналу датчика на своём дискретном входе. Это самый точный момент съёмки: изделие всегда в одном месте кадра, а анализ идёт ровно один раз на изделие. Окно ТРИГГЕРЫ собирает связь «датчик → камера» и рисует схему подключения под выбранный разъём.

Распиновка разъёмов

7. Выходы: браковщик, дискретные выходы камер и TCP

Браковщик превращает результат инспекции в действие. Правило создаётся на конкретной зоне (или сразу на всех зонах модели, класса или отмеченных зонах) и срабатывает, когда модель увидела в этой зоне указанный класс. Действий три: TCP-посылка роботу или ПЛК, переключение дискретного выхода камеры и звуковое оповещение оператора. Каждое срабатывание пишется в журнал.

7.1. Справочник ВЫХОДЫ: контакты и проверка тестером

Кнопка ВЫХОДЫ над видео открывает справочное окно, которое ничего не настраивает: оно показывает, на каких контактах выход, как его проверить тестером без питания и как подключить нагрузку.

• Выход — «сухой контакт» оптопары: своего напряжения он не даёт, только замыкает цепь. Нужен внешний источник питания.
• Проверка тестером в режиме Ω: выход ВЫКЛ — обрыв (OL), ВКЛ — сотни Ом. Зуммер прозвонки молчит в обоих случаях, смотрите цифры. Если ничего не меняется — переверните щупы, оптопара полярна.
• Нагрузка: +24 В → лампа → пин «+», пин «−» → GND. Для HIKROBOT 25 мА — предел: сигнальная арматура на 27 мА уже за ним, снизьте питание или поставьте промежуточное реле. Для SICK запас большой, лампа на 20–30 мА подключается напрямую.

7.2. Окно OUTPUT: правило на зону

Кнопка OUTPUT на правой панели (или правый клик по зоне → «Сделать браковщик для этой зоны») открывает окно «OUTPUT — TCP-посылки и дискретные выходы камер». Слева дерево Камеры → модели ИИ → классы → зоны с галочками на зонах; справа вкладки Правила зоны, Журнал срабатываний, База данных.

Одна зона может нести несколько TCP-правил (разные приёмники), не более одного правила дискретного выхода на класс и не более одного звука на класс. Правило хранится в базе и работает из потока инференса: правила держатся в памяти, один поиск по адресу зоны на кадр, а сокеты и SDK камеры трогает отдельный поток-диспетчер, чтобы анализ не ждал сети.

7.3. TCP-посылка роботу или ПЛК

Программа работает как TCP-клиент: подключается к IP-адрес и Порт приёмника, держит соединение открытым и переиспользует его. При обрыве делает одну попытку переподключения и повтора. Строка уходит в UTF-8 с CR+LF в конце.

Пример структурированного шаблона: zoneId={zoneId};zone={zone};class={class};conf={conf};camera={camera};model={model};time={time};date={date};data={data}. Числа всегда в инвариантном формате, чтобы «87,6» не ломал разбор на ПЛК.

• Проверить связь только открывает сокет и сообщает «соединение установлено» или «нет ответа за N мс».
• Отправить тест реально шлёт строку; результат показывается рядом с кнопкой, а не окном.
• Квитирование. Без галочки «повторять» правило шлёт одну посылку при смене класса и повторяет её, пока приёмник не ответит строкой ok <посылка>. С галочкой — повтор по интервалу, пока класс держится.
• «Последняя команда побеждает»: если модель успела дать несколько результатов, пока диспетчер занят, уйдёт последний. Очередь ограничена 512 заданиями.

7.4. Дискретный выход камеры

Кнопки Включить выход, Выключить выход, Импульс проверяют пин тестером или лампой; Что умеет камера опрашивает все способы и печатает отчёт. Ручные тесты пишутся в тот же журнал.

7.5. Звуковое оповещение: свой звук на каждую зону

Третий тип правила — звук на компьютере с программой. Оператору не нужно смотреть на экран: по сигналу он слышит, что зона ушла в брак, а разные звуки на разных зонах подсказывают, где именно. Звук доступен для любых камер, включая USB и RTSP, у которых нет дискретных выходов.

7.6. Журнал срабатываний и база данных

Вкладка Журнал срабатываний показывает последние 300 записей строками ЧЧ:ММ:СС.ммм ✔/✖ Камера · Модель · Класс · Зона → Действие [сообщение] и обновляется живьём. Кнопки Обновить и Очистить журнал.

Вкладка База данных: программа хранит всё в файле SQLite rejectors.db рядом с exe — отдельной службы нет, порт не слушается, ничего устанавливать не нужно. Таблицы: settings (настройки), cameras (профили камер), camera_models (модели на камерах), zones (имена и геометрия зон), rejectors (правила), reject_log (журнал), camera_param_files (копии параметров камер), camera_presets (наборы настроек камер). Сохранить копию базы… делает целостный снимок командой VACUUM INTO прямо на работающей базе; Загрузить базу из копии… восстанавливает, предварительно сохранив текущую. Базу можно смотреть в DBeaver, не закрывая программу; писать в неё извне не стоит.

8. Другие режимы и задачи

Обычные модели: normal / anomaly и любые классы

Тот же редактор ROI работает и для обычной классификации: таблетки, крышки, этикетки, детали в ложементе. Классы задаются в диалоге «Новая ИИ модель» (по умолчанию normal и anomaly, имена латиницей), зоны ставятся на изделия, кнопка Сделать снимок с числом кругов 1…50, серия Создать снимки по камере (кадр/с) или по энкодеру. Панель Синтетика для ИИ: точные повороты 90°/180°, полный оборот 360° с шагом и диапазоном, зеркало, «классы по градусам» (каждый угол в свой класс — браковщик отправит угол по TCP), диапазоны яркости и контраста. Обучение — с полными аугментациями Ultralytics. Порог уверенности для таких моделей задаётся там же, где и для ЗОНА-ПАРА — на вкладке Inspect.

Много-модельная инспекция (слоты 1–20)

На одной камере можно держать до 20 моделей: Добавить ONNX в слот, затем ROI → Добавить класс в выбранную модель — у каждой модели в слоте своя разметка зон, результаты всех моделей показываются на одном кадре.

Когда много-модельность всё же применяется:

Порог, темп анализа, жёлтые зоны и правила браковщика действуют на все модели камеры. Кнопка УБРАТЬ МОДЕЛЬ очищает и слоты, поэтому спрашивает подтверждение; Удалить выбранную убирает одну модель из слота, её файлы и зоны в базе остаются.

Общие модели

Кнопка ОБЩИЕ МОДЕЛИ сохраняет набор «камера → модель» под именем: Создать из текущих моделей, Применить ко всем камерам, Обновить из текущих, Переименовать, Удалить набор. Переход стенда из восьми камер на другое изделие — один выбор. Удаление набора убирает только группировку: папки, ONNX, зоны и правила остаются. Зоны принадлежат паре «камера + модель»: одна модель на восьми камерах — восемь независимых разметок.

Энкодер и браковщик по конвейеру

Для линий с энкодером на COM-порту (115200, ESP32): подключение CONNECT ENCODER, автоподключение, позиция, шаг снимка и коррекция, Установить ноль + СНИМОК. Съёмка для обучения и анализ могут идти «По энкодеру» — кадры равномерны по пути изделия. Старый браковщик по времени с задержкой и антиспамом отправляет команду REJECT на контроллер энкодера.

Запись видео и снимки

Вкладка Settings: НАЧАТЬ ЗАПИСЬ ВИДЕО с активной камеры в файл record_дата_время.avi (MJPG, реальный FPS камеры). Снимки для обучения — real_….jpg, снимки инспекции — inspect_….jpg с нарисованными зонами.

9. Настройки, консоль, требования и лицензия

Settings

• СОХРАНИТЬ В ФАЙЛ / ЗАГРУЗИТЬ ИЗ ФАЙЛА — все настройки (камеры, модели, правила) в JSON, удобно перед переустановкой или для переноса на второй компьютер. Источник истины — база, JSON — страховка на случай её недоступности. Каждое изменение настроек сохраняется автоматически.
• СБРОСИТЬ НА НАЧАЛЬНЫЕ — необратимо: удаляет конфиг и раскладку окон.
• Язык интерфейса — 14 языков; главное окно переключается сразу, остальные окна — при следующем открытии.
• Положение, размер и монитор всех окон, позиции разделителей — в базе; при отключённом мониторе окно возвращается в видимую область.

Console

Галочки «Камеры» и «Триггер» по умолчанию сняты и включают показ соответствующих сообщений (в режиме триггера сообщения камеры идут в «Триггер»); в файлы logs\engiai-*.log пишется всё и до фильтров. Консоль рассчитана на недели работы без внимания: на экране держится 800 строк, при 1000 старые 200 удаляются; новые строки собираются пачкой 4 раза в секунду, а не по одной; автопрокрутка вниз включена, пока вы сами не прокрутили вверх; звука у консоли нет. Смены класса зон пишутся не чаще 10 строк в секунду (остальное сворачивается в счётчик), файл журнала делится по 20 МБ, файлы старше 14 дней удаляются при запуске, журнал срабатываний в базе хранит последние 20 000 записей. Необработанные ошибки — в crash.log, причины принудительного завершения — в runtime.log рядом с exe. Если что-то работает не так — смотрите сюда в первую очередь.

Требования

Лицензия и пробный режим

При запуске программа обращается к серверу лицензий engi.live; отправляются только хэши идентификаторов оборудования и версии, без серийников и имён пользователей. Если сервера нет, а разрешение закэшировано — программа работает по кэшу (для линий без интернета). Без лицензии действует пробный режим 20 минут: в заголовке окна и в строке ИИ идёт отсчёт «ТЕСТ ММ:СС», кнопка КУПИТЬ на вкладке Settings открывает страницу покупки. При действующей лицензии отсчёта нет.

10. Короткий чек-лист и поиск неисправностей

Чек-лист с нуля для платы

Если что-то пошло не так

engiAI Ethernet System. Все названия кнопок и полей в руководстве приведены так, как они отображаются в программе на русском языке. Снимки экрана сделаны на модели «model_4» (две зоны 256×256: конденсатор C30 и мост BR1), USB-камера 3264×2448, модель обучена в оттенках серого. Редакция 3, сентябрь 2026: пример на двух зонах, формирование папок модели, область привязки, синтетика «элемент с основанием» с картинками «до / после», палитра и толщина линии, красные зоны, консоль.