sakumisu/CherryUSB
1
0
Fork 0
mirror of https://github.com/sakumisu/CherryUSB.git synced 2025-05-09 00:21:44 +08:00
Code Issues Packages Projects Releases Wiki Activity

Deploying to gh-pages from @ cherry-embedded/CherryUSB@d459ab11fb 🚀

Browse Source
This commit is contained in:
sakumisu 2024-10-10 13:03:21 +00:00
parent 4d2aa4db55
commit 798f5d015d
4 changed files with 1 additions and 688 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

232
_sources/porting_usbip.rst.txt
View File

@ -1,232 +0,0 @@
USB IP 勘误
==============================
本节主要对已经支持的 USB IP 在不同厂家上的一些差别说明并进行校对。欢迎补充。
FSDEV
--------------------------
FSDEV 仅支持从机。这个 ip 不同厂家基本都是基于标准的 usb 寄存器，有些芯片可能还需要配置 `PMA_ACCESS` 的值，默认为2。下表为具体芯片相关宏的修改值：
.. list-table::
:widths: 30 20 30 30 30
:header-rows: 1
* - 芯片
- 中断名
- 寄存器地址
- CONFIG_USBDEV_EP_NUM
- PMA_ACCESS
* - STM32F0
- USB_IRQHandler
- 0x40005C00
- 8
- 1
* - STM32F1
- USB_LP_CAN1_RX0_IRQHandler
- 同上
- 同上
- 同上
* - STM32F3
- USB_LP_CAN_RX0_IRQHandler
- 同上
- 同上
- 1 or 2
* - STM32L0
- USB_IRQHandler
- 同上
- 同上
- 1
* - STM32L1
- USB_LP_IRQHandler
- 同上
- 同上
- 2
* - STM32L4
- USB_IRQHandler
- 同上
- 同上
- 1
fsdev 需要外置 dp 上拉才能使用，有些芯片可能是接上拉电阻，有些芯片可能是设置寄存器，举例如下：
.. code-block:: C
USB->BCDR |= (uint16_t)USB_BCDR_DPPU;
如果不存在 BCDR 寄存器，则一般是配置如下，并且该设置需要配置到 `usb_dc_low_level_init` 中或者 `usb_dc_init` 最后都行：
.. code-block:: C
/* Pull up controller register */
#define DP_CTRL ((__IO unsigned*)(0x40001820))
#define _EnPortPullup() (*DP_CTRL = (*DP_CTRL) | 0x10000000);
#define _DisPortPullup() (*DP_CTRL = (*DP_CTRL) & 0xEFFFFFFF);
MUSB
--------------------------
MUSB IP 支持主从，并且由 **mentor** 定义了一套标准的寄存器偏移，如果非标准，则需要实现以下宏的偏移，以标准为例：
.. code-block:: C
#define MUSB_FADDR_OFFSET 0x00
#define MUSB_POWER_OFFSET 0x01
#define MUSB_TXIS_OFFSET 0x02
#define MUSB_RXIS_OFFSET 0x04
#define MUSB_TXIE_OFFSET 0x06
#define MUSB_RXIE_OFFSET 0x08
#define MUSB_IS_OFFSET 0x0A
#define MUSB_IE_OFFSET 0x0B
#define MUSB_EPIDX_OFFSET 0x0E
#define MUSB_IND_TXMAP_OFFSET 0x10
#define MUSB_IND_TXCSRL_OFFSET 0x12
#define MUSB_IND_TXCSRH_OFFSET 0x13
#define MUSB_IND_RXMAP_OFFSET 0x14
#define MUSB_IND_RXCSRL_OFFSET 0x16
#define MUSB_IND_RXCSRH_OFFSET 0x17
#define MUSB_IND_RXCOUNT_OFFSET 0x18
#define MUSB_IND_TXTYPE_OFFSET 0x1A
#define MUSB_IND_TXINTERVAL_OFFSET 0x1B
#define MUSB_IND_RXTYPE_OFFSET 0x1C
#define MUSB_IND_RXINTERVAL_OFFSET 0x1D
#define MUSB_FIFO_OFFSET 0x20
#define MUSB_DEVCTL_OFFSET 0x60
#define MUSB_TXFIFOSZ_OFFSET 0x62
#define MUSB_RXFIFOSZ_OFFSET 0x63
#define MUSB_TXFIFOADD_OFFSET 0x64
#define MUSB_RXFIFOADD_OFFSET 0x66
#define MUSB_TXFUNCADDR0_OFFSET 0x80
#define MUSB_TXHUBADDR0_OFFSET 0x82
#define MUSB_TXHUBPORT0_OFFSET 0x83
#define MUSB_TXFUNCADDRx_OFFSET 0x88
#define MUSB_TXHUBADDRx_OFFSET 0x8A
#define MUSB_TXHUBPORTx_OFFSET 0x8B
#define MUSB_RXFUNCADDRx_OFFSET 0x8C
#define MUSB_RXHUBADDRx_OFFSET 0x8E
#define MUSB_RXHUBPORTx_OFFSET 0x8F
#define USB_TXADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx)
#define USB_TXHUBADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 2)
#define USB_TXHUBPORT_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 3)
#define USB_RXADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 4)
#define USB_RXHUBADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 6)
#define USB_RXHUBPORT_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 7)
下表为具体芯片从机相关宏的修改值：
.. list-table::
:widths: 30 30 30 30
:header-rows: 1
* - 芯片
- 中断名
- 寄存器地址
- CONFIG_USBDEV_EP_NUM
* - ES32F3xx
- USB_INT_Handler
- 0x40086400
- 5
* - MSP432Ex
- 同上
- 0x40050000
- 同上
* - F1C100S
- USB_INT_Handler
- 0x01c13000
- 4
下表为具体芯片主机相关宏的修改值：
.. list-table::
:widths: 30 30 30 30
:header-rows: 1
* - 芯片
- 中断名
- 寄存器地址
- CONIFG_USB_MUSB_EP_NUM
* - ES32F3xx
- USB_INT_Handler
- 0x40086400
- 5
* - MSP432Ex
- 同上
- 0x40050000
- 同上
* - F1C100S
- USB_INT_Handler
- 0x01c13000
- 4
DWC2
--------------------------
DWC2 IP 支持主从，并且由 **synopsys** 定义了一套标准的寄存器偏移。大部分厂家都使用标准的寄存器偏移(除了 GCCFG(GGPIO)寄存器)，所以如果是从机仅需要修改 `中断名` 、 `USB_BASE` 、 `CONFIG_USBDEV_EP_NUM` ，主机仅需要修改 `中断名` 、 `USB_BASE` 即可。
.. note:: GCCFG(GGPIO) 根据不同的厂家设置不同，会影响 usb 枚举，需要根据厂家提供的手册进行配置,并实现 usbd_get_dwc2_gccfg_conf 和 usbh_get_dwc2_gccfg_conf 函数，填充相应需要使能的bit
.. caution:: 主机 port 仅支持有 dma 功能的 dwc2 ip(代码中会判断当前 ip 是否支持), 如果不支持 dma 模式，则无法使用。
下表为具体芯片从机相关宏的修改值：
.. list-table::
:widths: 30 30 30 30
:header-rows: 1
* - 芯片
- 中断名
- 寄存器地址
- CONFIG_USBDEV_EP_NUM
* - STM32 非 H7
- OTG_FS_IRQHandler/OTG_HS_IRQHandler
- 0x50000000UL/0x40040000UL
- 5
* - STM32 H7
- 同上
- 0x40080000UL/0x40040000UL
- 9
下表为具体芯片主机相关宏的修改值：
.. list-table::
:widths: 30 30 30 30
:header-rows: 1
* - 芯片
- 中断名
- 寄存器地址
- CONFIG_USBHOST_PIPE_NUM
* - STM32 全系列
- OTG_HS_IRQHandler
- 0x40040000UL
- 12
EHCI
--------------------------
EHCI 是 intel 制定的标准主机控制器接口，任何厂家都必须实现 EHCI 中定义的寄存器以及寄存器的功能。EHCI 相关配置宏如下：
.. code-block:: C
#define CONFIG_USB_EHCI_HCCR_OFFSET (0x0)
#define CONFIG_USB_EHCI_FRAME_LIST_SIZE 1024
#define CONFIG_USB_EHCI_QH_NUM CONFIG_USBHOST_PIPE_NUM
#define CONFIG_USB_EHCI_QTD_NUM 3
#define CONFIG_USB_EHCI_ITD_NUM 20
//是否关闭保留寄存器的占位，默认保留 9 个双字的占位
#define CONFIG_USB_EHCI_HCOR_RESERVED_DISABLE
//是否使能 configflag 寄存器中的 bit0
#define CONFIG_USB_EHCI_CONFIGFLAG
#define CONFIG_USB_EHCI_ISO
// 不带 tt的 IP 一般使用OHCI
#define CONFIG_USB_EHCI_WITH_OHCI
同时由于 EHCI 只是主机控制器并且只支持高速，一般配合一个 otg 控制器和一个低速全速兼容控制单元，而速度的获取一般是在 otg 寄存器中，所以需要用户实现 `usbh_get_port_speed` 函数。

