《ESP32-P4开发指南— V1.0》第四十八章 USB鼠标（Host）实验

正点原子运营

第四十八章 USB鼠标（Host）实验

1）实验平台：正点原子DNESP32P4开发板

2）章节摘自【正点原子】ESP32-P4开发指南— V1.0

3）购买链接：https://detail.tmall.com/item.htm?id=873309579825

4）全套实验源码+手册+视频下载地址：http://www.openedv.com/docs/boards/esp32/ATK-DNESP32P4.html

5）正点原子官方B站：https://space.bilibili.com/394620890

6）正点原子DNESP32S3开发板技术交流群：132780729





本章我们介绍如何使用ESP32-P4的USB HOST来驱动USB鼠标。
本章分为如下几个部分：
48.1 USB鼠标键盘简介
48.2 硬件设计
48.3 程序设计
48.4 下载验证

48.1 USB鼠标键盘简介
传统的鼠标是采用PS/2接口和电脑通信的，但是现在PS/2接口在电脑上逐渐消失，所以现在越来越多的鼠标采用的是USB接口，而不是PS/2接口的了。
USB鼠标属于USB HID设备。USB HID即：Human Interface Device（人机交互设备）的缩写，键盘、鼠标与游戏杆等都属于此类设备。不过HID设备并不一定要有人机接口，只要符合HID类别规范的设备都是HID设备。关于USB HID的知识，我们这里就不详细介绍了，请大家自行百度学习。
ESP32-P4的USB OTG HS接口是支持鼠标功能的。Espressif官方在ESP-IDF中提供了针对USB HOST HID人机交互的示例代码，路径为：esp-idf\examples\peripherals\usb\host\hid。本章实验将参考官方示例代码，通过ESP32-P4的USB HOST接口实现对鼠标设备操作。

48.2 硬件设计

48.2.1 程序功能
本实验代码，开机的时候先显示一些提示信息，然后初始化USB HOST，并不断轮询。当检测到USB鼠标的插入后，PC机通过USB接口将显示鼠标移动的坐标（X，Y坐标）和左右按键的状态发送至DNSP32P4开发板，然后把这些数据显示在LCD上。

48.2.2 硬件资源
1）RGBLCD/MIPILCD（引脚太多，不罗列出来）
2）USB_HOST HS接口
3）本实验接入的是小米蓝牙鼠标无线双模静音版鼠标

48.2.3 原理图
USB HOST原理图已在47.2.3小节中详细阐述，为避免重复，此处不再赘述。

48.3 程序设计

48.3.1 USB HOST HID的IDF驱动
usb_host_hid组件驱动位于ESP-IDF在线组件注册表中。如果需要将该组件添加到项目工程中，可按照以下步骤操作：
1）打开ESP-IDF注册表。
2）搜索 “usb_host_hid”组件。
3）将组件安装到项目中。
组件安装完成后，系统会自动更新main文件夹中的特殊组件清单文件idf_component.yml在项目编译时，系统会根据清单文件从注册表中下载并集成该组件到工程中。关于上述操作流程，可参考本书籍第八章的内容。
为了使用 usb_host_hid组件提供的功能，首先需要在代码中导入以下头文件：

1. #include "usb/usb_host.h"
   
2. #include "usb/hid_host.h"
   
3. #include "usb/hid_usage_mouse.h"

复制代码

接下来，作者将本章节实验用到的usb_host_hid函数，这些函数的描述及其作用如下：
1，安装USB HID主机的USB Host HID类驱动hid_host_install
该函数用于安装 USB HID 主机的 USB Host HID 类驱动，其函数原型如下：

1. esp_err_t hid_host_install(const hid_host_driver_config_t *config);

复制代码

函数形参：

表48.3.1.1 hid_host_install函数形参描述

