Deploying to gh-pages from @ cherry-embedded/CherryUSB@8712e2c03c 🚀
This commit is contained in:
sakumisu
@@ -1,17 +1,21 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html class="writer-html5" lang="en">
|
||||
<html class="writer-html5" lang="en" data-content_root="../">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>基于现有 demo 快速验证 — CherryUSB 1.4.0 documentation</title>
|
||||
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
|
||||
<link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" />
|
||||
|
||||
|
||||
<script src="../_static/jquery.js"></script>
|
||||
<script src="../_static/underscore.js"></script>
|
||||
<script src="../_static/doctools.js"></script>
|
||||
<script src="../_static/language_data.js"></script>
|
||||
<script src="../_static/jquery.js?v=5d32c60e"></script>
|
||||
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
||||
<script src="../_static/documentation_options.js?v=9172181d"></script>
|
||||
<script src="../_static/doctools.js?v=9a2dae69"></script>
|
||||
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
|
||||
<script src="../_static/js/theme.js"></script>
|
||||
<link rel="index" title="Index" href="../genindex.html" />
|
||||
<link rel="search" title="Search" href="../search.html" />
|
||||
@@ -38,7 +42,7 @@
|
||||
</form>
|
||||
</div>
|
||||
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
||||
<p class="caption"><span class="caption-text">快速上手</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
|
||||
<ul class="current">
|
||||
<li class="toctree-l1"><a class="reference internal" href="start.html">入门必看</a></li>
|
||||
<li class="toctree-l1 current"><a class="current reference internal" href="#">基于现有 demo 快速验证</a><ul>
|
||||
@@ -56,9 +60,9 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="transplant.html">芯片通用移植指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="rtthread.html">基于 RT-Thread 软件包开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="esp.html">基于 ESP-Registry 开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q&a.html">Q & A</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q%26a.html">Q & A</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb2.0_basic.html">USB 基本概念(2.0 为主)</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb3.0_basic.html">USB 基本概念(3.0 为主)</a></li>
|
||||
@@ -67,14 +71,14 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_enum.html">USB 枚举</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_ext.html">USB 知识点拓展</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">API 手册</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_device.html">设备协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_host.html">主机协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_port.html">主从驱动</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_config.html">USB CONFIG 说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Class 指南</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">Class 指南</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_cdc.html">CDC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_hid.html">HID</a></li>
|
||||
@@ -83,7 +87,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_video.html">UVC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/winusb.html">WINUSB</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">例程说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">例程说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_cdc_acm.html">usbd_cdc_acm</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_hid.html">usbd_hid</a></li>
|
||||
@@ -102,7 +106,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_bluetooth.html">usbh_bluetooth</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_wifi.html">usbh_wifi</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ohci.html">OHCI</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ehci.html">EHCI</a></li>
|
||||
@@ -115,18 +119,18 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/cdns3.html">CDNS3</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/dwc3.html">DWC3</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">工具使用</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">工具使用</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">chryusb_configurator</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#usb-protocol-suite">力科 USB Protocol Suite</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#wireshark">Wireshark</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#audacity">Audacity</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">版本说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">版本说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../version.html">版本说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">商业支持</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">商业支持</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../support/index.html">商业支持</a></li>
|
||||
</ul>
|
||||
@@ -155,44 +159,44 @@
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="demo">
|
||||
<h1>基于现有 demo 快速验证<a class="headerlink" href="#demo" title="Permalink to this headline">¶</a></h1>
|
||||
<section id="demo">
|
||||
<h1>基于现有 demo 快速验证<a class="headerlink" href="#demo" title="Link to this heading"></a></h1>
|
||||
<p>在学习 USB 或者是学习 CherryUSB 代码之前，我们需要先基于现有的 demo 进行快速验证，为什么？是为了提升对 USB 的兴趣，能有信心进行下一步的动作，如果 demo 都跑不起来，或者自己摸索写代码，或者先看 USB 基本概念，结果看到最后，
|
||||
发现一点都看不懂，概念好多，根本记不住，从而丧失对 USB 的兴趣。因此，先跑 demo 非常重要。下面我将给大家罗列目前支持的 demo 仓库。</p>
|
||||
<div class="section" id="bouffalolab">
|
||||
<h2>基于 bouffalolab 系列芯片<a class="headerlink" href="#bouffalolab" title="Permalink to this headline">¶</a></h2>
|
||||
<section id="bouffalolab">
|
||||
<h2>基于 bouffalolab 系列芯片<a class="headerlink" href="#bouffalolab" title="Link to this heading"></a></h2>
|
||||
<p>仓库参考：<a class="reference external" href="https://github.com/CherryUSB/cherryusb_bouffalolab">https://github.com/CherryUSB/cherryusb_bouffalolab</a></p>
|
||||
<ul class="simple">
|
||||
<li><p>BL616/BL808 是一个 USB2.0 并且内置高速 PHY 芯片，共 5个端点（包含端点0）。支持主从机。</p></li>
|
||||
<li><p>USB 的相关应用位于 <cite>examples/usbdev</cite> 和 <cite>examples/usbhost</cite> 目录下，根据官方环境搭建完成后，即可编译使用。</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="hpmicro">
|
||||
<h2>基于 HPMicro 系列芯片<a class="headerlink" href="#hpmicro" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="hpmicro">
|
||||
<h2>基于 HPMicro 系列芯片<a class="headerlink" href="#hpmicro" title="Link to this heading"></a></h2>
|
||||
<p>仓库参考：<a class="reference external" href="https://github.com/CherryUSB/cherryusb_hpmicro">https://github.com/CherryUSB/cherryusb_hpmicro</a></p>
|
||||
<ul class="simple">
|
||||
<li><p>HPM 系列芯片均 USB 2.0 并且内置高速 PHY，支持主从机，端点共 8/16 个，并且可以同时使用双向，不同芯片个数有差异</p></li>
|
||||
<li><p>USB 的相关应用位于 <cite>samples/cherryusb</cite> ，根据官方环境搭建完成后，即可编译使用。</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="esp32s2-s3-p4">
|
||||
<h2>基于 esp32s2/s3/p4 系列芯片<a class="headerlink" href="#esp32s2-s3-p4" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="esp32s2-s3-p4">
|
||||
<h2>基于 esp32s2/s3/p4 系列芯片<a class="headerlink" href="#esp32s2-s3-p4" title="Link to this heading"></a></h2>
|
||||
<p>仓库参考：<a class="reference external" href="https://github.com/CherryUSB/cherryusb_esp32">https://github.com/CherryUSB/cherryusb_esp32</a></p>
|
||||
<ul class="simple">
|
||||
<li><p>esp32s2/s3 支持全速主从机，esp32p4 支持高速主从机</p></li>
|
||||
<li><p>默认提供主机 demo，并且使用 esp 组件库进行开发， 在 <a class="reference external" href="https://components.espressif.com/">https://components.espressif.com/</a> 中搜索 cherryusb 即可</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="id1">
|
||||
<h2>基于飞腾派系列芯片<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id1">
|
||||
<h2>基于飞腾派系列芯片<a class="headerlink" href="#id1" title="Link to this heading"></a></h2>
|
||||
<p>仓库参考：<a class="reference external" href="https://gitee.com/phytium_embedded/phytium-free-rtos-sdk">https://gitee.com/phytium_embedded/phytium-free-rtos-sdk</a></p>
|
||||
<ul class="simple">
|
||||
<li><p>飞腾派支持两个 USB3.0 主机， 两个 USB2.0 主从机</p></li>
|
||||
<li><p>USB 的相关应用位于 <cite>example/peripheral/usb</cite> ，根据官方环境搭建完成后，即可编译使用。</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="st">
|
||||
<h2>基于 ST 系列芯片<a class="headerlink" href="#st" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="st">
|
||||
<h2>基于 ST 系列芯片<a class="headerlink" href="#st" title="Link to this heading"></a></h2>
|
||||
<p>仓库参考：<a class="reference external" href="https://github.com/CherryUSB/cherryusb_stm32">https://github.com/CherryUSB/cherryusb_stm32</a></p>
|
||||
<p>默认提供以下 demo 工程：</p>
|
||||
<ul class="simple">
|
||||
@@ -212,79 +216,79 @@
|
||||
<li><p>F4 无cache，H7 有 cache</p></li>
|
||||
</ul>
|
||||
<p>如果是 STM32F7/STM32H7 这种带 cache 功能，需要将 usb 使用到的 ram 定位到 no cache ram 区域。举例如下</p>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">cpu_mpu_config</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">MPU_Normal_NonCache</span><span class="p">,</span> <span class="mh">0x24070000</span><span class="p">,</span> <span class="n">MPU_REGION_SIZE_64KB</span><span class="p">);</span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">cpu_mpu_config</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="n">MPU_Normal_NonCache</span><span class="p">,</span><span class="w"> </span><span class="mh">0x24070000</span><span class="p">,</span><span class="w"> </span><span class="n">MPU_REGION_SIZE_64KB</span><span class="p">);</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>对应 keil 中的 sct 脚本修改：</p>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span>LR_IROM1 0x08000000 0x00200000 { ; load region size_region
|
||||
ER_IROM1 0x08000000 0x00200000 { ; load address = execution address
|
||||
*.o (RESET, +First)
|
||||
*(InRoot$$Sections)
|
||||
.ANY (+RO)
|
||||
.ANY (+XO)
|
||||
}
|
||||
RW_IRAM2 0x24000000 0x00070000 { ; RW data
|
||||
.ANY (+RW +ZI)
|
||||
}
|
||||
USB_NOCACHERAM 0x24070000 0x00010000 { ; RW data
|
||||
*(.noncacheable)
|
||||
}
|
||||
}
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">LR_IROM1</span><span class="w"> </span><span class="mh">0x08000000</span><span class="w"> </span><span class="mh">0x00200000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">load</span><span class="w"> </span><span class="n">region</span><span class="w"> </span><span class="n">size_region</span>
|
||||
<span class="n">ER_IROM1</span><span class="w"> </span><span class="mh">0x08000000</span><span class="w"> </span><span class="mh">0x00200000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">load</span><span class="w"> </span><span class="n">address</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">execution</span><span class="w"> </span><span class="n">address</span>
|
||||
<span class="o">*</span><span class="p">.</span><span class="n">o</span><span class="w"> </span><span class="p">(</span><span class="n">RESET</span><span class="p">,</span><span class="w"> </span><span class="o">+</span><span class="n">First</span><span class="p">)</span>
|
||||
<span class="o">*</span><span class="p">(</span><span class="n">InRoot$$Sections</span><span class="p">)</span>
|
||||
<span class="p">.</span><span class="n">ANY</span><span class="w"> </span><span class="p">(</span><span class="o">+</span><span class="n">RO</span><span class="p">)</span>
|
||||
<span class="p">.</span><span class="n">ANY</span><span class="w"> </span><span class="p">(</span><span class="o">+</span><span class="n">XO</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="n">RW_IRAM2</span><span class="w"> </span><span class="mh">0x24000000</span><span class="w"> </span><span class="mh">0x00070000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">RW</span><span class="w"> </span><span class="n">data</span>
|
||||
<span class="p">.</span><span class="n">ANY</span><span class="w"> </span><span class="p">(</span><span class="o">+</span><span class="n">RW</span><span class="w"> </span><span class="o">+</span><span class="n">ZI</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="n">USB_NOCACHERAM</span><span class="w"> </span><span class="mh">0x24070000</span><span class="w"> </span><span class="mh">0x00010000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">RW</span><span class="w"> </span><span class="n">data</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">noncacheable</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<div class="section" id="usb-device">
|
||||
<h3>USB Device 移植要点<a class="headerlink" href="#usb-device" title="Permalink to this headline">¶</a></h3>
|
||||
<section id="usb-device">
|
||||
<h3>USB Device 移植要点<a class="headerlink" href="#usb-device" title="Link to this heading"></a></h3>
|
||||
<ul class="simple">
|
||||
<li><p>使用 <strong>stm32cubemx</strong> 创建工程，配置基本的 RCC、UART (作为log使用)</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_1.png" src="../_images/stm32_1.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_2.png" src="../_images/stm32_2.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>如果使用 fsdev ip，勾选 <strong>USB</strong> 。如果使用 dwc2 ip，勾选 <strong>USB_OTG_FS</strong> 或者勾选 <strong>USB_OTG_HS</strong>。开启 USB 中断，其他配置对我们没用，代码中不会使用任何 st 的 usb 库。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_3_1.png" src="../_images/stm32_3_1.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_3.png" src="../_images/stm32_3.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>配置 usb clock 为 48M</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_4_1.png" src="../_images/stm32_4_1.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_4.png" src="../_images/stm32_4.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>选择好工程，这里我们选择 keil，设置好 stack 和 heap，如果使用 msc 可以推荐设置大点，然后点击 <strong>Generate Code</strong>。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_5.png" src="../_images/stm32_5.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>添加 CherryUSB 必须要的源码（ <strong>usbd_core.c</strong> 、 <strong>usb_dc_dwc2.c</strong> 或者是 <strong>usb_dc_fsdev.c</strong> ）,以及想要使用的 class 驱动，可以将对应的 class template 添加方便测试。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_6.png" src="../_images/stm32_6.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>头文件该加的加</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_7.png" src="../_images/stm32_7.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>复制一份 <strong>cherryusb_config_template.h</strong>，放到 <cite>Core/Inc</cite> 目录下，并命名为 <cite>usb_config.h</cite></p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_8.png" src="../_images/stm32_8.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>如果使用 dwc2 ip，需要增加 <strong>usb_glue_st.c</strong> 文件，并在 <cite>usb_config.h</cite> 中实现以下宏：</p></li>
|
||||
</ul>
|
||||
@@ -310,52 +314,52 @@ USB_NOCACHERAM 0x24070000 0x00010000 { ; RW data
|
||||
<ul class="simple">
|
||||
<li><p>编译器推荐使用 <strong>AC6</strong>。勾选 <strong>Microlib</strong>，并实现 <strong>printf</strong> ，方便后续查看 log。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_10.png" src="../_images/stm32_10.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_11.png" src="../_images/stm32_11.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>拷贝 <strong>xxx_msp.c</strong> 中的 <strong>HAL_PCD_MspInit</strong> 函数中的内容到 <strong>usb_dc_low_level_init</strong> 函数中，屏蔽 st 生成的 usb 初始化</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_12.png" src="../_images/stm32_12.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_14.png" src="../_images/stm32_14.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>在中断函数中调用 <cite>USBD_IRQHandler</cite>，并传入 <cite>busid</cite></p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_13.png" src="../_images/stm32_13.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>调用 template 的内容初始化，并填入 <cite>busid</cite> 和 USB IP 的 <cite>reg base</cite>， <cite>busid</cite> 从 0 开始，不能超过 <cite>CONFIG_USBDEV_MAX_BUS</cite></p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_15.png" src="../_images/stm32_15.png" />
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="usb-host">
|
||||
<h3>USB Host 移植要点<a class="headerlink" href="#usb-host" title="Permalink to this headline">¶</a></h3>
|
||||
</figure>
|
||||
</section>
|
||||
<section id="usb-host">
|
||||
<h3>USB Host 移植要点<a class="headerlink" href="#usb-host" title="Link to this heading"></a></h3>
|
||||
<p>前面 6 步与 Device 一样。需要注意，host 驱动只支持带 dma 的 hs port (引脚是 PB14/PB15)，所以 fs port (引脚是 PA11/PA12)不做支持（没有 dma 你玩什么主机）。</p>
|
||||
<ul class="simple">
|
||||
<li><p>添加 CherryUSB 必须要的源码（ <strong>usbh_core.c</strong> 、 <strong>usbh_hub.c</strong> 、 <strong>usb_hc_dwc2.c</strong> 、以及 <strong>osal</strong> 目录下的适配层文件）,以及想要使用的 class 驱动，并且可以将对应的 <strong>usb host.c</strong> 添加方便测试。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_16.png" src="../_images/stm32_16.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>编译器推荐使用 <strong>AC6</strong>。勾选 <strong>Microlib</strong>，并实现 <strong>printf</strong> ，方便后续查看 log。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_10.png" src="../_images/stm32_10.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_11.png" src="../_images/stm32_11.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>复制一份 <strong>cherryusb_config_template.h</strong>，放到 <cite>Core/Inc</cite> 目录下，并命名为 <cite>usb_config.h</cite></p></li>
|
||||
<li><p>增加 <strong>usb_glue_st.c</strong> 文件，并在 <cite>usb_config.h</cite> 中实现以下宏：</p></li>
|
||||
@@ -374,21 +378,21 @@ USB_NOCACHERAM 0x24070000 0x00010000 { ; RW data
|
||||
<li><p>调用 <cite>usbh_initialize</cite> 并填入 <cite>busid</cite> 和 USB IP 的 <cite>reg base</cite>， <cite>busid</cite> 从 0 开始，不能超过 <cite>CONFIG_USBHOST_MAX_BUS</cite></p></li>
|
||||
<li><p>启动线程</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_18.png" src="../_images/stm32_18.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_19.png" src="../_images/stm32_19.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>如果使用 <strong>msc</strong>，并且带文件系统，需要自行添加文件系统文件了，对应的 porting 编写参考 <strong>fatfs_usbh.c</strong> 文件。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_21.png" src="../_images/stm32_21.png" />
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</figure>
|
||||
</section>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
@@ -1,21 +1,25 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html class="writer-html5" lang="en">
|
||||
<html class="writer-html5" lang="en" data-content_root="../">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>基于 ESP-Registry 开发指南 — CherryUSB 1.4.0 documentation</title>
|
||||
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
|
||||
<link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" />
|
||||
|
||||
|
||||
<script src="../_static/jquery.js"></script>
|
||||
<script src="../_static/underscore.js"></script>
|
||||
<script src="../_static/doctools.js"></script>
|
||||
<script src="../_static/language_data.js"></script>
|
||||
<script src="../_static/jquery.js?v=5d32c60e"></script>
|
||||
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
||||
<script src="../_static/documentation_options.js?v=9172181d"></script>
|
||||
<script src="../_static/doctools.js?v=9a2dae69"></script>
|
||||
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
|
||||
<script src="../_static/js/theme.js"></script>
|
||||
<link rel="index" title="Index" href="../genindex.html" />
|
||||
<link rel="search" title="Search" href="../search.html" />
|
||||
<link rel="next" title="Q & A" href="../q&a.html" />
|
||||
<link rel="next" title="Q & A" href="../q%26a.html" />
|
||||
<link rel="prev" title="基于 RT-Thread 软件包开发指南" href="rtthread.html" />
|
||||
</head>
|
||||
|
||||
@@ -38,16 +42,16 @@
|
||||
</form>
|
||||
</div>
|
||||
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
||||
<p class="caption"><span class="caption-text">快速上手</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
|
||||
<ul class="current">
|
||||
<li class="toctree-l1"><a class="reference internal" href="start.html">入门必看</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="demo.html">基于现有 demo 快速验证</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="transplant.html">芯片通用移植指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="rtthread.html">基于 RT-Thread 软件包开发指南</a></li>
|
||||
<li class="toctree-l1 current"><a class="current reference internal" href="#">基于 ESP-Registry 开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q&a.html">Q & A</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q%26a.html">Q & A</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb2.0_basic.html">USB 基本概念(2.0 为主)</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb3.0_basic.html">USB 基本概念(3.0 为主)</a></li>
|
||||
@@ -56,14 +60,14 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_enum.html">USB 枚举</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_ext.html">USB 知识点拓展</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">API 手册</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_device.html">设备协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_host.html">主机协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_port.html">主从驱动</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_config.html">USB CONFIG 说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Class 指南</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">Class 指南</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_cdc.html">CDC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_hid.html">HID</a></li>
|
||||
@@ -72,7 +76,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_video.html">UVC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/winusb.html">WINUSB</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">例程说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">例程说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_cdc_acm.html">usbd_cdc_acm</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_hid.html">usbd_hid</a></li>
|
||||
@@ -91,7 +95,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_bluetooth.html">usbh_bluetooth</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_wifi.html">usbh_wifi</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ohci.html">OHCI</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ehci.html">EHCI</a></li>
|
||||
@@ -104,18 +108,18 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/cdns3.html">CDNS3</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/dwc3.html">DWC3</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">工具使用</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">工具使用</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">chryusb_configurator</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#usb-protocol-suite">力科 USB Protocol Suite</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#wireshark">Wireshark</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#audacity">Audacity</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">版本说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">版本说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../version.html">版本说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">商业支持</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">商业支持</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../support/index.html">商业支持</a></li>
|
||||
</ul>
|
||||
@@ -144,38 +148,38 @@
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="esp-registry">
|
||||
<h1>基于 ESP-Registry 开发指南<a class="headerlink" href="#esp-registry" title="Permalink to this headline">¶</a></h1>
|
||||
<section id="esp-registry">
|
||||
<h1>基于 ESP-Registry 开发指南<a class="headerlink" href="#esp-registry" title="Link to this heading"></a></h1>
|
||||
<p>ESP-Registry 可以参考官方文档，推荐使用 vscode + esp-idf 的开发环境。</p>
|
||||
<ul class="simple">
|
||||
<li><p>ctrl + shift + p 选择 ESP-IDF 欢迎界面，然后选择 Component mananger</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/esp1.png" src="../_images/esp1.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>找到 cherryusb 并安装</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/esp2.png" src="../_images/esp2.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>打开 menuconfig，并打开 cherryusb 的配置，根据实际情况选择主机或者从机模式</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/esp3.png" src="../_images/esp3.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/esp4.png" src="../_images/esp4.png" />
|
||||
</div>
|
||||
</div>
|
||||
</figure>
|
||||
</section>
|
||||
|
||||
|
||||
</div>
|
||||
</div>
|
||||
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
|
||||
<a href="rtthread.html" class="btn btn-neutral float-left" title="基于 RT-Thread 软件包开发指南" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
|
||||
<a href="../q&a.html" class="btn btn-neutral float-right" title="Q & A" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
||||
<a href="../q%26a.html" class="btn btn-neutral float-right" title="Q & A" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
|
||||
</div>
|
||||
|
||||
<hr/>
|
||||
|
||||
@@ -1,17 +1,21 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html class="writer-html5" lang="en">
|
||||
<html class="writer-html5" lang="en" data-content_root="../">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>基于 RT-Thread 软件包开发指南 — CherryUSB 1.4.0 documentation</title>
|
||||
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
|
||||
<link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" />
|
||||
|
||||
|
||||
<script src="../_static/jquery.js"></script>
|
||||
<script src="../_static/underscore.js"></script>
|
||||
<script src="../_static/doctools.js"></script>
|
||||
<script src="../_static/language_data.js"></script>
|
||||
<script src="../_static/jquery.js?v=5d32c60e"></script>
|
||||
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
||||
<script src="../_static/documentation_options.js?v=9172181d"></script>
|
||||
<script src="../_static/doctools.js?v=9a2dae69"></script>
|
||||
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
|
||||
<script src="../_static/js/theme.js"></script>
|
||||
<link rel="index" title="Index" href="../genindex.html" />
|
||||
<link rel="search" title="Search" href="../search.html" />
|
||||
@@ -38,7 +42,7 @@
|
||||
</form>
|
||||
</div>
|
||||
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
||||
<p class="caption"><span class="caption-text">快速上手</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
|
||||
<ul class="current">
|
||||
<li class="toctree-l1"><a class="reference internal" href="start.html">入门必看</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="demo.html">基于现有 demo 快速验证</a></li>
|
||||
@@ -50,9 +54,9 @@
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="esp.html">基于 ESP-Registry 开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q&a.html">Q & A</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q%26a.html">Q & A</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb2.0_basic.html">USB 基本概念(2.0 为主)</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb3.0_basic.html">USB 基本概念(3.0 为主)</a></li>
|
||||
@@ -61,14 +65,14 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_enum.html">USB 枚举</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_ext.html">USB 知识点拓展</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">API 手册</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_device.html">设备协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_host.html">主机协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_port.html">主从驱动</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_config.html">USB CONFIG 说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Class 指南</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">Class 指南</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_cdc.html">CDC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_hid.html">HID</a></li>
|
||||
@@ -77,7 +81,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_video.html">UVC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/winusb.html">WINUSB</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">例程说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">例程说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_cdc_acm.html">usbd_cdc_acm</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_hid.html">usbd_hid</a></li>
|
||||
@@ -96,7 +100,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_bluetooth.html">usbh_bluetooth</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_wifi.html">usbh_wifi</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ohci.html">OHCI</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ehci.html">EHCI</a></li>
|
||||
@@ -109,18 +113,18 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/cdns3.html">CDNS3</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/dwc3.html">DWC3</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">工具使用</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">工具使用</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">chryusb_configurator</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#usb-protocol-suite">力科 USB Protocol Suite</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#wireshark">Wireshark</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#audacity">Audacity</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">版本说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">版本说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../version.html">版本说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">商业支持</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">商业支持</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../support/index.html">商业支持</a></li>
|
||||
</ul>
|
||||
@@ -149,18 +153,18 @@
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="rt-thread">
|
||||
<h1>基于 RT-Thread 软件包开发指南<a class="headerlink" href="#rt-thread" title="Permalink to this headline">¶</a></h1>
|
||||
<section id="rt-thread">
|
||||
<h1>基于 RT-Thread 软件包开发指南<a class="headerlink" href="#rt-thread" title="Link to this heading"></a></h1>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>CherryUSB 已经加入 RT-Thread 主线，可以选择使用主线版本，配置方式相同。</p>
|
||||
</div>
|
||||
<p>本节主要介绍使用 RT-Thread 提供的软件包管理器来配置工程，以 env 作为演示。本节操作不同芯片都一样，后续不再重复讲解。打开 env 以后使用 menuconfig 进入包管理器，并在如图所示路径中选择 CherryUSB。</p>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/env0.png" src="../_images/env0.png" />
|
||||
</div>
|
||||
<div class="section" id="id1">
|
||||
<h2>从机配置<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h2>
|
||||
</figure>
|
||||
<section id="id1">
|
||||
<h2>从机配置<a class="headerlink" href="#id1" title="Link to this heading"></a></h2>
|
||||
<ul class="simple">
|
||||
<li><p>选择 Enable usb device mode 并敲回车进入。</p></li>
|
||||
<li><p>首先第一个配置是配置 USB 的速度，分为 <strong>FS、HS</strong>，表示使用全速还是高速功能。高速功能要求内置高速 PHY 或者外接 PHY</p></li>
|
||||
@@ -168,14 +172,14 @@
|
||||
<li><p>选择你想使用的 class</p></li>
|
||||
<li><p>选择是否使用 demo 模板</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/env1.png" src="../_images/env1.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>最后退出保存即可。</p></li>
|
||||
<li><p>拷贝 <cite>cherryusb_config_template.h</cite> 文件到自己工程目录下，命名为 <cite>usb_config.h</cite>，并添加相应的目录头文件路径,并修改以下内容：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"rtthread.h"</span><span class="cp"></span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">"rtthread.h"</span>
|
||||
|
||||
<span class="cp">#define CONFIG_USB_PRINTF(...) rt_kprintf(__VA_ARGS__)</span>
|
||||
</pre></div>
|
||||
@@ -186,16 +190,16 @@
|
||||
<li><p>调用 <cite>usbd_initialize</cite> 并填入 <cite>busid</cite> 和 USB IP 的 <cite>reg base</cite>， <cite>busid</cite> 从 0 开始，不能超过 <cite>CONFIG_USBDEV_MAX_BUS</cite></p></li>
|
||||
<li><p>以上内容我们推荐放在 <strong>board.c</strong> 中，如下代码：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span> <span class="nf">OTG_HS_IRQHandler</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">OTG_HS_IRQHandler</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="k">extern</span> <span class="kt">void</span> <span class="n">USBD_IRQHandler</span><span class="p">(</span><span class="kt">uint8_t</span> <span class="n">busid</span><span class="p">);</span>
|
||||
<span class="k">extern</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">USBD_IRQHandler</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">busid</span><span class="p">);</span>
|
||||
<span class="n">USBD_IRQHandler</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="kt">int</span> <span class="nf">usbd_init</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="kt">int</span><span class="w"> </span><span class="nf">usbd_init</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">xxx_template_init</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">USB_OTG_HS_PERIPH_BASE</span><span class="p">);</span>
|
||||
<span class="k">return</span> <span class="mi">0</span><span class="p">;</span>
|
||||
<span class="n">xxx_template_init</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="n">USB_OTG_HS_PERIPH_BASE</span><span class="p">);</span>
|
||||
<span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="n">INIT_APP_EXPORT</span><span class="p">(</span><span class="n">usbd_init</span><span class="p">);</span>
|
||||
@@ -204,23 +208,23 @@
|
||||
<ul class="simple">
|
||||
<li><p>使用 <cite>scons –target=mdk5</cite> 或者 <cite>scons</cite> 进行编译，如果是mdk，需要使用 AC6 编译器</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="id2">
|
||||
<h2>主机配置<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id2">
|
||||
<h2>主机配置<a class="headerlink" href="#id2" title="Link to this heading"></a></h2>
|
||||
<ul class="simple">
|
||||
<li><p>选择 Enable usb host mode 并敲回车进入。</p></li>
|
||||
<li><p>选择 USB host ip，不清楚自己芯片是哪个 ip 的可以参考 <strong>port</strong> 目录下对应的 readme。</p></li>
|
||||
<li><p>根据需要勾选 class 驱动</p></li>
|
||||
<li><p>选择是否开启模板 demo，请注意， msc 禁止使能，因为默认对接到 dfs。</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/env2.png" src="../_images/env2.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>最后退出保存即可。</p></li>
|
||||
<li><p>拷贝 <cite>cherryusb_config_template.h</cite> 文件到自己工程目录下，命名为 <cite>usb_config.h</cite>，并添加相应的目录头文件路径,并实现以下内容：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">"rtthread.h"</span><span class="cp"></span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">"rtthread.h"</span>
|
||||
|
||||
<span class="cp">#define CONFIG_USB_PRINTF(...) rt_kprintf(__VA_ARGS__)</span>
|
||||
</pre></div>
|
||||
@@ -231,16 +235,16 @@
|
||||
<li><p>调用 <cite>usbh_initialize</cite> 并填入 <cite>busid</cite> 和 USB IP 的 <cite>reg base</cite>， <cite>busid</cite> 从 0 开始，不能超过 <cite>CONFIG_USBHOST_MAX_BUS</cite></p></li>
|
||||
<li><p>以上内容我们推荐放在 <strong>board.c</strong> 中，如下代码：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span> <span class="nf">OTG_HS_IRQHandler</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="kt">void</span><span class="w"> </span><span class="nf">OTG_HS_IRQHandler</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="k">extern</span> <span class="kt">void</span> <span class="n">USBH_IRQHandler</span><span class="p">(</span><span class="kt">uint8_t</span> <span class="n">busid</span><span class="p">);</span>
|
||||
<span class="k">extern</span><span class="w"> </span><span class="kt">void</span><span class="w"> </span><span class="n">USBH_IRQHandler</span><span class="p">(</span><span class="kt">uint8_t</span><span class="w"> </span><span class="n">busid</span><span class="p">);</span>
|
||||
<span class="n">USBH_IRQHandler</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="kt">int</span> <span class="nf">usbh_init</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="kt">int</span><span class="w"> </span><span class="nf">usbh_init</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">usbh_initialize</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">USB_OTG_HS_PERIPH_BASE</span><span class="p">);</span>
|
||||
<span class="k">return</span> <span class="mi">0</span><span class="p">;</span>
|
||||
<span class="n">usbh_initialize</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="w"> </span><span class="n">USB_OTG_HS_PERIPH_BASE</span><span class="p">);</span>
|
||||
<span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="n">INIT_APP_EXPORT</span><span class="p">(</span><span class="n">usbh_init</span><span class="p">);</span>
|
||||
@@ -251,42 +255,42 @@
|
||||
<li><p>如果使用的是 GCC ，需要在链接脚本(ld)中添加如下代码：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cm">/* section information for usbh class */</span>
|
||||
<span class="p">.</span> <span class="o">=</span> <span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">__usbh_class_info_start__</span> <span class="o">=</span> <span class="p">.;</span>
|
||||
<span class="p">.</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">__usbh_class_info_start__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span>
|
||||
<span class="n">KEEP</span><span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">usbh_class_info</span><span class="p">))</span>
|
||||
<span class="n">__usbh_class_info_end__</span> <span class="o">=</span> <span class="p">.;</span>
|
||||
<span class="n">__usbh_class_info_end__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="stm32cubemx-usb">
|
||||
<h2>借助 STM32CubeMX 生成 USB 初始化<a class="headerlink" href="#stm32cubemx-usb" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="stm32cubemx-usb">
|
||||
<h2>借助 STM32CubeMX 生成 USB 初始化<a class="headerlink" href="#stm32cubemx-usb" title="Link to this heading"></a></h2>
|
||||
<p>使用 STM32CubeMX 主要是用来生成 usb 时钟、引脚、中断的配置。我们需要点击如图所示文件，并配置好 USB 的时钟、中断，点击 <cite>Generate Code</cite>。</p>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32cubemx0.png" src="../_images/stm32cubemx0.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32cubemx1.png" src="../_images/stm32cubemx1.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32cubemx2.png" src="../_images/stm32cubemx2.png" />
|
||||
</div>
|
||||
<div class="figure align-default">
|
||||
</figure>
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32cubemx_clk.png" src="../_images/stm32cubemx_clk.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>将 <cite>main.c</cite> 中的 <cite>SystemClock_Config</cite> 替换掉 <cite>board.c</cite> 中的配置</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_init2.png" src="../_images/stm32_init2.png" />
|
||||
</div>
|
||||
</figure>
|
||||
<ul class="simple">
|
||||
<li><p>将 <cite>stm32xxxx_hal_msp.c</cite> 中的 <cite>HAL_PCD_MspInit</cite> 或者是 <cite>HAL_HCD_MspInit</cite> 中的内容复制到 <cite>usb_dc_low_level_init</cite> 和 <cite>usb_hc_low_level_init</cite> 函数中，举例如下：</p></li>
|
||||
</ul>
|
||||
<div class="figure align-default">
|
||||
<figure class="align-default">
|
||||
<img alt="../_images/stm32_init.png" src="../_images/stm32_init.png" />
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</figure>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
@@ -1,17 +1,21 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html class="writer-html5" lang="en">
|
||||
<html class="writer-html5" lang="en" data-content_root="../">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>入门必看 — CherryUSB 1.4.0 documentation</title>
|
||||
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
|
||||
<link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" />
|
||||
|
||||
|
||||
<script src="../_static/jquery.js"></script>
|
||||
<script src="../_static/underscore.js"></script>
|
||||
<script src="../_static/doctools.js"></script>
|
||||
<script src="../_static/language_data.js"></script>
|
||||
<script src="../_static/jquery.js?v=5d32c60e"></script>
|
||||
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
||||
<script src="../_static/documentation_options.js?v=9172181d"></script>
|
||||
<script src="../_static/doctools.js?v=9a2dae69"></script>
|
||||
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
|
||||
<script src="../_static/js/theme.js"></script>
|
||||
<link rel="index" title="Index" href="../genindex.html" />
|
||||
<link rel="search" title="Search" href="../search.html" />
|
||||
@@ -38,27 +42,27 @@
|
||||
</form>
|
||||
</div>
|
||||
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
||||
<p class="caption"><span class="caption-text">快速上手</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
|
||||
<ul class="current">
|
||||
<li class="toctree-l1 current"><a class="current reference internal" href="#">入门必看</a><ul>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id2">第一步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id3">第二步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id4">第三步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id7">第四步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id8">第五步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id9">第六步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id10">第七步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id11">第八步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id12">第九步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id5">第四步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id6">第五步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id7">第六步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id8">第七步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id9">第八步</a></li>
|
||||
<li class="toctree-l2"><a class="reference internal" href="#id10">第九步</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="demo.html">基于现有 demo 快速验证</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="transplant.html">芯片通用移植指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="rtthread.html">基于 RT-Thread 软件包开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="esp.html">基于 ESP-Registry 开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q&a.html">Q & A</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q%26a.html">Q & A</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb2.0_basic.html">USB 基本概念(2.0 为主)</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb3.0_basic.html">USB 基本概念(3.0 为主)</a></li>
|
||||
@@ -67,14 +71,14 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_enum.html">USB 枚举</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_ext.html">USB 知识点拓展</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">API 手册</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_device.html">设备协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_host.html">主机协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_port.html">主从驱动</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_config.html">USB CONFIG 说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Class 指南</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">Class 指南</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_cdc.html">CDC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_hid.html">HID</a></li>
|
||||
@@ -83,7 +87,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_video.html">UVC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/winusb.html">WINUSB</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">例程说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">例程说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_cdc_acm.html">usbd_cdc_acm</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_hid.html">usbd_hid</a></li>
|
||||
@@ -102,7 +106,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_bluetooth.html">usbh_bluetooth</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_wifi.html">usbh_wifi</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ohci.html">OHCI</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ehci.html">EHCI</a></li>
|
||||
@@ -115,18 +119,18 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/cdns3.html">CDNS3</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/dwc3.html">DWC3</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">工具使用</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">工具使用</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">chryusb_configurator</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#usb-protocol-suite">力科 USB Protocol Suite</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#wireshark">Wireshark</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#audacity">Audacity</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">版本说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">版本说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../version.html">版本说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">商业支持</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">商业支持</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../support/index.html">商业支持</a></li>
|
||||
</ul>
|
||||
@@ -155,48 +159,48 @@
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="id1">
|
||||
<h1>入门必看<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
|
||||
<section id="id1">
|
||||
<h1>入门必看<a class="headerlink" href="#id1" title="Link to this heading"></a></h1>
|
||||
<p>首先欢迎大家来到 usb 的世界，在这里你可以学习到 usb 各种知识以及 cherryusb 的移植使用进阶等等。但是呢，刚进来的你，一定很懵懂，因为 USB 很难（其实当你学会了 cherryusb以后，你会发现，USB 一点都不难），
|
||||
那么这种情况下，你的学习路线，应该是怎么样呢？在这里，我推荐大家是按照我得学习路线来学习，这样对你的 USB 成长是最有帮助的，并且你也不会中途放弃。</p>
|
||||
<p>首先，不允许上来就看概念，有句古诗说的好， <strong>纸上得来终觉浅，绝知此事要躬行</strong> ，光看纸面上的东西，你是学不到什么的，只有当自己实践了，你才能更深入的了解这些概念。那么作为初学者，你应该怎么做呢？请看以下步骤。</p>
|
||||
<div class="section" id="id2">
|
||||
<h2>第一步<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
|
||||
<section id="id2">
|
||||
<h2>第一步<a class="headerlink" href="#id2" title="Link to this heading"></a></h2>
|
||||
<p>你需要学过 C 语言，UART, DMA，这是基础，如果没学过，请去学习，不然你会很吃力。你会问 USB 跟 UART/DMA 有什么关系？ 我只能说两个字， <strong>等价</strong></p>
|
||||
</div>
|
||||
<div class="section" id="id3">
|
||||
<h2>第二步<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id3">
|
||||
<h2>第二步<a class="headerlink" href="#id3" title="Link to this heading"></a></h2>
|
||||
<p>下载 demo 工程并跑通能运行， <strong>建议学习慢的，使用 demo 同型号芯片</strong>，学习快的，可以选择自己移植相关支持的型号的芯片。你连 demo 都跑不通，你学什么 USB，你说对不对？</p>
|
||||
</div>
|
||||
<div class="section" id="id4">
|
||||
<h2>第三步<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h2>
|
||||
<p>非常好，到这步，说明你已经能熟练移植和跑通所有示例了，那么接下来，你应该学习什么呢？ <strong>事务</strong>， <strong>请求</strong> 和 <a href="#id5"><span class="problematic" id="id6">**</span></a>描述符**（在 USB 的学习过程中，你只需要知道这三个，其余都不需要知道）。</p>
|
||||
</div>
|
||||
<div class="section" id="id7">
|
||||
<h2>第四步<a class="headerlink" href="#id7" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id4">
|
||||
<h2>第三步<a class="headerlink" href="#id4" title="Link to this heading"></a></h2>
|
||||
<p>非常好，到这步，说明你已经能熟练移植和跑通所有示例了，那么接下来，你应该学习什么呢？ <strong>事务</strong>， <strong>请求</strong> 和 <strong>描述符</strong> （在 USB 的学习过程中，你只需要知道这三个，其余都不需要知道）。</p>
|
||||
</section>
|
||||
<section id="id5">
|
||||
<h2>第四步<a class="headerlink" href="#id5" title="Link to this heading"></a></h2>
|
||||
<p>首先我们需要知道 USB 事务包含 SETUP/IN/OUT，其实就是等价于发送命令，发送数据和接收数据，很简单。至于下面枚举中你在外面的网络中所听到的控制阶段，数据阶段，状态阶段，他不是事务，他只是用多个事务代表了一个阶段而已。</p>
|
||||
</div>
|
||||
<div class="section" id="id8">
|
||||
<h2>第五步<a class="headerlink" href="#id8" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id6">
|
||||
<h2>第五步<a class="headerlink" href="#id6" title="Link to this heading"></a></h2>
|
||||
<p>然后你再去看 <strong>USB 枚举</strong> 章节并且知道了一个概念： <strong>描述符</strong> ，这个时候，你就可以去简单看看什么是描述符，有哪些描述符，然后你需要记住， <strong>设备、配置、接口、端点描述符的组成</strong>，并背下来，其余的你都不需要知道，因为其他都是固定的，后续都是 CV 。群文件有各类设备枚举的抓包，可以下下来看看。</p>
|
||||
</div>
|
||||
<div class="section" id="id9">
|
||||
<h2>第六步<a class="headerlink" href="#id9" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id7">
|
||||
<h2>第六步<a class="headerlink" href="#id7" title="Link to this heading"></a></h2>
|
||||
<p>然后呢，你可以再去看看什么是 <strong>请求</strong> ，请求结构体的组成，看看有哪些请求，简单了解即可，为什么呢？因为它不过就是 8 字节的数据格式，大家都会写一个 UART + 自定义协议，那么 USB 的请求也是一样的，只不过是规定好了而已。</p>
|
||||
</div>
|
||||
<div class="section" id="id10">
|
||||
<h2>第七步<a class="headerlink" href="#id10" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id8">
|
||||
<h2>第七步<a class="headerlink" href="#id8" title="Link to this heading"></a></h2>
|
||||
<p>这个时候，你该去熟悉下协议栈的一些 API 了，参考 <strong>API 手册</strong> 章节。并且你需要知道中断完成的条件是什么，什么时候算接收完成，什么时候算发送完成，可以参考 <strong>USB 知识点拓展</strong> 章节。</p>
|
||||
</div>
|
||||
<div class="section" id="id11">
|
||||
<h2>第八步<a class="headerlink" href="#id11" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id9">
|
||||
<h2>第八步<a class="headerlink" href="#id9" title="Link to this heading"></a></h2>
|
||||
<p>到这步呢，你肯定已经非常懂了，然后就可以开始你的一些小功能小项目了，在此期间呢，请循环查看 <strong>USB 知识点拓展</strong> 章节，直到你真的理解了，因为这些内容是非常重要的，会影响我们代码的执行结果。</p>
|
||||
</div>
|
||||
<div class="section" id="id12">
|
||||
<h2>第九步<a class="headerlink" href="#id12" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="id10">
|
||||
<h2>第九步<a class="headerlink" href="#id10" title="Link to this heading"></a></h2>
|
||||
<p>都到这步了，你应该不需要我了，这个时候，你可以去看看 USB 概念，看看 USB 的一些细节，看看 CherryUSB 的代码流程了。然后就是巩固巩固再巩固了。恭喜你，出师了！！！</p>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
@@ -1,17 +1,21 @@
|
||||
|
||||
|
||||
<!DOCTYPE html>
|
||||
<html class="writer-html5" lang="en">
|
||||
<html class="writer-html5" lang="en" data-content_root="../">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
<title>芯片通用移植指南 — CherryUSB 1.4.0 documentation</title>
|
||||
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />
|
||||
<link rel="stylesheet" type="text/css" href="../_static/css/theme.css?v=e59714d7" />
|
||||
|
||||
|
||||
<script src="../_static/jquery.js"></script>
|
||||
<script src="../_static/underscore.js"></script>
|
||||
<script src="../_static/doctools.js"></script>
|
||||
<script src="../_static/language_data.js"></script>
|
||||
<script src="../_static/jquery.js?v=5d32c60e"></script>
|
||||
<script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
|
||||
<script src="../_static/documentation_options.js?v=9172181d"></script>
|
||||
<script src="../_static/doctools.js?v=9a2dae69"></script>
|
||||
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
|
||||
<script src="../_static/js/theme.js"></script>
|
||||
<link rel="index" title="Index" href="../genindex.html" />
|
||||
<link rel="search" title="Search" href="../search.html" />
|
||||
@@ -38,7 +42,7 @@
|
||||
</form>
|
||||
</div>
|
||||
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
|
||||
<p class="caption"><span class="caption-text">快速上手</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
|
||||
<ul class="current">
|
||||
<li class="toctree-l1"><a class="reference internal" href="start.html">入门必看</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="demo.html">基于现有 demo 快速验证</a></li>
|
||||
@@ -50,9 +54,9 @@
|
||||
</li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="rtthread.html">基于 RT-Thread 软件包开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="esp.html">基于 ESP-Registry 开发指南</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q&a.html">Q & A</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../q%26a.html">Q & A</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USB 基本知识点</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb2.0_basic.html">USB 基本概念(2.0 为主)</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb3.0_basic.html">USB 基本概念(3.0 为主)</a></li>
|
||||
@@ -61,14 +65,14 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_enum.html">USB 枚举</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usb/usb_ext.html">USB 知识点拓展</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">API 手册</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">API 手册</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_device.html">设备协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_host.html">主机协议栈</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_port.html">主从驱动</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../api/api_config.html">USB CONFIG 说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">Class 指南</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">Class 指南</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_cdc.html">CDC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_hid.html">HID</a></li>
|
||||
@@ -77,7 +81,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/class_video.html">UVC</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../class/winusb.html">WINUSB</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">例程说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">例程说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_cdc_acm.html">usbd_cdc_acm</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbd_hid.html">usbd_hid</a></li>
|
||||
@@ -96,7 +100,7 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_bluetooth.html">usbh_bluetooth</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../demo/usbh_wifi.html">usbh_wifi</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">USBIP 介绍</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ohci.html">OHCI</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/ehci.html">EHCI</a></li>
|
||||
@@ -109,18 +113,18 @@
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/cdns3.html">CDNS3</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../usbip/dwc3.html">DWC3</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">工具使用</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">工具使用</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">chryusb_configurator</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#usb-protocol-suite">力科 USB Protocol Suite</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#wireshark">Wireshark</a></li>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html#audacity">Audacity</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">版本说明</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">版本说明</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../version.html">版本说明</a></li>
|
||||
</ul>
|
||||
<p class="caption"><span class="caption-text">商业支持</span></p>
|
||||
<p class="caption" role="heading"><span class="caption-text">商业支持</span></p>
|
||||
<ul>
|
||||
<li class="toctree-l1"><a class="reference internal" href="../support/index.html">商业支持</a></li>
|
||||
</ul>
|
||||
@@ -149,11 +153,11 @@
|
||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
||||
<div itemprop="articleBody">
|
||||
|
||||
<div class="section" id="id1">
|
||||
<h1>芯片通用移植指南<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
|
||||
<section id="id1">
|
||||
<h1>芯片通用移植指南<a class="headerlink" href="#id1" title="Link to this heading"></a></h1>
|
||||
<p>本节主要介绍所有带 USB IP 的芯片，移植 CherryUSB 主从协议栈时的通用步骤和注意事项。在移植之前，需要 <strong>你准备好一个可以打印 helloworld 的基本工程</strong> ，默认打印使用 <cite>printf</cite>, 如果是主机模式， <strong>则需要准备好可以正常执行 os 调度的基本工程</strong>。</p>
|
||||
<div class="section" id="usb-device">
|
||||
<h2>USB Device 移植要点<a class="headerlink" href="#usb-device" title="Permalink to this headline">¶</a></h2>
|
||||
<section id="usb-device">
|
||||
<h2>USB Device 移植要点<a class="headerlink" href="#usb-device" title="Link to this heading"></a></h2>
|
||||
<ul class="simple">
|
||||
<li><p>拷贝 CherryUSB 源码到工程目录下，并按需添加源文件和头文件路径，其中 <cite>usbd_core.c</cite> 和 <cite>usb_dc_xxx.c</cite> 为必须添加项。而 <cite>usb_dc_xxx.c</cite> 是芯片所对应的 USB IP dcd 部分驱动，如果不知道自己芯片属于那个 USB IP，参考 <strong>port</strong> 目录下的不同 USB IP 的 readme。如果使用的 USB IP 没有支持，只能自己实现了</p></li>
|
||||
<li><p>拷贝 <cite>cherryusb_config_template.h</cite> 文件到自己工程目录下，命名为 <cite>usb_config.h</cite>，并添加相应的目录头文件路径</p></li>
|
||||
@@ -163,9 +167,9 @@
|
||||
<li><p>在中断函数中调用 <cite>USBD_IRQHandler</cite>，并传入 <cite>busid</cite>, 如果你的 SDK 中中断入口已经存在 <cite>USBD_IRQHandler</cite> ，请更改 USB 协议栈中的名称</p></li>
|
||||
<li><p>编译使用。各个 class 如何使用，参考 demo 下的 template</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="usb-host">
|
||||
<h2>USB Host 移植要点<a class="headerlink" href="#usb-host" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="usb-host">
|
||||
<h2>USB Host 移植要点<a class="headerlink" href="#usb-host" title="Link to this heading"></a></h2>
|
||||
<ul class="simple">
|
||||
<li><p>拷贝 CherryUSB 源码到工程目录下，并按需添加源文件和头文件路径，其中 <cite>usbh_core.c</cite> 、 <cite>usb_hc_xxx.c</cite> 以及 <strong>osal</strong> 目录下源文件（根据不同的 os 选择对应的源文件）为必须添加项。而 <cite>usb_hc_xxx.c</cite> 是芯片所对应的 USB IP hcd 部分驱动，如果不知道自己芯片属于那个 USB IP，参考 <strong>port</strong> 目录下的不同 USB IP 的 readme。如果使用的 USB IP 没有支持，只能自己实现了</p></li>
|
||||
<li><p>拷贝 <cite>cherryusb_config_template.h</cite> 文件到自己工程目录下，命名为 <cite>usb_config.h</cite>，并添加相应的目录头文件路径</p></li>
|
||||
@@ -175,93 +179,93 @@
|
||||
<li><p>如果使用的是 GCC ，需要在链接脚本中添加如下代码（需要放在 flash 位置）：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="c1">// 在 ld 文件中添加如下代码</span>
|
||||
<span class="p">.</span> <span class="o">=</span> <span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">__usbh_class_info_start__</span> <span class="o">=</span> <span class="p">.;</span>
|
||||
<span class="p">.</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">__usbh_class_info_start__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span>
|
||||
<span class="n">KEEP</span><span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">usbh_class_info</span><span class="p">))</span>
|
||||
<span class="n">__usbh_class_info_end__</span> <span class="o">=</span> <span class="p">.;</span>
|
||||
<span class="n">__usbh_class_info_end__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>GCC 举例如下：</p>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cm">/* The program code and other data into "FLASH" Rom type memory */</span>
|
||||
<span class="p">.</span><span class="nl">text</span> <span class="p">:</span>
|
||||
<span class="p">.</span><span class="n">text</span><span class="w"> </span><span class="o">:</span>
|
||||
<span class="p">{</span>
|
||||
<span class="p">.</span> <span class="o">=</span> <span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">text</span><span class="p">)</span> <span class="cm">/* .text sections (code) */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">text</span><span class="o">*</span><span class="p">)</span> <span class="cm">/* .text* sections (code) */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">glue_7</span><span class="p">)</span> <span class="cm">/* glue arm to thumb code */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">glue_7t</span><span class="p">)</span> <span class="cm">/* glue thumb to arm code */</span>
|
||||
<span class="p">.</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">text</span><span class="p">)</span><span class="w"> </span><span class="cm">/* .text sections (code) */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">text</span><span class="o">*</span><span class="p">)</span><span class="w"> </span><span class="cm">/* .text* sections (code) */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">glue_7</span><span class="p">)</span><span class="w"> </span><span class="cm">/* glue arm to thumb code */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">glue_7t</span><span class="p">)</span><span class="w"> </span><span class="cm">/* glue thumb to arm code */</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">eh_frame</span><span class="p">)</span>
|
||||
|
||||
<span class="n">KEEP</span> <span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">init</span><span class="p">))</span>
|
||||
<span class="n">KEEP</span> <span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">fini</span><span class="p">))</span>
|
||||
<span class="p">.</span> <span class="o">=</span> <span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">__usbh_class_info_start__</span> <span class="o">=</span> <span class="p">.;</span>
|
||||
<span class="n">KEEP</span><span class="w"> </span><span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">init</span><span class="p">))</span>
|
||||
<span class="n">KEEP</span><span class="w"> </span><span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">fini</span><span class="p">))</span>
|
||||
<span class="p">.</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">__usbh_class_info_start__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span>
|
||||
<span class="n">KEEP</span><span class="p">(</span><span class="o">*</span><span class="p">(.</span><span class="n">usbh_class_info</span><span class="p">))</span>
|
||||
<span class="n">__usbh_class_info_end__</span> <span class="o">=</span> <span class="p">.;</span>
|
||||
<span class="p">.</span> <span class="o">=</span> <span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">_etext</span> <span class="o">=</span> <span class="p">.;</span> <span class="cm">/* define a global symbols at end of code */</span>
|
||||
<span class="p">}</span> <span class="o">></span> <span class="n">FLASH</span>
|
||||
<span class="n">__usbh_class_info_end__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span>
|
||||
<span class="p">.</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="n">_etext</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">.;</span><span class="w"> </span><span class="cm">/* define a global symbols at end of code */</span>
|
||||
<span class="p">}</span><span class="w"> </span><span class="o">></span><span class="w"> </span><span class="n">FLASH</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<ul class="simple">
|
||||
<li><p>Segger Embedded Studio 举例如下：</p></li>
|
||||
</ul>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">define</span> <span class="n">block</span> <span class="n">cherryusb_usbh_class_info</span> <span class="p">{</span> <span class="n">section</span> <span class="p">.</span><span class="n">usbh_class_info</span> <span class="p">};</span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">define</span><span class="w"> </span><span class="n">block</span><span class="w"> </span><span class="n">cherryusb_usbh_class_info</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">section</span><span class="w"> </span><span class="p">.</span><span class="n">usbh_class_info</span><span class="w"> </span><span class="p">};</span>
|
||||
|
||||
<span class="n">define</span> <span class="n">exported</span> <span class="n">symbol</span> <span class="n">__usbh_class_info_start__</span> <span class="o">=</span> <span class="n">start</span> <span class="n">of</span> <span class="n">block</span> <span class="n">cherryusb_usbh_class_info</span><span class="p">;</span>
|
||||
<span class="n">define</span> <span class="n">exported</span> <span class="n">symbol</span> <span class="n">__usbh_class_info_end__</span> <span class="o">=</span> <span class="n">end</span> <span class="n">of</span> <span class="n">block</span> <span class="n">cherryusb_usbh_class_info</span> <span class="o">+</span> <span class="mi">1</span><span class="p">;</span>
|
||||
<span class="n">define</span><span class="w"> </span><span class="n">exported</span><span class="w"> </span><span class="n">symbol</span><span class="w"> </span><span class="n">__usbh_class_info_start__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">start</span><span class="w"> </span><span class="n">of</span><span class="w"> </span><span class="n">block</span><span class="w"> </span><span class="n">cherryusb_usbh_class_info</span><span class="p">;</span>
|
||||
<span class="n">define</span><span class="w"> </span><span class="n">exported</span><span class="w"> </span><span class="n">symbol</span><span class="w"> </span><span class="n">__usbh_class_info_end__</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">end</span><span class="w"> </span><span class="n">of</span><span class="w"> </span><span class="n">block</span><span class="w"> </span><span class="n">cherryusb_usbh_class_info</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
|
||||
|
||||
<span class="n">place</span> <span class="n">in</span> <span class="n">AXI_SRAM</span> <span class="p">{</span> <span class="n">block</span> <span class="n">cherryusb_usbh_class_info</span> <span class="p">};</span>
|
||||
<span class="n">keep</span> <span class="p">{</span> <span class="n">section</span> <span class="p">.</span><span class="n">usbh_class_info</span><span class="p">};</span>
|
||||
<span class="n">place</span><span class="w"> </span><span class="n">in</span><span class="w"> </span><span class="n">AXI_SRAM</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">block</span><span class="w"> </span><span class="n">cherryusb_usbh_class_info</span><span class="w"> </span><span class="p">};</span>
|
||||
<span class="n">keep</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">section</span><span class="w"> </span><span class="p">.</span><span class="n">usbh_class_info</span><span class="p">};</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<ul class="simple">
|
||||
<li><p>编译使用。各个 class 如何使用，参考 demo 下的 <cite>usb_host.c</cite> 文件</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="section" id="cache">
|
||||
<h2>带 cache 功能的芯片使用注意<a class="headerlink" href="#cache" title="Permalink to this headline">¶</a></h2>
|
||||
</section>
|
||||
<section id="cache">
|
||||
<h2>带 cache 功能的芯片使用注意<a class="headerlink" href="#cache" title="Link to this heading"></a></h2>
|
||||
<p>协议栈以及 port 中不会对 cache 区域的 ram 进行 clean 或者 invalid，所以需要使用一块非 cache 区域的 ram 来维护。 <cite>USB_NOCACHE_RAM_SECTION</cite> 宏表示将变量指定到非 cache ram上，
|
||||
因此，用户需要在对应的链接脚本中添加 no cache ram 的 section。默认 <cite>USB_NOCACHE_RAM_SECTION</cite> 定义为 <cite>__attribute__((section(“.noncacheable”)))</cite>。</p>
|
||||
<p>GCC:</p>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">MEMORY</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">RAM</span> <span class="p">(</span><span class="n">xrw</span><span class="p">)</span> <span class="o">:</span> <span class="n">ORIGIN</span> <span class="o">=</span> <span class="mh">0x20000000</span><span class="p">,</span> <span class="n">LENGTH</span> <span class="o">=</span> <span class="mi">256</span><span class="n">K</span> <span class="o">-</span> <span class="mi">64</span><span class="n">K</span>
|
||||
<span class="n">RAM_nocache</span> <span class="p">(</span><span class="n">xrw</span><span class="p">)</span> <span class="o">:</span> <span class="n">ORIGIN</span> <span class="o">=</span> <span class="mh">0x20030000</span><span class="p">,</span> <span class="n">LENGTH</span> <span class="o">=</span> <span class="mi">64</span><span class="n">K</span>
|
||||
<span class="n">FLASH</span> <span class="p">(</span><span class="n">rx</span><span class="p">)</span> <span class="o">:</span> <span class="n">ORIGIN</span> <span class="o">=</span> <span class="mh">0x8000000</span><span class="p">,</span> <span class="n">LENGTH</span> <span class="o">=</span> <span class="mi">512</span><span class="n">K</span>
|
||||
<span class="n">RAM</span><span class="w"> </span><span class="p">(</span><span class="n">xrw</span><span class="p">)</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">ORIGIN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mh">0x20000000</span><span class="p">,</span><span class="w"> </span><span class="n">LENGTH</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">256</span><span class="n">K</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mi">64</span><span class="n">K</span>
|
||||
<span class="n">RAM_nocache</span><span class="w"> </span><span class="p">(</span><span class="n">xrw</span><span class="p">)</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">ORIGIN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mh">0x20030000</span><span class="p">,</span><span class="w"> </span><span class="n">LENGTH</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">64</span><span class="n">K</span>
|
||||
<span class="n">FLASH</span><span class="w"> </span><span class="p">(</span><span class="n">rx</span><span class="p">)</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="n">ORIGIN</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mh">0x8000000</span><span class="p">,</span><span class="w"> </span><span class="n">LENGTH</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">512</span><span class="n">K</span>
|
||||
<span class="p">}</span>
|
||||
|
||||
<span class="p">.</span><span class="nl">_nocache_ram</span> <span class="p">:</span>
|
||||
<span class="p">.</span><span class="n">_nocache_ram</span><span class="w"> </span><span class="o">:</span>
|
||||
<span class="p">{</span>
|
||||
<span class="p">.</span> <span class="o">=</span> <span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="p">.</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">ALIGN</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">noncacheable</span><span class="p">)</span>
|
||||
<span class="p">}</span> <span class="o">></span><span class="n">RAM_nocache</span>
|
||||
<span class="p">}</span><span class="w"> </span><span class="o">></span><span class="n">RAM_nocache</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>SCT:</p>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span>LR_IROM1 0x08000000 0x00200000 { ; load region size_region
|
||||
ER_IROM1 0x08000000 0x00200000 { ; load address = execution address
|
||||
*.o (RESET, +First)
|
||||
*(InRoot$$Sections)
|
||||
.ANY (+RO)
|
||||
.ANY (+XO)
|
||||
}
|
||||
RW_IRAM2 0x24000000 0x00070000 { ; RW data
|
||||
.ANY (+RW +ZI)
|
||||
}
|
||||
USB_NOCACHERAM 0x24070000 0x00010000 { ; RW data
|
||||
*(.noncacheable)
|
||||
}
|
||||
}
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">LR_IROM1</span><span class="w"> </span><span class="mh">0x08000000</span><span class="w"> </span><span class="mh">0x00200000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">load</span><span class="w"> </span><span class="n">region</span><span class="w"> </span><span class="n">size_region</span>
|
||||
<span class="n">ER_IROM1</span><span class="w"> </span><span class="mh">0x08000000</span><span class="w"> </span><span class="mh">0x00200000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">load</span><span class="w"> </span><span class="n">address</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">execution</span><span class="w"> </span><span class="n">address</span>
|
||||
<span class="o">*</span><span class="p">.</span><span class="n">o</span><span class="w"> </span><span class="p">(</span><span class="n">RESET</span><span class="p">,</span><span class="w"> </span><span class="o">+</span><span class="n">First</span><span class="p">)</span>
|
||||
<span class="o">*</span><span class="p">(</span><span class="n">InRoot$$Sections</span><span class="p">)</span>
|
||||
<span class="p">.</span><span class="n">ANY</span><span class="w"> </span><span class="p">(</span><span class="o">+</span><span class="n">RO</span><span class="p">)</span>
|
||||
<span class="p">.</span><span class="n">ANY</span><span class="w"> </span><span class="p">(</span><span class="o">+</span><span class="n">XO</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="n">RW_IRAM2</span><span class="w"> </span><span class="mh">0x24000000</span><span class="w"> </span><span class="mh">0x00070000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">RW</span><span class="w"> </span><span class="n">data</span>
|
||||
<span class="p">.</span><span class="n">ANY</span><span class="w"> </span><span class="p">(</span><span class="o">+</span><span class="n">RW</span><span class="w"> </span><span class="o">+</span><span class="n">ZI</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="n">USB_NOCACHERAM</span><span class="w"> </span><span class="mh">0x24070000</span><span class="w"> </span><span class="mh">0x00010000</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">;</span><span class="w"> </span><span class="n">RW</span><span class="w"> </span><span class="n">data</span>
|
||||
<span class="o">*</span><span class="p">(.</span><span class="n">noncacheable</span><span class="p">)</span>
|
||||
<span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>ICF:</p>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">define</span> <span class="n">region</span> <span class="n">NONCACHEABLE_RAM</span> <span class="o">=</span> <span class="p">[</span><span class="n">from</span> <span class="mh">0x1140000</span> <span class="n">size</span> <span class="mi">256</span><span class="n">K</span><span class="p">];</span>
|
||||
<span class="n">place</span> <span class="n">in</span> <span class="n">NONCACHEABLE_RAM</span> <span class="p">{</span> <span class="n">section</span> <span class="p">.</span><span class="n">noncacheable</span><span class="p">,</span> <span class="n">section</span> <span class="p">.</span><span class="n">noncacheable</span><span class="p">.</span><span class="n">init</span><span class="p">,</span> <span class="n">section</span> <span class="p">.</span><span class="n">noncacheable</span><span class="p">.</span><span class="n">bss</span> <span class="p">};</span> <span class="c1">// Noncacheable</span>
|
||||
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">define</span><span class="w"> </span><span class="n">region</span><span class="w"> </span><span class="n">NONCACHEABLE_RAM</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="n">from</span><span class="w"> </span><span class="mh">0x1140000</span><span class="w"> </span><span class="n">size</span><span class="w"> </span><span class="mi">256</span><span class="n">K</span><span class="p">];</span>
|
||||
<span class="n">place</span><span class="w"> </span><span class="n">in</span><span class="w"> </span><span class="n">NONCACHEABLE_RAM</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">section</span><span class="w"> </span><span class="p">.</span><span class="n">noncacheable</span><span class="p">,</span><span class="w"> </span><span class="n">section</span><span class="w"> </span><span class="p">.</span><span class="n">noncacheable</span><span class="p">.</span><span class="n">init</span><span class="p">,</span><span class="w"> </span><span class="n">section</span><span class="w"> </span><span class="p">.</span><span class="n">noncacheable</span><span class="p">.</span><span class="n">bss</span><span class="w"> </span><span class="p">};</span><span class="w"> </span><span class="c1">// Noncacheable</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
</section>
|
||||
|
||||
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user