关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)

作者 : admin 本文共18097个字,预计阅读时间需要46分钟 发布时间: 2024-06-9 共5人阅读

主要最近做了一个要用STM32实现读取鼠标键盘一体的那种USB设备,STM32的界面上要和电脑一样的能通过这个USB接口实现鼠标移动,键盘的按键。然后我就很自然的去参考了正点原子的例程,可是找了一圈,发现正点原子好像用的库函数,还是自己实现的,然后看了半天都看晕了,感觉自己实现不了,然后就主攻Cubemx实现的USB设备读取了。

在网上找了一圈,终于让我发现了一个可以用的博主的,而且实现了USB读取鼠标键盘一体的设备。
参考网址如下:
http://blog.csdn.net/weixin_50969532/article/details/134313495
基于STM32-USB中间库的多接口主机开发实战
感觉这个博主实现的非常好了,主要实现方法我都是参考这个博主的,只是基于Cubemx实现的还是和博主的实现有一点点的出入,我这里主要跟随博主的实现方法,和博主的文章对比着修改下博主的实现方法,并融合一下,并且实现的更好一点。

使用的硬件

根据网上很多的HID实现方法,大多数都是用F103一类的STM32设备,将STM32设置成Device,模拟鼠标键盘和电脑进行通信,相当于就是用STM32做一个鼠标键盘。但是我们要实现的正好是反着来的,我们要用STM32当做是电脑,读取真正的鼠标键盘的数据,然后在STM32上显示鼠标的移动,按键,键盘的按键。下面是我用的主要硬件。

STM32:正点原子的阿波罗F767开发板

鼠标键盘(一体的):不知道是什么杂牌子,反正写着型号T1,2.4G无线充电鼠标,电压4.2V,载波频率:2402Mhz。

第一步了解USB主机和设备

首先第一步,看下博主的博客。根据博主的说明,我们可以知道,主机和设备之间的USB基础知识。
USB:通用串行总线,是由主机发起通信、从机被动接收的主从机通信机制。

管道:主从机通信的通道,可以理解为两个海岸之间船只来往的航线。要想船只走得通,必须开放这条航线;要想进行通信,必须打开对应的管道。(其实生成的代码里仔细看也会有,生成的Cubemx代码里叫pipe,还分为进出pipe)

端点:主从机传输的最终对象,可以理解为船只来往的码头,航线的两头即端点。要想船只来往,必须开放码头;要想进行通信,必须开放对应的端点。(这个可以理解为Freertos里的队列的进出口,关键Cubemx里也真的是用的队列,队列实现的管道,写入队列和读取队列就是端点)

接口:几个端点的集合,实现某一具体功能。比如这2个码头用来运输食品,这就是一个食品接口;另外4个码头用来运输石油,这是一个石油接口。键鼠一体有两个接口,一个接口是键盘,一个接口是鼠标。(这里就是最重要的,按照博主的说明,接口的数量决定是只有一个鼠标或者一个键盘,还是两个都有。也就是说,如果一个USB的接口插在电脑上,可以接收很多个无线设备的数据,接口几个,就有几个设备)

关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图
这里参考的就是【半路程序媛】http://blog.csdn.net/weixin_50969532/article/details/134313495这位博主的图片,感谢博主的说明。。。

第二步 用Cubemx生成STM32代码

Cubemx来生成的STM32的代码,主要要设置Cubemx的两个部分,第一个,就是USB_OTG_FS,第二个是USB_HOST。(注意,STM32F1都实现不了HOST,只能是Device,所以买错STM32的小伙伴注意了)

然后就是打开Cubemx,选择自己的STM32,我这里用的硬件是F767IGT6,我就选择F767IGT6。
然后就是一般的CUbemx设置,选晶振,设置时钟,配置UART1作为调试接口输出到电脑,Freertos系统配置(是的,我用了系统,没试过不用系统的,但是有系统的话,为啥非要跑裸机呢~)。

好了,设置好了后,就可以开始用Cubemx配置USB设备了,首先是Connectivity里的USB_OTG_FS(我这里有USB_OTG_HS,但是我的设备主要用这个OTG_FS接口)
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(1)

这里设置好了后,Middleware and Software里就会有一个USB_HOST(有的Cubemx版本可能不在这里,注意找一下,如果找不到,就是你的STM32不支持HOST),然后就是USB_HOST的配置。
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(2)
User Constants不用,就用默认就可以了,然后就是Platform Settings这个设置要说明一下。