返回值：
ESP_OK表示配置成功。
其他错误码表示配置失败。
config为指向USB Host HID 类驱动的配置结构体。接下来，笔者将详细介绍hid_host_driver_config_t结构体中的各个成员变量，如下代码所示：

1. /**
   
2. * @brief HID 配置结构体
   
3. */
   
4. typedef struct {
   
5. /* 当设置为 true 时，将创建一个处理 USB 事件的后台任务。*/
   
6.     bool create_background_task;        
   
7.     size_t task_priority;                           /* 创建的后台任务的任务优先级 */
   
8.     size_t stack_size;                              /* 创建的后台任务的堆栈大小 */
   
9.     BaseType_t core_id;        /* 选择后台任务运行的核心或 tskNO_AFFINITY */
   
10.     hid_host_driver_event_cb_t callback;/* HID驱动事件发生时调用的回调函数,不能为空 */
    
11.     void *callback_arg;                                  /* 用户提供的参数，将传递给回调函数 */
    
12. } hid_host_driver_config_t;

复制代码

上述结构体用于传递USB Host HID 类配置参数，以下对各个成员做简单介绍。
1）create_background_task：
若此字段设置为true，则创建USB事件后台任务。
2）task_priority：
设置USB事件后台任务优先级。
3）stack_size：
设置USB事件后台任务堆栈大小。
4）core_id：
将USB事件任务运行在哪个内核。
5）callback
USB事件任务调用此函数。
6）callback_arg
回调函数的传入形参。
2，获取HID设备参数hid_host_device_get_params
该函数用于获取HID设备参数，其函数原型如下：

1. esp_err_t hid_host_device_get_params(hid_host_device_handle_t hid_dev_handle,
   
2.                                      hid_host_dev_params_t *dev_params);

复制代码

函数形参：

表48.3.1.2 hid_host_device_get_params函数形参描述

返回值：
ESP_OK表示获取信息成功。
其他错误码表示获取信息失败。
3，打开USB HID主机设备hid_host_device_open
该函数用于打开USB HID主机设备，其函数原型如下：

1. esp_err_t hid_host_device_open(hid_host_device_handle_t hid_dev_handle,
   
2.                                const hid_host_device_config_t *config);

复制代码

函数形参：

表48.3.1.3 hid_host_device_open函数形参描述

返回值：
ESP_OK表示打开设备成功。
其他错误码表示打开设备失败。
4，设置HID请求协议hid_class_request_set_protocol
该函数用于设置HID请求协议，其函数原型如下：

1. esp_err_t hid_class_request_set_protocol(
   
2. hid_host_device_handle_t hid_dev_handle,
   
3.                                         hid_report_protocol_t protocol);

复制代码

函数形参：

表48.3.1.4 hid_class_request_set_protocol函数形参描述

返回值：
ESP_OK表示设置协议成功。
其他错误码表示设置协议失败。
5，设置HID请求协议的空闲时间hid_class_request_set_idle
该函数用于设置HID请求协议的空闲时间，其函数原型如下：

1. esp_err_t hid_class_request_set_idle(hid_host_device_handle_t hid_dev_handle,
   
2.                                      uint8_t duration,
   
3.                                      uint8_t report_id);

复制代码

函数形参：

表48.3.1.5 hid_class_request_set_idle函数形参描述

返回值：
ESP_OK表示设置协议空闲时间成功。
其他错误码表示设置协议空闲时间失败。
6，启动HID设备hid_host_device_start
该函数用于启动HID设备，其函数原型如下：

1. esp_err_t hid_host_device_start(hid_host_device_handle_t hid_dev_handle);

复制代码

函数形参：

表48.3.1.6 hid_host_device_start函数形参描述

返回值：
ESP_OK表示启动HID设备成功。
其他错误码表示启动HID设备失败。
7，获取设备的原始输入报告数据hid_host_device_get_raw_input_report_data
该函数用于获取设备的原始输入报告数据，其函数原型如下：

