Разделить USB идентичность USART и CAN адаптеров

This commit is contained in:
2026-11-16 18:20:19 +03:00
parent 34d9016118
commit e627d088e0
3 changed files with 11 additions and 4 deletions
+2
View File
@@ -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, задержка |
+4 -1
View File
@@ -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. Данные не экранируются;
+5 -3
View File
@@ -6,23 +6,25 @@
#include <string.h> /* Копирует завершённые 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. */