第八十五章、CH32V103应用教程——USB Host

洛川飞鱼 · 发表于 2021-3-20 13:24

本帖最后由 RISCVLAR 于 2021-3-20 13:24 编辑

CH32V103应用教程——USB Host

本章教程主要使用CH32V103 USB用作主机模式，程序仅供参考。

1、USB简介及相关函数介绍

CH32V103芯片内嵌USB主从控制器及收发器，支持USB Host主机功能和USB Device设备功能。

在 USB 主机模式下，芯片提供了一组双向主机端点，包括一个发送端点 OUT 和一个接收端点 IN，一个数据包的最大长度是 1023 字节（V103），支持控制传输、中断传输、批量传输和实时/同步传输。

主机端点发起的每一个 USB 事务，在处理结束后总是自动设置RB_UIF_TRANSFER 中断标志。应用程序可以直接查询或在 USB 中断服务程序中查询并分析中断标志寄存器 R8_USB_INT_FG，根据各中断标志分别进行相应的处理；并且，如果 RB_UIF_TRANSFER 有效，那么还需要继续分析 USB 中断状态寄存器 R8_USB_INT_ST，根据当前 USB 传输事务的应答 PID 标识 MASK_UIS_H_RES 进行相应的处理。

如果事先设定了主机接收端点的 IN 事务的同步触发位（RB_UH_R_TOG），那么可以通过RB_U_TOG_OK 或者 RB_UIS_TOG_OK 判断当前所接收到的数据包的同步触发位是否与主机接收端点的同步触发位匹配，如果数据同步，则数据有效；如果数据不同步，则数据应该被丢弃。每次处理完USB 发送或者接收中断后，都应该正确修改相应主机端点的同步触发位，用于同步下次所发送的数据包和检测下次所接收的数据包是否同步；另外，通过设置 RB_UH_T_AUTO_TOG 和 RB_UH_R_AUTO_TOG可以实现在发送成功或接收成功后自动翻转相应的同步触发位。

USB 主机令牌设置寄存器 R8_UH_EP_PID 用于设置被操作的目标设备的端点号和本次 USB 传输事务的令牌 PID 包标识。SETUP 令牌和 OUT 令牌所对应的数据由主机发送端点提供，准备发送的数据在R16_UH_TX_DMA 缓冲区中，准备发送的数据长度设置在 R16_UH_TX_LEN 中；IN 令牌所对应数据由目标设备返回给主机接收端点，接收到数据存放 R16_UH_RX_DMA 缓冲区中，接收到的数据长度存放在R8_USB_RX_LEN 中。

关于USB主机模式具体信息以及寄存器相关描述，可参考CH32V103应用手册。

2、硬件设计

本章教程主要进行USB主机模式实验，仅需用到开发板USB口。

3、软件设计

本章程序全在主函数中进行，具体程序如下：

main.c文件

复制

/********************************** (C) COPYRIGHT *******************************

* File Name          : main.c

* Author             : WCH

* Version            : V1.0.0

* Date               : 2019/10/15

* Description        : Main program body.

*******************************************************************************/



/*

 *@Note

  USB设备的简易枚举过程例程：

  USBHDM(PB6)、USBHDP(PB7)。

*/



#include "debug.h"

#include "string.h"

#include "ch32v10x_conf.h"



/* Global Variable */

__attribute__ ((aligned(4))) UINT8  RxBuffer[MAX_PACKET_SIZE] ;      // IN, must even address

__attribute__ ((aligned(4))) UINT8  TxBuffer[MAX_PACKET_SIZE] ;      // OUT, must even address

__attribute__ ((aligned(4))) UINT8  Com_Buffer[128];



_DevOnHubPort  DevOnHubPort[HUB_MAX_PORTS];

_RootHubDev  ThisUsbDev;



/*******************************************************************************

* Function Name  : Set_USBConfig

* Description    : Set USB clock.

* Input          : None

* Return         : None

*******************************************************************************/

void USBHD_ClockCmd(UINT32 RCC_USBCLKSource,FunctionalState NewState)

{

    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, NewState);

    EXTEN->EXTEN_CTR |= EXTEN_USBHD_IO_EN;

    RCC_USBCLKConfig(RCC_USBCLKSource);             //USBclk=PLLclk/1.5=48Mhz

    RCC_AHBPeriphClockCmd(RCC_AHBPeriph_USBHD,NewState);

}