1. esp_err_t hid_host_device_get_raw_input_report_data(
   
2. hid_host_device_handle_t hid_dev_handle,
   
3.                                         uint8_t *data,
   
4.                                         size_t data_length_max,
   
5.                                         size_t *data_length);

复制代码

函数形参：

表48.3.1.7 hid_host_device_get_raw_input_report_data函数形参描述

返回值：
ESP_OK表示获取输入报告数据成功。
其他错误码表示获取输入报告数据失败。
8，关闭USB HID主机设备hid_host_device_close
该函数用于关闭USB HID主机设备，其函数原型如下：

1. esp_err_t hid_host_device_close(hid_host_device_handle_t hid_dev_handle);

复制代码

函数形参：

表48.3.1.8 hid_host_device_close函数形参描述

返回值：
ESP_OK表示关闭HID设备成功。
其他错误码表示关闭HID设备失败。

48.3.2 程序流程图

图48.3.2.1 USB鼠标实验程序流程图

48.3.3 程序解析
本章节的例程是基于13_lcd实验编写的，所以笔者重点讲解有区别的文件。
1，USB HID 驱动
这里我们只讲解核心代码，详细的源码请大家参考光盘本实验对应源码。USB HID MSC驱动源码包括两个文件：usb_hid_mouse.c和usb_hid_mouse.h。
usb_hid_mouse.h主要用于声明usb_hid_mouse函数和USB消息等结构体，以便在其他文件中调用，具体内容不再赘述。
下面我们再解析usb_hid_mouse.c的程序，这里笔者分了几个部分来讲解，如下代码所示：
1，usb_hid_mouse
该函数初始化USB HID鼠标功能。它创建USB主机任务，安装HID主机驱动程序，并创建消息队列来接收和处理来自鼠标的事件。

1. /**
   
2. * @brief             鼠标初始化
   
3. * [url=home.php?mod=space&uid=271674]@param[/url]             无
   
4. * @retval            ESP_OK:初始化成功
   
5. */
   
6. esp_err_t usb_hid_mouse(void)
   
7. {
   
8.     /* 创建USB线程 */
   
9.     BaseType_t task_created = xTaskCreatePinnedToCore(usb_lib_task,
   
10.                                                      "usb_events",
    
11.                                                      4096,
    
12.                                                     xTaskGetCurrentTaskHandle(),
    
13.                                                      2, NULL, 0);
    
14.     assert(task_created == pdTRUE);
    
15. 
    
16.     /* 等待usb_lib_task的通知继续 */
    
17.     ulTaskNotifyTake(false, 1000);
    
18. 
    
19.     /* HID 主机配置 */
    
20.     const hid_host_driver_config_t hid_host_driver_config = {
    
21.         .create_background_task = true,             /* 创建回调函数任务 */
    
22.         .task_priority = 5,                         /* 优先级5 */
    
23.         .stack_size = 4096,                         /* 任务堆栈 */
    
24.         .core_id = 0,                               /* 内核ID */
    
25.         .callback = hid_host_device_callback,       /* 回调函数，即任务函数 */
    
26.         .callback_arg = NULL                        /* 回调函数传入参数 */
    
27.     };
    
28.     /* 初始化hid host */
    
29.     ESP_ERROR_CHECK(hid_host_install(&hid_host_driver_config));
    
30. 
    
31.     /* 创建消息队列 */
    
32.     app_event_queue = xQueueCreate(10, sizeof(app_event_queue_t));
    
33. 
    
34.     return ESP_OK;
    
35. }

复制代码

2，hid_host_device_callbac
该函数是HID设备事件的回调函数。当设备发生连接、断开等事件时，它会将事件信息发送到消息队列中，以便其他任务或者回调实时处理。

1. /**
   
2. * @brief             HID设备回调函数
   
3. * @param            hid_device_handle:HID设备句柄
   
4. * @param             event:HID设备事件
   
5. * @param             arg:未使用
   
6. * @retval            无
   
7. */
   
