summaryrefslogtreecommitdiff
path: root/docs/source
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/porting_usbip.rst42
-rw-r--r--docs/source/quick_start/rt-thread/rtthread.rst2
2 files changed, 35 insertions, 9 deletions
diff --git a/docs/source/porting_usbip.rst b/docs/source/porting_usbip.rst
index 57ba5d4d..9ee36de4 100644
--- a/docs/source/porting_usbip.rst
+++ b/docs/source/porting_usbip.rst
@@ -150,17 +150,43 @@ MUSB IP 支持主从,并且由 **mentor** 定义了一套标准的寄存器偏
- 0x01c13000
- 4
-SYNOPSYS
+DWC2
--------------------------
-- STM32 芯片中,H7 的 FS 控制器(使用 PA11/PA12)基地址(**0x40080000UL**)与其他芯片 FS 控制器基地址(**0x50000000UL**)不一样, HS 基地址都是一样的。其次是关于 **VBUS_SENSE** 的控制,虽然寄存器相同,但是个别芯片对该 bit 操作 0 和操作 1 是相反的(估计是硬件设计问题),此问题会影响枚举,所以需要根据芯片控制是否使能 **CONFIG_USB_SYNOPSYS_NOVBUSSEN**。
-不可靠的统计是新款 F4、F7、H7、L4 都是需要使能的。
+DWC2 IP 支持主从,并且由 **synopsys** 定义了一套标准的寄存器偏移。大部分厂家都使用标准的寄存器偏移,所以如果是从机仅需要修改 `USBD_IRQHandler` 、 `USB_BASE` 、 `USB_NUM_BIDIR_ENDPOINTS` ,主机仅需要修改 `USBH_IRQHandler` 、 `USB_BASE` 即可。
-.. code-block:: C
+.. caution:: 主机 port 仅支持有高速功能的 dwc2 ip, 因为他支持 dma 模式,如果厂家买的 ip 不支持 dma 模式,则无法使用。
- /* Deactivate VBUS Sensing B */
- USBx->GCCFG &= ~USB_OTG_GCCFG_VBDEN;
+下表为具体芯片从机相关宏的修改值:
- USBx->GCCFG |= USB_OTG_GCCFG_NOVBUSSENS;
+.. list-table::
+ :widths: 30 30 30 30
+ :header-rows: 1
- 两者都是关闭作用,并且其中 USB_OTG_GCCFG_NOVBUSSENS 和 USB_OTG_GCCFG_VBDEN 都是 21 bit \ No newline at end of file
+ * - 芯片
+ - USBH_IRQHandler
+ - USB_BASE
+ - USB_NUM_BIDIR_ENDPOINTS
+ * - STM32 非 H7
+ - OTG_FS_IRQHandler/OTG_HS_IRQHandler
+ - 0x50000000UL/0x40040000UL
+ - 5
+ * - STM32 H7
+ - 同上
+ - 0x40080000UL/0x40040000UL
+ - 9
+
+下表为具体芯片主机相关宏的修改值:
+
+.. list-table::
+ :widths: 30 30 30 30
+ :header-rows: 1
+
+ * - 芯片
+ - USBH_IRQHandler
+ - USB_BASE
+ - CONFIG_USB_DWC2_PIPE_NUM
+ * - STM32 全系列
+ - OTG_HS_IRQHandler
+ - 0x40040000UL
+ - 12
diff --git a/docs/source/quick_start/rt-thread/rtthread.rst b/docs/source/quick_start/rt-thread/rtthread.rst
index 2ee4c0b3..92f847ff 100644
--- a/docs/source/quick_start/rt-thread/rtthread.rst
+++ b/docs/source/quick_start/rt-thread/rtthread.rst
@@ -44,7 +44,7 @@
.. figure:: img/env7.png
-* 选择 USB host ip,不清楚自己芯片是哪个 ip 的可以参考 **port** 目录下对应的 readme。选择好 USB host ip 以后,还需要选择是哪款芯片,第二个箭头则是用来选择芯片,选择以后会帮忙配置相对应的 ip 的一些信息,比如 `USB_BASE` 、 `USBH_Handler` 以及特殊的一些配置等等,如果没找到自己的芯片,可以手动在 `usb_dc_xxx.c` 中修改。
+* 选择 USB host ip,不清楚自己芯片是哪个 ip 的可以参考 **port** 目录下对应的 readme。选择好 USB host ip 以后,还需要选择是哪款芯片,第二个箭头则是用来选择芯片,选择以后会帮忙配置相对应的 ip 的一些信息,比如 `USB_BASE` 、 `USBH_Handler` 以及特殊的一些配置等等,如果没找到自己的芯片,可以手动在 `usb_hc_xxx.c` 中修改。
.. figure:: img/env8.png