Platform Settings设置说明

这个设置的意思是STM32支持其中一个STM32的引脚来控制USB设备的供电,也就是在硬件上要有相同的设置。如果你的硬件电路板上,硬件工程师做了这么一个设置,可以用一个STM32的引脚来给外部USB供电,这个设置你就是必须要设置的,而且一定要问硬件工程师是设置的哪个引脚,引脚要一致。
但是如果你电路板本身就是USB有供电了,那这个的设置就对你毫无用处,随便设置一个不用的引脚吧,就是为了Cubemx能顺利生成代码而已。。而且在生成后的代码里,也没啥用处。。

如果你用的板子和我的一样,都是正点原子的阿波罗,那你要仔细看下硬件原理图了,正点原子的USB的供电引脚是用一个扩展芯片来实现的,叫pcf8574,这个芯片要用IIC驱动才能让USB供电上,不供电的话就算你怎么改代码都读不到USB的。。别被坑了。。。

回到正题,继续配置Cubemx

Cubemx配置好了这两个以后,USB这方面就完成了。然后就是生成代码。下面我们来看下keil5的代码吧。

Keil5上看下生成的代码,修改代码来实现

Keil5生成的代码我们先看下文件树,我这里主要生成的文件是这样的。
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(3)
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(4)
这三个文件夹是个USB设备有关的,后面我们主要也是要修改这几个文件来实现一体化设备的数据读取。

关于Cubemx生成的代码里,本身是可以直接用的,要实现键盘的话,就本身生成好的就可以直接用。

Cubemx的代码可以直接驱动一个USB设备?

是的,Cubemx的代码确实直接生成好的就是可以直接插上USB设备就能用。
先看main。。。。呃。。我用的freertos的系统,看main没啥用,就不看了,主要看下在哪里初始化USB设备和怎么用吧。

关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(5)
我这里的这个函数是Cubemx上了freertos系统后,自动生成的一个任务,我直接把初始化放在任务里,然后初始化USB设备,下面的for(;;)里面只用写自己要处理的usb_demo(&hUsbHostFs)就可以了。下面是我的usb_demo。

下面展示一些 内联代码片

void USB_Demo(USBH_HandleTypeDef * phost)
{
    char c,i;
 
for(i=0;i<USBH_MAX_NUM_INTERFACES;i++)
{
if(InterfaceIndex[i] != 0xff)
{
    if(USBH_HID_GetDeviceType(&hUSBHost)==HID_KEYBOARD)     //键盘设备
    {
         if(Appli_state==APPLICATION_READY)
         {           //获取键盘信息
            if(k_pinfo!=NULL)
            {
                c=USBH_HID_GetASCIICode(k_pinfo);           //转换成ASCII码
                //这里是我自己加的一句,只用输出c就行了
                printf("%c",c);
                MYUSR_KEYBRD_ProcessData(c);                //在LCD上显示出键盘字符
                k_pinfo = NULL;
                memset(k_pinfo ,0,sizeof(HID_KEYBD_Info_TypeDef ));
            }
         }
    }
    else if (USBH_HID_GetDeviceType(&hUSBHost)==HID_MOUSE)  //鼠标设备
    {
        if(Appli_state==APPLICATION_READY)
        {
           // MOUSE_Demo(&hUSBHost);
            if(m_pinfo!=NULL)
            {
                MYUSR_MOUSE_ProcessData(&mouse_info);       //LCD上显示鼠标信息
                m_pinfo = NULL;
                memset(m_pinfo ,0,sizeof(HID_MOUSE_Info_TypeDef ));
            }
        }
    }else                                                   //无法识别的设备
    {
        //printf("无法识别的设备\r
");
    }
}
}
}

这个代码其实就是楼上博主的demo代码,博主的文章中没有实现的两点是MYUSR_MOUSE_ProcessData(&mouse_info);和 MYUSR_KEYBRD_ProcessData©;
但是这两个函数我们这里可以先不要,因为本身的这个Cubemx生成的代码里,也只能实现键盘的读取,所以,代码运行到了c=USBH_HID_GetASCIICode(k_pinfo);的时候,就可以了,后面只要printf出来c,就是你按下的那个按键。

