index.rst 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. .. CherryUSB 使用指南 documentation master file, created by
  2. sphinx-quickstart on Thu Nov 21 10:50:33 2019.
  3. You can adapt this file completely to your liking, but it should at least
  4. contain the root `toctree` directive.
  5. CherryUSB 使用指南
  6. ======================================================
  7. CherryUSB 是一个小而美的、可移植性高的、用于嵌入式系统的 USB 主从协议栈。同时 CherryUSB 具有以下优点:
  8. - 代码精简,并且内存占用极小,而且还可进一步的裁剪
  9. - 全面的 class 驱动,并且主从 class 驱动全部模板化,方便用户增加新的 class 驱动以及学习的时候查找规律
  10. - 可供用户使用的 API 非常少,并且分类清晰。从机:初始化 + 注册、命令回调类、数据收发类;主机:初始化 + 查找类、数据收发类
  11. - 树状化编程,代码层层递进,方便用户理清函数调用关系、枚举和 class 驱动加载过程
  12. - 标准化的 porting 接口,相同 ip 无需重写驱动,并且 porting 驱动也进行了模板化,方便用户新增 porting。
  13. - 主从收发接口的使用等价于 uart tx/rx dma 的使用,长度也没有限制
  14. - 能够达到 USB 硬件理论带宽
  15. 其他相关链接:
  16. - **从机协议栈视频教程** https://www.bilibili.com/video/BV1Ef4y1t73d
  17. - **主机协议栈视频教程** TODO
  18. - **github** https://github.com/sakumisu/CherryUSB
  19. .. toctree::
  20. :maxdepth: 1
  21. :caption: 快速上手
  22. quick_start/bl702
  23. quick_start/stm32
  24. quick_start/es32
  25. quick_start/rt-thread/rtthread
  26. quick_start/other_chip
  27. .. toctree::
  28. :maxdepth: 1
  29. :caption: USB 基本知识点
  30. usb/usb2.0_basic
  31. usb/usb3.0_basic
  32. usb/usb_desc
  33. usb/usb_request
  34. usb/usb_enum
  35. .. toctree::
  36. :maxdepth: 1
  37. :caption: API 手册
  38. api/api_device
  39. api/api_host
  40. api/api_port
  41. api/api_common
  42. api/api_config
  43. .. toctree::
  44. :maxdepth: 1
  45. :caption: Class 指南
  46. class/class_cdc
  47. class/class_hid
  48. class/class_msc
  49. class/class_audio
  50. class/class_video
  51. class/winusb
  52. .. toctree::
  53. :maxdepth: 1
  54. :caption: 综合例程
  55. demo/usb2uart
  56. demo/mouse_keyboard
  57. demo/msc_boot
  58. demo/video
  59. demo/speaker_mic
  60. demo/daplink
  61. .. toctree::
  62. :maxdepth: 1
  63. :caption: Porting 说明
  64. porting
  65. porting_usbip
  66. .. toctree::
  67. :maxdepth: 1
  68. :caption: 工具使用
  69. tools/index