Почетна Преглед Помоћ
Пријавите се
cherry-embedded
/
CherryUSB
огледало од https://github-proxy.rt-thread.io/cherry-embedded/CherryUSB.git
2
0
Креирај огранак 0
Датотеке Дискусије 0 Вики
Дрво: d6975facbc
Гране Ознаке
CherryUSB
/
api
/
api_device.html

api_device.html 55 KB
Историја Датотека

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703 
  1. 

  2. 

  3. <!DOCTYPE html>
    4. 

  4. <html class="writer-html5" lang="en" data-content_root="../">
    5. 

  5. <head>
    6. 

  6.   <meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
    7. 

  7. 

  8.   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    9. 

  9.   <title>设备协议栈 &mdash; CherryUSB 1.5.0 documentation</title>
    10. 

  10.       <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
    11. 

  11.       <link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" />
    12. 

  12. 

  13.   
    14. 

  14.       <script src="../_static/jquery.js?v=5d32c60e"></script>
    15. 

  15.       <script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
    16. 

  16.       <script src="../_static/documentation_options.js?v=e0a75244"></script>
    17. 

  17.       <script src="../_static/doctools.js?v=9a2dae69"></script>
    18. 

  18.       <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
    19. 

  19.     <script src="../_static/js/theme.js"></script>
    20. 

  20.     <link rel="index" title="Index" href="../genindex.html" />
    21. 

  21.     <link rel="search" title="Search" href="../search.html" />
    22. 

  22.     <link rel="next" title="主机协议栈" href="api_host.html" />
    23. 

  23.     <link rel="prev" title="USB 知识点拓展" href="../usb/usb_ext.html" /> 
    24. 

  24. </head>
    25. 

  25. 

  26. <body class="wy-body-for-nav"> 
    27. 

  27.   <div class="wy-grid-for-nav">
    28. 

  28.     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
    29. 

  29.       <div class="wy-side-scroll">
    30. 

  30.         <div class="wy-side-nav-search" >
    31. 

  31. 

  32.           
    33. 

  33.           
    34. 

  34.           <a href="../index.html" class="icon icon-home">
    35. 

  35.             CherryUSB
    36. 

  36.           </a>
    37. 

  37. <div role="search">
    38. 

  38.   <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    39. 

  39.     <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
    40. 

  40.     <input type="hidden" name="check_keywords" value="yes" />
    41. 

  41.     <input type="hidden" name="area" value="default" />
    42. 

  42.   </form>
    43. 

  43. </div>
    44. 

  44.         </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
    45. 

  45.               <p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
    46. 

  46. <ul>
    47. 

  47. <li class="toctree-l1"><a class="reference internal" href="../quick_start/start.html">入门必看</a></li>
    48. 

  48. <li class="toctree-l1"><a class="reference internal" href="../quick_start/demo.html">基于现有 demo 快速验证</a></li>
    49. 

  49. <li class="toctree-l1"><a class="reference internal" href="../quick_start/transplant.html">芯片通用移植指南</a></li>
    50. 

  50. <li class="toctree-l1"><a class="reference internal" href="../quick_start/rtthread.html">基于 RT-Thread 软件包开发指南</a></li>
    51. 

  51. <li class="toctree-l1"><a class="reference internal" href="../quick_start/esp.html">基于 ESP-Registry 开发指南</a></li>
    52. 

  52. <li class="toctree-l1"><a class="reference internal" href="../q%26a.html">Q &amp; A</a></li>
    53. 

  53. <li class="toctree-l1"><a class="reference internal" href="../opensource.html">官方开源项目分享</a></li>
    54. 

  54. <li class="toctree-l1"><a class="reference internal" href="../share.html">开发者经验/开源项目分享</a></li>
    55. 

  55. </ul>
    56. 

  56. <p class="caption" role="heading"><span class="caption-text">USB 基本知识点</span></p>
    57. 

  57. <ul>
    58. 

  58. <li class="toctree-l1"><a class="reference internal" href="../usb/usb2.0_basic.html">USB 基本概念(2.0 为主)</a></li>
    59. 

  59. <li class="toctree-l1"><a class="reference internal" href="../usb/usb3.0_basic.html">USB 基本概念(3.0 为主)</a></li>
    60. 

  60. <li class="toctree-l1"><a class="reference internal" href="../usb/usb_desc.html">USB 描述符</a></li>
    61. 

  61. <li class="toctree-l1"><a class="reference internal" href="../usb/usb_request.html">USB 设备请求</a></li>
    62. 

  62. <li class="toctree-l1"><a class="reference internal" href="../usb/usb_enum.html">USB 枚举</a></li>
    63. 

  63. <li class="toctree-l1"><a class="reference internal" href="../usb/usb_ext.html">USB 知识点拓展</a></li>
    64. 

  64. </ul>
    65. 

  65. <p class="caption" role="heading"><span class="caption-text">API 手册</span></p>
    66. 

  66. <ul class="current">
    67. 

  67. <li class="toctree-l1 current"><a class="current reference internal" href="#">设备协议栈</a><ul>
    68. 

  68. <li class="toctree-l2"><a class="reference internal" href="#core">CORE</a><ul>
    69. 

  69. <li class="toctree-l3"><a class="reference internal" href="#id2">端点结构体</a></li>
    70. 

  70. <li class="toctree-l3"><a class="reference internal" href="#id3">接口结构体</a></li>
    71. 

  71. <li class="toctree-l3"><a class="reference internal" href="#usbd-desc-register">usbd_desc_register</a></li>
    72. 

  72. <li class="toctree-l3"><a class="reference internal" href="#usbd-msosv1-desc-register">usbd_msosv1_desc_register</a></li>
    73. 

  73. <li class="toctree-l3"><a class="reference internal" href="#usbd-msosv2-desc-register">usbd_msosv2_desc_register</a></li>
    74. 

  74. <li class="toctree-l3"><a class="reference internal" href="#usbd-bos-desc-register">usbd_bos_desc_register</a></li>
    75. 

  75. <li class="toctree-l3"><a class="reference internal" href="#usbd-add-interface">usbd_add_interface</a></li>
    76. 

  76. <li class="toctree-l3"><a class="reference internal" href="#usbd-add-endpoint">usbd_add_endpoint</a></li>
    77. 

  77. <li class="toctree-l3"><a class="reference internal" href="#usbd-initialize">usbd_initialize</a></li>
    78. 

  78. <li class="toctree-l3"><a class="reference internal" href="#usbd-event-handler">usbd_event_handler</a></li>
    79. 

  79. </ul>
    80. 

  80. </li>
    81. 

  81. <li class="toctree-l2"><a class="reference internal" href="#cdc-acm">CDC ACM</a><ul>
    82. 

  82. <li class="toctree-l3"><a class="reference internal" href="#usbd-cdc-acm-init-intf">usbd_cdc_acm_init_intf</a></li>
    83. 

  83. <li class="toctree-l3"><a class="reference internal" href="#usbd-cdc-acm-set-line-coding">usbd_cdc_acm_set_line_coding</a></li>
    84. 

  84. <li class="toctree-l3"><a class="reference internal" href="#usbd-cdc-acm-get-line-coding">usbd_cdc_acm_get_line_coding</a></li>
    85. 

  85. <li class="toctree-l3"><a class="reference internal" href="#usbd-cdc-acm-set-dtr">usbd_cdc_acm_set_dtr</a></li>
    86. 

  86. <li class="toctree-l3"><a class="reference internal" href="#usbd-cdc-acm-set-rts">usbd_cdc_acm_set_rts</a></li>
    87. 

  87. <li class="toctree-l3"><a class="reference internal" href="#cdc-acm-descriptor-init">CDC_ACM_DESCRIPTOR_INIT</a></li>
    88. 

  88. </ul>
    89. 

  89. </li>
    90. 

  90. <li class="toctree-l2"><a class="reference internal" href="#hid">HID</a><ul>
    91. 

  91. <li class="toctree-l3"><a class="reference internal" href="#usbd-hid-init-intf">usbd_hid_init_intf</a></li>
    92. 

  92. </ul>
    93. 

  93. </li>
    94. 

  94. <li class="toctree-l2"><a class="reference internal" href="#msc">MSC</a><ul>
    95. 

  95. <li class="toctree-l3"><a class="reference internal" href="#usbd-msc-init-intf">usbd_msc_init_intf</a></li>
    96. 

  96. <li class="toctree-l3"><a class="reference internal" href="#usbd-msc-get-cap">usbd_msc_get_cap</a></li>
    97. 

  97. <li class="toctree-l3"><a class="reference internal" href="#usbd-msc-sector-read">usbd_msc_sector_read</a></li>
    98. 

  98. <li class="toctree-l3"><a class="reference internal" href="#usbd-msc-sector-write">usbd_msc_sector_write</a></li>
    99. 

  99. </ul>
    100. 

  100. </li>
    101. 

  101. <li class="toctree-l2"><a class="reference internal" href="#uac">UAC</a><ul>
    102. 

  102. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-init-intf">usbd_audio_init_intf</a></li>
    103. 

  103. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-open">usbd_audio_open</a></li>
    104. 

  104. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-close">usbd_audio_close</a></li>
    105. 

  105. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-add-entity">usbd_audio_add_entity</a></li>
    106. 

  106. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-set-mute">usbd_audio_set_mute</a></li>
    107. 

  107. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-set-volume">usbd_audio_set_volume</a></li>
    108. 

  108. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-set-sampling-freq">usbd_audio_set_sampling_freq</a></li>
    109. 

  109. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-get-sampling-freq-table">usbd_audio_get_sampling_freq_table</a></li>
    110. 

  110. <li class="toctree-l3"><a class="reference internal" href="#usbd-audio-set-pitch">usbd_audio_set_pitch</a></li>
    111. 

  111. </ul>
    112. 

  112. </li>
    113. 

  113. <li class="toctree-l2"><a class="reference internal" href="#uvc">UVC</a><ul>
    114. 

  114. <li class="toctree-l3"><a class="reference internal" href="#usbd-video-init-intf">usbd_video_init_intf</a></li>
    115. 

  115. <li class="toctree-l3"><a class="reference internal" href="#usbd-video-open">usbd_video_open</a></li>
    116. 

  116. <li class="toctree-l3"><a class="reference internal" href="#usbd-video-close">usbd_video_close</a></li>
    117. 

  117. <li class="toctree-l3"><a class="reference internal" href="#usbd-video-payload-fill">usbd_video_payload_fill</a></li>
    118. 

  118. </ul>
    119. 

  119. </li>
    120. 

  120. <li class="toctree-l2"><a class="reference internal" href="#dfu">DFU</a></li>
    121. 

  121. <li class="toctree-l2"><a class="reference internal" href="#printer">PRINTER</a></li>
    122. 

  122. <li class="toctree-l2"><a class="reference internal" href="#mtp">MTP</a></li>
    123. 

  123. </ul>
    124. 

  124. </li>
    125. 

  125. <li class="toctree-l1"><a class="reference internal" href="api_host.html">主机协议栈</a></li>
    126. 

  126. <li class="toctree-l1"><a class="reference internal" href="api_port.html">主从驱动</a></li>
    127. 

  127. <li class="toctree-l1"><a class="reference internal" href="api_config.html">USB CONFIG 说明</a></li>
    128. 

  128. </ul>
    129. 

  129. <p class="caption" role="heading"><span class="caption-text">Class 指南</span></p>
    130. 

  130. <ul>
    131. 

  131. <li class="toctree-l1"><a class="reference internal" href="../class/class_cdc.html">CDC</a></li>
    132. 

  132. <li class="toctree-l1"><a class="reference internal" href="../class/class_hid.html">HID</a></li>
    133. 

  133. <li class="toctree-l1"><a class="reference internal" href="../class/class_msc.html">MSC</a></li>
    134. 

  134. <li class="toctree-l1"><a class="reference internal" href="../class/class_audio.html">UAC</a></li>
    135. 

  135. <li class="toctree-l1"><a class="reference internal" href="../class/class_video.html">UVC</a></li>
    136. 

  136. <li class="toctree-l1"><a class="reference internal" href="../class/winusb.html">WINUSB</a></li>
    137. 

  137. </ul>
    138. 

  138. <p class="caption" role="heading"><span class="caption-text">例程说明</span></p>
    139. 

  139. <ul>
    140. 

  140. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_cdc_acm.html">usbd_cdc_acm</a></li>
    141. 

  141. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_hid.html">usbd_hid</a></li>
    142. 

  142. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_msc.html">usbd_msc</a></li>
    143. 

  143. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_rndis.html">usbd_rndis</a></li>
    144. 

  144. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_ecm.html">usbd_cdc_ecm</a></li>
    145. 

  145. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_audiov1.html">usbd_audiov1</a></li>
    146. 

  146. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_audiov2.html">usbd_audiov2</a></li>
    147. 

  147. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_video.html">usbd_video</a></li>
    148. 

  148. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_winusb.html">usbd_winusb</a></li>
    149. 

  149. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_webusb.html">usbd_webusb</a></li>
    150. 

  150. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_serial.html">usbh_serial</a></li>
    151. 

  151. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_hid.html">usbh_hid</a></li>
    152. 

  152. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_msc.html">usbh_msc</a></li>
    153. 

  153. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_net.html">usbh_net</a></li>
    154. 

  154. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_bluetooth.html">usbh_bluetooth</a></li>
    155. 

  155. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_wifi.html">usbh_wifi</a></li>
    156. 

  156. <li class="toctree-l1"><a class="reference internal" href="../demo/usbd_vendor.html">vendor device 驱动编写</a></li>
    157. 

  157. <li class="toctree-l1"><a class="reference internal" href="../demo/usbh_vendor.html">vendor host 驱动编写</a></li>
    158. 

  158. </ul>
    159. 

  159. <p class="caption" role="heading"><span class="caption-text">USBIP 介绍</span></p>
    160. 

  160. <ul>
    161. 

  161. <li class="toctree-l1"><a class="reference internal" href="../usbip/ohci.html">OHCI</a></li>
    162. 

  162. <li class="toctree-l1"><a class="reference internal" href="../usbip/ehci.html">EHCI</a></li>
    163. 

  163. <li class="toctree-l1"><a class="reference internal" href="../usbip/xhci.html">XHCI</a></li>
    164. 

  164. <li class="toctree-l1"><a class="reference internal" href="../usbip/chipidea.html">CHIPIDEA</a></li>
    165. 

  165. <li class="toctree-l1"><a class="reference internal" href="../usbip/dwc2.html">DWC2</a></li>
    166. 

  166. <li class="toctree-l1"><a class="reference internal" href="../usbip/musb.html">MUSB</a></li>
    167. 

  167. <li class="toctree-l1"><a class="reference internal" href="../usbip/fotg210.html">FOTG210</a></li>
    168. 

  168. <li class="toctree-l1"><a class="reference internal" href="../usbip/cdns2.html">CDNS2</a></li>
    169. 

  169. <li class="toctree-l1"><a class="reference internal" href="../usbip/cdns3.html">CDNS3</a></li>
    170. 

  170. <li class="toctree-l1"><a class="reference internal" href="../usbip/dwc3.html">DWC3</a></li>
    171. 

  171. </ul>
    172. 

  172. <p class="caption" role="heading"><span class="caption-text">工具使用</span></p>
    173. 

  173. <ul>
    174. 

  174. <li class="toctree-l1"><a class="reference internal" href="../tools/index.html">chryusb_configurator</a></li>
    175. 

  175. <li class="toctree-l1"><a class="reference internal" href="../tools/index.html#usb-protocol-suite">力科 USB Protocol Suite</a></li>
    176. 

  176. <li class="toctree-l1"><a class="reference internal" href="../tools/index.html#wireshark">Wireshark</a></li>
    177. 

  177. <li class="toctree-l1"><a class="reference internal" href="../tools/index.html#audacity">Audacity</a></li>
    178. 

  178. </ul>
    179. 

  179. <p class="caption" role="heading"><span class="caption-text">版本说明</span></p>
    180. 

  180. <ul>
    181. 

  181. <li class="toctree-l1"><a class="reference internal" href="../version.html">版本说明</a></li>
    182. 

  182. </ul>
    183. 

  183. <p class="caption" role="heading"><span class="caption-text">性能展示</span></p>
    184. 

  184. <ul>
    185. 

  185. <li class="toctree-l1"><a class="reference internal" href="../show/index.html">性能展示</a></li>
    186. 

  186. </ul>
    187. 

  187. <p class="caption" role="heading"><span class="caption-text">商业支持</span></p>
    188. 

  188. <ul>
    189. 

  189. <li class="toctree-l1"><a class="reference internal" href="../support/index.html">商业支持</a></li>
    190. 

  190. </ul>
    191. 

  191. 

  192.         </div>
    193. 

  193.       </div>
    194. 

  194.     </nav>
    195. 

  195. 

  196.     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
    197. 

  197.           <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
    198. 

  198.           <a href="../index.html">CherryUSB</a>
    199. 

  199.       </nav>
    200. 

  200. 

  201.       <div class="wy-nav-content">
    202. 

  202.         <div class="rst-content">
    203. 

  203.           <div role="navigation" aria-label="Page navigation">
    204. 

  204.   <ul class="wy-breadcrumbs">
    205. 

  205.       <li><a href="../index.html" class="icon icon-home" aria-label="Home"></a></li>
    206. 

  206.       <li class="breadcrumb-item active">设备协议栈</li>
    207. 

  207.       <li class="wy-breadcrumbs-aside">
    208. 

  208.             <a href="../_sources/api/api_device.rst.txt" rel="nofollow"> View page source</a>
    209. 

  209.       </li>
    210. 

  210.   </ul>
    211. 

  211.   <hr/>
    212. 

  212. </div>
    213. 

  213.           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
    214. 

  214.            <div itemprop="articleBody">
    215. 

  215.              
    216. 

  216.   <section id="id1">
    217. 

  217. <h1>设备协议栈<a class="headerlink" href="#id1" title="Link to this heading"></a></h1>
    218. 

  218. <p>设备协议栈主要负责枚举和驱动加载，枚举这边就不说了，驱动加载，也就是接口驱动加载，主要是依靠 <cite>usbd_add_interface</cite> 函数，用于记录传入的接口驱动并保存到接口数组表，当主机进行类请求时就可以查找接口表进行访问了。
    219. 

  219. 在调用 <cite>usbd_desc_register</cite> 以后需要进行接口注册和端点注册，口诀如下：</p>
    220. 

  220. <ul class="simple">
    221. 

  221. <li><p>有多少个接口就调用多少次 <cite>usbd_add_interface</cite>，参数填相关 <cite>xxx_init_intf</cite>, 如果没有支持的，手动创建一个 intf 填入</p></li>
    222. 

  222. <li><p>有多少个端点就调用多少次 <cite>usbd_add_endpoint</cite>，当中断完成时，会调用到注册的端点回调中。</p></li>
    223. 

  223. </ul>
    224. 

  224. <section id="core">
    225. 

  225. <h2>CORE<a class="headerlink" href="#core" title="Link to this heading"></a></h2>
    226. 

  226. <div class="admonition note">
    227. 

  227. <p class="admonition-title">Note</p>
    228. 

  228. <p>请注意，v1.1 版本开始增加 busid 形参，其余保持不变，所以 API 说明不做更新</p>
    229. 

  229. </div>
    230. 

  230. <section id="id2">
    231. 

  231. <h3>端点结构体<a class="headerlink" href="#id2" title="Link to this heading"></a></h3>
    232. 

  232. <p>端点结构体主要用于注册不同端点地址的中断完成回调函数。</p>
    233. 

  233. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_endpoint</span><span class="w"> </span><span class="p">{</span>
    234. 

  234. <span class="w">    </span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">ep_addr</span><span class="p">;</span>
    235. 

  235. <span class="w">    </span><span class="n">usbd_endpoint_callback</span><span class="w"> </span><span class="n">ep_cb</span><span class="p">;</span>
    236. 

  236. <span class="p">};</span>
    237. 

  237. </pre></div>
    238. 

  238. </div>
    239. 

  239. <ul class="simple">
    240. 

  240. <li><p><strong>list</strong> 端点的链表节点</p></li>
    241. 

  241. <li><p><strong>ep_addr</strong> 端点地址（带方向）</p></li>
    242. 

  242. <li><p><strong>ep_cb</strong> 端点完成中断回调函数。</p></li>
    243. 

  243. </ul>
    244. 

  244. <div class="admonition note">
    245. 

  245. <p class="admonition-title">Note</p>
    246. 

  246. <p>总结一句话：in 回调函数等价于 dma 发送完成中断回调函数；out 回调函数等价于 dma 接收完成中断回调函数</p>
    247. 

  247. </div>
    248. 

  248. </section>
    249. 

  249. <section id="id3">
    250. 

  250. <h3>接口结构体<a class="headerlink" href="#id3" title="Link to this heading"></a></h3>
    251. 

  251. <p>接口结构体主要用于注册不同类设备除了标准设备请求外的其他请求，包括类设备请求、厂商设备请求和自定义设备请求。以及协议栈中的相关通知回调函数。</p>
    252. 

  252. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="p">{</span>
    253. 

  253. <span class="w">    </span><span class="n">usbd_request_handler</span><span class="w"> </span><span class="n">class_interface_handler</span><span class="p">;</span>
    254. 

  254. <span class="w">    </span><span class="n">usbd_request_handler</span><span class="w"> </span><span class="n">class_endpoint_handler</span><span class="p">;</span>
    255. 

  255. <span class="w">    </span><span class="n">usbd_request_handler</span><span class="w"> </span><span class="n">vendor_handler</span><span class="p">;</span>
    256. 

  256. <span class="w">    </span><span class="n">usbd_notify_handler</span><span class="w"> </span><span class="n">notify_handler</span><span class="p">;</span>
    257. 

  257. <span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">hid_report_descriptor</span><span class="p">;</span>
    258. 

  258. <span class="w">    </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">hid_report_descriptor_len</span><span class="p">;</span>
    259. 

  259. <span class="w">    </span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf_num</span><span class="p">;</span>
    260. 

  260. <span class="p">};</span>
    261. 

  261. </pre></div>
    262. 

  262. </div>
    263. 

  263. <ul class="simple">
    264. 

  264. <li><p><strong>class_interface_handler</strong> class setup 请求回调函数,接收者为接口</p></li>
    265. 

  265. <li><p><strong>class_endpoint_handler</strong> class setup 请求回调函数,接收者为端点</p></li>
    266. 

  266. <li><p><strong>vendor_handler</strong> vendor setup 请求回调函数</p></li>
    267. 

  267. <li><p><strong>notify_handler</strong> 中断标志、协议栈相关状态回调函数</p></li>
    268. 

  268. <li><p><strong>hid_report_descriptor</strong> hid 报告描述符</p></li>
    269. 

  269. <li><p><strong>hid_report_descriptor_len</strong> hid 报告描述符长度</p></li>
    270. 

  270. <li><p><strong>intf_num</strong> 当前接口偏移</p></li>
    271. 

  271. <li><p><strong>ep_list</strong> 端点的链表节点</p></li>
    272. 

  272. </ul>
    273. 

  273. </section>
    274. 

  274. <section id="usbd-desc-register">
    275. 

  275. <h3>usbd_desc_register<a class="headerlink" href="#usbd-desc-register" title="Link to this heading"></a></h3>
    276. 

  276. <p><code class="docutils literal notranslate"><span class="pre">usbd_desc_register</span></code> 用来注册 USB 描述符，描述符种类包括：设备描述符、配置描述符（包含配置描述符、接口描述符、class 类描述符、端点描述符）、字符串描述符、设备限定描述符。</p>
    277. 

  277. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_desc_register</span><span class="p">(</span><span class="k">const</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">desc</span><span class="p">);</span>
    278. 

  278. </pre></div>
    279. 

  279. </div>
    280. 

  280. <ul class="simple">
    281. 

  281. <li><p><strong>desc</strong>  描述符的句柄</p></li>
    282. 

  282. </ul>
    283. 

  283. <div class="admonition note">
    284. 

  284. <p class="admonition-title">Note</p>
    285. 

  285. <p>当前 API 仅支持一种速度，如果需要更高级的速度切换功能，请开启 CONFIG_USBDEV_ADVANCE_DESC，并且包含了下面所有描述符注册功能</p>
    286. 

  286. </div>
    287. 

  287. </section>
    288. 

  288. <section id="usbd-msosv1-desc-register">
    289. 

  289. <h3>usbd_msosv1_desc_register<a class="headerlink" href="#usbd-msosv1-desc-register" title="Link to this heading"></a></h3>
    290. 

  290. <p><code class="docutils literal notranslate"><span class="pre">usbd_msosv1_desc_register</span></code> 用来注册一个 WINUSB 1.0 描述符。</p>
    291. 

  291. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_msosv1_desc_register</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usb_msosv1_descriptor</span><span class="w"> </span><span class="o">*</span><span class="n">desc</span><span class="p">);</span>
    292. 

  292. </pre></div>
    293. 

  293. </div>
    294. 

  294. <ul class="simple">
    295. 

  295. <li><p><strong>desc</strong>  描述符句柄</p></li>
    296. 

  296. </ul>
    297. 

  297. </section>
    298. 

  298. <section id="usbd-msosv2-desc-register">
    299. 

  299. <h3>usbd_msosv2_desc_register<a class="headerlink" href="#usbd-msosv2-desc-register" title="Link to this heading"></a></h3>
    300. 

  300. <p><code class="docutils literal notranslate"><span class="pre">usbd_msosv2_desc_register</span></code> 用来注册一个 WINUSB 2.0 描述符。</p>
    301. 

  301. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_msosv2_desc_register</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usb_msosv2_descriptor</span><span class="w"> </span><span class="o">*</span><span class="n">desc</span><span class="p">);</span>
    302. 

  302. </pre></div>
    303. 

  303. </div>
    304. 

  304. <ul class="simple">
    305. 

  305. <li><p><strong>desc</strong>  描述符句柄</p></li>
    306. 

  306. </ul>
    307. 

  307. </section>
    308. 

  308. <section id="usbd-bos-desc-register">
    309. 

  309. <h3>usbd_bos_desc_register<a class="headerlink" href="#usbd-bos-desc-register" title="Link to this heading"></a></h3>
    310. 

  310. <p><code class="docutils literal notranslate"><span class="pre">usbd_bos_desc_register</span></code> 用来注册一个 BOS 描述符， USB 2.1 版本以上必须注册。</p>
    311. 

  311. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_bos_desc_register</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usb_bos_descriptor</span><span class="w"> </span><span class="o">*</span><span class="n">desc</span><span class="p">);</span>
    312. 

  312. </pre></div>
    313. 

  313. </div>
    314. 

  314. <ul class="simple">
    315. 

  315. <li><p><strong>desc</strong>  描述符句柄</p></li>
    316. 

  316. </ul>
    317. 

  317. </section>
    318. 

  318. <section id="usbd-add-interface">
    319. 

  319. <h3>usbd_add_interface<a class="headerlink" href="#usbd-add-interface" title="Link to this heading"></a></h3>
    320. 

  320. <p><code class="docutils literal notranslate"><span class="pre">usbd_add_interface</span></code> 添加一个接口驱动。 <strong>添加顺序必须按照描述符顺序</strong>。</p>
    321. 

  321. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_add_interface</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">intf</span><span class="p">);</span>
    322. 

  322. </pre></div>
    323. 

  323. </div>
    324. 

  324. <ul class="simple">
    325. 

  325. <li><p><strong>intf</strong>  接口驱动句柄，通常从不同 class 的 <cite>xxx_init_intf</cite> 函数获取</p></li>
    326. 

  326. </ul>
    327. 

  327. </section>
    328. 

  328. <section id="usbd-add-endpoint">
    329. 

  329. <h3>usbd_add_endpoint<a class="headerlink" href="#usbd-add-endpoint" title="Link to this heading"></a></h3>
    330. 

  330. <p><code class="docutils literal notranslate"><span class="pre">usbd_add_endpoint</span></code> 添加一个端点中断完成回调函数。</p>
    331. 

  331. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_add_endpoint</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_endpoint</span><span class="w"> </span><span class="o">*</span><span class="n">ep</span><span class="p">);;</span>
    332. 

  332. </pre></div>
    333. 

  333. </div>
    334. 

  334. <ul class="simple">
    335. 

  335. <li><p><strong>ep</strong>    端点句柄</p></li>
    336. 

  336. </ul>
    337. 

  337. </section>
    338. 

  338. <section id="usbd-initialize">
    339. 

  339. <h3>usbd_initialize<a class="headerlink" href="#usbd-initialize" title="Link to this heading"></a></h3>
    340. 

  340. <p><code class="docutils literal notranslate"><span class="pre">usbd_initialize</span></code> 用来初始化 usb device 寄存器配置、usb 时钟、中断等，需要注意，此函数必须在所有列出的 API 最后。 <strong>如果使用 os，必须放在线程中执行</strong>。</p>
    341. 

  341. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">int</span><span class="w"> </span><span class="nf">usbd_initialize</span><span class="p">(</span><span class="kt">void</span><span class="p">);</span>
    342. 

  342. </pre></div>
    343. 

  343. </div>
    344. 

  344. </section>
    345. 

  345. <section id="usbd-event-handler">
    346. 

  346. <h3>usbd_event_handler<a class="headerlink" href="#usbd-event-handler" title="Link to this heading"></a></h3>
    347. 

  347. <p><code class="docutils literal notranslate"><span class="pre">usbd_event_handler</span></code> 是协议栈中中断或者协议栈一些状态的回调函数。大部分 IP 仅支持 USBD_EVENT_RESET 和 USBD_EVENT_CONFIGURED</p>
    348. 

  348. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_event_handler</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">event</span><span class="p">);</span>
    349. 

  349. </pre></div>
    350. 

  350. </div>
    351. 

  351. </section>
    352. 

  352. </section>
    353. 

  353. <section id="cdc-acm">
    354. 

  354. <h2>CDC ACM<a class="headerlink" href="#cdc-acm" title="Link to this heading"></a></h2>
    355. 

  355. <section id="usbd-cdc-acm-init-intf">
    356. 

  356. <h3>usbd_cdc_acm_init_intf<a class="headerlink" href="#usbd-cdc-acm-init-intf" title="Link to this heading"></a></h3>
    357. 

  357. <p><code class="docutils literal notranslate"><span class="pre">usbd_cdc_acm_init_intf</span></code> 用来初始化 USB CDC ACM 类接口，并实现该接口相关的函数。</p>
    358. 

  358. <ul class="simple">
    359. 

  359. <li><p><code class="docutils literal notranslate"><span class="pre">cdc_acm_class_interface_request_handler</span></code> 用来处理 USB CDC ACM 类 Setup 请求。</p></li>
    360. 

  360. <li><p><code class="docutils literal notranslate"><span class="pre">cdc_notify_handler</span></code> 用来处理 USB CDC 其他中断回调函数。</p></li>
    361. 

  361. </ul>
    362. 

  362. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">usbd_cdc_acm_init_intf</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">intf</span><span class="p">);</span>
    363. 

  363. </pre></div>
    364. 

  364. </div>
    365. 

  365. <ul class="simple">
    366. 

  366. <li><p><strong>return</strong>  接口句柄</p></li>
    367. 

  367. </ul>
    368. 

  368. </section>
    369. 

  369. <section id="usbd-cdc-acm-set-line-coding">
    370. 

  370. <h3>usbd_cdc_acm_set_line_coding<a class="headerlink" href="#usbd-cdc-acm-set-line-coding" title="Link to this heading"></a></h3>
    371. 

  371. <p><code class="docutils literal notranslate"><span class="pre">usbd_cdc_acm_set_line_coding</span></code> 用来对串口进行配置，如果仅使用 USB 而不用 串口，该接口不用用户实现，使用默认。</p>
    372. 

  372. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_cdc_acm_set_line_coding</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">,</span><span class="w"> </span><span class="k">struct</span><span class="w"> </span><span class="nc">cdc_line_coding</span><span class="w"> </span><span class="o">*</span><span class="n">line_coding</span><span class="p">);</span>
    373. 

  373. </pre></div>
    374. 

  374. </div>
    375. 

  375. <ul class="simple">
    376. 

  376. <li><p><strong>intf</strong> 控制接口号</p></li>
    377. 

  377. <li><p><strong>line_coding</strong> 串口配置</p></li>
    378. 

  378. </ul>
    379. 

  379. </section>
    380. 

  380. <section id="usbd-cdc-acm-get-line-coding">
    381. 

  381. <h3>usbd_cdc_acm_get_line_coding<a class="headerlink" href="#usbd-cdc-acm-get-line-coding" title="Link to this heading"></a></h3>
    382. 

  382. <p><code class="docutils literal notranslate"><span class="pre">usbd_cdc_acm_get_line_coding</span></code> 用来获取串口进行配置，如果仅使用 USB 而不用 串口，该接口不用用户实现，使用默认。</p>
    383. 

  383. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_cdc_acm_get_line_coding</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">,</span><span class="w"> </span><span class="k">struct</span><span class="w"> </span><span class="nc">cdc_line_coding</span><span class="w"> </span><span class="o">*</span><span class="n">line_coding</span><span class="p">);</span>
    384. 

  384. </pre></div>
    385. 

  385. </div>
    386. 

  386. <ul class="simple">
    387. 

  387. <li><p><strong>intf</strong> 控制接口号</p></li>
    388. 

  388. <li><p><strong>line_coding</strong> 串口配置</p></li>
    389. 

  389. </ul>
    390. 

  390. </section>
    391. 

  391. <section id="usbd-cdc-acm-set-dtr">
    392. 

  392. <h3>usbd_cdc_acm_set_dtr<a class="headerlink" href="#usbd-cdc-acm-set-dtr" title="Link to this heading"></a></h3>
    393. 

  393. <p><code class="docutils literal notranslate"><span class="pre">usbd_cdc_acm_set_dtr</span></code> 用来控制串口 DTR 。如果仅使用 USB 而不用 串口，该接口不用用户实现，使用默认。</p>
    394. 

  394. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_cdc_acm_set_dtr</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">,</span><span class="w"> </span><span class="kt">bool</span><span class="w"> </span><span class="n">dtr</span><span class="p">);</span>
    395. 

  395. </pre></div>
    396. 

  396. </div>
    397. 

  397. <ul class="simple">
    398. 

  398. <li><p><strong>intf</strong> 控制接口号</p></li>
    399. 

  399. <li><p><strong>dtr</strong> dtr 为1表示拉低电平，为0表示拉高电平</p></li>
    400. 

  400. </ul>
    401. 

  401. </section>
    402. 

  402. <section id="usbd-cdc-acm-set-rts">
    403. 

  403. <h3>usbd_cdc_acm_set_rts<a class="headerlink" href="#usbd-cdc-acm-set-rts" title="Link to this heading"></a></h3>
    404. 

  404. <p><code class="docutils literal notranslate"><span class="pre">usbd_cdc_acm_set_rts</span></code> 用来控制串口 RTS 。如果仅使用 USB 而不用 串口，该接口不用用户实现，使用默认。</p>
    405. 

  405. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_cdc_acm_set_rts</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">,</span><span class="w"> </span><span class="kt">bool</span><span class="w"> </span><span class="n">rts</span><span class="p">);</span>
    406. 

  406. </pre></div>
    407. 

  407. </div>
    408. 

  408. <ul class="simple">
    409. 

  409. <li><p><strong>intf</strong> 控制接口号</p></li>
    410. 

  410. <li><p><strong>rts</strong> rts 为1表示拉低电平，为0表示拉高电平</p></li>
    411. 

  411. </ul>
    412. 

  412. </section>
    413. 

  413. <section id="cdc-acm-descriptor-init">
    414. 

  414. <h3>CDC_ACM_DESCRIPTOR_INIT<a class="headerlink" href="#cdc-acm-descriptor-init" title="Link to this heading"></a></h3>
    415. 

  415. <p><code class="docutils literal notranslate"><span class="pre">CDC_ACM_DESCRIPTOR_INIT</span></code> 配置了默认的 cdc acm 需要的描述符以及参数，方便用户使用。总长度为 <cite>CDC_ACM_DESCRIPTOR_LEN</cite> 。</p>
    416. 

  416. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">CDC_ACM_DESCRIPTOR_INIT</span><span class="p">(</span><span class="n">bFirstInterface</span><span class="p">,</span><span class="w"> </span><span class="n">int_ep</span><span class="p">,</span><span class="w"> </span><span class="n">out_ep</span><span class="p">,</span><span class="w"> </span><span class="n">in_ep</span><span class="p">,</span><span class="w"> </span><span class="n">str_idx</span><span class="p">);</span>
    417. 

  417. </pre></div>
    418. 

  418. </div>
    419. 

  419. <ul class="simple">
    420. 

  420. <li><p><strong>bFirstInterface</strong> 表示该 cdc acm 第一个接口所在所有接口的偏移</p></li>
    421. 

  421. <li><p><strong>int_ep</strong> 表示中断端点地址（带方向）</p></li>
    422. 

  422. <li><p><strong>out_ep</strong> 表示 bulk out 端点地址（带方向）</p></li>
    423. 

  423. <li><p><strong>in_ep</strong> 表示 bulk in 端点地址（带方向）</p></li>
    424. 

  424. <li><p><strong>str_idx</strong> 控制接口对应的字符串 id</p></li>
    425. 

  425. </ul>
    426. 

  426. </section>
    427. 

  427. </section>
    428. 

  428. <section id="hid">
    429. 

  429. <h2>HID<a class="headerlink" href="#hid" title="Link to this heading"></a></h2>
    430. 

  430. <section id="usbd-hid-init-intf">
    431. 

  431. <h3>usbd_hid_init_intf<a class="headerlink" href="#usbd-hid-init-intf" title="Link to this heading"></a></h3>
    432. 

  432. <p><code class="docutils literal notranslate"><span class="pre">usbd_hid_init_intf</span></code> 用来初始化 USB HID 类接口，并实现该接口相关的函数：</p>
    433. 

  433. <ul class="simple">
    434. 

  434. <li><p><code class="docutils literal notranslate"><span class="pre">hid_class_interface_request_handler</span></code> 用来处理 USB HID 类的 Setup 请求。</p></li>
    435. 

  435. <li><p><code class="docutils literal notranslate"><span class="pre">hid_notify_handler</span></code> 用来处理 USB HID 其他中断回调函数。</p></li>
    436. 

  436. </ul>
    437. 

  437. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">usbd_hid_init_intf</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">intf</span><span class="p">,</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">desc</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">desc_len</span><span class="p">);</span>
    438. 

  438. </pre></div>
    439. 

  439. </div>
    440. 

  440. <ul class="simple">
    441. 

  441. <li><p><strong>desc</strong> 报告描述符</p></li>
    442. 

  442. <li><p><strong>desc_len</strong> 报告描述符长度</p></li>
    443. 

  443. </ul>
    444. 

  444. </section>
    445. 

  445. </section>
    446. 

  446. <section id="msc">
    447. 

  447. <h2>MSC<a class="headerlink" href="#msc" title="Link to this heading"></a></h2>
    448. 

  448. <section id="usbd-msc-init-intf">
    449. 

  449. <h3>usbd_msc_init_intf<a class="headerlink" href="#usbd-msc-init-intf" title="Link to this heading"></a></h3>
    450. 

  450. <p><code class="docutils literal notranslate"><span class="pre">usbd_msc_init_intf</span></code> 用来初始化 MSC 类接口，并实现该接口相关函数，并且注册端点回调函数。（因为 msc bot 协议是固定的，所以不需要用于实现，因此端点回调函数自然不需要用户实现）。</p>
    451. 

  451. <ul class="simple">
    452. 

  452. <li><p><code class="docutils literal notranslate"><span class="pre">msc_storage_class_interface_request_handler</span></code> 用于处理 USB MSC Setup 中断请求。</p></li>
    453. 

  453. <li><p><code class="docutils literal notranslate"><span class="pre">msc_storage_notify_handler</span></code> 用于实现 USB MSC 其他中断回调函数。</p></li>
    454. 

  454. <li><p><code class="docutils literal notranslate"><span class="pre">mass_storage_bulk_out</span></code> 用于处理 USB MSC 端点 out 中断。</p></li>
    455. 

  455. <li><p><code class="docutils literal notranslate"><span class="pre">mass_storage_bulk_in</span></code> 用于处理 USB MSC 端点 in 中断。</p></li>
    456. 

  456. </ul>
    457. 

  457. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">usbd_msc_init_intf</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">intf</span><span class="p">,</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">out_ep</span><span class="p">,</span><span class="w"> </span><span class="k">const</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">in_ep</span><span class="p">);</span>
    458. 

  458. </pre></div>
    459. 

  459. </div>
    460. 

  460. <ul class="simple">
    461. 

  461. <li><p><strong>out_ep</strong>     out 端点地址</p></li>
    462. 

  462. <li><p><strong>in_ep</strong>      in 端点地址</p></li>
    463. 

  463. </ul>
    464. 

  464. </section>
    465. 

  465. <section id="usbd-msc-get-cap">
    466. 

  466. <h3>usbd_msc_get_cap<a class="headerlink" href="#usbd-msc-get-cap" title="Link to this heading"></a></h3>
    467. 

  467. <p><code class="docutils literal notranslate"><span class="pre">usbd_msc_get_cap</span></code> 用来获取存储器的 lun、扇区个数和每个扇区大小。用户必须实现该函数。</p>
    468. 

  468. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_msc_get_cap</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">lun</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="o">*</span><span class="n">block_num</span><span class="p">,</span><span class="w"> </span><span class="kt">uint16_t</span><span class="w"> </span><span class="o">*</span><span class="n">block_size</span><span class="p">);</span>
    469. 

  469. </pre></div>
    470. 

  470. </div>
    471. 

  471. <ul class="simple">
    472. 

  472. <li><p><strong>lun</strong> 存储逻辑单元，暂时无用，默认支持一个</p></li>
    473. 

  473. <li><p><strong>block_num</strong>  存储扇区个数</p></li>
    474. 

  474. <li><p><strong>block_size</strong>  存储扇区大小</p></li>
    475. 

  475. </ul>
    476. 

  476. </section>
    477. 

  477. <section id="usbd-msc-sector-read">
    478. 

  478. <h3>usbd_msc_sector_read<a class="headerlink" href="#usbd-msc-sector-read" title="Link to this heading"></a></h3>
    479. 

  479. <p><code class="docutils literal notranslate"><span class="pre">usbd_msc_sector_read</span></code> 用来对存储器某个扇区开始的地址进行数据读取。用户必须实现该函数。</p>
    480. 

  480. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">int</span><span class="w"> </span><span class="nf">usbd_msc_sector_read</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">sector</span><span class="p">,</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">buffer</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">length</span><span class="p">);</span>
    481. 

  481. </pre></div>
    482. 

  482. </div>
    483. 

  483. <ul class="simple">
    484. 

  484. <li><p><strong>sector</strong> 扇区偏移</p></li>
    485. 

  485. <li><p><strong>buffer</strong> 存储读取的数据的指针</p></li>
    486. 

  486. <li><p><strong>length</strong> 读取长度</p></li>
    487. 

  487. </ul>
    488. 

  488. </section>
    489. 

  489. <section id="usbd-msc-sector-write">
    490. 

  490. <h3>usbd_msc_sector_write<a class="headerlink" href="#usbd-msc-sector-write" title="Link to this heading"></a></h3>
    491. 

  491. <p><code class="docutils literal notranslate"><span class="pre">usbd_msc_sector_write</span></code>  用来对存储器某个扇区开始写入数据。用户必须实现该函数。</p>
    492. 

  492. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">int</span><span class="w"> </span><span class="nf">usbd_msc_sector_write</span><span class="p">(</span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">sector</span><span class="p">,</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">buffer</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">length</span><span class="p">);</span>
    493. 

  493. </pre></div>
    494. 

  494. </div>
    495. 

  495. <ul class="simple">
    496. 

  496. <li><p><strong>sector</strong> 扇区偏移</p></li>
    497. 

  497. <li><p><strong>buffer</strong> 写入数据指针</p></li>
    498. 

  498. <li><p><strong>length</strong> 写入长度</p></li>
    499. 

  499. </ul>
    500. 

  500. </section>
    501. 

  501. </section>
    502. 

  502. <section id="uac">
    503. 

  503. <h2>UAC<a class="headerlink" href="#uac" title="Link to this heading"></a></h2>
    504. 

  504. <section id="usbd-audio-init-intf">
    505. 

  505. <h3>usbd_audio_init_intf<a class="headerlink" href="#usbd-audio-init-intf" title="Link to this heading"></a></h3>
    506. 

  506. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_init_intf</span></code>  用来初始化 USB Audio 类接口，并实现该接口相关的函数：</p>
    507. 

  507. <ul class="simple">
    508. 

  508. <li><p><code class="docutils literal notranslate"><span class="pre">audio_class_interface_request_handler</span></code> 用于处理 USB Audio Setup 接口接收者中断请求。</p></li>
    509. 

  509. <li><p><code class="docutils literal notranslate"><span class="pre">audio_class_endpoint_request_handler</span></code> 用于处理 USB Audio Setup 端点接收者中断请求。</p></li>
    510. 

  510. <li><p><code class="docutils literal notranslate"><span class="pre">audio_notify_handler</span></code> 用于实现 USB Audio 其他中断回调函数。</p></li>
    511. 

  511. </ul>
    512. 

  512. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">usbd_audio_init_intf</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">intf</span><span class="p">);</span>
    513. 

  513. </pre></div>
    514. 

  514. </div>
    515. 

  515. <ul class="simple">
    516. 

  516. <li><p><strong>class</strong> 类的句柄</p></li>
    517. 

  517. <li><p><strong>intf</strong>  接口句柄</p></li>
    518. 

  518. </ul>
    519. 

  519. </section>
    520. 

  520. <section id="usbd-audio-open">
    521. 

  521. <h3>usbd_audio_open<a class="headerlink" href="#usbd-audio-open" title="Link to this heading"></a></h3>
    522. 

  522. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_open</span></code>  用来开启音频数据传输。</p>
    523. 

  523. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_open</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">);</span>
    524. 

  524. </pre></div>
    525. 

  525. </div>
    526. 

  526. <ul class="simple">
    527. 

  527. <li><p><strong>intf</strong> 开启的接口号</p></li>
    528. 

  528. </ul>
    529. 

  529. </section>
    530. 

  530. <section id="usbd-audio-close">
    531. 

  531. <h3>usbd_audio_close<a class="headerlink" href="#usbd-audio-close" title="Link to this heading"></a></h3>
    532. 

  532. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_close</span></code>  用来关闭音频数据传输。</p>
    533. 

  533. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_close</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">);</span>
    534. 

  534. </pre></div>
    535. 

  535. </div>
    536. 

  536. <ul class="simple">
    537. 

  537. <li><p><strong>intf</strong> 关闭的接口号</p></li>
    538. 

  538. </ul>
    539. 

  539. </section>
    540. 

  540. <section id="usbd-audio-add-entity">
    541. 

  541. <h3>usbd_audio_add_entity<a class="headerlink" href="#usbd-audio-add-entity" title="Link to this heading"></a></h3>
    542. 

  542. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_add_entity</span></code>  用来添加 unit 相关控制，例如 feature unit、clock source。</p>
    543. 

  543. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_add_entity</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">entity_id</span><span class="p">,</span><span class="w"> </span><span class="kt">uint16_t</span><span class="w"> </span><span class="n">bDescriptorSubtype</span><span class="p">);</span>
    544. 

  544. </pre></div>
    545. 

  545. </div>
    546. 

  546. <ul class="simple">
    547. 

  547. <li><p><strong>entity_id</strong> 要添加的 unit id</p></li>
    548. 

  548. <li><p><strong>bDescriptorSubtype</strong> entity_id 的描述符子类型</p></li>
    549. 

  549. </ul>
    550. 

  550. </section>
    551. 

  551. <section id="usbd-audio-set-mute">
    552. 

  552. <h3>usbd_audio_set_mute<a class="headerlink" href="#usbd-audio-set-mute" title="Link to this heading"></a></h3>
    553. 

  553. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_set_mute</span></code>  用来设置静音。</p>
    554. 

  554. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_set_mute</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">ch</span><span class="p">,</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">enable</span><span class="p">);</span>
    555. 

  555. </pre></div>
    556. 

  556. </div>
    557. 

  557. <ul class="simple">
    558. 

  558. <li><p><strong>ch</strong> 要设置静音的通道</p></li>
    559. 

  559. <li><p><strong>enable</strong> 为1 表示静音，0相反</p></li>
    560. 

  560. </ul>
    561. 

  561. </section>
    562. 

  562. <section id="usbd-audio-set-volume">
    563. 

  563. <h3>usbd_audio_set_volume<a class="headerlink" href="#usbd-audio-set-volume" title="Link to this heading"></a></h3>
    564. 

  564. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_set_volume</span></code>  用来设置音量。</p>
    565. 

  565. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_set_volume</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">ch</span><span class="p">,</span><span class="w"> </span><span class="kt">float</span><span class="w"> </span><span class="n">dB</span><span class="p">);</span>
    566. 

  566. </pre></div>
    567. 

  567. </div>
    568. 

  568. <ul class="simple">
    569. 

  569. <li><p><strong>ch</strong> 要设置音量的通道</p></li>
    570. 

  570. <li><p><strong>dB</strong> 要设置音量的分贝，其中 UAC1.0范围从 -127 ~ +127dB，UAC2.0 从 0 ~ 256dB</p></li>
    571. 

  571. </ul>
    572. 

  572. </section>
    573. 

  573. <section id="usbd-audio-set-sampling-freq">
    574. 

  574. <h3>usbd_audio_set_sampling_freq<a class="headerlink" href="#usbd-audio-set-sampling-freq" title="Link to this heading"></a></h3>
    575. 

  575. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_set_sampling_freq</span></code>  用来设置设备上音频模块的采样率</p>
    576. 

  576. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_set_sampling_freq</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">ep_ch</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">sampling_freq</span><span class="p">);</span>
    577. 

  577. </pre></div>
    578. 

  578. </div>
    579. 

  579. <ul class="simple">
    580. 

  580. <li><p><strong>ch</strong> 要设置采样率的端点或者通道，UAC1.0为端点，UAC2.0 为通道</p></li>
    581. 

  581. <li><p><strong>dB</strong> 要设置的采样率</p></li>
    582. 

  582. </ul>
    583. 

  583. </section>
    584. 

  584. <section id="usbd-audio-get-sampling-freq-table">
    585. 

  585. <h3>usbd_audio_get_sampling_freq_table<a class="headerlink" href="#usbd-audio-get-sampling-freq-table" title="Link to this heading"></a></h3>
    586. 

  586. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_get_sampling_freq_table</span></code>  用来获取支持的采样率列表，如果函数没有实现，则使用默认采样率列表。</p>
    587. 

  587. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_get_sampling_freq_table</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">**</span><span class="n">sampling_freq_table</span><span class="p">);</span>
    588. 

  588. </pre></div>
    589. 

  589. </div>
    590. 

  590. <ul class="simple">
    591. 

  591. <li><p><strong>sampling_freq_table</strong> 采样率列表地址，格式参考默认采样率列表</p></li>
    592. 

  592. </ul>
    593. 

  593. </section>
    594. 

  594. <section id="usbd-audio-set-pitch">
    595. 

  595. <h3>usbd_audio_set_pitch<a class="headerlink" href="#usbd-audio-set-pitch" title="Link to this heading"></a></h3>
    596. 

  596. <p><code class="docutils literal notranslate"><span class="pre">usbd_audio_set_pitch</span></code>  用来设置音频音调，仅 UAC1.0 有这功能。</p>
    597. 

  597. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_audio_set_pitch</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">ep</span><span class="p">,</span><span class="w"> </span><span class="kt">bool</span><span class="w"> </span><span class="n">enable</span><span class="p">);</span>
    598. 

  598. </pre></div>
    599. 

  599. </div>
    600. 

  600. <ul class="simple">
    601. 

  601. <li><p><strong>ep</strong> 要设置音调的端点</p></li>
    602. 

  602. <li><p><strong>enable</strong> 开启或关闭音调</p></li>
    603. 

  603. </ul>
    604. 

  604. </section>
    605. 

  605. </section>
    606. 

  606. <section id="uvc">
    607. 

  607. <h2>UVC<a class="headerlink" href="#uvc" title="Link to this heading"></a></h2>
    608. 

  608. <section id="usbd-video-init-intf">
    609. 

  609. <h3>usbd_video_init_intf<a class="headerlink" href="#usbd-video-init-intf" title="Link to this heading"></a></h3>
    610. 

  610. <p><code class="docutils literal notranslate"><span class="pre">usbd_video_init_intf</span></code>  用来初始化 USB Video 类接口，并实现该接口相关的函数：</p>
    611. 

  611. <ul class="simple">
    612. 

  612. <li><p><code class="docutils literal notranslate"><span class="pre">video_class_interface_request_handler</span></code> 用于处理 USB Video Setup 中断请求。</p></li>
    613. 

  613. <li><p><code class="docutils literal notranslate"><span class="pre">video_notify_handler</span></code> 用于实现 USB Video 其他中断回调函数。</p></li>
    614. 

  614. </ul>
    615. 

  615. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">usbd_video_init_intf</span><span class="p">(</span><span class="k">struct</span><span class="w"> </span><span class="nc">usbd_interface</span><span class="w"> </span><span class="o">*</span><span class="n">intf</span><span class="p">,</span>
    616. 

  616. <span class="w">                                         </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">dwFrameInterval</span><span class="p">,</span>
    617. 

  617. <span class="w">                                         </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">dwMaxVideoFrameSize</span><span class="p">,</span>
    618. 

  618. <span class="w">                                         </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">dwMaxPayloadTransferSize</span><span class="p">);</span>
    619. 

  619. </pre></div>
    620. 

  620. </div>
    621. 

  621. <ul class="simple">
    622. 

  622. <li><p><strong>class</strong> 类的句柄</p></li>
    623. 

  623. <li><p><strong>intf</strong>  接口句柄</p></li>
    624. 

  624. </ul>
    625. 

  625. </section>
    626. 

  626. <section id="usbd-video-open">
    627. 

  627. <h3>usbd_video_open<a class="headerlink" href="#usbd-video-open" title="Link to this heading"></a></h3>
    628. 

  628. <p><code class="docutils literal notranslate"><span class="pre">usbd_video_open</span></code>  用来开启视频数据传输。</p>
    629. 

  629. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_video_open</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">);</span>
    630. 

  630. </pre></div>
    631. 

  631. </div>
    632. 

  632. <ul class="simple">
    633. 

  633. <li><p><strong>intf</strong> 开启的接口号</p></li>
    634. 

  634. </ul>
    635. 

  635. </section>
    636. 

  636. <section id="usbd-video-close">
    637. 

  637. <h3>usbd_video_close<a class="headerlink" href="#usbd-video-close" title="Link to this heading"></a></h3>
    638. 

  638. <p><code class="docutils literal notranslate"><span class="pre">usbd_video_close</span></code>  用来关闭视频数据传输。</p>
    639. 

  639. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">usbd_video_open</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">intf</span><span class="p">);</span>
    640. 

  640. </pre></div>
    641. 

  641. </div>
    642. 

  642. <ul class="simple">
    643. 

  643. <li><p><strong>intf</strong> 关闭的接口号</p></li>
    644. 

  644. </ul>
    645. 

  645. </section>
    646. 

  646. <section id="usbd-video-payload-fill">
    647. 

  647. <h3>usbd_video_payload_fill<a class="headerlink" href="#usbd-video-payload-fill" title="Link to this heading"></a></h3>
    648. 

  648. <p><code class="docutils literal notranslate"><span class="pre">usbd_video_payload_fill</span></code>  用来填充 mjpeg 到新的 buffer中，其中会对 mjpeg 数据按帧进行切分，切分大小由 <code class="docutils literal notranslate"><span class="pre">dwMaxPayloadTransferSize</span></code> 控制，并添加头部信息，当前头部字节数为 2。头部信息见 <code class="docutils literal notranslate"><span class="pre">struct</span> <span class="pre">video_mjpeg_payload_header</span></code></p>
    649. 

  649. <div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">uint32_t</span><span class="w"> </span><span class="nf">usbd_video_payload_fill</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">input</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="n">input_len</span><span class="p">,</span><span class="w"> </span><span class="kt">uint8_t</span><span class="w"> </span><span class="o">*</span><span class="n">output</span><span class="p">,</span><span class="w"> </span><span class="kt">uint32_t</span><span class="w"> </span><span class="o">*</span><span class="n">out_len</span><span class="p">);</span>
    650. 

  650. </pre></div>
    651. 

  651. </div>
    652. 

  652. <ul class="simple">
    653. 

  653. <li><p><strong>input</strong> mjpeg 格式的数据包，从 FFD8~FFD9结束</p></li>
    654. 

  654. <li><p><strong>input_len</strong> mjpeg数据包大小</p></li>
    655. 

  655. <li><p><strong>output</strong> 输出缓冲区</p></li>
    656. 

  656. <li><p><strong>out_len</strong> 输出实际要发送的长度大小</p></li>
    657. 

  657. <li><p><strong>return</strong> 返回 usb 按照 <code class="docutils literal notranslate"><span class="pre">dwMaxPayloadTransferSize</span></code> 大小要发多少帧</p></li>
    658. 

  658. </ul>
    659. 

  659. </section>
    660. 

  660. </section>
    661. 

  661. <section id="dfu">
    662. 

  662. <h2>DFU<a class="headerlink" href="#dfu" title="Link to this heading"></a></h2>
    663. 

  663. </section>
    664. 

  664. <section id="printer">
    665. 

  665. <h2>PRINTER<a class="headerlink" href="#printer" title="Link to this heading"></a></h2>
    666. 

  666. </section>
    667. 

  667. <section id="mtp">
    668. 

  668. <h2>MTP<a class="headerlink" href="#mtp" title="Link to this heading"></a></h2>
    669. 

  669. </section>
    670. 

  670. </section>
    671. 

  671. 

  672. 

  673.            </div>
    674. 

  674.           </div>
    675. 

  675.           <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
    676. 

  676.         <a href="../usb/usb_ext.html" class="btn btn-neutral float-left" title="USB 知识点拓展" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
    677. 

  677.         <a href="api_host.html" class="btn btn-neutral float-right" title="主机协议栈" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    678. 

  678.     </div>
    679. 

  679. 

  680.   <hr/>
    681. 

  681. 

  682.   <div role="contentinfo">
    683. 

  683.     <p>&#169; Copyright 2022 ~ 2025, sakumisu.</p>
    684. 

  684.   </div>
    685. 

  685. 

  686.   Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
    687. 

  687.     <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
    688. 

  688.     provided by <a href="https://readthedocs.org">Read the Docs</a>.
    689. 

  689.    
    690. 

  690. 

  691. </footer>
    692. 

  692.         </div>
    693. 

  693.       </div>
    694. 

  694.     </section>
    695. 

  695.   </div>
    696. 

  696.   <script>
    697. 

  697.       jQuery(function () {
    698. 

  698.           SphinxRtdTheme.Navigation.enable(true);
    699. 

  699.       });
    700. 

  700.   </script> 
    701. 

  701. 

  702. </body>
    703. 

  703. </html>
    704.