AtguiguCorp/0417_QT_code
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Push layered Qt host source files

Browse Source
This commit is contained in:
stli
2026-04-17 16:25:19 +08:00
parent b576d3f19d
commit 89b23b2291
58 changed files with 10349 additions and 2461 deletions
Download Patch File Download Diff File Expand all files Collapse all files

67
MID/Mid_Def.h
View File

@@ -1,86 +1,81 @@
#pragma once
#pragma once
#include <QtCore/QByteArray>
#include <QtCore/QString>
#include <QtCore/QStringList>
#include <QtCore/QVector>
/*
* MID 层公共定义：设备配置、匹配条件、HID 报文常量等都集中于此。
* 高密注释放在每个结构/函数附近，方便教学时直接引用。
*/
// Shared protocol constants and raw packet definitions.
/* HID 报文 ID：用于区分 NKRO、Consumer、Vendor */
enum Mid_Enum_ReportId : quint8
{
Mid_Enum_ReportId_None = 0x00,
Mid_Enum_ReportId_Nkro = 0x01,
Mid_Enum_ReportId_Consumer = 0x03,
Mid_Enum_ReportId_Vendor = 0x04
Mid_Enum_ReportId_Vendor = 0x04,
Mid_Enum_ReportId_VendorCommand = 0x05
};
enum Mid_Enum_RawPacketSource : quint8
{
Mid_Enum_RawPacketSource_None = 0,
Mid_Enum_RawPacketSource_UsbNkroRaw,
Mid_Enum_RawPacketSource_UsbConsumerHid,
Mid_Enum_RawPacketSource_UsbVendorHid,
Mid_Enum_RawPacketSource_BleGatt,
Mid_Enum_RawPacketSource_BleHidKeyboard,
Mid_Enum_RawPacketSource_BleHidConsumer,
Mid_Enum_RawPacketSource_BleHidVendor,
Mid_Enum_RawPacketSource_BleHidVendorCommand
};
/* 默认 VID/PID：教学用固件的 USB 身份 */
const quint16 MID_CONST_VENDOR_ID_DEFAULT = 0x1209;
const quint16 MID_CONST_PRODUCT_ID_DEFAULT = 0x0001;
/* 上位机配置：允许 UI 快速切换 VID/PID */
struct Mid_Struct_DeviceConfig
{
quint16 VendorId = MID_CONST_VENDOR_ID_DEFAULT;
quint16 ProductId = MID_CONST_PRODUCT_ID_DEFAULT;
};
/* 匹配条件：Win32 SetupAPI + HidP_Caps 的输入结构 */
struct Mid_Struct_DeviceMatch
{
quint16 VendorId = 0;
quint16 ProductId = 0;
quint16 UsagePage = 0;
quint16 Usage = 0;
QString Name;
};
/* 统一的“原始包”封装：记录来源端口与字节内容 */
struct Mid_Struct_RawPacket
{
bool IsValid = false;
Mid_Enum_RawPacketSource Source = Mid_Enum_RawPacketSource_None;
QByteArray ByteArray;
QString PortName;
};
/* Vendor 状态：逻辑层解析后的结果（Modifier + Usage 列表） */
struct Mid_Struct_VendorState
{
bool IsValid = false;
quint8 Modifier = 0;
QByteArray UsageBitmap;
QVector<quint16> UsageList;
QStringList UsageTextList;
};
const quint16 MID_CONST_USAGE_PAGE_NKRO = 0x0001;
const quint16 MID_CONST_USAGE_NKRO = 0x0006;
const quint16 MID_CONST_USAGE_PAGE_CONSUMER = 0x000C;
const quint16 MID_CONST_USAGE_CONSUMER = 0x0001;
const quint16 MID_CONST_USAGE_PAGE_VENDOR = 0xFF00;
const quint16 MID_CONST_USAGE_VENDOR = 0x0002;
const quint16 MID_CONST_USAGE_PAGE_VENDOR_COMMAND = 0xFF01;
const quint16 MID_CONST_USAGE_VENDOR_COMMAND = 0x0005;
const int MID_CONST_KEYBOARD_USAGE_MAX = 0x00E7;
const int MID_CONST_USAGE_BITMAP_SIZE = 29;
const int MID_CONST_PACKET_SIZE_NKRO = 31;
const int MID_CONST_PACKET_SIZE_VENDOR = 31;
const int MID_CONST_PACKET_SIZE_VENDOR_COMMAND = 10;
const int MID_CONST_PACKET_SIZE_VENDOR_COMMAND_DATA = 8;
const int MID_CONST_PACKET_SIZE_CONSUMER = 3;
/* 设备匹配函数：针对 NKRO / Consumer / Vendor */
Mid_Struct_DeviceMatch Mid_Func_GetNkroMatch(const Mid_Struct_DeviceConfig& DeviceConfig);
Mid_Struct_DeviceMatch Mid_Func_GetConsumerMatch(const Mid_Struct_DeviceConfig& DeviceConfig);
Mid_Struct_DeviceMatch Mid_Func_GetVendorMatch(const Mid_Struct_DeviceConfig& DeviceConfig);
/* HID 接口枚举 & 辅助文本转换 */
bool Mid_Func_FindHidInterface(
bool Mid_FindHidInterface(
const Mid_Struct_DeviceMatch& Match,
QString* p_DevicePath,
quint16* p_InputLength,
quint16* p_OutputLength);
QString Mid_Func_GetHexText(const QByteArray& ByteArray);
QString Mid_Func_GetModifierText(quint8 Modifier);
QString Mid_Func_GetKeyboardUsageText(quint16 Usage);
QString Mid_Func_GetConsumerUsageText(quint16 Usage);
quint16* p_OutputLength,
QString* p_DeviceInstanceId = nullptr);
bool Mid_IsBluetoothHidInstanceId(const QString& DeviceInstanceId);
QString Mid_GetHexText(const QByteArray& ByteArray);
QString Mid_GetModifierText(quint8 Modifier);
QString Mid_GetKeyboardUsageText(quint16 Usage);
QString Mid_GetConsumerUsageText(quint16 Usage);