到这里Cubemx本身的使用就这样子了,实现一个键盘的按键读取,鼠标我还没试过,不过改改也是可以实现的,只是暂时没那个时间啦。
下面就是要根据参考的博主的步伐,改下Cubemx生成的代码,实现一个USB,读取鼠标键盘两个设备。

一个USB,读取鼠标和键盘两个设备

第一步,改代码,主要在usbh_hid.c里

我这里的修改主要对标博主的第三步和第四步。
把原来Cubemx生成的static函数都改成__WEAK,然后自己重写一遍这几个函数,因为这几个函数两个接口都会要用到。
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(6)
原来博主的文章里写的是直接改这几个红框后面的函数,我这里按照博主的方法,把这几个函数重写,原来的函数就直接把static改成__WEAK,这样就算再用Cubemx修改生成一遍,改动也会很小。

第二步,重新建立自己的.c和.h文件,把改动都放在自己的文件里

我这里建立的名字是My_USB_MouseKey.h和My_USB_MouseKey.c,第一步的图里的函数都要重写,所以我把重写后的函数都放下面吧,大家复制粘贴一下,然后自己跑一下,看哪里没有包含.h的自己包含一下。

下面展示一些 内联代码片

My_USB_MouseKey.c
/*------------------函数修改的区域------------------------------*/
uint8_t USBH_HID_GetPollInterval(USBH_HandleTypeDef *phost)
{
for(int i=0;ipActiveClass->pData[i];
if ((phost->gState == HOST_CLASS_REQUEST) ||
(phost->gState == HOST_INPUT) ||
(phost->gState == HOST_SET_CONFIGURATION) ||
(phost->gState == HOST_CHECK_CLASS) ||
((phost->gState == HOST_CLASS)))
{
return (uint8_t)(HID_Handle->poll);
}
else
{
return 0U;
}
}
return 0U;
}
USBH_StatusTypeDef USBH_HID_SOFProcess(USBH_HandleTypeDef *phost)
{
for(int i=0;ipActiveClass->pData[i];
if (HID_Handle->state == USBH_HID_POLL)
{
if ((phost->Timer - HID_Handle->timer) >= HID_Handle->poll)
{
HID_Handle->state = USBH_HID_GET_DATA;
#if (USBH_USE_OS == 1U)
phost->os_msg = (uint32_t)USBH_URB_EVENT;
#if (osCMSIS os_event, phost->os_msg, 0U);
#else
(void)osMessageQueuePut(phost->os_event, &phost->os_msg, 0U, 0U);
#endif
#endif
}
}
}
return USBH_OK;
}
USBH_StatusTypeDef USBH_HID_InterfaceInit(USBH_HandleTypeDef *phost)
{
USBH_StatusTypeDef status;
HID_HandleTypeDef *HID_Handle;
uint8_t max_ep;
uint8_t num = 0U;
uint8_t interface;
for(int i=0;ipActiveClass->ClassCode, HID_BOOT_CODE, i+1);
#include "My_USB_MouseKey.h"
InterfaceIndex[i] = interface;
if ((interface == 0xFFU) || (interface >= USBH_MAX_NUM_INTERFACES)) /* No Valid Interface */
{
USBH_DbgLog("Cannot Find the interface for %s class.", phost->pActiveClass->Name);
return USBH_FAIL;
}
status = USBH_SelectInterface(phost, interface);
if (status != USBH_OK)
{
return USBH_FAIL;
}
phost->pActiveClass->pData[i] = (HID_HandleTypeDef *)USBH_malloc(sizeof(HID_HandleTypeDef));
HID_Handle = (HID_HandleTypeDef *) phost->pActiveClass->pData[i];
if (HID_Handle == NULL)
{
USBH_DbgLog("Cannot allocate memory for HID Handle");
return USBH_FAIL;
}
/* Initialize hid handler */
(void)USBH_memset(HID_Handle, 0, sizeof(HID_HandleTypeDef));
HID_Handle->state = USBH_HID_ERROR;
/*Decode Bootclass Protocol: Mouse or Keyboard*/
if (phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].bInterfaceProtocol == HID_KEYBRD_BOOT_CODE)
{
USBH_UsrLog("KeyBoard device found!");
HID_Handle->Init = USBH_HID_KeybdInit;
}
else if (phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].bInterfaceProtocol  == HID_MOUSE_BOOT_CODE)
{
USBH_UsrLog("Mouse device found!");
HID_Handle->Init = USBH_HID_MouseInit;
}
else
{
USBH_UsrLog("Protocol not supported.");
return USBH_FAIL;
}
HID_Handle->state     = USBH_HID_INIT;
HID_Handle->ctl_state = USBH_HID_REQ_INIT;
HID_Handle->ep_addr   = phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].Ep_Desc[0].bEndpointAddress;
HID_Handle->length    = phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].Ep_Desc[0].wMaxPacketSize;
HID_Handle->poll      = phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].Ep_Desc[0].bInterval;
if (HID_Handle->poll  poll = HID_MIN_POLL;
}
/* Check of available number of endpoints */
/* Find the number of EPs in the Interface Descriptor */
/* Choose the lower number in order not to overrun the buffer allocated */
max_ep = ((phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].bNumEndpoints device.CfgDesc.Itf_Desc[phost->device.current_interface].bNumEndpoints : USBH_MAX_NUM_ENDPOINTS);
/* Decode endpoint IN and OUT address from interface descriptor */
for (num = 0U; num device.CfgDesc.Itf_Desc[phost->device.current_interface].Ep_Desc[num].bEndpointAddress & 0x80U) != 0U)
{
HID_Handle->InEp = (phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].Ep_Desc[num].bEndpointAddress);
HID_Handle->InPipe = USBH_AllocPipe(phost, HID_Handle->InEp);
/* Open pipe for IN endpoint */
(void)USBH_OpenPipe(phost, HID_Handle->InPipe, HID_Handle->InEp, phost->device.address,
phost->device.speed, USB_EP_TYPE_INTR, HID_Handle->length);
(void)USBH_LL_SetToggle(phost, HID_Handle->InPipe, 0U);
}
else
{
HID_Handle->OutEp = (phost->device.CfgDesc.Itf_Desc[phost->device.current_interface].Ep_Desc[num].bEndpointAddress);
HID_Handle->OutPipe  = USBH_AllocPipe(phost, HID_Handle->OutEp);
/* Open pipe for OUT endpoint */
(void)USBH_OpenPipe(phost, HID_Handle->OutPipe, HID_Handle->OutEp, phost->device.address,
phost->device.speed, USB_EP_TYPE_INTR, HID_Handle->length);
(void)USBH_LL_SetToggle(phost, HID_Handle->OutPipe, 0U);
}
}
}
return USBH_OK;
}
USBH_StatusTypeDef USBH_HID_InterfaceDeInit(USBH_HandleTypeDef *phost)
{
for(int i=0;ipActiveClass->pData[i];
if (HID_Handle->InPipe != 0x00U)
{
(void)USBH_ClosePipe(phost, HID_Handle->InPipe);
(void)USBH_FreePipe(phost, HID_Handle->InPipe);
HID_Handle->InPipe = 0U;     /* Reset the pipe as Free */
}
if (HID_Handle->OutPipe != 0x00U)
{
(void)USBH_ClosePipe(phost, HID_Handle->OutPipe);
(void)USBH_FreePipe(phost, HID_Handle->OutPipe);
HID_Handle->OutPipe = 0U;     /* Reset the pipe as Free */
}
if ((phost->pActiveClass->pData[i]) != NULL)
{
USBH_free(phost->pActiveClass->pData[i]);
phost->pActiveClass->pData[i] = 0U;
}
}
return USBH_OK;
}
USBH_StatusTypeDef USBH_HID_ClassRequest(USBH_HandleTypeDef *phost)
{
USBH_StatusTypeDef status         = USBH_BUSY;
USBH_StatusTypeDef classReqStatus = USBH_BUSY;
for(int i=0;ipActiveClass->pData[i];
/* Switch HID state machine */
switch (HID_Handle->ctl_state)
{
case USBH_HID_REQ_INIT:
case USBH_HID_REQ_GET_HID_DESC:
USBH_HID_ParseHIDDesc(&HID_Handle->HID_Desc, phost->device.CfgDesc_Raw);
HID_Handle->ctl_state = USBH_HID_REQ_GET_REPORT_DESC;
break;
case USBH_HID_REQ_GET_REPORT_DESC:
/* Get Report Desc */
classReqStatus = USBH_HID_GetHIDReportDescriptor(phost, HID_Handle->HID_Desc.wItemLength);
if (classReqStatus == USBH_OK)
{
/* The descriptor is available in phost->device.Data */
HID_Handle->ctl_state = USBH_HID_REQ_SET_IDLE;
}
else if (classReqStatus == USBH_NOT_SUPPORTED)
{
USBH_ErrLog("Control error: HID: Device Get Report Descriptor request failed");
status = USBH_FAIL;
}
else
{
/* .. */
}
break;
case USBH_HID_REQ_SET_IDLE:
classReqStatus = USBH_HID_SetIdle(phost, 0U, 0U);
/* set Idle */
if (classReqStatus == USBH_OK)
{
HID_Handle->ctl_state = USBH_HID_REQ_SET_PROTOCOL;
}
else
{
if (classReqStatus == USBH_NOT_SUPPORTED)
{
HID_Handle->ctl_state = USBH_HID_REQ_SET_PROTOCOL;
}
}
break;
case USBH_HID_REQ_SET_PROTOCOL:
/* set protocol */
classReqStatus = USBH_HID_SetProtocol(phost, 0U);
if (classReqStatus == USBH_OK)
{
HID_Handle->ctl_state = USBH_HID_REQ_IDLE;
/* all requests performed*/
phost->pUser(phost, HOST_USER_CLASS_ACTIVE);
status = USBH_OK;
}
else if (classReqStatus == USBH_NOT_SUPPORTED)
{
USBH_ErrLog("Control error: HID: Device Set protocol request failed");
status = USBH_FAIL;
}
else
{
/* .. */
}
break;
case USBH_HID_REQ_IDLE:
default:
break;
}
}
return status;
}
USBH_StatusTypeDef USBH_HID_Process(USBH_HandleTypeDef *phost)
{
USBH_StatusTypeDef status = USBH_OK;
for(int i=0;ipActiveClass->pData[i];
uint32_t XferSize;
switch (HID_Handle->state)
{
case USBH_HID_INIT:
HID_Handle->Init(phost);
HID_Handle->state = USBH_HID_IDLE;
#if (USBH_USE_OS == 1U)
phost->os_msg = (uint32_t)USBH_URB_EVENT;
#if (osCMSIS os_event, phost->os_msg, 0U);
#else
(void)osMessageQueuePut(phost->os_event, &phost->os_msg, 0U, 0U);
#endif
#endif
break;
case USBH_HID_IDLE:
status = USBH_HID_GetReport(phost, 0x01U, 0U, HID_Handle->pData, (uint8_t)HID_Handle->length);
if (status == USBH_OK)
{
HID_Handle->state = USBH_HID_SYNC;
}
else if (status == USBH_BUSY)
{
HID_Handle->state = USBH_HID_IDLE;
status = USBH_OK;
}
else if (status == USBH_NOT_SUPPORTED)
{
HID_Handle->state = USBH_HID_SYNC;
status = USBH_OK;
}
else
{
HID_Handle->state = USBH_HID_ERROR;
status = USBH_FAIL;
}
#if (USBH_USE_OS == 1U)
phost->os_msg = (uint32_t)USBH_URB_EVENT;
#if (osCMSIS os_event, phost->os_msg, 0U);
#else
(void)osMessageQueuePut(phost->os_event, &phost->os_msg, 0U, 0U);
#endif
#endif
break;
case USBH_HID_SYNC:
/* Sync with start of Even Frame */
if ((phost->Timer & 1U) != 0U)
{
HID_Handle->state = USBH_HID_GET_DATA;
}
#if (USBH_USE_OS == 1U)
phost->os_msg = (uint32_t)USBH_URB_EVENT;
#if (osCMSIS os_event, phost->os_msg, 0U);
#else
(void)osMessageQueuePut(phost->os_event, &phost->os_msg, 0U, 0U);
#endif
#endif
break;
case USBH_HID_GET_DATA:
(void)USBH_InterruptReceiveData(phost, HID_Handle->pData,
(uint8_t)HID_Handle->length,
HID_Handle->InPipe);
HID_Handle->state = USBH_HID_POLL;
HID_Handle->timer = phost->Timer;
HID_Handle->DataReady = 0U;
break;
case USBH_HID_POLL:
if (USBH_LL_GetURBState(phost, HID_Handle->InPipe) == USBH_URB_DONE)
{
XferSize = USBH_LL_GetLastXferSize(phost, HID_Handle->InPipe);
if ((HID_Handle->DataReady == 0U) && (XferSize != 0U))
{
(void)USBH_HID_FifoWrite(&HID_Handle->fifo, HID_Handle->pData, HID_Handle->length);
HID_Handle->DataReady = 1U;
USBH_HID_EventCallback(phost,i);
#if (USBH_USE_OS == 1U)
phost->os_msg = (uint32_t)USBH_URB_EVENT;
#if (osCMSIS os_event, phost->os_msg, 0U);
#else
(void)osMessageQueuePut(phost->os_event, &phost->os_msg, 0U, 0U);
#endif
#endif
}
}
else
{
/* IN Endpoint Stalled */
if (USBH_LL_GetURBState(phost, HID_Handle->InPipe) == USBH_URB_STALL)
{
/* Issue Clear Feature on interrupt IN endpoint */
if (USBH_ClrFeature(phost, HID_Handle->ep_addr) == USBH_OK)
{
/* Change state to issue next IN token */
HID_Handle->state = USBH_HID_GET_DATA;
}
}
}
break;
default:
break;
}
}
return status;
}

