diff --git a/.buildinfo b/.buildinfo index 5c5f4f71..1e036491 100644 --- a/.buildinfo +++ b/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: f08f70254e181703d01c45e93ee5b4fa +config: 63d6aa3eaecdeded9cb9f23316cfab45 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/_sources/quick_start/demo.rst.txt b/_sources/quick_start/demo.rst.txt index 48338aad..b53baa38 100644 --- a/_sources/quick_start/demo.rst.txt +++ b/_sources/quick_start/demo.rst.txt @@ -4,24 +4,24 @@ 在学习 USB 或者是学习 CherryUSB 代码之前，我们需要先基于现有的 demo 进行快速验证，为什么？是为了提升对 USB 的兴趣，能有信心进行下一步的动作，如果 demo 都跑不起来，或者自己摸索写代码，或者先看 USB 基本概念，结果看到最后， 发现一点都看不懂，概念好多，根本记不住，从而丧失对 USB 的兴趣。因此，先跑 demo 非常重要。下面我将给大家罗列目前支持的 demo 仓库。 -基于 bouffalolab 系列芯片 ---------------------------- +基于 bouffalolab 系列芯片（官方 SDK 支持） +------------------------------------------ 仓库参考：https://github.com/CherryUSB/cherryusb_bouffalolab - BL616/BL808：USB2.0 内置 HS phy 芯片，支持主从机。device 支持 5 个端点（包括端点0），不支持双向同时使用。 - USB 的相关应用位于 `examples/usbdev` 和 `examples/usbhost` 目录下，根据官方环境搭建完成后，即可编译使用。 -基于 HPMicro 系列芯片 ---------------------------- +基于 HPMicro 系列芯片（官方 SDK 支持） +----------------------------------------------------- 仓库参考：https://github.com/CherryUSB/cherryusb_hpmicro - HPM 系列: USB2.0 内置 HS phy 芯片，支持主从机。device 支持 8/16 端点（包括端点0），并且可以同时使用双向，不同芯片个数有差异。 - USB 的相关应用位于 `samples/cherryusb` ，根据官方环境搭建完成后，即可编译使用。 -基于 esp32s2/s3/p4 系列芯片 ---------------------------- +基于 esp32s2/s3/p4 系列芯片（官方 SDK 即将支持） +------------------------------------------------- 仓库参考：https://github.com/CherryUSB/cherryusb_esp32 @@ -29,21 +29,35 @@ - esp32p4：一个 USB2.0 内置全速 PHY 芯片，一个 USB2.0 内置高速 PHY 芯片，支持主从机。 - 默认 demo 采用组件库安装的形式，在 https://components.espressif.com/ 中搜索 cherryusb 即可 -基于飞腾派系列芯片 ---------------------------- +基于飞腾派系列芯片（官方 SDK 支持） +----------------------------------- 仓库参考：https://gitee.com/phytium_embedded/phytium-free-rtos-sdk - 飞腾派支持两个 USB3.0 主机（采用 XHCI）， 两个 USB2.0 主从机 - USB 的相关应用位于 `example/peripheral/usb` ，根据官方环境搭建完成后，即可编译使用。 -基于 Essemi 系列芯片 ---------------------------- +基于 Essemi 系列芯片（官方 SDK 支持） +----------------------------------------- 仓库参考：https://github.com/CherryUSB/cherryusb_es32 - 支持全速和高速主从机。device 支持 6 个端点（包括端点0），并且可以同时使用双向。 +基于 Artinchip 系列芯片（官方 SDK 支持） +----------------------------------------------- + +仓库参考：https://gitee.com/artinchip/luban-lite + +- 支持全速和高速主从机，主机采用 EHCI + OHCI。device 支持 8 个端点（包括端点0），并且可以同时使用双向。 + +基于 canmv-k230 芯片（官方 SDK 支持） +--------------------------------------------- + +仓库参考：https://github.com/CherryUSB/k230_sdk + +- K230: 两个 USB2.0 内置 HS PHY 芯片，支持主从机。device 支持 16 个端点（包括端点0），并且可以同时使用双向。 + 基于 NXP MCX系列芯片 --------------------------- @@ -51,19 +65,10 @@ - 支持全速 IP 和高速 IP， 高速 IP 支持主机和从机。device 支持 8 个端点（包括端点0），并且可以同时使用双向。 -基于 Artinchip 系列芯片 ---------------------------- +基于 RP2040/RP2035 芯片（官方 SDK 即将支持） +-------------------------------------------- -仓库参考：https://gitee.com/artinchip/luban-lite - -- 支持全速和高速主从机，主机采用 EHCI + OHCI。device 支持 8 个端点（包括端点0），并且可以同时使用双向。 - -基于 canmv-k230 芯片 ---------------------------- - -仓库参考：https://github.com/CherryUSB/k230_sdk - -- K230: 两个 USB2.0 内置 HS PHY 芯片，支持主从机。device 支持 16 个端点（包括端点0），并且可以同时使用双向。 +仓库参考： https://github.com/CherryUSB/pico-examples 和 https://github.com/CherryUSB/pico-sdk 基于 ST 系列芯片 --------------------------- diff --git a/_sources/version.rst.txt b/_sources/version.rst.txt index 6c967e1c..409a7658 100644 --- a/_sources/version.rst.txt +++ b/_sources/version.rst.txt @@ -134,4 +134,18 @@ v1.5.1 - **dwc2 增加多个 usbport 不同参数的配置功能，比如一个全速一个高速，fifo配置和phy配置不同** - **ehci 在控制传输中如果没有 nodata 阶段会导致 data qtd 未释放，导致内存泄漏** - **dwc2 读取 setup 使用 usbd_get_next_ep0_state 去判断，避免 setup 和 ep0 out 使用在 USB_OTG_DOEPINT_XFRC 状态下冲突** -- sifli usb device 初步支持 \ No newline at end of file +- sifli usb device 初步支持 + +v1.5.2 +---------------------- + +- 对 1.5.1 下 rt-thread 组件的一些 bugfix +- idf timer osal 替换为 esp timer，freertos timer会有启动失败的可能性；xTaskCreate 使用 xTaskCreatePinnedToCore 替换，方便多核使用 +- 主机枚举中，删除描述符溢出相关的 ASSERT 操作，改成返回错误。获取字符串描述符改成支持才获取。2 ms 延时改成 10ms，因为一些 os 使用的是 100hz，会造成延时失效 +- **dwc2 ep mult 支持，split 传输代码优化，对 split 相关的 cache 处理修改** +- **dwc2 halt 中不能清除 USB_OTG_HCCHAR_EPDIR，reset port 中使用超时机制，防止在枚举时由于拔出而造成死等** +- 更新 DWC2 中 at32，stm32，kendryte，espressif glue 代码 +- musb 对于标准的 IP 结构采用独立 EP 控制寄存器组，不使用 EPIDX 寄存器去控制 +- 删除所有 CONFIG_USBDEV_EP_NUM & CONFIG_USBHOST_PIPE_NUM，不再使用，因为 IP 本身会携带这些信息，或者厂家 SDK 提供了对应的宏 +- CONFIG_USBHOST_MAX_INTF_ALTSETTINGS 默认使用 2 减少内存，只有 UVC 和UAC 使用（商业收费），所以不需要开很大 +- urb interval 从 u8 改 u32，最大支持 2^15 * 125us \ No newline at end of file diff --git a/_static/documentation_options.js b/_static/documentation_options.js index 5426053b..67b298a9 100644 --- a/_static/documentation_options.js +++ b/_static/documentation_options.js @@ -1,5 +1,5 @@ const DOCUMENTATION_OPTIONS = { - VERSION: '1.5.1', + VERSION: '1.5.2', LANGUAGE: 'en', COLLAPSE_INDEX: false, BUILDER: 'html', diff --git a/api/api_config.html b/api/api_config.html index 8c505398..9f6e4719 100644 --- a/api/api_config.html +++ b/api/api_config.html @@ -6,14 +6,14 @@ - USB CONFIG 说明 — CherryUSB 1.5.1 documentation + USB CONFIG 说明 — CherryUSB 1.5.2 documentation - + diff --git a/api/api_device.html b/api/api_device.html index 1e01ad13..09cbe487 100644 --- a/api/api_device.html +++ b/api/api_device.html @@ -6,14 +6,14 @@ - 设备协议栈 — CherryUSB 1.5.1 documentation + 设备协议栈 — CherryUSB 1.5.2 documentation - + diff --git a/api/api_host.html b/api/api_host.html index 808962d4..61c8ddc8 100644 --- a/api/api_host.html +++ b/api/api_host.html @@ -6,14 +6,14 @@ - 主机协议栈 — CherryUSB 1.5.1 documentation + 主机协议栈 — CherryUSB 1.5.2 documentation - + diff --git a/api/api_port.html b/api/api_port.html index 1f0a822e..868c219f 100644 --- a/api/api_port.html +++ b/api/api_port.html @@ -6,14 +6,14 @@ - 主从驱动 — CherryUSB 1.5.1 documentation + 主从驱动 — CherryUSB 1.5.2 documentation - + diff --git a/class/class_audio.html b/class/class_audio.html index 047a3e4c..a9341a09 100644 --- a/class/class_audio.html +++ b/class/class_audio.html @@ -6,14 +6,14 @@ - UAC — CherryUSB 1.5.1 documentation + UAC — CherryUSB 1.5.2 documentation - + diff --git a/class/class_cdc.html b/class/class_cdc.html index b23fbc58..d7756cac 100644 --- a/class/class_cdc.html +++ b/class/class_cdc.html @@ -6,14 +6,14 @@ - CDC — CherryUSB 1.5.1 documentation + CDC — CherryUSB 1.5.2 documentation - + diff --git a/class/class_hid.html b/class/class_hid.html index f00680e0..ed8e795d 100644 --- a/class/class_hid.html +++ b/class/class_hid.html @@ -6,14 +6,14 @@ - HID — CherryUSB 1.5.1 documentation + HID — CherryUSB 1.5.2 documentation - + diff --git a/class/class_msc.html b/class/class_msc.html index c01594e2..04ea2b9c 100644 --- a/class/class_msc.html +++ b/class/class_msc.html @@ -6,14 +6,14 @@ - MSC — CherryUSB 1.5.1 documentation + MSC — CherryUSB 1.5.2 documentation - + diff --git a/class/class_video.html b/class/class_video.html index 593782ae..9e177a5a 100644 --- a/class/class_video.html +++ b/class/class_video.html @@ -6,14 +6,14 @@ - UVC — CherryUSB 1.5.1 documentation + UVC — CherryUSB 1.5.2 documentation - + diff --git a/class/winusb.html b/class/winusb.html index 036f69d3..dc543d43 100644 --- a/class/winusb.html +++ b/class/winusb.html @@ -6,14 +6,14 @@ - WINUSB — CherryUSB 1.5.1 documentation + WINUSB — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_adb.html b/demo/usbd_adb.html index 464c6425..e3fadc03 100644 --- a/demo/usbd_adb.html +++ b/demo/usbd_adb.html @@ -6,14 +6,14 @@ - usbd_adb — CherryUSB 1.5.1 documentation + usbd_adb — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_audiov1.html b/demo/usbd_audiov1.html index 69d63995..9d72ebf4 100644 --- a/demo/usbd_audiov1.html +++ b/demo/usbd_audiov1.html @@ -6,14 +6,14 @@ - usbd_audiov1 — CherryUSB 1.5.1 documentation + usbd_audiov1 — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_audiov2.html b/demo/usbd_audiov2.html index ad9e6edb..13106af5 100644 --- a/demo/usbd_audiov2.html +++ b/demo/usbd_audiov2.html @@ -6,14 +6,14 @@ - usbd_audiov2 — CherryUSB 1.5.1 documentation + usbd_audiov2 — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_cdc_acm.html b/demo/usbd_cdc_acm.html index f13bc332..230d1557 100644 --- a/demo/usbd_cdc_acm.html +++ b/demo/usbd_cdc_acm.html @@ -6,14 +6,14 @@ - usbd_cdc_acm — CherryUSB 1.5.1 documentation + usbd_cdc_acm — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_ecm.html b/demo/usbd_ecm.html index b044e060..393142d6 100644 --- a/demo/usbd_ecm.html +++ b/demo/usbd_ecm.html @@ -6,14 +6,14 @@ - usbd_cdc_ecm — CherryUSB 1.5.1 documentation + usbd_cdc_ecm — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_hid.html b/demo/usbd_hid.html index 243efb99..882b84df 100644 --- a/demo/usbd_hid.html +++ b/demo/usbd_hid.html @@ -6,14 +6,14 @@ - usbd_hid — CherryUSB 1.5.1 documentation + usbd_hid — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_msc.html b/demo/usbd_msc.html index b8286412..9602f559 100644 --- a/demo/usbd_msc.html +++ b/demo/usbd_msc.html @@ -6,14 +6,14 @@ - usbd_msc — CherryUSB 1.5.1 documentation + usbd_msc — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_rndis.html b/demo/usbd_rndis.html index 17a888b7..ac4ffbbf 100644 --- a/demo/usbd_rndis.html +++ b/demo/usbd_rndis.html @@ -6,14 +6,14 @@ - usbd_rndis — CherryUSB 1.5.1 documentation + usbd_rndis — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_vendor.html b/demo/usbd_vendor.html index 80a85e19..a02eedcb 100644 --- a/demo/usbd_vendor.html +++ b/demo/usbd_vendor.html @@ -6,14 +6,14 @@ - vendor device 驱动编写 — CherryUSB 1.5.1 documentation + vendor device 驱动编写 — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_video.html b/demo/usbd_video.html index 0c0ba8f6..e968496d 100644 --- a/demo/usbd_video.html +++ b/demo/usbd_video.html @@ -6,14 +6,14 @@ - usbd_video — CherryUSB 1.5.1 documentation + usbd_video — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_webusb.html b/demo/usbd_webusb.html index 04236ced..33535d7e 100644 --- a/demo/usbd_webusb.html +++ b/demo/usbd_webusb.html @@ -6,14 +6,14 @@ - usbd_webusb — CherryUSB 1.5.1 documentation + usbd_webusb — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbd_winusb.html b/demo/usbd_winusb.html index 228869ff..38beb02c 100644 --- a/demo/usbd_winusb.html +++ b/demo/usbd_winusb.html @@ -6,14 +6,14 @@ - usbd_winusb — CherryUSB 1.5.1 documentation + usbd_winusb — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_bluetooth.html b/demo/usbh_bluetooth.html index 3f54fa2d..9a19bd70 100644 --- a/demo/usbh_bluetooth.html +++ b/demo/usbh_bluetooth.html @@ -6,14 +6,14 @@ - usbh_bluetooth — CherryUSB 1.5.1 documentation + usbh_bluetooth — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_hid.html b/demo/usbh_hid.html index a5930136..eb4d8dd1 100644 --- a/demo/usbh_hid.html +++ b/demo/usbh_hid.html @@ -6,14 +6,14 @@ - usbh_hid — CherryUSB 1.5.1 documentation + usbh_hid — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_msc.html b/demo/usbh_msc.html index 3eb89351..7aa1c552 100644 --- a/demo/usbh_msc.html +++ b/demo/usbh_msc.html @@ -6,14 +6,14 @@ - usbh_msc — CherryUSB 1.5.1 documentation + usbh_msc — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_net.html b/demo/usbh_net.html index d0c64ccf..9443d52b 100644 --- a/demo/usbh_net.html +++ b/demo/usbh_net.html @@ -6,14 +6,14 @@ - usbh_net — CherryUSB 1.5.1 documentation + usbh_net — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_serial.html b/demo/usbh_serial.html index 1355bf83..40d66129 100644 --- a/demo/usbh_serial.html +++ b/demo/usbh_serial.html @@ -6,14 +6,14 @@ - usbh_serial — CherryUSB 1.5.1 documentation + usbh_serial — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_vendor.html b/demo/usbh_vendor.html index 31036504..0e42f0da 100644 --- a/demo/usbh_vendor.html +++ b/demo/usbh_vendor.html @@ -6,14 +6,14 @@ - vendor host 驱动编写 — CherryUSB 1.5.1 documentation + vendor host 驱动编写 — CherryUSB 1.5.2 documentation - + diff --git a/demo/usbh_wifi.html b/demo/usbh_wifi.html index 128a8c88..4b73a2ed 100644 --- a/demo/usbh_wifi.html +++ b/demo/usbh_wifi.html @@ -6,14 +6,14 @@ - usbh_wifi — CherryUSB 1.5.1 documentation + usbh_wifi — CherryUSB 1.5.2 documentation - + diff --git a/genindex.html b/genindex.html index 2e941db7..92a11e94 100644 --- a/genindex.html +++ b/genindex.html @@ -5,14 +5,14 @@ - Index — CherryUSB 1.5.1 documentation + Index — CherryUSB 1.5.2 documentation - + diff --git a/index.html b/index.html index c5147def..79207ad3 100644 --- a/index.html +++ b/index.html @@ -6,14 +6,14 @@ - CherryUSB 使用指南 — CherryUSB 1.5.1 documentation + CherryUSB 使用指南 — CherryUSB 1.5.2 documentation - + diff --git a/objects.inv b/objects.inv index ae1dabff..bca4f0dd 100644 Binary files a/objects.inv and b/objects.inv differ diff --git a/opensource.html b/opensource.html index 82eb1488..b2847e48 100644 --- a/opensource.html +++ b/opensource.html @@ -6,14 +6,14 @@ - 官方开源项目分享 — CherryUSB 1.5.1 documentation + 官方开源项目分享 — CherryUSB 1.5.2 documentation - + diff --git a/q&a.html b/q&a.html index a76da974..6cb643d7 100644 --- a/q&a.html +++ b/q&a.html @@ -6,14 +6,14 @@ - Q & A — CherryUSB 1.5.1 documentation + Q & A — CherryUSB 1.5.2 documentation - + diff --git a/quick_start/demo.html b/quick_start/demo.html index d0e14852..d05db2cc 100644 --- a/quick_start/demo.html +++ b/quick_start/demo.html @@ -6,14 +6,14 @@ - 基于现有 demo 快速验证 — CherryUSB 1.5.1 documentation + 基于现有 demo 快速验证 — CherryUSB 1.5.2 documentation - + @@ -46,14 +46,15 @@ @@ -319,6 +320,21 @@

  • sifli usb device 初步支持

    • +
    +

    v1.5.2

    + +