diff --git a/python/set_devices/qt_ports/can_adapter_settings.py b/python/set_devices/qt_ports/can_adapter_settings.py new file mode 100644 index 0000000..8fa6b04 --- /dev/null +++ b/python/set_devices/qt_ports/can_adapter_settings.py @@ -0,0 +1,372 @@ +"""Общий редактор настроек и диагностика физических CAN-адаптеров.""" # Одинаковое окно используется снифером, терминалом и прошивкой. + +from set_devices.qt_ports.console import ConsoleView # Общая реализация templates объединяет инструменты просмотра журналов SETGUI. +import json # Сохраняем переносимую конфигурацию в одном значении QSettings. +from dataclasses import asdict # Вложенные тайминги преобразуются в словари без зависимости от виджетов. +from PySide6.QtCore import QSettings, QTimer # Настройки сохраняются между запусками; таймер обновляет только локальную историю FD. +from PySide6.QtWidgets import QCheckBox, QComboBox, QDialog, QDialogButtonBox, QDoubleSpinBox, QFormLayout, QGridLayout, QHBoxLayout, QLabel, QLineEdit, QMessageBox, QPlainTextEdit, QPushButton, QScrollArea, QSpinBox, QVBoxLayout, QWidget, QTabWidget # Используем стандартные элементы Qt, совместимые с темами приложения. +from set_devices.can_adapter_settings import CanTiming, CandleOptions, SlcanOptions # Транспорт и редактор используют одну проверяемую модель параметров. + + +def _choice(items, value): # Создаём выпадающий список со стабильными внутренними значениями. + widget = QComboBox() # Пользователь видит подпись, а настройки хранят bool/None либо строковый ключ. + for label, data in items: # Порядок вариантов задаёт привычный порядок выбора. + widget.addItem(label, data) # Отделяем русский текст интерфейса от сериализованного значения. + widget.setCurrentIndex(next((i for i in range(widget.count()) if widget.itemData(i) == value), 0)) # Неизвестное старое значение возвращается к первому варианту. + return widget # Вызывающий код добавляет виджет в нужную строку формы. + + +def _number(value, low, high, *, decimal=False): # Общая фабрика проверяемых числовых полей. + widget = QDoubleSpinBox() if decimal else QSpinBox() # Дробные проценты не округляются до целого числа. + widget.setRange(low, high) # Ограничения интерфейса дополняют аппаратную проверку транспорта. + widget.setValue(value) # Показываем сохранённое значение выбранного профиля. + return widget # Единицы измерения находятся в подписи строки формы. + + +class TimingEditor(QWidget): # Ручной тайминг обеих фаз имеет одинаковые поля и правила включения. + def __init__(self, value, parent=None): # Отсутствие модели означает автоматический расчёт. + super().__init__(parent) # Дочерние виджеты удаляются вместе с диалогом. + row = QGridLayout(self) # Подписи над числами уменьшают ширину формы на узком экране. + row.setContentsMargins(0, 0, 0, 0) # Убираем двойной отступ внутри родительской формы. + self.manual = QCheckBox("Вручную") # Явно отличаем ручную конфигурацию от автоматического расчёта. + self.manual.setChecked(value is not None) # Восстанавливаем фактический режим сохранённого тайминга. + row.addWidget(self.manual, 0, 0, 2, 1) # Переключатель занимает обе строки перед колонками параметров. + selected = value or CanTiming() # Дефолт соответствует 500 кбит/с при частоте CAN 48 МГц. + self.fields = {} # Словарь сохраняет порядок полей dataclass CanTiming. + for column, (name, label) in enumerate((("prop_seg", "PROP"), ("phase_seg1", "PH1"), ("phase_seg2", "PH2"), ("sjw", "SJW"), ("brp", "BRP")), 1): # Колонки сохраняют порядок полей ABI и понятные имена регистров. + row.addWidget(QLabel(label), 0, column) # Подпись располагается над своим числовым значением. + field = _number(getattr(selected, name), 0 if name == "prop_seg" else 1, 65535) # Реальные аппаратные пределы проверяет транспорт по capability. + field.setToolTip("Сегменты и SJW — в квантах CAN; BRP — делитель частоты. Скорость должна совпадать со скоростью подключения.") # Объясняем единицы и связь ручных параметров со скоростью. + field.setEnabled(self.manual.isChecked()) # Автоматический режим не допускает редактирования неиспользуемых чисел. + self.manual.toggled.connect(field.setEnabled) # Состояние всех полей следует одному переключателю. + row.addWidget(field, 1, column) # Пять чисел занимают общую строку под подписями. + self.fields[name] = field # Сохраняем доступ для сборки согласованной модели. + + def value(self): # Создаём модель только при явном выборе ручной настройки. + return CanTiming(**{name: field.value() for name, field in self.fields.items()}) if self.manual.isChecked() else None # None оставляет расчёт транспорту по возможностям устройства. + + +class AdapterSettingsDialog(QDialog): # Окно настройки остаётся доступным при соединении для диагностики и FD. + def __init__(self, kind, options, listen_only, adapter=None, parent=None, bitrate=500000, usb_update_factory=None): # Скорость нужна для проверки ручного BTR и доступности Sn до сохранения формы. + super().__init__(parent) # Модальное окно принадлежит вызывающей панели подключения. + self.usb_update_factory = usb_update_factory # Приложение передаёт своё окно обновления USB, чтобы общий модуль не зависел от SETGUI. + self.kind, self.adapter, self.original = kind, adapter, options # Модель применяется только при успешном подтверждении формы. + self.bitrate = bitrate # Значение относится к текущей панели подключения и не меняет скорость активного сеанса. + self.original_listen_only = listen_only # Закрытие диагностики не должно менять внешний флажок уже работающего режима. + self.setWindowTitle("Настройки CAN-адаптера — " + ("SLCAN" if kind == "slcan" else "Candle / gs_usb")) # Заголовок явно показывает редактируемое семейство. + self.resize(870, 690) # Начальный размер помещает ручные тайминги без чрезмерного расширения основного окна. + layout = QVBoxLayout(self) # Заголовок, вкладки и кнопки занимают независимые строки. + hint = QLabel("Настройки применяются при подключении. Функции Candle проверяются по возможностям выбранного канала. CANable не подтверждает команды настройки.") # Объясняем момент применения и доступность обратной связи прошивки. + hint.setWordWrap(True) # Текст не расширяет диалог за пределы экрана. + layout.addWidget(hint) # Подсказка остаётся видимой на всех вкладках. + self.tabs = QTabWidget(self) # Общий шаблон включает перестановку и единое оформление вкладок проекта. + self.tabs.setMovable(True); self.tabs.setDocumentMode(True); self.tabs.tabBar().setDrawBase(False) # Сохраняем привычную перестановку и плоское оформление вкладок общего редактора. + layout.addWidget(self.tabs) # Вкладки получают оставшуюся высоту окна. + self.page = QWidget() # Единственная форма содержит только параметры выбранного транспорта. + self.form = QFormLayout(self.page) # Подписи и поля выравниваются стандартным механизмом Qt. + self.form.setRowWrapPolicy(QFormLayout.RowWrapPolicy.WrapLongRows) # Длинный ручной тайминг переносится под подпись вместо расширения всего окна за экран. + scroll = QScrollArea() # Низкий экран не должен скрывать нижние параметры FD. + scroll.setWidgetResizable(True) # Ширина формы следует размеру окна. + scroll.setWidget(self.page) # Владение формой передаётся прокручиваемой области. + self.tabs.addTab(scroll, "Параметры") # Основная вкладка открывается первой при отключённом адаптере. + self.fields = {} # Реестр связывает элементы формы с полями модели настроек. + modes = [("Активный — приём, передача и ACK", "normal"), ("Только приём — без ACK", "listen"), ("Loopback — приём собственных кадров", "loopback")] # Базовые режимы имеют отдельные команды открытия в SLCAN. + if kind == "candle": # gs_usb допускает одновременные флаги LOOP_BACK и LISTEN_ONLY. + modes.append(("Loopback без ACK — пассивная самопроверка", "silent_loopback")) # Комбинация доступна только если устройство объявляет обе возможности. + selected_mode = "silent_loopback" if options.loopback and listen_only and kind == "candle" else "loopback" if options.loopback else "listen" if listen_only else "normal" # Сохраняем оба флага уже работающего Candle-сеанса. + self.mode = _choice(modes, selected_mode) # Одна комбинация выбора синхронизирует модель Loopback и внешний флажок приёма. + self.form.addRow("Режим CAN", self.mode) # Режим синхронизируется с существующим флажком только после принятия диалога. + if kind == "slcan": # Профиль определяет различия ASCII-команд и возможные расширения. + self._slcan(options) # Добавляем настройки именно последовательного протокола. + else: # WinUSB получает собственные флаги и параметры тайминга. + self._candle(options) # Не показываем пользователю не относящиеся к Candle команды Lawicel. + self._fd(options) # Быстрая фаза доступна обоим семействам с отдельными ограничениями. + self._diagnostics() # Диагностика использует уже подключённый адаптер и его локальный журнал. + self.buttons = QDialogButtonBox(QDialogButtonBox.StandardButton.Ok | QDialogButtonBox.StandardButton.Cancel | QDialogButtonBox.StandardButton.RestoreDefaults) # Отмена не меняет ни сохранённую модель, ни рабочее соединение. + self.buttons.button(QDialogButtonBox.StandardButton.Ok).setText("Применить") # Подпись явно обозначает сохранение параметров для следующего подключения. + self.buttons.button(QDialogButtonBox.StandardButton.Cancel).setText("Отмена") # Русская подпись доступна и без установленного переводчика Qt. + self.buttons.button(QDialogButtonBox.StandardButton.RestoreDefaults).setText("По умолчанию") # Сброс относится только к редактируемой форме и требует последующего применения. + self.buttons.accepted.connect(self.accept) # Переопределённый accept проверяет введённые данные до закрытия окна. + self.buttons.rejected.connect(self.reject) # Закрытие без применения сохраняет прежние настройки. + self.buttons.button(QDialogButtonBox.StandardButton.RestoreDefaults).clicked.connect(self._defaults) # Сброс также применяется только после явного OK. + layout.addWidget(self.buttons) # Кнопки остаются вне прокрутки и доступны на низком экране. + connected = bool(adapter is not None and adapter.connected) # Не опрашиваем и не открываем физические устройства при создании окна. + self.page.setEnabled(not connected) # Параметры аппаратного режима меняются только через переподключение. + self.buttons.button(QDialogButtonBox.StandardButton.RestoreDefaults).setEnabled(not connected) # Сброс не должен менять рабочую конфигурацию сеанса. + if connected: # Подключённый пользователь прежде всего получает состояние и журнал FD. + self.tabs.setCurrentIndex(1) # Сразу показываем доступные рабочие действия. + self.timer = QTimer(self) # Таймер принадлежит диалогу и останавливается при его уничтожении. + self.timer.timeout.connect(self._refresh_fd) # Обновление читает только ограниченную историю в памяти. + self.timer.start(250) # Четыре обновления в секунду достаточны для диагностического текстового просмотра. + self._refresh_fd() # Уже накопленные сообщения видны без ожидания первого срабатывания таймера. + + def add(self, name, label, widget): # Сохраняем единообразную привязку поля к dataclass. + self.fields[name] = widget # Реестр нужен при чтении и восстановлении стандартных значений. + self.form.addRow(label, widget) # Стандартная форма корректно учитывает размеры выбранного виджета. + return widget # Вызывающий метод может сразу подключить обновление зависимых элементов. + + def toggle(self, name, label, value): # Логические флаги отображаются компактными флажками. + widget = QCheckBox(label) # Подпись находится внутри элемента для удобного переключения мышью. + widget.setChecked(value) # Восстанавливаем сохранённое состояние без изменения модели. + return self.add(name, "", widget) # Пустая подпись формы не дублирует текст флажка. + + def tri(self, name, label, value): # Три состояния отличают явную настройку от сохранения состояния прошивки. + return self.add(name, label, _choice((("Не менять / автоматически", None), ("Включить", True), ("Выключить", False)), value)) # None не выполняет лишнюю запись EEPROM или переключение терминатора. + + def _slcan(self, value): # Диалекты Lawicel и CANable имеют несовместимые команды режима и фильтра. + profile = self.add("profile", "Прошивка SLCAN", _choice((("Lawicel — CR/BEL, команды O/L/l", "lawicel"), ("CANable 1.x — M0/M1, без ACK команд", "canable"), ("CANable 2.0 — M0/M1, CAN FD, без ACK команд", "canable2")), value.profile)) # Явный профиль исключает ошибочное автоматическое распознавание по COM-порту. + self.tri("retransmit", "Автоматические повторы A0/A1", value.retransmit) # Эта настройка применяется только в диалекте CANable. + self.tri("timestamps", "Временные метки Z0/Z1 (EEPROM)", value.timestamps) # Пользователь видит, что явный выбор может сохраняться в адаптере. + self.add("btr", "BTR0/BTR1 (16 МГц) — 4 HEX, пусто = Sn", QLineEdit(value.btr)) # Частота генератора относится к классическому Lawicel/SJA1000 и явно указана рядом с регистрами. + self.add("acceptance_code", "Код фильтра M — 8 HEX, пусто = не менять", QLineEdit("" if value.acceptance_code is None else f"{value.acceptance_code:08X}")) # Не смешиваем аппаратный фильтр с экранным поиском сообщений. + self.add("acceptance_mask", "Маска m — 8 HEX, 1 = не учитывать бит", QLineEdit("" if value.acceptance_mask is None else f"{value.acceptance_mask:08X}")) # Семантика маски соответствует Lawicel/SJA1000. + self.add("command_timeout_ms", "Тайм-аут команды, мс", _number(value.command_timeout_ms, 10, 10000)) # Верхняя граница 10 с предотвращает неограниченное ожидание. + profile.currentIndexChanged.connect(self._profile_changed) # Доступность зависимых полей следует явно выбранному диалекту. + + def _candle(self, value): # Все выбранные расширения проверит транспорт по capability до START. + self.toggle("one_shot", "One-shot — не повторять передачу при отсутствии ACK", value.one_shot) # Одна попытка полезна при диагностике и испытаниях одиночного узла. + self.toggle("triple_sample", "Triple sampling — тройная выборка бита", value.triple_sample) # Функция зависит от контроллера и прошивки адаптера. + self.tri("hardware_timestamp", "Аппаратные временные метки", value.hardware_timestamp) # Автоматический выбор сохраняет прежнее поведение SETGUI. + self.tri("termination", "Встроенный терминатор 120 Ом", value.termination) # Состояние не меняется по умолчанию, поскольку зависит от места адаптера на шине. + self.toggle("bus_errors", "Сообщать ошибки CAN (BERR reporting)", value.bus_errors) # Старые прошивки могут выдавать ошибки постоянно без выключателя. + self.add("sample_point", "Точка выборки номинального бита, %", _number(value.sample_point, 50, 95, decimal=True)) # Используется только при автоматическом расчёте сегментов. + self.add("timing", "Номинальный тайминг", TimingEditor(value.timing)) # Фактическая частота и пределы читаются из устройства при подключении. + + def _fd(self, value): # FD получает самостоятельный путь приёма и передачи, сохраняя Classic-декодеры. + self.toggle("fd", "Разрешить CAN FD — отдельный просмотр и отправка на вкладке диагностики", value.fd) # Переключатель включает настройку быстрой фазы при подключении. + self.add("data_bitrate", "Скорость данных FD, бит/с", _number(value.data_bitrate, 10000, 10000000)) # Верхний предел соответствует диапазону настроек шины приложения. + if self.kind == "candle": # CANable 2.0 предоставляет только Y2/Y5 без ручных сегментов. + self.add("data_sample_point", "Точка выборки FD, %", _number(value.data_sample_point, 50, 95, decimal=True)) # Быстрая фаза имеет отдельную цель выборки. + self.add("data_timing", "Тайминг данных FD", TimingEditor(value.data_timing)) # Пределы DTSEG и DBRP проверяются отдельно от номинальной фазы. + self.fields["fd"].toggled.connect(self._profile_changed) # Быстрая фаза недоступна, пока пользователь не включил FD. + self._profile_changed() # Выставляем начальное состояние всех зависимых полей после построения формы. + + def _profile_changed(self): # Визуально блокируем поля, неприменимые к выбранному семейству прошивки. + lawicel = self.kind == "slcan" and self.fields["profile"].currentData() == "lawicel" # Только этот профиль понимает BTR, Z и аппаратные фильтры M/m. + if self.kind == "slcan": # Candle не использует понятие ASCII-профиля. + for name in ("timestamps", "btr", "acceptance_code", "acceptance_mask"): # Все перечисленные расширения принадлежат диалекту Lawicel. + self.fields[name].setEnabled(lawicel) # Выбранные значения сохраняются визуально, но не включаются в модель другого профиля. + self.fields["retransmit"].setEnabled(not lawicel) # A0/A1 доступны только у CANable. + self.fields["fd"].setEnabled(self.fields["profile"].currentData() == "canable2") # Classic CANable 1.x не имеет расширенных FD-команд. + self.mode.model().item(2).setEnabled(lawicel) # Команда l не документирована у CANable. + enabled = self.fields["fd"].isChecked() and (self.kind == "candle" or self.fields["profile"].currentData() == "canable2") # Зависимые параметры доступны только при включённом совместимом FD. + for name in ("data_bitrate", "data_sample_point", "data_timing"): # Набор зависит от наличия ручных таймингов в текущем семействе. + if name in self.fields: # В SLCAN нет полей процента и сегментов быстрой фазы. + self.fields[name].setEnabled(enabled) # Отключённые значения не должны выглядеть применяемыми прямо сейчас. + + def _diagnostics(self): # Объединяет диагностику, отправку FD и явный переход адаптера в загрузчик USB. + page = QWidget() # Диагностическая вкладка доступна также при заблокированной форме параметров. + layout = QVBoxLayout(page) # Состояние, журнал и отправка FD следуют сверху вниз. + row = QHBoxLayout() # Кнопки диагностики отделены от опасных действий передачи. + read = QPushButton("Прочитать состояние / возможности") # Опрос выполняется только по явному действию пользователя. + read.clicked.connect(self._read_diagnostics) # Не создаём фоновых управляющих USB/COM-запросов. + row.addWidget(read) # Чтение состояния стоит первой доступной операцией. + recover = QPushButton("Восстановить Bus-off") # Кнопка использует только объявленное прошивкой расширение восстановления. + recover.setEnabled(self.kind == "candle" and bool(self.adapter is not None and self.adapter.connected and self.adapter.capabilities is not None and self.adapter.capabilities.feature & 0x40000)) # Не предлагаем неподдерживаемый vendor-запрос. + recover.clicked.connect(self._recover) # Восстановление не выполняется автоматически при появлении ошибки. + row.addWidget(recover) # Действие находится рядом с чтением состояния контроллера. + layout.addLayout(row) # Кнопки не занимают область журнала. + self.dfu_button = QPushButton("Перевести в DFU (USB)", page) # Родитель назначается до setVisible, чтобы кнопка перевода в USB-загрузчик не показывалась отдельным окном при сборке формы. + self.dfu_button.setObjectName("can_adapter_enter_dfu") # Стабильное имя позволяет находить действие в проверках общего окна настроек. + self.dfu_button.setVisible(self.kind == "candle") # Стандартный SLCAN не имеет универсальной команды входа в USB DFU. + self.dfu_button.setEnabled(bool(self.adapter is not None and self.adapter.connected and callable(getattr(self.adapter, "enter_dfu_mode", None)))) # Требует уже выбранного подключённого адаптера и подходящего транспортного API. + self.dfu_button.setToolTip("Остановить CAN-сеанс и перевести CANable 2.5 / weCANdle в загрузчик USB. Для записи выберите соседнюю кнопку «Обновить прошивку по USB…».") # Направляет пользователя к полному сценарию обновления в том же меню. + self.dfu_button.clicked.connect(self._enter_dfu) # Команда выполняется только явным нажатием оператора. + layout.addWidget(self.dfu_button) # Выносит переход в загрузчик в отдельную строку от диагностики CAN. + self.usb_update_button = QPushButton("Обновить прошивку по USB…", page) # Сразу помещаем действие обновления в диагностическую страницу, исключая отдельное окно при раннем setVisible. + self.usb_update_button.setObjectName("can_adapter_update_usb") # Стабильное имя связывает действие меню с проверками интеграции. + self.usb_update_button.setVisible(self.kind == "candle" and self.usb_update_factory is not None) # Стандартный SLCAN не объявляет универсальный USB-загрузчик. + self.usb_update_button.setToolTip("WeAct V1 / STM32G0B1: выбрать BIN, перейти в DFU, записать и проверить прошивку. Прямая запись по USB DFU; для загрузчика нужен драйвер WinUSB.") # Объясняет назначение и зависимость до остановки CAN-сеанса. + self.usb_update_button.clicked.connect(self._open_usb_update) # Окно доступно также для уже отключённого адаптера в DFU. + layout.addWidget(self.usb_update_button) # Новое действие находится рядом с прежней кнопкой перехода в загрузчик. + self.status = QPlainTextEdit() # Диагностический текст доступен для выделения и копирования. + self.status.setReadOnly(True) # Ручное редактирование не должно создавать впечатление изменения состояния адаптера. + self.status.setMaximumHeight(130) # Оставляем основную площадь для полного payload FD. + self.status.setPlainText("Сначала подключите адаптер. Для изменения параметров отключите его и откройте это окно повторно. Запрос F у Lawicel читает флаги и сбрасывает индикатор ошибки.") # Сообщаем о документированном побочном эффекте F до нажатия кнопки. + layout.addWidget(self.status) # Состояние находится выше журнала и отправки данных. + description = QLabel("CAN FD: последние 500 кадров; флаги FD=0x02, BRS=0x04, ESI=0x08. Аппаратная метка — мкс; 0 также используется, если метка недоступна.") # Нулевая метка может быть первым отсчётом или обозначать отсутствие аппаратного времени. + description.setWordWrap(True) # Описание журнала не расширяет диагностическую вкладку за пределы экрана. + layout.addWidget(description) # Единицы и флаги видны непосредственно над журналом кадров. + self.fd_log = ConsoleView(directions=True) # Общая консоль templates предоставляет ограниченную историю, очистку, паузу, поиск и экспорт. + self.fd_log.setReadOnly(True) # Приём не должен смешиваться с ручным вводом сообщений. + self.fd_log.userCleared.connect(self._clear_fd_log) # Очистка удаляет источник снимка, чтобы очередной опрос не вернул старые FD-кадры. + layout.addWidget(self.fd_log.panel) # Контейнер templates сохраняет над журналом общие инструменты просмотра. + send = QFormLayout() # Отправка отдельного FD-кадра не меняет существующий конструктор Classic CAN. + self.fd_id, self.fd_data = QLineEdit("123"), QLineEdit() # ID задаётся в HEX, данные — парами HEX-цифр. + send.addRow("ID (HEX)", self.fd_id) # Явное основание системы счисления исключает неоднозначность ID. + send.addRow("Данные HEX: 0…8, 12, 16, 20, 24, 32, 48, 64 байта", self.fd_data) # Неподдерживаемая длина отклоняется, не дополняется нулями. + layout.addLayout(send) # Поля отправки остаются вне журнала приёма. + row = QHBoxLayout() # Формат ID, BRS и кнопка передачи относятся к одному кадру. + self.fd_ext, self.fd_brs = QCheckBox("EXT (29 бит)"), QCheckBox("BRS — быстрая фаза") # Пользователь явно выбирает формат каждого отправляемого кадра. + self.fd_ext.setChecked(True) # Расширенный формат соответствует обычным протоколам SET. + self.fd_brs.setChecked(True) # BRS использует настроенную скорость данных FD. + row.addWidget(self.fd_ext) # Тип идентификатора находится рядом с отправкой. + row.addWidget(self.fd_brs) # Переключение скорости задаётся независимо от длины сообщения. + send_button = QPushButton("Передать CAN FD") # Кнопка выполняет только одну явную отправку. + send_button.setEnabled(bool(self.adapter is not None and self.adapter.connected and self.adapter.options.fd and not self.adapter._listen_only)) # Пассивный либо Classic-сеанс не допускает передачи FD. + send_button.clicked.connect(self._send_fd) # Настройки формы не передаются в устройство до этого действия. + self._connected_actions = [read, recover, send_button] # Запоминает действия, которые нужно отключить после освобождения CAN-сеанса для DFU. + row.addWidget(send_button) # Передача завершает строку параметров кадра. + layout.addLayout(row) # Действия остаются доступны независимо от количества принятых сообщений. + self.tabs.addTab(page, "Диагностика и CAN FD") # Вкладка имеет одинаковое имя во всех точках подключения. + + def _clear_fd_log(self): # Очищаем только диагностическую историю, сохраняя подключение и счётчики транспорта. + if self.adapter is not None: self.adapter.fd_history.clear() # Следующий снимок адаптера должен начинаться с новых кадров. + self.fd_log.clear() # Программная очистка не эмитирует повторный пользовательский сигнал. + + def _read_diagnostics(self): # Пользовательский опрос работает через публичный транспортный API. + try: # Отказ устройства отображается в самом окне и не разрывает соединение без причины. + self.status.setPlainText(self.adapter.diagnostics() if self.adapter is not None else "Сначала подключите адаптер") # Не создаём соединение при отсутствии выбранного адаптера. + except (RuntimeError, OSError, ValueError) as error: # Неподдерживаемая диагностика не должна приводить к исключению в Qt. + self.status.setPlainText(str(error)) # Сохраняем точную причину USB/COM-отказа. + + def _enter_dfu(self): # Явное действие останавливает обмен и показывает результат перехода в USB-загрузчик. + self.dfu_button.setEnabled(False) # Исключает повторный DETACH при двойном нажатии. + try: # Ошибка USB остаётся в том же окне, где пользователь начал переход. + self.status.setPlainText(self.adapter.enter_dfu_mode().replace("Откройте STM32CubeProgrammer → USB и обновите список устройств.", "Откройте «Обновить прошивку по USB…» и найдите USB-загрузчик.")) # Направляет в прямое обновление SetGUI и сохраняет требование аппаратного переподключения USB. + except (RuntimeError, OSError, ValueError) as error: # Отсутствие интерфейса, старая DLL и отказ прошивки не должны завершать Qt-обработчик исключением. + self.status.setPlainText(str(error)) # Сохраняет реальную причину отказа вместо сообщения об успешной прошивке. + finally: # Состояние действий должно соответствовать фактически оставшемуся CAN-соединению. + self._sync_usb_connection() # Ручной DETACH и полное обновление одинаково отключают старые действия CAN. + + def _sync_usb_connection(self): # Синхронизирует диагностику после остановки транспорта из любого USB-сценария. + connected = bool(self.adapter is not None and self.adapter.connected) # Старая DLL без DFU может оставить прежний сеанс открытым. + self.dfu_button.setEnabled(connected) # Повторный переход доступен только существующему соединению CAN. + if not connected: # Освобождённый WinUSB-handle не должен использоваться диагностикой и отправкой FD. + self.timer.stop() # Прекращает опрос истории завершённого CAN-сеанса. + for action in self._connected_actions: # Отключает все аппаратные действия прежнего сеанса единым правилом. + action.setEnabled(False) # После обновления пользователь создаёт новое подключение штатной панелью. + + def _open_usb_update(self): # Полный сценарий открыт из того же окна, что и прежняя кнопка DFU. + dialog = self.usb_update_factory(self.adapter, self) # Передаёт существующий адаптер без повторного открытия USB. + dialog.transport_stopped.connect(self._sync_usb_connection) # Родитель немедленно узнаёт об освобождении CAN во вложенном окне. + dialog.exec() # Модальный цикл Qt продолжает обрабатывать асинхронные процессы записи и проверки. + self._sync_usb_connection() # Состояние исходной формы остаётся правильным также после ошибки входа в DFU. + dialog.deleteLater() # Освобождает завершённый диалог вместе с журналом и дочерними таймерами. + + def _recover(self): # Восстановление Bus-off вызывается только явным нажатием кнопки. + try: # Поддержка дополнительно проверяется внутри адаптера. + self.adapter.recover_bus_off() # Не подменяем восстановление сбросом всего устройства. + self._read_diagnostics() # Показываем новое состояние после подтверждённого запроса. + except (RuntimeError, OSError) as error: # Физическое отключение во время запроса остаётся видимым оператору. + self.status.setPlainText(str(error)) # Сохраняем причину отказа без закрытия окна. + + def _send_fd(self): # Преобразование текста не меняет скорость или режим существующего соединения. + try: # Ошибочный HEX и отказ транспорта имеют один понятный путь отображения. + self.adapter.send_fd(int(self.fd_id.text().strip(), 16), bytes.fromhex(self.fd_data.text()), extended=self.fd_ext.isChecked(), brs=self.fd_brs.isChecked()) # Проверка длины и аппаратного режима выполняется транспортом. + self.status.setPlainText("Кадр передан в очередь адаптера; это не подтверждение доставки на шине CAN.") # USB-запись и TX echo не являются гарантией ACK получателя. + except (RuntimeError, OSError, ValueError) as error: # Неверный ID либо длина не должны закрывать диагностическую вкладку. + self.status.setPlainText(str(error)) # Сообщение позволяет исправить параметры того же кадра. + + def _refresh_fd(self): # Локальный опрос истории не отправляет никаких управляющих команд на шину. + history = list(self.adapter.fd_history) if self.adapter is not None else [] # Снимок ограничен 500 записями транспорта. + text = "\n".join(f"{direction} {'EXT' if record[2] else 'STD'} {record[0]:08X} [{len(record[1])}] flags=0x{record[3]:02X} t={record[4]} мкс {record[1].hex(' ').upper()}" for direction, record in history) # Сохраняем весь payload и явно указываем направление RX/TX echo/TX queued. + if text != self.fd_log.toPlainText(): # Не сбрасываем выделение и прокрутку, пока новых кадров нет. + self.fd_log.setPlainText(text) # Память виджета ограничена тем же числом записей, что и история адаптера. + + def _defaults(self): # Сброс применяется к форме, не затрагивая сохранённые параметры до OK. + defaults = SlcanOptions() if self.kind == "slcan" else CandleOptions() # Каждый транспорт получает свои безопасные значения по умолчанию. + for name, field in self.fields.items(): # Восстанавливаем все поля, включая временные метки и ручные тайминги. + value = getattr(defaults, name) # dataclass служит единственным источником стандартных значений. + if isinstance(field, QCheckBox): # Логические флаги возвращаются в стандартное состояние. + field.setChecked(value) # Сигналы Qt обновят зависимые поля формы. + elif isinstance(field, QComboBox): # Трёхпозиционные параметры и профиль хранят значение в itemData. + field.setCurrentIndex(next(i for i in range(field.count()) if field.itemData(i) == value)) # None означает не менять аппаратное состояние. + elif isinstance(field, QLineEdit): # HEX-поля очищаются, чтобы не записывать регистры без необходимости. + field.setText("" if value is None else str(value)) # Пустой BTR возвращает стандартные команды Sn. + elif isinstance(field, TimingEditor): # Ручные числа перестают использоваться после выключения флажка. + field.manual.setChecked(False) # Автоматический расчёт снова использует реальные аппаратные пределы. + else: # Числовые поля восстанавливают тайм-ауты, проценты и скорости. + field.setValue(value) # Значения модели уже находятся внутри диапазонов интерфейса. + self.mode.setCurrentIndex(0) # Стандарт модели — активный режим; существующий флажок изменится только после OK. + self._profile_changed() # Окончательно согласуем доступность полей после всех сигналов восстановления. + + def accept(self): # Проверка формы предшествует сохранению QSettings и изменению флажка режима. + if not self.page.isEnabled(): # В рабочем соединении окно выполняет только диагностику. + self.result_options, self.result_listen_only = self.original, self.original_listen_only # Заблокированная форма не меняет ни модель, ни внешний флажок активного соединения. + super().accept() # Завершаем окно без повторной конфигурации аппаратуры. + return # Поля невалидируемого неактивного профиля не мешают закрыть диагностику. + try: # Все ошибки ввода отображаются без потери редактируемых значений. + values = {} # Собираем только поля текущего транспорта. + for name, field in self.fields.items(): # Каждое значение извлекается через штатный API виджета. + if isinstance(field, QCheckBox): # Bool-поля не используют трёхпозиционный режим Qt. + values[name] = field.isChecked() # Приводим к обычному bool для JSON и dataclass. + elif isinstance(field, QComboBox): # Профиль и явное/автоматическое состояние имеют типизированные itemData. + values[name] = field.currentData() # Русские подписи не попадают в протокол настройки. + elif isinstance(field, QLineEdit): # Текстовые поля содержат BTR либо 32-битные фильтры. + raw = field.text().strip() # Пробелы по краям не относятся к содержимому регистра. + if name.startswith("acceptance_"): # Код и маска фильтра передаются строго по восемь HEX-цифр. + if raw and (len(raw) != 8 or any(c not in "0123456789abcdefABCDEF" for c in raw)): # Исключаем неоднозначный неполный регистр и знаки числа. + raise ValueError("Код и маска фильтра должны содержать по 8 HEX-цифр") # Пользователь исправляет ввод до сохранения. + values[name] = int(raw, 16) if raw else None # Пустое поле не меняет аппаратное состояние. + else: # BTR остаётся строкой из четырёх HEX-цифр и проверяется общей моделью. + values[name] = raw # Не применяем десятичное преобразование к регистрам SJA1000. + else: # Спинбоксы и TimingEditor предоставляют согласованный метод value. + values[name] = field.value() # Ручной тайминг возвращается как CanTiming либо None. + values["loopback"] = self.mode.currentData() in ("loopback", "silent_loopback") # Оба варианта самопроверки задают один флаг LOOP_BACK в модели. + if self.kind == "slcan": # Не переносим скрытые значения между несовместимыми диалектами. + lawicel = values["profile"] == "lawicel" # Список команд определяется выбранным профилем. + for name in ("timestamps", "acceptance_code", "acceptance_mask", "btr"): # Эти поля принадлежат только Lawicel. + if not lawicel: # Смена профиля не должна отправлять старый фильтр как команду режима CANable. + values[name] = "" if name == "btr" else None # Сбрасываем неприменимые настройки в новой модели. + if lawicel: # Lawicel не документирует CANable A0/A1. + values["retransmit"] = None # Не отправляем букву A с чужой семантикой. + values["fd"] = values["fd"] and values["profile"] == "canable2" # FD включается только для документированного расширения CANable 2.0. + if values["loopback"] and not lawicel: # Программное изменение индекса также не должно обходить ограничение GUI. + raise ValueError("Loopback доступен только для совместимых прошивок Lawicel") # Не подменяем выбранный режим активным подключением. + if values["fd"] and values["data_bitrate"] not in (2000000, 5000000): # Y2/Y5 — единственные скорости данных данного профиля. + raise ValueError("CANable 2.0 поддерживает FD data bitrate 2 000 000 или 5 000 000 бит/с") # Отклоняем ошибку до закрытия окна настроек. + self.result_options = (SlcanOptions if self.kind == "slcan" else CandleOptions)(**values) # Неизменяемая модель передаётся транспортам без зависимости от формы. + self.result_listen_only = self.mode.currentData() in ("listen", "silent_loopback") # Пассивная самопроверка сохраняет LISTEN_ONLY вместе с LOOP_BACK. + if self.kind == "slcan": # Полный план проверяет парность фильтров, BTR, скорость Sn и совместимость расширений. + self.result_options.commands(self.bitrate, self.result_listen_only) # Не сохраняем конфигурацию, которую транспорт заведомо не сможет применить. + except (ValueError, TypeError) as error: # Ошибка не должна сохранять половину настроек или закрывать редактор. + QMessageBox.warning(self, "Настройки CAN", str(error)) # Показываем причину рядом с редактируемыми полями. + return # Пользователь продолжает исправлять текущую конфигурацию. + super().accept() # Только проверенные значения становятся результатом диалога. + + +class CanAdapterSettingsButton(QPushButton): # Общая кнопка минимально увеличивает существующие панели подключения. + dialog_class = AdapterSettingsDialog # Потребитель может расширить диалог интеграцией USB без копирования редактора. + + def __init__(self, kind_provider, listen_checkbox, adapter_provider, storage_key, parent=None, bitrate_provider=None): # Функции доступа читают текущий выбор без создания лишних соединений. + super().__init__("Настройки адаптера…", parent) # Одинаковая подпись помогает найти расширения на любой вкладке. + self.kind_provider, self.listen_checkbox, self.adapter_provider = kind_provider, listen_checkbox, adapter_provider # Родитель продолжает владеть портом и жизненным циклом сеанса. + self.storage_key = storage_key # Разные панели сохраняют собственные параметры и не меняют соседний активный сеанс. + self.bitrate_provider = bitrate_provider or (lambda: 500000) # Текущая скорость проверяется только при явном открытии редактора. + if QSettings().contains(f"{storage_key}/listen_only"): # При первом запуске сохраняем исходный режим панели, включая пассивный снифер. + listen_checkbox.setChecked(QSettings().value(f"{storage_key}/listen_only", False, type=bool)) # Явный выбор режима в диалоге восстанавливается при следующем запуске приложения. + self.values = {"slcan": SlcanOptions(), "candle": CandleOptions()} # Значения по умолчанию сохраняют прежнее поведение подключения. + for kind, model in (("slcan", SlcanOptions), ("candle", CandleOptions)): # У каждого семейства свой набор полей и независимая сохранённая модель. + try: # Повреждённые либо устаревшие настройки не должны мешать запуску приложения. + data = json.loads(QSettings().value(f"{storage_key}/{kind}", "{}")) # JSON хранится в стандартном хранилище настроек SETGUI. + for name in ("timing", "data_timing"): # Вложенные словари восстанавливаются в типизированные модели тайминга. + if data.get(name) is not None: # None означает автоматический расчёт и не требует преобразования. + data[name] = CanTiming(**data[name]) # Имена полей проверяются конструктором dataclass. + self.values[kind] = model(**data) # Старые неизвестные поля не применяются частично. + except (ValueError, TypeError): # При несовместимом сохранении используем полный стандартный профиль. + self.values[kind] = model() # Обычный запуск не должен выполнять произвольные команды из повреждённых данных. + self.clicked.connect(self.open_settings) # Диалог создаётся только при явном открытии пользователем. + + def options_for(self, kind): # Возвращаем расширения только при отличии от прежней конфигурации. + value = self.values[kind] # Параметры другого семейства не попадают в транспорт выбранного канала. + return None if value == (SlcanOptions() if kind == "slcan" else CandleOptions()) else value # None сохраняет совместимость существующих обработчиков и тестовых транспортов. + + def open_settings(self): # Открытие окна не выполняет USB/COM-запросов и не меняет текущий канал. + kind = self.kind_provider() or "candle" # До выбора типа используем стандартный WinUSB-профиль. + adapter = self.adapter_provider(kind) # Получаем существующий адаптер только для чтения состояния подключённого сеанса. + try: # Редактируемая строка скорости может временно содержать незавершённое число. + bitrate = int(self.bitrate_provider()) # Используем выбранную панелью скорость при проверке BTR и Sn. + except (ValueError, TypeError): # Неверная скорость должна быть исправлена до создания конфигурации адаптера. + QMessageBox.warning(self, "Настройки CAN", "Сначала укажите числовую скорость CAN в панели подключения") # Не подменяем ошибочный ввод стандартной скоростью. + return # Сохраняем существующую модель и режим без изменений. + dialog = self.dialog_class(kind, self.values[kind], self.listen_checkbox.isChecked(), adapter, self, bitrate=bitrate) # Отдельная форма редактирует копию параметров и знает фактическую скорость панели. + try: # Таймер и дочерние объекты должны освобождаться при любом закрытии окна. + if dialog.exec() == QDialog.DialogCode.Accepted: # Отмена оставляет настройки и флажок режима неизменными. + self.values[kind] = dialog.result_options # Сохраняем только полную проверенную модель. + self.listen_checkbox.setChecked(dialog.result_listen_only) # Режим синхронизируется с существующей панелью подключения. + QSettings().setValue(f"{self.storage_key}/{kind}", json.dumps(asdict(dialog.result_options), ensure_ascii=False)) # Сериализация сохраняет Unicode и вложенные тайминги. + QSettings().setValue(f"{self.storage_key}/listen_only", dialog.result_listen_only) # Пассивный режим сохраняется вместе с параметрами, а не только внутри текущего виджета. + finally: # Закрытое окно не должно продолжать обновлять скрытый FD-журнал. + dialog.timer.stop() # Прекращаем локальный опрос истории до отложенного удаления Qt. + dialog.deleteLater() # Освобождаем виджеты в штатном цикле событий Qt.