"""Встроенные RAM-ядра F28335, не требующие файлов проекта или установленного TI SDK.""" # Все аппаратные операции остаются в существующем SCI-автомате. import hashlib # Сверяет двоичные ресурсы поставки с каталогом до открытия COM. import json # Читает только локальный каталог ресурсов текущего Python-пакета. from pathlib import Path # Ресурсы ищутся относительно модуля одинаково в исходниках, wheel и PyInstaller. from protocan.c2000_sci import decode, validate # Проверка адресов и формата остаётся в общем C-ядре. def embedded_kernel(oscillator_hz): # Выбирает ядро под подтверждённую частоту платы, сохраняя согласование секторов в протоколе SM1. directory = Path(__file__).with_name('sci_kernels') # Каталог входит в поставку SETGUI и не зависит от расположения прошиваемого проекта. catalog = json.loads((directory / 'catalog.json').read_text(encoding='utf-8')) # Каталог не скачивается из сети во время подготовки аппаратной операции. if catalog.get('schema') != 1 or catalog.get('target') != 'TMS320F28335': raise ValueError('Повреждён каталог встроенных ядер F28335') # Чужой формат или MCU не допускается к запуску в RAM. rows = [row for row in catalog.get('kernels', []) if row.get('oscillator_hz') == oscillator_hz] # Частоты сравниваются в герцах без округления GUI. if len(rows) != 1: raise ValueError('Встроенное ядро F28335 поддерживает кварц 20, 25 или 30 МГц') # Не заменяет неизвестную частоту ближайшим вариантом Flash API. row = rows[0] # Единственное найденное ядро фиксируется до дальнейших проверок. if not isinstance(row.get('file'), str) or Path(row['file']).name != row['file']: raise ValueError('Некорректное имя встроенного ядра F28335') # Каталог не может ссылаться на файл за пределами ресурсов приложения. data = (directory / row['file']).read_bytes() # Встроенное ядро читается отдельным неизменяемым снимком для текущей попытки. if len(data) != row.get('size_bytes') or hashlib.sha256(data).hexdigest() != row.get('sha256'): raise ValueError('Повреждено встроенное RAM-ядро F28335: переустановите SETGUI') # Совпадение имени ресурса не заменяет проверку его точных байтов. data = decode(data) # Общий C-декодер проверяет контейнер SCI8 до обращения к его резерву. entry, _ = validate(data, False) # Допускает только безопасные RAM-диапазоны без Flash и периферийных регистров. if entry != 0 or data[2:10] != b'VR\x01\x00SM\x01\x00': raise ValueError('Встроенное ядро не поддерживает вход UlitCo, Verify или маску секторов SM1') # Старый первичный загрузчик выполняет переход на адрес 0; SM1 обязателен для точного стирания. return data # Возвращает проверенное ядро; приложение и маску секторов дополнительно проверит Session.