docs: update readme

Signed-off-by: sakumisu <1203593632@qq.com>
This commit is contained in:
sakumisu
2025-08-02 17:55:46 +08:00
parent 20ceaced92
commit 3905eff2f4
6 changed files with 42 additions and 13 deletions

View File

@@ -40,6 +40,8 @@ Taking into account USB performance issues and trying to achieve the theoretical
- Unlimited length make it easier to interface with hardware DMA and take advantage of DMA
- Packetization is handled in interrupt
Performance showhttps://cherryusb.cherry-embedded.org/show/
## Directory Structure
| Directory | Description |

View File

@@ -40,6 +40,8 @@ CherryUSB 是一个小而美的、可移植性高的、用于嵌入式系统(
- 长度无限制,方便对接硬件 DMA 并且发挥 DMA 的优势
- 分包过程在中断中执行
性能展示https://cherryusb.cherry-embedded.org/show/
## 目录结构
| 目录名 | 描述 |

View File

@@ -10,11 +10,12 @@ Q & A
提问中请包含以下信息:
- 使用的版本
- 使用的板子引脚USB IP
- 是否配置 USB 中断USB 时钟USB 引脚USB phy 配置,以及 USB 寄存器地址是否正确,截图
- 是否能进 USB 中断
- 芯片是否带有 cache功能是否做了 no cache 处理,截图
- 硬件是否正常,是否使用杜邦线连接,如果正常,请说明正常原因
- USB 电路是否画正确,是否使用杜邦线连接,是否直连,如果正常,请说明正常原因
- 如果能进中断,配置 **#define CONFIG_USB_DBG_LEVEL USB_DBG_LOG** 并提供 log仅限商业 IP, 其余 IP 禁止开启 log否则无法枚举
- 是否流片并销售
@@ -65,7 +66,6 @@ CONFIG_USB_HS 何时使用
当你的芯片硬件支持高速,并想初始化成高速模式时开启,相关 IP 会根据该宏配置内部或者外部 高速 PHY。
Failed to enable port
----------------------------------------------------------------
@@ -75,3 +75,24 @@ Failed to enable port
----------------------------------------------------------------
检查 phy 配置cache 配置(如果有),电源供电(建议自供电)
USB_ERR_NAK 说明
----------------------------------------------------------------
USB_ERR_NAK 只存在于 DWC2 buffer dma 模式DWC2 在 buffer dma模式下对于中断传输不支持硬件处理 NAK 中断,因此需要软件处理,导致 NAK 中断非常多,建议搭配定时器使用。
DWC2 scatter/gather dma 模式下全部由硬件处理,但是不支持 split 传输。总结, **半斤 IP**
USB host 连接 USB 网卡问题
----------------------------------------------------------------
表现为能识别网卡并且分配到 IP 地址,但是无法 ping 通,这是因为网卡自身需要开启自动拨号,通常需要使用 AT 口设置。具体为 EC20/ML307 等模块。
PC 识别的 COM 口如何更改名称
----------------------------------------------------------------
这是微软对 CDC ACM 的驱动问题,无法修改,如需修改,请联系微软并缴纳费用即可更改。
connect 和 disconnect event 不触发
----------------------------------------------------------------
当前仅 hpm 芯片支持 connect 和 disconnect 事件,其他芯片请使用 USB 检测 vbus 电路。DWC2 IP 支持但是由于需要占用引脚并且大多是log 口,
然后不同使能的配置也不一样,因此不做支持。

View File

@@ -1,10 +1,10 @@
# Note
If you are using more than one port, all ip parameters must be the same(like fifo num, endpoint num, dma support and so on), otherwise give up using multi ports.
Please note that host must support dma mode.
## Support Chip List
## STM32
### STM32
**有且仅有 PB14/PB15 引脚支持 host 模式, 部分 F7/H7 可能 PA11/PA12 也支持**
@@ -16,13 +16,13 @@ If you are using more than one port, all ip parameters must be the same(like fif
- STM32L4xx
- STM32U5xx
## AT32
### AT32
**有且仅有 AT32F405xx PB14/PB15引脚支持 host 模式**
- AT32F402xx、AT32F405xx、AT32F415xx、AT32F423xx、AT32F425xx、AT32F435xx、AT32F437xx
## GD32
### GD32
**由于无法读取 DWC2 配置信息,并且有部分寄存器是非标准的,因此暂时无法支持 GD 系列**
@@ -30,22 +30,22 @@ If you are using more than one port, all ip parameters must be the same(like fif
- GD32F405、GD32F407
- GD32F350、GD32F450
## HC32
### HC32
- HC32F4A0
## Espressif
### Espressif
- ESP32S2、ESP32S3、ESP32P4
## Sophgo
### Sophgo
- CV18xx
## Kendryte
### Kendryte
- K230
## Nationstech
### Nationstech
- N32H4X

View File

@@ -17,3 +17,7 @@
### AllwinnerTech
- F1Cxxx, F2Cxxx
### SIFLI
- SF325X

View File

@@ -12,6 +12,6 @@ Modify USB_NOCACHE_RAM_SECTION
- MCXN9XX/MCXN236 (chipidea + EHCI)
## IMRT
### IMRT
- IMRT10XX/IMRT11XX (chipidea + EHCI)