sdk-bsp-stm32f407-spark/projects/04_component_usb_mouse

USB 鼠标例程

例程简介

本例程使用板载的六轴传感器 icm20608 获取开发板的旋转方向及角度，然后转换为鼠标的位移信息。同时使用板载按键实现鼠标的左右键，最后将这些鼠标信息通过 RT-Thread 的 USB 组件发送至电脑，从而实现开发板模拟 USB 鼠标的功能。

相关组件与软件包简介

RT-Thread USB 组件

该组件位于 /rt-thread/components/drivers/usb，是 RT-Thread 依据 USB2.0 协议规范将 USB 协议栈逻辑高度抽象，支持 host（主机）模式、 device（从机）模式。

该组件允许用户通过宏 RT_USB_DEVICE_COMPOSITE 开启复合功能，无需额外的代码即可对多个设备类型进行复合，虚拟串口、以太网卡、人体学输入设备、大容量存储设备、微软通用 USB 等。

该组件在驱动移植方面提供了非常友好的移植接口，用户可将厂商 SDK（软件开发工具包）中 PCD（端口连接检测）驱动直接接入到 RT-Thread，实现 0 代码使用 USB。

ICM20608 软件包

该软件包位于 /projects/04_component_usb_mouse/packages/icm20608-v1.0.0 中，是 RT-Thread 针对六轴传感器 icm20608 功能使用的实现，使用这个软件包，可以让该传感器在 RT-Thread 上非常方便使用 icm20608 的基本功能，包括读取三轴加速度（3-axis accelerometer）、三轴陀螺仪（3-axis gyroscope）、零值校准等功能，如需详细了解该软件包，请参考 ICM20608 软件包中的 README。

硬件说明

如 USB 原理图所示：

USB-DEV 是本例程使用的 USB OTG 接口，其中 USB_D-(PA11) 、 USB_D+(PA12) 为 USB 主机与从机的数据交互接口，本例程中开发板作为从机，电脑作为主机。

USB 接口、鼠标按键与传感器 icm20608 在开发板中的位置如下图所示:

软件说明

USB 鼠标例程位于 /projects/04_component_usb_mouse 目录下，重要文件摘要说明如下所示：

文件	说明
applications	应用
applications/main.c	app 入口
applications/SD_mouse.c	USB 鼠标应用主要文件
packages	内含简易好用的官方软件包
packages/icm20608-v1.0.0	六轴传感器

例程主要流程如下：

1. 初始化设备或者查找设备

查找设备名称为 hidd 的 hid 设备，初始化 icm20608 传感器，初始化鼠标按键。

1. 打开设备

打开查找到的 hid 设备。

1. 创建线程

分别创建鼠标数据发送处理线程、传感器数据读取与处理线程、按键检测线程，并且启动这些创建的线程。

USB 鼠标功能指标定义

const static float mouse_rang_scope = 6.0f; /* 变 动 识 别 值 */

这个值设定开发板上下、左右移动变动识别值，可以自定义，值越小，鼠标越灵敏，越大鼠标越迟钝，但是应该大于 0，小于 45。

const static float mouse_angle_range = 80.0f; /* 读 取 角 度 有 效 角 度 */

这个值决定了六轴传感器 icm20608 读取角度控制值，范围为 0 - 90 度。

const static float mouse_move_range = 127.0f; /* 移 动 值 的 最 大 值 */

这个值决定了开发板倾斜角度转换成鼠标移动值的最大值，默认为最大值。

#define mouse_ratio (mouse_move_range / mouse_angle_range) /* 角 度 移 动 比 */

这个值由上面两个值决定，是将传感器读到的角度值转换成鼠标移动距离的比率。在角度一定的情况下，值越大，鼠标移动的距离越大，值越小，鼠标移动距离就小。

const static rt_uint8_t mouse_pixel_len = 5; /* 移 动 步 长 */

这个值决定了每次鼠标移动的步长，值越小，鼠标单次移动的就小，鼠标指针精度就越高，取值范围 0 - 127。

const static rt_uint32_t mouse_sample_times = 0; /* 鼠 标 响 应 时 间 */

