diff options
| author | sakumisu <[email protected]> | 2025-07-22 18:20:37 +0800 |
|---|---|---|
| committer | sakumisu <[email protected]> | 2025-07-22 18:20:37 +0800 |
| commit | 68b28a43f30829f944eb9ba8a81c3ead4736b6f2 (patch) | |
| tree | ac5c256b6c72af92566736c2e0975e112b3b3af0 /docs/source/quick_start | |
| parent | ddda03c4cb854041e38d8d28ffa3fcdb571b4cab (diff) | |
docs: update rst
Signed-off-by: sakumisu <[email protected]>
Diffstat (limited to 'docs/source/quick_start')
| -rw-r--r-- | docs/source/quick_start/demo.rst | 8 | ||||
| -rw-r--r-- | docs/source/quick_start/img/stm32_21.png | bin | 13584 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32_3_2.png (renamed from docs/source/quick_start/img/stm32_3.png) | bin | 49701 -> 49701 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32_4_2.png (renamed from docs/source/quick_start/img/stm32_4.png) | bin | 74975 -> 74975 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32_init.png | bin | 8280 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32_init2.png | bin | 47691 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32cubemx0.png | bin | 22591 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32cubemx1.png | bin | 37705 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32cubemx2.png | bin | 41977 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/img/stm32cubemx_clk.png | bin | 16418 -> 0 bytes | |||
| -rw-r--r-- | docs/source/quick_start/transplant.rst | 10 |
11 files changed, 9 insertions, 9 deletions
diff --git a/docs/source/quick_start/demo.rst b/docs/source/quick_start/demo.rst index 3ad3ca72..3c330e46 100644 --- a/docs/source/quick_start/demo.rst +++ b/docs/source/quick_start/demo.rst @@ -116,12 +116,12 @@ USB Device 移植要点 - 如果使用 fsdev ip,勾选 **USB** 。如果使用 dwc2 ip,勾选 **USB_OTG_FS** 或者勾选 **USB_OTG_HS**。开启 USB 中断,其他配置对我们没用,代码中不会使用任何 st 的 usb 库。 .. figure:: img/stm32_3_1.png -.. figure:: img/stm32_3.png +.. figure:: img/stm32_3_2.png - 配置 usb clock 为 48M .. figure:: img/stm32_4_1.png -.. figure:: img/stm32_4.png +.. figure:: img/stm32_4_2.png - 选择好工程,这里我们选择 keil,设置好 stack 和 heap,如果使用 msc 可以推荐设置大点,然后点击 **Generate Code**。 @@ -214,10 +214,12 @@ USB Host 移植要点 - 拷贝 **xxx_msp.c** 中的 `HAL_HCD_MspInit` 函数中的内容到 `usb_hc_low_level_init` 函数中,屏蔽 st 生成的 usb 初始化 - 在中断函数中调用 `USBH_IRQHandler`,并传入 `busid` + +.. figure:: img/stm32_19.png + - 链接脚本修改参考 :ref:`usbh_link_script` 章节 - 如果芯片带 cache,cache 修改参考 :ref:`usb_cache` 章节 - 调用 `usbh_initialize` 并填入 `busid` 和 USB IP 的 `reg base`, `busid` 从 0 开始,不能超过 `CONFIG_USBHOST_MAX_BUS` - 启动线程 .. figure:: img/stm32_18.png -.. figure:: img/stm32_19.png diff --git a/docs/source/quick_start/img/stm32_21.png b/docs/source/quick_start/img/stm32_21.png Binary files differdeleted file mode 100644 index 977bda82..00000000 --- a/docs/source/quick_start/img/stm32_21.png +++ /dev/null diff --git a/docs/source/quick_start/img/stm32_3.png b/docs/source/quick_start/img/stm32_3_2.png Binary files differindex 492d6739..492d6739 100644 --- a/docs/source/quick_start/img/stm32_3.png +++ b/docs/source/quick_start/img/stm32_3_2.png diff --git a/docs/source/quick_start/img/stm32_4.png b/docs/source/quick_start/img/stm32_4_2.png Binary files differindex dd90f5b8..dd90f5b8 100644 --- a/docs/source/quick_start/img/stm32_4.png +++ b/docs/source/quick_start/img/stm32_4_2.png diff --git a/docs/source/quick_start/img/stm32_init.png b/docs/source/quick_start/img/stm32_init.png Binary files differdeleted file mode 100644 index 3ce57201..00000000 --- a/docs/source/quick_start/img/stm32_init.png +++ /dev/null diff --git a/docs/source/quick_start/img/stm32_init2.png b/docs/source/quick_start/img/stm32_init2.png Binary files differdeleted file mode 100644 index eae3c026..00000000 --- a/docs/source/quick_start/img/stm32_init2.png +++ /dev/null diff --git a/docs/source/quick_start/img/stm32cubemx0.png b/docs/source/quick_start/img/stm32cubemx0.png Binary files differdeleted file mode 100644 index 1ea33e04..00000000 --- a/docs/source/quick_start/img/stm32cubemx0.png +++ /dev/null diff --git a/docs/source/quick_start/img/stm32cubemx1.png b/docs/source/quick_start/img/stm32cubemx1.png Binary files differdeleted file mode 100644 index a6ca5078..00000000 --- a/docs/source/quick_start/img/stm32cubemx1.png +++ /dev/null diff --git a/docs/source/quick_start/img/stm32cubemx2.png b/docs/source/quick_start/img/stm32cubemx2.png Binary files differdeleted file mode 100644 index e29254bb..00000000 --- a/docs/source/quick_start/img/stm32cubemx2.png +++ /dev/null diff --git a/docs/source/quick_start/img/stm32cubemx_clk.png b/docs/source/quick_start/img/stm32cubemx_clk.png Binary files differdeleted file mode 100644 index 41a7aae8..00000000 --- a/docs/source/quick_start/img/stm32cubemx_clk.png +++ /dev/null diff --git a/docs/source/quick_start/transplant.rst b/docs/source/quick_start/transplant.rst index 1b401d15..a6dcf14e 100644 --- a/docs/source/quick_start/transplant.rst +++ b/docs/source/quick_start/transplant.rst @@ -6,26 +6,24 @@ USB Device 移植要点 ----------------------- -- 拷贝 CherryUSB 源码到工程目录下,并按需添加源文件和头文件路径,其中 `usbd_core.c` 和 `usb_dc_xxx.c` 为必须添加项。而 `usb_dc_xxx.c` 是芯片所对应的 USB IP dcd 部分驱动,如果不知道自己芯片属于那个 USB IP,参考 **port** 目录下的不同 USB IP 的 readme。如果使用的 USB IP 没有支持,只能自己实现了 +- 拷贝 CherryUSB 源码到工程目录下,并按需添加源文件和头文件路径,头文件路径建议全部添加。其中 `usbd_core.c` 和 `usb_dc_xxx.c` 为必须添加项。而 `usb_dc_xxx.c` 是芯片所对应的 USB IP dcd 部分驱动,如果不知道自己芯片属于那个 USB IP,参考 **port** 目录下的不同 USB IP 的 readme。如果使用的 USB IP 没有支持,只能自己实现了 - 拷贝 `cherryusb_config_template.h` 文件到自己工程目录下,命名为 `usb_config.h`,并添加相应的目录头文件路径 - 实现 `usb_dc_low_level_init` 函数(该函数主要负责 USB 时钟、引脚、中断的初始化)。该函数可以放在你想要放的任何参与编译的 c 文件中。如何进行 USB 的时钟、引脚、中断等初始化,请自行根据你使用的芯片原厂提供的源码中进行添加。 -- 描述符的注册、class的注册、接口的注册、端点中断的注册。不会的参考 demo 下的 template -- 调用 `usbd_initialize` 并填入 `busid` 和 USB IP 的 `reg base`, `busid` 从 0 开始,不能超过 `CONFIG_USBDEV_MAX_BUS` - 在中断函数中调用 `USBD_IRQHandler`,并传入 `busid`, 如果你的 SDK 中中断入口已经存在 `USBD_IRQHandler` ,请更改 USB 协议栈中的名称 - 如果芯片带 cache,cache 修改参考 :ref:`usb_cache` 章节 -- 编译使用。各个 class 如何使用,参考 demo 下的 template +- 注册描述符并调用 `usbd_initialize`,填入 `busid` 和 USB IP 的 `reg base`, `busid` 从 0 开始,不能超过 `CONFIG_USBDEV_MAX_BUS`,可以直接使用 demo 下的 template USB Host 移植要点 ----------------------- -- 拷贝 CherryUSB 源码到工程目录下,并按需添加源文件和头文件路径,其中 `usbh_core.c` 、 `usb_hc_xxx.c` 以及 **osal** 目录下源文件(根据不同的 os 选择对应的源文件)为必须添加项。而 `usb_hc_xxx.c` 是芯片所对应的 USB IP hcd 部分驱动,如果不知道自己芯片属于那个 USB IP,参考 **port** 目录下的不同 USB IP 的 readme。如果使用的 USB IP 没有支持,只能自己实现了 +- 拷贝 CherryUSB 源码到工程目录下,并按需添加源文件和头文件路径,头文件路径建议全部添加。其中 `usbh_core.c` 、 `usb_hc_xxx.c` 以及 **osal** 目录下源文件(根据不同的 os 选择对应的源文件)为必须添加项。而 `usb_hc_xxx.c` 是芯片所对应的 USB IP hcd 部分驱动,如果不知道自己芯片属于那个 USB IP,参考 **port** 目录下的不同 USB IP 的 readme。如果使用的 USB IP 没有支持,只能自己实现了 - 拷贝 `cherryusb_config_template.h` 文件到自己工程目录下,命名为 `usb_config.h`,并添加相应的目录头文件路径 - 实现 `usb_hc_low_level_init` 函数(该函数主要负责 USB 时钟、引脚、中断的初始化)。该函数可以放在你想要放的任何参与编译的 c 文件中。如何进行 USB 的时钟、引脚、中断等初始化,请自行根据你使用的芯片原厂提供的源码中进行添加。 - 调用 `usbh_initialize` 并填入 `busid` 和 USB IP 的 `reg base`, `busid` 从 0 开始,不能超过 `CONFIG_USBHOST_MAX_BUS` - 在中断函数中调用 `USBH_IRQHandler`,并传入 `busid`, 如果你的 SDK 中中断入口已经存在 `USBH_IRQHandler` ,请更改 USB 协议栈中的名称 - 链接脚本修改参考 :ref:`usbh_link_script` 章节 - 如果芯片带 cache,cache 修改参考 :ref:`usb_cache` 章节 -- 编译使用。基础的 cdc + hid + msc 参考 `usb_host.c` 文件,其余参考 **platform** 目录下适配 +- 调用 `usbh_initialize` ,填入 `busid` 和 USB IP 的 `reg base`, `busid` 从 0 开始,不能超过 `CONFIG_USBHOST_MAX_BUS` 。基础的 cdc + hid + msc 参考 `usb_host.c` 文件,其余参考 **platform** 目录下适配 .. _usbh_link_script: |