My_USB_MouseKey.h

下面展示一些 内联代码片


#ifndef __MY_USB_MOUSEKEY_H__
#define __MY_USB_MOUSEKEY_H__		
#include "main.h"	 
#include "usbh_def.h"
#include "usart.h"
#include "usbh_hid_mouse.h"
#include "usb_host.h"
#include "usbh_hid.h"
#include "usbh_hid_parser.h"
#ifdef __cplusplus
extern "C" {
#endif
typedef enum{
EXTRA_NULL=0,
LEFT_PRESSED,
RIGHT_PRESSED,
EXTRA_NULL2,
MIDDLE_PRESSED,
EXTRA_NULL3,
EXTRA_NULL4,
EXTRA_NULL5,
SIDE_PRESSED,
EXTRA_NULL6,
EXTRA_NULL7,
EXTRA_NULL8,
EXTRA_NULL9,
EXTRA_NULL10,
EXTRA_NULL11,
EXTRA_NULL12,
EXTRA_PRESSED,
}mouse_status;	
typedef enum{
MOVEMENT_NULL = 0,
UP,
DOWN,
LEFT,
RIGHT,
UP_LEFT,
UP_RIGHT,
DOWN_LEFT,
DOWN_RIGHT,
}mouse_movement_status;
extern void USBH_HID_ParseHIDDesc(HID_DescTypeDef *desc, uint8_t *buf);
extern ApplicationTypeDef Appli_state;	 
extern  HID_MOUSE_Info_TypeDef    mouse_info;
#ifdef __cplusplus
}
#endif
#endif 

