Разделить USB идентичность USART и CAN адаптеров
This commit is contained in:
@@ -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, задержка |
|
||||
|
||||
@@ -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. Данные не экранируются;
|
||||
|
||||
@@ -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. */
|
||||
|
||||
Reference in New Issue
Block a user