Сохранить совместимый переход RAM-ядра, постоянный поток Qt, точную диагностику обмена и журнал без повторов процентов. Добавить проверку транспортной точки входа официальным TI compiler.
104 lines
20 KiB
Python
104 lines
20 KiB
Python
"""Общий выпуск 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 без поиска по времени изменения.
|