基于RT-Thread與MCXA156的USB HID游戲手柄設計與實現 | 技術集結

#define RT_THREAD_PRIORITY_MAX  32      // 32 級優先級#define RT_TICK_PER_SECOND      1000    // 1ms 系統節拍#define RT_USING_TIMER_SOFT             // 軟件定時器#define RT_USING_SEMAPHORE              // 信號量#define RT_USING_MUTEX                  // 互斥鎖#define RT_USING_MAILBOX                // 郵箱

INIT_BOARD_EXPORT(rt_hw_adc_init);      // ADC 驅動初始化INIT_DEVICE_EXPORT(key_init);            // 矩陣鍵盤初始化INIT_DEVICE_EXPORT(joystick_init);       // 搖桿初始化INIT_COMPONENT_EXPORT(cherryusb_init);   // USB 初始化INIT_APP_EXPORT(gamepad_app_start);      // 應用層啟動

┌─────────────────────────────────────────────────────────────┐│                      FRDM-MCXA156                           ││  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ ││  │  4x4 矩陣   │  │  雙搖桿模塊  │  │     USB Device      │ ││  │   鍵盤      │  │  (帶按鍵)    │  │    (Full Speed)     │ ││  └──────┬──────┘  └──────┬──────┘  └──────────┬──────────┘ ││         │                │                     │            ││    GPIO P2/P3       ADC0 CH0/1/8/13           USB0         ││         │                │                     │            ││  ┌──────┴────────────────┴─────────────────────┴──────────┐││  │                    MCXA156 MCU                          │││  │              (Cortex-M33 @ 96MHz)                       │││  └─────────────────────────────────────────────────────────┘│└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐│                      應用層 (Application)                    ││  ┌─────────────────────────────────────────────────────────┐││  │                   gamepad_app.c                         │││  │         (整合輸入設備，映射到 USB HID 報告)              │││  └─────────────────────────────────────────────────────────┘│├─────────────────────────────────────────────────────────────┤│                      功能層 (Function)                       ││  ┌───────────────┐  ┌───────────────┐  ┌─────────────────┐ ││  │  key_app.c    │  │ joystick_app.c│  │   usb_app.c     │ ││  │  (矩陣鍵盤)   │  │   (雙搖桿)    │  │  (USB HID)      │ ││  └───────────────┘  └───────────────┘  └─────────────────┘ │├─────────────────────────────────────────────────────────────┤│                      驅動層 (Driver)                         ││  ┌───────────────┐  ┌───────────────┐  ┌─────────────────┐ ││  │   drv_pin.c   │  │   drv_adc.c   │  │   CherryUSB     │ ││  │   (GPIO)      │  │   (ADC)       │  │   (USB Stack)   │ ││  └───────────────┘  └───────────────┘  └─────────────────┘ │├─────────────────────────────────────────────────────────────┤│                      RT-Thread 內核                          ││         (線程調度、IPC、設備框架、自動初始化)                │├─────────────────────────────────────────────────────────────┤│                      硬件抽象層 (HAL)                        ││                   NXP MCX SDK / CMSIS                        │└─────────────────────────────────────────────────────────────┘

矩陣鍵盤 ──? key_read() ──────────────────────────────────┐                                                           │左搖桿 ADC ──? joystick_left_read() ──? apply_deadzone() ──┤                                                           ├──? gamepad_thread右搖桿 ADC ──? joystick_right_read() ──? apply_deadzone() ──┤     │                                                           │     ▼搖桿按鍵 ──? rt_pin_read() ────────────────────────────────┘  scale_axis()                                                                  │                                                                  ▼                                                           USB HID Report                                                                  │                                                                  ▼                                                        hid_gamepad_send_report()                                                                  │                                                                  ▼                                                              USB Host(PC)

rt_uint8_tkey_read(void);  // 返回 0-15 表示按鍵索引，0xFF 表示無按鍵

typedefstruct {    int16_t x;      // X軸: -32768 ~ 32767    int16_t y;      // Y軸: -32768 ~ 32767    bool btn;       // 按鍵: true=按下} joystick_data_t;

rt_err_tjoystick_left_read(joystick_data_t *data);rt_err_tjoystick_right_read(joystick_data_t *data);

typedefstruct __attribute__((packed)) {    uint16_t buttons;      // 16 個按鈕    int8_t left_x;         // 左搖桿 X (-127 ~ 127)    int8_t left_y;         // 左搖桿 Y    int8_t right_x;        // 右搖桿 X    int8_t right_y;        // 右搖桿 Y    uint8_t left_trigger;  // 左扳機 (0-255)    uint8_t right_trigger; // 右扳機 (0-255)    uint8_t hat;           // 方向鍵 (0-8)} usb_gamepad_report_t;

KEY OKjoystick: init OK[USB] Initializing HID Gamepad...[USB] HID Gamepad initialized successfully[USB] VID:0x045E PID:0x02FF[GAMEPAD] Started (interval: 10ms)System Start[GAMEPAD] Thread started[USB] Device Configured - Gamepad Ready!

applications/├── main.c              # 主入口├── gamepad_app.c/h     # 游戲手柄應用層├── key_app.c/h         # 矩陣鍵盤模塊├── joystick_app.c/h    # 搖桿模塊└── usb_app.c/h         # USB HID 模塊board/├── MCUX_Config/board/pin_mux.c  # 引腳配置└── ports/cherryusb/             # CherryUSB 適配Libraries/drivers/└── drv_adc.c           # ADC 驅動（已修改）