这就是我的两个.c和.h文件,其中有一些要说明一下。先说.h文件。

我的.h文件里的#include不用说,都要包含进来,然后是mouse_status,这个枚举是用来最后对标鼠标按键用的枚举;mouse_movement_status是用来对标鼠标移动的枚举。其他的extern主要都是我自己写的函数要用到,所以要extern出来。

然后是.c文件的说明,上面的.c文件里,都是原来的Cubemx里生成的文件,但是要按照博主的方法修改的函数。

第三步,修改struct

我这里对标的是博主的第二步。

修改类结构体,原定义中只有一个数据接口,将这个改成数组形式,就可实现多个接口/类。
下面展示一些 内联代码片

/* USB Host Class structure */
typedef struct 
{
const char          *Name;
uint8_t              ClassCode;  
USBH_StatusTypeDef  (*Init)        (struct _USBH_HandleTypeDef *phost);
USBH_StatusTypeDef  (*DeInit)      (struct _USBH_HandleTypeDef *phost);
USBH_StatusTypeDef  (*Requests)    (struct _USBH_HandleTypeDef *phost);  
USBH_StatusTypeDef  (*BgndProcess) (struct _USBH_HandleTypeDef *phost);
USBH_StatusTypeDef  (*SOFProcess) (struct _USBH_HandleTypeDef *phost);  
void*                pData[USBH_MAX_NUM_INTERFACES];//原为pData修改为数组形式
} USBH_ClassTypeDef;

