diff options
Diffstat (limited to 'docs/source/quick_start/rt-thread')
20 files changed, 62 insertions, 232 deletions
diff --git a/docs/source/quick_start/rt-thread/img/demo1.png b/docs/source/quick_start/rt-thread/img/demo1.png Binary files differdeleted file mode 100644 index 5176a02c..00000000 --- a/docs/source/quick_start/rt-thread/img/demo1.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/demo2.png b/docs/source/quick_start/rt-thread/img/demo2.png Binary files differdeleted file mode 100644 index 29d30734..00000000 --- a/docs/source/quick_start/rt-thread/img/demo2.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/demo3.png b/docs/source/quick_start/rt-thread/img/demo3.png Binary files differdeleted file mode 100644 index 82bb35ff..00000000 --- a/docs/source/quick_start/rt-thread/img/demo3.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/env1.png b/docs/source/quick_start/rt-thread/img/env1.png Binary files differnew file mode 100644 index 00000000..f8fcb33e --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env1.png diff --git a/docs/source/quick_start/rt-thread/img/env2.png b/docs/source/quick_start/rt-thread/img/env2.png Binary files differnew file mode 100644 index 00000000..2adc4d7b --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env2.png diff --git a/docs/source/quick_start/rt-thread/img/env3.png b/docs/source/quick_start/rt-thread/img/env3.png Binary files differnew file mode 100644 index 00000000..af69dd75 --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env3.png diff --git a/docs/source/quick_start/rt-thread/img/env4.png b/docs/source/quick_start/rt-thread/img/env4.png Binary files differnew file mode 100644 index 00000000..36c4e53c --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env4.png diff --git a/docs/source/quick_start/rt-thread/img/env5.png b/docs/source/quick_start/rt-thread/img/env5.png Binary files differnew file mode 100644 index 00000000..85de879a --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env5.png diff --git a/docs/source/quick_start/rt-thread/img/env6.png b/docs/source/quick_start/rt-thread/img/env6.png Binary files differnew file mode 100644 index 00000000..20a57d07 --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env6.png diff --git a/docs/source/quick_start/rt-thread/img/env7.png b/docs/source/quick_start/rt-thread/img/env7.png Binary files differnew file mode 100644 index 00000000..d304afc3 --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/env7.png diff --git a/docs/source/quick_start/rt-thread/img/rtt_cdc_demo.png b/docs/source/quick_start/rt-thread/img/rtt_cdc_demo.png Binary files differdeleted file mode 100644 index 861669e1..00000000 --- a/docs/source/quick_start/rt-thread/img/rtt_cdc_demo.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/rtt_libc.png b/docs/source/quick_start/rt-thread/img/rtt_libc.png Binary files differdeleted file mode 100644 index 7fd5f00c..00000000 --- a/docs/source/quick_start/rt-thread/img/rtt_libc.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/rtt_menuconfig1.png b/docs/source/quick_start/rt-thread/img/rtt_menuconfig1.png Binary files differdeleted file mode 100644 index 24caa9c7..00000000 --- a/docs/source/quick_start/rt-thread/img/rtt_menuconfig1.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/rtt_menuconfig2.png b/docs/source/quick_start/rt-thread/img/rtt_menuconfig2.png Binary files differdeleted file mode 100644 index fbf49ab4..00000000 --- a/docs/source/quick_start/rt-thread/img/rtt_menuconfig2.png +++ /dev/null diff --git a/docs/source/quick_start/rt-thread/img/stm32_init.png b/docs/source/quick_start/rt-thread/img/stm32_init.png Binary files differnew file mode 100644 index 00000000..3ce57201 --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/stm32_init.png diff --git a/docs/source/quick_start/rt-thread/img/stm32cubemx0.png b/docs/source/quick_start/rt-thread/img/stm32cubemx0.png Binary files differnew file mode 100644 index 00000000..1ea33e04 --- /dev/null +++ b/docs/source/quick_start/rt-thread/img/stm32cubemx0.png diff --git a/docs/source/quick_start/rt-thread/img/stm32cubemx.png b/docs/source/quick_start/rt-thread/img/stm32cubemx1.png Binary files differindex a6ca5078..a6ca5078 100644 --- a/docs/source/quick_start/rt-thread/img/stm32cubemx.png +++ b/docs/source/quick_start/rt-thread/img/stm32cubemx1.png diff --git a/docs/source/quick_start/rt-thread/rt-thread.md b/docs/source/quick_start/rt-thread/rt-thread.md deleted file mode 100644 index 7c57a47c..00000000 --- a/docs/source/quick_start/rt-thread/rt-thread.md +++ /dev/null @@ -1,84 +0,0 @@ -# RT-Thread based Software Package Development Guide - -[中文版](rt-thread_zh.md) - -To use CherryUSB package, you need to select it in the RT-Thread package manager. The specific path is as follows: - -``` --> RT-Thread online packages - -> system packages - --- CherryUSB: tiny and portable USB stack for embedded system with USB IP - - CherryUSB Options ----> - USB Speed (FS) ---> - [*] Enable usb device mode - [*] Enable usb cdc acm device - [ ] Enable usb hid device - [ ] Enable usb dfu device - [ ] Enable usb msc device - [ ] Enable usb hub device - [ ] Enable usb audio device - [ ] Enable usb video device - - Version (latest) ---> -``` - -## Based ON STM32 Platform - -Please note that stm32 series have two usb ip. For usb ip, like stm32f0、stm32f1、stm32f3, for usb otg ip(as we know it is from **synopsys**),like stm32f4、stm32f7 and so on. - -### Use USB Device - -- Firstly,you should have a bsp project,and then go to `board\CubeMX_Config` directory, open file that suffix name with `.ioc` in **STM32CubeMX**. -- Enable **USB** or **USB_OTG_FS** or **USB_OTG_HS** in **Connectivity** List,enable USB IRQ in **NVIC Setting**. - - - -- Enable USB Clock for 48Mhz in **Clock configuration**. - - - -- Generate code. -- Copy **SystemClock_Config** into **board.c**. -- ~~Copy **MX_USB_OTG_FS_PCD_Init** or **MX_USB_OTG_HS_PCD_Init** into **main.c** if you use **usb_dc_hal.c**.Also, USB Irq from **it.c** needs the same.~~ -- Implement **usb_dc_low_level_init** and copy codes in from ``HAL_PCD_MspInit``. - -``` -void usb_dc_low_level_init(void) -{ - /* Peripheral clock enable */ - __HAL_RCC_USB_CLK_ENABLE(); - /* USB interrupt Init */ - HAL_NVIC_SetPriority(USB_LP_CAN1_RX0_IRQn, 0, 0); - HAL_NVIC_EnableIRQ(USB_LP_CAN1_RX0_IRQn); - -} -``` - -- Implement **printf** or modify with **rt_kprintf** in **usb_utils.h**, usb stack needs. -- Now we can call some functions provided by **usb_stack**.Your should register descriptors、interfaces and endpoint callback firstly, and then call `usb_dc_init`. Example is as follows: - -``` -int main(void) -{ - extern void cdc_init(void); - cdc_init(); - usb_dc_init(); - while (1) - { - uint8_t data_buffer[10] = { 0x31, 0x32, 0x33, 0x34, 0x35, 0x31, 0x32, 0x33, 0x34, 0x35 }; - usbd_ep_write(0x81, data_buffer, 10, NULL); - rt_thread_mdelay(500); - } -} -``` - -- How to register class you can go to [stm32 class examples](https://github.com/sakumisu/usb_stack/tree/master/demo/stm32/stm32f103c8t6/example) for a reference. - -### CDC Demo Demonstration - - - -### Video manual - -If you have problem from steps above, you can see this video：[Use USB Stack in RT-Thread package manager](https://www.bilibili.com/video/BV1Ef4y1t73d?p=26)。
\ No newline at end of file diff --git a/docs/source/quick_start/rt-thread/rt-thread_zh.md b/docs/source/quick_start/rt-thread/rt-thread_zh.md deleted file mode 100644 index e9bff015..00000000 --- a/docs/source/quick_start/rt-thread/rt-thread_zh.md +++ /dev/null @@ -1,148 +0,0 @@ -# 基于 RT-Thread 软件包开发指南 - -[English Version](rt-thread.md) - -使用 CherryUSB package 需要在 RT-Thread 的包管理器中选择它，具体路径如下： - -``` --> RT-Thread online packages - -> system packages - --- CherryUSB: tiny and portable USB stack for embedded system with USB IP - - CherryUSB Options ----> - USB Speed (FS) ---> - [*] Enable usb device mode - [ ] Enable usb host mode - [*] Enable usb cdc acm device - [ ] Enable usb hid device - [ ] Enable usb dfu device - [ ] Enable usb msc device - [ ] Enable usb hub device - [ ] Enable usb audio device - [ ] Enable usb video device - - Version (latest) ---> -``` - -## 基于 STM32 平台 - -STM32 系列单片机有两种 USB IP,分别是 USB IP 和 USB OTG IP。其中 USB IP，例如 STM32F0、STM32F1、STM32F3等等，USB OTG IP(我们都知道用的是 **synopsys** 公司的)的有 STM32F4、STM32F7、STM32H7等等。当前如果你需要使用 USB Device 功能，porting 接口提供了两种，一种是适配 USB IP的 **fsdev**,另一种是适配 USB OTG IP 的 **synopsys**。 - -### 使用 USB Device 功能 - -- 首先，你需要有一个 bsp 工程，之后进入到 `board\CubeMX_Config` 目录下，使用 **STM32CubeMX** 打开后缀名为 `.ioc` 的文件。 -- 进入 **Connectivity** 选项，选择 **USB** 或者 **USB_OTG_FS** 或者 **USB_OTG_HS**，并使能 device 功能，在 **NVIC Setting** 中开启 USB 中断。 - - - -- 在 **Clock configuration** 栏配置 USB 时钟为 48Mhz. - - - -- 点击 **Generate code**。 -- 复制 **SystemClock_Config** 函数内容到 **board.c** 中。 -- 实现 ``usb_dc_low_level_init``，并将 ``HAL_PCD_MspInit`` 里面内容复制进来，例如： - -``` -void usb_dc_low_level_init(void) -{ - /* Peripheral clock enable */ - __HAL_RCC_USB_CLK_ENABLE(); - /* USB interrupt Init */ - HAL_NVIC_SetPriority(USB_LP_CAN1_RX0_IRQn, 0, 0); - HAL_NVIC_EnableIRQ(USB_LP_CAN1_RX0_IRQn); - -} -``` - -- 由于协议栈默认使用 `printf` 和 `malloc` 和 `free`,所以需要开启 libc 支持或者自己实现。 - - -- 使用 **menuconfig** 配置 **CherryUSB** 软件包，使能 usb device 并勾选需要的 device class。 - - -- 现在我们可以调用 CherryUSB 中的函数来注册描述符、接口、端点中断，并调用 `usb_dc_init`，示例如下： - -``` -#include <rtthread.h> -#include <rtdevice.h> -#include <board.h> -#include <stdio.h> - -extern void usb_dc_init(void); -int main(void) -{ - extern void cdc_init(void); - cdc_init(); - usb_dc_init(); - while (1) - { - uint8_t data_buffer[10] = { 0x31, 0x32, 0x33, 0x34, 0x35, 0x31, 0x32, 0x33, 0x34, 0x35 }; - usbd_ep_write(0x81, data_buffer, 10, NULL); - rt_thread_mdelay(500); - } -} - -``` - -- 关于如何注册 class 类可以参考 [stm32 class examples](https://github.com/sakumisu/usb_stack/tree/master/demo/stm32/stm32f103c8t6/example)。 - -### 使用 USB Host 功能 - -- 首先，你需要有一个 bsp 工程，之后进入到 `board\CubeMX_Config` 目录下，使用 **STM32CubeMX** 打开后缀名为 `.ioc` 的文件。 -- 进入 **Connectivity** 选项，选择 **USB_OTG_FS** 或者 **USB_OTG_HS**，并使能 **host only** 功能，在 **NVIC Setting** 中开启 OTG GLOBAL 中断，其余两个端点中断不需要。 - - - -- 在 **Clock configuration** 栏配置 USB 时钟为 48Mhz. -- 点击 **Generate code**。 -- 复制 **SystemClock_Config** 函数内容到 **board.c** 中。 -- 修改 **usb_hc_synopsys.c** 中 HAL 库头文件包含，例如 `#include "stm32f4xx_hal.h"`。 -- 手动增加 **xxx_hal_hcd.c** 和 **xxx_ll_usb.c** 文件 -- 由于协议栈默认使用 `printf` 和 `malloc` 和 `free`,所以需要开启 libc 支持或者自己实现。 - - -- 使用 **menuconfig** 配置 **CherryUSB** 软件包，使能 usb host（默认加载所有支持的 class）。 - - -- `main.c` 中调用 `usbh_initialize` 初始化 host 协议栈。 - -``` -#include <rtthread.h> -#include <rtdevice.h> -#include <board.h> -#include "usbh_core.h" -/* defined the LED0 pin: PH10 */ -#define LED0_PIN GET_PIN(H, 10) - -int main(void) -{ - /* set LED0 pin mode to output */ - rt_pin_mode(LED0_PIN, PIN_MODE_OUTPUT); - usbh_initialize(); - while (1) - { - rt_pin_write(LED0_PIN, PIN_HIGH); - rt_thread_mdelay(500); - rt_pin_write(LED0_PIN, PIN_LOW); - rt_thread_mdelay(500); - } -} - - -``` - -### Demo 演示 - -- cdc acm device demo - - -- host demo - - - - - -### 视频教程 - -如果对上述步骤还有问题，可以参考 [协议栈在 RT-Thread 包管理器中的使用](https://www.bilibili.com/video/BV1Ef4y1t73d?p=26)。
\ No newline at end of file diff --git a/docs/source/quick_start/rt-thread/rtthread.rst b/docs/source/quick_start/rt-thread/rtthread.rst new file mode 100644 index 00000000..8ec5c6c9 --- /dev/null +++ b/docs/source/quick_start/rt-thread/rtthread.rst @@ -0,0 +1,62 @@ +基于 RT-Thread 软件包开发指南 +=============================== + +本节主要介绍使用 RT-Thread 提供的软件包管理器来配置工程，以 env 作为演示。本节操作不同芯片都一样，后续不再重复讲解。打开 env 以后使用 menuconfig 进入包管理器，并在如图所示路径中选择 CherryUSB。 + +.. figure:: img/env1.png + + +从机配置 +-------------------------- + +* 选择 Enable usb device mode 并敲回车进入。 + +.. figure:: img/env2.png + +* 首先第一个配置是配置 USB 的速度，分为 **FS、HIGH_IN_FULL、HS**,。其中， **HIGH_IN_FULL** 表示设备使用支持高速的 USB IP，但是工作在全速模式下，这里仅使用 **synopsys ip** 时使用。 + +.. figure:: img/env3.png + +* 其次第二个配置则是选择 USB device ip，不清楚自己芯片是哪个 ip的可以参考 **port** 目录下对应的 readme。 + +.. figure:: img/env4.png + +* 选择好 USB device ip 以后，还需要选择是哪款芯片，第三个配置则是用来选择芯片，选择以后会帮忙配置相对应的 ip 的一些信息，比如 `USB_BASE` 、 `USBD_Handler` 以及特殊的一些配置等等，如果没找到自己的芯片，可以手动在 `usb_dc_xxx.c` 中修改。 + +.. figure:: img/env5.png + +* 接下来是 class 的选择，用哪个 class 勾选哪个就可以了，使能 class 以后，双击进入可以选择一个 demo 的模板参与编译，当然也可以不选，自己写。 + +.. figure:: img/env6.png + +* 最后退出保存即可。 +* 退出以后不急着编译，需要在代码中实现 `usb_dc_low_level_init` 函数。最后使用芯片能够接受的编译方式进行编译。 + + +主机配置 +-------------------------- + +* 选择 Enable usb host mode 并敲回车进入。 + +.. figure:: img/env7.png + +* 和 device 配置一样，需要选择对应的 host ip，以及使用对应 ip 的芯片，如果没找到自己的芯片，可以手动在 `usb_hc_xxx.c` 中修改。 +* 默认使用除了 hub 之外的所有 class 驱动。 +* 设置 psc 线程的线程栈以及线程优先级。 +* 最后退出保存即可。 +* 退出以后不急着编译，需要在代码中实现 `usb_hc_low_level_init` 函数。最后使用芯片能够接受的编译方式进行编译。 + + +借助 STM32CubeMX 生成 USB 初始化 +---------------------------------- + +使用 STM32CubeMX 主要是用来生成 usb 时钟、引脚、中断的配置。我们需要点击如图所示文件，并配置好 USB 的时钟、中断，点击 `Generate Code`。生成的时钟配置在 `main.c` 中的 `SystemClock_Config` 文件，将其拷贝到 `board.c` 中。 + +.. figure:: img/stm32cubemx0.png +.. figure:: img/stm32cubemx1.png +.. figure:: img/stm32cubemx2.png +.. figure:: img/stm32cubemx_clk.png + +然后将 `stm32xxxx_hal_msp.c` 中的 `HAL_PCD_MspInit` 或者是 `HAL_HCD_MspInit` 中的内容复制到 `usb_dc_low_level_init` 和 `usb_hc_low_level_init` 函数中，举例如下： + +.. figure:: img/stm32_init.png
\ No newline at end of file |
