Добавить проверку Flash SCI, системные диалоги и векторизацию PDF

Расширить протокол SCI проверкой содержимого Flash и комплектом RAM-ядер.
Добавить утилиту векторизации PDF с OCR, общие диалоги DSView и проверки.
This commit is contained in:
2026-11-18 16:03:53 +03:00
parent 4825465583
commit afdf62cfa4
50 changed files with 2670 additions and 51 deletions
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -18,5 +18,5 @@ where = ["."]
include = ["firmware_image*", "altera_logic*", "logic_analyzer*", "set_devices*", "protocan*", "setprotocol*", "pysetterminal*"]
[tool.setuptools.package-data]
set_devices = ["gas_logger_maps/*.json"]
set_devices = ["gas_logger_maps/*.json", "sci_kernels/*.bin", "sci_kernels/*.json"] # Самостоятельный пакет templates также поставляет ядра F28335 с каталогом SHA-256 и лицензией TI.
protocan = ["*.json", "native/*.dll", "native/*.so", "native/*.dylib"]
+20
View File
@@ -0,0 +1,20 @@
"""Встроенные 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.
+10
View File
@@ -57,6 +57,16 @@ class FirmwareImage:
raise FirmwareImageError(f"Размер образа превышает {maximum_size} байт")
return cls(file_path, data, base)
@classmethod # Отдельный маршрут C2000 не меняет байтовую адресацию Intel HEX других микроконтроллеров.
def load_c2000(cls, path, maximum_size=1024 * 1024): # Принимает прежний HEX C2Prog и бинарный/ASCII SCI8 без соседнего manifest.
from protocan.c2000_sci import decode, validate # Единственный C-парсер проверяет checksum, словные адреса и порядок октетов TI.
file_path = Path(path) # Сохраняет исходный путь для SHA-256 и повторного чтения перед аппаратным подтверждением.
with file_path.open('rb') as stream: raw = stream.read(maximum_size + 1) # Ограничивает чтение старых файлов до одного МиБ, как подготовка SCI-панели.
if not raw or len(raw) > maximum_size: raise FirmwareImageError('Пустой или слишком большой образ C2000') # Не выделяет дополнительные буферы для неподходящего размера.
try: validate(decode(raw), True) # Проверяет весь результат до изменения выбранного образа или контролов основной формы.
except ValueError as error: raise FirmwareImageError(str(error)) from error # Обычный диалог файла показывает конкретную ошибку HEX или защищённого адреса.
return cls(file_path, raw, 0) # SHA и CRC относятся к исходному файлу; словные адреса передаются внутри проверенной SCI8-таблицы.
def _parse_intel_hex(text: str, maximum_size=2 * 1024 * 1024) -> tuple[bytes, int]:
return contiguous_image(text, maximum_size)
File diff suppressed because one or more lines are too long
@@ -90,8 +90,8 @@ class UartUsbTerminal(QWidget): # Встраивается непосредст
layout = QVBoxLayout(self) # Позволяет панели растягиваться внутри существующей MCU страницы.
layout.addWidget(QLabel('USART → USB · RX1 PA3 / RX2 PB11 / RX3 PC11 / RX4 PD2 · TX1 PA2 · 8N1')) # Показывает проверенную разводку до подключения проводов.
controls = QHBoxLayout(); self.devices = QComboBox(); self.devices.setMinimumContentsLength(35) # Делает выбор нескольких USB адаптеров читаемым в обычном окне.
self.refresh = QPushButton('Обновить USB'); self.connect = QPushButton('Запустить'); self.record = QPushButton('Запись RX…') # Разделяет поиск, начало захвата и выбор места бинарных журналов.
for widget in (self.devices, self.refresh, self.connect, self.record): controls.addWidget(widget) # Сохраняет основные действия в одной строке над потоками.
self.refresh = QPushButton('Обновить USB'); self.connect_button = QPushButton('Запустить'); self.record = QPushButton('Запись RX…') # Имя кнопки сохраняет метод QObject.connect, который PySide2 вызывает при подключении сигналов панели.
for widget in (self.devices, self.refresh, self.connect_button, self.record): controls.addWidget(widget) # Размещает выбор USB и три действия в одной строке, не перекрывая служебный метод Qt.
layout.addLayout(controls); grid = QGridLayout(); layout.addLayout(grid) # Показывает четыре RX-экрана одновременно в сетке 2×2.
for index, peripheral in enumerate(('USART2', 'USART3', 'UART4', 'UART5')): # Имена соответствуют единственному аппаратному порту G474 из templates.
container = QWidget(); column = QVBoxLayout(container); row = QHBoxLayout(); rate = QComboBox(); rate.setEditable(True) # Каждому входу назначает независимый редактор скорости.
@@ -105,7 +105,7 @@ class UartUsbTerminal(QWidget): # Встраивается непосредст
layout.addLayout(sending); self.hex_view = QCheckBox('Показывать RX в HEX'); layout.addWidget(self.hex_view) # Позволяет читать двоичный поток без потери исходных байтов журнала.
self.message = QLabel('Отключено. Для непрерывного потока выберите запись RX; экран показывает последние 8 КиБ каждого канала.'); self.message.setWordWrap(True); layout.addWidget(self.message) # Объясняет ограничение предпросмотра до начала длительного захвата.
self.counts = [0] * 4; self.lost = [0] * 4; self.errors = [0] * 4 # Разделяет счётчики хоста и сообщённые прошивкой потери.
self.refresh.clicked.connect(self.refresh_devices); self.connect.clicked.connect(self.toggle); self.record.clicked.connect(self.choose_directory); self.send.clicked.connect(self.transmit); self.input.returnPressed.connect(self.transmit) # Связывает действия с общими обработчиками без открытия транспорта при создании UI.
self.refresh.clicked.connect(self.refresh_devices); self.connect_button.clicked.connect(self.toggle); self.record.clicked.connect(self.choose_directory); self.send.clicked.connect(self.transmit); self.input.returnPressed.connect(self.transmit) # Подключает кнопку запуска и остальные действия к обработчикам, сохраняя совместимость сигналов Qt 5 и Qt 6.
self.hex_view.toggled.connect(self.render_all) # Меняет только представление уже принятых байтов.
def refresh_devices(self): # Поиск выполняется только по явной кнопке пользователя.
try: # Ошибка установки DLL должна быть видна на этой же странице.
@@ -118,7 +118,7 @@ class UartUsbTerminal(QWidget): # Встраивается непосредст
directory = QFileDialog.getExistingDirectory(self, 'Каталог бинарных журналов RX') # Пользователь явно определяет место длительной записи.
if directory: self.directory = directory; self.record.setText('Запись RX: включена') # Отдельная подпапка и четыре bin файла создаются worker при START.
def toggle(self): # Кнопка запуска меняет состояние только существующей сессии этой панели.
if self.worker and self.worker.isRunning(): self.worker.requestInterruption(); self.connect.setEnabled(False); return # Просит worker штатно завершить TX, STOP и закрытие файлов без блокирования GUI.
if self.worker and self.worker.isRunning(): self.worker.requestInterruption(); self.connect_button.setEnabled(False); return # Блокирует повторное отключение, пока worker штатно завершает TX, STOP и закрытие файлов без ожидания в GUI.
if not self.devices.currentData(): self.refresh_devices() # Первый запуск помогает обнаружить устройство без дополнительного шага пользователя.
if not self.devices.currentData(): return # Не создаёт worker с пустым либо выдуманным USB путём.
try: rates = [int(rate.currentText()) for rate in self.rates] # Читает независимые скорости в битах в секунду перед фиксацией сессии.
@@ -128,12 +128,12 @@ class UartUsbTerminal(QWidget): # Встраивается непосредст
self.worker = UsbWorker(self.devices.currentData(), rates, self.directory, self) # Передаёт потоку неизменяемые параметры выбранного оборудования.
self.worker.data_ready.connect(self.received); self.worker.stats_ready.connect(self.statistics); self.worker.status.connect(self.message.setText); self.worker.active.connect(self.started); self.worker.finished.connect(self.finished) # Все изменения виджетов выполняются через queued Qt сигналы GUI потока.
for widget in [self.devices, self.refresh, self.record] + self.rates: widget.setEnabled(False) # Исключает изменение параметров уже открытого USB-сеанса.
self.connect.setText('Отключить'); self.message.setText('Подключение и настройка USART…'); self.worker.start() # Запускает ограниченные ожидания USB в фоне.
self.connect_button.setText('Отключить'); self.message.setText('Подключение и настройка USART…'); self.worker.start() # Переводит кнопку в режим отключения до начала фоновых ожиданий USB и подтверждений настройки.
def started(self, channels): # Показывает возможности, которые реально подтвердила прошивка.
self.send.setEnabled(True); self.message.setText('Захват активен: RX ' + str(channels) + ', TX только канал 1 / PA2') # Не разрешает TX до ACK команды START.
for index, view in enumerate(self.views): view.setEnabled(index < channels) # Отражает сборки с двумя и тремя входами без ложного ожидания четырёх потоков.
def finished(self): # Возвращает элементы управления только после закрытия USB и файлов worker.
self.send.setEnabled(False); self.connect.setEnabled(True); self.connect.setText('Запустить') # Завершённая сессия больше не принимает данные передатчика.
self.send.setEnabled(False); self.connect_button.setEnabled(True); self.connect_button.setText('Запустить') # После завершения сессии запрещает TX и возвращает доступную кнопку нового подключения.
for widget in [self.devices, self.refresh, self.record] + self.rates: widget.setEnabled(True) # Разрешает выбор следующего устройства и независимых скоростей.
self.worker.deleteLater(); self.worker = None # Освобождает завершённый QThread после обработки его последнего queued сигнала.
def transmit(self): # Отправляет пользовательские данные только через единственный доступный TX.
File diff suppressed because one or more lines are too long
@@ -0,0 +1,30 @@
{
"schema": 1,
"target": "TMS320F28335",
"kernels": [
{
"file": "f28335_20mhz.bin",
"oscillator_hz": 20000000,
"size_bytes": 5788,
"sha256": "5046fa4b2903974d73046d5e66c13a4cfdbdf16ac072cfbf8ba17e4c3f7b4143",
"verify": "readback-v1",
"sectors": "header-sm1"
},
{
"file": "f28335_25mhz.bin",
"oscillator_hz": 25000000,
"size_bytes": 5788,
"sha256": "03e32cda9105b9a3d458dc2500b9a44807d8293fe46c2b7aef9400e4294d8f31",
"verify": "readback-v1",
"sectors": "header-sm1"
},
{
"file": "f28335_30mhz.bin",
"oscillator_hz": 30000000,
"size_bytes": 5792,
"sha256": "fef8d88d96fe9d18b356dbddf10f5824b14ef45eae55d69ff74482e23a25f9a8",
"verify": "readback-v1",
"sectors": "header-sm1"
}
]
}
Binary file not shown.
Binary file not shown.
Binary file not shown.
+31 -4
View File
@@ -10,9 +10,11 @@ def sci8(address, words): # Готовит минимальную адресн
@pytest.mark.parametrize("words", [1, 1024, 1025, 2048, 2050]) # Границы проверяют обычную порцию, остаток и дополнительный нулевой ACK официального TI kernel.
def test_complete_echo_and_checksum_transcript(words): # Фактические ответы подтверждают порядок и неизменность всего приложения.
@pytest.mark.parametrize('verify', [False, True]) # Каждый размер проверяется и в прежнем протоколе, и с обязательным чтением реальной Flash.
def test_complete_echo_and_checksum_transcript(words, verify): # Фактические ответы подтверждают полный порядок записи и выбранной проверки.
kernel, image = sci8(0x9000, [0x1234, 0x5678]), sci8(0x328000, [0xA55A] * words) # RAM-ядро и Flash занимают разные разрешённые области.
session, received, pauses, zero_acks = Session(kernel, image), bytearray(), [], 0 # Наблюдения не используют внутреннюю структуру C-контекста.
if verify: kernel = kernel[:2] + b'VR\x01\x00' + kernel[6:] # Независимый эталон объявляет VR1 в резерве транспортного RAM-ядра.
session, received, pauses, zero_acks = Session(kernel, image, verify=verify), bytearray(), [], 0 # Использует настоящее C-ядро, включая проверку его возможностей до UART.
for _ in range(len(kernel) + words + 100): # Конечный предел выявляет зацикливание автомата.
state, tx, expected, delay = session.next() # Проверяет настоящий сформированный C-пакет.
if state == 0: break # Успех допустим лишь после отправки нулевого терминатора приложения.
@@ -20,10 +22,10 @@ def test_complete_echo_and_checksum_transcript(words): # Фактические
if expected == 1: session.accept(tx) # ROM и autobaud должны вернуть точное эхо отправленного октета.
else: # Kernel A подтверждает сумму октетов после erase/program, без побайтового эха приложения.
received.extend(tx) # Снимок подтверждает отсутствие пропущенных, повторённых либо изменённых октетов SCI8.
if expected: session.accept(struct.pack("<H", sum(tx) & 65535)) # Независимый эталон суммы следует опубликованному исходнику TI SendCheckSum.
if expected: session.accept((tx[-(expected - 2):] if expected > 2 else b'') + struct.pack("<H", sum(tx) & 65535)) # Ответ VR1 содержит только записанные данные без заголовка секции, затем независимую checksum TI.
if not tx: zero_acks += 1 # Пустой остаток TI подтверждается отдельным нулевым словом.
else: pytest.fail("Автомат SCI не завершился") # Отсутствие терминального перехода считается ошибкой протокола.
assert bytes(received) == image # MCU получил ровно исходный Flash SCI8 без переименования или подмены содержимого.
assert bytes(received) == (image[:2] + b'VR\x01\x00' + image[6:] if verify else image) # Verify меняет только запрос в резерве заголовка; адреса и все программируемые октеты исходного BIN неизменны.
assert pauses == [3000, 3000] and session.progress == 100 # Порядок ожиданий совпадает с TI f05_DownloadImage.
assert zero_acks == int(words > 1024 and words % 1024 == 0) # Обрабатывает особенность исходного TI Kernel A на кратной порции.
@@ -49,3 +51,28 @@ def test_ascii_decode_memory_ranges_and_monitor_command(): # Проверяет
with pytest.raises(ValueError): validate(sci8(0x33FFF8, [0x1234])) # Область CSM-паролей запрещена независимо от имени файла.
with pytest.raises(ValueError): validate(sci8(0x8000, [0x1234])) # RAM-образ не может стать Flash-приложением из-за выбранного loader.
assert ulitco_enter() == bytes([247, 213, 255, 93, 0, 0, 1, 0, 93, 1]) # Эталон совпадает с десятиоктетным Monitor-запросом FLASH_NUM=93 текущей прошивки UlitCo.
@pytest.mark.parametrize('fault', ['first', 'last', 'checksum', 'short']) # Повреждение данных, checksum и неполный ответ проверяются независимо друг от друга.
def test_verify_rejects_faults_in_later_noncontiguous_section(fault): # Адрес ошибки должен учитывать LOAD следующей секции и смещение после полного 1024-словного буфера.
kernel = sci8(0x9000, [1]); kernel = kernel[:2] + b'VR\x01\x00' + kernel[6:] # Минимальное ядро объявляет обязательный формат чтения VR1.
first, second = sci8(0x328000, [0x1234]), sci8(0x330100, [0xA55A] * 1025) # Разрыв между секциями выявляет ошибочное продолжение счётчика адресов первой секции.
session = Session(kernel, first[:-2] + second[22:], verify=True) # Оба блока проходят настоящую проверку Flash-адресов C-ядра.
while True: # Доходит до однословного остатка второй секции по публичному контракту обмена.
state, tx, expected, _ = session.next() # Размер ответа определяет физические данные и checksum без чтения структуры контекста.
if state == 2: continue # Обязательные паузы TI не требуют аппаратного ожидания в тесте.
if expected == 1: session.accept(tx); continue # ROM и autobaud возвращают точное эхо.
reply = (tx[-(expected - 2):] if expected > 2 else b'') + struct.pack('<H', sum(tx) & 65535) # Слова Flash и контрольная сумма формируются независимо от production-проверки.
if expected == 4 and tx == b'\x5A\xA5': break # После 1024 слов по адресу 0x330100 остаётся одно слово по адресу 0x330500.
session.accept(reply) # Все предыдущие блоки и их физическое содержимое считаются корректными.
damaged = bytearray(reply) # Сохраняет эталонную checksum неизменной для сценариев повреждения памяти.
if fault in ('first', 'last'): damaged[0 if fault == 'first' else 1] ^= 1 # Оба октета последнего слова должны проверяться, включая старший.
elif fault == 'checksum': damaged[-1] ^= 1 # Правильные физические данные не оправдывают неверное подтверждение TI.
else: damaged.pop() # Усечённый ответ нельзя засчитать как завершённую проверку.
with pytest.raises(ValueError, match='0x330500' if fault in ('first', 'last') else None): session.accept(bytes(damaged)) # Передаёт неизменяемый UART-ответ; отказ запрещает терминатор и сообщает адрес повреждённого слова Flash.
with pytest.raises(ValueError): session.next() # После неуспешной проверки автомат остаётся остановленным до нового явного сеанса.
assert session.progress < 100 # Непроверенный остаток не выдаётся за полностью завершённую прошивку.
def test_verify_requires_capable_kernel_before_first_exchange(): # Старый RAM-бинарник не должен привести к записи с обещанной, но отсутствующей проверкой.
with pytest.raises(ValueError, match='RAM-ядро TI не поддерживает Verify'): Session(sci8(0x9000, [1]), sci8(0x328000, [2]), verify=True) # Неподдерживаемый комплект отклоняется ещё до autobaud.