第四步,补充USBH_HID_EventCallbcak函数

这里对标博主的第五步。
补充USBH_HID_EventCallbcak函数。此函数被调用于USBH_HID_Process->case HID_POLL,当接收到数据填入fifo后,立即调用USBH_HID_EventCallbcak函数将数据读取到对应的fifo中,防止被下一接口数据覆盖。KeyboardFlag和MouseFlag 用于标记是哪个接口接收了数据。

关于我自己的修改:我这里的修改其实和博主不太一样,因为每次按下键盘或者鼠标都会触发这个函数,所以我把这个函数放在了我自己写的My_USB_MouseKey.h和My_USB_MouseKey.c中。原生的Cubemx的代码我也是直接__WEAK掉了。

Cubemx的代码修改:
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(7)

然后自己写了一遍,自己写的如下:
主要实现的函数是USBH_HID_MouseDecode(phost);和USBH_HID_GetASCIICode(k_pinfo);
但是这两个函数是Cubemx生成的,所以可以直接用。自己要写的数据处理函数是mouse_data_process(mouse_info);
keypad_data_process©;
这两个函数。
下面展示一些 内联代码片

void USBH_HID_EventCallback(USBH_HandleTypeDef *phost,uint8_t flag)
{
#include "usb_host.h"
#include "usbh_hid_mouse.h"
char c;
HID_KEYBD_Info_TypeDef *k_pinfo;
HID_MOUSE_Info_TypeDef *m_pinfo;
if(1 == flag)
{
m_pinfo = USBH_HID_GetMouseInfo(phost); 
if (m_pinfo != NULL)
{
//LED_0_State = 0;
USBH_HID_MouseDecode(phost);
mouse_data_process(mouse_info);
memset(m_pinfo ,0,sizeof(HID_MOUSE_Info_TypeDef ));
}
}
else
{
k_pinfo = USBH_HID_GetKeybdInfo(phost); /* ?????? */
if(k_pinfo == NULL)
{
uint8_t err = 0xff;
}
if (k_pinfo != NULL)
{
c = USBH_HID_GetASCIICode(k_pinfo); /* ???ASCII? */
keypad_data_process(c);
memset(k_pinfo ,0,sizeof(HID_KEYBD_Info_TypeDef ));
}
}
}
// An highlighted block

