Files
Balsam_167/UKSSTMS320F28335
Andrey bbd82b3a4e Перенести улучшения 166 и добавить сборку для M95M02 и Flash
Восстановить телеметрию CAN, обработку TESTLAMP и сохранение команд при загрузке параметров.

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

Проверки: хостовые тесты, реальные сборки TI C2000, контроль COFF/SCI8 и защита записи при активной нагрузке.
2026-10-19 16:33:28 +03:00
..

Сборка Бальзам-167

Проект CCS использует TMS320F28335, модель памяти large и ABI COFF. Исходники и русские комментарии сохранены в UTF-8 без BOM. Кодировка проекта задана в .settings/org.eclipse.core.resources.prefs, правило редактора — в ../.editorconfig. Подробная проверка покрытия: COMMENT_AUDIT.md.

Версия и паспорт прошивки

Текущий номер 1.1.2 задаётся в firmware_version.h: major/minor 0..255, patch 0..999. Меняйте только три числовых определения версии и выполняйте Clean/Rebuild. firmware_identity.json хранит product/target.

Debug и Release вызывают prepare_identity.py. Он читает номер версии и передаёт его общему генератору паспорта. generated/firmware_identity.h и JSON создаются в каталоге сборки; вручную их редактировать не нужно. Паспорт включает исходный коммит, признак незакоммиченных изменений и время UTC. Порядок проверки приведён в FIRMWARE_IDENTITY.md.

Зависимости и настройки CCS

Для текущих конфигураций нужны Python, Git и TI C2000 22.6 LTS. Debug и Release используют оптимизацию уровня 3 и приоритет размера --opt_for_speed=0. Основной аппаратный профиль — M95M02-DR, 256 КиБ. Локальный проверенный выпуск после переноса доработок 166 находится в Bin/Final167/M95M02: EEPROM/RAM SCI8 занимает 34 120 байт при пределе 261 884. AT25256B остаётся явным альтернативным профилем, однако текущий полный образ превышает её предел; защищённый выпуск не разрешает такой BIN. Общая реализация УМП и порт TMS320F28335 подключаются из ../newProject/SETGUI/third_party/templates/c/set-protocol относительно корня репозитория. shared_ump.c включает эту реализацию и модуль паспорта.

В .cproject обе конфигурации используют локальные prepare_identity.py и publish_identity.py. Генератор паспорта и Git-ревизия зависимости берутся из той же копии SETGUI/third_party/templates, из которой компилируется общий C-код. Инструмент конверсии postcompile.bat находится в K:/git_project/newProject/templates/tools/firmware-build/ccs. При переносе проекта проверьте оба пути, Include Options и каталог назначения BIN.

Защищённый post-build вызывает общий postcompile только во временный каталог. До публикации проверяются аппаратный профиль по MAP, размер до параметров EEPROM, структура SCI8, RAM-адреса, встроенный паспорт, manifest и SHA-256. Поле eeprom различает AT25256B и M95M02. Текущий каталог копирования задан в .cproject: K:/git_project/newProject/SETGUI/..periph_28335/firmware/periph28335/balzam167.

COM_1 работает на 115200 с FIFO. COM_2 использует 9600 для OWEN либо 115200 для другого режима. Эти скорости задаются в main.c.

Профиль EEPROM и GAS

В Source/Internal/Include/eeprom_config.h значение EEPROM_M95M02=0 выбирает AT25256B 32 КиБ; значение 1 — M95M02-DR 256 КиБ и выбрано по умолчанию. Выбор обязан соответствовать микросхеме на плате. После изменения нужен Clean/Rebuild. При отдельной сборке определение должно совпадать у компилятора и у препроцессора линкера.

GAS включается только при значении 1: технологические слова 0x5000..0x507F и дескриптор только для чтения 0x5F00..0x5F07. Транспорты — Modbus RTU и служебный CAN УМП. Карта и измеренные размеры: GAS_167_M95M02.md. Подробное назначение модулей: SOURCE_GUIDE.md.

Проверки

Запускайте из корня репозитория Python-скрипты tests/comments/run_test.py, tests/gas167/run_test.py, tests/eeprom_profiles/run_test.py, tests/load_control/run_test.py и проверки регистратора в tests/ump_logger. Проверка FIFO: tests/rs232_fifo/run_test.py --cc <путь к GCC>. Для MinGW каталог исполняемых файлов GCC должен присутствовать в PATH.

Полезные доработки из ветки 166

