index.rst 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  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. - 比较全面的 class 驱动,并且 class 驱动全部模板化,方便学习和自主添加
  9. - 树状化编程,方便理清 class 驱动与接口、端点的关系,hub、port、class 之间的关系;代码层层递进,调用关系一目了然,方便理清 usb 枚举过程和 class 驱动加载
  10. - 设备协议栈的使用简化到类如 uart 、dma 的使用,主机协议栈的使用简化到文件的使用
  11. - 标准化的 porting 接口,同时面向 ip 化编程,相同 ip 无需重复编写驱动
  12. - Api 少,分类清晰:dcd/hcd api、注册 api、命令回调 api
  13. - 代码精简,内存占用极小,同时能够达到 usb 硬件能够达到的最大带宽
  14. 其他相关链接:
  15. - **从机协议栈视频教程** https://www.bilibili.com/video/BV1Ef4y1t73d
  16. - **主机协议栈视频教程** TODO
  17. - **github** https://github.com/sakumisu/CherryUSB
  18. .. toctree::
  19. :maxdepth: 1
  20. :caption: 快速上手
  21. quick_start/bl702
  22. quick_start/stm32
  23. quick_start/es32
  24. quick_start/rt-thread/rtthread
  25. quick_start/other_chip
  26. .. toctree::
  27. :maxdepth: 1
  28. :caption: USB 基本知识点
  29. usb/usb_basic
  30. usb/usb_desc
  31. usb/usb_request
  32. usb/usb_enum
  33. .. toctree::
  34. :maxdepth: 1
  35. :caption: API 手册
  36. api/api_device
  37. api/api_host
  38. api/api_port
  39. api/api_common
  40. api/api_config
  41. .. toctree::
  42. :maxdepth: 1
  43. :caption: Class 指南
  44. class/class_cdc
  45. class/class_hid
  46. class/class_msc
  47. class/class_audio
  48. class/class_video
  49. class/winusb
  50. .. toctree::
  51. :maxdepth: 1
  52. :caption: 综合例程
  53. demo/usb2uart
  54. demo/mouse_keyboard
  55. demo/msc_boot
  56. demo/video
  57. demo/speaker_mic
  58. demo/daplink
  59. .. toctree::
  60. :maxdepth: 1
  61. :caption: Porting 说明
  62. porting
  63. porting_usbip
  64. .. toctree::
  65. :maxdepth: 1
  66. :caption: 工具使用
  67. tools/index