Добавить защищённое обновление приложения через RS и CAN с сохранением загрузчика, проверкой CRC, восстановлением передачи и защитой EEPROM. Подключить общий процесс сборки C2000 и автоматический счётчик версии для согласованных RAM, Flash, CAN и паспортов бинарных образов. Уточнить запуск ЦАП, обработку измерений и параметров нагрузки, начальную индикацию и документацию регистров GAS. Дополнить модели аппаратуры и изолировать заголовки CAN в тестах. Проверка: 26 тестов выпуска, 4 теста восстановления CAN и восемь программных моделей CAN, Flash, EEPROM, ЦАП, параметров и TESTLAMP.
87 lines
15 KiB
Python
87 lines
15 KiB
Python
"""Проверяет восстановление 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() # Восстановление передачи не затрагивает защищённую область параметров платы.
|