8. void hid_host_device_callback(hid_host_device_handle_t hid_device_handle,
   
9.                               const hid_host_driver_event_t event,
   
10.                               void *arg)
    
11. {
    
12.     const app_event_queue_t evt_queue = {
    
13.         .event_group = APP_EVENT_HID_HOST,              /* HID事件 */
    
14.         .hid_host_device.handle = hid_device_handle,    /* hid句柄 */
    
15.         .hid_host_device.event = event,                 /* 事件 */
    
16.         .hid_host_device.arg = arg,                     /* 传入参数 */
    
17.         .mouse_flag = CONNECT,                          /* 鼠标处于在线状态 */
    
18.         .coordinate_buf = {0},                          /* 无坐标数据 */
    
19.     };
    
20. 
    
21.     if (app_event_queue)
    
22.     {
    
23.         xQueueSend(app_event_queue, &evt_queue, 0);     /* 发送消息 */
    
24.     }
    
25. }

复制代码

3，usb_lib_task
该函数是一个USB主机库任务，负责初始化USB主机并处理USB事件。它会在事件发生时调用相应的回调函数，并在所有事件处理完毕后注销USB主机库并删除任务。

1. /**
   
2. * @brief             USB主机库的任务函数
   
3. * @param             arg:未使用
   
4. * @retval             无
   
5. */
   
6. static void usb_lib_task(void *arg)
   
7. {
   
8.     /* 主机配置 */
   
9.     const usb_host_config_t host_config = {
   
10.         .skip_phy_setup = false,
    
11.         .intr_flags = ESP_INTR_FLAG_LEVEL1,
    
12.     };
    
13.     /* usb host安装 */
    
14.     ESP_ERROR_CHECK(usb_host_install(&host_config));
    
15.     xTaskNotifyGive(arg);
    
16. 
    
17.     while (true)
    
18.     {
    
19.         uint32_t event_flags;
    
20.         usb_host_lib_handle_events(portMAX_DELAY, &event_flags);
    
21.         /* 只能注册一个客户端 */
    
22.         if (event_flags & USB_HOST_LIB_EVENT_FLAGS_NO_CLIENTS)
    
23.         {
    
24.             ESP_ERROR_CHECK(usb_host_device_free_all());
    
25.             break;
    
26.         }
    
27.     }
    
28. 
    
29.     vTaskDelay(10); /* 必须延时 */
    
30.     /* 注销USB HOST */
    
31.     ESP_ERROR_CHECK(usb_host_uninstall());
    
32.     /* 删除当前任务 */
    
33.     vTaskDelete(NULL);
    
34. }

复制代码

4，hid_print_new_device_report_heade
该函数根据当前协议类型输出报告的头部信息。当协议类型变化时（例如从鼠标到键盘或其他设备），它会打印设备类型（如“Mouse”或“Keyboard”）到日志中。

1. /**
   
2. * @brief             根据报告输出协议类型生成新行
   
3. * @param             proto:当前要输出的协议
   
4. * @retval           无
   
5. */
   
6. static void hid_print_new_device_report_header(hid_protocol_t proto)
   
7. {
   
8.     static hid_protocol_t prev_proto_output = -1;
   
9. 
   
10.     if (prev_proto_output != proto)
    
11.     {
    
12.         prev_proto_output = proto;
    
13. 
    
14.         if (proto == HID_PROTOCOL_MOUSE)
    
15.         {
    
16.             ESP_LOGI(usb_hid_mouse_tag,"Mouse\r\n");
    
17.         }
    
18.         else if (proto == HID_PROTOCOL_KEYBOARD)
    
19.         {
    
20.             ESP_LOGI(usb_hid_mouse_tag,"Keyboard\r\n");
    
21.         }
    
22.         else
    
23.         {
    
24.             ESP_LOGI(usb_hid_mouse_tag,"Generic\r\n");
    
25.         }
    
26.     }
    
27. }

