让开发板畅游网络：RT-Thread CherryUSB 驱动 RNDIS 模块详解 | 技术集结

本文通过在 RT-Thread 操作系统上，使用CherryUSB 软件包作为USB Host 协议栈，驱动AIR780E 4G Cat.1 模块 的 RNDIS 功能，并成功接入lwIP 网络协议栈，最终在开发板上实现了通过 4G 模块上网的功能，以STM32F429为例。

目录

新建工程

配置cubemx

配置cherryusb

main.c添加代码

完成

1 新建工程

2 配置cubemx

四大件不过多赘述

打开USB HOST功能

打开USB HOST中断

cubemx配置到此结束，点击生成工程，关闭cubemx

3 配置cherryusb

先编译一下工程，发现会有个报错：

把RT_WEAK删掉重新编译就不会报错了

然后打开RT-Thread Settings,添加软件包

配置cherryusb

其实这里可以只打开rndis，不打开CDC ACM也能驱动air780实现LWIP上网，但是终端会一大堆报红提示不支持CDC ACM，强迫症难受所以干脆打开

这时候保存，编译会有一大堆报错，不慌，一个一个解决：

1

usb_config.h报错

解决办法，在applications文件夹下添加usb_config.h代码内容如下：

/** Copyright (c) 2022, sakumisu** SPDX-License-Identifier: Apache-2.0*/#ifndefCHERRYUSB_CONFIG_H#defineCHERRYUSB_CONFIG_H/* ================ USB common Configuration ================ */#defineCONFIG_USB_PRINTF(...) printf(__VA_ARGS__)#ifndefCONFIG_USB_DBG_LEVEL#defineCONFIG_USB_DBG_LEVEL USB_DBG_INFO#endif/* Enable print with color */#defineCONFIG_USB_PRINTF_COLOR_ENABLE/* data align size when use dma */#ifndefCONFIG_USB_ALIGN_SIZE#defineCONFIG_USB_ALIGN_SIZE 4#endif/* attribute data into no cache ram */#defineUSB_NOCACHE_RAM_SECTION __attribute__((section(".noncacheable")))/* ================= USB Device Stack Configuration ================ *//* Ep0 in and out transfer buffer */#ifndefCONFIG_USBDEV_REQUEST_BUFFER_LEN#defineCONFIG_USBDEV_REQUEST_BUFFER_LEN 512#endif/* Setup packet log for debug */// #define CONFIG_USBDEV_SETUP_LOG_PRINT/* Check if the input descriptor is correct */// #define CONFIG_USBDEV_DESC_CHECK/* Enable test mode */// #define CONFIG_USBDEV_TEST_MODE#ifndefCONFIG_USBDEV_MSC_MAX_LUN#defineCONFIG_USBDEV_MSC_MAX_LUN 1#endif#ifndefCONFIG_USBDEV_MSC_MAX_BUFSIZE#defineCONFIG_USBDEV_MSC_MAX_BUFSIZE 512#endif#ifndefCONFIG_USBDEV_MSC_MANUFACTURER_STRING#defineCONFIG_USBDEV_MSC_MANUFACTURER_STRING""#endif#ifndefCONFIG_USBDEV_MSC_PRODUCT_STRING#defineCONFIG_USBDEV_MSC_PRODUCT_STRING""#endif#ifndefCONFIG_USBDEV_MSC_VERSION_STRING#defineCONFIG_USBDEV_MSC_VERSION_STRING"0.01"#endif// #define CONFIG_USBDEV_MSC_THREAD#ifndefCONFIG_USBDEV_MSC_PRIO#defineCONFIG_USBDEV_MSC_PRIO 4#endif#ifndefCONFIG_USBDEV_MSC_STACKSIZE#defineCONFIG_USBDEV_MSC_STACKSIZE 2048#endif#ifndefCONFIG_USBDEV_RNDIS_RESP_BUFFER_SIZE#defineCONFIG_USBDEV_RNDIS_RESP_BUFFER_SIZE 156#endif#ifndefCONFIG_USBDEV_RNDIS_ETH_MAX_FRAME_SIZE#defineCONFIG_USBDEV_RNDIS_ETH_MAX_FRAME_SIZE 2048#endif#ifndefCONFIG_USBDEV_RNDIS_VENDOR_ID#defineCONFIG_USBDEV_RNDIS_VENDOR_ID 0x0000ffff#endif#ifndefCONFIG_USBDEV_RNDIS_VENDOR_DESC#defineCONFIG_USBDEV_RNDIS_VENDOR_DESC"CherryUSB"#endif#defineCONFIG_USBDEV_RNDIS_USING_LWIP/* ================ USB HOST Stack Configuration ================== */#defineCONFIG_USBHOST_MAX_RHPORTS 1#defineCONFIG_USBHOST_MAX_EXTHUBS 1#defineCONFIG_USBHOST_MAX_EHPORTS 4#defineCONFIG_USBHOST_MAX_INTERFACES 8#defineCONFIG_USBHOST_MAX_INTF_ALTSETTINGS 8#defineCONFIG_USBHOST_MAX_ENDPOINTS 4#defineCONFIG_USBHOST_MAX_CDC_ACM_CLASS 4#defineCONFIG_USBHOST_MAX_HID_CLASS 4#defineCONFIG_USBHOST_MAX_MSC_CLASS 2#defineCONFIG_USBHOST_MAX_AUDIO_CLASS 1#defineCONFIG_USBHOST_MAX_VIDEO_CLASS 1#defineCONFIG_USBHOST_DEV_NAMELEN 16#ifndefCONFIG_USBHOST_PSC_PRIO#defineCONFIG_USBHOST_PSC_PRIO 0#endif#ifndefCONFIG_USBHOST_PSC_STACKSIZE#defineCONFIG_USBHOST_PSC_STACKSIZE 2048#endif//#define CONFIG_USBHOST_GET_STRING_DESC// #define CONFIG_USBHOST_MSOS_ENABLE#ifndefCONFIG_USBHOST_MSOS_VENDOR_CODE#defineCONFIG_USBHOST_MSOS_VENDOR_CODE 0x00#endif/* Ep0 max transfer buffer */#ifndefCONFIG_USBHOST_REQUEST_BUFFER_LEN#defineCONFIG_USBHOST_REQUEST_BUFFER_LEN 2048#endif#ifndefCONFIG_USBHOST_CONTROL_TRANSFER_TIMEOUT#defineCONFIG_USBHOST_CONTROL_TRANSFER_TIMEOUT 500#endif#ifndefCONFIG_USBHOST_MSC_TIMEOUT#defineCONFIG_USBHOST_MSC_TIMEOUT 5000#endif/* This parameter affects usb performance, and depends on (TCP_WND)tcp eceive windows size,* you can change with 2K,4K,8K,16K,default is 2K to get one TCP_MSS*/#ifndefCONFIG_USBHOST_RNDIS_ETH_MAX_RX_SIZE#defineCONFIG_USBHOST_RNDIS_ETH_MAX_RX_SIZE (2048)#endif#ifndefCONFIG_USBHOST_RNDIS_ETH_MAX_TX_SIZE#defineCONFIG_USBHOST_RNDIS_ETH_MAX_TX_SIZE (2048)#endif/* This parameter affects usb performance, and depends on (TCP_WND)tcp eceive windows size,* you can change with 2K,4K,8K,16K,default is 2K to get one TCP_MSS*/#ifndefCONFIG_USBHOST_CDC_NCM_ETH_MAX_RX_SIZE#defineCONFIG_USBHOST_CDC_NCM_ETH_MAX_RX_SIZE (2048)#endif#ifndefCONFIG_USBHOST_CDC_NCM_ETH_MAX_TX_SIZE#defineCONFIG_USBHOST_CDC_NCM_ETH_MAX_TX_SIZE (2048)#endif/* This parameter affects usb performance, and depends on (TCP_WND)tcp eceive windows size,* you can change to 2K ~ 16K and must be larger than TCP RX windows size in order to avoid being overflow.*/#ifndefCONFIG_USBHOST_ASIX_ETH_MAX_RX_SIZE#defineCONFIG_USBHOST_ASIX_ETH_MAX_RX_SIZE (2048)#endif/* Because lwip do not support multi pbuf at a time, so increasing this variable has no performance improvement */#ifndefCONFIG_USBHOST_ASIX_ETH_MAX_TX_SIZE#defineCONFIG_USBHOST_ASIX_ETH_MAX_TX_SIZE (2048)#endif/* This parameter affects usb performance, and depends on (TCP_WND)tcp eceive windows size,* you can change to 2K ~ 16K and must be larger than TCP RX windows size in order to avoid being overflow.*/#ifndefCONFIG_USBHOST_RTL8152_ETH_MAX_RX_SIZE#defineCONFIG_USBHOST_RTL8152_ETH_MAX_RX_SIZE (2048)#endif/* Because lwip do not support multi pbuf at a time, so increasing this variable has no performance improvement */#ifndefCONFIG_USBHOST_RTL8152_ETH_MAX_TX_SIZE#defineCONFIG_USBHOST_RTL8152_ETH_MAX_TX_SIZE (2048)#endif#defineCONFIG_USBHOST_BLUETOOTH_HCI_H4// #define CONFIG_USBHOST_BLUETOOTH_HCI_LOG#ifndefCONFIG_USBHOST_BLUETOOTH_TX_SIZE#defineCONFIG_USBHOST_BLUETOOTH_TX_SIZE 2048#endif#ifndefCONFIG_USBHOST_BLUETOOTH_RX_SIZE#defineCONFIG_USBHOST_BLUETOOTH_RX_SIZE 2048#endif/* ================ USB Device Port Configuration ================*/#ifndefCONFIG_USBDEV_MAX_BUS#defineCONFIG_USBDEV_MAX_BUS 1// for now, bus num must be 1 except hpm ip#endif#ifndefCONFIG_USBDEV_EP_NUM#defineCONFIG_USBDEV_EP_NUM 6#endif/* ---------------- FSDEV Configuration ---------------- *///#define CONFIG_USBDEV_FSDEV_PMA_ACCESS 2 // maybe 1 or 2, many chips may have a difference/* ---------------- DWC2 Configuration ---------------- */// #define CONFIG_USB_DWC2_RXALL_FIFO_SIZE (320)// #define CONFIG_USB_DWC2_TX0_FIFO_SIZE (64 / 4)// #define CONFIG_USB_DWC2_TX1_FIFO_SIZE (512 / 4)// #define CONFIG_USB_DWC2_TX2_FIFO_SIZE (64 / 4)// #define CONFIG_USB_DWC2_TX3_FIFO_SIZE (64 / 4)// #define CONFIG_USB_DWC2_TX4_FIFO_SIZE (0 / 4)// #define CONFIG_USB_DWC2_TX5_FIFO_SIZE (0 / 4)// #define CONFIG_USB_DWC2_TX6_FIFO_SIZE (0 / 4)// #define CONFIG_USB_DWC2_TX7_FIFO_SIZE (0 / 4)// #define CONFIG_USB_DWC2_TX8_FIFO_SIZE (0 / 4)/* ---------------- MUSB Configuration ---------------- */// #define CONFIG_USB_MUSB_SUNXI/* ================ USB Host Port Configuration ==================*/#ifndefCONFIG_USBHOST_MAX_BUS#defineCONFIG_USBHOST_MAX_BUS 1#endif#ifndefCONFIG_USBHOST_PIPE_NUM#defineCONFIG_USBHOST_PIPE_NUM 12#endif/* ---------------- EHCI Configuration ---------------- */#defineCONFIG_USB_EHCI_HCCR_OFFSET (0x0)#defineCONFIG_USB_EHCI_FRAME_LIST_SIZE 1024#defineCONFIG_USB_EHCI_QH_NUM CONFIG_USBHOST_PIPE_NUM#defineCONFIG_USB_EHCI_QTD_NUM 3#defineCONFIG_USB_EHCI_ITD_NUM 20// #define CONFIG_USB_EHCI_HCOR_RESERVED_DISABLE// #define CONFIG_USB_EHCI_CONFIGFLAG// #define CONFIG_USB_EHCI_ISO// #define CONFIG_USB_EHCI_WITH_OHCI/* ---------------- OHCI Configuration ---------------- */#defineCONFIG_USB_OHCI_HCOR_OFFSET (0x0)/* ---------------- XHCI Configuration ---------------- */#defineCONFIG_USB_XHCI_HCCR_OFFSET (0x0)/* ---------------- DWC2 Configuration ---------------- *//* largest non-periodic USB packet used / 4 */#defineCONFIG_USB_DWC2_NPTX_FIFO_SIZE (512 / 4)/* largest periodic USB packet used / 4 */#defineCONFIG_USB_DWC2_PTX_FIFO_SIZE (1024 / 4)/** (largest USB packet used / 4) + 1 for status information + 1 transfer complete +* 1 location each for Bulk/Control endpoint for handling NAK/NYET scenario*/#defineCONFIG_USB_DWC2_RX_FIFO_SIZE ((1012 - CONFIG_USB_DWC2_NPTX_FIFO_SIZE - CONFIG_USB_DWC2_PTX_FIFO_SIZE))/* ---------------- MUSB Configuration ---------------- */// #define CONFIG_USB_MUSB_SUNXI#endif

然后再次编译，报错少了很多

2

RT_TIMER_THREAD_STACK_SIZE问题

解决办法

注意，也要将空闲线程栈调大

3

lwip版本问题

解决办法，使用lwip2.1.2

4

lwip接收线程问题

解决办法，关闭lwip接收线程

5

lwip线程堆栈问题

解决办法增大线程堆栈

6

链接脚本问题

解决办法，在链接脚本里增加代码

/* section information for USB Host class (CherryUSB) */ . =ALIGN(4); __usbh_class_info_start__ = .; KEEP(*(.usbh_class_info)) __usbh_class_info_end__ = .;

再次编译，没有问题

4 main.c添加代码

#include#defineDBG_TAG"main"#defineDBG_LVL DBG_LOG#include#include#include"usbh_core.h"#include"lwip/tcpip.h"intmain(void){ usbh_initialize(0, USB_OTG_HS_PERIPH_BASE);returnRT_EOK;

5 完成

烧录之后终端信息：

输入ping命令：