这个值决定了鼠标响应时间，默认立即响应程序调度。初次使用，可以调大，便于观察日志。

原理性介绍

USB HID 鼠标实现流程图如下所示：

开发板开始正常运行后， RT-Thread 操作系统的线程调度函数，管理程序的运行，调度检测过程如下：

传感器数据读取与处理线程负责读取三轴加速度与三轴陀螺仪的测量值，在将测量值超过设置的上下、左右移动变动识别值，将读取到测量值，也就是倾斜值，转换成鼠标位移信息，其中倾斜值的正负号对应鼠标位移的方向，倾斜值的大小对应鼠标位移的大小，处理完成后将数据发送至电脑，完成鼠标位移操作。

按键检测线程负责检测开发板上按键是否被按下，若被按下，将响应的按键转换成鼠标的左键或者右键指令，处理完成后将数据发送至电脑，完成鼠标按键操作。

USB 数据例程程序入口

static int application_usb_init(void)
{
    /* 查找名称为 hidd 的设备 */
    rt_device_t device = rt_device_find("hidd");
    /* 初始化六轴传感器设备 */
    icm_device = mouse_init_icm();
    /* 初始化按键 */
    mouse_init_key();

    RT_ASSERT(device != RT_NULL);
    RT_ASSERT(icm_device != RT_NULL);

    /* 打开查找到的 hid 设备 */
    rt_device_open(device, RT_DEVICE_FLAG_WRONLY);

    /* 初始化 USB 线程 */
    rt_thread_init(&usb_thread,
                   "hidd",
                   usb_thread_entry, device,
                   usb_thread_stack, sizeof(usb_thread_stack),
                   10, 20);
    rt_thread_startup(&usb_thread);

    /* 初始化六轴传感器线程 */
    rt_thread_init(&icm_thread,
                   "icm20608",
                   icm_thread_entry, RT_NULL,
                   icm_thread_stack, sizeof(icm_thread_stack),
                   10, 20);
    rt_thread_startup(&icm_thread);

    /* 初始化按键线程 */
    rt_thread_init(&key_thread,
                   "key",
                   key_thread_entry, device,
                   key_thread_stack, sizeof(key_thread_stack),
                   10,20);
    rt_thread_startup(&key_thread);

    return 0;
}

编译 & 下载

• RT-Thread Studio：在 RT-Thread Studio 的包管理器中下载 STM32F407-RT-SPARK 资源包，然后创建新工程，执行编译。
• MDK：首先双击 mklinks.bat，生成 rt-thread 与 libraries 文件夹链接；再使用 Env 生成 MDK5 工程；最后双击 project.uvprojx 打开 MDK5 工程，执行编译。

编译完成后，将开发板的 ST-Link USB 口与 PC 机连接，然后将固件下载至开发板。

运行效果

烧写程序之后，并将开发板的 USB OTG 接口与电脑连接，电脑通过设备管理器查询，可以发现多了一个鼠标设备，如下图所示：

打开串口，重启后，分别进行相关操作即可显示响应的日志，具体解释如下：

\ | /
- RT - Thread Operating System
/ | \ 4.0.1 build Mar 28 2019
2006 - 2019 Copyright by rt-thread team
[D/3D_mouse] The 3D mouse initializes success                          #鼠标初始化成功
msh >[D/3D_mouse] left down                                            #左键按下
[D/3D_mouse] left down
[D/3D_mouse] left down
[D/3D_mouse] right down                                                #右键按下
[D/3D_mouse] right down
[D/3D_mouse] right down
[D/3D_mouse] right down
[D/3D_mouse] move_max :   5, x:    0, y :   5                          #鼠标移动
[D/3D_mouse] move_max :   7, x:    3, y :   7
[D/3D_mouse] move_max :   7, x:    0, y :   7
[D/3D_mouse] move_max :  14, x:    0, y :  14
[D/3D_mouse] move_max :  14, x:    0, y :  14
[D/3D_mouse] move_max :  21, x:    0, y :  21

注意事项

暂无。