复制代码

5，hid_host_mouse_report_callbac
该函数用于处理来自USB HID鼠标设备的输入报告。它解析报告中的位移信息，更新鼠标的当前位置，并将坐标数据发送到消息队列中。

1. /**
   
2. * @brief             USB HID主机鼠标接口报告回调处理程序
   
3. * @param             data:输入报表数据缓冲区的指针
   
4. * @param             length:输入报表数据缓冲区的长度
   
5. * @retval           无
   
6. */
   
7. static void hid_host_mouse_report_callback(const uint8_t *const data,
   
8. const int length)
   
9. {
   
10. hid_mouse_input_report_boot_t *mouse_report =
    
11. (hid_mouse_input_report_boot_t *)data;
    
12. 
    
13.     if (length < sizeof(hid_mouse_input_report_boot_t))
    
14.     {
    
15.         return;
    
16.     }
    
17. 
    
18.     static int x_pos = 0;
    
19.     static int y_pos = 0;
    
20. 
    
21.     /* 从位移计算绝对位置 */
    
22.     x_pos += mouse_report->x_displacement;
    
23.     y_pos += mouse_report->y_displacement;
    
24. 
    
25.     hid_print_new_device_report_header(HID_PROTOCOL_MOUSE);
    
26. 
    
27.     app_event_queue_t evt_queue = {0};
    
28.     evt_queue.event_group = APP_EVENT_HID_HOST;     /* HID事件 */
    
29.     evt_queue.mouse_flag = COORDINATE_DATA;         /* 坐标数据 */
    
30.     /* 存储坐标数据 */
    
31. sprintf(evt_queue.coordinate_buf,"X:%06d,Y:%06d,|%c|%c|",x_pos,
    
32. y_pos,(mouse_report->buttons.button1 ? 'o' : ' '),
    
33. (mouse_report->buttons.button2 ? 'o' : ' '));
    
34. 
    
35.     if (app_event_queue)
    
36.     {
    
37.         xQueueSend(app_event_queue, &evt_queue, 0);     /* 发送消息 */
    
38.     }
    
39. }

复制代码

6，hid_host_generic_report_callbac
该函数用于处理来自USB HID设备（如键盘、触摸板等）的通用输入报告。它将接收到的数据逐字节打印到日志中。

1. /**
   
2. * @brief            USB HID主机通用接口报告回调处理程序
   
3. * @param            data:输入报表数据缓冲区的指针
   
4. * @param           length:输入报表数据缓冲区的长度
   
5. * @retval           无
   
6. */
   
7. static void hid_host_generic_report_callback(const uint8_t *const data,
   
8. const int length)
   
9. {
   
10.     hid_print_new_device_report_header(HID_PROTOCOL_NONE);
    
11. 
    
12.     for (int i = 0; i < length; i++)
    
13.     {
    
14.         ESP_LOGI(usb_hid_mouse_tag,"%02X", data[i]);
    
15.     }
    
16. }

复制代码

7，hid_host_interface_callbac
该函数是处理USB HID接口事件的回调函数。根据不同的事件（如输入报告、设备断开连接、传输错误），它会调用不同的处理函数，并在必要时将事件发送到消息队列。

1. /**
   
2. * @brief             USB HID Host 接口事件
   
3. * @param           hid_device_handle:设备句柄
   
4. * @param             event:设备事件
   
5. * @param            arg:未使用
   
6. * @retval           无
   
7. */
   
8. void hid_host_interface_callback(hid_host_device_handle_t hid_device_handle,
   
9.                                  const hid_host_interface_event_t event,
   
10.                                  void *arg)
    
