Files
templates/c/firmware-info/tools/c2000_sci_build.py
Andrey 26f9d62896 Согласовать SCI-ядро и жизненный цикл прошивки с UlitCo
Сохранить совместимый переход RAM-ядра, постоянный поток Qt,
точную диагностику обмена и журнал без повторов процентов.
Добавить проверку транспортной точки входа официальным TI compiler.
2026-11-13 19:23:41 +03:00

104 lines
20 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 SCI8 и RAM-ядра TI для штатного SCI-загрузчика F28335.""" # Подключается автоматически по flashing.default_loader=f28335-sci без проектного build_flash.py.
import base64 # Получает точные данные LOAD-секций из официального XML TI OFD.
import hashlib # Привязывает RAM-ядро к manifest конкретного комплекта прошивки.
import json # Сохраняет тот же UTF-8 паспорт версии и параметры загрузки из проектного JSON.
import os # Учитывает явный путь C2000WARE_ROOT без зависимости от компьютера разработчика.
from pathlib import Path # Все промежуточные файлы находятся внутри явно выбранного staging.
import re # Изменяет только закреплённые настройки официального TI kernel в временной копии.
import shutil # Копирует исходники ядра с сохранением лицензии TI и текущие артефакты проекта.
import subprocess # Запускает локальный TI compiler/hex2000 без JTAG и без аппаратного программирования.
import tempfile # Постоянный выпуск появляется после проверки всех результатов текущей сборки.
import xml.etree.ElementTree as ET # Читает фактические адреса COFF и ссылки исходников официального проекта ядра.
def find_c2000ware(): # Автоматически находит установленный комплект TI до компиляции ядра.
candidates = [Path(os.environ[name]) for name in ("C2000WARE_ROOT", "C2000WARE_INSTALL_DIR") if os.environ.get(name)] # Явная установка имеет приоритет над стандартными путями Windows.
candidates += sorted(Path("C:/ti").glob("C2000Ware_*"), reverse=True) # Типовая установка TI не требует ручного добавления каталогов в PATH.
for root in candidates: # Проверяет наличие именно F28335 SCI Flash Kernel A.
if (root / "device_support/f2833x/examples/f28335_flash_kernel/Shared_Boot.c").is_file(): return root.resolve() # Не принимает другой SDK за готовую зависимость.
raise ValueError("Не найден C2000Ware с f28335_flash_kernel; установите C2000Ware или задайте C2000WARE_ROOT") # Автонастройка должна показывать отсутствующую зависимость до сборки проекта.
def inspect_flash(image, compiler): # Проверяет обычный Flash OUT UlitCo независимо от названия выходной папки.
document = ET.fromstring(subprocess.check_output([str(compiler / "bin/ofd2000.exe"), "-x", str(image)])) # XML создаёт тот же официальный toolchain, который выпустил COFF.
coff = document.find(".//ti_coff") # SCI-профиль предназначен для исполняемого COFF TMS320F28335.
if coff is None or coff.findtext("file_header/target_id") != "0x9d" or coff.findtext("file_header/exec") != "true": raise ValueError("Для F28335 SCI нужен исполняемый COFF OUT") # Чужой процессор или объектный файл не конвертируется в прошивку.
entry, sections, mask = int(coff.findtext("optional_file_header/entry_point", "0"), 0), [], 0 # Entry и диапазоны OFD выражены в 16-битных словах C28x.
for section in coff.findall("section"): # Учитывает только реально загружаемые секции, исключая DSECT/NOLOAD и отладочные данные.
raw = section.findtext("raw_data") # OFD публикует содержимое загружаемой секции как base64.
if raw is None or section.findtext("copy") == "true": continue # Отсутствующие данные не должны породить ложную запись в ROM или регистры.
data, start = base64.b64decode(raw), int(section.findtext("virtual_addr", "0"), 0) # Использует LOAD-адрес, даже когда код исполняется из RAM.
stop = start + len(data) // 2 # Конец секции исключается; длина файла задана физическими октетами.
if not data: continue # Пустые служебные секции не влияют на Flash-маску.
if len(data) % 2 or start < 0x300000 or stop > 0x33FFF8 or (start < 0x33FFF6 and stop > 0x33FF80): raise ValueError("Flash OUT содержит недопустимую LOAD-секцию: " + str(section.findtext("name"))) # Не допускает RAM-образ, OTP или CSM; аппаратный codestart остаётся разрешён.
if any(start < old_stop and old_start < stop for old_start, old_stop in sections): raise ValueError("Пересекающиеся LOAD-секции Flash OUT") # Одинаковый адрес не может программироваться дважды разными секциями.
sections.append((start, stop)) # Сохраняет диапазон для проверки entry и последующих секций.
for sector in range((0x33FFFF - (stop - 1)) // 0x8000, (0x33FFFF - start) // 0x8000 + 1): mask |= 1 << sector # Маска TI нумерует сектор A младшим битом; сектор содержит 0x8000 слов.
if not sections or not any(start <= entry < stop for start, stop in sections): raise ValueError("Точка входа Flash OUT отсутствует в загружаемых данных") # Наличие OUT без реального кода не разрешает выпуск.
return mask # Ядро стирает только сектора, необходимые этому образу.
def build_kernel(compiler, output, oscillator_hz, sectors, ware=None): # Собирает официальный TI Kernel A под частоту платы и маску текущего приложения.
ware = Path(ware) if ware else find_c2000ware() # Применение настроек и postbuild используют одну процедуру поиска зависимости.
device = ware / "device_support/f2833x" # Общие заголовки и периферийные символы берутся из выбранного SDK.
original = device / "examples/f28335_flash_kernel" # Использует штатные исходники TI вместо закрытого ядра C2Prog.
output = Path(output); output.parent.mkdir(parents=True, exist_ok=True) # Ядро создаётся только внутри staging текущего выпуска.
source = output.parent / "kernel-source"; shutil.copytree(original, source) # Сохраняет полный текст лицензии каждого исходника в временной копии.
shared = source / "Shared_Boot.c"; text = shared.read_text(encoding="utf-8-sig") # Меняет только маску erase, не алгоритм Flash API.
text, replaced = re.subn(r"Flash_Erase\(\s*\([^)]*\)", f"Flash_Erase((Uint16)0x{sectors:04X}", text, count=1) # Маска соответствует фактическим Flash LOAD-секциям текущего OUT.
if replaced != 1: raise ValueError("Неподдержанная версия TI Kernel A: не найдена маска Flash_Erase") # Изменённый SDK не должен незаметно стирать другой набор секторов.
shared.write_text(text, encoding="utf-8") # Временный исходник остаётся UTF-8 с сохранённой лицензией TI.
cpu_rate = 1000000000 / (oscillator_hz * 5) # Штатный PLLCR=10 и DIVSEL=/2 дают SYSCLKOUT=5×частота кварца; CPU_RATE выражен наносекундами.
config = source / "Flash2833x_API_Config.h"; text = config.read_text(encoding="utf-8-sig") # Масштабирование Flash API должно соответствовать реальной частоте CPU.
text, replaced = re.subn(r"(?m)^#define\s+CPU_RATE\s+[^\r\n]+", f"#define CPU_RATE {cpu_rate:.6f}L /* Период SYSCLKOUT в наносекундах для выбранного кварца. */", text, count=1) # Не меняет закомментированные примеры частот TI.
if replaced != 1: raise ValueError("В TI kernel отсутствует настройка CPU_RATE") # Отсутствующий масштаб времени не допускает вызов Flash API.
config.write_text(text, encoding="utf-8") # Подготовленный заголовок действует только на RAM-ядро этой сборки.
start = source / "UlitCo_CodeStart.asm" # Штатный primary_bootloader.obj разрешает только entry=0 и после загрузки выполняет LB #0.
start.write_text(' .ref _InitBoot ; Использует штатную инициализацию стека и возврат из TI Kernel A.\n .sect "codestart" ; Карта TI размещает два слова перехода в BEGIN по словному адресу 0x000000.\n LB _InitBoot ; Передаёт управление ядру с корректным стеком вместо входа через C runtime.\n', encoding="utf-8") # Самого изменения entry недостаточно: прежний codestart вёл через _c_int00 и обходил выход _ExitBoot.
sources = list(source.glob("*.c")) + list(source.glob("*.asm")); commands = [] # Локальные исходники штатного проекта компилируются без рекурсивного запуска CCS Make.
project = ET.parse(original / ".project") # Связанные исходники SDK разрешаются по стандартным ссылкам проекта TI.
for link in project.findall(".//linkedResources/link"): # Подключает common и headers, не копируя их в проект пользователя.
location = link.findtext("locationURI", "") # Официальный проект использует INSTALLROOT_2833X.
if location.startswith("INSTALLROOT_2833X/"): commands.append(device / location.split("/", 1)[1]) # Сохраняет пути выбранного SDK вместо абсолютных путей TI-разработчика.
sources += [path for path in commands if path.suffix.lower() in (".c", ".asm") and path.name != "DSP2833x_CodeStartBranch.asm"] # Включает ADC calibration, delay и регистры F28335; штатный codestart заменён переходом в _InitBoot.
compiler_args = [str(compiler / "bin/cl2000.exe"), "-v28", "-ml", "-mt", "--float_support=fpu32", "--abi=coffabi", "--define=LARGE_MODEL", "--opt_level=2"] # Параметры соответствуют официальному проекту TI F28335 Kernel A.
compiler_args += ["--include_path=" + str(path) for path in (source, device / "common/include", device / "headers/include", compiler / "include")] # Только заголовки выбранных compiler и SDK участвуют в сборке.
objects = [] # Каждый исходник создаёт свой новый OBJ в staging.
for index, path in enumerate(sources): # Уникальные имена защищают от одноимённых файлов разных каталогов SDK.
obj = source / (str(index) + ".obj"); subprocess.run(compiler_args + ["--compile_only", "--output_file=" + str(obj), str(path)], check=True, cwd=source) # Не использует устаревшие OBJ из Debug официального примера.
objects.append(str(obj)) # Линкер получает только результаты текущего вызова.
out = output.with_suffix(".out") # RAM COFF остаётся промежуточным результатом подготовки ядра.
link_args = [str(compiler / "bin/cl2000.exe"), "-v28", "-ml", "--float_support=fpu32", "--abi=coffabi", "-z", "--rom_model", "--entry_point=_InitBoot", "--stack_size=0x200", "--output_file=" + str(out), "--map_file=" + str(out.with_suffix(".map"))] # Entry _InitBoot и стек повторяют официальную RAM-конфигурацию ядра.
link_args += ["--search_path=" + str(compiler / "lib"), "--search_path=" + str(source)] + objects + [str(path) for path in commands if path.suffix.lower() == ".cmd"] + [str(source / "Flash28335_API_V210.lib"), "-lrts2800_fpu32.lib"] # Flash API берётся из лицензированного SDK на машине пользователя.
subprocess.run(link_args, check=True, cwd=source) # Неполная RAM-компоновка не допускается к упаковке.
subprocess.run([str(compiler / "bin/hex2000.exe"), str(out), "-boot", "-sci8", "--entrypoint=0", "-b", "-o", str(output)], check=True) # SCI8 входит через адрес 0x000000, где codestart передаёт управление _InitBoot; COFF сохраняет символическую точку входа.
if not output.is_file() or not output.stat().st_size: raise ValueError("TI hex2000 не создал RAM-ядро SCI") # Ложный успех процесса не оставляет неполный комплект.
return output # Ядро проверяется host C-ядром до первого байта COM-передачи.
def publish(build, project, compiler, build_dir, artifact, metadata, output, export=None): # Выпускает комплект штатного SCI-профиля из уже собранного Flash OUT.
identity = build.load_identity(Path(__file__).resolve().parents[3]) # Паспорт, архивирование и SHA-256 остаются общими для CCS и Keil.
base = Path(artifact.replace("\\", "/")).name; source = Path(str(Path(artifact) if Path(artifact).is_absolute() else build_dir / artifact) + ".out") # Выбирает точный артефакт текущей конфигурации CCS.
settings = metadata["flashing"]["profiles"]["f28335-sci"] # Конкретный профиль задаёт частоту кварца и параметры UART пользователя.
sectors = inspect_flash(source, compiler) # RAM OUT или файл с защищёнными адресами отвергается до постоянного экспорта.
output = output.resolve(); output.mkdir(parents=True, exist_ok=True) # Каталог выпуска не зависит от дополнительного пути SETGUI.
with tempfile.TemporaryDirectory(prefix=".sci-release-", dir=output) as temporary: # Все преобразования проверяются до изменения постоянного комплекта.
stage = Path(temporary); image = stage / (base + "_flash_rs.bin"); kernel = stage / "f28335_sci_kernel.bin" # Отдельные имена однозначно различают Flash-приложение и RAM-ядро.
build_kernel(compiler, kernel, settings.get("oscillator_hz", 30000000), sectors) # Подготовка Flash больше не требует проектного build_flash.py.
subprocess.run([str(compiler / "bin/hex2000.exe"), str(source), "-boot", "-sci8", "-b", "-map", str(image.with_suffix(".bin.map")), "-o", str(image)], check=True) # BIN содержит LOAD-адреса исходной Flash-компоновки, без переименования RAM-образа.
build.verify_embedded(image, metadata) # Подтверждает полноту SCI8 и встроенный паспорт именно текущего prebuild.
kernel_info = {"file": kernel.name, "size_bytes": kernel.stat().st_size, "sha256": hashlib.sha256(kernel.read_bytes()).hexdigest(), "oscillator_hz": settings.get("oscillator_hz", 30000000), "sector_mask": sectors, "protocol": "TI Flash Kernel A"} # GUI проверяет точный RAM-бинарник перед отправкой первичному загрузчику.
specific = dict(metadata, execution="FLASH", image_format="SCI8-FLASH-SCI", protocol="TI SCI Flash Kernel A", transport="tms", flash_kernel=kernel_info) # Паспорт не объявляет совместимость с отдельным BIOS ПМ35 и FAB1.
passport = stage / "firmware_identity.json"; passport.write_text(json.dumps(specific, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") # Сохраняет все исходные настройки, версию и точное назначение комплекта.
identity.seal(image, passport); build.verify_package(image, specific) # Подтверждает SHA-256 транспортного Flash BIN до архивирования.
coff = stage / (base + "_flash.out"); shutil.copy2(source, coff) # Исходный COFF сохраняется для JTAG и диагностики с точными исходными байтами.
notices = stage / "TI_F28335_kernel_license.json"; notices.write_text(json.dumps({"source": "TI C2000Ware f28335_flash_kernel", "license_notice": "\n".join((find_c2000ware() / "device_support/f2833x/examples/f28335_flash_kernel/main.c").read_text(encoding="utf-8-sig").splitlines()[:49])}, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") # Скомпилированное RAM-ядро распространяется с исходным уведомлением и условиями лицензии TI.
extras = [kernel, coff, image.with_suffix(".bin.map"), notices] # Полный комплект включает зависимое ядро и обязательное уведомление поставщика.
result = identity.archive_build(image, passport, stage / "archive", extra_files=extras) # Использует общий проверенный архиватор вместо проектного копирования файлов.
folder = Path(result["directory"]); destination = output / folder.name # Имя выпуска определяется коммитом и временем prebuild в UTC+3.
identity.copy_tree(folder, destination) # Переносит только подготовленный текущий комплект; старые выпуски не сканируются.
if export is not None: identity.export_build(destination, export.resolve(), image.name) # Дополнительная папка SETGUI получает тот же полный проверенный набор.
build.write_receipt(output, destination.name, image.name) # Указатель импорта ведёт прямо к *_flash_rs.bin.manifest.json этого профиля.
print("[firmware-build] Flash SCI BIN: " + str(destination / image.name)) # IDE показывает фактический файл результата вместо неподходящей папки eeprom.
return destination / image.name # Вызывающий может открыть manifest без поиска по времени изменения.