Files
templates/c/f28335-rs-boot
Andrey f9d369d032 feat(f28335-rs-boot): добавьте постоянный загрузчик по RS
Принимайте INITLOAD, LOAD и TFLASH общим автоматом с повторной
проверкой SCI8/FAB1 до стирания и сохранением сектора A.

Сохраняйте параметры прошивки в паспорте prebuild, выпускайте
независимые образы загрузчика и приложения с manifest и SHA-256.

Проверено: шесть испытаний модели, включая обрывы записи и восстановление.
2026-11-13 15:07:55 +03:00
..

Загрузчик F28335 по RS для periph_28335

Постоянный загрузчик принимает INITLOAD (58), LOAD (51) и TFLASH (55), совместимые с Flash RS в терминале periph_28335 SETGUI. Ядро не зависит от UART, GPIO, ОС и Qt. Оно использует существующий валидатор и writer c/protocan-boot/ports/tms320f28335, сохраняя единый формат SCI8/FAB1.

Слои: клиент periph_28335 → автомат RS → проверка SCI8/FAB1 → callbacks платы → TI Flash API. Передаются октеты; адреса CPU считаются 16-битными словами.

Файл Назначение и зависимости
include/f28335_rs_boot.h, src/f28335_rs_boot.c Переносимый автомат, зависит от protocan-boot
ports/tms320f28335/flash_api.c Официальный TI API v2.10, заголовки устройства, частота F28335_RS_CPU_HZ
ports/tms320f28335/boot.cmd Постоянный сектор A, отдельные RAMAPI, RAMFUNCS и стек
tools/build.py Сборка boot и выпуск проверенных Flash OUT/SCI8 с manifest/SHA-256
tests/test_boot.py Настоящий автомат и writer в модели RAM/Flash без оборудования

Приложение занимает [0x300000,0x338000), первые 16 слов содержат FAB1. Сектор A и переход 0x33FFF6 принадлежат постоянному загрузчику. INITLOAD разрешает только staging 0x200000, чётный размер 24..130560 октетов. Ошибочные CRC, таймаут и ошибка UART отзывают подтверждение LOAD. Перед erase повторно проверяются RAM, CRC32, все адреса, entry и FAB1. Общий writer пишет FAB1 последним и проверяет физическую Flash. Ошибка не удаляет recovery; перезапуск разрешён после успешного ACK.

Контракт callbacks: stage_write(user, offset, octet) и stage.read(user, offset, buffer, size) обслуживают RAM относительно начала файла; transmit(user, data, size) возвращает true после физического окончания TX; program(user, image) вызывает общий Flash writer; reboot(user) сбрасывает контроллер. Все чтения/записи должны завершиться полностью либо вернуть false. Прерывания в постоянном загрузчике запрещены, watchdog выключен на время стирания. Межбайтовый таймаут аппаратный порт передаёт в f28335_rs_abort.

Быстрый старт: выделить f28335_rs_boot_t в RAM, заполнить пять callbacks, вызвать f28335_rs_init(&boot, &port, 16) и передавать каждый октет SCI через f28335_rs_feed(&boot, octet). До запуска приложения вызвать f28335_flash_app_validate, после успеха перейти на возвращённый entry. Аппаратные таймауты, выключение силовых выходов и выбор скорости задаёт плата.

Подключено в prolitarski_ups: SCI-A/RS-422, 115200 8N1, адрес 16; Monitor №93=1 в остановленном состоянии запрашивает boot через watchdog. Первичная установка требует записи двух OUT через JTAG с сохранением сектора A при загрузке приложения. Все последующие RS-обновления меняют B–H. Повреждённое приложение оставляет устройство в RS recovery после сброса.