summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorsakumisu <[email protected]>2025-08-02 17:55:46 +0800
committersakumisu <[email protected]>2025-08-02 17:55:46 +0800
commit3905eff2f4a0c99fc51ff695b7ba78146531aed3 (patch)
tree16e56953b6f440af09125e4176b5a504081ffe22
parent20ceaced928ea5959d05c37296907e1e85e7336d (diff)
docs: update readme
Signed-off-by: sakumisu <[email protected]>
-rw-r--r--README.md2
-rw-r--r--README_zh.md2
-rw-r--r--docs/source/q&a.rst27
-rw-r--r--port/dwc2/README.md18
-rw-r--r--port/musb/README.md4
-rw-r--r--port/nxp/README.md2
6 files changed, 42 insertions, 13 deletions
diff --git a/README.md b/README.md
index fcb6f13c..890e4bfb 100644
--- a/README.md
+++ b/README.md
@@ -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 show:https://cherryusb.cherry-embedded.org/show/
+
## Directory Structure
| Directory | Description |
diff --git a/README_zh.md b/README_zh.md
index c0ff9133..8e52f84b 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -40,6 +40,8 @@ CherryUSB 是一个小而美的、可移植性高的、用于嵌入式系统(�
- 长度无限制,方便对接硬件 DMA 并且发挥 DMA 的优势
- 分包过程在中断中执行
+性能展示:https://cherryusb.cherry-embedded.org/show/
+
## 目录结构
| 目录名 | 描述 |
diff --git a/docs/source/q&a.rst b/docs/source/q&a.rst
index 16613a91..59b9dc7d 100644
--- a/docs/source/q&a.rst
+++ b/docs/source/q&a.rst
@@ -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
----------------------------------------------------------------
@@ -74,4 +74,25 @@ Failed to enable port
移植 usb host 出现 urb 返回 -12/-14
----------------------------------------------------------------
-检查 phy 配置,cache 配置(如果有),电源供电(建议自供电) \ No newline at end of file
+检查 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 口,
+然后不同使能的配置也不一样,因此不做支持。 \ No newline at end of file
diff --git a/port/dwc2/README.md b/port/dwc2/README.md
index bc8461a5..2861cde7 100644
--- a/port/dwc2/README.md
+++ b/port/dwc2/README.md
@@ -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 \ No newline at end of file
diff --git a/port/musb/README.md b/port/musb/README.md
index ad2a527f..8b5e1299 100644
--- a/port/musb/README.md
+++ b/port/musb/README.md
@@ -17,3 +17,7 @@
### AllwinnerTech
- F1Cxxx, F2Cxxx
+
+### SIFLI
+
+- SF325X
diff --git a/port/nxp/README.md b/port/nxp/README.md
index 5c461b22..c7d95668 100644
--- a/port/nxp/README.md
+++ b/port/nxp/README.md
@@ -12,6 +12,6 @@ Modify USB_NOCACHE_RAM_SECTION
- MCXN9XX/MCXN236 (chipidea + EHCI)
-## IMRT
+### IMRT
- IMRT10XX/IMRT11XX (chipidea + EHCI) \ No newline at end of file