Добавить защищённое обновление приложения через RS и CAN с сохранением загрузчика, проверкой CRC, восстановлением передачи и защитой EEPROM. Подключить общий процесс сборки C2000 и автоматический счётчик версии для согласованных RAM, Flash, CAN и паспортов бинарных образов. Уточнить запуск ЦАП, обработку измерений и параметров нагрузки, начальную индикацию и документацию регистров GAS. Дополнить модели аппаратуры и изолировать заголовки CAN в тестах. Проверка: 26 тестов выпуска, 4 теста восстановления CAN и восемь программных моделей CAN, Flash, EEPROM, ЦАП, параметров и TESTLAMP.
114 lines
21 KiB
Python
114 lines
21 KiB
Python
"""Собирает независимый Flash COFF текущей 167 с тем же паспортом и аппаратной EEPROM.""" # Альтернативная сборка сохраняет основную RAM/EEPROM-прошивку.
|
||
import argparse # Поддерживает штатный вызов общего postbuild и явную проверочную сборку без Make.
|
||
import importlib.util # Подключает общий формат FAB1 из той же зависимости templates, которая компилирует приложение.
|
||
import json # Читает подготовленный паспорт, включая выбранную физическую EEPROM и компилируемую зависимость.
|
||
import os # Позволяет указать установленный TI Flash API без изменения исходников проекта.
|
||
from pathlib import Path # Разрешает все файлы относительно проекта, исключая зависимость от текущего терминала.
|
||
import subprocess # Запускает только локальные компилятор и линкер TI, не программируя устройство.
|
||
import tempfile # Каждая компиляция получает новые объектные файлы, не зависящие от старых артефактов или блокировок CCS.
|
||
import xml.etree.ElementTree as ET # Читает фактические списки исходников и include paths CCS вместо устаревшего generated Makefile.
|
||
from prepare_identity import read_profile, configured_version # Читает физическую разметку и текущий номер из JSON-счётчика либо ручного профиля другого проекта.
|
||
|
||
PROJECT = Path(__file__).resolve().parent # Каталог CCS содержит проверяемые .project и .cproject.
|
||
ROOT = PROJECT.parent # Корень production-исходников и обоих linker-вариантов устройства.
|
||
COMPILER = Path("C:/ti/ccs1230/ccs/tools/compiler/ti-cgt-c2000_22.6.0.LTS") # Доступный установленный COFF/FPU32 toolchain проекта.
|
||
FLASH_API = Path(os.environ.get("TI_FLASH_API_ROOT", "C:/ti/controlSUITE/libs/utilities/flash_api/2833x/28335/v210")) # Официальный API v2.10 F28335 с COFF ABI; сама библиотека не копируется в репозиторий.
|
||
|
||
|
||
def configuration_paths(configuration, compiler, build_dir): # Получает include paths и оптимизацию именно выбранной конфигурации CCS.
|
||
configs = ET.parse(PROJECT / ".cproject").findall(".//configuration") # Читает актуальный XML, а не параметры старой ветки Flash.
|
||
config = next(item for item in configs if item.get("name") == configuration) # Ошибка неизвестного Debug/Release не подменяется произвольными настройками.
|
||
options = config.findall(".//tool/option") # Содержит общие и файловые настройки компилятора в штатном порядке CCS.
|
||
include_option = next(item for item in options if item.get("superClass", "").endswith("compilerID.INCLUDE_PATH")) # Использует действующие include paths, включая vendored templates.
|
||
macros = {"${SRC_ROOT}": str(ROOT), "${PROJECT_LOC}": str(PROJECT), "${PROJECT_ROOT}": str(PROJECT), "${CG_TOOL_ROOT}": str(compiler), "${BuildDirectory}": str(build_dir)} # Разрешает только известные файловые макросы CCS; PROJECT_ROOT совпадает с каталогом .project.
|
||
includes = [] # Поддерживает исходный порядок поиска заголовков компилятора.
|
||
for option in include_option.findall("listOptionValue"): # Обрабатывает каждый путь фактически выбранной конфигурации.
|
||
value = option.get("value", "") # Пустые некорректные настройки будут отвергнуты до компиляции.
|
||
if value == "${COM_TI_XDC_INCLUDE_PATH}": # Штатная конфигурация проекта без SYS/BIOS не задаёт каталогов XDC, а CCS оставляет служебный макрос пустым.
|
||
continue # Не передаёт неразрешённый встроенный placeholder отдельному CLI-компилятору.
|
||
for macro, replacement in macros.items(): # Подставляет реальные абсолютные пути данной проверки.
|
||
value = value.replace(macro, replacement) # Не использует shell expansion и не исполняет текст XML.
|
||
if not value or "${" in value: # Не передаёт компилятору неразрешённый путь вместо общей зависимости.
|
||
raise ValueError("Unresolved CCS include path: " + value) # Указывает настройку, которую требуется исправить в проекте.
|
||
includes.append(Path(value).resolve()) # Позволяет сборке запускаться из любого каталога postbuild.
|
||
level = next(item.get("value").rsplit(".", 1)[-1] for item in options if "compilerID.OPT_LEVEL" in item.get("superClass", "")) # Сохраняет нынешний O3 вместо старого O1 Flash-ветки.
|
||
speed = next(item.get("value").rsplit(".", 1)[-1] for item in options if item.get("superClass", "").endswith("compilerID.OPT_FOR_SPEED")) # Приоритет размера остаётся общим для RAM и Flash.
|
||
return includes, ["-O" + level, "--opt_for_speed=" + speed] # Прочие архитектурные настройки C28x/FPU32/COFF задаются явно ниже.
|
||
|
||
|
||
def project_sources(templates=None): # Перечисляет связанные C/ASM CCS, позволяя явно выбрать тот же checkout templates, который указан в паспорте текущей сборки.
|
||
sources = [] # Каждая запись компилируется в независимый Flash-объект без использования старой RAM-сборки.
|
||
default_templates = (ROOT.parent / "newProject/SETGUI/third_party/templates").resolve() # Этот checkout задан относительной ссылкой linked resource в .project и служит исходной базой переноса.
|
||
selected_templates = Path(templates).resolve() if templates is not None else default_templates # CLI override применяется только к общим модулям, сохраняя аппаратные исходники текущей платы.
|
||
link_roots = {"SRC_ROOT1": ROOT, "PARENT-2-PROJECT_LOC": PROJECT.parent.parent} # Повторяет корни связанных ресурсов Eclipse: локальные исходники лежат в репозитории, а общий модуль — в соседнем SETGUI на два уровня выше каталога проекта CCS.
|
||
for link in ET.parse(PROJECT / ".project").findall(".//linkedResources/link"): # Сохраняет подключённые внешние TI-модули и все актуальные локальные изменения.
|
||
uri = link.findtext("locationURI", "") # Читает точную ссылку CCS, включая штатный корень PARENT-2-PROJECT_LOC для общей реализации CAN.
|
||
prefix, separator, relative = uri.partition("/") # Отделяет имя переменной Eclipse от относительного пути; пустой разделитель означает отсутствие допустимой ссылки на исходник.
|
||
if separator and prefix in link_roots and Path(relative).suffix.lower() in (".c", ".asm"): # Выбирает связанные C/ASM из поддержанных корней; заголовки, библиотеки и linker command не компилируются отдельно.
|
||
source = (link_roots[prefix] / relative).resolve() # Получает тот же абсолютный путь, что CCS, независимо от рабочего каталога процесса Flash-сборки.
|
||
if source.is_relative_to(default_templates): source = selected_templates / source.relative_to(default_templates) # Прямой C-модуль общей библиотеки должен принадлежать тому же templates_root, что include paths и prebuild-паспорт.
|
||
sources.append(source) # Передаёт компилятору единственный согласованный исходник текущего аппаратного проекта либо выбранной общей библиотеки.
|
||
sources.append(ROOT / "Source/Internal/flash_codestart.asm") # Аппаратный boot-переход подключается только к Flash, сохраняя чистую RAM SCI8-таблицу.
|
||
return list(dict.fromkeys(sources)) # Исключает дубли после повторного импорта CCS, не меняя первоначальный порядок.
|
||
|
||
|
||
def build_flash(compiler, build_dir, output, configuration="Debug"): # Полностью пересобирает отдельный Flash-вариант без рекурсивного Make и без прошивки платы.
|
||
compiler, build_dir, output = compiler.resolve(), build_dir.resolve(), output.resolve() # Фиксирует реальные пути входов и единственного запрошенного результата.
|
||
api_library = FLASH_API / "lib/Flash28335_API_V210.lib" # Официальная библиотека TI содержит алгоритмы стирания, записи и проверки F28335.
|
||
if not api_library.is_file(): # Нельзя выпускать образ с обещанным RS-обновлением без Flash API.
|
||
raise FileNotFoundError(api_library) # Диагностирует отсутствующую локальную установку до компиляции проекта.
|
||
metadata = json.loads((build_dir / "generated/firmware_identity.json").read_text(encoding="utf-8")) # Использует паспорт, подготовленный до RAM-сборки той же конфигурации.
|
||
templates = Path(metadata["templates_root"]) # Не возвращается к старой другой копии templates из Flash-ветки.
|
||
profile = read_profile(PROJECT, templates, metadata["eeprom"]) # Поддерживает согласованный CLI override обеих физических EEPROM.
|
||
settings = json.loads((PROJECT / "firmware_identity.json").read_text(encoding="utf-8-sig")) # Сверяет Flash с уже зарезервированным номером основной сборки, не увеличивая счётчик повторно.
|
||
if any(metadata.get(key) != value for key, value in profile.items()) or metadata["version"] != configured_version(PROJECT, settings): # Отвергает смену версии или аппаратного профиля после prebuild; Flash и RAM обязаны принадлежать одной попытке сборки.
|
||
raise ValueError("Flash configuration changed: run prebuild before compiling") # Не подписывает новый Flash старой таблицей версии.
|
||
includes, optimize = configuration_paths(configuration, compiler, build_dir) # Сохраняет актуальные include paths и настройки оптимизации RAM-проекта.
|
||
includes += [ROOT, FLASH_API / "include", templates / "c/set-protocol", templates / "c/set-protocol/ports/tms320f28335", templates / "c/protocan-boot/ports/tms320f28335", templates / "c/firmware-info/include", build_dir / "generated"] # Подключает аппаратный порт ProtoCAN Boot, откуда flash_rs.c берёт общий f28335_flash_app.c; остальные пути сохраняют согласованный паспорт и Flash API.
|
||
selected = int(profile["eeprom"] == "M95M02") # Только физический тип EEPROM управляет адресацией SPI и расположением сохраняемых параметров.
|
||
flags = ["-v28", "-ml", "-mt", "--float_support=fpu32", "--abi=coffabi", *optimize, "--gen_func_subsections=on", "--define=LARGE_MODEL", "--define=FLASH_BOOT", "--define=EEPROM_M95M02=" + str(selected)] # Flash boot отделён от аппаратной EEPROM; общий compiler guard проверяет выбранный профиль.
|
||
flags += ["--define=_DEBUG"] if configuration == "Debug" else [] # Сохраняет отладочный макрос без переноса других старых поведенческих изменений.
|
||
flags += ["--include_path=" + str(path) for path in dict.fromkeys(includes)] # Повторные пути не меняют поиск, а список остаётся пригодным для журнала.
|
||
object_root = build_dir / "flash" # Дополнительные объекты не подменяют RAM-компиляцию и её проверенный образ.
|
||
object_root.mkdir(parents=True, exist_ok=True) # Создаёт только выделенный корень артефактов Flash, сохраняя прежние диагностические сборки.
|
||
objects = Path(tempfile.mkdtemp(prefix="build-", dir=object_root)) # Новый каталог исключает подстановку stale OBJ и ошибки перезаписи заблокированного старого файла другой ветки.
|
||
object_files = [] # Линкер получит лишь объекты успешно завершившихся компиляций этой попытки.
|
||
log_path = objects / "build.log" # Сохраняет команды и диагностику для воспроизводимого review без засорения исходников.
|
||
with log_path.open("w", encoding="utf-8") as log: # Один журнал принадлежит одному последовательному Flash-build.
|
||
for source in project_sources(templates): # Пересобирает все модули CCS и связывает прямое подключение загрузчика с templates_root из текущего паспорта.
|
||
object_file = objects / (source.stem + ".obj") # Имена исходников текущего CCS-проекта уникальны и совпадают с его объектной моделью.
|
||
command = [str(compiler / "bin/cl2000.exe"), *flags, "-c", "--output_file=" + str(object_file), str(source)] # Не использует объект из старого Makefile либо другой ветки.
|
||
log.write(json.dumps(command, ensure_ascii=False) + "\n") # Фиксирует точные include paths, compiler define и исходник текущей попытки.
|
||
log.flush() # Команда остаётся доступной при аварийном завершении компилятора.
|
||
result = subprocess.run(command, cwd=ROOT, stdout=log, stderr=subprocess.STDOUT) # Все сообщения TI сохраняются рядом с альтернативными объектами.
|
||
if result.returncode: # Ненулевой код не допускает линковку прежнего объектного файла.
|
||
raise RuntimeError(f"Flash compilation failed: {source}; see {log_path}") # Даёт точный модуль и журнал ошибки вместо ложного успеха старого OUT.
|
||
object_files.append(str(object_file)) # Только успешный объект входит в итоговый список линкера.
|
||
output.parent.mkdir(parents=True, exist_ok=True) # Общий postcompile обычно передаёт свой временный каталог выпуска.
|
||
command = [str(compiler / "bin/cl2000.exe"), "-v28", "--float_support=fpu32", "--abi=coffabi", "-z", "--define=EEPROM_M95M02=" + str(selected), "--stack_size=0x3f0", "--entry_point=_flash_app_start", "--rom_model", "--warn_sections", "--reread_libs", "-m" + str(output.with_suffix(".map")), "-o", str(output)] # Общий boot вызывает watchdog-safe entry приложения ниже сектора A; аппаратный вход 0x33FFF6 в этот OUT не включается.
|
||
command += ["--search_path=" + str(path) for path in (ROOT, compiler / "lib", FLASH_API / "lib", templates / "c/set-protocol")] # Разрешает общую разметку EEPROM и секции официального TI API в linker command file.
|
||
command += [str(ROOT / "F28335_flash.cmd"), str(ROOT / "Source/External/v120/DSP2833x_headers/cmd/DSP2833x_Headers_nonBIOS.cmd"), *object_files, str(api_library), "-lrts2800_fpu32.lib", "-llibc.a"] # Берёт актуальный runtime TI вместо старой локальной библиотеки, в которой ранее ломался memcpy startup.
|
||
log.write(json.dumps(command, ensure_ascii=False) + "\n") # Сохраняет полную карту входов Flash-линкера для проверки LOAD/RUN.
|
||
log.flush() # Записывает команду до запуска потенциально ошибочной линковки.
|
||
result = subprocess.run(command, cwd=ROOT, stdout=log, stderr=subprocess.STDOUT) # Итоговый OUT принадлежит только этой свежей Flash-компиляции.
|
||
if result.returncode: # Нельзя выпускать старый OUT после неудачной линковки.
|
||
raise RuntimeError(f"Flash link failed; see {log_path}") # Общий postcompile прекратит выпуск всех вариантов текущей попытки.
|
||
spec = importlib.util.spec_from_file_location('protected_flash_image', templates / 'python/protocan/f28335_flash.py') # Использует единый контракт FAB1, который проверяют MCU и SETGUI.
|
||
flash_image = importlib.util.module_from_spec(spec) # Не меняет глобальный поиск Python-пакетов во время CCS postbuild.
|
||
spec.loader.exec_module(flash_image) # Отсутствующая общая зависимость останавливает выпуск до конверсии BIN.
|
||
flash_image.seal_coff(output, compiler / 'bin/ofd2000.exe') # Заполняет зарезервированный FAB1 и CRC всех окончательных LOAD-секций до hex2000 и внешней подписи.
|
||
print(f"[firmware-build] Flash {profile['eeprom']} COFF: {output}") # Показывает конкретный физический профиль и отдельный файл исполнения из Flash.
|
||
return output # Защищённый publish проверит COFF/MAP/SCI8 перед публикацией и export.
|
||
|
||
|
||
if __name__ == "__main__": # Импорт проверяющим кодом не запускает сборку и не создаёт файлы.
|
||
parser = argparse.ArgumentParser(description=__doc__) # Описывает отдельный вариант вместо скрытого переключения обычного BIN.
|
||
parser.add_argument("--postbuild", action="store_true") # Сохраняет совместимость с автоматическим обнаружением общего postcompile.
|
||
parser.add_argument("--compiler", type=Path, default=COMPILER) # Общий postbuild передаёт фактический CG_TOOL_ROOT.
|
||
parser.add_argument("--build-dir", type=Path, default=PROJECT / "Debug") # Разрешает независимый временный каталог проверки с собственным generated.
|
||
parser.add_argument("--output", type=Path, default=ROOT / "Bin/UKSSTMS320F28335_flash.out") # Не заменяет основной RAM OUT.
|
||
parser.add_argument("--configuration", choices=("Debug", "Release")) # Позволяет явно воспроизвести настройки CCS при изолированной проверке.
|
||
arguments = parser.parse_args() # Проверяет CLI до любых операций компилятора.
|
||
configuration = arguments.configuration or ("Release" if arguments.build_dir.name.lower() == "release" else "Debug") # Штатные каталоги CCS выбирают конфигурацию без дополнительного параметра общего postcompile.
|
||
build_flash(arguments.compiler, arguments.build_dir, arguments.output, configuration) # Запускает только компиляцию/линковку; программирование устройства отсутствует.
|