luban-lite-t3e-pro/packages/third-party/cherryusb/docs/source/porting_usbip.rst

USB IP 勘误
==============================

本节主要对已经支持的 USB IP 在不同厂家上的一些差别说明并进行校对。欢迎补充。

FSDEV
--------------------------

FSDEV 仅支持从机。这个 ip 不同厂家基本都是基于标准的 usb 寄存器，所以用户使用时，仅需要修改 `USBD_IRQHandler` 、 `USB_BASE` 、 `USB_NUM_BIDIR_ENDPOINTS` 即可。有些芯片可能还需要配置 `PMA_ACCESS` 的值，默认为2。下表为具体芯片相关宏的修改值：

.. list-table::
    :widths: 30 20 30 30 30
    :header-rows: 1

    * - 芯片
      - USBD_IRQHandler
      - USB_BASE
      - USB_NUM_BIDIR_ENDPOINTS
      - 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** 定义了一套标准的寄存器偏移，所以如果是走的标准，则从机仅需要修改 `USBD_IRQHandler` 、 `USB_BASE` 、 `USB_NUM_BIDIR_ENDPOINTS` ，主机仅需要修改 `USBH_IRQHandler` 、 `USB_BASE` 以及 `CONIFG_USB_MUSB_EP_NUM` 即可。如果非标准，则需要实现以下宏的偏移，以标准为例：

.. 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

    * - 芯片
      - USBD_IRQHandler
      - USB_BASE
      - USB_NUM_BIDIR_ENDPOINTS
    * - ES32F3xx
      - USB_INT_Handler
      - 0x40086400
      - 5
    * - MSP432Ex
      - 同上
      - 0x40050000
      - 同上
    * - F1C100S
      - USB_INT_Handler
      - 0x01c13000
      - 4

下表为具体芯片主机相关宏的修改值：

.. list-table::
    :widths: 30 30 30 30
    :header-rows: 1

    * - 芯片
      - USBH_IRQHandler
      - USB_BASE
      - 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)寄存器)，所以如果是从机仅需要修改 `USBD_IRQHandler` 、 `USB_BASE` 、 `USB_NUM_BIDIR_ENDPOINTS` ，主机仅需要修改 `USBH_IRQHandler` 、 `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

    * - 芯片
      - USBH_IRQHandler
      - USB_BASE
      - USB_NUM_BIDIR_ENDPOINTS
    * - 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

    * - 芯片
      - USBH_IRQHandler
      - USB_BASE
      - CONFIG_USB_DWC2_PIPE_NUM
    * - STM32 全系列
      - OTG_HS_IRQHandler
      - 0x40040000UL
      - 12

EHCI
--------------------------

EHCI 是 intel 制定的标准主机控制器接口，任何厂家都必须实现 EHCI 中定义的寄存器以及寄存器的功能。EHCI 相关配置宏如下：

.. code-block:: C

  //Host Controller Operational Register BASE 距离基地址的偏移
  #define CONFIG_USB_EHCI_HCOR_OFFSET (0x14)
  //是否打印 ehci 配置信息
  #define CONFIG_USB_EHCI_INFO_ENABLE
  //是否关闭保留寄存器的占位，默认保留 9 个双字的占位
  #define CONFIG_USB_EHCI_HCOR_RESERVED_DISABLE
  //是否使能 configflag 寄存器中的 bit0
  #define CONFIG_USB_EHCI_CONFIGFLAG
  //是否使能 port power bit
  #define CONFIG_USB_EHCI_PORT_POWER
  //是否查看 ehci 配置信息
  #define CONFIG_USB_EHCI_PRINT_HW_PARAM

同时由于 EHCI 只是主机控制器并且只支持高速，一般配合一个 otg 控制器和一个低速全速兼容控制单元，而速度的获取一般是在 otg 寄存器中，所以需要用户实现 `usbh_get_port_speed` 函数。