В 167 перенесены heartbeat CAN 1 Гц, отправка изменившихся данных, повтор каждого подтверждённого пакета через 1,3 с, повтор после потери ACK и защита границы R127. R96/R97 теперь включают потоки: 0 выключает соответствующую маску, любое ненулевое значение разрешает её. Значение больше не задаёт делитель периода. R0–R3 пульта находятся в быстрой маске; служебный канал УМП/GAS и опрос OWEN сохраняются. Подробности: PERIPH28335_CAN.md.

TESTLAMP включается после двух секунд непрерывного удержания физической кнопки. Время считает Timer1, поэтому занятость главного цикла и EEPROM не меняет задержку. Порядок индикаторов в профиле 167 сохранён.

Загрузка и заводской сброс параметров сохраняют действующие START/RESET готовой платы нагрузки. Сохранённое в EEPROM слово команд не подаётся автомату даже на промежуточный такт. Новый автомат защиты нагрузки и регистратор 167 сохранены.

Проверки переноса: tests/can_telemetry/run_test.py, tests/can_vpu_rx/run_test.py, tests/can_timeout/run_test.py, tests/testlamp/run_test.py --cc <путь к GCC> и tests/load_control/run_test.py. Проверки защищённого выпуска: tests/firmware_identity/test_release.py.

Внутренняя Flash

В 167 добавлен отдельный Flash-вариант на основе ветки прошивка-через-flash (437f250) с сохранением текущих CAN, GAS, регистратора и защиты нагрузки. Основной F28335.cmd размещает .text в RAM. Альтернативный F28335_flash.cmd размещает код во FlashH, константы и инициализацию — во FlashG, аппаратный переход codestart — по адресу слова 0x33FFF6. Предстартовый код TI отключает watchdog до входа в _c_int00, чтобы холодный запуск не прерывал инициализацию C. ramfuncs копируются в RAML4 до InitFlash; автономный RS-программатор и TI Flash API копируются из FlashF в RAML0 до стирания.

Штатный защищённый postbuild вызывает build_flash.py и выпускает оба варианта с одним паспортом текущей компиляции. Требуется официальный TI Flash API v2.10 для F28335; его каталог задаётся TI_FLASH_API_ROOT либо штатным путём controlSUITE. Перед публикацией проверяются COFF официальным ofd2000, точные LOAD/RUN, точка входа, содержимое SCI8 и побайтное совпадение загружаемых слов COFF/SCI8.

Проверенный локальный комплект: Bin/Final167/M95M02.

Файл Назначение
firmware_9858046+.bin M95M02 → RAM, 34 120 байт SCI8
firmware_flash.out Первичная запись внутренней Flash через JTAG, COFF с символами
firmware_flash_rs.bin Обновление внутренней Flash по RS, 39 494 байта SCI8

Паспорта Flash дополнены execution=FLASH и image_format=COFF либо SCI8-FLASH; поле eeprom=M95M02 описывает отдельную память параметров. Для запуска после сброса аппаратные boot-перемычки должны выбирать Flash. При SPI boot загружается EEPROM/RAM-образ из M95M02.

Команда записи Flash на плате нагрузки отклоняется кодом 0x1005, пока штатный STOP не завершён и SPI не подтвердил отправку текущего кода 4 мА. Probe не останавливает нагрузку. После начала стирания IRQ запрещены, все вызовы остаются в RAM, boot-переход записывается последним. При ошибке записи может потребоваться восстановление через JTAG: резервного Flash-образа нет. Сборка, хостовые проверки и дизассемблер не заменяют проверку записи и самостоятельного запуска на стенде; физическая плата в этой работе не прошивалась.

Помощник настройки linker

Общая утилита и инструкция находятся в соседнем репозитории templates/tools/c2000-linker. Она создаёт стартовые карты COFF для TMS320F28335 и TMS320F2812 в режимах RAM/Flash, объясняет LOAD/RUN и проверяет физические пересечения памяти. Профильные особенности платы и внешняя XINTF RAM задаются в проекте.

EEPROM M95M02 хранит загрузочный поток SCI8. Её 256 КиБ не являются CPU-адресуемым расширением RAM и не добавляются в MEMORY linker-файла. В текущем RAM-варианте .text занимает внутренние RAML0–RAML3, а .cinit и константы — RAML4. При Flash-варианте код и константы загружаются во Flash, а секции ramfuncs и автономного программатора имеют отдельные LOAD и RUN.