11. {
    
12.     uint8_t data[64] = { 0 };
    
13.     size_t data_length = 0;
    
14.     hid_host_dev_params_t dev_params;
    
15.     ESP_ERROR_CHECK(hid_host_device_get_params(hid_device_handle, &dev_params));
    
16. 
    
17.     switch (event)
    
18.     {
    
19.         case HID_HOST_INTERFACE_EVENT_INPUT_REPORT:
    
20.             ESP_ERROR_CHECK(hid_host_device_get_raw_input_report_data(
    
21. hid_device_handle,
    
22.                                                                     data,
    
23.                                                                     64,
    
24. &data_length));
    
25. 
    
26.             if (HID_SUBCLASS_BOOT_INTERFACE == dev_params.sub_class)
    
27.             {
    
28.                 if (HID_PROTOCOL_MOUSE == dev_params.proto)
    
29.                 {
    
30.                     hid_host_mouse_report_callback(data, data_length);
    
31.                 }
    
32.             }
    
33.             else
    
34.             {
    
35.                 hid_host_generic_report_callback(data, data_length);
    
36.             }
    
37. 
    
38.             break;
    
39.         case HID_HOST_INTERFACE_EVENT_DISCONNECTED:
    
40. 
    
41.             const app_event_queue_t evt_queue = {
    
42.                 .event_group = APP_EVENT,   /* 一般事件 */
    
43.                 .hid_host_device = {0},     /* 设备信息清零 */
    
44.                 .mouse_flag = DISCONNECT,   /* 鼠标处于离线状态 */
    
45.                 .coordinate_buf = {0},      /* 无坐标数据 */
    
46.             };
    
47. 
    
48.             if (app_event_queue)
    
49.             {
    
50.                 xQueueSend(app_event_queue, &evt_queue, 0);     /* 发送消息 */
    
51.             }
    
52. 
    
53.             ESP_ERROR_CHECK(hid_host_device_close(hid_device_handle));
    
54.             break;
    
55.         case HID_HOST_INTERFACE_EVENT_TRANSFER_ERROR:
    
56.             break;
    
57.         default:
    
58.             break;
    
59.     }
    
60. }

复制代码

8，hid_host_device_even
该函数处理HID设备连接或事件。它根据设备的协议类型（如键盘或鼠标）打开并配置相应的HID设备，并启动设备的通信。

1. /**
   
2. * @brief             USB HID Host 设备事件
   
3. * @param             hid_device_handle:设备句柄
   
4. * @param            event:设备事件
   
5. * @param            arg:未使用
   
6. * @retval          无
   
7. */
   
8. void hid_host_device_event(hid_host_device_handle_t hid_device_handle,
   
9.                            const hid_host_driver_event_t event,
   
10.                            void *arg)
    
11. {
    
12.     hid_host_dev_params_t dev_params;
    
13.     ESP_ERROR_CHECK(hid_host_device_get_params(hid_device_handle, &dev_params));
    
14. 
    
15.     switch (event)
    
16.     {
    
17.         case HID_HOST_DRIVER_EVENT_CONNECTED:
    
18.             ESP_LOGI(usb_hid_mouse_tag, "HID Device, protocol '%s' CONNECTED",
    
19.                     hid_proto_name_str[dev_params.proto]);
    
20. 
    
21.             const hid_host_device_config_t dev_config = {
    
22.                 .callback = hid_host_interface_callback,    /* hid接口回调函数 */
    
23.                 .callback_arg = NULL                        /* 回调函数传入参数 */
    
24.             };
    
25.             /* 打开hid host设备 */
    
26.             ESP_ERROR_CHECK(hid_host_device_open(hid_device_handle,
    
27. &dev_config));
    
28. 
    
29.             if (HID_SUBCLASS_BOOT_INTERFACE == dev_params.sub_class)
    
30.             {
    
31.                 ESP_ERROR_CHECK(hid_class_request_set_protocol(
    
32. hid_device_handle,
    
33. HID_REPORT_PROTOCOL_BOOT));
    
34. 
    
35.                 if (HID_PROTOCOL_KEYBOARD == dev_params.proto)
    
36.                 {
    
37.                     ESP_ERROR_CHECK(hid_class_request_set_idle(
    
38. hid_device_handle, 0, 0));
    
39.                 }
    
40.             }
    
41.             /* 开始hid host 设备 */
    
42.             ESP_ERROR_CHECK(hid_host_device_start(hid_device_handle));
    
43.             break;
    
44.         default:
    
45.             break;
    
46.     }
    
47. }

