Расширить протокол SCI проверкой содержимого Flash и комплектом RAM-ядер. Добавить утилиту векторизации PDF с OCR, общие диалоги DSView и проверки.
79 lines
12 KiB
Python
79 lines
12 KiB
Python
"""Эталонные обмены SCI ROM и TI Flash Kernel A без настоящей платы.""" # Проверки не открывают COM и не вызывают внешнюю программу C2Prog.
|
|
import struct # Формирует независимые тестовые SCI8-векторы с явно заданными словами и адресами.
|
|
import pytest # Проверяет отказ при повреждениях и граничные размеры порций ядра TI.
|
|
from protocan.c2000_sci import Session, decode, validate, ulitco_enter # Испытывает настоящий ctypes-порт общего C99-ядра.
|
|
|
|
|
|
def sci8(address, words): # Готовит минимальную адресную таблицу для эталонных данных теста.
|
|
pointer = struct.pack("<HH", address >> 16, address & 65535) # SCI8 хранит старшее слово адреса перед младшим.
|
|
return b"\xaa\x08" + bytes(16) + pointer + struct.pack("<H", len(words)) + pointer + struct.pack("<" + "H" * len(words), *words) + bytes(2) # Вектор содержит ключ, резерв, entry, одну секцию и терминатор.
|
|
|
|
|
|
@pytest.mark.parametrize("words", [1, 1024, 1025, 2048, 2050]) # Границы проверяют обычную порцию, остаток и дополнительный нулевой ACK официального TI kernel.
|
|
@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 занимают разные разрешённые области.
|
|
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 # Успех допустим лишь после отправки нулевого терминатора приложения.
|
|
if state == 2: pauses.append(delay); continue # Внешний транспорт выполняет только заданную алгоритмом задержку.
|
|
if expected == 1: session.accept(tx) # ROM и autobaud должны вернуть точное эхо отправленного октета.
|
|
else: # Kernel A подтверждает сумму октетов после erase/program, без побайтового эха приложения.
|
|
received.extend(tx) # Снимок подтверждает отсутствие пропущенных, повторённых либо изменённых октетов SCI8.
|
|
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[: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 на кратной порции.
|
|
|
|
|
|
def test_corrupt_echo_and_checksum_stop_transfer(): # Повреждённое подтверждение не должно разрешать следующий пакет.
|
|
kernel, image = sci8(0x9000, [1]), sci8(0x328000, [2]) # Минимальные векторы отделяют проверку ответа от больших файлов.
|
|
session = Session(kernel, image); session.next() # Первый пакет требует эхо ASCII A.
|
|
with pytest.raises(ValueError, match="не совпали"): session.accept(b"B") # Чужой байт autobaud не принимается как связь с ROM.
|
|
session = Session(kernel, image) # Независимый сеанс проверяет повреждение двухоктетной суммы Flash.
|
|
while True: # Доходит до первой операции erase/header без использования внутренних фаз автомата.
|
|
state, tx, expected, _ = session.next() # Паузы не требуют аппаратного ответа.
|
|
if state == 2: continue # Номер стадии остаётся внутри C-ядра.
|
|
if expected == 1: session.accept(tx) # Корректный ROM позволяет загрузить RAM-ядро.
|
|
else: break # Первый двухоктетный ответ должен подтвердить заголовок приложения.
|
|
with pytest.raises(ValueError, match="не совпали"): session.accept(b"\xff\xff") # Неверная сумма не разрешает программирование следующей секции.
|
|
|
|
|
|
def test_ascii_decode_memory_ranges_and_monitor_command(): # Проверяет переносимость форматов и аппаратные границы до открытия порта.
|
|
image = sci8(0x328000, [0x1234]) # Обычный Flash-вектор не пересекает CSM.
|
|
ascii_image = b"\x02\n" + " ".join(f"{value:02X}" for value in image).encode("ascii") + b"\n\x03\n" # Формат соответствует выводу TI hex2000 -boot -sci8 -a.
|
|
assert decode(ascii_image) == image and validate(image) == (0x328000, 4) # Сектор C имеет маску 0x0004 в TI Flash API.
|
|
with pytest.raises(ValueError): decode(ascii_image[:-2]) # Усечённый ETX не должен оставить частично декодированное ядро.
|
|
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.
|