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

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

Проверка: 26 тестов выпуска, 4 теста восстановления CAN и восемь
программных моделей CAN, Flash, EEPROM, ЦАП, параметров и TESTLAMP.
2026-11-06 16:11:11 +03:00

114 lines
21 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Собирает независимый 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) # Запускает только компиляцию/линковку; программирование устройства отсутствует.