Record PM67 ZPT voltages in UMP logger v3

Doc/UMP_LOGGER.md

@@ -35,10 +35,10 @@ EEPROM не используется: под отключением в этой
 ## Память и точность
 
 Использована существующая секция `.logg` по адресу 0x200000: 64000
-16-битных слов. Два банка по 800 записей × 40 слов занимают её целиком.
-Текущий банк кольцевой. При триггере сохраняются последние до 399 записей,
+16-битных слов. Два банка по 760 записей × 42 слова занимают 63840 слов (160 слов свободны).
+Текущий банк кольцевой. При триггере сохраняются последние до 379 записей,
 добавляется событие отключения, оставшаяся половина банка отведена
-постинтервалу. При 20 мс это до примерно 8 секунд до отключения и 1 секунды
+постинтервалу. При 20 мс это до примерно 7.6 секунды до отключения и 1 секунды
 после. Дополнительные события CAN и дискретов сокращают временную глубину.
 
 При интенсивном потоке событий или периоде 1 мс постинтервал может заполнить
@@ -51,7 +51,7 @@ EEPROM не используется: под отключением в этой
 одинаковую отметку; порядок сохраняется порядком записей. На перезапуске
 регистратора счётчик продолжает прежнюю шкалу, при перезагрузке платы — 0.
 
-Онлайн-опрос возвращает три последних записи каждые 40 мс. Он не гарантирует
+Онлайн-опрос возвращает две последние записи каждые 40 мс. Он не гарантирует
 передачу каждого события при высоком CAN-трафике, медленном UART или паузах
 GUI. Номера записей позволяют убрать дубликаты и явно показать пропуски.
 Полный сохранившийся фрагмент следует читать кнопкой архива. Частота 20 мс
@@ -63,7 +63,7 @@ GUI. Номера записей позволяют убрать дублика
 EEPROM, выделения памяти или копирования целого банка. Реальную задержку
 прерываний и длительность критических секций нужно измерить на F28335.
 
-## Состав записи: 40 слов
+## Состав записи v3: 42 слова
 
 | Слова | Данные | Единицы/смысл |
 |---|---|---|
@@ -91,6 +91,16 @@ EEPROM, выделения памяти или копирования целог
 | 33–34 | эффективные dac_go/dac_stop + 4 | 0.1 мА после ограничений алгоритма; GUI переводит в мА |
 | 35 | kod | целочисленное положение, используемое Anal_output |
 | 36–39 | ADC_table[0..3] | значения таблицы АЦП в исходном масштабе прошивки |
+| 40 | ЗПТ1: U1 + U2, ПМ67 регистр 306 / индекс 305 | исходное 16-битное слово без пересчёта |
+| 41 | ЗПТ2: U3 + U4, ПМ67 регистр 9 / индекс 8 | исходное 16-битное слово без пересчёта |
+
+Напряжения принимаются из технологических CAN-кадров с нулевыми индексами
+305 и 8. Учитываются все три позиции и биты маски 0x8000/0x4000/0x2000.
+Они хранятся отдельно от массива modbus[0..127], обновляются и при выключенном
+логгере. Запись содержит последние принятые значения; до первого приёма — 0.
+При потере связи остаётся последнее значение: отдельного признака свежести нет.
+Масштаб и знаковость физического напряжения не заданы исходной таблицей;
+SetGUI показывает исходное беззнаковое слово, коэффициент задаётся в интерфейсе.
 
 **Отправленный код ЦАП не является измеренным током выхода.** В этом проекте
 не установлено, какой вход аппаратно измеряет ток ЦАП. При включённом
@@ -116,9 +126,9 @@ FC03, 0x1000, 16 слов:
 
 | Смещение | Значение |
 |---|---|
-| 0,1 | 0x554D, версия 2 |
+| 0,1 | 0x554D, версия 3 |
 | 2,3 | состояние и число записей выбранного источника |
-| 4,5 | 40 слов в записи, 800 записей в банке |
+| 4,5 | 42 слова в записи, 760 записей в банке |
 | 6 | период периодических снимков, мс |
 | 7,8 | счётчик времени, младшее/старшее слово |
 | 9,10 | Desk (требуется 6 / dsk_LOAD), Mode |
@@ -133,25 +143,28 @@ FC03, 0x1000, 16 слов:
 FC06:
 - 0x1000: 1 — новый текущий журнал, 0 — остановить его;
 - 0x1001: период 1..1000, менять только при остановленном журнале;
-- 0x1002: хронологический индекс первой записи окна 0..799;
+- 0x1002: хронологический индекс первой записи окна 0..759;
 - 0x1003: источник окна, 0 — текущий остановленный банк, 1 — архив отключения.
 
-FC03, 0x1010, до 120 слов: окно до трёх записей от установленного индекса.
+FC03, 0x1010, до 120 слов: окно от установленного индекса; для целых записей v3 читать 42 или 84 слова.
+CAN допускает 42/84 и прежние размеры 40/80/120; RTU допускает 1..120 слов.
 Чтение текущего банка этим окном во время записи не выдаёт изменяющиеся
 данные. GUI сначала останавливает его; архив можно читать при работающем
 текущем банке. После всех блоков GUI повторно проверяет поколение архива;
 при замене во время чтения результат не подменяет предыдущий график.
 
 FC03, 0x1100, ровно 124 слова: онлайн-блок. Слова 0,1 — 32-битный номер
-первой записи, 2 — число записей 0..3, 3 — поколение архива, далее до трёх
-записей по 40 слов. Неиспользованные слова равны нулю. Окно онлайн не
+первой записи, 2 — число записей 0..2, 3 — поколение архива, далее до двух
+записей по 42 слова. Неиспользованные слова равны нулю. Окно онлайн не
 зависит от курсора/выбора архива. Разделение 0x1010 и 0x1100 предотвращает
 пересечение двух окон.
 
 Недопустимые диапазоны и значения возвращают исключения Modbus 2/3.
 CRC и разбор стандартного ответа GUI используют существующее общее ядро.
-Расширение описано отдельно в core/ump_logger.py, без изменения общей
-библиотеки и без необходимости пересобирать её DLL.
+SetGUI распознаёт v2 (40 слов, 800 записей) и v3 (42 слова, 760 записей).
+Для v2 новые напряжения недоступны (NaN), для v3 доступны графики и CSV.
+CAN-валидация общей библиотеки расширена размерами 42/84 слова.
+Исходники протокола подключаются к прошивке из templates/c/set-protocol.
 
 ## Проверка и запуск
 
@@ -176,3 +189,6 @@ TI. Отдельно выполнена синтаксическая прове
 подать откл. → через секунду прочитать архив → сверить код ЦАП, ток внешним
 измерителем и физические входы/выходы; затем повторить с разрывом RS.
 Период 1 мс проверить отдельно под максимальной CAN-нагрузкой.
+
+Для сборки v3 нужен templates/main начиная с коммита c0ee7c4
+(поддержка CAN-чтения 42/84 слов и порт TMS320F28335).