Files
Andrey 05be38a04a Обновить Flash/CAN, версии сборок и управление периферией
Добавить защищённое обновление приложения через RS и CAN с сохранением
загрузчика, проверкой CRC, восстановлением передачи и защитой EEPROM.
Подключить общий процесс сборки C2000 и автоматический счётчик версии
для согласованных RAM, Flash, CAN и паспортов бинарных образов.

Уточнить запуск ЦАП, обработку измерений и параметров нагрузки,
начальную индикацию и документацию регистров GAS.
Дополнить модели аппаратуры и изолировать заголовки CAN в тестах.

Проверка: 26 тестов выпуска, 4 теста восстановления CAN и восемь
программных моделей CAN, Flash, EEPROM, ЦАП, параметров и TESTLAMP.
2026-11-06 16:11:11 +03:00

87 lines
15 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.
"""Проверяет восстановление SETGUI после потерь CAN на настоящем ядре и EEPROM-порте F28335.""" # Аппаратная очередь ограничена 31 кадром, как production queue[32] с одним резервным элементом.
import ctypes # Передаёт кадры неизменённому C-ядру и получает настоящие ответы mailbox 4.
from collections import deque # Моделирует порядок CAN-кадров, уже отправленных клиентом в очередь загрузчика.
import os # Позволяет выбрать компилятор, зависимость templates и реальный пользовательский BIN.
from pathlib import Path # Формирует абсолютные пути независимо от каталога запуска проверки.
import subprocess # Компилирует production-порт с существующими аппаратными заглушками.
import sys # Подключает тот же пакет protocan, который использует SETGUI.
from types import SimpleNamespace # Предоставляет клиенту данные образа, версию и CRC без запуска GUI.
import zlib # Задаёт эталонный CRC32 тестового файла независимо от загрузчика.
import pytest # Разделяет сценарии потерь и гарантирует освобождение тестовой DLL.
ROOT = Path(__file__).resolve().parents[2] # Находит проект ПМ35 по расположению этой регрессии.
TEMPLATES = Path(os.environ.get("TEMPLATES_ROOT", ROOT.parent / "newProject/SETGUI/third_party/templates")) # По умолчанию проверяет фактическую зависимость SETGUI.
sys.path.insert(0, str(TEMPLATES / "python")) # Импортирует production-клиент вместо копии алгоритма передачи.
from protocan.can_boot import CanBootTarget, CanBootTransfer # Использует действующий автомат оконной загрузки.
from protocan.protocan import ProtoCanId # Различает DATA и STATUS штатным декодером идентификаторов.
from protocan.transport import build_frame # Возвращает ответы C-порта в стандартном формате клиента.
@pytest.fixture(scope="module") # Одна DLL обслуживает все независимые сценарии с полным сбросом EEPROM между ними.
def model(tmp_path_factory): # Создаёт программную модель без обращения к физическому CAN-адаптеру.
compiler = Path(os.environ.get("CC", "C:/msys64/ucrt64/bin/gcc.exe")) # Использует установленный host GCC, как остальные аппаратные регрессии проекта.
compiler_env = dict(os.environ, PATH=str(compiler.parent) + os.pathsep + os.environ.get("PATH", "")) # Предоставляет дочерним процессам GCC его DLL без изменения окружения пользователя.
core = TEMPLATES / "c/protocan-boot" # Объединяет ядро протокола, EEPROM-store и аппаратный CAN-порт одной версии.
library = tmp_path_factory.mktemp("can-recovery") / "transfer.dll" # Изолирует объект проверки от выпускаемых DLL приложения.
subprocess.run([str(compiler), "-std=c99", "-O2", "-shared", "-DPCAN_BOOT_WIDE_BYTES", "-I" + str(core), "-I" + str(core / "tests/f28335_stubs"), str(core / "src/pcan_boot.c"), str(core / "ports/tms320f28335/f28335_boot_store.c"), str(ROOT / "tests/can_boot/transfer_model.c"), "-o", str(library)], check=True, env=compiler_env) # Компилирует настоящий C28x-порт с широкими октетами и существующим тестовым экспортом.
with os.add_dll_directory(str(compiler.parent)): # Предоставляет Windows доступ к зависимостям выбранного GCC только на время загрузки.
device = ctypes.CDLL(str(library)) # Загружает локальную модель, которая не содержит операций с реальным оборудованием.
device.model_frame.argtypes = [ctypes.c_uint32, ctypes.POINTER(ctypes.c_uint), ctypes.c_uint, ctypes.POINTER(ctypes.c_uint32), ctypes.POINTER(ctypes.c_uint)] # Согласует 32-битный CAN ID и широкие октеты между Python и C.
try: # Освобождает DLL даже при обнаружении переполнения очереди либо ошибки передачи.
yield device # Каждый тест вызывает model_reset и получает отдельную пустую EEPROM.
finally: # Удаление временного каталога Windows возможно только после выгрузки библиотеки.
close = ctypes.WinDLL("kernel32", use_last_error=True).FreeLibrary # Использует штатное освобождение загруженной тестовой DLL.
close.argtypes, close.restype = [ctypes.c_void_p], ctypes.c_int # Сохраняет полный размер дескриптора в 64-битном процессе.
assert close(device._handle) # Не оставляет заблокированный файл после завершения регрессии.
@pytest.mark.parametrize("loss", ["first_block", "middle_block", "window_ack", "duplicate_ack"]) # Покрывает потерю DATA в начале/середине окна, потерю ACK и дубликат ACK.
def test_transfer_recovers_without_overfilling_device_queue(model, loss): # Передача должна завершиться после сбоя около показанных пользователем 64 процентов.
sample = bytearray(1054) # SCI8 содержит 22 байта заголовка, шесть байт описания секции, 1024 байта данных и два байта завершения.
sample[0:2], sample[21], sample[23], sample[27] = b"\xaa\x08", 0x80, 2, 0x80 # SCI8 задаёт entry 0x8000 и одну RAM-секцию из 512 слов; несколько окон позволяют проверить дубликат промежуточного ACK.
data = Path(os.environ["CAN167_IMAGE"]).read_bytes() if "CAN167_IMAGE" in os.environ else bytes(sample) # Позволяет проверить точные 41446 байт образа со скриншота без привязки теста к build ID.
target = CanBootTarget(device_type=1, device=8, product_type=0x2833, hardware_min=1, hardware_max=1) # Адрес и совместимость соответствуют задатчику PERIPH 8.
client = CanBootTransfer(SimpleNamespace(data=data, crc32=zlib.crc32(data), version=0x01010002), target) # Запускает production-клиент с проверяемым образом и ручной версией 1.1.2.
model.model_reset() # Каждая потеря проверяется независимо от ранее опубликованного pending.
pending = client.start() # Сохраняет запрос для штатного повтора по тайм-ауту SETGUI.
queue = deque(pending) # Сначала аппаратной очереди предназначена только команда ENTER_BOOT.
total = (len(data) + 7) // 8 # Протокол передаёт по восемь байт с дополнением последнего блока.
window_start = min((total * 64 // 100) // 16 * 16, max(0, (total - 1) // 16 * 16)) # Выбирает реальное окно около 64 процентов, сохраняя допустимость короткого SCI8.
lost_block = window_start + (min(5, total - window_start - 1) if loss == "middle_block" else 0) # Для частичного окна пропускает существующий внутренний блок, для first_block — первый.
window_end = min(total, window_start + 16) # Последнее укороченное окно подтверждается полным количеством блоков образа.
injected, retries, steps, max_queued = False, 0, 0, len(queue) # Ограничивает повторы и сохраняет доказательство отсутствия переполнения.
octets = ctypes.c_uint * 8 # Широкие октеты соответствуют типу pcan_boot_byte_t в C28x-сборке модели.
while not client.finished: # Завершение разрешается только после настоящих VERIFY, COMMIT и REBOOT ACK.
if not queue: # Отсутствие ответа после окна воспроизводит тайм-аут транспорта SETGUI.
retries += 1 # Бесконечное ожидание не может скрыть отсутствие восстановления.
assert retries <= 3, "Клиент не восстановил передачу за три повтора" # Соответствует текущему пределу повторов BusTab.
queue.extend(pending) # Повторяет последнее неподтверждённое окно, как _firmware_timeout.
request = queue.popleft() # F28335 обрабатывает один кадр из очереди за проход main.
identity = ProtoCanId.parse(request.can_id) # Использует production-разбор номера блока и типа сообщения.
steps += 1 # Ограничивает общую работу при ошибочной лавине повторных окон.
assert steps <= total * 20 + 100 # Даже серия восстановлений должна оставаться ограниченной относительно размера образа.
if not injected and loss in ("first_block", "middle_block") and identity.msg_type in (10, 11) and identity.body == lost_block: # Теряет ровно один DATA при неизменённом порядке остальных кадров.
injected = True # Следующий повтор пропущенного блока уже должен доставляться устройству.
continue # Не передаёт потерянный кадр ядру и не формирует вымышленный ответ.
reply_id, reply = ctypes.c_uint32(), octets() # Принимает реальные поля ответа из аппаратной модели mailbox 4.
count = model.model_frame(request.can_id, octets(*request.data), len(request.data), ctypes.byref(reply_id), reply) # Выполняет штатные запись EEPROM, readback, CRC и автомат команд.
if not count: # Внутри успешно принятого окна протокол не выдаёт ACK на каждый блок.
continue # Следующий уже отправленный кадр остаётся в аппаратной очереди.
response = build_frame(reply_id.value, bytes(reply[:]), to_can=False) # Преобразует восемь широких значений C28x в восемь wire-октетов без подмены status или next_block.
ack = ProtoCanId.parse(response.can_id) # Выделяет DATA ACK среди управляющих подтверждений.
affected = not injected and loss in ("window_ack", "duplicate_ack") and (ack.body & 255) == 0 and reply[0] == 0 and (reply[2] | reply[3] << 8) == window_end # Вмешивается только в успешное подтверждение выбранного окна.
if affected: # Однократный сбой канала должен быть пережит без перезапуска загрузчика.
injected = True # Повторный ACK того же окна после тайм-аута доставляется штатно.
if loss == "window_ack": # Потеря ответа оставляет клиенту последнее окно для повтора по тайм-ауту.
continue # Устройство уже записало данные, но клиент ещё не получил подтверждение.
for _ in range(2 if affected and loss == "duplicate_ack" else 1): # Повторяет один ACK, не повторяя запись EEPROM на стороне устройства.
outgoing, _ = client.handle_status(response) # Только production-клиент решает, следует ли посылать очередное окно.
if outgoing: # Игнорируемый дубликат не должен заменять набор для тайм-аута.
pending, retries = outgoing, 0 # Новое подтверждённое продвижение сбрасывает счётчик транспортных повторов.
queue.extend(outgoing) # Новые кадры приходят после уже стоящих в очереди хвостов предыдущего окна.
max_queued = max(max_queued, len(queue)) # Считает реальный объём ожидающих обработки кадров.
assert max_queued <= 31, f"Переполнение очереди загрузчика: {max_queued} кадров" # Production head/tail оставляет только 31 полезное место из queue[32].
assert injected and client.percent == 100 # Сценарий обязан действительно потерять/повторить кадр и полностью пройти протокол.
assert model.model_select() == 0 and model.model_confirm(0) # Настоящий журнал должен разрешить пробный запуск записанного A и его подтверждение.
assert model.model_parameters_intact() # Восстановление передачи не затрагивает защищённую область параметров платы.