/*******************************************************************************

* Function Name  : main

* Description    : Main program.

* Input          : None

* Return         : None

*******************************************************************************/

int main()

{

    UINT8   s;

    UINT8   i, k, len, endp;

    UINT16  loc;



    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);

    Delay_Init();

    USART_Printf_Init(115200);



    printf("SystemClk:%d\r\n",SystemCoreClock);

    printf("USBHD HOST Test\r\n");



    USBHD_ClockCmd(RCC_USBCLKSource_PLLCLK_1Div5,ENABLE);



    pHOST_RX_RAM_Addr = RxBuffer;

    pHOST_TX_RAM_Addr = TxBuffer;



    USB_HostInit();  //初始化USB主机模式



    printf( "Wait Device In\n" );



    while(1)

    {

        s = ERR_SUCCESS;



        //RB_UIF_DETECT：USB主机模式下USB设备连接或断开事件中断标志位

        if ( R8_USB_INT_FG & RB_UIF_DETECT )

        {

            R8_USB_INT_FG = RB_UIF_DETECT ;      //检测到USB设备连接或断开触发



            s = AnalyzeRootHub( );               //分析跟集线器状态



            if ( s == ERR_USB_CONNECT )          //如果检测到设备连接

            {

                printf( "New Device In\r\n" );

                FoundNewDev = 1;

            }

            if( s == ERR_USB_DISCON )            //如果检测到设备断开连接

            {

                printf( "Device Out\r\n" );

            }

        }



        if ( FoundNewDev || s == ERR_USB_CONNECT )     //如果检测到有USB设备连接

        {

            FoundNewDev = 0;

            s = EnumAllRootDevice( );                  //枚举所有ROOT-HUB端口的USB设备

            if ( s == ERR_SUCCESS )                    //如果枚举成功

            {

                printf( "Device Enum Succeed\r\n" );

            }

            else                                       //如果枚举失败

            {

                printf( "Device Enum Failed\r\n" );

                printf( "EnumAllRootDev err = %02X\n", (UINT16)s );

            }

        }



        //如果CH32V103下端连接的是HUB，则先枚举HUB

        s = EnumAllHubPort( );                                     //枚举所有ROOT-HUB端口下外部HUB后的二级USB设备

        if ( s != ERR_SUCCESS )                                    //可能是HUB断开了

        {

            printf( "EnumAllHubPort err = %02X\n", (UINT16)s );

        }



        //如果设备是鼠标

        loc = SearchTypeDevice( DEV_TYPE_MOUSE );      // 在ROOT-HUB以及外部HUB各端口上搜索指定类型的设备所在的端口号



        //printf("loc=%d\n",loc);



        if ( loc != 0xFFFF )                           // 找到了,如果有两个MOUSE如何处理?

        {

            //printf( "Query Mouse @%04X\n", loc );



            i = (UINT8)( loc >> 8 );



            len = (UINT8)loc;



            //printf("len=%d\n",len);



            SelectHubPort( len );                                            // 选择操作指定的ROOT-HUB端口,设置当前USB速度以及被操作设备的USB地址



            //printf("len1=%d\n",len);



            endp = len ? DevOnHubPort[len-1].GpVar[0] : ThisUsbDev.GpVar[0]; // 中断端点的地址,位7用于同步标志位



            //printf("endp=%d\n",endp);



            if ( endp & USB_ENDP_ADDR_MASK )                                 // 端点有效

            {



                s = USBHostTransact( USB_PID_IN << 4 | (endp & 0x7F), endp & 0x80 ? RB_UH_R_TOG | RB_UH_T_TOG : 0, 0 );// CH32传输事务,获取数据,NAK不重试



                if ( s == ERR_SUCCESS )

                {

                    endp ^= 0x80;                                            // 同步标志翻转



                    if ( len ) DevOnHubPort[len-1].GpVar[0] = endp;          // 保存同步标志位



                    else ThisUsbDev.GpVar[0] = endp;



                    len = R8_USB_RX_LEN;                                     // 接收到的数据长度



                    if ( len )

                    {

                        printf("Mouse data: ");



                        for ( i = 0; i < len; i ++ )

                        {

                            printf("x%02X ",(UINT16)(RxBuffer[i]) );

                        }



                        printf("\n");

                    }

                }

                else if ( s != ( USB_PID_NAK | ERR_USB_TRANSFER ) )

                {

                    printf("Mouse error %02x\n",(UINT16)s);                  // 可能是断开了

                }

            }

            else

            {

                printf("Mouse no interrupt endpoint\n");

            }

            SetUsbSpeed( 1 );                                                // 默认为全速

        }



        //如果设备是键盘

        loc = SearchTypeDevice( DEV_TYPE_KEYBOARD );                         // 在ROOT-HUB以及外部HUB各端口上搜索指定类型的设备所在的端口号

        if ( loc != 0xFFFF )                                                 // 找到了,如果有两个KeyBoard如何处理?

        {

            //printf( "Query Keyboard @%04X\n", loc );



            i = (UINT8)( loc >> 8 );



            len = (UINT8)loc;



            SelectHubPort( len );                                            // 选择操作指定的ROOT-HUB端口,设置当前USB速度以及被操作设备的USB地址



            endp = len ? DevOnHubPort[len-1].GpVar[0] : ThisUsbDev.GpVar[0]; // 中断端点的地址,位7用于同步标志位



            //printf("%02X  ",endp);

            if ( endp & USB_ENDP_ADDR_MASK )                                 // 端点有效

            {

                s = USBHostTransact( USB_PID_IN << 4 | (endp & 0x7F), endp & 0x80 ? RB_UH_R_TOG | RB_UH_T_TOG : 0, 0 );// CH32传输事务,获取数据,NAK不重试

                if ( s == ERR_SUCCESS )

                {

                    endp ^= 0x80;                                            // 同步标志翻转



                    if ( len ) DevOnHubPort[len-1].GpVar[0] = endp;          // 保存同步标志位



                    else ThisUsbDev.GpVar[0] = endp;



                    len = R8_USB_RX_LEN;                                     // 接收到的数据长度



                    if ( len )

                    {

                        SETorOFFNumLock(RxBuffer);

                        printf("keyboard data: ");

                        for ( i = 0; i < len; i ++ )

                        {

                            printf("x%02X ",(UINT16)(RxBuffer[i]) );

                        }

                        printf("\n");

                    }

                }

                else if ( s != ( USB_PID_NAK | ERR_USB_TRANSFER ) )

                {

                    printf("keyboard error %02x\n",(UINT16)s);               // 可能是断开了

                }

            }

            else

            {

                printf("keyboard no interrupt endpoint\n");

            }

            SetUsbSpeed( 1 );                                                // 默认为全速

        }





//      //操作USB打印机

//      if(GPIO_ReadOutputDataBit(GPIOA,GPIO_Pin_1) == 0)              //PA1为低，开始打印

//      {

//          memset(TxBuffer,0,sizeof(TxBuffer));

//

//          TxBuffer[0]=0x1B;TxBuffer[1]=0x40;TxBuffer[2]=0x1D;TxBuffer[3]=0x55;TxBuffer[4]=0x42;TxBuffer[5]=0x02;TxBuffer[6]=0x18;TxBuffer[7]=0x1D;

//          TxBuffer[8]=0x76;TxBuffer[9]=0x30;TxBuffer[10]=0x00;TxBuffer[11]=0x30;TxBuffer[12]=0x00;TxBuffer[13]=0x18;



            loc = SearchTypeDevice( USB_DEV_CLASS_PRINTER );                 // 在ROOT-HUB以及外部HUB各端口上搜索指定类型的设备所在的端口号



            if ( loc != 0xFFFF )                                             // 找到了,如果有两个打印机如何处理?

            {

                //printf( "Query Printer @%04X\n", loc );



                i = (UINT8)( loc >> 8 );



                len = (UINT8)loc;



                SelectHubPort( len );                                             // 选择操作指定的ROOT-HUB端口,设置当前USB速度以及被操作设备的USB地址



                endp = len ? DevOnHubPort[len-1].GpVar[0] : ThisUsbDev.GpVar[0];  // 端点的地址,位7用于同步标志位



                //printf("%02X  ",endp);



                if ( endp & USB_ENDP_ADDR_MASK )                                  // 端点有效

                {



                    R8_UH_TX_LEN = 64;                                            // 默认无数据故状态阶段为IN



                    s = USBHostTransact( USB_PID_OUT << 4 | (endp & 0x7F), endp & 0x80 ? RB_UH_R_TOG | RB_UH_T_TOG : 0, 0xffff );// CH554传输事务,获取数据,NAK重试



                    if ( s == ERR_SUCCESS )

                    {

                        endp ^= 0x80;                                             // 同步标志翻转



                        memset(TxBuffer,0,sizeof(TxBuffer));



                        R8_UH_TX_LEN = 64;                                        // 默认无数据故状态阶段为IN



                        s = USBHostTransact( USB_PID_OUT << 4 | (endp & 0x7F), endp & 0x80 ? RB_UH_R_TOG | RB_UH_T_TOG : 0, 0xffff );// CH554传输事务,获取数据,NAK重试



                    }

                    else if ( s != ( USB_PID_NAK | ERR_USB_TRANSFER ) )



                    printf("Printer error %02x\n",(UINT16)s); // 可能是断开了

                }

            }

//      }



        //操作HID复合设备

        loc = SearchTypeDevice( USB_DEV_CLASS_HID );                              // 在ROOT-HUB以及外部HUB各端口上搜索指定类型的设备所在的端口号



        if ( loc != 0xFFFF )                                                      // 找到了

        {

            //printf( "Query USB_DEV_CLASS_HID @%04X\n", loc );



            loc = (UINT8)loc;



            for(k=0;k!=4;k++)

            {

                //端点是否有效？

                endp = loc ? DevOnHubPort[loc-1].GpVar[k] : ThisUsbDev.GpVar[k];  // 中断端点的地址,位7用于同步标志位



                if ( (endp & USB_ENDP_ADDR_MASK) == 0 ) break;



                //printf("endp: %02X\n",(UINT16)endp);



                SelectHubPort( loc );                                             // 选择操作指定的ROOT-HUB端口,设置当前USB速度以及被操作设备的USB地址



                s = USBHostTransact( USB_PID_IN << 4 | (endp & 0x7F), endp & 0x80 ? RB_UH_R_TOG | RB_UH_T_TOG : 0, 0 );// CH554传输事务,获取数据,NAK不重试

                if ( s == ERR_SUCCESS )

                {

                    endp ^= 0x80;                                                 // 同步标志翻转



                    if ( loc ) DevOnHubPort[loc-1].GpVar[k] = endp;               // 保存同步标志位



                    else ThisUsbDev.GpVar[k] = endp;



                    len = R8_USB_RX_LEN;                                          // 接收到的数据长度



                    if ( len )

                    {

                        printf("keyboard data: ");

                        for ( i = 0; i < len; i ++ )

                      {

                            printf("x%02X ",(UINT16)(RxBuffer[i]) );

                        }

                        printf("\n");

                    }

                }

                else if ( s != ( USB_PID_NAK | ERR_USB_TRANSFER ) )

                {

                    printf("keyboard error %02x\n",(UINT16)s);                    // 可能是断开了

                }



            }

            SetUsbSpeed( 1 );                                                     // 默认为全速

        }

    }

}

