56 lines
9.2 KiB
Python
56 lines
9.2 KiB
Python
"""Эталонные байты и потоковые проверки единственного C-кодека USART USB.""" # Тест использует настоящую DLL, а не повторяет кодек на Python.
|
|
import ctypes as ct # Передаёт эталонные фрагменты непосредственно C-функциям.
|
|
import os # Получает путь собранной DLL через окружение тестового запуска.
|
|
import random # Создаёт воспроизводимые произвольные разрывы входного потока.
|
|
import pytest # Параметризует границы каналов и длины USB-записей.
|
|
from set_devices.uart_usb import Native, Frame, Parser, CEvent # Использует штатные ABI структуры production порта.
|
|
@pytest.fixture # Каждая проверка получает независимое состояние C parser.
|
|
def native(): # Загружает только DLL, явно подготовленную внешней командой сборки.
|
|
result = Native(os.environ['UART_USB_LIBRARY']) # Исключает случайную проверку старой установленной библиотеки.
|
|
result.lib.ub_encode.argtypes = [ct.c_uint8, ct.c_uint8, ct.POINTER(ct.c_uint8), ct.c_uint16, ct.POINTER(ct.c_uint8)] # Описывает общий builder для эталонных ответов fake устройства.
|
|
result.lib.ub_encode.restype = ct.c_uint16 # Принимает точную длину построенной записи.
|
|
return result # Возвращает реальный C-кодек и Windows-порт с общим ABI.
|
|
def encoded(native, kind, channel, data): # Строит тестовый ответ общим C builder, сохраняя literal-векторы в проверках ниже.
|
|
source, out = (ct.c_uint8 * len(data)).from_buffer_copy(data), (ct.c_uint8 * 64)() # Размещает входной payload и независимый выходной буфер.
|
|
size = native.lib.ub_encode(kind, channel, source, len(data), out) # Вызывает production кодек без реализации заголовка в тестовом helper.
|
|
return bytes(out[:size]) # Возвращает ровно столько байтов, сколько разрешило C-ядро.
|
|
def test_literal_commands(native): # Фиксирует endian и единственный TX канал независимо от будущих изменений builder.
|
|
assert native.make('config', 1, 3000000) == bytes.fromhex('a7 11 04 00 c0 c6 2d 00') # Скорость 3000000 бит/с кодируется little-endian, канал 1 находится в младшей тетраде.
|
|
assert native.make('start') == bytes.fromhex('a7 20 00 00') # Общая команда START не содержит payload и номера физического входа.
|
|
assert native.make('stop') == bytes.fromhex('a7 30 00 00') # Общая команда STOP отличается только типом.
|
|
assert native.make('tx', data=b'\0\xa7\xff') == bytes.fromhex('a7 41 03 00 00 a7 ff') # Служебный байт внутри данных передаётся без экранирования и изменения.
|
|
@pytest.mark.parametrize('cut', range(65)) # Проверяет каждый возможный разрыв максимального USB-пакета.
|
|
def test_every_split(native, cut): # Гарантирует восстановление записи между произвольными вызовами чтения.
|
|
payload = bytes([0xA7, 0, 255] * 20) # Заполняет все 60 байт двоичными значениями, включая синхронизацию.
|
|
packet = encoded(native, 9, 4, payload) # Готовит максимальный RX ответ канала 4.
|
|
events = native.feed(packet[:cut]) + native.feed(packet[cut:]) # Разделяет заголовок и данные в каждой возможной позиции.
|
|
assert len(events) == 1 and events[0].channel == 4 and events[0].data == payload # Ни разрыв, ни служебный байт внутри payload не создают ложный канал.
|
|
def test_noise_and_invalid_header(native): # Проверяет восстановление после шума, неизвестного типа и превышения длины.
|
|
stream = bytes.fromhex('00 ff a7 f1 00 00 a7 91 ff ff a7 95 01 00') + encoded(native, 9, 2, b'ok') # Добавляет неправильные тип, длину и канал перед валидной записью.
|
|
events = native.feed(stream) # Передаёт повреждённый поток реальному C parser.
|
|
assert [(item.channel, item.data) for item in events] == [(2, b'ok')] # Ошибочные заголовки не меняют полезные данные следующего канала.
|
|
def test_many_records_random_chunks(native): # Проверяет последовательность множества каналов при разных границах системного чтения.
|
|
rng, expected, stream = random.Random(474), [], bytearray() # Фиксированный seed делает проверку повторяемой.
|
|
for index in range(1000): # Создаёт достаточно длинный поток для многократного использования внутреннего буфера parser.
|
|
channel, payload = index % 4 + 1, bytes(rng.randrange(256) for _ in range(rng.randrange(1, 61))) # Перемешивает размеры и бинарные значения четырёх физических входов.
|
|
expected.append((channel, payload)); stream.extend(encoded(native, 9, channel, payload)) # Сохраняет ожидаемую модель до произвольной нарезки.
|
|
actual, offset = [], 0 # Собирает восстановленные события в исходном порядке.
|
|
while offset < len(stream): # Имитация WinUSB отдаёт блоки разной длины без границ записей.
|
|
count = rng.randrange(1, 300); actual.extend((item.channel, item.data) for item in native.feed(stream[offset:offset + count])); offset += count # Делегирует весь разбор общего заголовка C-ядру.
|
|
assert actual == expected # Проверяет отсутствие потерь, перестановки каналов и повреждения payload.
|
|
def test_ack_and_stats(native): # Фиксирует смысловые поля ответов без локального декодирования wire-байтов.
|
|
ack = native.feed(bytes.fromhex('a7 80 04 00 02 00 04 01'))[0] # Эталон подтверждает START, четыре RX и TX только канала 1.
|
|
assert (ack.kind, ack.command, ack.status, ack.channels, ack.tx_channel) == (2, 2, 0, 4, 1) # C API возвращает уже разобранные свойства устройства.
|
|
stats = native.feed(bytes.fromhex('a7 a3 08 00 78 56 34 12 ff ff ff ff'))[0] # Эталон содержит статистику канала 3 и максимальный беззнаковый счётчик.
|
|
assert (stats.kind, stats.channel, stats.lost, stats.errors) == (3, 3, 0x12345678, 0xFFFFFFFF) # Значения endian и диапазоны счётчиков одинаковы в MCU и Python.
|
|
@pytest.mark.parametrize('payload', [b'', b'\x02\x00\x04', b'\x02\x00\x05\x01', b'\x02\x00\x04\x02']) # Покрывает ошибочные длины и несовместимые возможности прошивки.
|
|
def test_bad_ack_is_not_event(native, payload): # Ошибочный ACK не разрешает передачу либо запуск панели.
|
|
assert native.feed(encoded(native, 8, 0, payload)) == [] # Семантическая проверка выполняется в C ub_describe.
|
|
def test_builder_rejects_bounds(native): # Границы публичного builder не зависят от ограничений UI.
|
|
assert encoded(native, 9, 5, b'x') == b'' # Номер канала 5 не существует в минимальном протоколе.
|
|
assert encoded(native, 9, 1, b'x' * 61) == b'' # Длина 61 превысила бы максимальный USB-пакет 64 байта.
|
|
with pytest.raises(ValueError): native.make('tx', data=b'') # Пустая отправка не создаёт неоднозначную команду TX.
|
|
def test_describe_checks_abi_bounds(native): # Прямой пользователь C ABI также защищён от выхода за размер payload.
|
|
frame, event = Frame(), CEvent(); frame.type = 9; frame.channel = 1; frame.length = 61 # Имитирует неверную структуру, созданную в обход потокового parser.
|
|
assert native.lib.ub_describe(ct.byref(frame), ct.byref(event)) == 0 # Проверка выполняется до memcpy и защищает память выходной модели.
|