Восстановить телеметрию CAN, обработку TESTLAMP и сохранение команд при загрузке параметров. Выбрать M95M02 основным профилем, добавить самостоятельную Flash-сборку и проверять образы до публикации. Проверки: хостовые тесты, реальные сборки TI C2000, контроль COFF/SCI8 и защита записи при активной нагрузке.
102 lines
18 KiB
Python
102 lines
18 KiB
Python
"""Собирает независимый Flash COFF текущей 167 с тем же паспортом и аппаратной EEPROM.""" # Альтернативная сборка сохраняет основную RAM/EEPROM-прошивку.
|
||
import argparse # Поддерживает штатный вызов общего postbuild и явную проверочную сборку без Make.
|
||
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, read_version # Сохраняет ручную версию и физическую разметку текущей 167.
|
||
|
||
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(): # Перечисляет только связанные production C/ASM-файлы текущего CCS-проекта.
|
||
sources = [] # Каждая запись компилируется в независимый Flash-объект без использования старой RAM-сборки.
|
||
for link in ET.parse(PROJECT / ".project").findall(".//linkedResources/link"): # Сохраняет подключённые внешние TI-модули и все актуальные локальные изменения.
|
||
uri = link.findtext("locationURI", "") # Исходники должны находиться в текущем дереве SRC_ROOT1.
|
||
if uri.startswith("SRC_ROOT1/Source/") and Path(uri).suffix.lower() in (".c", ".asm"): # Заголовки и linker command файлы не компилируются как самостоятельный C-код.
|
||
sources.append(ROOT / uri.removeprefix("SRC_ROOT1/")) # Избегает ссылок на исходники другой ветки или случайный generated 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.
|
||
if any(metadata.get(key) != value for key, value in profile.items()) or metadata["version"] != read_version(PROJECT / "firmware_version.h"): # Отвергает смену версии/аппаратного профиля после prebuild.
|
||
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/firmware-info/include", build_dir / "generated"] # Изолированная проверочная сборка получает тот же generated-паспорт и локальные Flash-заголовки.
|
||
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(): # Пересобирает все production-модули, сохраняя текущие CAN, GAS, защиты и регистратор 167.
|
||
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=_c_int00", "--rom_model", "--warn_sections", "--reread_libs", "-m" + str(output.with_suffix(".map")), "-o", str(output)] # Стандартный C startup и Flash codestart образуют две нужные точки входа устройства.
|
||
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 прекратит выпуск всех вариантов текущей попытки.
|
||
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) # Запускает только компиляцию/линковку; программирование устройства отсутствует.
|