复制代码

2，main.c驱动代码
在main.c里面编写如下代码。

1. void app_main(void)
   
2. {
   
3.     esp_err_t ret;
   
4.     app_event_queue_t evt_queue;
   
5.     ret = nvs_flash_init();          /* 初始化NVS */
   
6. 
   
7.     if(ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND)
   
8.     {
   
9.         ESP_ERROR_CHECK(nvs_flash_erase());
   
10.         ESP_ERROR_CHECK(nvs_flash_init());
    
11.     }
    
12. 
    
13.     lcd_init();                         /* LCD屏初始化 */
    
14.     usb_hid_mouse();                    /* HID mouse初始化 */
    
15. 
    
16.     lcd_show_string(30, 50,  200, 16, 16, "ESP32-P4", RED);
    
17.     lcd_show_string(30, 70,  200, 16, 16, "USB mouse TEST", RED);
    
18.     lcd_show_string(30, 90,  200, 16, 16, "ATOM@ALIENTEK", RED);
    
19.     lcd_show_string(30, 110, 200, 16, 16, "status:disconnect", RED);
    
20. 
    
21.     while (1)
    
22.     {
    
23.         /* 等待消息队列 */
    
24.         if (xQueueReceive(app_event_queue, &evt_queue, portMAX_DELAY))
    
25.         {
    
26.             if (APP_EVENT_HID_HOST ==  evt_queue.event_group)
    
27.             {
    
28.                 if (CONNECT == evt_queue.mouse_flag)
    
29.                 {
    
30.                     lcd_show_string(84, 110, 200, 16, 16, "connected.", BLUE);
    
31.                     hid_host_device_event(evt_queue.hid_host_device.handle,
    
32.                                           evt_queue.hid_host_device.event,
    
33.                                           evt_queue.hid_host_device.arg);
    
34.                 }
    
35.                 else if (COORDINATE_DATA == evt_queue.mouse_flag)
    
36.                 {
    
37.                     lcd_show_string(30, 130, lcddev.width, 16,
    
38. 16, evt_queue.coordinate_buf, BLUE);
    
39.                 }
    
40.             }
    
41.             else if (APP_EVENT ==  evt_queue.event_group)
    
42.             {
    
43.                 if (DISCONNECT == evt_queue.mouse_flag)
    
44.                 {
    
45.                     lcd_show_string(84, 110, 200, 16, 16, "disconnect", BLUE);
    
46.                 }
    
47.             }
    
48.         }
    
49.     }
    
50. }

复制代码

首先，程序初始化了NVS存储和LCD屏幕，并通过 usb_hid_mouse 函数初始化了USB HID鼠标设备。在LCD上显示设备的状态信息。进入主循环后，程序通过消息队列（xQueueReceive）监听和处理来自其他任务或事件的消息。当接收到鼠标设备的连接事件时，LCD显示“connected”；当接收到鼠标坐标数据时，LCD显示坐标信息；若设备断开连接，则LCD显示“disconnect”。通过这种方式，程序不仅管理了鼠标设备的连接状态，还将实时的设备状态和数据在LCD上显示。

48.4 下载验证
将程序下载到开发板后，将USB鼠标插入开发板的USB_HOST端口。如果鼠标被成功识别，LCD屏幕会显示连接成功的提示信息。此时，通过移动鼠标或按下左右按键，LCD将实时显示鼠标的当前坐标值和按键状态，如下图所示。

图48.4.1 鼠标提示信息