From e627d088e0ab5f92b7c7d7b430c9ef3392370b80 Mon Sep 17 00:00:00 2001 From: Andrey Date: Mon, 16 Nov 2026 18:20:19 +0300 Subject: [PATCH] =?UTF-8?q?=D0=A0=D0=B0=D0=B7=D0=B4=D0=B5=D0=BB=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20USB=20=D0=B8=D0=B4=D0=B5=D0=BD=D1=82=D0=B8=D1=87?= =?UTF-8?q?=D0=BD=D0=BE=D1=81=D1=82=D1=8C=20USART=20=D0=B8=20CAN=20=D0=B0?= =?UTF-8?q?=D0=B4=D0=B0=D0=BF=D1=82=D0=B5=D1=80=D0=BE=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 2 ++ c/uart-usb/README.md | 5 ++++- c/uart-usb/ports/windows/uart_usb_winusb.c | 8 +++++--- 3 files changed, 11 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 47ce767..7c9c6e2 100644 --- a/README.md +++ b/README.md @@ -38,6 +38,8 @@ templates/ ### C +USART STM32G474 → USB и терминал четырёх каналов: [`c/uart-usb`](c/uart-usb/README.md). + | Библиотека | Что делает | Зависимости | Что нужно от платформы | |---|---|---|---| | [`c/st7789`](c/st7789) | TFT ST7789V по SPI, RGB565, текст без кадрового буфера | `stdint.h` | SPI-запись, линия DC, задержка | diff --git a/c/uart-usb/README.md b/c/uart-usb/README.md index 0e0283c..db1509c 100644 --- a/c/uart-usb/README.md +++ b/c/uart-usb/README.md @@ -60,7 +60,10 @@ callbacks. `UB_BUSY` гарантирует отсутствие побочно USB interface 2: class `FF`, subclass `55`, protocol `01`, bulk IN `83`, bulk OUT `03`, max packet 64. CAN и DFU сохраняют номера 0 и 1. -Windows получает WinUSB и стандартный GUID gs_usb через Microsoft OS 1.0. +Windows получает WinUSB через Microsoft OS 1.0. USART использует отдельный GUID +`{8a650f40-8fb3-49b5-a067-5b2494740001}`, чтобы CAN-клиенты gs_usb не считали +новый интерфейс ещё одним CAN-адаптером. Ревизия USB bcdDevice=0x0001 обновляет +кэш состава интерфейсов Windows после прошивки; переподключите кабель USB. Запись: `A7 | (type << 4) OR channel | length_lo | length_hi | payload`. Payload 0…60 байт, длина little-endian. Данные не экранируются; diff --git a/c/uart-usb/ports/windows/uart_usb_winusb.c b/c/uart-usb/ports/windows/uart_usb_winusb.c index ee952ac..427115e 100644 --- a/c/uart-usb/ports/windows/uart_usb_winusb.c +++ b/c/uart-usb/ports/windows/uart_usb_winusb.c @@ -6,23 +6,25 @@ #include /* Копирует завершённые USB-пакеты в буфер Python-клиента. */ #include "uart_usb.h" /* Экспортирует Windows транспорт рядом с единственным C-кодеком протокола. */ #define USB_READS 16U /* Держит шестнадцать запросов IN одновременно, исключая паузы между вызовами Python. */ -static const GUID interface_guid = {0xc15b4308, 0x04d3, 0x11e6, {0xb3, 0xea, 0x60, 0x57, 0x18, 0x9e, 0x64, 0x43}}; /* Совпадает со стандартным gs_usb GUID из Microsoft OS дескриптора прошивки. */ +static const GUID interface_guid = {0x8a650f40, 0x8fb3, 0x49b5, {0xa0, 0x67, 0x5b, 0x24, 0x94, 0x74, 0x00, 0x01}}; /* Собственный UUID USART совпадает с интерфейсом 2 прошивки и исключает перечисление моста CAN-клиентами gs_usb. */ typedef struct { OVERLAPPED io; uint8_t bytes[64]; uint8_t queued; } usb_read; /* Каждый запрос владеет событием, буфером USB FS и флагом фактической постановки I/O. */ typedef struct { HANDLE file; WINUSB_INTERFACE_HANDLE usb; usb_read reads[USB_READS]; unsigned next; } usb_context; /* Хранит все ресурсы одной выбранной USB-сессии, не затрагивая CAN handle. */ UB_API int ub_usb_paths(wchar_t *out, uint32_t capacity) { /* Возвращает список путей интерфейса 2 как MULTI_SZ с двойным завершающим нулём. */ + if (!out || capacity < 2U) return -1; /* Проверяет выходной буфер до выделения системного SetupDi списка, исключая утечку handle. */ HDEVINFO devices = SetupDiGetClassDevsW(&interface_guid, NULL, NULL, DIGCF_PRESENT | DIGCF_DEVICEINTERFACE); /* Перечисляет только подключённые WinUSB интерфейсы данного семейства. */ uint32_t used = 0U; /* Считает записанные wchar_t, а не байты, для совместимости x86/x64. */ - if (!out || capacity < 2U || devices == INVALID_HANDLE_VALUE) return -1; /* Не записывает список при неверном буфере или отказе SetupDi. */ + if (devices == INVALID_HANDLE_VALUE) return -1; /* Не использует системный список после отказа SetupDi. */ out[0] = out[1] = 0; /* Возвращает корректный пустой MULTI_SZ при отсутствии устройств. */ for (DWORD index = 0U;; ++index) { /* Обходит каждый опубликованный интерфейс независимо от физического CAN-порта. */ SP_DEVICE_INTERFACE_DATA item = {0}; item.cbSize = sizeof(item); /* Задаёт размер структуры SetupDi для текущей разрядности процесса. */ if (!SetupDiEnumDeviceInterfaces(devices, NULL, &interface_guid, index, &item)) break; /* Завершает перечисление после последнего доступного интерфейса. */ DWORD needed = 0U; /* Получает точный размер переменной структуры с DevicePath. */ SetupDiGetDeviceInterfaceDetailW(devices, &item, NULL, 0U, &needed, NULL); /* Запрашивает размер без фиксированного ограничения длины системного пути. */ + if (needed < sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA_W)) continue; /* Устройство могло отключиться между перечислением и запросом размера; не пишет cbSize в нулевой malloc. */ PSP_DEVICE_INTERFACE_DETAIL_DATA_W detail = (PSP_DEVICE_INTERFACE_DETAIL_DATA_W)malloc(needed); /* Выделяет временную память в Windows-порту для пути устройства. */ if (!detail) { SetupDiDestroyDeviceInfoList(devices); return -1; } /* Освобождает SetupDi список при нехватке памяти. */ detail->cbSize = sizeof(*detail); /* Использует правильный размер структуры для ABI текущей Windows. */ - if (SetupDiGetDeviceInterfaceDetailW(devices, &item, detail, needed, NULL, NULL) && wcsstr(detail->DevicePath, L"&mi_02")) { /* Отбирает отдельный USART-интерфейс 2, исключая CAN и DFU. */ + if (SetupDiGetDeviceInterfaceDetailW(devices, &item, detail, needed, NULL, NULL)) { /* Собственный GUID уже выделяет USART; номер интерфейса дополнительно проверяется при open независимо от регистра DevicePath. */ uint32_t count = (uint32_t)wcslen(detail->DevicePath) + 1U; /* Учитывает завершающий ноль каждого системного пути. */ if (used + count + 1U > capacity) { free(detail); SetupDiDestroyDeviceInfoList(devices); return -2; } /* Явно сообщает недостаточную ёмкость, не возвращая обрезанный путь. */ memcpy(out + used, detail->DevicePath, count * sizeof(wchar_t)); used += count; out[used] = 0; /* Добавляет путь и сохраняет двойное завершение MULTI_SZ. */