关于参考的博主的第六步和第七步

关于博主的第六步和第七步我都没有去做,第一是我发现做了以后,整个USB就跑不动了,不知道哪里出了问题,第二就是我觉得博主的第七步说的很对,根本不需要跑demo了,直接所有的都在USBH_HID_EventCallback里已经处理了。

关于运行后还有的一些错误

如果你按我的方法这样修改后,KEIL5一定还是会报一些错误,因为原生的Cubemx代码里还是有一些是static定义的,所以如果还有错误,你可以看下错误的地方,把host_hid.c里只要是自己__weak了的函数里的错误的全删除掉,因为只要__weak了,而且你重写了,就不会再跑__WEAK的函数。还可能有一些错误是识别不到函数,就要#include 一下啊,或者有些变量比如pdata或者下面改进的部分会出现的问题,加了Z在鼠标解码的结构体里,就要自己改下加一下。

关于我自己做的一些改进

我根据自己的硬件设备,做了一些读取USB键盘和鼠标的改进,因为原生的Cubemx生成的鼠标还有一些问题,现在的设备的鼠标的数据和Cubemx生成代码的解码还是有一些出入,这里说明一下这些有出入的地方和我自己的改进部分。

键盘的改进

我上面的代码里不是有实现keypad_data_process©;这个函数么,我这个函数就是输出一下按键到UART1这种调试接口,用电脑显示一下,我的函数如下:
下面展示一些 内联代码片

void keypad_data_process(uint8_t data)
{
printf("%c",data);
}	

鼠标的改进

因为原生的Cubmx生成的代码在鼠标上和现在的键盘鼠标一体的设备的出入比较大,所以在原生的Cubemx生成的代码上,还要做一些修改。

第一步

USBH_StatusTypeDef USBH_HID_MouseDecode(USBH_HandleTypeDef *phost)函数要修改。
修改后的函数如下,大家可以对比下Cubemx生成的代码,看下区别。
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(8)

第二步

我这里的是比原生的代码多出来的部分,我这里其实是增加了下面的这个prop_z,这个你们也可以按照我的方法自己加一下,主要是打开usbh_hid_mouse.c文件,差不多150行左右,复制prop_y,粘贴在prop_y下面,并且把mouse_report_data + 2改成mouse_report_data + 3就行了,其他的不变。
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(9)