main.c文件主要进行插入设备的检测、识别以及数据的传输，具体可见程序和注释。

4、下载验证

将编译好的程序下载到开发板并复位，打开串口调试助手，串口打印如下：

当插入鼠标设备并移动鼠标时，串口打印显示如下：

其他设备与之类似，不再一一附图展示。

发表于 2022-1-13 15:43

USBHDM(PB6)、USBHDP(PB7)。
-----------------------------------------------------
这个DEMO是配合103的吧。但是103只有1个USB，口线是 USBHDM(PA11)、USBHDP(PA12)。
笔误》还是其他的MCU的demo没有变更过来？

发表于 2022-1-13 16:41

这个demo是官网的嘛？我发现官网的demo里面内容没有那么多。其中的官网.h文件内容少很多。求大神指点。

发表于 2022-1-13 16:44

ch32v10x_usb_host.h 和 ch32v10x_usb_host.c 官网的写的很少。

发表于 2022-1-13 19:15

huangyu_ninbo 发表于 2022-1-13 16:41
这个demo是官网的嘛？我发现官网的demo里面内容没有那么多。其中的官网.h文件内容少很多。求大神指点。 ...

非官方例程例程，移植例程，仅供参考

发表于 2022-1-17 13:09

上传的附件打不开

发表于 2022-12-3 12:11

这个需要设置驱动程序的吗？

发表于 2022-12-5 21:22

USB Host最大传输字节是多少的？

[RISC-V MCU 应用开发] 第八十五章、CH32V103应用教程——USB Host

评论

相关帖子

浏览过的版块

浏览过的版块