Перенести улучшения 166 и добавить сборку для M95M02 и Flash

Восстановить телеметрию CAN, обработку TESTLAMP и сохранение команд при загрузке параметров.

Выбрать M95M02 основным профилем, добавить самостоятельную Flash-сборку и проверять образы до публикации.

Проверки: хостовые тесты, реальные сборки TI C2000, контроль COFF/SCI8 и защита записи при активной нагрузке.
This commit is contained in:
2026-10-19 16:33:28 +03:00
parent 985804607d
commit bbd82b3a4e
42 changed files with 1820 additions and 321 deletions
+11 -9
View File
@@ -60,16 +60,18 @@ SPI-загрузчика и драйвера, а не только правка
выбор. Не задавайте противоречащий ему отдельный define только компилятору CCS:
тогда компилятор, линкер и проверка BIN могут получить разные настройки.
### Сборка скриптом
### Отдельная сборка
```powershell
./build_logger.ps1 -Eeprom AT25256B -OutputDirectory ./Bin/EepromProfiles/AT25256B -ImageName UKSSTMS320F28335_AT25256B
./build_logger.ps1 -Eeprom M95M02 -OutputDirectory ./Bin/EepromProfiles/M95M02 -ImageName UKSSTMS320F28335_M95M02
```
Параметр скрипта передаётся компилятору, линкеру и проверке размера; исходный
config не меняется. Скрипт по умолчанию собирает AT25256B. Рядом с BIN создаются
manifest и SHA-256; поле `eeprom` в manifest различает аппаратные варианты.
Скрипт `build_logger.ps1` отсутствует в текущем дереве. Для штатного выпуска
выберите профиль в заголовке и выполните Clean/Rebuild CCS.
`UKSSTMS320F28335/prepare_identity.py` подготавливает паспорт;
`UKSSTMS320F28335/publish_identity.py` проверяет и публикует результат TI.
При отдельной сборке явный выбор `--eeprom AT25256B` или `--eeprom M95M02`
в обоих Python-шагах должен совпадать с `EEPROM_M95M02` у компилятора и
препроцессора линкера. Защищённый postbuild сверяет профиль с символами MAP,
проверяет структуру SCI8, встроенный паспорт и предел до параметров EEPROM
перед копированием в постоянные каталоги. Рядом с BIN создаются manifest и
SHA-256; поле `eeprom` в manifest различает аппаратные варианты.
UART остаётся 115200; алгоритм UART и FIFO не изменялся.
| Параметр | AT25256B | M95M02-DR |
+32 -38
View File
@@ -15,42 +15,36 @@
| `UKSSTMS320F28335/firmware_identity.json` | Product и target; версия берётся из C-заголовка |
| `Source/Internal/shared_ump.c` | Подключение общей таблицы версии и привязка к UMP ПМ35 |
| `UKSSTMS320F28335/prepare_identity.py` | Генерация идентичности из C-заголовка перед CCS Debug/Release |
| `build_logger.ps1` | Полный CLI build: prepare, compile, link, SCI8, size check, seal |
| `build_bin.bat` | Debug post-build: проверка SCI8 и паспорт конечного BIN |
| `UKSSTMS320F28335/publish_identity.py` | Защищённый post-build Debug/Release: SCI8, встроенный паспорт, профиль EEPROM, размер, manifest и SHA |
| `tests/firmware_identity/port_test.c` | Host-проверка привязки версии к реальному порту 167 |
Номер `0.1.0` — начальная версия разработки этого механизма; он не выдаётся за
историческую версию предыдущих BIN. Назначайте release-номер вручную перед выпуском.
## Сборка из PowerShell
## Выпуск и отдельные проверки
Из корня 167:
Скрипты `build_logger.ps1` и `build_bin.bat` отсутствуют в текущем дереве.
Штатный выпуск выполняется через Clean/Rebuild CCS с оптимизацией
`-O3 --opt_for_speed=0`. Обе конфигурации вызывают `prepare_identity.py`
перед компиляцией и `publish_identity.py` после линковки.
```powershell
./build_logger.ps1 -OutputDirectory "$PWD/Bin/FirmwareIdentity" `
-ImageName UKSSTMS320F28335
```
Prebuild сохраняет заголовок и JSON в `${BuildDirectory}/generated`.
Защищённый postbuild сначала вызывает общий конвертор во временный каталог,
затем проверяет границы EEPROM, структуру SCI8, точку входа и адреса RAM,
ровно один встроенный паспорт текущей компиляции и весь комплект manifest/SHA.
Аппаратный профиль сверяется с абсолютными символами EEPROM в карте линкера.
Ошибка любой проверки не публикует новый BIN или архив.
По умолчанию применяется `-O2 --opt_for_speed=0`. Результаты:
Проверенный выпуск сохраняется в `${BuildDirectory}/firmware` вместе с
manifest и SHA-256. Архив содержит OUT и сопроводительные файлы; его копия
передаётся в каталог, заданный аргументом `--export` в `.cproject`.
Поле `eeprom` в manifest обязательно различает AT25256B и M95M02.
```text
Bin/FirmwareIdentity/UKSSTMS320F28335.bin
Bin/FirmwareIdentity/UKSSTMS320F28335.bin.manifest.json
Bin/FirmwareIdentity/UKSSTMS320F28335.bin.sha256
Bin/FirmwareIdentity/generated/firmware_identity.h
Bin/FirmwareIdentity/generated/firmware_identity.json
```
Проверка файла перед передачей:
```powershell
python ../newProject/SETGUI/third_party/templates/c/firmware-info/tools/identity.py verify `
--image Bin/FirmwareIdentity/UKSSTMS320F28335.bin `
--manifest Bin/FirmwareIdentity/UKSSTMS320F28335.bin.manifest.json
```
CLI принимает `-TemplatesRoot`, если общий checkout расположен иначе. Все
исходники общего механизма собираются непосредственно из этого checkout.
При отдельной сборке параметры обоих Python-шагов можно посмотреть через
`--help`. Явный `--eeprom` должен совпадать с define компилятора и линкера.
Паспорт зависимости относится к фактически компилируемой копии
`SETGUI/third_party/templates`; инструменты конверсии остаются в соседнем
основном checkout `templates`.
## Сборка CCS
@@ -62,7 +56,7 @@ Pre-build требует Python 3.10+ и Git в PATH процесса CCS. `Gene
этому проекту: не запускайте Debug/Release одновременно. Для параллельных
сборок используйте CLI с разными output-каталогами.
Штатный Debug post-build создаёт в `Bin`:
Штатный post-build Debug/Release создаёт в `${BuildDirectory}/firmware`:
```text
UKSSTMS320F28335_<commit>.bin
@@ -70,12 +64,9 @@ UKSSTMS320F28335_<commit>.bin.manifest.json
UKSSTMS320F28335_<commit>.bin.sha256
```
Имя BIN исторически содержит HEAD без dirty-суффикса; достоверные признаки dirty
находятся внутри ответа версии и паспорта. Не определяйте чистоту только по имени.
Release-конфигурация получает embedded identity через pre-build, но её старый
проект не имел автоматического BIN post-build. Для готового проверенного BIN с
паспортом используйте описанный CLI либо настройте release-конверсию по общей
инструкции; нельзя запускать Debug `build_bin.bat` на Release и ожидать другой `.out`.
Идентификатор в имени BIN соответствует встроенному Build ID; знак `+`
обозначает незакоммиченные изменения приложения либо компилируемой зависимости.
Полная ревизия и состояние обоих деревьев находятся в паспорте.
Если CCS пишет `Error ... (ignored)`, сборка не считается успешной: убедитесь,
что последняя проверка и `seal` завершились без ошибок. Старый BIN с таким же
@@ -119,14 +110,17 @@ CAN ПМ67 не переназначается. Запись функции 06
## Влияние на память и параметры
С проверенными настройками текущий образ занимает **32 286 байт**, предел —
**32 508**, запас **222 байта**. Механизм добавил 116 байт относительно сборки
без него. Это результат конкретной сборки, не обещание для следующих изменений.
Историческая сборка при внедрении механизма занимала **32 286 байт** при
пределе AT25256B **32 508 байт**. Этот результат не относится к текущему
полному набору функций. Основной профиль теперь M95M02, его предел до
параметров — **261 884 байта**; актуальные результаты сборок приведены в
`UKSSTMS320F28335/README.md`. Postbuild проверяет размер каждого выпуска заново.
Таблица версии — часть `.econst` прошивки. Её не сохраняют в область параметров;
старые настройки не могут подменить версию после обновления. Размер буфера лога
и размещение EEPROM-параметров не менялись. Дата не разбирается на MCU, SHA-256
не вычисляется на MCU. Проверка размера `check_firmware.ps1` остаётся обязательной.
не вычисляется на MCU. Проверка размера встроена в `publish_identity.py` и
выполняется до публикации каждого нового BIN.
## Проверки и ограничения
+1 -1
View File
@@ -43,7 +43,7 @@ CLI define EEPROM_M95M02 должен передаваться и компиля
| 0x5F04 | 0x5000 | Начало технологических регистров |
| 0x5F05 | 128 | Количество технологических регистров |
| 0x5F06 | 7 | Бит 0: RTU; бит 1: служебный CAN; бит 2: запись FC06 |
| 0x5F07 | 1 | EEPROM M95M02 |
| 0x5F07 | 1 / 2 | 1 — EEPROM M95M02 с исполнением из RAM; 2 — отдельный образ исполнения из внутренней Flash |
В сборке AT25256B эти адреса отклоняются как недопустимые; сигнатуру GAS она не возвращает.
+3 -3
View File
@@ -138,8 +138,8 @@ GAS предоставляет доступ к тем же значениям `m
| `0x005D` | 93 | `0x505D` | 20573 | 5093 | 6093 | `sens_lo_edge[21]` | RW |
| `0x005E` | 94 | `0x505E` | 20574 | 5094 | 6094 | `sens_lo_edge[22]` | RW |
| `0x005F` | 95 | `0x505F` | 20575 | 5095 | 6095 | `sens_lo_edge[23]` | RW |
| `0x0060` | 96 | `0x5060` | 20576 | 5096 | 6096 | `Cancount[m_FAST]` — пауза быстрых посылок CAN | RW |
| `0x0061` | 97 | `0x5061` | 20577 | 5097 | 6097 | `Cancount[m_SLOW]` — пауза медленных посылок CAN | RW |
| `0x0060` | 96 | `0x5060` | 20576 | 5096 | 6096 | `Cancount[m_FAST]` — включение быстрого потока CAN: 0 выключен, иначе включён | RW |
| `0x0061` | 97 | `0x5061` | 20577 | 5097 | 6097 | `Cancount[m_SLOW]` — включение медленного потока CAN: 0 выключен, иначе включён | RW |
| `0x0062` | 98 | `0x5062` | 20578 | 5098 | 6098 | `Brightness` / `Bright[0]` — яркость | RW |
| `0x0063` | 99 | `0x5063` | 20579 | 5099 | 6099 | `Owncount` / `Bright[1]`; LOAD: исходное значение АЦП | RW |
| `0x0064` | 100 | `0x5064` | 20580 | 5100 | 6100 | `Bright[2]`; `Current_count`: исходное значение канала 0 | RW |
@@ -186,7 +186,7 @@ GAS предоставляет доступ к тем же значениям `m
| `0x5F04` | 24324 | `0x5000` | База технологических GAS-регистров |
| `0x5F05` | 24325 | `128` | Число технологических регистров |
| `0x5F06` | 24326 | `0x0007` | Возможности: бит 0 — RTU, бит 1 — служебный CAN, бит 2 — FC06 |
| `0x5F07` | 24327 | `1` | Аппаратный вариант EEPROM M95M02 |
| `0x5F07` | 24327 | `1` / `2` | Исполнение: `1` — загрузка из M95M02 в RAM, `2` — внутренняя Flash; физическая EEPROM указывается отдельно в manifest |
Все восемь слов — **RO**. В сборке AT25256B GAS-адреса, включая этот блок, отклоняются с кодом недопустимого адреса.
+15
View File
@@ -69,6 +69,21 @@ UMP_CAN_service(). Ожидания передачи в цикле нет. Пе
## Формат кадров
После переноса планировщика из ветки 166 штатная телеметрия MBOX0 передаёт
изменённые трёхсловные пакеты и повторяет каждый подтверждённый пакет через
1,3 с. Изменения обнаруживаются с шагом 20 мс; потоки обслуживаются по очереди,
поэтому включённая быстрая маска не блокирует медленную. R0–R3 пульта находятся
в быстрой маске. При свободной шине и своевременном ACK обновления R3 проходят
не реже одного раза за 20 мс, что проверяется хостовой моделью.
R96/R97 сохраняют прежние адреса, но теперь являются выключателями потоков:
ноль отключает соответствующий поток, любое ненулевое значение включает.
Значение больше не умножается на период 20 мс. Отдельный heartbeat с адресом
`0x0100` и счётчиком секунд передаётся с частотой 1 Гц независимо от этих настроек.
Кэш обновляется только после аппаратного ACK. При ошибке пакет остаётся
неподтверждённым; повтор разрешается после секундной паузы. Служебный канал
УМП/GAS продолжает использовать отдельный MBOX2.
CAN 2.0B, расширенный ID, 8 байт данных. Порядок соответствует существующей
прошивке: MDL (слова 1,2), затем MDH (заголовок, слово 0). Каждое слово
содержит сначала старший байт.