第三步

这个.h里要加一个z,只有z才包含鼠标的上下移动的数据。
关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)插图(10)

这样就好了,这里我要说明下为啥要加这个。
首先,我发现mouse_info这个变量,也就是用HID_MOUSE_Info_TypeDef定义的是这样的,原生的代码只有x,y,buttons[3],这三个变量,但是我测试下来发现,x里面只有鼠标按键的左键、右键、中建、边按键、第二个边键的信息。y里面只有鼠标的左右移动的信息,所以还缺失了鼠标上下移动的信息。所以在原生的代码里,还要加上这条,才能实现鼠标的上下移动的代码。关于buttons[3],这个就没啥用了,但是每次发送回来的数据里button[3]都是一样的数据,所以可以当做是一种验证码,如果哪次发送回来的buttons【3】数据不一样,就说明这次是错误数据。

关于鼠标的解析

因为经过不断的测试,我的鼠标的y和z两个函数和上下左右的关联都有,所以必须要一起处理,单独处理的话,就会很容易解析出错,明明是左移数据,就可能会解析成左和下都有,所以花乐2个小时又不断测试修改,最后成了下面的这些函数。

我自己的鼠标的解析函数如下:

下面展示一些 内联代码片

int InterfaceIndex[USBH_MAX_NUM_INTERFACES] ={0};
uint8_t Pressed[5]={0};
void CLear_MousePressed()
{
for(int i =0;i255/2)
{
return UP;
}
else
{
return DOWN;
}
}
else
{
return 0;
}
}
else
{
if(status2 != 0)
{
if((status1>255/2) && (status2255/2) && (status2>255/2))
{
return UP_LEFT;//0,255,239
}
else
{
if((status1255/2))
{
return UP_RIGHT;//0,3,240
}
else
{
if((status1>255/2) && (status2<255/2))
{
return DOWN_LEFT;//0,254,31
}
else
{
return DOWN_RIGHT;//0,2,32
}
}
}
}
}
else
{
if(status1<255/2 )
{
return RIGHT;
}
}
}
return 0;
}
void Show_MouseMoved_Status(uint8_t status1,uint8_t status2)
{
switch(Movement_Measure(status1,status2))
{
case LEFT:{printf("左\r
");break;}
case RIGHT:{printf("右\r
");break;}
case UP:{printf("上\r
");break;}
case DOWN:{printf("下\r
");break;}
case UP_LEFT:{printf("左上\r
");break;}
case UP_RIGHT:{printf("右上\r
");break;}
case DOWN_LEFT:{printf("左下\r
");break;}
case DOWN_RIGHT:{printf("右下\r
");break;}
default:break;
}
}
void keypad_data_process(uint8_t data)
{
printf("%c",data);
}	
void mouse_data_process(HID_MOUSE_Info_TypeDef data)
{
if((data.buttons[0] == 0x00) &&(data.buttons[1] == 0x01)&&(data.buttons[2] == 0x00))
{
if(data.x !=0)
{
//鼠标按键
Show_MousePressed_Status(data.x);
}
if((data.y != 0x00)||(data.z != 0x00))
{
//鼠标移动
Show_MouseMoved_Status(data.y,data.z);
}
}
CLear_MousePressed();
}	

关于鼠标的知识

参考这位博主的文章,这位博主的解析是正确的。
链接: Linux之解析鼠标input事件数据

根据博主的解释,对应我们STM32的HID_MOUSE_Info_TypeDef的数据结构可知,x是鼠标按键,而且x是uint8_t的8位数据。
x的第一位是左键按下
x的第二位是右键按下
x的第三位是中键按下
x的第四位是边键按下
x的第5位是边2键按下

博主文章中的,data 数组的第1个字节:表示鼠标的水平位移;
也就是对应我们的y。

博主文章中的,data 数组的第2个字节:表示鼠标的垂直位移;
也就是对应我们自己新加的z。

关于后续

因为我这个项目只需要用到这几个按键,和移动,所以我也就测试到这里了,如果还有需要鼠标滚轮的事件的,可以参考
链接: Linux之解析鼠标input事件数据
这位博主的继续修改代码,读取滚轮的数据。

本站无任何商业行为
个人在线分享 » 关于怎么用Cubemx生成的USBHID设备实现读取一体的鼠标键盘设备(改进版)
E-->