Files
templates/c/uart-usb/tests/test_terminal.py
T

46 lines
8.1 KiB
Python
Raw 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.
"""Проверяет worker настоящего терминала с C-кодеком и имитацией USB устройства.""" # Не требует подключённой платы и не подменяет кодек реализацией Python.
import ctypes as ct # Передаёт входящие команды в общий C parser fake устройства.
from pathlib import Path # Проверяет точные бинарные журналы, сохранённые production worker.
from PySide6.QtWidgets import QApplication # Создаёт реальный Qt UI для проверки ограниченного предпросмотра.
from set_devices.uart_usb import Frame, Parser # Использует те же структуры C ABI, что и основной Python порт.
from set_devices.qt_ports.uart_usb_terminal import UsbWorker, UartUsbTerminal # Проверяет реальную панель и её единственный фоновый транспорт.
from test_uart_usb import native, encoded # Повторно использует загруженную DLL и builder эталонных ответов.
def test_worker_busy_tx_and_binary_logs(native, tmp_path): # Проверяет полный STOP→CONFIG→START→TX→STOP с записью всех двоичных байтов.
worker = UsbWorker('fake', [1000000] * 4, str(tmp_path), native_factory=lambda: native) # Запускает production автомат с настоящим C протоколом и тестовым USB handle.
payload, rx = b'\0\xa7\xffhello', b'\0\xff\xa7RX\r\n' # Данные включают нулевой байт, служебную синхронизацию и двоичное значение FF.
class FakeUsb: # Моделирует только аппаратное поведение устройства, используя общий C parser и builder.
def __init__(self, codec, path): # Получает тот же codec API, что обычный WinUSB порт.
self.queue, self.parser, self.tx, self.commands, self.attempts, self.closed = [], Parser(), [], [], 0, False # Разделяет состояние командного parser и ответного потока хоста.
def write(self, data): # Принимает уже готовые команды worker без локальной реализации wire заголовка.
source, frame = (ct.c_uint8 * len(data)).from_buffer_copy(data), Frame() # Выделяет проверяемую входную память команды.
assert native.lib.ub_feed(ct.byref(self.parser), source, len(data), ct.byref(frame)) == len(data) # Общий C parser должен потребить ровно одну целую команду.
self.commands.append((frame.type, frame.channel)); status = 0 # Сохраняет семантику принятой команды для проверки порядка.
if frame.type == 4: # Единственная передача сначала получает явный BUSY, затем принимается.
self.attempts += 1; status = 2 if self.attempts == 1 else 0 # BUSY не имеет побочного действия и разрешает безопасный повтор.
if not status: self.tx.append(bytes(frame.data[:frame.length])) # Сохраняет байты только после действительного принятия TX.
self.queue.append(encoded(native, 8, frame.channel, bytes([frame.type, status, 2, 1]))) # Fake прошивка объявляет два RX и единственный TX1 через общий ACK builder.
if frame.type == 2: self.queue.append(encoded(native, 9, 1, rx)) # Данные RX следуют сразу за START, проверяя захват начала сессии.
def read(self): # Возвращает несколько готовых записей одним блоком, как реальный конвейер USB.
if self.queue: result = b''.join(self.queue); self.queue.clear(); return result # Сохраняет порядок ACK и первого RX в одном чтении.
if self.tx: worker.requestInterruption() # Завершает тест после успешной пользовательской передачи, не оставляя бесконечный loop.
return b'' # Пустое чтение соответствует штатному ограниченному таймауту транспорта.
def close(self): self.closed = True # Фиксирует обязательное закрытие после STOP независимо от данных сессии.
worker.usb_factory = FakeUsb; worker.commands.put(payload); statuses = []; worker.status.connect(statuses.append) # Ставит пользовательский TX до запуска worker без взаимодействия с GUI потоком.
worker.start(); assert worker.wait(3000) # Проверяет настоящий QThread и его штатный requestInterruption с ограниченным сроком завершения.
assert worker.usb.closed and worker.usb.tx == [payload] and worker.usb.attempts == 2 # BUSY вызывает повтор ровно один раз и не дублирует байты USART.
assert worker.usb.commands[:4] == [(3, 0), (1, 1), (1, 2), (2, 0)] # Сборка с двумя входами не настраивает несуществующие каналы 3 и 4.
assert worker.usb.commands[-1] == (3, 0) # Штатное отключение завершается командой STOP до закрытия Windows handle.
assert list(tmp_path.glob('*/rx1.bin'))[0].read_bytes() == rx # Бинарный журнал сохраняет исходные байты без UTF-8 перекодирования и USB заголовка.
assert worker.totals == [len(rx), 0, 0, 0] # Общий счётчик хоста соответствует всем реально полученным данным.
assert not any('Нет подтверждения' in status for status in statuses) # Нормальный BUSY не маскируется таймаутом команды.
def test_panel_preview_and_rx_only(native): # Проверяет реальную панель без открытия USB и без аппаратного оборудования.
application = QApplication.instance() or QApplication([]) # Создаёт один Qt event dispatcher для виджетов теста.
panel = UartUsbTerminal(); panel.resize(1000, 650) # Проверяет компоновку четырёх каналов в обычном размере окна.
assert not panel.send.isEnabled() # TX недоступен до подтверждённого открытия и START.
panel.started(2); assert panel.send.isEnabled() and not panel.views[2].isEnabled() # Возможности прошивки отключают экраны отсутствующих третьего и четвёртого входов.
panel.received(1, b'x' * 20000, 20000); panel.statistics(1, 7, 3) # Имитирует большой непрерывный поток и отдельные аппаратные счётчики.
assert len(panel.buffers[0]) == 8192 and panel.counts[0] == 20000 # Предпросмотр ограничен, но суммарное число байтов не обрезается.
assert 'потери 7' in panel.counters[0].text() and 'ошибки 3' in panel.counters[0].text() # GUI показывает явные сообщения о перегрузке прошивки.
panel.hex_view.setChecked(True); assert panel.views[0].toPlainText().startswith('78 78') # HEX меняет только отображение принятого пользовательского потока.
panel.close(); application.processEvents() # Завершает тест без фонового QThread и открытых системных ресурсов.