Обновить Flash/CAN, версии сборок и управление периферией

Добавить защищённое обновление приложения через RS и CAN с сохранением
загрузчика, проверкой CRC, восстановлением передачи и защитой EEPROM.
Подключить общий процесс сборки C2000 и автоматический счётчик версии
для согласованных RAM, Flash, CAN и паспортов бинарных образов.

Уточнить запуск ЦАП, обработку измерений и параметров нагрузки,
начальную индикацию и документацию регистров GAS.
Дополнить модели аппаратуры и изолировать заголовки CAN в тестах.

Проверка: 26 тестов выпуска, 4 теста восстановления CAN и восемь
программных моделей CAN, Flash, EEPROM, ЦАП, параметров и TESTLAMP.
This commit is contained in:
2026-11-06 16:11:11 +03:00
parent bbd82b3a4e
commit 05be38a04a
52 changed files with 1328 additions and 690 deletions
+4
View File
@@ -62,3 +62,7 @@
/Bin/Final167/
# Временные объекты отдельной Flash-сборки зависят от установленного TI toolchain и не входят в исходники.
/Bin/Flash167/
# Объекты и OUT постоянного CAN-загрузчика воспроизводятся локальной сборкой TI.
/Bootloader/build/
# Проверенный комплект приложения CAN A/B хранится локально и не входит в исходники.
/Bin/Can167/
+87
View File
@@ -0,0 +1,87 @@
# Обновление внутренней Flash F28335 по CAN
В постоянный загрузчик ProtoCAN добавлена запись приложения во внутреннюю Flash.
Сектор A (`0x338000…0x33FFFF`, адреса в 16-битных словах) остаётся загрузчиком;
обновляются только B–H (`0x300000…0x337FFF`). RS-232 и обновление EEPROM A/B
сохраняют прежние команды. Поддерживается текущая аппаратная конфигурация M95M02:
её неактивный слот используется для временного хранения полного образа.
## Первичная установка
1. Собрать обновлённый постоянный загрузчик из зависимости SETGUI:
```powershell
python K:/git_project/newProject/SETGUI/third_party/templates/c/protocan-boot/projects/build.py --device f28335 --configuration Release --output K:/git_project/28335_periph/outputs/can-flash-20261021/loader
```
Нужны установленный TI C2000 COFF compiler и официальный TI Flash API v2.10
F28335. Его include/lib подключены в Debug и Release CCS-проекта.
2. Через JTAG установить новый `F28335_CAN_AB.out` **только в сектор A**.
Использовать существующий режим установки постоянного загрузчика с маской A;
полное стирание чипа удалит приложение. Разметка EEPROM и параметры не меняются.
3. Аппаратный режим запуска должен выбирать Flash boot. Старый запуск непосредственно
SPI ROM не передаёт управление постоянному загрузчику и не разрешает CAN handoff.
Существующий загрузчик без этой доработки отклоняет новую команду выбора памяти.
Обновить сам сектор A через действующий RS Flash или CAN нельзя: он защищён от записи.
## Обновление приложения из SETGUI
1. Открыть общую страницу «Прошивка», выбрать **CAN / ProtoCAN Boot** и подключить
CAN-адаптер. Штатная скорость PERIPH — 250000 бит/с.
2. Выбрать нужный PERIPH: УМП1 — Type 1 / Device 5, УМП2 — 1/6, задатчик — 1/8.
Product Type — `0x2833`, аппаратная ревизия — 1.
3. В поле **«ProtoCAN: память прошивки»** выбрать **«Внутренняя Flash F28335»**.
4. Открыть `*_flash_rs.bin` из папки `rs` штатного комплекта сборки. Это тот же
SCI8 Flash BIN с FAB1, который используется для RS Flash. RAM BIN из `can`
либо `eeprom`, COFF OUT и образ с аппаратным входом сектора A не подходят.
5. Запустить обновление и дождаться подтверждения записи и перезапуска.
Максимум — 130560 октетов SCI8, до 64 непересекающихся секций. Исполняемый entry
обязан присутствовать в данных приложения. EEPROM-кандидат после такого обновления
не создаётся: при обычном reset постоянный boot предпочитает проверенную Flash,
а подтверждённый EEPROM-образ остаётся резервным источником запуска.
## Последовательность и сохранность
`ENTER_BOOT → SELECT_MEMORY(1) → BEGIN_IMAGE → BEGIN_COMPAT → ERASE staging →
DATA → VERIFY → COMMIT Flash → REBOOT`.
Новая управляющая команда `0x10` имеет один октет данных: 0 — прежняя EEPROM A/B,
1 — внутренняя Flash. Она принимается только в текущей ненулевой сессии до любых
метаданных. Каждая новая сессия начинает с EEPROM по умолчанию; сменить цель после
начала передачи нельзя. Старый клиент без этой команды сохраняет прежнее поведение.
На VERIFY загрузчик заново читает staging EEPROM, проверяет транспортную CRC32,
границы SCI8, перекрытия, наличие entry и FAB1, CRC будущей физической Flash.
Перед COMMIT эти проверки выполняются повторно. Только затем TI Flash API стирает
маску `0x00FE` (B–H), записывает данные порциями до 128 слов и проверяет каждую порцию.
FAB1 записывается последним; затем проверяется CRC уже физической Flash.
Код и таблицы TI API копируются из A в RAM `0x8000…0x97FF`. На время аппаратных
вызовов IRQ запрещены: секторы A–H используют общий банк Flash. Сам CAN-сервис и
его очередь остаются в постоянном загрузчике. Подтверждение COMMIT приходит после
полной записи и проверки; клиент ждёт до 180 секунд и затем отдельно запрашивает reset.
При отказе erase/program/readback COMMIT возвращает ошибку. Частичный образ с
недействительным FAB1/CRC не запускается; boot A сохраняется для восстановления.
Подтверждённый EEPROM-слот и параметры не изменяются. Прежний неактивный слот
EEPROM используется как staging и при этом теряет свой старый резервный образ.
## Проверка
```powershell
python tests/can_boot/run_flash_test.py
python tests/protected_boot/run_test.py
```
`CAN_FLASH_IMAGE` позволяет передать тесту настоящий Flash BIN текущей сборки.
Сквозной тест использует реальный клиент SETGUI, ядро ProtoCAN, аппаратный CAN-порт,
EEPROM-журнал и Flash writer; подменяются только физические CAN/SPI/Flash.
Проверяются сохранность A и параметров, резервный EEPROM-слот, CRC, неверные адреса,
обрезание, перекрытия, изменение staging после VERIFY и обрыв erase/данных/FAB1.
Debug и Release собраны TI C2000 22.6.0.LTS; проверены реальные COFF LOAD-адреса
в секторе A. Испытание физических CAN, SPI, питания и автономного запуска на плате
ещё требуется. В ходе разработки плата не программировалась.
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+2
View File
@@ -1,5 +1,7 @@
# periph_28335: общая панель RS/CAN и регистратор УМП
> Новый GAS SLOT v2: `(Mode<<8)|LocalSlot`, четыре слова в слоте, 50 слотов на mode. Здесь ниже описывается действующий native/legacy-обмен; его адреса сохраняются. Общий слотный обработчик и переход: [GAS_ADDRESS_ALLOCATION.md](GAS_ADDRESS_ALLOCATION.md).
## Где находятся панели
В верхнем ряду вкладок, рядом с **Altera Logic**, появилась **periph_28335**.
+18 -4
View File
@@ -97,11 +97,19 @@ PAGE 0: /* Program Memory */ /* Выбирает страницу адрес
/* Memory (RAM/FLASH/OTP) blocks can be moved to PAGE1 for data allocation */
ZONE0 : origin = 0x004000, length = 0x001000 /* XINTF zone 0 */ /* Записывает origin значением 0x004000, length = 0x001000; данные origin. */
RAML0 : origin = 0x008000, length = 0x004000 /* on-chip RAM block L0 */ /* Записывает origin значением 0x008000, length = 0x004000; данные origin. */
#if EEPROM_M95M02 /* A/B-загрузчик занимает RAM E000..FFFF до запуска приложения; payload ограничивается E000. */
RAML0 : origin = 0x008000, length = 0x005800 /* Код приложения использует 22528 слов до D800, оставляя отдельное место константам. */
#else /* AT25256B сохраняет прежнюю разметку самостоятельной SCI8-сборки. */
RAML0 : origin = 0x008000, length = 0x004000 /* Старые четыре банка L0..L3 содержат 16384 слова кода. */
#endif /* Завершает выбор размера исполняемой RAM. */
/* RAML1 : origin = 0x009000, length = 0x001000 /* on-chip RAM block L1 */
/* RAML2 : origin = 0x00A000, length = 0x001000 /* on-chip RAM block L2 */
// RAML3 : origin = 0x00B000, length = 0x001000 /* on-chip RAM block L3 */
RAML4 : origin = 0x00C000, length = 0x001000 /* on-chip RAM block L1 */ /* Записывает origin значением 0x00C000, length = 0x001000; данные origin. */
#if EEPROM_M95M02 /* Инициализированные данные не должны пересекать RAM работающего загрузчика. */
RAML4 : origin = 0x00D800, length = 0x000800 /* Последние 2048 слов payload содержат .cinit, .econst и ramfuncs. */
#else /* Сохраняет прежние адреса RAM для малого аппаратного профиля. */
RAML4 : origin = 0x00C000, length = 0x001000 /* Банк L4 малой сборки содержит 4096 слов констант. */
#endif /* Завершает выбор области инициализированных данных. */
ZONE6 : origin = 0x0100000, length = 0x100000 /* XINTF zone 6 */ /* Записывает origin значением 0x0100000, length = 0x100000; данные origin. */
FLASHH : origin = 0x300000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x300000, length = 0x008000; данные origin. */
@@ -129,9 +137,14 @@ PAGE 1 : /* Data Memory */ /* Выбирает страницу адресно
/* Registers remain on PAGE1 */
BOOT_RSVD : origin = 0x000000, length = 0x000050 /* Part of M0, BOOT rom will use this for stack */ /* Записывает origin значением 0x000000, length = 0x000050; данные origin. */
RAMM0 : origin = 0x000050, length = 0x0003B0 /* on-chip RAM block M0 */ /* Записывает origin значением 0x000050, length = 0x0003B0; данные origin. */
BOOT_SHARED : origin = 0x000050, length = 0x000008 /* Восемь слов handoff сохраняют session/слот через watchdog reset вне scratch RAM Boot ROM. */
RAMM0 : origin = 0x000058, length = 0x0003A8 /* Исключает handoff из памяти, доступной обычным секциям приложения. */
RAMM1 : origin = 0x000400, length = 0x000400 /* on-chip RAM block M1 */ /* Записывает origin значением 0x000400, length = 0x000400; данные origin. */
RAML5 : origin = 0x00D000, length = 0x003000 /* on-chip RAM block L1 */ /* Записывает origin значением 0x00D000, length = 0x003000; данные origin. */
#if EEPROM_M95M02 /* После перехода в C runtime приложение может занять прежнюю рабочую RAM загрузчика. */
RAML5 : origin = 0x00E000, length = 0x002000 /* Неинициализированные данные занимают 8192 слова и отсутствуют в payload SCI8. */
#else /* Малый профиль не использует отдельный CAN-загрузчик. */
RAML5 : origin = 0x00D000, length = 0x003000 /* Сохраняет историческое положение .ebss. */
#endif /* Завершает выбор адреса неинициализированных данных. */
/* RAML6 : origin = 0x00E000, length = 0x001000 /* on-chip RAM block L1 */
/* RAML7 : origin = 0x00F000, length = 0x001000 /* on-chip RAM block L1 */
ZONE7A : origin = 0x0200000, length = 0x00FC00 /* XINTF zone 7 - program space */ /* Записывает origin значением 0x0200000, length = 0x00FC00; данные origin. */
@@ -182,6 +195,7 @@ SECTIONS
/* Allocate uninitalized data sections: */
/* Записывает PAGE значением 1; данные PAGE. */
.boot_shared : > BOOT_SHARED, PAGE = 1, TYPE = NOINIT /* Запрещает C startup очищать контекст handoff отдельного загрузчика. */
.stack : > RAMM1 PAGE = 1
/* Записывает PAGE значением 1; данные PAGE. */
.ebss : > RAML5 PAGE = 1
+10 -10
View File
@@ -104,16 +104,14 @@ PAGE 0: /* Program Memory */ /* Выбирает страницу адрес
RAML4 : origin = 0x00C000, length = 0x001000 /* on-chip RAM block L1 */ /* Записывает origin значением 0x00C000, length = 0x001000; данные origin. */
ZONE6 : origin = 0x0100000, length = 0x100000 /* XINTF zone 6 */ /* Записывает origin значением 0x0100000, length = 0x100000; данные origin. */
FLASHH : origin = 0x300000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x300000, length = 0x008000; данные origin. */
APP_HEADER : origin = 0x300000, length = 0x000010 /* 16 слов описания FAB1 содержат entry и CRC; аппаратный Flash boot остаётся в секторе A. */
FLASHH : origin = 0x300010, length = 0x007FF0 /* Остаток сектора H хранит приложение, не перекрывая служебный заголовок. */
FLASHG : origin = 0x308000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x308000, length = 0x008000; данные origin. */
FLASHF : origin = 0x310000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x310000, length = 0x008000; данные origin. */
FLASHE : origin = 0x318000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x318000, length = 0x008000; данные origin. */
FLASHD : origin = 0x320000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x320000, length = 0x008000; данные origin. */
FLASHC : origin = 0x328000, length = 0x008000 /* on-chip FLASH */ /* Записывает origin значением 0x328000, length = 0x008000; данные origin. */
FLASHA : origin = 0x338000, length = 0x007F80 /* on-chip FLASH */ /* Записывает origin значением 0x338000, length = 0x007F80; данные origin. */
CSM_RSVD : origin = 0x33FF80, length = 0x000076 /* Part of FLASHA. Program with all 0x0000 when CSM is in use. */ /* Записывает origin значением 0x33FF80, length = 0x000076; данные origin. */
BEGIN : origin = 0x33FFF6, length = 0x000002 /* Part of FLASHA. Used for "boot to Flash" bootloader mode. */ /* Записывает origin значением 0x33FFF6, length = 0x000002; данные origin. */
CSM_PWL : origin = 0x33FFF8, length = 0x000008 /* Part of FLASHA. CSM password locations in FLASHA */ /* Записывает origin значением 0x33FFF8, length = 0x000008; данные origin. */
/* Сектор A 0x338000..0x33FFFF намеренно отсутствует: приложение не может разместить здесь ни код, ни boot-переход, ни пароли CSM. */
OTP : origin = 0x380400, length = 0x000400 /* on-chip OTP */ /* Записывает origin значением 0x380400, length = 0x000400; данные origin. */
ADC_CAL : origin = 0x380080, length = 0x000009 /* ADC_cal function in Reserved memory */ /* Записывает origin значением 0x380080, length = 0x000009; данные origin. */
@@ -129,7 +127,8 @@ PAGE 1 : /* Data Memory */ /* Выбирает страницу адресно
/* Registers remain on PAGE1 */
BOOT_RSVD : origin = 0x000000, length = 0x000050 /* Part of M0, BOOT rom will use this for stack */ /* Записывает origin значением 0x000000, length = 0x000050; данные origin. */
RAMM0 : origin = 0x000050, length = 0x0003B0 /* on-chip RAM block M0 */ /* Записывает origin значением 0x000050, length = 0x0003B0; данные origin. */
BOOT_SHARED : origin = 0x000050, length = 0x000008 /* Восемь слов NOINIT передают источник запуска и CAN-session между постоянным boot и приложением. */
RAMM0 : origin = 0x000058, length = 0x0003A8 /* Рабочая RAM начинается после handoff и не повреждает его при C startup. */
RAMM1 : origin = 0x000400, length = 0x000400 /* on-chip RAM block M1 */ /* Записывает origin значением 0x000400, length = 0x000400; данные origin. */
RAML5 : origin = 0x00D000, length = 0x003000 /* on-chip RAM block L1 */ /* Записывает origin значением 0x00D000, length = 0x003000; данные origin. */
/* RAML6 : origin = 0x00E000, length = 0x001000 /* on-chip RAM block L1 */
@@ -159,9 +158,10 @@ SECTIONS
/* Записывает PAGE значением 0; данные PAGE. */
.pinit : > FLASHG PAGE = 0 /* Конструкторы используют тот же непрерывный сектор данных, что и таблица C startup. */
/* Записывает PAGE значением 0; данные PAGE. */
.text : > FLASHH PAGE = 0 /* Основной код запускается непосредственно из сектора H, начиная с адреса слова 0x300000. */
.text : > FLASHH PAGE = 0 /* Основной код следует за описанием FAB1 с адреса 0x300010; сектор A недоступен линкеру. */
/* Записывает PAGE значением 0; данные PAGE. */
codestart : > BEGIN PAGE = 0
.flash_app : > APP_HEADER PAGE = 0 /* Описание приложения заменяет прежний аппаратный codestart; CRC заполняется после линковки. */
.boot_shared : > BOOT_SHARED PAGE = 1, TYPE = NOINIT /* Сохраняет handoff источника Flash и запрос входа CAN Boot при watchdog reset. */
flash_rs : /* Собирает весь автономный участок, который должен пережить стирание исполняемой Flash. */
{ /* Начинает перечень функций и таблиц загрузчика RS и официального TI API. */
*(flash_rs) /* Включает декодер, CRC, проверку образа, стирание, программирование и автономный ответ SCI. */
@@ -183,9 +183,9 @@ SECTIONS
PAGE = 0
/* Записывает PAGE значением 0; данные PAGE. */
csmpasswds : > CSM_PWL PAGE = 0
/* Секции паролей CSM не назначаются: Flash-приложение не содержит данных сектора постоянного загрузчика. */
/* Записывает PAGE значением 0; данные PAGE. */
csm_rsvd : > CSM_RSVD PAGE = 0
/* Зарезервированные слова сектора A также не выделяются и не попадают в OUT/SCI8. */
/* Allocate uninitalized data sections: */
/* Записывает PAGE значением 1; данные PAGE. */
+22
View File
@@ -14,6 +14,7 @@
#include "message.h"
/* Подключает "DAC.h": выход ЦАП и автомат защиты нагрузки с проверкой напряжения и свежести CAN. */
#include "DAC.h"
#include "can_boot.h" /* Определяет доступность безопасной остановки перед отдельным CAN-загрузчиком. */
/* Подключает "package.h": адреса устройств, типы плат и псевдонимы технологических регистров. */
#include "package.h"
/* Подключает "tools.h": настройка внешней памяти и служебные задержки. */
@@ -59,6 +60,9 @@ unsigned int period_dac, time_dac;
#define LOAD_START_WAIT_STEPS (3U * DAC_FREQ)
/* load_start_remaining хранит остаток 600 стартовых отправок 6 мА; ноль означает конец выдержки или подтверждённые 30 В. */
static unsigned int load_start_remaining;
#if CAN167_AB_ENABLED /* Блокировка требуется только приложению, передающему управление CAN-загрузчику. */
static volatile unsigned int load_boot_stopping; /* Удерживает штатный STOP, даже если во время входа продолжают поступать команды START. */
#endif /* Самостоятельный Flash-вариант сохраняет прежний автомат нагрузки. */
/* Хранит состояние автомата, число выданных START в текущем сеансе и запрет повторного пуска; лимит берётся отдельно из регистра 0x7D. */
static unsigned int load_state, load_attempts, load_inhibit;
/* Объявляет load_count_dac — load число ЦАП; load_count_ramp — load число ramp; load_init_count — load init число. */
@@ -83,6 +87,9 @@ void Load_control_init(void)
{
/* Записывает load_state значением LOAD_IDLE; load_attempts = 0; load_inhibit = 0; текущее состояние автомата нагрузки. */
load_state = LOAD_IDLE; load_attempts = 0; load_inhibit = 0;
#if CAN167_AB_ENABLED /* COFF не гарантирует нулевое содержимое всей .ebss после reset. */
load_boot_stopping = 0U; /* Обычный запуск снимает блокировку предыдущей сессии обновления. */
#endif /* Завершает начальную настройку загрузочной блокировки. */
/* Начинает первую попытку без накопленной выдержки и подтверждённого роста ЗПТ; COFF требует явной инициализации статических полей. */
load_start_remaining = 0;
/* Записывает load_count_dac значением 0; load_count_ramp = 0; load_init_count = 1; load число ЦАП. */
@@ -391,6 +398,9 @@ void Load_runner(void)
saved = __disable_interrupts();
/* Записывает commands значением (unsigned int)Commands; данные commands. */
commands = (unsigned int)Commands;
#if CAN167_AB_ENABLED /* Во время смены приложения Timer1 остаётся единственным владельцем выходов нагрузки. */
if (load_boot_stopping) commands = (commands & ~0x03C0U) | 0x0040U; /* Снимает START и включает локальный RESET, чтобы штатный автомат выдал STOP даже из исходного IDLE; 0x40 — бит RESET. */
#endif /* После reset новая прошивка начнёт с обычных команд. */
/* Записывает voltage значением (load_simulation & 2U) ? 0U : load_voltage; данные voltage. */
voltage = (load_simulation & 2U) ? 0U : load_voltage;
/* Записывает timeout значением (unsigned int)LOAD_CAN_TIMEOUT; данные timeout. */
@@ -617,3 +627,15 @@ unsigned int Load_protection_prepare(unsigned int function, unsigned int address
return 2;
/* Закрывает текущий блок или список полей; следующие операторы относятся к внешнему уровню. */
}
#if CAN167_AB_ENABLED /* Остановка используется только при переходе приложения M95M02 в CAN Boot. */
void Load_boot_stop(void) /* Выполняется в main с работающим Timer1, до отключения IRQ общим загрузчиком. */
{ /* Передаёт остановку тому же автомату, который управляет нагрузкой в рабочем режиме. */
unsigned long started = CpuTimer1.InterruptCount; /* Миллисекундная отметка задаёт минимальную длительность STOP по тем же часам, что рабочий автомат. */
if (Desk == dsk_LOAD) { /* Остальные типы плат не используют аналоговую нагрузку и её импульс STOP. */
load_boot_stopping = 1U; /* Новые CAN-команды не разрешают повторный START во время входа в загрузчик. */
while (!load_stop_asserted || !load_zero_sent || IMPowse || CpuTimer1.InterruptCount - started < 1000UL) { ServiceDog(); } /* Ждёт отправленные 4 мА, завершённый секундный STOP и минимум секунду после запроса. */
} /* К этому моменту обычный Timer1 завершил безопасную остановку. */
READY = 0; /* Запрещает возобновление прикладного управления до немедленного watchdog reset. */
} /* Общий загрузчик после возврата сохранит session и запретит IRQ. */
#endif /* Завершает приложение зависимую часть CAN Boot. */
+2
View File
@@ -31,3 +31,5 @@ void Load_voltage_can(unsigned int header, unsigned int a,
unsigned int Load_protection_prepare(unsigned int function, unsigned int address,
/* Объявляет value — данные value; out — данные out. Хранит указатель на данные. */
unsigned int value, unsigned int *out, unsigned int *error);
void Load_boot_stop(void); /* Удерживает штатный STOP и 4 мА до перехода из main в отдельный CAN-загрузчик M95M02. */
+18
View File
@@ -0,0 +1,18 @@
#ifndef CAN167_BOOT_H /* Исключает повторное объявление точек подключения загрузчика 167. */
#define CAN167_BOOT_H /* Один интерфейс используется главным циклом, CAN ISR и watchdog ISR. */
#include "f28335_can_application_config.h" /* Использует тот же аппаратный выбор и версию, что напрямую подключённый к CCS модуль templates. */
#if F28335_CAN_BOOT_APPLICATION_ENABLED /* Единый признак исключает расхождение интерфейса платы и реально скомпилированной общей реализации. */
#include "../protocan-boot/ports/tms320f28335/f28335_can_boot.h" /* Подключает существующий порт общей библиотеки без копирования протокола в 167. */
#include "../protocan-boot/ports/tms320f28335/f28335_boot_platform.h" /* Предоставляет handoff, ранний watchdog и определение реально запущенного слота. */
#define CAN167_AB_ENABLED 1 /* Разрешает защиту EEPROM и CAN-сервис для RAM и защищённой Flash при физически установленной M95M02. */
#else /* Остальные аппаратные варианты не получают ложного обещания A/B-обновления. */
#define CAN167_AB_ENABLED 0 /* Позволяет старым сборкам и host-моделям исключить зависимости загрузчика. */
#define F28335Boot_StartupWatchdog() ((void)0) /* Профиль AT25256B без CAN A/B сохраняет прежний watchdog приложения. */
#define F28335Boot_RunningSlot() 255U /* Значение FF означает отсутствие handoff от отдельного загрузчика. */
#define F28335CanBoot_Init(periph_id) ((void)(periph_id)) /* При выключенном A/B принимает тот же аппаратный номер, но не занимает служебные mailbox. */
#define F28335CanBoot_RxISR() ((void)0) /* Оставляет legacy CAN ISR независимым от выключенного сервиса. */
#define F28335CanBoot_Service() ((void)0) /* Главный цикл использует единый вызов для всех физических профилей. */
#define F28335CanBoot_Ready() ((void)0) /* Не публикует подтверждение кандидата, если загрузчик не подключён. */
#define F28335CanBoot_WatchdogAllowed() 1U /* Сохраняет прежнее обслуживание watchdog для самостоятельных образов. */
#endif /* Завершает выбор поддерживаемого способа загрузки. */
#endif /* Завершает защиту интерфейса CAN Boot проекта 167. */
@@ -0,0 +1,11 @@
#ifndef CAN167_APPLICATION_CONFIG_H /* Защищает общие настройки CAN A/B от повторного подключения через интерфейс платы и модуль templates. */
#define CAN167_APPLICATION_CONFIG_H /* Один набор параметров используется всеми единицами трансляции текущего приложения 167. */
#include "eeprom_config.h" /* Получает физический тип EEPROM из действующей аппаратной конфигурации проекта. */
#if EEPROM_M95M02 /* RAM и защищённое Flash-приложение обслуживают CAN Boot при физически установленной M95M02; запись слотов выполняет только постоянный загрузчик. */
#define F28335_CAN_BOOT_APPLICATION_ENABLED 1 /* Разрешает компиляцию прикладной части ProtoCAN непосредственно из templates для этого аппаратного профиля. */
#include "firmware_version.h" /* Получает автоматически подготовленную версию из generated/firmware_identity.h; CAN, RAM и Flash используют тот же номер, что паспорт BIN. */
#define F28335_CAN_BOOT_FIRMWARE_VERSION (((unsigned long)FIRMWARE_VERSION_MAJOR << 24) | ((unsigned long)FIRMWARE_VERSION_MINOR << 16) | FIRMWARE_VERSION_PATCH) /* Поле FW ProtoCAN содержит major в битах 31..24, minor в 23..16 и patch в 15..0; unsigned long C28x имеет 32 бита. */
#else /* Выключенный аппаратный профиль сохраняет прежнее поведение приложения без CAN A/B. */
#define F28335_CAN_BOOT_APPLICATION_ENABLED 0 /* Общий прикладной модуль templates превращается в пустую единицу трансляции и не резервирует служебные ресурсы. */
#endif /* Завершает выбор CAN A/B по физической EEPROM и способу исполнения приложения. */
#endif /* Сохраняет единый конфигурационный контракт f28335_can_application.c общей библиотеки. */
+9
View File
@@ -0,0 +1,9 @@
#include "DSP2833x_Device.h" /* Использует штатные 16-битные типы и регистры F28335. */
#include "can_boot.h" /* Выбирает A/B только для RAM-приложения с большой EEPROM. */
#if CAN167_AB_ENABLED /* Общая реализация компилируется отдельно из templates; здесь остаётся аппаратная остановка платы перед переходом в CAN boot. */
#include "DAC.h" /* Передаёт остановку нагрузки единственному владельцу её GPIO и ЦАП. */
void F28335Boot_Quiesce(void) /* Вызывается из main после разрешённого ENTER_BOOT, перед watchdog reset. */
{ /* Останавливает прикладные выходы до перехода в отдельный загрузчик. */
Load_boot_stop(); /* Выдаёт 4 мА и полный секундный STOP при сохранённом миллисекундном такте. */
} /* После остановки общий аппаратный слой сохраняет session и выполняет reset. */
#endif /* Самостоятельный Flash-образ не резервирует handoff и CAN boot mailbox. */
+6 -4
View File
@@ -12,6 +12,7 @@
#include "package.h" // DSP281x Headerfile Include File
/* Подключает "ecan.h": штатный eCAN и отдельный служебный обмен УМП/GAS. */
#include "can_boot.h" /* Отделяет очередь адресного обновления от технологического обмена CAN. */
#include "ecan.h" // DSP281x Headerfile Include File
/* Подключает "tools.h": настройка внешней памяти и служебные задержки. */
#include "tools.h" // DSP281x Headerfile Include File
@@ -394,10 +395,11 @@ interrupt void CANa_handler(void)
EINT;
/* Вызывает Handlai с аргументами (&ECanaMboxes) в текущей последовательности операций. */
Handlai(&ECanaMboxes);
/* Записывает ECanaRegs.CANRMP.all значением 2; представление регистра целым словом без разбиения на битовые поля. */
ECanaRegs.CANRMP.all = 2;
F28335CanBoot_RxISR(); /* Помещает только Boot mailbox 3/6 в очередь; запись EEPROM выполняется позднее в main. */
if (ECanaRegs.CANRMP.all & 2UL) { /* Проверяет собственный RX-флаг legacy mailbox, исключая повтор старых команд при Boot IRQ. */
Handlai(&ECanaMboxes); /* Передаёт свежий технологический пакет прежнему обработчику регистров и напряжения. */
ECanaRegs.CANRMP.all = 2UL; /* Подтверждает только прочитанный mailbox; Boot IRQ не может погасить новый непрочитанный legacy пакет. */
} /* Остальные входящие mailbox подтверждает исключительно общий Boot-порт. */
/* Устанавливает биты PieCtrlRegs.PIEACK.bit.ACK9 значением 1; данные ACK9. */
PieCtrlRegs.PIEACK.bit.ACK9 |= 1;
// Restore registers saved:
+7 -3
View File
@@ -1,8 +1,12 @@
.ref _c_int00 ; Стандартный COFF startup применяет .cinit и вызывает main после отключения раннего watchdog.
.sect "codestart" ; Boot ROM передаёт управление двухсловному переходу по аппаратному адресу слова 0x33FFF6.
LB flash_boot_start ; Переходит к короткой подготовке C28x во Flash, сохраняя точный размер аппаратного входа два слова.
.def _flash_app_start ; Экспортирует отдельную точку приложения; аппаратный вход 0x33FFF6 принадлежит постоянному загрузчику.
.sect ".flash_app" ; Linker резервирует 16 слов по 0x300000; postbuild заполнит описание FAB1 и CRC окончательно связанных LOAD-секций.
.word 0FFFFh, 0FFFFh, 0FFFFh, 0FFFFh ; До подписи отсутствуют magic и версия, поэтому незавершённый OUT не считается запускаемым приложением.
.word 0FFFFh, 0FFFFh, 0FFFFh, 0FFFFh ; Резервирует адрес точки входа и начало диапазона в словах C28x.
.word 0FFFFh, 0FFFFh, 0FFFFh, 0FFFFh ; Резервирует конец диапазона и CRC32 его физических октетов.
.word 0FFFFh, 0FFFFh, 0FFFFh, 0FFFFh ; Резервирует инверсию entry и маркеры завершённого описания FAB1.
.text ; Последовательность взята из штатного TI DSP2833x_CodeStartBranch.asm и размещается в секторе основного кода.
flash_boot_start: ; Отключает watchdog до возможной длительной обработки таблиц инициализации C, а не только после входа в main.
_flash_app_start: ; Общий загрузчик вызывает эту точку только после проверки описания и CRC приложения ниже сектора A.
SETC OBJMODE ; Выбирает C28x object mode, требуемый стандартным COFF startup процессора F28335.
EALLOW ; Разрешает запись защищённого регистра WDCR перед запуском C runtime.
MOVZ DP, #7029h>>6 ; Адрес слова WDCR=0x7029 из карты F28335; DP выбирает соответствующую страницу по 64 слова.
+34 -13
View File
@@ -5,6 +5,8 @@
#include "DAC.h" /* Проверяет завершённую штатную остановку нагрузки до отключения Timer1 на время стирания. */
#include "Flash2833x_API_Library.h" /* Вызывает официальный алгоритм TI v2.10 для стирания, записи и проверки F28335. */
#include <string.h> /* Переносит код и константы Flash API во внутреннюю RAM до изменения Flash. */
#include "../protocan-boot/ports/tms320f28335/f28335_flash_app.c" /* Путь разрешается от штатного include c/set-protocol; общий FAB1/CRC проверяется до первого стирания Flash. */
extern void ServiceDog(void); /* Во время длительных предварительных CRC прерывания уже запрещены, поэтому watchdog обслуживается из проверяемого главного контекста. */
extern Uint16 FlashRsLoadStart, FlashRsLoadEnd, FlashRsRunStart; /* Границы отдельной секции задаёт F28335_flash.cmd в адресуемых 16-битных словах. */
static Uint16 program_buffer[128]; /* Буфер на 128 слов хранится во внутренней RAM; он не зависит от стираемых секторов или порядка байтов RS. */
static FLASH_ST api_status; /* Внутренняя RAM сохраняет адрес и данные первой ошибки официального Flash API. */
@@ -36,6 +38,21 @@ static Uint16 crc_byte(Uint16 crc, Uint16 value) /* Продвигает ста
crc = (crc & 1U) ? ((crc >> 1) ^ 0xA001U) : (crc >> 1); /* 0xA001 — отражённый полином CRC16 Modbus, совпадающий с проверкой GUI. */
return crc; /* Возвращает состояние без вызовов функции из Flash. */
} /* Завершает шаг CRC. */
typedef struct { const Uint16 *data; Uint32 length; } flash_image_source; /* Описывает проверенную таблицу SCI8 в staging RAM без доступа к настоящей Flash. */
static uint16_t image_read_word(void *user, uint32_t wanted) /* Предоставляет общему валидатору будущие Flash-слова, включая стёртые промежутки. */
{ /* Вызывается только после проверки границ и отсутствия пересечений в validate_image. */
flash_image_source *source = (flash_image_source *)user; /* Контекст ограничивает чтение фактической длиной загруженной таблицы. */
Uint32 offset = 22UL, address; Uint16 count; /* Заголовок TI занимает 22 октета; адреса назначения выражены словами C28x. */
if (!(wanted & 255UL)) ServiceDog(); /* Подтверждает продвижение CRC каждые 256 слов до erase, пока обычный таймерный ISR отключён. */
while (offset + 2UL <= source->length) { /* Ищет слово только среди полностью проверенных блоков. */
count = word_at(source->data, offset); offset += 2UL; /* Нулевой размер завершает таблицу без адресного поля. */
if (!count) break; /* Отсутствующее слово должно остаться стёртым после обновления приложения. */
address = long_at(source->data, offset); offset += 4UL; /* Восстанавливает абсолютный LOAD-адрес секции. */
if (wanted >= address && wanted - address < count) return word_at(source->data, offset + 2UL * (wanted - address)); /* Читает запрошенное слово в упаковке действующего RS LOAD. */
offset += 2UL * count; /* Пропускает проверенные октеты текущего блока. */
} /* Промежутки не наследуют старую прошивку, поскольку все секторы приложения будут стёрты. */
return 0xFFFFU; /* Стёртое слово входит в общую CRC FAB1 по его двум физическим октетам. */
} /* Callback не изменяет staging RAM, EEPROM или внутреннюю Flash. */
#pragma CODE_SECTION(reply_status, "flash_rs") /* Передаёт итог даже после удаления старой программы и её ISR. */
static void reply_status(RS_DATA *rs, Uint16 status) /* Ответ содержит адрес, команду, 16-битный статус и CRC; SCI и RS485 обслуживаются опросом. */
{ /* Начинает автономную передачу подтверждения из RAM. */
@@ -70,23 +87,28 @@ static void reply_status(RS_DATA *rs, Uint16 status) /* Ответ содерж
static Uint16 validate_image(const Uint16 *data, Uint32 length) /* Проверяет весь образ до первого стирания, включая загрузочный переход и запрещённые адреса CSM. */
{ /* Начинает проверку структуры таблицы TI SCI8. */
Uint32 offset = 22UL, address, bytes, entry_address, prior, prior_address; /* Заголовок TI занимает 11 слов; дополнительные курсоры проверяют перекрытия и наличие данных по адресу входа. */
Uint16 count, boot = 0, entry = 0, prior_count; /* Требует единственный boot-переход и хотя бы один блок, содержащий точку входа C runtime. */
Uint16 count, boot = 0, entry = 0, prior_count; /* Требует один полный FAB1 и явный блок исполняемого кода по адресу входа. */
flash_image_source source; Uint32 checked_entry; /* Общий валидатор пересчитает CRC будущего приложения до стирания. */
if (length < 24UL || (length & 1UL) || word_at(data, 0) != 0x08AAU) return 0x1002U; /* Ключ SCI8 и чётный размер исключают обычный плоский EEPROM BIN. */
address = long_at(data, 18UL); /* Адрес входа следует после восьми резервных слов заголовка TI. */
entry_address = address; /* Сохраняет адрес для проверки наличия соответствующих исполняемых слов в таблице. */
if (address < 0x300000UL || address >= 0x33FF80UL) return 0x1002U; /* Точка входа C runtime обязана находиться в исполняемой Flash вне CSM. */
if (address < F28335_FLASH_APP_DATA || address >= F28335_FLASH_APP_STOP) return 0x1002U; /* Точка входа следует после FAB1; весь сектор постоянного boot исключён. */
while (offset + 2UL <= length) /* Читает блоки только в пределах подтверждённого загрузчиком массива. */
{ /* Начинает проверку очередного блока. */
count = word_at(data, offset); /* Размер блока выражен в 16-битных словах C28x, а не октетах RS. */
offset += 2UL; /* Продвигает курсор за поле длины. */
if (!count) return (offset == length && boot == 1U && entry) ? 0U : 0x1002U; /* Нулевой блок завершает образ; хвост, отсутствие boot-перехода или данных C runtime запрещены. */
if (!count) { /* После структурной проверки таблицы подтверждает общий контракт FAB1 и CRC будущей Flash. */
if (offset != length || boot != 1U || !entry) return 0x1002U; /* Хвост, отсутствующее описание или отсутствующий код не допускаются. */
source.data = data; source.length = length; /* Передаёт общему валидатору только проверенный staging-блок. */
return f28335_flash_app_validate(image_read_word, &source, &checked_entry) && checked_entry == entry_address ? 0U : 0x1002U; /* Повреждение описания, диапазона или данных выявляется до Flash_Erase. */
} /* Только полностью проверенный образ допускает обновление приложения. */
if (offset + 4UL > length) return 0x1002U; /* Не читает обрезанный 32-битный адрес назначения. */
address = long_at(data, offset); /* Читает адрес в формате старшее слово, затем младшее. */
offset += 4UL; /* Переводит курсор к первому слову данных блока. */
bytes = (Uint32)count << 1; /* Каждое слово программы соответствует двум октетам файла. */
if (bytes > length - offset) return 0x1002U; /* Проверяет остаток файла без возможности выхода за границы массива. */
if (address == 0x33FFF6UL && count == 2U) ++boot; /* Единственное исключение рядом с CSM — аппаратный переход из двух слов. */
else if (address < 0x300000UL || address >= 0x33FF80UL || (Uint32)count > 0x33FF80UL - address) return 0x1002U; /* Запрещает OTP, RAM, пароли CSM и зарезервированный диапазон сектора A. */
if (address < F28335_FLASH_APP_START || address >= F28335_FLASH_APP_STOP || (Uint32)count > F28335_FLASH_APP_STOP - address) return 0x1002U; /* Весь сектор A, включая аппаратный вход 0x33FFF6, защищён независимо от типа блока. */
if (address == F28335_FLASH_APP_START) { if (count < F28335_FLASH_APP_HEADER_WORDS) return 0x1002U; ++boot; } /* Все 16 слов FAB1 должны находиться вместе для публикации описания последней стадией. */
if (entry_address >= address && entry_address < address + count) entry = 1U; /* Подтверждает, что после boot-перехода процессор получит код из текущего образа. */
prior = 22UL; /* Начинает сравнение диапазона с уже проверенными блоками таблицы. */
while (prior < offset - 6UL) /* Повторно рассматривает только заголовки, прошедшие проверки границ выше. */
@@ -105,7 +127,7 @@ static void program_image(RS_DATA *rs, const Uint16 *data, Uint32 length) /* Н
{ /* Начинает автономный алгоритм записи и проверки. */
Uint32 offset = 22UL, address, boot_offset = 0UL; /* Хранит курсоры данных и отложенного загрузочного перехода во внутренней RAM. */
Uint16 count, chunk, i, status; /* Состояние API и размеры блоков не зависят от внешних таблиц. */
status = Flash_Erase(0x00FFU, &api_status); /* Маска TI содержит биты A–H; обновление заменяет весь исполняемый образ, параметры внешней EEPROM сохраняются. */
status = Flash_Erase(0x00FEU, &api_status); /* TI v2.10: бит 0 — сектор A; маска FE стирает только B–H и сохраняет постоянный CAN boot вместе с аппаратным входом. */
while (!status && offset < length) /* Программирует блоки только после успешного стирания всех секторов. */
{ /* Начинает обработку очередной секции изображения. */
count = word_at(data, offset); /* Использует размер, уже проверенный до входа в критический участок. */
@@ -113,7 +135,7 @@ static void program_image(RS_DATA *rs, const Uint16 *data, Uint32 length) /* Н
if (!count) break; /* Нулевой блок означает конец файла TI. */
address = long_at(data, offset); /* Восстанавливает Flash-адрес текущей секции. */
offset += 4UL; /* Переводит курсор к полезным словам секции. */
if (address == 0x33FFF6UL) { boot_offset = offset; offset += 4UL; continue; } /* Откладывает boot-переход до успешной записи и проверки остальных секций. */
if (address == F28335_FLASH_APP_START) { boot_offset = offset; offset += 2UL * F28335_FLASH_APP_HEADER_WORDS; address += F28335_FLASH_APP_HEADER_WORDS; count -= F28335_FLASH_APP_HEADER_WORDS; } /* Откладывает 16 слов FAB1; соседний код того же блока программируется обычным порядком. */
while (count && !status) /* Делит большие секции на буферные порции без переполнения RAM. */
{ /* Начинает запись очередной порции. */
chunk = count > 128U ? 128U : count; /* Ограничение совпадает с размером внутреннего программирующего буфера в словах. */
@@ -127,10 +149,9 @@ static void program_image(RS_DATA *rs, const Uint16 *data, Uint32 length) /* Н
} /* Завершает запись обычных блоков. */
if (!status && boot_offset) /* Разрешает запуск нового образа только после проверки всех предыдущих секций. */
{ /* Начинает фиксацию аппаратной точки входа. */
program_buffer[0] = word_at(data, boot_offset); /* Восстанавливает первое слово инструкции длинного перехода. */
program_buffer[1] = word_at(data, boot_offset + 2UL); /* Восстанавливает второе слово адреса перехода. */
status = Flash_Program((Uint16 *)0x33FFF6UL, program_buffer, 2UL, &api_status); /* Записывает boot-переход последним, исключая запуск неполного образа. */
if (!status) status = Flash_Verify((Uint16 *)0x33FFF6UL, program_buffer, 2UL, &api_status); /* Проверяет обе части аппаратной точки входа. */
for (i = 0; i < F28335_FLASH_APP_HEADER_WORDS; ++i) program_buffer[i] = word_at(data, boot_offset + 2UL * i); /* Восстанавливает FAB1 только после записи и проверки всех LOAD-секций приложения. */
status = Flash_Program((Uint16 *)F28335_FLASH_APP_START, program_buffer, F28335_FLASH_APP_HEADER_WORDS, &api_status); /* Публикует CRC и entry в секторе H, не меняя аппаратный boot сектора A. */
if (!status) status = Flash_Verify((Uint16 *)F28335_FLASH_APP_START, program_buffer, F28335_FLASH_APP_HEADER_WORDS, &api_status); /* Подтверждает весь заголовок чтением до watchdog reset. */
} /* Завершает фиксацию загрузочного перехода. */
reply_status(rs, status); /* Отправляет конкретный результат после записи и аппаратной проверки. */
if (!status) { EALLOW; SysCtrlRegs.WDCR = 0x0028U; EDIS; } /* Успех включает watchdog для аппаратного перезапуска; режим загрузки задают GPIO84–87. */
@@ -153,9 +174,9 @@ void FlashRs_Command(RS_DATA *rs) /* До стирания проверяет и
if (!status) /* Перепроверяет байты буфера после LOAD, защищая от изменения RAM до стирания. */
{ /* Начинает повторное вычисление CRC исходного кадра LOAD. */
crc = crc_byte(crc_byte(0xFFFFU, rs->addr_recive), CMD_LOAD); /* CRC включает тот же адрес и номер команды, что и первоначальная передача блока. */
for (i = 0; i < length; ++i) crc = crc_byte(crc, byte_at((Uint16 *)source, i)); /* Проверяет каждую полезную октету без таблицы из Flash. */
for (i = 0; i < length; ++i) { crc = crc_byte(crc, byte_at((Uint16 *)source, i)); if (!(i & 255UL)) ServiceDog(); } /* Повторная CRC LOAD проверяет каждую октету и обслуживает watchdog при уже запрещённых ISR до стирания. */
if (crc != word_at((Uint16 *)source, length)) status = 0x1003U; /* Запрещает стирание, если блок RAM отличается от подтверждённого загрузчиком. */
else status = validate_image((Uint16 *)source, length); /* Проверяет все адреса, завершённость и аппаратный переход до изменения Flash. */
else status = validate_image((Uint16 *)source, length); /* Подтверждает все адреса ниже сектора A, полное FAB1 и CRC будущего Flash-приложения до erase. */
} /* Завершает проверки буфера. */
} /* Завершает предварительную проверку команды. */
if (!status && length) /* Входит в автономный участок только для полностью проверенной ненулевой записи. */
+10 -1
View File
@@ -1,7 +1,7 @@
/* Порядок запуска периферии и обслуживание команд в главном цикле. Русские пояснения сохранены в UTF-8. */
/* Подключает "DSP2833x_Device.h": поставляемое TI описание Device для семейства C2833x. */
#include "DSP2833x_Device.h" // DSP2833x Headerfile Include File
#include <string.h> /* Переносит только функции ramfuncs из загрузочного диапазона Flash в рабочую внутреннюю RAM. */
#include <string.h> /* Предоставляет memset для начального обнуления карты регистров и memcpy для переноса ramfuncs из Flash в RAM. */
extern unsigned int RamfuncsLoadStart, RamfuncsLoadEnd, RamfuncsRunStart; /* Оба linker-варианта экспортируют границы копирования в адресуемых словах C28x. */
/* Подключает "cntrl_adr.h": собственный и универсальный адрес устройства. */
@@ -33,6 +33,7 @@ extern unsigned int RamfuncsLoadStart, RamfuncsLoadEnd, RamfuncsRunStart; /* О
/* Подключает "ecan.h": штатный eCAN и отдельный служебный обмен УМП/GAS. */
#include "ecan.h"
#include "can_boot.h" /* Подключает готовые CAN Boot, handoff и контроль подтверждения приложения. */
/* Подключает "kanal.h": последовательный вывод данных канала индикации. */
#include "kanal.h"
/* Подключает "pulto.h": обмен и индикация пульта. */
@@ -80,8 +81,12 @@ void main()
/* Объявляет presbyt — данные presbyt. Начальное значение задаётся справа от знака равенства. */
int presbyt=0;
DINT; /* Запрещает IRQ до очистки рабочих регистров: Timer1 и приём CAN не должны читать или менять частично инициализированную карту. */
memset(modbus, 0, (ANSWER_LEN + 1U) * sizeof(modbus[0])); /* Обнуляет все 129 адресуемых слов до настройки периферии: COFF startup не очищает .ebss, а initializer {0} у TI заполняет только первый явно указанный элемент. */
/* Инициализирует модуль вызовом InitSysCtrl(); перед его дальнейшим использованием. */
InitSysCtrl();
F28335Boot_StartupWatchdog(); /* Сразу включает watchdog кандидата и запрещает ISR скрывать зависание main до CONFIRM. */
if (&RamfuncsLoadStart != &RamfuncsRunStart) /* RAM-образ не копирует одинаковые диапазоны; Flash-образ переносит InitFlash перед изменением wait states. */
memcpy(&RamfuncsRunStart, &RamfuncsLoadStart, &RamfuncsLoadEnd - &RamfuncsLoadStart); /* Размер равен разности адресуемых 16-битных слов TI, а не физическим октетам ПК. */
InitFlash(); /* Вызывает находящийся в RAM код настройки Flash-пайплайна и задержек для штатного SYSCLKOUT. */
@@ -133,6 +138,7 @@ void main()
{
/* Вызывает pause_us. Формирует задержку в микросекундах через калиброванную функцию DSP28x_usDelay. */
pause_us(50000);
ServiceDog(); /* Подтверждает продвижение раннего main каждые 50 мс; до CONFIRM кандидат не получает кормление из ISR. */
/* Вызывает led2_toggle с аргументами () в текущей последовательности операций. */
led2_toggle();
/* Вызывает led1_toggle с аргументами () в текущей последовательности операций. */
@@ -193,7 +199,9 @@ void main()
EDIS;
/* Записывает READY значением 1; данные READY. */
F28335CanBoot_Init(Mode); /* Передаёт аппаратный номер PERIPH из get_Mode: задатчик 8, УМП1 5 и УМП2 6 получают разные Boot-адреса до включения mailbox. */
READY=1;
F28335CanBoot_Ready(); /* Отмечает завершение загрузки параметров, датчиков и ЦАП для проверки пробного запуска. */
/* Повторяет или ожидает, пока выполняется while(1). */
while(1)
@@ -201,6 +209,7 @@ void main()
{
/* Чтение логгера по CAN не блокирует цикл управления. */
/* Вызывает UMP_CAN_service. В главном цикле готовит замороженный ответ служебного CAN и отправляет его двухсловными фрагментами. */
F28335CanBoot_Service(); /* Выполняет очередь CAN Boot и подтверждает кандидата только из работающего главного цикла. */
UMP_CAN_service();
CAN_telemetry_service(); /* Обслуживает heartbeat 1 Гц, изменения и повторы 1,3 с независимо от делителя OWEN и состояния CanGO. */
if (CanGO) { /* Миллисекундный Timer1 по-прежнему выдаёт один флаг каждые CANPOWSE=20 мс для внешнего опроса. */
+3 -2
View File
@@ -1,5 +1,6 @@
/* Обработка датчиков, вычисление величин и миллисекундный такт системы. Русские пояснения сохранены в UTF-8. */
/* Подключает "DSP2833x_Device.h": поставляемое TI описание Device для семейства C2833x. */
#include "can_boot.h" /* До CONFIRM таймер не должен кормить watchdog вместо главного цикла кандидата. */
#include "DSP2833x_Device.h" // DSP2833x Headerfile Include File
/* Подключает "DSP2833x_SWPrioritizedIsrLevels.h": поставляемое TI описание SWPrioritizedIsrLevels для семейства C2833x. */
#include "DSP2833x_SWPrioritizedIsrLevels.h"
@@ -243,8 +244,8 @@ interrupt void cpu_timer1_isr_SENS(void)
/* Закрытие доступа к защищённым регистрам периферии. */
EDIS; // This is needed to disable write to EALLOW protected registers
/* Проверяет if(!cReset) ServiceDog(); последующий оператор выполняется только при истинном условии. */
if(!cReset) ServiceDog();
/* До подтверждения кандидата только работающий main имеет право кормить watchdog; команда RESET сохраняет приоритет. */
if(!cReset && F28335CanBoot_WatchdogAllowed()) ServiceDog(); /* Подтверждённое приложение сохраняет прежнее обслуживание из ISR. */
/* Проверяет if(++CanPowse >= CANPOWSE); последующий оператор выполняется только при истинном условии. */
if(++CanPowse >= CANPOWSE)
+1 -1
View File
@@ -303,7 +303,7 @@ void Load_params()
/* Чтение EEPROM уже завершено: короткая секция ниже согласованно применяет настройки защиты из буфера param. */
saved = __disable_interrupts(); /* Применяет лимит попыток и тайм-аут единым снимком; длительное чтение EEPROM выше остаётся доступным для IRQ. */
for(i=0;i<ANSWER_LEN;i++) /* Переносит проверенную карту параметров, не выдавая аппаратных сигналов и не сбрасывая автомат167. */
if (Desk != dsk_LOAD || i != 127U) modbus[i] = param[i]; /* Никогда не копирует сохранённый START/RESET нагрузки, даже на один промежуточный такт Timer1. */
if ((Desk != dsk_LOAD || i != 127U) && (Desk != dsk_EPLT || i >= 4U)) modbus[i] = param[i]; /* R127 нагрузки содержит живые START/RESET; R0..R3 пульта — два числа и две маски индикации, которые должны поступать по связи, а не восстанавливаться из старого EEPROM-снимка. */
reset_parameter_commands(); /* Сохраняет последние принятые START/RESET после чтения EEPROM; до READY очищает команды полностью. */
__restore_interrupts(saved); /* Возвращает исходное состояние IRQ после согласованного применения RAM-настроек. */
/* Закрывает текущий блок или список полей; следующие операторы относятся к внешнему уровню. */
+7 -6
View File
@@ -1,5 +1,6 @@
/* Обмен и индикация пульта. Русские пояснения сохранены в UTF-8. */
/* Подключает "DSP2833x_Device.h": поставляемое TI описание Device для семейства C2833x. */
#include "can_boot.h" /* До CONFIRM таймер не должен кормить watchdog вместо главного цикла кандидата. */
#include "DSP2833x_Device.h" // DSP2833x Headerfile Include File
/* Подключает "DSP2833x_SWPrioritizedIsrLevels.h": поставляемое TI описание SWPrioritizedIsrLevels для семейства C2833x. */
#include "DSP2833x_SWPrioritizedIsrLevels.h"
@@ -22,9 +23,9 @@
#include "peripher.h"
/* Объявляет isMask — is маска. */
unsigned long isMask;
unsigned long isMask = 0; /* Задаёт начальную погашенную фазу тестовых ламп через .cinit, независимо от остатков RAM после JTAG или watchdog reset. */
/* Объявляет isNumb — данные isNumb. */
int isNumb;
int isNumb = 0; /* До первого периода теста передаёт определённую цифру, а не содержимое неинициализированной COFF .ebss. */
/* Объявляет quaLamp — данные quaLamp. Начальное значение задаётся справа от знака равенства. */
int quaLamp = 6;
@@ -37,7 +38,7 @@ void what_is()
/* Открывает составной блок или описание полей; следующие строки принадлежат этому уровню вложенности. */
{
/* Объявляет count_blink — число blink. */
static unsigned int count_blink;
static unsigned int count_blink = 0; /* Отсчитывает первый BLINK_TIME от запуска теста с известного нуля; явный initializer попадает в таблицу COFF .cinit. */
/* Объявляет numb — данные numb. Начальное значение задаётся справа от знака равенства. */
static int numb=0;
@@ -65,7 +66,7 @@ interrupt void cpu_timer1_isr_PULT(void)
/* Открывает составной блок или описание полей; следующие строки принадлежат этому уровню вложенности. */
{
/* Объявляет cownt — данные cownt; count_bright — число bright. Начальное значение задаётся справа от знака равенства. */
static int cownt=0,count_bright;
static int cownt=0,count_bright=0; /* Начинает очередь каналов и десятиступенчатый PWM с определённой фазы, не используя случайный счётчик яркости из RAM. */
/* Объявляет light — данные light; i — данные i. Начальное значение задаётся справа от знака равенства. */
unsigned int light=0, i;
/* Объявляет Alone — данные Alone; READY_FREQ — частота основного такта Timer1 в герцах. Хранит указатель на данные. Начальное значение задаётся справа от знака равенства. */
@@ -84,8 +85,8 @@ interrupt void cpu_timer1_isr_PULT(void)
/* Закрытие доступа к защищённым регистрам периферии. */
EDIS; // This is needed to disable write to EALLOW protected registers
/* Проверяет if(!cReset) ServiceDog(); последующий оператор выполняется только при истинном условии. */
if(!cReset) ServiceDog();
/* До подтверждения кандидата только работающий main имеет право кормить watchdog; команда RESET сохраняет приоритет. */
if(!cReset && F28335CanBoot_WatchdogAllowed()) ServiceDog(); /* Подтверждённое приложение сохраняет прежнее обслуживание из ISR. */
/* Проверяет if(++CanPowse >= CANPOWSE); последующий оператор выполняется только при истинном условии. */
if(++CanPowse >= CANPOWSE)
+2
View File
@@ -4,6 +4,7 @@
/* Подключает "spise2p.h": драйвер SPI EEPROM, адресация, страницы и автомат завершения операций. */
#include "spise2p.h"
#include "can_boot.h" /* Защищает A/B-журнал и слоты от старого произвольного пути записи EEPROM. */
/* Instance the SPI bus serial EEPROM driver */
@@ -48,6 +49,7 @@ void Seeprom_write( SE2P_SIZE adres,
#endif
/* Записывает CpuTimer2.InterruptCount значением 0; прерывание число. */
if (F28335Boot_RunningSlot() < 2U && (adres < BALSAM167_EEPROM_PARAMS_START_WORD || adres >= BALSAM167_EEPROM_PARAMS_END_WORD || size > (BALSAM167_EEPROM_PARAMS_END_WORD - adres) * 2UL)) return; /* В A/B-приложении штатный SPI-драйвер пишет только 129 слов параметров; слоты обслуживает общий загрузчик. */
CpuTimer2.InterruptCount=0;
/* Записывает CpuTimer2Regs.TCR.all значением 0x4020; представление регистра целым словом без разбиения на битовые поля. */
CpuTimer2Regs.TCR.all = 0x4020; // Use write-only instruction to set TSS bit = 0
File diff suppressed because one or more lines are too long
+11
View File
@@ -51,6 +51,17 @@
</natures>
<!-- Настройка linkedResources. -->
<linkedResources>
<link> <!-- Компилирует прикладную часть CAN-загрузчика непосредственно из используемой проектом зависимости templates. -->
<name>Source/Templates/f28335_can_application.c</name> <!-- Отображает общий исходник отдельно от аппаратных hooks платы в дереве CCS. -->
<type>1</type> <!-- Связанный файл автоматически входит в Debug и Release как самостоятельная единица трансляции C. -->
<locationURI>PARENT-2-PROJECT_LOC/newProject/SETGUI/third_party/templates/c/protocan-boot/ports/tms320f28335/f28335_can_application.c</locationURI> <!-- Поднимается на два каталога от UKSSTMS320F28335 к git_project штатной переменной Eclipse: сегмент .. после SRC_ROOT1 ошибочно разрешается относительно каталога запуска CCS. -->
</link> <!-- Завершает прямое подключение общей реализации без локального копирования исходников загрузчика. -->
<!-- Подключает аппаратный hook остановки нагрузки отдельно от общей реализации CAN-загрузчика templates. -->
<link> <!-- Оставляет аппаратную последовательность STOP в проекте владельца ЦАП и нагрузки. -->
<name>Source/can_boot.c</name> <!-- Сохраняет прежнее имя ресурса CCS для локальной аппаратной части интеграции. -->
<type>1</type> <!-- Тип 1 обозначает файл, компилируемый вместе с приложением. -->
<locationURI>SRC_ROOT1/Source/Internal/can_boot.c</locationURI> <!-- Использует исходник текущего checkout 167. -->
</link> <!-- Завершает связь без копирования общей библиотеки. -->
<!-- Настройка link. -->
<link>
<!-- Настройка name. -->
@@ -1,214 +1,152 @@
# Настройка Eclipse/CCS: eclipse.preferences.version.
eclipse.preferences.version=1
# Настройка Eclipse/CCS: encoding//Debug/Libraries/subdir_rules.mk.
encoding//Debug/ByPurpose20261019/flash/build-4eb7c2_d/subdir_rules.mk=UTF-8
encoding//Debug/ByPurpose20261019/flash/build-4eb7c2_d/subdir_vars.mk=UTF-8
encoding//Debug/ByPurpose20261019/flash/build-l3oio6ty/subdir_rules.mk=UTF-8
encoding//Debug/ByPurpose20261019/flash/build-l3oio6ty/subdir_vars.mk=UTF-8
encoding//Debug/ByPurpose20261019/subdir_rules.mk=UTF-8
encoding//Debug/ByPurpose20261019/subdir_vars.mk=UTF-8
encoding//Debug/CanAuto20261019/subdir_rules.mk=UTF-8
encoding//Debug/CanAuto20261019/subdir_vars.mk=UTF-8
encoding//Debug/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Libraries/subdir_vars.mk.
encoding//Debug/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/ProtectedBoot20261019/flash/build-r5zbzzw_/subdir_rules.mk=UTF-8
encoding//Debug/ProtectedBoot20261019/flash/build-r5zbzzw_/subdir_vars.mk=UTF-8
encoding//Debug/ProtectedBoot20261019/subdir_rules.mk=UTF-8
encoding//Debug/ProtectedBoot20261019/subdir_vars.mk=UTF-8
encoding//Debug/PultStartup20261019/flash/build-llylkr3t/subdir_rules.mk=UTF-8
encoding//Debug/PultStartup20261019/flash/build-llylkr3t/subdir_vars.mk=UTF-8
encoding//Debug/PultStartup20261019/flash/build-qlj4p8v8/subdir_rules.mk=UTF-8
encoding//Debug/PultStartup20261019/flash/build-qlj4p8v8/subdir_vars.mk=UTF-8
encoding//Debug/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/Internal/subdir_rules.mk.
encoding//Debug/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/Source/Internal/subdir_vars.mk.
encoding//Debug/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/makefile.
encoding//Debug/Source/Templates/subdir_rules.mk=UTF-8
encoding//Debug/Source/Templates/subdir_vars.mk=UTF-8
encoding//Debug/Source/subdir_rules.mk=UTF-8
encoding//Debug/Source/subdir_vars.mk=UTF-8
encoding//Debug/TemplatesLoader20261019/config-checks/subdir_rules.mk=UTF-8
encoding//Debug/TemplatesLoader20261019/config-checks/subdir_vars.mk=UTF-8
encoding//Debug/TemplatesLoader20261019/flash/build-5uc2tvkt/subdir_rules.mk=UTF-8
encoding//Debug/TemplatesLoader20261019/flash/build-5uc2tvkt/subdir_vars.mk=UTF-8
encoding//Debug/TemplatesLoader20261019/subdir_rules.mk=UTF-8
encoding//Debug/TemplatesLoader20261019/subdir_vars.mk=UTF-8
encoding//Debug/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/objects.mk.
encoding//Debug/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Libraries/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Libraries/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/Internal/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/Internal/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/makefile.
encoding//Debug/optimizerAssistant/opt_for_speed__0/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/objects.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/sources.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__0/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__0/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Libraries/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Libraries/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/Internal/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/Internal/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/makefile.
encoding//Debug/optimizerAssistant/opt_for_speed__1/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/objects.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/sources.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__1/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__1/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Libraries/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Libraries/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/Internal/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/Internal/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/makefile.
encoding//Debug/optimizerAssistant/opt_for_speed__2/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/objects.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/sources.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__2/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__2/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Libraries/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Libraries/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/Internal/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/Internal/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/makefile.
encoding//Debug/optimizerAssistant/opt_for_speed__3/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/objects.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/sources.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__3/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__3/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Libraries/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Libraries/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/Internal/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/Internal/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/makefile.
encoding//Debug/optimizerAssistant/opt_for_speed__4/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/objects.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/sources.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__4/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__4/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Libraries/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Libraries/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Libraries/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Libraries/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_common/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_common/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/Internal/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/Internal/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/Internal/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/Source/Internal/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/makefile.
encoding//Debug/optimizerAssistant/opt_for_speed__5/makefile=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/objects.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/objects.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/sources.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/subdir_rules.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/optimizerAssistant/opt_for_speed__5/subdir_vars.mk.
encoding//Debug/optimizerAssistant/opt_for_speed__5/subdir_vars.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/sources.mk.
encoding//Debug/sources.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/subdir_rules.mk.
encoding//Debug/subdir_rules.mk=UTF-8
# Настройка Eclipse/CCS: encoding//Debug/subdir_vars.mk.
encoding//Debug/subdir_vars.mk=UTF-8
# Кодировка всего проекта, включая связанные исходники.
encoding//Release/Libraries/subdir_rules.mk=UTF-8
encoding//Release/Libraries/subdir_vars.mk=UTF-8
encoding//Release/Source/External/v120/DSP2833x_common/source/subdir_rules.mk=UTF-8
encoding//Release/Source/External/v120/DSP2833x_common/source/subdir_vars.mk=UTF-8
encoding//Release/Source/External/v120/DSP2833x_headers/cmd/subdir_rules.mk=UTF-8
encoding//Release/Source/External/v120/DSP2833x_headers/cmd/subdir_vars.mk=UTF-8
encoding//Release/Source/External/v120/DSP2833x_headers/source/subdir_rules.mk=UTF-8
encoding//Release/Source/External/v120/DSP2833x_headers/source/subdir_vars.mk=UTF-8
encoding//Release/Source/Internal/subdir_rules.mk=UTF-8
encoding//Release/Source/Internal/subdir_vars.mk=UTF-8
encoding//Release/Source/Templates/subdir_rules.mk=UTF-8
encoding//Release/Source/Templates/subdir_vars.mk=UTF-8
encoding//Release/Source/subdir_rules.mk=UTF-8
encoding//Release/Source/subdir_vars.mk=UTF-8
encoding//Release/makefile=UTF-8
encoding//Release/objects.mk=UTF-8
encoding//Release/sources.mk=UTF-8
encoding//Release/subdir_rules.mk=UTF-8
encoding//Release/subdir_vars.mk=UTF-8
encoding/<project>=UTF-8
+87 -17
View File
@@ -7,13 +7,16 @@
## Версия и паспорт прошивки
Текущий номер 1.1.2 задаётся в firmware_version.h: major/minor 0..255,
patch 0..999. Меняйте только три числовых определения версии и выполняйте
Clean/Rebuild. firmware_identity.json хранит product/target.
Номер хранится в `firmware_identity.json` вместе с `product`, `target` и
`increment_version: true`. Перед каждой сборкой Debug или Release общий prebuild
атомарно увеличивает `patch`, как в ветке 166: `1.1.2 → 1.1.3 → 1.1.4`.
При переполнении `patch` 999 увеличивается `minor`; пределы `major/minor` — 255.
Номер резервируется до компиляции, поэтому неудачная попытка также расходует его.
Debug и Release вызывают prepare_identity.py. Он читает номер версии и передаёт
его общему генератору паспорта. generated/firmware_identity.h и JSON создаются
в каталоге сборки; вручную их редактировать не нужно. Паспорт включает исходный
`generated/firmware_identity.h` и JSON создаются в каталоге выбранной конфигурации;
вручную их редактировать не нужно. `firmware_version.h` подключает подготовленный
заголовок: RAM, Flash, CAN и паспорта используют один номер. Postbuild и сборка
дополнительных вариантов счётчик не увеличивают. Паспорт включает исходный
коммит, признак незакоммиченных изменений и время UTC. Порядок проверки
приведён в [FIRMWARE_IDENTITY.md](../Doc/FIRMWARE_IDENTITY.md).
@@ -30,19 +33,55 @@ AT25256B остаётся явным альтернативным профиле
../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.
В .cproject обе конфигурации вызывают единый
K:/git_project/newProject/templates/c/firmware-info/tools/c2000_build.py:
prepare перед компиляцией и build после линковки. prepare_identity.py и
publish_identity.py оставлены совместимыми адаптерами без копии алгоритмов.
Генератор паспорта и Git-ревизия компилируемой зависимости берутся из
SETGUI/third_party/templates. firmware_build_profile.json задаёт аппаратные
пути, имена макросов EEPROM и допустимые RAM-адреса в словах C28x; ёмкость
EEPROM и размер SCI8 выражены в октетах. При переносе проекта проверьте оба
пути templates, Include Options и каталог назначения BIN.
Значения ram_ranges [32768, 57344] соответствуют CPU-адресам слов
0x8000..0xDFFF из F28335.cmd: верхняя граница 0xE000 не включается,
чтобы загружаемый образ не затронул рабочую память постоянного CAN-загрузчика.
Защищённый post-build вызывает общий postcompile только во временный каталог.
До публикации проверяются аппаратный профиль по MAP, размер до параметров
Защищённый post-build использует общий конвертор только во временном каталоге.
До сохранения комплекта проверяются аппаратный профиль по MAP, размер до параметров
EEPROM, структура SCI8, RAM-адреса, встроенный паспорт, manifest и SHA-256.
Поле eeprom различает AT25256B и M95M02. Текущий каталог копирования
задан в .cproject:
K:/git_project/newProject/SETGUI/..periph_28335/firmware/periph28335/balzam167.
Поле eeprom различает AT25256B и M95M02. Готовый комплект сохраняется в
Debug/firmware/prepared либо Release/firmware/prepared. В обеих конфигурациях CCS
postbuild также экспортирует архив в
`../newProject/SETGUI/..periph_28335/firmware/periph28335/balzam167/HASH_дата_UTC+3`.
Локальный выпуск и его архив имеют одинаковую структуру:
```text
eeprom/ <артефакт>_<build_id>.bin, HEX, RAM OUT и карты
flash/ <артефакт>_flash.out и карта — внутренняя Flash через JTAG
can/ <артефакт>_<build_id>_can.bin — ProtoCAN Boot, M95M02 A/B
rs/ <артефакт>_flash_rs.bin и карта — внутренняя Flash через COM
```
Flash OUT и Flash RS BIN теперь предназначены для постоянного общего загрузчика:
сектор A и аппаратный вход `0x33FFF6` исключены из приложения. Описание FAB1 с
CRC32 занимает 16 слов по `0x300000`; программа находится ниже `0x338000`.
Сначала через JTAG устанавливается обновлённый `F28335_CAN_AB.out`, затем можно
обновлять приложение по RS Flash или JTAG с сохранением A. Flash основная,
EEPROM/CAN — резерв. [Порядок запуска, маски стирания и переход](../Bootloader/README.md).
Каждый основной образ имеет рядом собственные `.manifest.json` и `.sha256`.
Общий `firmware_identity.json` находится в корне архива. Папка неподдержанного
варианта не создаётся. `latest_build.json` указывает архив текущей сборки и
относительный путь `eeprom/<артефакт>_<build_id>.bin.manifest.json`.
В SETGUI откройте Сервис → Прошивка → Публикатор, выберите режим
«Из папки postbuild / manifest» и «Импорт папки postbuild…». Для обновления Flash
по RS выбирайте паспорт из `rs`, для CAN — из `can`, для EEPROM — из `eeprom`.
Можно выбрать корень одной сборки: диалог покажет пути с назначениями.
Для JTAG импортируйте комплект через его основной EEPROM BIN и выберите загрузчик
«TMS320F28335 / Flash JTAG (OUT)»: он найдёт подписанный OUT в `flash`.
Импорт любого варианта сохраняет все четыре папки одной сборки в ZIP.
Сетевой выпуск создаёт Публикатор после предпросмотра; CCS подготавливает
локальные файлы и копирует проверенный комплект в каталог SETGUI.
COM_1 работает на 115200 с FIFO. COM_2 использует 9600 для OWEN либо 115200
для другого режима. Эти скорости задаются в main.c.
@@ -94,6 +133,28 @@ TESTLAMP включается после двух секунд непрерыв
## Внутренняя Flash
Общий postbuild templates автоматически выпускает отдельный
`<артефакт>_<build_id>_can.bin` для ProtoCAN Boot при профиле M95M02.
Профиль включён полем `can_boot_profile: f28335-m95m02-ab` в
`firmware_build_profile.json`. Проверяются предел 130560 октетов, не более
64 SCI8-секций, RAM `[0x8000,0xE000)`, точка входа, встроенный паспорт и hooks
CAN-приложения по MAP. Для AT25256B CAN-файл не создаётся.
У CAN BIN собственные `.manifest.json` и `.sha256`; все три файла добавляются
в тот же архив и каталог GUI, что обычный RAM BIN и варианты Flash.
Изменение CAN-профиля после prebuild требует новой сборки.
В этом же автоматическом выпуске сохраняются `<артефакт>_flash.out` для JTAG
и `<артефакт>_flash_rs.bin` для обновления внутренней Flash по RS, с отдельными
паспортами и SHA-256. CAN BIN содержит RAM-приложение для M95M02 A/B;
он не является образом внутренней Flash.
Обновлённый постоянный загрузчик также записывает внутреннюю Flash по CAN.
В SETGUI выбираются «CAN / ProtoCAN Boot» и «Внутренняя Flash F28335», затем
существующий `*_flash_rs.bin` из папки `rs`. Он проходит staging в неактивном
EEPROM-слоте, повторную проверку SCI8/FAB1 и запись только B–H; сектор A и
подтверждённый EEPROM-резерв сохраняются. Сначала нужен обновлённый boot в A
через JTAG. [Установка, протокол и проверки](../Doc/CAN_FLASH_UPDATE.md).
В 167 добавлен отдельный Flash-вариант на основе ветки `прошивка-через-flash`
(`437f250`) с сохранением текущих CAN, GAS, регистратора и защиты нагрузки.
Основной `F28335.cmd` размещает `.text` в RAM. Альтернативный
@@ -144,3 +205,12 @@ CPU-адресуемым расширением RAM и не добавляютс
В текущем RAM-варианте `.text` занимает внутренние RAML0–RAML3, а `.cinit`
и константы — RAML4. При Flash-варианте код и константы загружаются во Flash,
а секции `ramfuncs` и автономного программатора имеют отдельные LOAD и RUN.
CAN-загрузчик подключён из templates: ресурс CCS
`Source/Templates/f28335_can_application.c` ссылается непосредственно на
`c/protocan-boot/ports/tms320f28335/f28335_can_application.c` той же зависимости.
Общие ядро, A/B-хранилище, SPI/handoff и CAN-порт не копируются в проект.
`Source/Internal/Include/f28335_can_application_config.h` задаёт включение
для RAM/M95M02 и версию из счётчика `firmware_identity.json`. Локальный `can_boot.c`
содержит только аппаратную остановку нагрузки. Постоянный Flash-загрузчик
остаётся отдельным проектом `templates/c/protocan-boot/projects/ccs/f28335`.
File diff suppressed because one or more lines are too long
@@ -0,0 +1,14 @@
{
"can_boot_profile": "f28335-m95m02-ab",
"ram_ranges": [[32768, 57344]],
"eeprom": {
"selection_header": "../Source/Internal/Include/eeprom_config.h",
"selection_macro": "EEPROM_M95M02",
"layout_header": "c/set-protocol/include/balsam167_eeprom_layout.h",
"param_words_macro": "BALSAM167_EEPROM_PARAM_WORDS",
"variants": {
"0": {"name": "AT25256B", "bytes_macro": "BALSAM167_AT25256_BYTES"},
"1": {"name": "M95M02", "bytes_macro": "BALSAM167_M95M02_BYTES"}
}
}
}
+7 -1
View File
@@ -1,4 +1,10 @@
{
"product": "Balsam-167-PM35",
"target": "TMS320F28335"
"target": "TMS320F28335",
"version": [
1,
1,
5
],
"increment_version": true
}
+4 -16
View File
@@ -1,16 +1,4 @@
/* Настройки и интерфейс firmware_version. Русские пояснения сохранены в UTF-8. */
/* Начинает условие: BALSAM_FIRMWARE_VERSION_H ещё не определён; защищает повторное включение или задаёт значение сборки. */
#ifndef BALSAM_FIRMWARE_VERSION_H
/* Определяет защитный символ или переключатель BALSAM_FIRMWARE_VERSION_H для последующей компиляции. */
#define BALSAM_FIRMWARE_VERSION_H
/* Edit these numbers before releasing firmware, then rebuild. */
/* Задаёт FIRMWARE_VERSION_MAJOR = 1U; данные FIRMWARE_VERSION_MAJOR. */
#define FIRMWARE_VERSION_MAJOR 1U
/* Задаёт FIRMWARE_VERSION_MINOR = 1U; данные FIRMWARE_VERSION_MINOR. */
#define FIRMWARE_VERSION_MINOR 1U
/* Задаёт FIRMWARE_VERSION_PATCH = 2U; данные FIRMWARE_VERSION_PATCH. */
#define FIRMWARE_VERSION_PATCH 2U
/* Закрывает условный блок препроцессора; дальнейшие строки относятся к внешнему уровню. */
#endif
#ifndef BALSAM_FIRMWARE_VERSION_H /* Защищает интерфейс версии от повторного включения через настройки CAN и другие модули платы. */
#define BALSAM_FIRMWARE_VERSION_H /* Все единицы трансляции получают один номер текущей попытки сборки. */
#include "firmware_identity.h" /* Prebuild увеличивает version в firmware_identity.json и формирует этот заголовок в generated; ручные константы не должны расходиться с паспортом BIN. */
#endif /* Завершает общий интерфейс автоматически подготовленной версии прошивки. */
+16 -145
View File
@@ -1,145 +1,16 @@
# Настройки и интерфейс prepare_identity. Комментарии и исходный текст в UTF-8.
# Продолжает текущий вызов, список или выражение: """Generate build identity using the release version from firmware_version.h."""; порядок аргументов сохраняется.
"""Generate build identity using the release version from firmware_version.h."""
# Подключает модуль argparse для этой проверки или подготовки сборки.
import argparse
# Подключает модуль importlib.util для этой проверки или подготовки сборки.
import importlib.util
# Подключает модуль json для этой проверки или подготовки сборки.
import json
# Импортирует необходимые имена: from pathlib import Path.
from pathlib import Path
# Подключает модуль re для этой проверки или подготовки сборки.
import re
# Запускает Git с доверием только к явно выбранному рабочему дереву, не меняя глобальные настройки пользователя.
import subprocess
# Подключает модуль tempfile для этой проверки или подготовки сборки.
import tempfile
# Читает единственное числовое определение; вычисляемые выражения отклоняются, чтобы Python не исполнял содержимое C-заголовков.
def numeric_define(header, name):
text = header.read_text(encoding="utf-8-sig") # Поддерживает UTF-8 с BOM для пользовательских заголовков конфигурации.
text = re.sub(r"/\*.*?\*/|//[^\n]*", "", text, flags=re.S) # Удаляет комментарии перед поиском настоящих директив препроцессора.
values = re.findall(r"^\s*#\s*define\s+" + re.escape(name) + r"\s+([^\n]+)", text, re.M) # Требует определение нужного макроса, а не упоминание в тексте.
if len(values) != 1 or not re.fullmatch(r"(?:0[xX][0-9a-fA-F]+|[0-9]+)[uUlL]*", values[0].strip()): # Исключает неоднозначность и выражения, которые могут отличаться от C-препроцессора.
raise ValueError(f"{header}: define {name} once as an integer") # Останавливает выпуск при неподдерживаемой структуре общей разметки.
return int(values[0].strip().rstrip("uUlL"), 0) # Преобразует десятичную либо шестнадцатеричную величину в число Python.
# Получает физический профиль из той же конфигурации и той же копии разметки, которые читает компилятор 167.
def read_profile(project, templates, eeprom=None):
selected = numeric_define(project.parent / "Source/Internal/Include/eeprom_config.h", "EEPROM_M95M02") # По умолчанию повторяет единственный аппаратный выбор платы из заголовка.
if selected not in (0, 1): # Не допускает произвольное ненулевое значение вместо двух поддерживаемых микросхем.
raise ValueError("EEPROM_M95M02 must be 0 or 1") # Диагностирует ошибку до генерации паспорта и конверсии OUT.
name = eeprom or ("M95M02" if selected else "AT25256B") # Явное CLI-переопределение должно также передаваться компилятору и линкеру.
if name not in ("AT25256B", "M95M02"): # Проверяет также программные вызовы, которые обходят argparse.
raise ValueError("EEPROM must be AT25256B or M95M02") # Не подставляет профиль по умолчанию при неизвестном названии.
layout = templates / "c/set-protocol/include/balsam167_eeprom_layout.h" # Выбирает реальный заголовок из компилируемой зависимости.
total = numeric_define(layout, "BALSAM167_M95M02_BYTES" if name == "M95M02" else "BALSAM167_AT25256_BYTES") # Ёмкость задаётся общим контрактом в физических октетах.
words = numeric_define(layout, "BALSAM167_EEPROM_PARAM_WORDS") # Число сохраняемых 16-битных слов включает контрольную сумму параметров.
limit = total - (words + 1) * 2 # Резервирует параметры и последнее неиспользуемое слово; слово C28x занимает два октета EEPROM.
if total <= 0 or total % 2 or words <= 0 or limit < 24: # Минимальная таблица SCI8 требует 22 октета заголовка и двухоктетный терминатор.
raise ValueError("Invalid EEPROM layout") # Отклоняет повреждённую разметку вместо отключения ограничения размера.
return {"eeprom": name, "eeprom_bytes": total, "eeprom_param_words": words, "max_image_bytes": limit} # Эти значения становятся частью паспорта конечного BIN.
# Снимает состояние только явно переданного репозитория и не требует записи safe.directory в пользовательский Git config.
def git_state(repository):
directory = repository.resolve() # Рабочий каталог CCS может быть вложен в репозиторий приложения.
trusted = next((path for path in (directory, *directory.parents) if (path / ".git").exists()), directory) # Git проверяет корень checkout; .git-файл также учитывает подключённый templates submodule.
command = ["git", "-c", "safe.directory=" + trusted.as_posix(), "-C", str(directory)] # Локальное доверие ограничено корнем явно выбранной зависимости или исходников проекта.
try: # Отсутствие Git сохраняет прежний явный NOGIT-контракт общей библиотеки.
commit = subprocess.check_output(command + ["rev-parse", "HEAD"], stderr=subprocess.DEVNULL, text=True, encoding="utf-8").strip() # Получает полный SHA именно компилируемого дерева.
dirty = bool(subprocess.check_output(command + ["status", "--porcelain", "--untracked-files=normal"], stderr=subprocess.DEVNULL, text=True, encoding="utf-8").strip()) # Учитывает новые и изменённые исходники при формировании знака плюс.
return {"commit": commit, "dirty": dirty} # Возвращает совместимую с общим генератором структуру происхождения.
except (OSError, subprocess.CalledProcessError): # Не выдаёт неизвестную ревизию за чистое дерево.
return {"commit": None, "dirty": None} # Генератор пометит такую сборку идентификатором NOGIT000.
# Объявляет функцию read_version и её входные параметры.
def read_version(header):
# Читает исходный файл или образ для последующей проверки и разбора.
text = header.read_text(encoding="utf-8-sig")
# Задаёт text по выражению справа; значение используется последующими операциями.
text = re.sub(r"/\*.*?\*/|//[^\n]*", "", text, flags=re.S)
# Задаёт version по выражению справа; значение используется последующими операциями.
version = []
# Перебирает part, limit in (("MAJOR", 255), ("MINOR", 255), ("PATCH", 999)) в указанном порядке.
for part, limit in (("MAJOR", 255), ("MINOR", 255), ("PATCH", 999)):
# Задаёт name по выражению справа; значение используется последующими операциями.
name = "FIRMWARE_VERSION_" + part
# Задаёт definitions по выражению справа; значение используется последующими операциями.
definitions = re.findall(r"^\s*#\s*define\s+" + name + r"\b([^\n]*)", text, re.M)
# Проверяет условие if len(definitions) != 1 перед выполнением следующего блока.
if len(definitions) != 1:
# Останавливает текущую операцию с исключением ValueError(f"{header}: define {name} exactly once").
raise ValueError(f"{header}: define {name} exactly once")
# Задаёт value по выражению справа; значение используется последующими операциями.
value = definitions[0].strip()
# Проверяет условие if not re.fullmatch(r"(?:0|[1-9][0-9]*)[uU]?", value) перед выполнением следующего блока.
if not re.fullmatch(r"(?:0|[1-9][0-9]*)[uU]?", value):
# Останавливает текущую операцию с исключением ValueError(f"{header}: {name} must be a decimal integer").
raise ValueError(f"{header}: {name} must be a decimal integer")
# Задаёт number по выражению справа; значение используется последующими операциями.
number = int(value.rstrip("uU"))
# Проверяет условие if not 0 <= number <= limit перед выполнением следующего блока.
if not 0 <= number <= limit:
# Останавливает текущую операцию с исключением ValueError(f"{header}: {name} must be in 0..{limit}").
raise ValueError(f"{header}: {name} must be in 0..{limit}")
# Продолжает текущий вызов, список или выражение: version.append(number); порядок аргументов сохраняется.
version.append(number)
# Возвращает version вызывающему коду и завершает функцию.
return version
# Объявляет функцию prepare и её входные параметры.
def prepare(project, templates, output, eeprom=None): # Допускает явный аппаратный профиль для CLI при согласованных define компилятора и линкера.
# Читает исходный файл или образ для последующей проверки и разбора.
settings = json.loads((project / "firmware_identity.json").read_text(encoding="utf-8-sig"))
# Задаёт settings["version"] по выражению справа; значение используется последующими операциями.
settings["version"] = read_version(project / "firmware_version.h")
settings["increment_version"] = False # Ручная версия из C-заголовка не увеличивается даже при случайном появлении старого JSON-переключателя.
profile = read_profile(project, templates, eeprom) # Вычисляет границу BIN до вызова генератора, чтобы ошибочный профиль не оставлял пригодный паспорт.
# Задаёт spec по выражению справа; значение используется последующими операциями.
spec = importlib.util.spec_from_file_location("shared_firmware_identity", templates / "c/firmware-info/tools/identity.py")
# Задаёт identity по выражению справа; значение используется последующими операциями.
identity = importlib.util.module_from_spec(spec)
# Продолжает текущий вызов, список или выражение: spec.loader.exec_module(identity); порядок аргументов сохраняется.
spec.loader.exec_module(identity)
identity.git_state = git_state # Использует штатную структуру паспорта с безопасным локальным чтением Git для выбранной копии templates.
# The source header owns SemVer; retain the shared generator and manifest format.
# Открывает управляемый ресурс tempfile.TemporaryDirectory(prefix="balsam-identity-") as directory с автоматическим освобождением.
with tempfile.TemporaryDirectory(prefix="balsam-identity-") as directory:
# Задаёт config по выражению справа; значение используется последующими операциями.
config = Path(directory) / "config.json"
# Сохраняет подготовленный файл в указанном формате для следующего шага.
config.write_text(json.dumps(settings), encoding="utf-8")
# Возвращает identity.prepare(project, templates, config, output) вызывающему коду и завершает функцию.
metadata = identity.prepare(project, templates, config, output) # Генерирует прежние 12 встроенных слов версии, не меняя транспортный контракт.
metadata.update(profile) # Различает физические EEPROM в JSON без добавления сохраняемых MCU-регистров.
metadata["templates_root"] = str(templates.resolve()) # Позволяет postbuild сверить, что использована та же компилируемая копия общих исходников.
header_path = output / "firmware_identity.h" # Штатный firmware_info_static.c обязательно компилирует этот заголовок внутри shared_ump.c.
guard = '\n#include "eeprom_config.h" /* Читает тот же аппаратный выбор, что SPI-драйвер и обработчики 167. */\n' # Проверка выполняется препроцессором и не увеличивает BIN малой EEPROM.
guard += f'#if EEPROM_M95M02 != {int(profile["eeprom"] == "M95M02")} /* Сверяет фактический define компилятора с профилем подготовленного паспорта. */\n' # Явный CLI-профиль требует согласованного compiler define.
guard += '#error EEPROM_profile_differs_from_prebuild /* Останавливает сборку при compiler-only override или смене EEPROM после prebuild. */\n#endif /* Завершает проверку соответствия аппаратного профиля паспорту. */\n' # Не позволяет подписать M95M02-драйвер паспортом AT25256B даже при согласованной MAP.
identity.write_atomic(header_path, header_path.read_text(encoding="utf-8") + guard) # Сохраняет исходный общий контракт и добавляет только локальную проверку конфигурации.
identity.write_atomic(output / "firmware_identity.json", json.dumps(metadata, ensure_ascii=False, indent=2) + "\n") # Сохраняет обогащённый паспорт до компиляции и последующей подписи BIN.
return metadata # Возвращает фактическую ручную версию и аппаратный профиль текущей сборки.
# Проверяет условие if __name__ == "__main__" перед выполнением следующего блока.
if __name__ == "__main__":
# Задаёт parser по выражению справа; значение используется последующими операциями.
parser = argparse.ArgumentParser(description=__doc__)
# Задаёт parser.add_argument("--project", type по выражению справа; значение используется последующими операциями.
parser.add_argument("--project", type=Path, required=True)
# Задаёт parser.add_argument("--templates", type по выражению справа; значение используется последующими операциями.
parser.add_argument("--templates", type=Path, required=True)
# Задаёт parser.add_argument("--output", type по выражению справа; значение используется последующими операциями.
parser.add_argument("--output", type=Path, required=True)
parser.add_argument("--eeprom", choices=("AT25256B", "M95M02")) # CLI-переопределение требует того же аппаратного define у компилятора и линкера.
# Задаёт args по выражению справа; значение используется последующими операциями.
args = parser.parse_args()
# Продолжает текущий вызов, список или выражение: print(json.dumps(prepare(args.project, args.templates, args.output))); порядок аргументов сохраняется.
print(json.dumps(prepare(args.project, args.templates, args.output, args.eeprom))) # Показывает выбранный профиль вместе с прежними полями идентификации.
"""Совместимый адаптер общего процесса подготовки C2000 из templates.""" # Сохраняет прежние импорты и команды без копирования алгоритмов.
import importlib.util # Подключает единственный модуль проверки и подготовки, общий для 166/167.
import os # Позволяет явно выбрать полный checkout инструментов на другом компьютере.
from pathlib import Path # Вычисляет соседний templates без привязки к букве диска.
import sys # Передаёт старые аргументы общей точке входа и сохраняет совместимость импортов.
tools = Path(os.environ.get("FIRMWARE_BUILD_TEMPLATES", Path(__file__).resolve().parents[2] / "newProject/templates")) # Переменная задаёт только корень инструментов; компилируемые исходники передаются отдельным --templates.
name = "_shared_c2000_build" # Оба старых адаптера разделяют один модуль и один набор проверок.
if name not in sys.modules: # Повторный импорт не создаёт независимую копию функций и состояния.
spec = importlib.util.spec_from_file_location(name, tools / "c/firmware-info/tools/c2000_build.py") # Единственный алгоритм расположен в полной библиотеке templates.
module = importlib.util.module_from_spec(spec) # Создаёт модуль без запуска подготовки и компилятора.
sys.modules[name] = module # Регистрирует общий модуль до импорта для совместимых host-тестов.
spec.loader.exec_module(module) # Отсутствующие инструменты возвращают явную ошибку вместо старой локальной реализации.
module = sys.modules[name] # Подготовка паспорта, проверка и архивирование используют одну реализацию.
if __name__ == "__main__": # Прямой старый вызов CCS получает прежний набор параметров.
raise SystemExit(module.main(["prepare", *sys.argv[1:]])) # Возвращает фактический результат общей команды без маскирования ошибок.
sys.modules[__name__] = module # Сохраняет публичные prepare/read_profile/publish/verify_* для существующих проектных тестов и Flash-сборщика.
+16 -202
View File
@@ -1,202 +1,16 @@
"""Публикует EEPROM/RAM SCI8 только после проверки встроенного паспорта и разметки платы.""" # Локальная защита дополняет общий конвертор без изменения соседнего templates.
import argparse # Разбирает одинаковые аргументы защищённого postbuild для CCS Debug и Release.
import base64 # Декодирует точные байты секций COFF из официального XML-вывода TI ofd2000.
from datetime import datetime # Восстанавливает слова UTC из паспорта, созданного перед компиляцией.
import hashlib # Проверяет точные байты конечного BIN и сопроводительного SHA-256.
import importlib.util # Подключает штатный механизм экспорта только после проверки временного выпуска.
import json # Сверяет изделие, аппаратный профиль и идентификацию текущей сборки.
from pathlib import Path # Разрешает пути относительно выбранной конфигурации CCS, а не текущего терминала.
import re # Читает абсолютные EEPROM-символы из карты линкера TI.
import shutil # Копирует только полностью проверенные файлы из временного каталога.
import struct # Разбирает 16-битные слова SCI8 и адреса загрузочных блоков C28x.
import subprocess # Вызывает общую BAT-точку конверсии без публикации во внешнее приложение.
import tempfile # Изолирует непроверенные результаты общего postcompile от постоянных выпусков.
import xml.etree.ElementTree as ET # Проверяет фактические LOAD/RUN адреса Flash COFF без собственного двоичного парсера TI.
from prepare_identity import read_profile, read_version # Использует тот же ручной номер и ту же физическую разметку, что и prebuild.
def verify_embedded(image, metadata, flash=False): # RAM и Flash SCI8 проверяются отдельно по разным допустимым адресам и ограничениям загрузчика.
data = image.read_bytes() # Проверяет содержимое файла, которое будет передано в EEPROM-программатор.
limit = 0xFC00 * 2 - 2 if flash else metadata["max_image_bytes"] # RS Flash использует внешний буфер 0x200000..0x20FC00 и ещё два октета CRC; RAM BIN ограничен резервом физической EEPROM.
if not 24 <= len(data) <= limit: # Учитывает заголовки SCI8 вместе с кодом, не позволяя переписать резерв параметров либо выйти за буфер RS.
raise ValueError("SCI8 exceeds EEPROM firmware boundary or is too short") # Отвергает слишком большой BIN до создания постоянного каталога выпуска.
if data[:2] != b"\xaa\x08": # 0x08AA — обязательный ключ восьмибитной boot-таблицы TI.
raise ValueError("Invalid SCI8 header") # Не принимает HEX, COFF либо плоский дамп под видом загрузочного BIN.
stamp = datetime.fromisoformat(metadata["built_at_utc"].replace("Z", "+00:00")) # Берёт момент именно того prebuild, который подготовил C-заголовок.
build_id = metadata["build_id"] # Контракт firmware-info v1 хранит ровно восемь ASCII-символов идентификатора.
if not re.fullmatch(r"[0-9a-fA-F]{8}|[0-9a-fA-F]{7}\+|NOGIT000", build_id) or stamp.utcoffset() is None or stamp.utcoffset().total_seconds(): # Исключает неоднозначную дату и неподдерживаемый идентификатор.
raise ValueError("Invalid prebuild identity") # Требует заново выполнить prebuild вместо выпуска чужих метаданных.
words = [1, *metadata["version"], stamp.year, stamp.month * 256 + stamp.day, stamp.hour * 256 + stamp.minute, stamp.second] # Независимо восстанавливает первые восемь 16-битных регистров общего контракта.
words += [ord(build_id[index]) * 256 + ord(build_id[index + 1]) for index in range(0, 8, 2)] # Упаковывает две ASCII-октеты в каждое из четырёх слов идентификатора.
expected = struct.pack("<12H", *words) # TI SCI8 хранит каждое слово полезных данных младшей октетой вперёд.
high, low = struct.unpack_from("<HH", data, 18) # Читает точку входа после ключа и восьми резервных слов загрузчика.
entry = (high << 16) | low # Адрес C28x передаётся старшим словом перед младшим.
offset, found, blocks, boot, loaded = 22, 0, [], 0, {} # Запоминает диапазоны, boot-переход и точные загружаемые слова для сопоставления Flash COFF с SCI8.
while offset + 2 <= len(data): # Перед чтением размера требует наличие полного 16-битного слова.
count, = struct.unpack_from("<H", data, offset) # Длина блока задана в адресуемых словах C28x, а не физических октетах.
offset += 2 # Пропускает размер перед адресом блока или терминатором таблицы.
if not count: # Нулевое слово завершает SCI8 без последующего адресного поля.
if offset != len(data) or found != 1 or (flash and boot != 1) or not any(start <= entry < end for start, end in blocks): # Дополнительно требует единственный двухсловный аппаратный переход Flash boot.
raise ValueError(f"SCI8 identity/entry/terminator mismatch: matching identities={found}") # Сообщает отсутствие встроенного паспорта вместо ложной подписи старого OUT.
return entry, loaded # Flash-проверка сопоставит реальные загрузочные слова с секциями исходного COFF; RAM-вызов может игнорировать результат.
if offset + 4 + count * 2 > len(data): # Требует полный 32-битный адрес и все октеты полезной нагрузки.
raise ValueError("Truncated SCI8 section") # Не допускает выпуск усечённой секции даже при паспорте в её начале.
high, low = struct.unpack_from("<HH", data, offset) # Получает адрес назначения текущего блока в словах C28x.
address, end = (high << 16) | low, ((high << 16) | low) + count # Конец исключается из диапазона, поэтому соседние блоки могут соприкасаться.
allowed = (0x300000 <= address < end <= 0x33FF80 or (address == 0x33FFF6 and count == 2)) if flash else 0x8000 <= address < end <= 0xD000 # Flash запрещает OTP, CSM и произвольную RAM; разрешён только отдельный boot-переход перед паролями CSM.
if not allowed or any(address < old_end and start < end for start, old_end in blocks): # Любое перекрытие секций либо несовместимый тип таблицы блокирует выпуск.
raise ValueError("SCI8 block outside application RAM or overlapping") # Не выпускает Flash-таблицу как EEPROM/RAM-образ.
blocks.append((address, end)) # Сохраняет проверенный диапазон для контроля следующих блоков и точки входа.
payload = data[offset + 4:offset + 4 + count * 2] # Ищет паспорт только внутри данных, исключая поля заголовка и адреса.
boot += int(flash and address == 0x33FFF6 and count == 2) # Аппаратный переход должен присутствовать ровно один раз в Flash-таблице.
loaded.update((address + index, value) for index, value in enumerate(struct.unpack("<" + "H" * count, payload))) # Фиксирует реальные 16-битные слова, которые RS-загрузчик запрограммирует во Flash.
found += sum(payload[index:index + 24] == expected for index in range(0, len(payload) - 23, 2)) # Учитывает лишь выровненные на слово экземпляры 12 регистров firmware-info.
offset += 4 + count * 2 # Переходит за полный адрес и полезные слова к следующему размеру.
raise ValueError("Missing SCI8 terminator") # Исчерпание файла без нулевого слова никогда не считается успешной конверсией.
def verify_package(image, metadata): # Связывает BIN, manifest и SHA-256 с тем же prebuild и аппаратной EEPROM.
manifest = json.loads(image.with_suffix(image.suffix + ".manifest.json").read_text(encoding="utf-8")) # Один контракт SHA/паспорта обслуживает отдельные RAM BIN, Flash COFF и Flash SCI8.
data = image.read_bytes() # Повторно считывает точные октеты перед постоянной публикацией.
digest = hashlib.sha256(data).hexdigest() # Вычисляет контрольную сумму независимо от общего seal.
if manifest.get("file") != image.name or manifest.get("size_bytes") != len(data) or manifest.get("sha256") != digest: # Требует согласованности имени, размера и содержимого файла.
raise ValueError("BIN does not match its manifest") # Не публикует повреждённый либо перепутанный комплект.
if any(manifest.get(key) != value for key, value in metadata.items()): # Проверяет также eeprom, физическую границу, версию и происхождение компилируемых templates.
raise ValueError("Manifest does not match prebuild identity/EEPROM") # Один лишь корректный SHA не разрешает паспорт другого аппаратного варианта.
if image.with_suffix(image.suffix + ".sha256").read_text(encoding="utf-8").strip() != f"{digest} {image.name}": # Общий sidecar содержит SHA и точное имя через два пробела.
raise ValueError("Invalid BIN SHA-256 sidecar") # Требует целостности всех трёх публикуемых файлов.
def verify_linker_profile(map_path, profile): # Сверяет аппаратную настройку Python с фактическими абсолютными символами линкера.
text = map_path.read_text(encoding="utf-8-sig") # MAP текущей конфигурации является обязательным результатом успешной линковки.
expected = {"_EEPROM_TOTAL_BYTES": profile["eeprom_bytes"], "_EEPROM_FIRMWARE_LIMIT_BYTES": profile["max_image_bytes"], "_EEPROM_PARAMS_START_WORD": profile["max_image_bytes"] // 2} # Символы разделяют физические октеты и адресуемые слова C28x.
for name, value in expected.items(): # Проверяет ёмкость, конец прошивки и начало сохраняемых параметров до запуска hex2000.
values = re.findall(r"^\s*(?:\w+\s+)?([0-9a-fA-F]{8})\s+" + re.escape(name) + r"\b", text, re.M) # Принимает формат глобальных TI-символов с номером страницы либо признаком ABS.
if not values or any(int(item, 16) != value for item in values): # Повторные списки MAP обязаны описывать один и тот же профиль.
raise ValueError(f"Linker EEPROM profile mismatch: {name}") # Выявляет define, переданный только компилятору или только линкеру, и устаревшую карту.
def verify_flash_coff(image, compiler): # Проверяет реальные секции COFF официальным TI-декодером и возвращает точные Flash-слова загрузки.
tool = compiler / "bin/ofd2000.exe" # Разбирает формат тем же установленным C2000 toolchain, который создал OUT.
document = ET.fromstring(subprocess.check_output([str(tool), "-x", str(image)], stderr=subprocess.STDOUT)) # XML содержит фактические адреса и двоичные данные секций, а не неподтверждённую соседнюю MAP.
coff = document.find(".//ti_coff") # Вариант предназначен строго для COFF ABI F28335.
if coff is None or coff.findtext("file_header/target_id") != "0x9d" or coff.findtext("file_header/exec") != "true": # Не принимает объект другого процессора, ELF либо незалинкованный модуль.
raise ValueError("Expected executable C2000 COFF Flash image") # Явно отделяет JTAG Flash OUT от обычного RAM OUT и чужих архитектур.
sections = {section.findtext("name"): section for section in coff.findall("section")} # Именованные выходные секции соответствуют отдельной Flash-карте линкера 167.
required = {".text": (0x300000, 0x33FF80, 0x300000, 0x33FF80), "codestart": (0x33FFF6, 0x33FFF8, 0x33FFF6, 0x33FFF8), "flash_rs": (0x8000, 0xC000, 0x300000, 0x33FF80), "ramfuncs": (0xC000, 0xD000, 0x300000, 0x33FF80)} # OFD COFF называет physical адресом RUN, virtual — LOAD; диапазоны выражены словами C28x.
for name, (run_begin, run_end, load_begin, load_end) in required.items(): # Наличие автономного RAM-загрузчика и InitFlash обязательно для выпуска Flash-варианта.
section = sections.get(name) # Отсутствующая обязательная секция не маскируется другими именами или символами MAP.
if section is None: # Проверяет отдельную карту и startup, а не одно лишь расположение основного кода.
raise ValueError("Missing Flash COFF section: " + name) # Не выдаёт RAM COFF за пригодный для автономной Flash.
run, load, size = (int(section.findtext(field, "0"), 0) for field in ("physical_addr", "virtual_addr", "raw_data_size")) # Длина OFD задана физическими октетами, оба адреса — 16-битными словами CPU.
if not size or size % 2 or not run_begin <= run < run + size // 2 <= run_end or not load_begin <= load < load + size // 2 <= load_end or (name == "codestart" and size != 4): # boot-переход имеет ровно два слова; прочие секции целиком помещаются в разрешённые LOAD/RUN-области.
raise ValueError("Invalid Flash COFF LOAD/RUN section: " + name) # Отвергает stale linker, размещение API во Flash во время стирания и аппаратный вход вне 0x33FFF6.
loaded = {} # Сопоставляет слова всех загружаемых Flash-секций с будущей SCI8-таблицей RS.
for section in sections.values(): # Служебные debug/copy-секции адреса ноль в программирование не входят.
address = int(section.findtext("virtual_addr", "0"), 0) # Для COFF TI это загрузочный адрес содержимого секции.
raw = section.findtext("raw_data") # Пустая .ebss, NOLOAD или DSECT не задаёт байтов прошивки.
if raw is None or not 0x300000 <= address < 0x340000: # Не включает отладочные записи, ROM-таблицы и рабочую RAM в образ Flash.
continue # Права оставшихся загружаемых Flash-слов дополнительно проверит общий SCI8-валидатор.
data = base64.b64decode(raw) # Получает именно те октеты, которые записаны в COFF и должны оказаться в Flash SCI8.
if len(data) % 2: # Любая программируемая секция C28x должна содержать целые 16-битные слова.
raise ValueError("Odd Flash COFF section size") # Не допускает неоднозначную упаковку образа RS.
for index, value in enumerate(struct.unpack("<" + "H" * (len(data) // 2), data)): # Восстанавливает little-endian представление каждого физического слова COFF.
if address + index in loaded: # Два выходных диапазона не должны программировать одно слово повторно.
raise ValueError("Overlapping Flash COFF load sections") # Проверяет реальный OUT независимо от доверия к линкерной карте.
loaded[address + index] = value # Сохраняет ожидаемые данные для независимого сравнения с hex2000.
entry = int(coff.findtext("optional_file_header/entry_point", "0"), 0) # Получает реальную точку входа C runtime из заголовка COFF.
if entry not in loaded or not 0x300000 <= entry < 0x33FF80: # C startup должен находиться в полностью загружаемой исполняемой Flash.
raise ValueError("Flash COFF entry is not loaded") # Исключает OUT со старой RAM-точкой входа или отрезанным startup.
return entry, loaded # Полное сравнение с SCI8 обнаружит конверсию другого OUT, потерю секции или подмену одного слова.
def verify_flash_release(stage, artifact, metadata, compiler, identity, required=False): # Проверяет и отдельно маркирует Flash COFF/SCI8 в staged-выпуске до любого постоянного копирования.
base = Path(artifact.replace("\\", "/")).name # Использует исходное имя артефакта CCS без директории и расширения OUT.
coff, serial = stage / (base + "_flash.out"), stage / (base + "_flash_rs.bin") # JTAG COFF и RS SCI8 являются разными формами одного отдельного Flash-варианта.
if not coff.exists() and not serial.exists() and not required: # Проекты без build_flash.py и host-фикстуры сохраняют прежний защищённый выпуск RAM.
return # Наличие обычного RAM BIN само по себе не объявляет поддержку Flash.
if not coff.is_file() or not serial.is_file(): # Сборка Flash должна выпустить оба согласованных артефакта.
raise ValueError("Incomplete Flash COFF/SCI8 release") # Не экспортирует один старый OUT вместе с новым RAM-выпуском.
verify_linker_profile(coff.with_suffix(".map"), metadata) # Flash использует физическую EEPROM для параметров и не меняет её профиль при размещении кода внутри CPU.
if verify_flash_coff(coff, compiler) != verify_embedded(serial, metadata, flash=True): # Сравнивает entry и каждое загрузочное слово официального COFF с результатом hex2000.
raise ValueError("Flash SCI8 does not match its COFF") # Отклоняет stale конверсию даже при правильных независимых SHA-файлах.
pairs = [(path, "COFF") for path in stage.rglob(coff.name)] + [(path, "SCI8-FLASH") for path in stage.rglob(serial.name)] # Включает плоские результаты и все их копии внутри текущего архива.
for path, kind in pairs: # Сначала проверяет весь исходный комплект, не меняя даже временных паспортов при первом отказе.
verify_package(path, metadata) # Общий postcompile обязан сохранить текущие version/EEPROM/SHA для каждого результата.
if path.read_bytes() != (coff if kind == "COFF" else serial).read_bytes(): # Архивированная копия должна быть побайтно тем же проверенным вариантом.
raise ValueError("Flash archive differs from staged release") # Не позволяет экспортировать чужой Flash внутри корректного RAM-архива.
with tempfile.TemporaryDirectory(prefix=".variant-", dir=stage) as directory: # Вариантные JSON нужны только для подписи разных форматов и не попадают в постоянный выпуск.
metadata_path = Path(directory) / "metadata.json" # Общий seal принимает обычный путь и не требует изменения соседнего templates.
for path, kind in pairs: # Только проверенные Flash-файлы получают явный признак исполнения и транспортный формат.
specific = dict(metadata, execution="FLASH", image_format=kind) # eeprom остаётся M95M02/AT25256B: исполнение Flash не подменяет физический тип сохраняемых параметров.
metadata_path.write_text(json.dumps(specific, ensure_ascii=False), encoding="utf-8") # Сохраняет все поля происхождения и ручную версию из общего prebuild.
identity.seal(path, metadata_path) # Переподписывает конкретный COFF либо SCI8 с явным execution=FLASH только после проверки байтов.
verify_package(path, specific) # Подтверждает согласованность готового вариантного manifest и SHA перед публикацией.
def convert(compiler, build_dir, artifact, metadata_path, stage, tools_templates): # Оборачивает общий postcompile без передачи постоянного output либо export.
script = tools_templates / "tools/firmware-build/ccs/postcompile.bat" # Общая BAT-точка остаётся в полной рабочей библиотеке инструментов.
if not script.is_file(): # Отсутствие зависимости не должно возвращать прежний выпуск как новый.
raise FileNotFoundError(script) # Указывает конкретную недостающую точку конверсии.
artifact_path = Path(artifact) # CCS допускает абсолютный OUT-базис либо имя относительно BuildDirectory.
source = Path(str(artifact_path if artifact_path.is_absolute() else build_dir / artifact_path) + ".out") # Выбирает только свежий RAM COFF текущего вызова.
with tempfile.TemporaryDirectory(prefix=".input-", dir=stage) as directory: # Общий Flash postbuild копирует дополнительные результаты рядом с входным OUT; это место тоже должно быть временным.
staged_source = Path(directory) / source.name # Не позволяет общей библиотеке публиковать непроверенный Flash OUT рядом с настоящим RAM-артефактом.
shutil.copy2(source, staged_source) # Даёт конвертору точную копию текущего OUT без изменения оригинала или его каталога.
subprocess.run(["cmd.exe", "/d", "/c", "call", str(script), "--identity", str(compiler), str(build_dir), str(staged_source.with_suffix("")), str(metadata_path), str(stage)], check=True) # И архивы, и служебные копии всех вариантов остаются временными до локальных проверок.
def publish(project, templates, tools_templates, compiler, build_dir, artifact, map_path, output, export=None, eeprom=None): # Выпускает только проверенные результаты конкретной конфигурации CCS.
project, templates, tools_templates = project.resolve(), templates.resolve(), tools_templates.resolve() # Фиксирует выбранные исходники и инструменты независимо от рабочего каталога терминала.
build_dir, compiler = build_dir.resolve(), compiler.resolve() # Общая BAT-точка получает полные пути текущих компилятора и Debug/Release.
metadata_path = build_dir / "generated/firmware_identity.json" # Использует паспорт, подготовленный до компиляции этой конфигурации.
metadata = json.loads(metadata_path.read_text(encoding="utf-8")) # Отсутствующий prebuild останавливает работу до создания выпуска.
profile = read_profile(project, templates, eeprom) # Повторно читает текущий выбор EEPROM и общий резерв параметров.
settings = json.loads((project / "firmware_identity.json").read_text(encoding="utf-8-sig")) # Сверяет product и target с действующим проектом.
expected = {"product": settings["product"], "target": settings["target"], "version": read_version(project / "firmware_version.h"), "templates_root": str(templates), **profile} # Ручной номер и аппаратный вариант обязаны совпадать с prebuild.
if any(metadata.get(key) != value for key, value in expected.items()): # Не подписывает старый OUT после изменения версии, EEPROM либо компилируемой зависимости.
raise ValueError("Configuration changed: run prebuild and rebuild before publishing") # Требует пересборку вместо подмены старых метаданных.
verify_linker_profile(map_path.resolve(), profile) # Проверяет аппаратный выбор линкера, который нельзя вывести только из Python-конфигурации.
with tempfile.TemporaryDirectory(prefix=".verified-release-", dir=build_dir) as directory: # Единственное место, куда общий postcompile пишет до подтверждения пригодности BIN.
stage = Path(directory) # Изолирует все архивы и промежуточные HEX от постоянных каталогов выпуска.
convert(compiler, build_dir, artifact, metadata_path, stage, tools_templates) # Любая ошибка TI или общей библиотеки прерывает публикацию.
image_name = Path(artifact.replace("\\", "/")).name + "_" + metadata["build_id"] + ".bin" # Повторяет штатное имя конкретного образа, не сканируя старые BIN.
image = stage / image_name # Проверяет только результат текущего вызова конвертора.
verify_embedded(image, metadata) # Обязательные проверки EEPROM, полной SCI8-таблицы и реально встроенных 12 слов.
verify_package(image, metadata) # Сверяет SHA и весь паспорт, включая физический профиль EEPROM.
for archived in stage.rglob(image_name): # Проверяет также копии внутри текущего архива перед их публикацией или export.
verify_package(archived, metadata) # Архив обязан содержать те же байты и профиль, что плоский выпуск.
spec = importlib.util.spec_from_file_location("release_identity_tools", tools_templates / "c/firmware-info/tools/identity.py") # Подключает существующий формат именования и экспорта архива без копирования реализации.
identity = importlib.util.module_from_spec(spec) # Создаёт отдельный модуль инструментов, не подменяя компилируемую зависимость паспорта.
spec.loader.exec_module(identity) # Ошибка подключения остаётся внутри временного этапа до постоянных файлов.
verify_flash_release(stage, artifact, metadata, compiler, identity, required=(build_dir.parent / "build_flash.py").is_file()) # Отдельная Flash-сборка требует собственного безопасного COFF/SCI8 и не ослабляет прежние RAM-проверки.
archive_name = identity.build_folder_name(metadata) # Сохраняет принятые имена архивов с ревизией, признаком изменений и временем UTC+3.
if not (stage / archive_name / image_name).is_file(): # Полный архив является обязательным результатом общей конверсии, а не необязательной старой папкой.
raise ValueError("Common postcompile did not produce the current build archive") # Не публикует неполный комплект без OUT, MAP и паспорта текущего выпуска.
output = output.resolve() # Постоянный каталог появляется только после всех проверок staged-комплекта.
output.mkdir(parents=True, exist_ok=True) # Прежние проверенные выпуски сохраняются при добавлении нового.
for item in stage.iterdir(): # Переносит только файлы и архив, созданные данным postcompile.
if item.is_dir(): # Архив содержит сопроводительные результаты той же сборки.
shutil.copytree(item, output / item.name, dirs_exist_ok=True) # Копирует проверенный архив без очистки других выпусков.
else: # Плоские BIN/HEX и их паспорта остаются совместимыми с прежними потребителями.
shutil.copy2(item, output / item.name) # Сохраняет имена и содержимое прошедшего проверки комплекта.
verify_package(output / image_name, metadata) # Подтверждает отсутствие повреждения при копировании на постоянный диск.
if export is not None: # Копирование в каталог GUI выполняется последним и лишь для прошедшего проверки архива.
identity.export_build(output / archive_name, export.resolve(), image_name) # Использует общий экспорт уже проверенного локального выпуска.
print(f"[firmware-build] Verified {profile['eeprom']} BIN: {output / image_name}") # Показывает пригодный аппаратный профиль и точный путь конечного файла.
return output / image_name # Даёт тестам и внешним средствам однозначный результат без поиска по времени.
if __name__ == "__main__": # Импорт для host-тестов не запускает TI и не меняет каталоги выпуска.
parser = argparse.ArgumentParser(description=__doc__) # Описывает назначение защищённого postbuild в сообщениях CCS.
for argument in ("project", "templates", "tools-templates", "compiler", "build-dir", "map", "output"): # Каждый обязательный путь задаётся настройками активной конфигурации CCS.
parser.add_argument("--" + argument, type=Path, required=True) # Проверяет обязательность аргументов до любых файловых операций.
parser.add_argument("--artifact", required=True) # Получает прежний BuildArtifactFileBaseName с допустимым абсолютным путём.
parser.add_argument("--export", type=Path) # Сохраняет возможность явно отключить экспорт при ручной проверке или в тестах.
parser.add_argument("--eeprom", choices=("AT25256B", "M95M02")) # Явный CLI-профиль должен совпадать с prebuild и линкерными define.
arguments = vars(parser.parse_args()) # argparse переводит дефисы имён аргументов в подчёркивания параметров функции.
arguments["map_path"] = arguments.pop("map") # Отделяет путь карты от встроенного имени map, не меняя CLI CCS.
try: # Ошибочный образ возвращает сборке явный ненулевой код.
publish(**arguments) # Выполняет проверку и публикацию только после разбора полного набора аргументов.
except (OSError, ValueError, KeyError, TypeError, struct.error, subprocess.CalledProcessError) as error: # Включает ошибки формата, инструментов и отсутствующие файлы staged-комплекта.
parser.exit(1, f"[firmware-build] ERROR: {error}\n") # Не маскирует отказ проверок сообщением об успешном выпуске.
"""Совместимый адаптер общего процесса подготовки C2000 из templates.""" # Сохраняет прежние импорты и команды без копирования алгоритмов.
import importlib.util # Подключает единственный модуль проверки и подготовки, общий для 166/167.
import os # Позволяет явно выбрать полный checkout инструментов на другом компьютере.
from pathlib import Path # Вычисляет соседний templates без привязки к букве диска.
import sys # Передаёт старые аргументы общей точке входа и сохраняет совместимость импортов.
tools = Path(os.environ.get("FIRMWARE_BUILD_TEMPLATES", Path(__file__).resolve().parents[2] / "newProject/templates")) # Переменная задаёт только корень инструментов; компилируемые исходники передаются отдельным --templates.
name = "_shared_c2000_build" # Оба старых адаптера разделяют один модуль и один набор проверок.
if name not in sys.modules: # Повторный импорт не создаёт независимую копию функций и состояния.
spec = importlib.util.spec_from_file_location(name, tools / "c/firmware-info/tools/c2000_build.py") # Единственный алгоритм расположен в полной библиотеке templates.
module = importlib.util.module_from_spec(spec) # Создаёт модуль без запуска подготовки и компилятора.
sys.modules[name] = module # Регистрирует общий модуль до импорта для совместимых host-тестов.
spec.loader.exec_module(module) # Отсутствующие инструменты возвращают явную ошибку вместо старой локальной реализации.
module = sys.modules[name] # Подготовка паспорта, проверка и архивирование используют одну реализацию.
if __name__ == "__main__": # Прямой старый вызов CCS получает прежний набор параметров.
raise SystemExit(module.main(["build", *sys.argv[1:]])) # Возвращает фактический результат общей команды без маскирования ошибок.
sys.modules[__name__] = module # Сохраняет публичные prepare/read_profile/publish/verify_* для существующих проектных тестов и Flash-сборщика.
+29
View File
@@ -0,0 +1,29 @@
#include <assert.h> /* Сравнивает аппаратные номера приложения и загрузчика для всех положений перемычек. */
#include <stdio.h> /* Сообщает результат проверки без обращения к физическому GPIO или CAN. */
#define EALLOW /* В host-модели запись конфигурации GPIO не требует доступа к защищённым регистрам TI. */
#define EDIS /* Конец защищённого аппаратного участка не меняет алгоритм чтения перемычек. */
struct address_bits { unsigned int GPIO20, GPIO21, GPIO22, GPIO51; }; /* Модель содержит только четыре реально используемых входа адреса. */
struct address_register { struct address_bits bit; }; /* Сохраняет production-обращения вида GPADAT.bit.GPIO21 без переписывания кода. */
static struct { struct address_register GPAMUX2, GPBMUX2, GPADIR, GPBDIR; } GpioCtrlRegs; /* Конфигурация входов отделена от их физических уровней. */
static struct { struct address_register GPADAT, GPBDAT; } GpioDataRegs; /* Содержит состояния перемычек двух GPIO-портов ПМ35. */
static unsigned int Mode; /* Production-фрагмент get_Mode записывает аппаратный номер в эту переменную приложения. */
#include "production_boot_address.inc" /* Включает точное тело boot_periph_id из текущего main постоянного загрузчика. */
static unsigned int application_periph_id(void) /* Выполняет извлечённые production-операторы Mode из peripher.c приложения. */
{ /* Комментарии и пять назначений приложения сохраняются без собственной копии алгоритма. */
#include "production_application_address.inc" /* Текущий get_Mode должен давать тот же результат, что чтение recovery после reset. */
return Mode; /* Возвращает реальный номер, который main передаёт в F28335CanBoot_Init. */
} /* Отделяет аппаратное чтение от остальной инициализации силовых выходов приложения. */
int main(void) /* Проверяет все 16 комбинаций четырёх перемычек существующей платы. */
{ /* Тест подтверждает совпадение приложения и recovery независимо от CAN-таблицы и адресов EEPROM. */
unsigned int switches; /* Каждая единица этого тестового номера означает замкнутую перемычку с низким уровнем. */
for(switches=0U;switches<16U;++switches) { /* Перебирает все физически доступные номера Mode 1–16. */
GpioDataRegs.GPADAT.bit.GPIO21=!(switches&1U); /* Самый младший разряд активен низким уровнем GPIO21. */
GpioDataRegs.GPADAT.bit.GPIO20=!(switches&2U); /* Второй разряд имеет вес 2 и поступает через GPIO20. */
GpioDataRegs.GPADAT.bit.GPIO22=!(switches&4U); /* Третий разряд имеет вес 4 и поступает через GPIO22. */
GpioDataRegs.GPBDAT.bit.GPIO51=!(switches&8U); /* Старший разряд имеет вес 8 и поступает через порт B. */
assert(boot_periph_id()==switches+1U); /* У загрузчика, как у штатного Mode, база адресного номера равна единице. */
assert(application_periph_id()==boot_periph_id()); /* После reset плата обязана сохранить адрес, иначе ACK пришёл бы от другого устройства. */
} /* Переключение границы Mode 15→16 также проверяется реальными production-операторами. */
puts("PASS: application and loader GPIO address match for every jumper combination"); /* Результат не заявляет физическую проверку контактов на стенде. */
return 0; /* Все аппаратные комбинации совпали без записи файлов прошивки или EEPROM. */
} /* Завершает независимую проверку источника физического номера PERIPH. */
+53
View File
@@ -0,0 +1,53 @@
#define F28335_CAN_FLASH_UPDATE 1 /* Включает настоящий выбор памяти и Flash callbacks аппаратного CAN-порта в host-модели. */
#include "transfer_model.c" /* Использует существующие реальные ядро, EEPROM-журнал, CAN mailbox и экспорт кадров клиента. */
#include "f28335_flash_app.c" /* Проверяет фактически записанный FAB1 тем же кодом, что постоянный загрузчик. */
static uint16_t flash_memory[0x40000]; /* Моделирует все 256 Кслов внутренней Flash F28335, включая защищённый сектор A. */
static unsigned int flash_fault, flash_erases, flash_programs; /* Вводит аппаратные отказы erase, данных и завершающего FAB1. */
static bool erase_model(void *user) /* Моделирует только аппаратную операцию TI Flash_Erase. */
{ /* Постоянный boot обязан пережить любой результат обновления. */
uint32_t i; (void)user; ++flash_erases; /* Фиксирует первый фактический erase, отделяя его от подготовки staging EEPROM. */
for (i = 0UL; i < 0x38000UL; ++i) flash_memory[i] = 0xFFFFU; /* Маска FE стирает B–H до адреса 0x338000 и не касается A. */
return flash_fault != 1U; /* Отказ erase оставляет приложение недействительным и boot доступным. */
} /* Эта подмена не меняет алгоритм проверки и порядка программирования. */
static bool program_model(void *user, uint32_t address, uint16_t *data, unsigned int words) /* Моделирует физическую запись и readback одной порции. */
{ /* Отдельно контролирует адреса каждого production-вызова. */
unsigned int i, count = words; (void)user; ++flash_programs; /* Подсчитывает операции, включая попытку публикации FAB1. */
if (address < F28335_FLASH_APP_START || address >= F28335_FLASH_APP_STOP || words > F28335_FLASH_APP_STOP - address) return false; /* Даже ошибочный writer не обращается за пределы модели. */
if (flash_fault == 2U || (flash_fault == 3U && address == F28335_FLASH_APP_START)) count /= 2U; /* Обрыв питания оставляет половину данных либо половину FAB1. */
for (i = 0U; i < count; ++i) flash_memory[address - F28335_FLASH_APP_START + i] = data[i]; /* Сохраняет частичный физический результат до сообщения об ошибке. */
return count == words; /* Неполная запись не должна подтверждать COMMIT. */
} /* Успешная порция полностью совпадает с переданным RAM-буфером. */
static uint16_t read_model(void *user, uint32_t address) /* Даёт production-валидатору фактические слова модели Flash. */
{ /* CPU-адреса преобразуются в индексы только внутри host-аппаратуры. */
(void)user; assert(address >= F28335_FLASH_APP_START && address < F28335_FLASH_APP_STOP); /* Проверяет границы каждого итогового чтения FAB1/CRC. */
return flash_memory[address - F28335_FLASH_APP_START]; /* Возвращает записанное значение, а не ожидаемое слово staging. */
} /* CRC физической памяти считается production-кодом. */
bool F28335Boot_FlashProgram(f28335_flash_update_t *s) /* Подменяет только обвязку официального TI API, сохраняя настоящий Flash writer. */
{ /* Вся структурная проверка, повторная CRC и порядок FAB1 остаются неизменёнными. */
f28335_flash_ops_t ops = { erase_model, program_model, read_model, 0 }; /* Передаёт операции модели через публичный аппаратный контракт. */
return f28335_flash_update_program(s, &ops); /* Ошибка модели проходит через обычный статус CAN COMMIT. */
} /* Python управляет лишь входными кадрами и аппаратными отказами. */
__declspec(dllexport) void model_flash_reset(unsigned int fault) /* Начинает независимый сценарий без физических интерфейсов. */
{ /* Заполняет boot контрольным значением перед проверкой его сохранности. */
uint32_t i; model_reset(); flash_fault = fault; flash_erases = flash_programs = 0U; /* Сбрасывает CAN/EEPROM штатной моделью и выбирает точку отказа. */
for (i = 0UL; i < 0x40000UL; ++i) flash_memory[i] = 0x5A5AU; /* Контрольное заполнение выявляет стирание любого слова сектора A. */
} /* Последующее обновление должно изменить только область приложения. */
__declspec(dllexport) unsigned int model_flash_valid(void) /* Проверяет возможность запуска после успеха либо смоделированного обрыва. */
{ /* Использует единый валидатор постоянного boot. */
uint32_t entry; return f28335_flash_app_validate(read_model, 0, &entry); /* Частично записанный файл не должен получить разрешение запуска. */
} /* Никакая модельная переменная успеха не заменяет реальную CRC. */
__declspec(dllexport) unsigned int model_flash_intact(void) /* Подтверждает сохранность boot и защищённой области EEPROM. */
{ /* Проверяет каждый адрес сектора A после любой попытки обновления. */
uint32_t i; for (i = 0x38000UL; i < 0x40000UL; ++i) if (flash_memory[i] != 0x5A5AU) return 0U; /* Весь сектор A, включая аппаратный вход и CSM, остаётся исходным. */
return model_parameters_intact(); /* Дополнительно проверяет резерв и все параметры M95M02. */
} /* Сохранность загрузчика проверяется независимо от результата COMMIT. */
__declspec(dllexport) unsigned int model_flash_erase_count(void) { return flash_erases; } /* Позволяет доказать отсутствие erase при ошибке CRC, адреса или назначения. */
__declspec(dllexport) void model_flash_corrupt(void) { memory[(flash_staging ? F28335_AB_SLOT_B : F28335_AB_SLOT_A) + 30UL] ^= 1U; } /* Повреждает EEPROM между VERIFY и COMMIT для проверки повторной CRC до erase. */
__declspec(dllexport) unsigned int model_flash_check(const pcan_boot_byte_t *data, unsigned int length) /* Проверяет недоверенные SCI8 непосредственно MCU-валидатором, минуя локальный отказ клиента. */
{ /* Разрушительные callbacks Flash в этой проверке вообще не вызываются. */
unsigned int i; pcan_boot_manifest_t manifest; f28335_boot_io_t io = { F28335Boot_Read, F28335Boot_Write, 0 }; /* Источник остаётся настоящим интерфейсом staging EEPROM. */
if (length > F28335_AB_SLOT_BYTES) return 0U; /* Не позволяет самой модели выйти за физическую ёмкость слота. */
for (i = 0U; i < length; ++i) memory[F28335_AB_SLOT_A + i] = (unsigned char)data[i]; /* Подменяет только ранее принятые байты физической EEPROM. */
memset(&manifest, 0, sizeof(manifest)); manifest.image_size = length; manifest.image_crc32 = pcan_boot_crc32_update(0UL, data, length); /* Транспортная CRC намеренно правильная даже для структурно запрещённой таблицы. */
return f28335_flash_update_validate(&flash_update, &io, F28335_AB_SLOT_A, &manifest); /* Отказ должен возникать на адресах, структуре или FAB1, а не на CRC CAN. */
} /* Такой повреждённый файл не получает разрешение erase даже от произвольного внешнего клиента. */
+29
View File
@@ -0,0 +1,29 @@
#include <stdlib.h> /* Позволяет ограничению модели завершить процесс при зависшем STOP. */
#define main existing_load_regressions /* Повторно использует проверенную модель GPIO, setup и tick действующих тестов нагрузки. */
#include "../load_control/load_control_test.c" /* Компилирует настоящий DAC.c с включённым новым путём CAN Boot. */
#undef main /* Собственный main проверяет переход из рабочего состояния в постоянный загрузчик. */
static unsigned int waiting_ticks; /* Ограничивает ожидание, чтобы ошибка остановки завершала тест, а не зависала. */
void ServiceDog(void) /* Моделирует работу Timer1 между проходами main, ожидающего завершённый STOP. */
{ /* Подменяет аппаратный scheduler, сохраняя настоящий алгоритм Load_runner. */
if (++waiting_ticks > 1500U) { puts("FAIL: CAN Boot STOP timeout"); exit(1); } /* Штатная остановка занимает около секунды; 1500 мс оставляет запас на границу периода ЦАП. */
CpuTimer1.InterruptCount++; /* Продвигает те же часы, которые читает production Load_boot_stop. */
Commands = 0x0380U; /* Продолжает подавать START, инициализацию и калибровку для проверки запрета повторного пуска. */
tick(1U, 1, 100U); /* Выполняет реальный миллисекундный автомат при свежем напряжении, которое обычно разрешает нагрузку. */
} /* Возвращается в цикл ожидания production функции. */
int main(void) /* Проверяет оба CAN-адреса нагрузок и вход из IDLE/работающего состояния. */
{ /* Содержит только модель времени и проверки наблюдаемых безопасных выходов. */
unsigned int mode, running, starts; /* Перебирает УМП5/6 и оба исходных состояния. */
for (mode = 5U; mode <= 6U; ++mode) { /* Обе штатные нагрузки обязаны одинаково останавливаться перед CAN Boot. */
for (running = 0U; running < 2U; ++running) { /* Начальный IDLE также должен получить полный STOP, даже если нагрузка ещё не запускалась. */
READY = 1; setup(mode); CpuTimer1.InterruptCount = 0UL; waiting_ticks = 0U; /* Сбрасывает production автомат и независимые часы очередного сценария. */
Commands = running ? 0x0080U : 0U; tick(20U, 1, 100U); /* При необходимости запускает нагрузку штатной командой до входа в загрузчик. */
starts = test_starts; /* Повторный START после открытия входа в boot запрещён. */
Load_boot_stop(); /* Вызывает настоящую блокирующую остановку, связанную с F28335Boot_Quiesce. */
CHECK(!READY && test_stop && !test_start && !test_permission && load_state == LOAD_IDLE); /* Требует снятый START, удержанный STOP и закрытый прикладной цикл. */
CHECK(load_zero_sent && !IMPowse && waiting_ticks >= 1000U && test_starts == starts); /* Проверяет завершение секундного импульса и отсутствие нового пуска от продолжающихся команд. */
CHECK(modbus[123] == DAC_min() && modbus[0x1C] == 40); /* Подтверждает реально отправленный код базовых 4 мА вместо калибровочного задания. */
} /* Завершает проверку двух исходных состояний. */
} /* Завершает обе штатные нагрузки. */
puts("PASS: CAN Boot uses full STOP and 4mA; live START/calibration cannot restart either load"); /* Сообщает проверенные свойства перехода, а не факт физической прошивки. */
return 0; /* Успех означает прохождение всех четырёх аппаратных сценариев модели. */
} /* Завершает поведенческую проверку остановки перед CAN Boot. */
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+6
View File
@@ -0,0 +1,6 @@
#ifndef CAN167_BOOT_TEST_H /* Предоставляет только аппаратно независимую часть включённого CAN Boot для модели ЦАП. */
#define CAN167_BOOT_TEST_H /* Исключает повторное объявление tick и тестового ServiceDog. */
#define CAN167_AB_ENABLED 1 /* Компилирует настоящий путь безопасной остановки, который выключен в старом Flash-тесте. */
static struct { unsigned long InterruptCount; } CpuTimer1; /* Воспроизводит миллисекундные часы без настоящего Timer1 F28335. */
void ServiceDog(void); /* Тестовый main моделирует очередной IRQ именно в ожидании штатного STOP. */
#endif /* Общий протокол тестируется отдельно против его production-ядра. */
+86
View File
@@ -0,0 +1,86 @@
"""Проверяет восстановление SETGUI после потерь CAN на настоящем ядре и EEPROM-порте F28335.""" # Аппаратная очередь ограничена 31 кадром, как production queue[32] с одним резервным элементом.
import ctypes # Передаёт кадры неизменённому C-ядру и получает настоящие ответы mailbox 4.
from collections import deque # Моделирует порядок CAN-кадров, уже отправленных клиентом в очередь загрузчика.
import os # Позволяет выбрать компилятор, зависимость templates и реальный пользовательский BIN.
from pathlib import Path # Формирует абсолютные пути независимо от каталога запуска проверки.
import subprocess # Компилирует production-порт с существующими аппаратными заглушками.
import sys # Подключает тот же пакет protocan, который использует SETGUI.
from types import SimpleNamespace # Предоставляет клиенту данные образа, версию и CRC без запуска GUI.
import zlib # Задаёт эталонный CRC32 тестового файла независимо от загрузчика.
import pytest # Разделяет сценарии потерь и гарантирует освобождение тестовой DLL.
ROOT = Path(__file__).resolve().parents[2] # Находит проект ПМ35 по расположению этой регрессии.
TEMPLATES = Path(os.environ.get("TEMPLATES_ROOT", ROOT.parent / "newProject/SETGUI/third_party/templates")) # По умолчанию проверяет фактическую зависимость SETGUI.
sys.path.insert(0, str(TEMPLATES / "python")) # Импортирует production-клиент вместо копии алгоритма передачи.
from protocan.can_boot import CanBootTarget, CanBootTransfer # Использует действующий автомат оконной загрузки.
from protocan.protocan import ProtoCanId # Различает DATA и STATUS штатным декодером идентификаторов.
from protocan.transport import build_frame # Возвращает ответы C-порта в стандартном формате клиента.
@pytest.fixture(scope="module") # Одна DLL обслуживает все независимые сценарии с полным сбросом EEPROM между ними.
def model(tmp_path_factory): # Создаёт программную модель без обращения к физическому CAN-адаптеру.
compiler = Path(os.environ.get("CC", "C:/msys64/ucrt64/bin/gcc.exe")) # Использует установленный host GCC, как остальные аппаратные регрессии проекта.
compiler_env = dict(os.environ, PATH=str(compiler.parent) + os.pathsep + os.environ.get("PATH", "")) # Предоставляет дочерним процессам GCC его DLL без изменения окружения пользователя.
core = TEMPLATES / "c/protocan-boot" # Объединяет ядро протокола, EEPROM-store и аппаратный CAN-порт одной версии.
library = tmp_path_factory.mktemp("can-recovery") / "transfer.dll" # Изолирует объект проверки от выпускаемых DLL приложения.
subprocess.run([str(compiler), "-std=c99", "-O2", "-shared", "-DPCAN_BOOT_WIDE_BYTES", "-I" + str(core), "-I" + str(core / "tests/f28335_stubs"), str(core / "src/pcan_boot.c"), str(core / "ports/tms320f28335/f28335_boot_store.c"), str(ROOT / "tests/can_boot/transfer_model.c"), "-o", str(library)], check=True, env=compiler_env) # Компилирует настоящий C28x-порт с широкими октетами и существующим тестовым экспортом.
with os.add_dll_directory(str(compiler.parent)): # Предоставляет Windows доступ к зависимостям выбранного GCC только на время загрузки.
device = ctypes.CDLL(str(library)) # Загружает локальную модель, которая не содержит операций с реальным оборудованием.
device.model_frame.argtypes = [ctypes.c_uint32, ctypes.POINTER(ctypes.c_uint), ctypes.c_uint, ctypes.POINTER(ctypes.c_uint32), ctypes.POINTER(ctypes.c_uint)] # Согласует 32-битный CAN ID и широкие октеты между Python и C.
try: # Освобождает DLL даже при обнаружении переполнения очереди либо ошибки передачи.
yield device # Каждый тест вызывает model_reset и получает отдельную пустую EEPROM.
finally: # Удаление временного каталога Windows возможно только после выгрузки библиотеки.
close = ctypes.WinDLL("kernel32", use_last_error=True).FreeLibrary # Использует штатное освобождение загруженной тестовой DLL.
close.argtypes, close.restype = [ctypes.c_void_p], ctypes.c_int # Сохраняет полный размер дескриптора в 64-битном процессе.
assert close(device._handle) # Не оставляет заблокированный файл после завершения регрессии.
@pytest.mark.parametrize("loss", ["first_block", "middle_block", "window_ack", "duplicate_ack"]) # Покрывает потерю DATA в начале/середине окна, потерю ACK и дубликат ACK.
def test_transfer_recovers_without_overfilling_device_queue(model, loss): # Передача должна завершиться после сбоя около показанных пользователем 64 процентов.
sample = bytearray(1054) # SCI8 содержит 22 байта заголовка, шесть байт описания секции, 1024 байта данных и два байта завершения.
sample[0:2], sample[21], sample[23], sample[27] = b"\xaa\x08", 0x80, 2, 0x80 # SCI8 задаёт entry 0x8000 и одну RAM-секцию из 512 слов; несколько окон позволяют проверить дубликат промежуточного ACK.
data = Path(os.environ["CAN167_IMAGE"]).read_bytes() if "CAN167_IMAGE" in os.environ else bytes(sample) # Позволяет проверить точные 41446 байт образа со скриншота без привязки теста к build ID.
target = CanBootTarget(device_type=1, device=8, product_type=0x2833, hardware_min=1, hardware_max=1) # Адрес и совместимость соответствуют задатчику PERIPH 8.
client = CanBootTransfer(SimpleNamespace(data=data, crc32=zlib.crc32(data), version=0x01010002), target) # Запускает production-клиент с проверяемым образом и ручной версией 1.1.2.
model.model_reset() # Каждая потеря проверяется независимо от ранее опубликованного pending.
pending = client.start() # Сохраняет запрос для штатного повтора по тайм-ауту SETGUI.
queue = deque(pending) # Сначала аппаратной очереди предназначена только команда ENTER_BOOT.
total = (len(data) + 7) // 8 # Протокол передаёт по восемь байт с дополнением последнего блока.
window_start = min((total * 64 // 100) // 16 * 16, max(0, (total - 1) // 16 * 16)) # Выбирает реальное окно около 64 процентов, сохраняя допустимость короткого SCI8.
lost_block = window_start + (min(5, total - window_start - 1) if loss == "middle_block" else 0) # Для частичного окна пропускает существующий внутренний блок, для first_block — первый.
window_end = min(total, window_start + 16) # Последнее укороченное окно подтверждается полным количеством блоков образа.
injected, retries, steps, max_queued = False, 0, 0, len(queue) # Ограничивает повторы и сохраняет доказательство отсутствия переполнения.
octets = ctypes.c_uint * 8 # Широкие октеты соответствуют типу pcan_boot_byte_t в C28x-сборке модели.
while not client.finished: # Завершение разрешается только после настоящих VERIFY, COMMIT и REBOOT ACK.
if not queue: # Отсутствие ответа после окна воспроизводит тайм-аут транспорта SETGUI.
retries += 1 # Бесконечное ожидание не может скрыть отсутствие восстановления.
assert retries <= 3, "Клиент не восстановил передачу за три повтора" # Соответствует текущему пределу повторов BusTab.
queue.extend(pending) # Повторяет последнее неподтверждённое окно, как _firmware_timeout.
request = queue.popleft() # F28335 обрабатывает один кадр из очереди за проход main.
identity = ProtoCanId.parse(request.can_id) # Использует production-разбор номера блока и типа сообщения.
steps += 1 # Ограничивает общую работу при ошибочной лавине повторных окон.
assert steps <= total * 20 + 100 # Даже серия восстановлений должна оставаться ограниченной относительно размера образа.
if not injected and loss in ("first_block", "middle_block") and identity.msg_type in (10, 11) and identity.body == lost_block: # Теряет ровно один DATA при неизменённом порядке остальных кадров.
injected = True # Следующий повтор пропущенного блока уже должен доставляться устройству.
continue # Не передаёт потерянный кадр ядру и не формирует вымышленный ответ.
reply_id, reply = ctypes.c_uint32(), octets() # Принимает реальные поля ответа из аппаратной модели mailbox 4.
count = model.model_frame(request.can_id, octets(*request.data), len(request.data), ctypes.byref(reply_id), reply) # Выполняет штатные запись EEPROM, readback, CRC и автомат команд.
if not count: # Внутри успешно принятого окна протокол не выдаёт ACK на каждый блок.
continue # Следующий уже отправленный кадр остаётся в аппаратной очереди.
response = build_frame(reply_id.value, bytes(reply[:]), to_can=False) # Преобразует восемь широких значений C28x в восемь wire-октетов без подмены status или next_block.
ack = ProtoCanId.parse(response.can_id) # Выделяет DATA ACK среди управляющих подтверждений.
affected = not injected and loss in ("window_ack", "duplicate_ack") and (ack.body & 255) == 0 and reply[0] == 0 and (reply[2] | reply[3] << 8) == window_end # Вмешивается только в успешное подтверждение выбранного окна.
if affected: # Однократный сбой канала должен быть пережит без перезапуска загрузчика.
injected = True # Повторный ACK того же окна после тайм-аута доставляется штатно.
if loss == "window_ack": # Потеря ответа оставляет клиенту последнее окно для повтора по тайм-ауту.
continue # Устройство уже записало данные, но клиент ещё не получил подтверждение.
for _ in range(2 if affected and loss == "duplicate_ack" else 1): # Повторяет один ACK, не повторяя запись EEPROM на стороне устройства.
outgoing, _ = client.handle_status(response) # Только production-клиент решает, следует ли посылать очередное окно.
if outgoing: # Игнорируемый дубликат не должен заменять набор для тайм-аута.
pending, retries = outgoing, 0 # Новое подтверждённое продвижение сбрасывает счётчик транспортных повторов.
queue.extend(outgoing) # Новые кадры приходят после уже стоящих в очереди хвостов предыдущего окна.
max_queued = max(max_queued, len(queue)) # Считает реальный объём ожидающих обработки кадров.
assert max_queued <= 31, f"Переполнение очереди загрузчика: {max_queued} кадров" # Production head/tail оставляет только 31 полезное место из queue[32].
assert injected and client.percent == 100 # Сценарий обязан действительно потерять/повторить кадр и полностью пройти протокол.
assert model.model_select() == 0 and model.model_confirm(0) # Настоящий журнал должен разрешить пробный запуск записанного A и его подтверждение.
assert model.model_parameters_intact() # Восстановление передачи не затрагивает защищённую область параметров платы.
+41
View File
@@ -0,0 +1,41 @@
#define main upstream_regressions /* Использует аппаратную модель общей библиотеки без запуска её собственного main. */
#include "tests/test_f28335_can_boot.c" /* Подключает настоящий CAN-порт, EEPROM-store, широкие октеты и аппаратные заглушки общей библиотеки. */
#undef main /* Экспортирует транспорт для существующего Python-клиента SETGUI. */
__declspec(dllexport) void model_reset(void) /* Создаёт пустую EEPROM с контрольным заполнением области параметров. */
{ /* Между передачами EEPROM сохраняется; эта функция вызывается лишь перед всей серией. */
memset(memory, 0xA5, sizeof(memory)); running = 255U; fail_write = 0; /* Запуск без active-слота воспроизводит первичную установку CAN-загрузчика. */
F28335CanBoot_Init(8U); /* Инициализирует задатчик PERIPH 8 с адресом Type 1 / Device 8 и чистой EEPROM. */
} /* Дальнейшая передача использует неизменённый production parser. */
__declspec(dllexport) unsigned int model_frame(uint32_t id, const pcan_boot_byte_t *data, unsigned int dlc, uint32_t *reply_id, pcan_boot_byte_t *reply) /* Принимает один реальный CAN-кадр клиента и возвращает ответ аппаратного порта. */
{ /* Меняет только железо и подтверждение физического TX; код команд остаётся общим. */
unsigned int i; /* Декодирует восемь аппаратных октетов, переданных в регистры MBOX4. */
tx_busy = 0; /* Предыдущий ответ уже подтверждён моделью CAN-шины до следующего запроса. */
(void)pcan_boot_process(&boot, id, data, dlc); /* Выполняет production сессию, ограничения устройства, CRC и callbacks EEPROM. */
if (!tx_busy) return 0U; /* В середине окна из 16 блоков ответ по протоколу не требуется. */
*reply_id = ECanaMboxes.MBOX4.MSGID.all & 0x1FFFFFFFUL; /* Удаляет только аппаратный IDE-бит, сохраняя полный 29-битный ProtoCAN ID. */
for (i = 0; i < 4U; ++i) { /* В аппаратном DBO=0 младший октет MDL/MDH идёт первым. */
reply[i] = (ECanaMboxes.MBOX4.MDL.all >> (i * 8U)) & 255U; /* Возвращает октеты status, slot и next_block из реального передатчика. */
reply[i + 4U] = (ECanaMboxes.MBOX4.MDH.all >> (i * 8U)) & 255U; /* Возвращает CRC32 принятых production-данных без повторного вычисления в модели. */
} /* Завершает чтение ответного mailbox. */
return 8U; /* Все статусы Boot имеют DLC=8. */
} /* Python-клиент получит тот же статусный кадр, что на физическом CAN. */
__declspec(dllexport) unsigned int model_select(void) /* Воспроизводит выбор слота при очередном аппаратном reset. */
{ /* attempted и rollback сохраняются настоящим журналом, а не переменными Python. */
unsigned int slot; /* FF означает, что ни один образ не разрешён к запуску. */
if (!f28335_boot_select(&store, &slot)) return 254U; /* Отдельное значение позволяет отличить ошибку журнала от пустого recovery. */
return slot; /* Возвращает trial, active либо recovery согласно production-алгоритму. */
} /* Повтор без CONFIRM обязан вернуть предыдущий active. */
__declspec(dllexport) unsigned int model_confirm(unsigned int slot) /* Моделирует подтверждение запущенным RAM-приложением после его READY. */
{ /* Проверяет фактическую публикацию active в том же энергонезависимом журнале. */
return f28335_boot_confirm(&store, slot); /* Не позволяет подтвердить слот, который ещё не выбирался для пробного запуска. */
} /* Подтверждённый слот защищается от следующих записей. */
__declspec(dllexport) void model_reopen(void) /* Воспроизводит перезапуск автомата загрузчика без стирания EEPROM. */
{ /* Новая сессия читает актуальный журнал после confirm либо rollback. */
F28335CanBoot_Init(8U); /* После перезапуска сохраняет адрес задатчика и сбрасывает только RAM-сессию протокола. */
} /* Сами два образа и параметры сохраняются. */
__declspec(dllexport) unsigned int model_parameters_intact(void) /* Проверяет всю защищённую верхнюю область M95M02 после серии обновлений. */
{ /* Значение A5 было записано только перед тестом и не должно меняться загрузчиком. */
uint32_t i; /* Адреса EEPROM выражены в октетах. */
for (i = 0x3FE00UL; i < 0x40000UL; ++i) if (memory[i] != 0xA5U) return 0U; /* Проверяет резерв, 258 октетов параметров и последнее неиспользуемое слово. */
return 1U; /* Подтверждает отсутствие изменений за пределами двух слотов и журнала. */
} /* Завершает аппаратную модель реального клиента SETGUI. */
+30 -10
View File
@@ -35,27 +35,47 @@ model = (root / 'tests/can_telemetry/model.c').read_text(encoding='utf-8').split
model = model.replace('/* TIMEOUT_ISR */', block(ecan, match.start())) # Вставляет реальное тело обработчика без отдельной копии его алгоритма.
model += '\n' + defines + '\nstatic int Kurrent, pow_addr, Owen; /* Повторяет настройки каналов и OWEN, используемые настоящими масками версии 167. */\n' + mask_function # Берёт реальные номера плат, потоков и состав масок из текущей прошивки.
model += r'''
int main(void) { /* Измеряет свежесть R3 при реальной карте пульта и разных настройках потоков EEPROM. */
const unsigned periods[][2] = {{2,101},{10,101},{12,50},{2,0},{1,101},{1,1}}; /* Проверяет прежние настройки, включая отключённый медленный поток. */
unsigned scenario, tick, cursor, received, last, gap, worst; /* Наблюдает переданные кадры и разрыв между обновлениями R3. */
int main(void) { /* Проверяет обратку ламп R2 и светодиодов R3 при одновременных изменениях FAST/SLOW и разных сохранённых настройках. */
const unsigned periods[][2] = {{2,101},{10,101},{12,50},{2,0},{1,101},{1,1},{10,13},{10,10}}; /* Добавляет FAST=10/SLOW=13 со снимка пользователя и равные старые делители, у которых совпадал каждый такт. */
unsigned scenario, tick, cursor, received[2], last[2], gap, worst[2], channel, found; /* Канал 0 учитывает обратку ламп R2, канал 1 — светодиодов R3; found отмечает доставку новых значений после задержанного ACK. */
Uint32 held_hi, held_lo; /* Сохраняет восемь октетов занятого mailbox для проверки неизменности кадра между тактами обоих потоков. */
for (scenario = 0; scenario < sizeof(periods)/sizeof(periods[0]); ++scenario) { /* Проверяет независимые запуски платы. */
prepare(8U, dsk_EPLT); Init_packMask(); /* Строит настоящую карту задатчика поверх сброшенной модели CAN. */
CHECK((Maska[m_FAST][0] & 15U) == 15U && !(Maska[m_SLOW][0] & 15U)); /* R0–R3 остаются в быстром потоке при отключённом медленном. */
CHECK(Maska[m_FAST][1] == 1U && Maska[m_SLOW][6] == 0x1FFU && Maska[m_SLOW][7] == 0xE000U); /* Кнопки и параметры сохраняют состав исходной карты. */
Cancount[0] = periods[scenario][0]; Cancount[1] = periods[scenario][1]; /* Ненулевое значение теперь включает обновления по изменению и таймеру. */
cursor = received = last = worst = 0U; /* Учитывает также начальное ожидание первого подтверждения. */
cursor = received[0] = received[1] = last[0] = last[1] = worst[0] = worst[1] = 0U; /* Считает начальную задержку и последующие интервалы обоих пакетов независимо. */
for (tick = 1U; tick <= 5000U; ++tick) { /* Пять секунд включают heartbeat и обязательные повторы неизменных данных. */
CpuTimer1.InterruptCount = tick; modbus[3] = tick; CHECK(pump() == 0); /* Меняет R3 каждую миллисекунду и выдаёт готовую очередь через настоящие CAN_send и ACK. */
CpuTimer1.InterruptCount = tick; modbus[2] = tick ^ 0xD05BU; modbus[3] = tick ^ 0xFF7FU; modbus[99] = tick; CHECK(pump() == 0); /* Разные исходные маски R2/R3 взяты со снимка; изменение яркости R99 одновременно нагружает SLOW, пока настоящий сервис формирует обратку FAST. */
for (; cursor < count; ++cursor) { /* Анализирует только новые кадры mailbox. */
if (address_at(cursor) != 3U) continue; /* R3 начинает второй трёхсловный фрагмент действительной маски. */
CHECK((frames_hi[cursor] & 0xFFFFU) == tick); /* Требует свежее значение вместо старого снимка. */
gap = tick - last; if (gap > worst) worst = gap; last = tick; ++received; /* Измеряет худший интервал получения актуального R3. */
if (address_at(cursor) != 0U && address_at(cursor) != 3U) continue; /* Выбирает пакет R0–R2 с лампами либо R3–R5 со светодиодами, исключая яркость и heartbeat. */
channel = address_at(cursor) == 3U; /* Различает два настоящих пакета по начальному адресу в CAN-заголовке. */
CHECK((channel ? frames_hi[cursor] & 0xFFFFU : frames_lo[cursor] & 0xFFFFU) == (tick ^ (channel ? 0xFF7FU : 0xD05BU))); /* Проверяет значение нужного слова: R2 находится в MDL, а R3 — в MDH отдельного кадра; совпавший SLOW не должен подменить их. */
gap = tick - last[channel]; if (gap > worst[channel]) worst[channel] = gap; last[channel] = tick; ++received[channel]; /* Измеряет задержки ламп и светодиодов независимо от порядка чередования потоков. */
} /* Завершает анализ кадров текущего момента. */
} /* Приоритет heartbeat обрабатывается общей моделью передатчика. */
CHECK(received > 0U && worst <= CANPOWSE && tick - 1U - last <= CANPOWSE); /* При немедленном ACK интервал ограничен шагом сканирования 20 мс независимо от slow. */
for (channel = 0U; channel < 2U; ++channel) CHECK(received[channel] > 0U && worst[channel] <= CANPOWSE && tick - 1U - last[channel] <= CANPOWSE); /* При немедленном ACK оба вида обратки сохраняют границу 20 мс, даже когда меняется медленный поток. */
CHECK(count_address(CAN_HEARTBEAT_ADDR) >= 4U); /* Обновление R3 не должно вытеснять секундный heartbeat. */
printf("PASS VPU fast=%u slow=%u: R3 max=%u ms, updates=%u\n", periods[scenario][0], periods[scenario][1], worst, received); /* Выводит измеренный интервал и число свежих кадров. */
CHECK(!periods[scenario][1] || count_address(99U) > 200U); /* Включённый SLOW действительно передаёт меняющуюся яркость, поэтому тест не сводится к работе одной быстрой маски. */
printf("PASS VPU fast=%u slow=%u: R2 max=%u ms, R3 max=%u ms, updates=%u/%u\n", periods[scenario][0], periods[scenario][1], worst[0], worst[1], received[0], received[1]); /* Показывает измеренные интервалы обратки обоих типов индикации при одновременной нагрузке потоков. */
} /* Завершает матрицу настроек EEPROM. */
prepare(8U, dsk_EPLT); Init_packMask(); Cancount[0] = 10; Cancount[1] = 13; modbus[2] = 0xD05B; modbus[3] = 0xFF7F; CHECK(pump() == 0); /* Начальный снимок использует настройки и маски ламп/светодиодов со снимков пользователя, без записи EEPROM. */
CpuTimer1.InterruptCount = 1299U; CHECK(pump() == 0 && count_address(0U) == 1U && count_address(3U) == 1U && count_address(99U) == 1U); /* Неизменные FAST/SLOW не повторяются до заводского срока 1300 мс; секундный heartbeat учитывается отдельно. */
CpuTimer1.InterruptCount = 1300U; CHECK(pump() == 0 && count_address(0U) == 2U && count_address(3U) == 2U && count_address(99U) == 2U); /* Совпавшие сроки повтора обоих потоков обслуживаются последовательно и не вытесняют обратку R2/R3. */
CpuTimer1.InterruptCount = 1320U; modbus[2] = 0x1111; modbus[3] = 0x2222; modbus[99] = 6; CAN_telemetry_service(); CHECK(ECanaRegs.CANTRS.all & 1UL); /* Запускает изменённый кадр на границе сканирования, затем удерживает аппаратный ACK дольше одного прохода main. */
held_hi = ECanaMboxes.MBOX0.MDH.all; held_lo = ECanaMboxes.MBOX0.MDL.all; cursor = count; /* Наблюдает реальные аппаратные данные и отделяет последующие кадры от уже проверенных повторов. */
for (tick = 1321U; tick <= 1340U; ++tick) { /* Двадцать миллисекунд включают следующую границу сканирования и остаются меньше защитного тайм-аута ACK 100 мс. */
CpuTimer1.InterruptCount = tick; modbus[2] = tick ^ 0xD05BU; modbus[3] = tick ^ 0xFF7FU; modbus[99] = tick; CAN_telemetry_service(); /* Пока передатчик занят, оба потока получают более свежие данные в каждом такте. */
CHECK(ECanaMboxes.MBOX0.MDH.all == held_hi && ECanaMboxes.MBOX0.MDL.all == held_lo && (ECanaRegs.CANTRS.all & 1UL)); /* Ни FAST, ни SLOW не перезаписывает передаваемый кадр и не принимает его за подтверждённый. */
} /* Завершает задержку аппаратного подтверждения без блокирующего ожидания в production-сервисе. */
hardware_ack(); CHECK(pump() == 0); found = 0U; /* Освобождение mailbox разрешает передать последние состояния вместо накопления очереди устаревших снимков. */
for (; cursor < count; ++cursor) { /* Проверяет только кадры, поставленные после задержанного ACK. */
if (address_at(cursor) == 0U) { CHECK((frames_lo[cursor] & 0xFFFFU) == (1340U ^ 0xD05BU)); found |= 1U; } /* Обратка ламп берёт последнее значение R2 из третьего слова кадра R0. */
if (address_at(cursor) == 3U) { CHECK((frames_hi[cursor] & 0xFFFFU) == (1340U ^ 0xFF7FU)); found |= 2U; } /* Обратка светодиодов берёт последнее значение R3 из первого слова отдельного кадра. */
if (address_at(cursor) == 99U) { CHECK((frames_hi[cursor] & 0xFFFFU) == 1340U); found |= 4U; } /* Медленный поток тоже получает свободный слот и передаёт актуальную яркость. */
} /* Завершает наблюдение очереди после освобождения передатчика. */
CHECK(found == 7U && Cancount[0] == 10 && Cancount[1] == 13); /* Все три ожидаемых пакета доставлены, а сохранённые настройки FAST/SLOW остались прежними. */
puts("PASS VPU: unchanged refresh 1300 ms; simultaneous FAST/SLOW; busy mailbox preserved; latest R2/R3 after delayed ACK"); /* Перечисляет проверенные свойства CAN-обратки без утверждения об испытании физической платы. */
return 0; /* Подтверждает программную модель без заявления об аппаратном испытании. */
} /* Завершает проверку обратной связи R3. */
''' # Использует production-маски и production-сервис вместо удалённого блока if(CanGO).
+12
View File
@@ -4,6 +4,10 @@
#include <assert.h>
/* Подключает "../../Source/Internal/spise2p.c": драйвер SPI EEPROM, адресация, страницы и автомат завершения операций. */
#include "../../Source/Internal/spise2p.c"
#if EEPROM_M95M02 /* Модель должна явно различать старый SPI-ROM запуск и защищённый A/B-слот. */
static unsigned int test_running_slot = 255U; /* FF воспроизводит отсутствие handoff в прежних проверках аппаратного SPI. */
unsigned int F28335Boot_RunningSlot(void) { return test_running_slot; } /* Подменяет только источник handoff, сохраняя production-защиту записи EEPROM. */
#endif /* Малый профиль не использует отдельный CAN-загрузчик. */
/* Продолжает список аргументов, полей или выражение static unsigned trace[300], widths[300], used;; порядок элементов сохраняется. */
static unsigned trace[300], widths[300], used;
/* Начинает функцию transfer; назначение модуля — проверка eeprom_profiles на модели ПК. */
@@ -77,6 +81,14 @@ int main(void)
#if EEPROM_M95M02
/* Вызывает assert с аргументами (BALSAM167_EEPROM_FIRMWARE_BYTES==261884UL) в текущей последовательности операций. */
assert(BALSAM167_EEPROM_FIRMWARE_BYTES==261884UL);
test_running_slot = 0U; /* Включает реальную защиту A/B-приложения при сохранении прежнего SPI-драйвера. */
CpuTimer2.InterruptCount = 123U; /* Отказ обязан произойти до запуска Timer2 и постановки операции SPI. */
Seeprom_write(0UL, 0, 2UL); /* Старый RS-путь не имеет права затронуть журнал A/B по адресу ноль. */
Seeprom_write(0x10000UL, 0, 2UL); /* CPU word-адрес соответствует началу B-слота в октетах EEPROM. */
Seeprom_write(BALSAM167_EEPROM_PARAMS_END_WORD - 1UL, 0, 4UL); /* Проверяет пересечение верхней границы параметров даже при допустимом начале записи. */
Seeprom_write(BALSAM167_EEPROM_PARAMS_END_WORD, 0, 2UL); /* Не разрешает запись в последнее зарезервированное слово. */
assert(CpuTimer2.InterruptCount == 123U && spiSe2pFree(&se2p)); /* Ни один отказ не запускает старый асинхронный SPI или таймер. */
test_running_slot = 255U; /* Последующие прежние проверки снова моделируют обычный SPI-ROM запуск. */
/* Вызывает transfer с аргументами (0xfffe,0); transfer(0x10000,0) в текущей последовательности операций. */
transfer(0xfffe,0); transfer(0x10000,0);
/* Вызывает transfer с аргументами (0x20000,1); transfer(0x3fffc,0); transfer(0x3fffc,1) в текущей последовательности операций. */
+8
View File
@@ -0,0 +1,8 @@
#ifndef EEPROM_PROFILE_CAN_BOOT_TEST_H /* Изолирует SPI-модель от аппаратных заголовков CAN, версии сборки и регистров F28335. */
#define EEPROM_PROFILE_CAN_BOOT_TEST_H /* Не допускает повторного объявления интерфейса тестового handoff. */
#if EEPROM_M95M02 /* Только физический профиль M95M02 поддерживает handoff от отдельного A/B-загрузчика. */
unsigned int F28335Boot_RunningSlot(void); /* Реализация в spi_test.c выбирает обычный запуск или A/B-слот, сохраняя проверку production-защиты области EEPROM. */
#else /* AT25256B повторяет самостоятельный запуск без загрузчика CAN A/B. */
#define F28335Boot_RunningSlot() 255U /* Значение FF совпадает с production-интерфейсом малого EEPROM-профиля и означает отсутствие handoff. */
#endif /* Оба аппаратных варианта используют тот же production-драйвер SPI. */
#endif /* Остальной интерфейс CAN не используется проверяемым драйвером SPI EEPROM. */
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+8 -1
View File
@@ -57,6 +57,13 @@ int main(void) /* Проверяет режимы RUN/STOP/RESET/FAULT чере
assert(!Commands && !irq_mask); /* Не переносит специальную семантику УМП на несвязанные типы плат. */
setup(0x2C0U, 0, 0x1234U); irq_mask = 1; reset_parameter_commands(); /* Проверяет вызов helper из уже защищённого блока применения параметров. */
assert(Commands == 0xC0U && irq_mask == 1); /* Вложенный helper сохраняет внешнюю маску IRQ и не выдаёт EINT без разрешения вызывающего кода. */
puts("PASS: production parameter loading/defaults preserve live START/RESET and reject EEPROM commands"); /* Сообщает о прохождении рабочего кода, а не копии алгоритма в модели. */
setup(0, 0, 0x1234U); Desk = dsk_EPLT; READY = 0; image[0] = 3950; image[1] = (unsigned int)-2310; image[2] = 0x3FU; image[3] = 0xFFFFU; image[0x62] = 6; /* Воспроизводит сохранённые 395.0 и -231, маски ламп и допустимую яркость при холодном старте задатчика. */
Load_params(); /* Применяет настоящий EEPROM-загрузчик до первого рабочего обмена с задатчиком. */
assert(!modbus[0] && !modbus[1] && !modbus[2] && !modbus[3] && Bright[0] == 6 && !irq_mask); /* Показания и лампы остаются нулевыми, но сохраняемая яркость действительно загружается из EEPROM. */
modbus[0] = 1234; modbus[1] = -567; modbus[2] = 1; modbus[3] = 2; READY = 1; Load_params(); /* Имитирует повторную загрузку настроек после получения новых показаний и масок по связи. */
assert(modbus[0] == 1234 && modbus[1] == -567 && modbus[2] == 1 && modbus[3] == 2 && Bright[0] == 6); /* Сохранённый снимок не перезаписывает актуальную индикацию работающего задатчика. */
setup(0, 0, 0x1234U); image[0] = 3950; image[1] = 2310; Load_params(); /* Проверяет прежнюю загрузку R0/R1 у платы нагрузки, где карта имеет другой смысл. */
assert(modbus[0] == 3950 && modbus[1] == 2310); /* Ограничивает исключение четырёх регистров только типом dsk_EPLT. */
puts("PASS: production parameters preserve live START/RESET and reject stored setpoint display values"); /* Подтверждает защиту команд нагрузки и текущей индикации задатчика на настоящем Load_params. */
return 0; /* Возвращает успех только после всех сценариев сохранности команд и состояния IRQ. */
} /* Завершает регрессию без обращения к аппаратной плате. */
+20 -14
View File
@@ -3,6 +3,7 @@
"""Compile the production DAC.c against GPIO/IRQ mocks; no hardware writes."""
# Подключает модуль os для этой проверки или подготовки сборки.
import os
import argparse # Позволяет независимо запускать регрессию EEPROM без аппаратных заглушек полного автомата нагрузки.
# Разбирает только границы настоящих функций message.c, сохраняя их неизменённое тело в регрессии параметров.
import re
# Импортирует необходимые имена: from pathlib import Path.
@@ -14,6 +15,10 @@ import subprocess
# Подключает модуль tempfile для этой проверки или подготовки сборки.
import tempfile
parser = argparse.ArgumentParser(description=__doc__) # Описывает существующую полную проверку и отдельный независимый сценарий применения параметров.
parser.add_argument('--parameters-only', action='store_true', help='Проверить только Load/Default параметров и стартовую индикацию задатчика') # Ограничивает запуск функциями message.c, не подключая аппаратный DAC.c.
arguments = parser.parse_args() # Проверяет режим до компиляции временных моделей.
# Задаёт root по выражению справа; значение используется последующими операциями.
root = Path(__file__).resolve().parents[2]
# Задаёт compiler по выражению справа; значение используется последующими операциями.
@@ -22,20 +27,21 @@ compiler = os.environ.get('CC') or shutil.which('gcc') or 'C:/msys64/mingw64/bin
os.environ['PATH'] = str(Path(compiler).resolve().parent) + os.pathsep + os.environ['PATH']
# Открывает управляемый ресурс tempfile.TemporaryDirectory(prefix='load-control-') as tmp с автоматическим освобождением.
with tempfile.TemporaryDirectory(prefix='load-control-') as tmp:
# Задаёт exe по выражению справа; значение используется последующими операциями.
exe = Path(tmp) / 'test.exe'
flash = (root / 'Source/Internal/flash_rs.c').read_text(encoding='utf-8') # Проверяет настоящий запрет активной нагрузки перед переходом к Flash API.
guard = re.search(r'^static unsigned int flash_load_guard\([^\n]*\n\{[^\n]*\n[^\n]*\n\}', flash, re.M) # Извлекает короткий production-helper без переписывания его условия в тестовой модели.
assert guard, 'Production Flash load guard missing' # Переименование или удаление защиты не должно незаметно отключить тест перед erase.
(Path(tmp) / 'production_flash_guard.inc').write_text(guard.group() + '\n', encoding='utf-8') # Включает реальный helper в тот же C-модуль, который исполняет production DAC.c.
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
subprocess.run([compiler, '-Wall', '-Wextra', '-std=c99',
# Продолжает текущий вызов, список или выражение: '-Itests/load_control/stubs', '-ISource/Internal/Include',; порядок аргументов сохраняется.
'-Itests/load_control/stubs', '-ISource/Internal/Include', '-I' + tmp, # Добавляет только каталог извлечённого рабочего Flash-helper этой проверки.
# Задаёт 'tests/load_control/load_control_test.c', '-o', str(exe)], cwd по выражению справа; значение используется последующими операциями.
'tests/load_control/load_control_test.c', '-o', str(exe)], cwd=root, check=True)
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
subprocess.run([str(exe)], check=True, timeout=10)
if not arguments.parameters_only: # Полный автомат проверяется по умолчанию; его аппаратные зависимости не блокируют независимый запуск EEPROM-регрессии.
# Задаёт exe по выражению справа; значение используется последующими операциями.
exe = Path(tmp) / 'test.exe'
flash = (root / 'Source/Internal/flash_rs.c').read_text(encoding='utf-8') # Проверяет настоящий запрет активной нагрузки перед переходом к Flash API.
guard = re.search(r'^static unsigned int flash_load_guard\([^\n]*\n\{[^\n]*\n[^\n]*\n\}', flash, re.M) # Извлекает короткий production-helper без переписывания его условия в тестовой модели.
assert guard, 'Production Flash load guard missing' # Переименование или удаление защиты не должно незаметно отключить тест перед erase.
(Path(tmp) / 'production_flash_guard.inc').write_text(guard.group() + '\n', encoding='utf-8') # Включает реальный helper в тот же C-модуль, который исполняет production DAC.c.
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
subprocess.run([compiler, '-Wall', '-Wextra', '-std=c99',
# Продолжает текущий вызов, список или выражение: '-Itests/load_control/stubs', '-ISource/Internal/Include',; порядок аргументов сохраняется.
'-Itests/load_control/stubs', '-ISource/Internal/Include', '-I' + tmp, # Добавляет только каталог извлечённого рабочего Flash-helper этой проверки.
# Задаёт 'tests/load_control/load_control_test.c', '-o', str(exe)], cwd по выражению справа; значение используется последующими операциями.
'tests/load_control/load_control_test.c', '-o', str(exe)], cwd=root, check=True)
# Запускает внешний компилятор, генератор или тест; ненулевой результат проверяется параметрами вызова.
subprocess.run([str(exe)], check=True, timeout=10)
# Читает рабочие загрузку и заводской сброс параметров для отдельной проверки живых START/RESET.
message = (root / 'Source/Internal/message.c').read_text(encoding='utf-8')
# Маскирует комментарии пробелами той же длины, чтобы фигурные скобки пояснений не влияли на поиск границ функций.
+4
View File
@@ -0,0 +1,4 @@
#ifndef LOAD_CONTROL_CAN_BOOT_TEST_H /* Модель автомата нагрузки проверяется без аппаратного порта CAN и сгенерированного паспорта платы. */
#define LOAD_CONTROL_CAN_BOOT_TEST_H /* Сохраняет единый выбор режима при повторном подключении production DAC.c. */
#define CAN167_AB_ENABLED 0 /* Проверяет самостоятельный автомат ЦАП; включённый A/B и ожидание STOP отдельно покрывает tests/can_boot/run_test.py. */
#endif /* Не подменяет GPIO, IRQ и действующие проверки безопасности самой нагрузки. */
+65
View File
@@ -0,0 +1,65 @@
#include <stdint.h> /* Использует точные host-типы для 16-битных слов и 32-битных адресов C28x. */
#include <setjmp.h> /* Перехватывает автономное завершение прошивки, не выполняя бесконечный аппаратный watchdog-цикл. */
#include <string.h> /* Инициализирует исключительно тестовые массивы модели внутренней Flash. */
#include "f28335_flash_app.c" /* Компилирует настоящий валидатор запуска постоянного загрузчика, а не его копию на Python. */
typedef uint16_t Uint16; /* Слово TI C28x содержит 16 бит независимо от разрядности host-компилятора. */
typedef uint32_t Uint32; /* Адрес CPU и длина транспортного образа имеют 32 бита. */
typedef int FLASH_ST; /* Модель не использует внутренние диагностические поля официального TI API. */
typedef struct { unsigned int unused; } RS_DATA; /* Автономный writer передаёт RS-контекст только в подменённый итоговый ответ. */
static Uint16 program_buffer[128], packed[0xFC00], memory[0x40000]; /* Буферы соответствуют production writer, staging ZONE7A и всей внутренней Flash A–H. */
static FLASH_ST api_status; /* Writer получает отдельную структуру результата, как при вызове настоящего API. */
static struct { Uint16 WDCR; } SysCtrlRegs; /* Завершение перехватывается до записи watchdog; поле необходимо для компиляции неизменённого writer. */
static jmp_buf completed; /* Контекст возврата принадлежит одной синхронной проверке модели. */
static Uint16 result, erase_mask; /* Хранит подтверждённый статус и фактическую маску Flash_Erase производственного алгоритма. */
static unsigned int programs, fault_at, last_count; /* Позволяет оборвать каждую стадию записи, включая публикацию FAB1. */
static Uint32 last_address; /* Доказывает, что описание приложения программируется последним. */
#define EALLOW ((void)0) /* Host не имеет защищённых аппаратных регистров; алгоритм записи Flash остаётся неизменным. */
#define EDIS ((void)0) /* Снятие аппаратного разрешения моделируется без побочных эффектов для ПК. */
static Uint16 Flash_Erase(Uint16 mask, FLASH_ST *status); /* Подменяется только физическая операция стирания секторов. */
static Uint16 Flash_Program(Uint16 *target, Uint16 *data, Uint32 count, FLASH_ST *status); /* Сохраняет адреса и данные реального writer для модели памяти. */
static Uint16 Flash_Verify(Uint16 *target, Uint16 *data, Uint32 count, FLASH_ST *status); /* Проверяет уже записанные слова модели, не возвращая безусловный успех. */
static void reply_status(RS_DATA *rs, Uint16 status); /* Итоговый RS-ответ завершает модель вместо перехода в аппаратный reset. */
void ServiceDog(void) {} /* Host не имеет watchdog; производственная предварительная CRC сохраняет своё место обслуживания таймера. */
#include "production.inc" /* Тестовый runner извлекает byte/word/CRC, validate_image и program_image непосредственно из production flash_rs.c. */
static Uint16 Flash_Erase(Uint16 mask, FLASH_ST *status) /* Реализует маску TI: A — бит 0, H — бит 7. */
{ /* Модель позволяет обнаружить стирание boot даже при отсутствии последующих записей в сектор A. */
Uint32 index; (void)status; erase_mask = mask; /* Сохраняет неизменённый аргумент настоящего Flash_Erase. */
for (index = 0; index < 0x40000UL; ++index) if (mask & (1U << ((0x3FFFFUL - index) / 0x8000UL))) memory[index] = 0xFFFFU; /* Каждый сектор содержит 0x8000 адресуемых слов. */
return 0U; /* Само стирание модели успешно; ошибки программирования вводятся независимо. */
} /* Проверка сохранности boot выполняется даже после смоделированного обрыва. */
static Uint16 Flash_Program(Uint16 *target, Uint16 *data, Uint32 count, FLASH_ST *status) /* Моделирует частичный результат при потере питания во время выбранной записи. */
{ /* Использует числовой адрес указателя C28x, не разыменовывая его в памяти ПК. */
Uint32 address = (Uint32)(uintptr_t)target, i, written = count; (void)status; /* Числовой LOAD-адрес сохраняется без преобразования в байтовый адрес. */
++programs; last_address = address; last_count = (unsigned int)count; /* Фиксирует порядок реальных вызовов writer. */
if (address < F28335_FLASH_APP_START || address + count > F28335_FLASH_APP_STOP) return 77U; /* Даже ошибочный writer не выходит за тестовый массив; отдельная проверка всё равно обнаружит запрос сектора A. */
if (fault_at == programs) written = count / 2UL; /* Обрыв оставляет половину текущей порции, включая половину FAB1 на последней стадии. */
for (i = 0; i < written; ++i) memory[address - F28335_FLASH_APP_START + i] &= data[i]; /* Программирование Flash может только сбрасывать биты; скрытое перезаписывание без erase не моделируется как успех. */
return fault_at == programs ? 22U : 0U; /* Код 22 отличает введённый обрыв от успешного выполнения. */
} /* Последующая Flash_Verify вызывается только при нулевом статусе, как на плате. */
static Uint16 Flash_Verify(Uint16 *target, Uint16 *data, Uint32 count, FLASH_ST *status) /* Сверяет фактическую память модели с исходной staging RAM. */
{ /* Неверно выбранный адрес либо данные не должны получить подтверждение. */
Uint32 address = (Uint32)(uintptr_t)target, i; (void)status; /* Адреса остаются в единицах слов C28x. */
for (i = 0; i < count; ++i) if (memory[address - F28335_FLASH_APP_START + i] != data[i]) return 40U; /* Несовпадение возвращает ненулевой статус аппаратной проверки. */
return 0U; /* Подтверждает только побайтно совпавшие слова после записи. */
} /* Не подменяет проверку полной CRC описания FAB1. */
static void reply_status(RS_DATA *rs, Uint16 status) { (void)rs; result = status; longjmp(completed, 1); } /* Завершает испытание после реального пути записи и проверки, до бесконечного watchdog-цикла. */
static uint16_t flash_word(void *user, uint32_t address) { (void)user; return memory[address - F28335_FLASH_APP_START]; } /* Читает модель Flash для настоящей boot-проверки CRC. */
static void pack(const Uint16 *octets, Uint32 length) /* Повторяет существующую упаковку RS_RX_Handler в staging RAM. */
{ /* Один октет ctypes передаётся отдельным host-словом для независимости от char C28x. */
Uint32 i; memset(packed, 0, sizeof(packed)); /* Очищает только тестовый staging-буфер текущего запуска. */
for (i = 0; i < length; ++i) packed[i / 2UL] |= octets[i] << ((i & 1UL) ? 0U : 8U); /* Чётная октета помещается в старший байт слова, как production RS LOAD. */
} /* Содержание исходного SCI8 не меняется при подготовке C-вызова. */
__declspec(dllexport) Uint16 check_image(const Uint16 *octets, Uint32 length) { pack(octets, length); return validate_image(packed, length); } /* Экспортирует настоящий MCU-валидатор для проверок Python. */
__declspec(dllexport) Uint16 check_program(const Uint16 *octets, Uint32 length, unsigned int fault) /* Выполняет настоящий writer на изолированной модели Flash. */
{ /* Обязательная входная проверка предшествует любому обращению к модели erase. */
Uint32 i, entry; Uint16 checked; pack(octets, length); /* Подготавливает staging в том же представлении, что устройство. */
checked = validate_image(packed, length); if (checked) return checked; /* Повреждённый FAB1 или слово сектора A не допускаются к записи. */
for (i = 0; i < 0x40000UL; ++i) memory[i] = i >= 0x38000UL ? 0xA35AU : 0U; /* Старый boot заполняется контрольным рисунком; область приложения требует настоящего erase. */
result = erase_mask = 0U; programs = 0U; fault_at = fault; /* Исключает влияние предыдущего испытания и задаёт точку обрыва. */
if (!setjmp(completed)) program_image(0, packed, length); /* Вызов возвращается только через перехваченный итоговый ответ. */
if (erase_mask != 0xFEU) return 0x7001U; /* Сектор A должен быть исключён из реального аргумента Flash_Erase. */
for (i = 0x38000UL; i < 0x40000UL; ++i) if (memory[i] != 0xA35AU) return 0x7002U; /* Все 0x8000 слов постоянного boot сохраняются после успеха и каждого обрыва. */
if (!result && (last_address != F28335_FLASH_APP_START || last_count != F28335_FLASH_APP_HEADER_WORDS || !f28335_flash_app_validate(flash_word, 0, &entry))) return 0x7003U; /* Успех требует последней публикации FAB1 и действительного запускаемого образа. */
if (result && f28335_flash_app_validate(flash_word, 0, &entry)) return 0x7004U; /* Частично записанная программа не должна проходить boot-проверку и вытеснять резерв EEPROM. */
return result; /* Сохраняет исходный код TI API при одновременно доказанной сохранности boot. */
} /* Модель никогда не открывает JTAG, COM или CAN-адаптер пользователя. */
+55
View File
@@ -0,0 +1,55 @@
import ctypes # Вызывает настоящие MCU-валидатор и writer на изолированной модели Flash, не используя оборудование.
import importlib.util # Подключает контракт FAB1 из выбранной зависимости templates без изменения окружения GUI.
import os # Передаёт процессу GCC путь к его runtime DLL в Windows.
from pathlib import Path # Все файлы испытания находятся в собственном временном каталоге.
import struct # Формирует SCI8 с известными адресами и проверяемыми повреждениями.
import subprocess # Компилирует production-функции host-компилятором без обращения к JTAG.
import tempfile # Автоматически очищает только временные исходники и DLL текущего испытания.
ROOT = Path(__file__).resolve().parents[2] # Корень содержит production flash_rs.c и исходники host-модели.
TEMPLATES = ROOT.parent / 'newProject/SETGUI/third_party/templates' # Использует ту же реализацию FAB1, что компилируемая прошивка.
PORT = TEMPLATES / 'c/protocan-boot/ports/tms320f28335' # Включает общий C-валидатор запуска постоянного загрузчика.
GCC = Path('C:/msys64/mingw64/bin/gcc.exe') # Установленный GCC предоставляет независимый от TI host-компилятор.
os.environ['PATH'] = str(GCC.parent) + os.pathsep + os.environ['PATH'] # Добавляет runtime только в среду этого тестового процесса.
spec = importlib.util.spec_from_file_location('flash_contract', TEMPLATES / 'python/protocan/f28335_flash.py') # Загружает общий Python-подписыватель описания.
contract = importlib.util.module_from_spec(spec) # Не подменяет установленный пакет protocan у пользователя.
spec.loader.exec_module(contract) # Ошибка контракта останавливает проверку вместо использования старого образа.
def block(address, words): # Формирует стандартный адресный блок TI SCI8 в октетах.
return struct.pack('<HHH', len(words), address >> 16, address & 65535) + struct.pack('<' + 'H' * len(words), *words) # Размер и адрес выражены словами C28x; каждое слово little endian.
entry = contract.APP_DATA # Точка входа расположена после фиксированного описания приложения в секторе H.
loaded = {entry: 0x1234, entry + 1: 0x5678, entry + 12: 0xAABB, entry + 13: 0xCCDD} # Разрыв между секциями проверяет включение стёртых слов 0xFFFF в CRC.
signed = contract.descriptor(entry, loaded) # Python формирует тот же FAB1, который C-загрузчик проверяет перед запуском.
header = b'\xaa\x08' + bytes(16) + struct.pack('<HH', entry >> 16, entry & 65535) # Сохраняет штатный SCI8 header и адрес безопасного startup.
valid = header + block(contract.APP_START, struct.unpack('<16H', signed)) + block(entry, [0x1234, 0x5678]) + block(entry + 12, [0xAABB, 0xCCDD]) + bytes(2) # Три блока отдельно проверяют отложенную публикацию описания после данных.
source = (ROOT / 'Source/Internal/flash_rs.c').read_text(encoding='utf-8') # Читает текущий production writer со всеми защитами адресов.
helpers = source[source.index('#pragma CODE_SECTION(byte_at'):source.index('#pragma CODE_SECTION(reply_status')] # Декодирование RS и callback виртуального Flash остаются производственными.
validator = source[source.index('#pragma CODE_SECTION(validate_image'):source.index('#pragma CODE_SECTION(program_image')] # Извлекает настоящую проверку до первого erase.
writer = source[source.index('#pragma CODE_SECTION(program_image'):source.index('void FlashRs_Command')] # Извлекает настоящий порядок erase, program, verify и последней публикации FAB1.
with tempfile.TemporaryDirectory(prefix='protected-f28335-') as directory: # Никакие промежуточные файлы не заменяют рабочую прошивку.
directory = Path(directory) # Разрешает все пути относительно одного изолированного запуска.
(directory / 'production.inc').write_text(helpers + validator + writer, encoding='utf-8') # Русские комментарии production-функций сохраняются в UTF-8.
library = directory / 'writer.dll' # Динамическая библиотека содержит только модель аппаратуры и настоящий MCU-код.
subprocess.run([str(GCC), '-shared', '-std=c99', '-Wno-unknown-pragmas', '-Wno-int-to-pointer-cast', '-I' + str(PORT), '-I' + str(directory), str(ROOT / 'tests/protected_boot/rs_program_model.c'), '-o', str(library)], check=True) # Не вызывает TI, программатор или аппаратные драйверы.
native = ctypes.CDLL(str(library)) # Загружает только созданную библиотеку этой проверки.
native.check_image.argtypes = [ctypes.POINTER(ctypes.c_uint16), ctypes.c_uint32] # Каждая физическая октета передаётся отдельным словом модели.
native.check_image.restype = ctypes.c_uint16 # Сохраняет коды предварительной проверки MCU.
native.check_program.argtypes = [ctypes.POINTER(ctypes.c_uint16), ctypes.c_uint32, ctypes.c_uint] # Последний параметр задаёт прерываемую стадию записи.
native.check_program.restype = ctypes.c_uint16 # Ненулевой результат API не превращается в успех модели.
for payload, expected in [(valid, 0), (valid[:-2], 0x1002), (valid + bytes(2), 0x1002), (valid[:-4] + b'\0\0' + bytes(2), 0x1002)]: # Проверяет полный файл, обрезание, хвост и нарушение CRC данных.
octets = (ctypes.c_uint16 * len(payload))(*payload) # Исключает зависимость от host-char при вызове производственного C-кода.
assert native.check_image(octets, len(payload)) == expected # Python-подпись и MCU-проверка должны согласовываться на реальном контракте.
for address in (0x2FFFFF, 0x338000, 0x33FFF6, 0x33FFF8, 0x340000, 0x380400): # Проверяет сектор A, аппаратный boot, CSM, OTP и обе внешние границы.
payload = valid[:-2] + block(address, [1, 2]) + bytes(2) # Добавляет запрещённую секцию к иначе полностью правильному приложению.
octets = (ctypes.c_uint16 * len(payload))(*payload) # Передаёт исходные октеты в неизменённый MCU-валидатор.
assert native.check_image(octets, len(payload)) == 0x1002 # Ни один запрещённый адрес не допускает erase.
octets = (ctypes.c_uint16 * len(valid))(*valid) # Одни и те же правильные данные проходят все стадии испытания writer.
for fault, expected in ((0, 0), (1, 22), (2, 22), (3, 22)): # Обрыв моделируется на каждой порции двух секций данных и на публикации FAB1.
assert native.check_program(octets, len(valid), fault) == expected # Boot сохраняется побитно, а частичная Flash не проходит проверку запуска.
unload = ctypes.WinDLL('kernel32').FreeLibrary # Освобождает DLL перед удалением её временного каталога в Windows.
unload.argtypes, unload.restype = [ctypes.c_void_p], ctypes.c_int # Передаёт полный размер дескриптора библиотеки.
assert unload(native._handle) # Закрывает только библиотеку текущего испытания.
print('PASS: production FAB1 CRC, protected sector A, RS erase/program/verify and power-loss stages') # Подтверждает проверки модели, не выдавая их за физическое испытание платы.

Some files were not shown because too many files have changed in this diff Show More