BIN
objects.inv
View File

Binary file not shown.

455
porting_usbip.html
View File

@ -1,455 +0,0 @@
<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
<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>USB IP 勘误 &mdash; 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?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" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home">
CherryUSB
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">快速上手</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="quick_start/start.html">入门必看</a></li>
<li class="toctree-l1"><a class="reference internal" href="quick_start/demo.html">基于现有 demo 快速验证</a></li>
<li class="toctree-l1"><a class="reference internal" href="quick_start/transplant.html">芯片通用移植指南</a></li>
<li class="toctree-l1"><a class="reference internal" href="quick_start/rtthread.html">基于 RT-Thread 软件包开发指南</a></li>
<li class="toctree-l1"><a class="reference internal" href="quick_start/esp.html">基于 ESP-Registry 开发指南</a></li>
<li class="toctree-l1"><a class="reference internal" href="q%26a.html">Q &amp; A</a></li>
</ul>
<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>
<li class="toctree-l1"><a class="reference internal" href="usb/usb_desc.html">USB 描述符</a></li>
<li class="toctree-l1"><a class="reference internal" href="usb/usb_request.html">USB 设备请求</a></li>
<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" 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" 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>
<li class="toctree-l1"><a class="reference internal" href="class/class_msc.html">MSC</a></li>
<li class="toctree-l1"><a class="reference internal" href="class/class_audio.html">UAC</a></li>
<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" 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>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_msc.html">usbd_msc</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_rndis.html">usbd_rndis</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_ecm.html">usbd_cdc_ecm</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_audiov1.html">usbd_audiov1</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_audiov2.html">usbd_audiov2</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_video.html">usbd_video</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_winusb.html">usbd_winusb</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbd_webusb.html">usbd_webusb</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbh_serial.html">usbh_serial</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbh_hid.html">usbh_hid</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbh_msc.html">usbh_msc</a></li>
<li class="toctree-l1"><a class="reference internal" href="demo/usbh_net.html">usbh_net</a></li>
<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" 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>
<li class="toctree-l1"><a class="reference internal" href="usbip/xhci.html">XHCI</a></li>
<li class="toctree-l1"><a class="reference internal" href="usbip/chipidea.html">CHIPIDEA</a></li>
<li class="toctree-l1"><a class="reference internal" href="usbip/dwc2.html">DWC2</a></li>
<li class="toctree-l1"><a class="reference internal" href="usbip/musb.html">MUSB</a></li>
<li class="toctree-l1"><a class="reference internal" href="usbip/fotg210.html">FOTG210</a></li>
<li class="toctree-l1"><a class="reference internal" href="usbip/cdns2.html">CDNS2</a></li>
<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" 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" 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" role="heading"><span class="caption-text">商业支持</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="support/index.html">商业支持</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">CherryUSB</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item active">USB IP 勘误</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/porting_usbip.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="usb-ip">
<h1>USB IP 勘误<a class="headerlink" href="#usb-ip" title="Link to this heading"></a></h1>
<p>本节主要对已经支持的 USB IP 在不同厂家上的一些差别说明并进行校对。欢迎补充。</p>
<section id="fsdev">
<h2>FSDEV<a class="headerlink" href="#fsdev" title="Link to this heading"></a></h2>
<p>FSDEV 仅支持从机。这个 ip 不同厂家基本都是基于标准的 usb 寄存器，有些芯片可能还需要配置 <cite>PMA_ACCESS</cite> 的值，默认为2。下表为具体芯片相关宏的修改值：</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 21.4%" />
<col style="width: 14.3%" />
<col style="width: 21.4%" />
<col style="width: 21.4%" />
<col style="width: 21.4%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>芯片</p></th>
<th class="head"><p>中断名</p></th>
<th class="head"><p>寄存器地址</p></th>
<th class="head"><p>CONFIG_USBDEV_EP_NUM</p></th>
<th class="head"><p>PMA_ACCESS</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>STM32F0</p></td>
<td><p>USB_IRQHandler</p></td>
<td><p>0x40005C00</p></td>
<td><p>8</p></td>
<td><p>1</p></td>
</tr>
<tr class="row-odd"><td><p>STM32F1</p></td>
<td><p>USB_LP_CAN1_RX0_IRQHandler</p></td>
<td><p>同上</p></td>
<td><p>同上</p></td>
<td><p>同上</p></td>
</tr>
<tr class="row-even"><td><p>STM32F3</p></td>
<td><p>USB_LP_CAN_RX0_IRQHandler</p></td>
<td><p>同上</p></td>
<td><p>同上</p></td>
<td><p>1 or 2</p></td>
</tr>
<tr class="row-odd"><td><p>STM32L0</p></td>
<td><p>USB_IRQHandler</p></td>
<td><p>同上</p></td>
<td><p>同上</p></td>
<td><p>1</p></td>
</tr>
<tr class="row-even"><td><p>STM32L1</p></td>
<td><p>USB_LP_IRQHandler</p></td>
<td><p>同上</p></td>
<td><p>同上</p></td>
<td><p>2</p></td>
</tr>
<tr class="row-odd"><td><p>STM32L4</p></td>
<td><p>USB_IRQHandler</p></td>
<td><p>同上</p></td>
<td><p>同上</p></td>
<td><p>1</p></td>
</tr>
</tbody>
</table>
<p>fsdev 需要外置 dp 上拉才能使用，有些芯片可能是接上拉电阻，有些芯片可能是设置寄存器，举例如下：</p>
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="n">USB</span><span class="o">-&gt;</span><span class="n">BCDR</span><span class="w"> </span><span class="o">|=</span><span class="w"> </span><span class="p">(</span><span class="kt">uint16_t</span><span class="p">)</span><span class="n">USB_BCDR_DPPU</span><span class="p">;</span>
</pre></div>
</div>
<p>如果不存在 BCDR 寄存器，则一般是配置如下，并且该设置需要配置到 <cite>usb_dc_low_level_init</cite> 中或者 <cite>usb_dc_init</cite> 最后都行：</p>
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cm">/* Pull up controller register */</span>
<span class="cp">#define DP_CTRL ((__IO unsigned*)(0x40001820))</span>
<span class="cp">#define _EnPortPullup() (*DP_CTRL = (*DP_CTRL) | 0x10000000);</span>
<span class="cp">#define _DisPortPullup() (*DP_CTRL = (*DP_CTRL) &amp; 0xEFFFFFFF);</span>
</pre></div>
</div>
</section>
<section id="musb">
<h2>MUSB<a class="headerlink" href="#musb" title="Link to this heading"></a></h2>
<p>MUSB IP 支持主从，并且由 <strong>mentor</strong> 定义了一套标准的寄存器偏移，如果非标准，则需要实现以下宏的偏移，以标准为例：</p>
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cp">#define MUSB_FADDR_OFFSET 0x00</span>
<span class="cp">#define MUSB_POWER_OFFSET 0x01</span>
<span class="cp">#define MUSB_TXIS_OFFSET 0x02</span>
<span class="cp">#define MUSB_RXIS_OFFSET 0x04</span>
<span class="cp">#define MUSB_TXIE_OFFSET 0x06</span>
<span class="cp">#define MUSB_RXIE_OFFSET 0x08</span>
<span class="cp">#define MUSB_IS_OFFSET 0x0A</span>
<span class="cp">#define MUSB_IE_OFFSET 0x0B</span>
<span class="cp">#define MUSB_EPIDX_OFFSET 0x0E</span>
<span class="cp">#define MUSB_IND_TXMAP_OFFSET 0x10</span>
<span class="cp">#define MUSB_IND_TXCSRL_OFFSET 0x12</span>
<span class="cp">#define MUSB_IND_TXCSRH_OFFSET 0x13</span>
<span class="cp">#define MUSB_IND_RXMAP_OFFSET 0x14</span>
<span class="cp">#define MUSB_IND_RXCSRL_OFFSET 0x16</span>
<span class="cp">#define MUSB_IND_RXCSRH_OFFSET 0x17</span>
<span class="cp">#define MUSB_IND_RXCOUNT_OFFSET 0x18</span>
<span class="cp">#define MUSB_IND_TXTYPE_OFFSET 0x1A</span>
<span class="cp">#define MUSB_IND_TXINTERVAL_OFFSET 0x1B</span>
<span class="cp">#define MUSB_IND_RXTYPE_OFFSET 0x1C</span>
<span class="cp">#define MUSB_IND_RXINTERVAL_OFFSET 0x1D</span>
<span class="cp">#define MUSB_FIFO_OFFSET 0x20</span>
<span class="cp">#define MUSB_DEVCTL_OFFSET 0x60</span>
<span class="cp">#define MUSB_TXFIFOSZ_OFFSET 0x62</span>
<span class="cp">#define MUSB_RXFIFOSZ_OFFSET 0x63</span>
<span class="cp">#define MUSB_TXFIFOADD_OFFSET 0x64</span>
<span class="cp">#define MUSB_RXFIFOADD_OFFSET 0x66</span>
<span class="cp">#define MUSB_TXFUNCADDR0_OFFSET 0x80</span>
<span class="cp">#define MUSB_TXHUBADDR0_OFFSET 0x82</span>
<span class="cp">#define MUSB_TXHUBPORT0_OFFSET 0x83</span>
<span class="cp">#define MUSB_TXFUNCADDRx_OFFSET 0x88</span>
<span class="cp">#define MUSB_TXHUBADDRx_OFFSET 0x8A</span>
<span class="cp">#define MUSB_TXHUBPORTx_OFFSET 0x8B</span>
<span class="cp">#define MUSB_RXFUNCADDRx_OFFSET 0x8C</span>
<span class="cp">#define MUSB_RXHUBADDRx_OFFSET 0x8E</span>
<span class="cp">#define MUSB_RXHUBPORTx_OFFSET 0x8F</span>
<span class="cp">#define USB_TXADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx)</span>
<span class="cp">#define USB_TXHUBADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 2)</span>
<span class="cp">#define USB_TXHUBPORT_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 3)</span>
<span class="cp">#define USB_RXADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 4)</span>
<span class="cp">#define USB_RXHUBADDR_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 6)</span>
<span class="cp">#define USB_RXHUBPORT_BASE(ep_idx) (USB_BASE + MUSB_TXFUNCADDR0_OFFSET + 0x8 * ep_idx + 7)</span>
</pre></div>
</div>
<p>下表为具体芯片从机相关宏的修改值：</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>芯片</p></th>
<th class="head"><p>中断名</p></th>
<th class="head"><p>寄存器地址</p></th>
<th class="head"><p>CONFIG_USBDEV_EP_NUM</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>ES32F3xx</p></td>
<td><p>USB_INT_Handler</p></td>
<td><p>0x40086400</p></td>
<td><p>5</p></td>
</tr>
<tr class="row-odd"><td><p>MSP432Ex</p></td>
<td><p>同上</p></td>
<td><p>0x40050000</p></td>
<td><p>同上</p></td>
</tr>
<tr class="row-even"><td><p>F1C100S</p></td>
<td><p>USB_INT_Handler</p></td>
<td><p>0x01c13000</p></td>
<td><p>4</p></td>
</tr>
</tbody>
</table>
<p>下表为具体芯片主机相关宏的修改值：</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>芯片</p></th>
<th class="head"><p>中断名</p></th>
<th class="head"><p>寄存器地址</p></th>
<th class="head"><p>CONIFG_USB_MUSB_EP_NUM</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>ES32F3xx</p></td>
<td><p>USB_INT_Handler</p></td>
<td><p>0x40086400</p></td>
<td><p>5</p></td>
</tr>
<tr class="row-odd"><td><p>MSP432Ex</p></td>
<td><p>同上</p></td>
<td><p>0x40050000</p></td>
<td><p>同上</p></td>
</tr>
<tr class="row-even"><td><p>F1C100S</p></td>
<td><p>USB_INT_Handler</p></td>
<td><p>0x01c13000</p></td>
<td><p>4</p></td>
</tr>
</tbody>
</table>
</section>
<section id="dwc2">
<h2>DWC2<a class="headerlink" href="#dwc2" title="Link to this heading"></a></h2>
<p>DWC2 IP 支持主从，并且由 <strong>synopsys</strong> 定义了一套标准的寄存器偏移。大部分厂家都使用标准的寄存器偏移(除了 GCCFG(GGPIO)寄存器)，所以如果是从机仅需要修改 <cite>中断名</cite> 、 <cite>USB_BASE</cite> 、 <cite>CONFIG_USBDEV_EP_NUM</cite> ，主机仅需要修改 <cite>中断名</cite> 、 <cite>USB_BASE</cite> 即可。</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>GCCFG(GGPIO) 根据不同的厂家设置不同，会影响 usb 枚举，需要根据厂家提供的手册进行配置,并实现 usbd_get_dwc2_gccfg_conf 和 usbh_get_dwc2_gccfg_conf 函数，填充相应需要使能的bit</p>
</div>
<div class="admonition caution">
<p class="admonition-title">Caution</p>
<p>主机 port 仅支持有 dma 功能的 dwc2 ip(代码中会判断当前 ip 是否支持), 如果不支持 dma 模式，则无法使用。</p>
</div>
<p>下表为具体芯片从机相关宏的修改值：</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>芯片</p></th>
<th class="head"><p>中断名</p></th>
<th class="head"><p>寄存器地址</p></th>
<th class="head"><p>CONFIG_USBDEV_EP_NUM</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>STM32 非 H7</p></td>
<td><p>OTG_FS_IRQHandler/OTG_HS_IRQHandler</p></td>
<td><p>0x50000000UL/0x40040000UL</p></td>
<td><p>5</p></td>
</tr>
<tr class="row-odd"><td><p>STM32 H7</p></td>
<td><p>同上</p></td>
<td><p>0x40080000UL/0x40040000UL</p></td>
<td><p>9</p></td>
</tr>
</tbody>
</table>
<p>下表为具体芯片主机相关宏的修改值：</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
<col style="width: 25.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>芯片</p></th>
<th class="head"><p>中断名</p></th>
<th class="head"><p>寄存器地址</p></th>
<th class="head"><p>CONFIG_USBHOST_PIPE_NUM</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>STM32 全系列</p></td>
<td><p>OTG_HS_IRQHandler</p></td>
<td><p>0x40040000UL</p></td>
<td><p>12</p></td>
</tr>
</tbody>
</table>
</section>
<section id="ehci">
<h2>EHCI<a class="headerlink" href="#ehci" title="Link to this heading"></a></h2>
<p>EHCI 是 intel 制定的标准主机控制器接口，任何厂家都必须实现 EHCI 中定义的寄存器以及寄存器的功能。EHCI 相关配置宏如下：</p>
<div class="highlight-C notranslate"><div class="highlight"><pre><span></span><span class="cp">#define CONFIG_USB_EHCI_HCCR_OFFSET (0x0)</span>
<span class="cp">#define CONFIG_USB_EHCI_FRAME_LIST_SIZE 1024</span>
<span class="cp">#define CONFIG_USB_EHCI_QH_NUM CONFIG_USBHOST_PIPE_NUM</span>
<span class="cp">#define CONFIG_USB_EHCI_QTD_NUM 3</span>
<span class="cp">#define CONFIG_USB_EHCI_ITD_NUM 20</span>
<span class="c1">//是否关闭保留寄存器的占位，默认保留 9 个双字的占位</span>
<span class="cp">#define CONFIG_USB_EHCI_HCOR_RESERVED_DISABLE</span>
<span class="c1">//是否使能 configflag 寄存器中的 bit0</span>
<span class="cp">#define CONFIG_USB_EHCI_CONFIGFLAG</span>
<span class="cp">#define CONFIG_USB_EHCI_ISO</span>
<span class="c1">// 不带 tt的 IP 一般使用OHCI</span>
<span class="cp">#define CONFIG_USB_EHCI_WITH_OHCI</span>
</pre></div>
</div>
<p>同时由于 EHCI 只是主机控制器并且只支持高速，一般配合一个 otg 控制器和一个低速全速兼容控制单元，而速度的获取一般是在 otg 寄存器中，所以需要用户实现 <cite>usbh_get_port_speed</cite> 函数。</p>
</section>
</section>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2024, sakumisu.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>

2
searchindex.js
View File

File diff suppressed because one or more lines are too long