staging: octeon-usb: cvmx-usbcx-defs.h: fix comment style
authorAaro Koskinen <aaro.koskinen@iki.fi>
Thu, 6 Jun 2013 19:35:00 +0000 (22:35 +0300)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Thu, 6 Jun 2013 20:15:03 +0000 (13:15 -0700)
Adjust struct member comments to be closer to kernel-doc format.

Signed-off-by: Aaro Koskinen <aaro.koskinen@iki.fi>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/staging/octeon-usb/cvmx-usbcx-defs.h

index fe109ca..744cefa 100644 (file)
  */
 union cvmx_usbcx_gahbcfg {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_gahbcfg_s
+        * @ptxfemplvl: Periodic TxFIFO Empty Level (PTxFEmpLvl)
+        *      Software should set this bit to 0x1.
+        *      Indicates when the Periodic TxFIFO Empty Interrupt bit in the
+        *      Core Interrupt register (GINTSTS.PTxFEmp) is triggered. This
+        *      bit is used only in Slave mode.
+        *      * 1'b0: GINTSTS.PTxFEmp interrupt indicates that the Periodic
+        *      TxFIFO is half empty
+        *      * 1'b1: GINTSTS.PTxFEmp interrupt indicates that the Periodic
+        *      TxFIFO is completely empty
+        * @nptxfemplvl: Non-Periodic TxFIFO Empty Level (NPTxFEmpLvl)
+        *      Software should set this bit to 0x1.
+        *      Indicates when the Non-Periodic TxFIFO Empty Interrupt bit in
+        *      the Core Interrupt register (GINTSTS.NPTxFEmp) is triggered.
+        *      This bit is used only in Slave mode.
+        *      * 1'b0: GINTSTS.NPTxFEmp interrupt indicates that the Non-
+        *      Periodic TxFIFO is half empty
+        *      * 1'b1: GINTSTS.NPTxFEmp interrupt indicates that the Non-
+        *      Periodic TxFIFO is completely empty
+        * @dmaen: DMA Enable (DMAEn)
+        *      * 1'b0: Core operates in Slave mode
+        *      * 1'b1: Core operates in a DMA mode
+        * @hbstlen: Burst Length/Type (HBstLen)
+        *      This field has not effect and should be left as 0x0.
+        * @glblintrmsk: Global Interrupt Mask (GlblIntrMsk)
+        *      Software should set this field to 0x1.
+        *      The application uses this bit to mask  or unmask the interrupt
+        *      line assertion to itself. Irrespective of this bit's setting, the
+        *      interrupt status registers are updated by the core.
+        *      * 1'b0: Mask the interrupt assertion to the application.
+        *      * 1'b1: Unmask the interrupt assertion to the application.
+        */
        struct cvmx_usbcx_gahbcfg_s {
                uint32_t reserved_9_31  : 23;
-               uint32_t ptxfemplvl     : 1;        /**< Periodic TxFIFO Empty Level (PTxFEmpLvl)
-                                                         Software should set this bit to 0x1.
-                                                         Indicates when the Periodic TxFIFO Empty Interrupt bit in the
-                                                         Core Interrupt register (GINTSTS.PTxFEmp) is triggered. This
-                                                         bit is used only in Slave mode.
-                                                         * 1'b0: GINTSTS.PTxFEmp interrupt indicates that the Periodic
-                                                           TxFIFO is half empty
-                                                         * 1'b1: GINTSTS.PTxFEmp interrupt indicates that the Periodic
-                                                           TxFIFO is completely empty */
-               uint32_t nptxfemplvl    : 1;        /**< Non-Periodic TxFIFO Empty Level (NPTxFEmpLvl)
-                                                         Software should set this bit to 0x1.
-                                                         Indicates when the Non-Periodic TxFIFO Empty Interrupt bit in
-                                                         the Core Interrupt register (GINTSTS.NPTxFEmp) is triggered.
-                                                         This bit is used only in Slave mode.
-                                                         * 1'b0: GINTSTS.NPTxFEmp interrupt indicates that the Non-
-                                                            Periodic TxFIFO is half empty
-                                                         * 1'b1: GINTSTS.NPTxFEmp interrupt indicates that the Non-
-                                                            Periodic TxFIFO is completely empty */
+               uint32_t ptxfemplvl     : 1;
+               uint32_t nptxfemplvl    : 1;
                uint32_t reserved_6_6   : 1;
-               uint32_t dmaen          : 1;        /**< DMA Enable (DMAEn)
-                                                         * 1'b0: Core operates in Slave mode
-                                                         * 1'b1: Core operates in a DMA mode */
-               uint32_t hbstlen        : 4;        /**< Burst Length/Type (HBstLen)
-                                                         This field has not effect and should be left as 0x0. */
-               uint32_t glblintrmsk    : 1;        /**< Global Interrupt Mask (GlblIntrMsk)
-                                                         Software should set this field to 0x1.
-                                                         The application uses this bit to mask  or unmask the interrupt
-                                                         line assertion to itself. Irrespective of this bit's setting, the
-                                                         interrupt status registers are updated by the core.
-                                                         * 1'b0: Mask the interrupt assertion to the application.
-                                                         * 1'b1: Unmask the interrupt assertion to the application. */
+               uint32_t dmaen          : 1;
+               uint32_t hbstlen        : 4;
+               uint32_t glblintrmsk    : 1;
        } s;
 };
 typedef union cvmx_usbcx_gahbcfg cvmx_usbcx_gahbcfg_t;
@@ -166,51 +174,63 @@ typedef union cvmx_usbcx_gahbcfg cvmx_usbcx_gahbcfg_t;
  */
 union cvmx_usbcx_ghwcfg3 {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_ghwcfg3_s
+        * @dfifodepth: DFIFO Depth (DfifoDepth)
+        *      This value is in terms of 32-bit words.
+        *      * Minimum value is 32
+        *      * Maximum value is 32768
+        * @ahbphysync: AHB and PHY Synchronous (AhbPhySync)
+        *      Indicates whether AHB and PHY clocks are synchronous to
+        *      each other.
+        *      * 1'b0: No
+        *      * 1'b1: Yes
+        *      This bit is tied to 1.
+        * @rsttype: Reset Style for Clocked always Blocks in RTL (RstType)
+        *      * 1'b0: Asynchronous reset is used in the core
+        *      * 1'b1: Synchronous reset is used in the core
+        * @optfeature: Optional Features Removed (OptFeature)
+        *      Indicates whether the User ID register, GPIO interface ports,
+        *      and SOF toggle and counter ports were removed for gate count
+        *      optimization.
+        * @vendor_control_interface_support: Vendor Control Interface Support
+        *      * 1'b0: Vendor Control Interface is not available on the core.
+        *      * 1'b1: Vendor Control Interface is available.
+        * @i2c_selection: I2C Selection
+        *      * 1'b0: I2C Interface is not available on the core.
+        *      * 1'b1: I2C Interface is available on the core.
+        * @otgen: OTG Function Enabled (OtgEn)
+        *      The application uses this bit to indicate the O2P USB core's
+        *      OTG capabilities.
+        *      * 1'b0: Not OTG capable
+        *      * 1'b1: OTG Capable
+        * @pktsizewidth: Width of Packet Size Counters (PktSizeWidth)
+        *      * 3'b000: 4 bits
+        *      * 3'b001: 5 bits
+        *      * 3'b010: 6 bits
+        *      * 3'b011: 7 bits
+        *      * 3'b100: 8 bits
+        *      * 3'b101: 9 bits
+        *      * 3'b110: 10 bits
+        *      * Others: Reserved
+        * @xfersizewidth: Width of Transfer Size Counters (XferSizeWidth)
+        *      * 4'b0000: 11 bits
+        *      * 4'b0001: 12 bits
+        *      - ...
+        *      * 4'b1000: 19 bits
+        *      * Others: Reserved
+        */
        struct cvmx_usbcx_ghwcfg3_s {
-               uint32_t dfifodepth                             : 16; /**< DFIFO Depth (DfifoDepth)
-                                                         This value is in terms of 32-bit words.
-                                                         * Minimum value is 32
-                                                         * Maximum value is 32768 */
+               uint32_t dfifodepth                             : 16;
                uint32_t reserved_13_15                         : 3;
-               uint32_t ahbphysync                             : 1; /**< AHB and PHY Synchronous (AhbPhySync)
-                                                         Indicates whether AHB and PHY clocks are synchronous to
-                                                         each other.
-                                                         * 1'b0: No
-                                                         * 1'b1: Yes
-                                                         This bit is tied to 1. */
-               uint32_t rsttype                                : 1; /**< Reset Style for Clocked always Blocks in RTL (RstType)
-                                                         * 1'b0: Asynchronous reset is used in the core
-                                                         * 1'b1: Synchronous reset is used in the core */
-               uint32_t optfeature                             : 1; /**< Optional Features Removed (OptFeature)
-                                                         Indicates whether the User ID register, GPIO interface ports,
-                                                         and SOF toggle and counter ports were removed for gate count
-                                                         optimization. */
-               uint32_t vendor_control_interface_support       : 1; /**< Vendor Control Interface Support
-                                                         * 1'b0: Vendor Control Interface is not available on the core.
-                                                         * 1'b1: Vendor Control Interface is available. */
-               uint32_t i2c_selection                          : 1; /**< I2C Selection
-                                                         * 1'b0: I2C Interface is not available on the core.
-                                                         * 1'b1: I2C Interface is available on the core. */
-               uint32_t otgen                                  : 1; /**< OTG Function Enabled (OtgEn)
-                                                         The application uses this bit to indicate the O2P USB core's
-                                                         OTG capabilities.
-                                                         * 1'b0: Not OTG capable
-                                                         * 1'b1: OTG Capable */
-               uint32_t pktsizewidth                           : 3; /**< Width of Packet Size Counters (PktSizeWidth)
-                                                         * 3'b000: 4 bits
-                                                         * 3'b001: 5 bits
-                                                         * 3'b010: 6 bits
-                                                         * 3'b011: 7 bits
-                                                         * 3'b100: 8 bits
-                                                         * 3'b101: 9 bits
-                                                         * 3'b110: 10 bits
-                                                         * Others: Reserved */
-               uint32_t xfersizewidth                          : 4; /**< Width of Transfer Size Counters (XferSizeWidth)
-                                                         * 4'b0000: 11 bits
-                                                         * 4'b0001: 12 bits
-                                                         - ...
-                                                         * 4'b1000: 19 bits
-                                                         * Others: Reserved */
+               uint32_t ahbphysync                             : 1;
+               uint32_t rsttype                                : 1;
+               uint32_t optfeature                             : 1;
+               uint32_t vendor_control_interface_support       : 1;
+               uint32_t i2c_selection                          : 1;
+               uint32_t otgen                                  : 1;
+               uint32_t pktsizewidth                           : 3;
+               uint32_t xfersizewidth                          : 4;
        } s;
 };
 typedef union cvmx_usbcx_ghwcfg3 cvmx_usbcx_ghwcfg3_t;
@@ -227,44 +247,75 @@ typedef union cvmx_usbcx_ghwcfg3 cvmx_usbcx_ghwcfg3_t;
  */
 union cvmx_usbcx_gintmsk {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_gintmsk_s
+        * @wkupintmsk: Resume/Remote Wakeup Detected Interrupt Mask
+        *      (WkUpIntMsk)
+        * @sessreqintmsk: Session Request/New Session Detected Interrupt Mask
+        *      (SessReqIntMsk)
+        * @disconnintmsk: Disconnect Detected Interrupt Mask (DisconnIntMsk)
+        * @conidstschngmsk: Connector ID Status Change Mask (ConIDStsChngMsk)
+        * @ptxfempmsk: Periodic TxFIFO Empty Mask (PTxFEmpMsk)
+        * @hchintmsk: Host Channels Interrupt Mask (HChIntMsk)
+        * @prtintmsk: Host Port Interrupt Mask (PrtIntMsk)
+        * @fetsuspmsk: Data Fetch Suspended Mask (FetSuspMsk)
+        * @incomplpmsk: Incomplete Periodic Transfer Mask (incomplPMsk)
+        *      Incomplete Isochronous OUT Transfer Mask
+        *      (incompISOOUTMsk)
+        * @incompisoinmsk: Incomplete Isochronous IN Transfer Mask (incompISOINMsk)
+        * @oepintmsk: OUT Endpoints Interrupt Mask (OEPIntMsk)
+        * @inepintmsk: IN Endpoints Interrupt Mask (INEPIntMsk)
+        * @epmismsk: Endpoint Mismatch Interrupt Mask (EPMisMsk)
+        * @eopfmsk: End of Periodic Frame Interrupt Mask (EOPFMsk)
+        * @isooutdropmsk: Isochronous OUT Packet Dropped Interrupt Mask
+        *      (ISOOutDropMsk)
+        * @enumdonemsk: Enumeration Done Mask (EnumDoneMsk)
+        * @usbrstmsk: USB Reset Mask (USBRstMsk)
+        * @usbsuspmsk: USB Suspend Mask (USBSuspMsk)
+        * @erlysuspmsk: Early Suspend Mask (ErlySuspMsk)
+        * @i2cint: I2C Interrupt Mask (I2CINT)
+        * @ulpickintmsk: ULPI Carkit Interrupt Mask (ULPICKINTMsk)
+        *      I2C Carkit Interrupt Mask (I2CCKINTMsk)
+        * @goutnakeffmsk: Global OUT NAK Effective Mask (GOUTNakEffMsk)
+        * @ginnakeffmsk: Global Non-Periodic IN NAK Effective Mask (GINNakEffMsk)
+        * @nptxfempmsk: Non-Periodic TxFIFO Empty Mask (NPTxFEmpMsk)
+        * @rxflvlmsk: Receive FIFO Non-Empty Mask (RxFLvlMsk)
+        * @sofmsk: Start of (micro)Frame Mask (SofMsk)
+        * @otgintmsk: OTG Interrupt Mask (OTGIntMsk)
+        * @modemismsk: Mode Mismatch Interrupt Mask (ModeMisMsk)
+        */
        struct cvmx_usbcx_gintmsk_s {
-               uint32_t wkupintmsk             : 1;    /**< Resume/Remote Wakeup Detected Interrupt Mask
-                                                         (WkUpIntMsk) */
-               uint32_t sessreqintmsk          : 1;    /**< Session Request/New Session Detected Interrupt Mask
-                                                         (SessReqIntMsk) */
-               uint32_t disconnintmsk          : 1;    /**< Disconnect Detected Interrupt Mask (DisconnIntMsk) */
-               uint32_t conidstschngmsk        : 1;    /**< Connector ID Status Change Mask (ConIDStsChngMsk) */
+               uint32_t wkupintmsk             : 1;
+               uint32_t sessreqintmsk          : 1;
+               uint32_t disconnintmsk          : 1;
+               uint32_t conidstschngmsk        : 1;
                uint32_t reserved_27_27         : 1;
-               uint32_t ptxfempmsk             : 1;    /**< Periodic TxFIFO Empty Mask (PTxFEmpMsk) */
-               uint32_t hchintmsk              : 1;    /**< Host Channels Interrupt Mask (HChIntMsk) */
-               uint32_t prtintmsk              : 1;    /**< Host Port Interrupt Mask (PrtIntMsk) */
+               uint32_t ptxfempmsk             : 1;
+               uint32_t hchintmsk              : 1;
+               uint32_t prtintmsk              : 1;
                uint32_t reserved_23_23         : 1;
-               uint32_t fetsuspmsk             : 1;    /**< Data Fetch Suspended Mask (FetSuspMsk) */
-               uint32_t incomplpmsk            : 1;    /**< Incomplete Periodic Transfer Mask (incomplPMsk)
-                                                         Incomplete Isochronous OUT Transfer Mask
-                                                         (incompISOOUTMsk) */
-               uint32_t incompisoinmsk         : 1;    /**< Incomplete Isochronous IN Transfer Mask (incompISOINMsk) */
-               uint32_t oepintmsk              : 1;    /**< OUT Endpoints Interrupt Mask (OEPIntMsk) */
-               uint32_t inepintmsk             : 1;    /**< IN Endpoints Interrupt Mask (INEPIntMsk) */
-               uint32_t epmismsk               : 1;    /**< Endpoint Mismatch Interrupt Mask (EPMisMsk) */
+               uint32_t fetsuspmsk             : 1;
+               uint32_t incomplpmsk            : 1;
+               uint32_t incompisoinmsk         : 1;
+               uint32_t oepintmsk              : 1;
+               uint32_t inepintmsk             : 1;
+               uint32_t epmismsk               : 1;
                uint32_t reserved_16_16         : 1;
-               uint32_t eopfmsk                : 1;    /**< End of Periodic Frame Interrupt Mask (EOPFMsk) */
-               uint32_t isooutdropmsk          : 1;    /**< Isochronous OUT Packet Dropped Interrupt Mask
-                                                         (ISOOutDropMsk) */
-               uint32_t enumdonemsk            : 1;    /**< Enumeration Done Mask (EnumDoneMsk) */
-               uint32_t usbrstmsk              : 1;    /**< USB Reset Mask (USBRstMsk) */
-               uint32_t usbsuspmsk             : 1;    /**< USB Suspend Mask (USBSuspMsk) */
-               uint32_t erlysuspmsk            : 1;    /**< Early Suspend Mask (ErlySuspMsk) */
-               uint32_t i2cint                 : 1;    /**< I2C Interrupt Mask (I2CINT) */
-               uint32_t ulpickintmsk           : 1;    /**< ULPI Carkit Interrupt Mask (ULPICKINTMsk)
-                                                         I2C Carkit Interrupt Mask (I2CCKINTMsk) */
-               uint32_t goutnakeffmsk          : 1;    /**< Global OUT NAK Effective Mask (GOUTNakEffMsk) */
-               uint32_t ginnakeffmsk           : 1;    /**< Global Non-Periodic IN NAK Effective Mask (GINNakEffMsk) */
-               uint32_t nptxfempmsk            : 1;    /**< Non-Periodic TxFIFO Empty Mask (NPTxFEmpMsk) */
-               uint32_t rxflvlmsk              : 1;    /**< Receive FIFO Non-Empty Mask (RxFLvlMsk) */
-               uint32_t sofmsk                 : 1;    /**< Start of (micro)Frame Mask (SofMsk) */
-               uint32_t otgintmsk              : 1;    /**< OTG Interrupt Mask (OTGIntMsk) */
-               uint32_t modemismsk             : 1;    /**< Mode Mismatch Interrupt Mask (ModeMisMsk) */
+               uint32_t eopfmsk                : 1;
+               uint32_t isooutdropmsk          : 1;
+               uint32_t enumdonemsk            : 1;
+               uint32_t usbrstmsk              : 1;
+               uint32_t usbsuspmsk             : 1;
+               uint32_t erlysuspmsk            : 1;
+               uint32_t i2cint                 : 1;
+               uint32_t ulpickintmsk           : 1;
+               uint32_t goutnakeffmsk          : 1;
+               uint32_t ginnakeffmsk           : 1;
+               uint32_t nptxfempmsk            : 1;
+               uint32_t rxflvlmsk              : 1;
+               uint32_t sofmsk                 : 1;
+               uint32_t otgintmsk              : 1;
+               uint32_t modemismsk             : 1;
                uint32_t reserved_0_0           : 1;
        } s;
 };
@@ -284,181 +335,213 @@ typedef union cvmx_usbcx_gintmsk cvmx_usbcx_gintmsk_t;
  */
 union cvmx_usbcx_gintsts {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_gintsts_s
+        * @wkupint: Resume/Remote Wakeup Detected Interrupt (WkUpInt)
+        *      In Device mode, this interrupt is asserted when a resume is
+        *      detected on the USB. In Host mode, this interrupt is asserted
+        *      when a remote wakeup is detected on the USB.
+        *      For more information on how to use this interrupt, see "Partial
+        *      Power-Down and Clock Gating Programming Model" on
+        *      page 353.
+        * @sessreqint: Session Request/New Session Detected Interrupt (SessReqInt)
+        *      In Host mode, this interrupt is asserted when a session request
+        *      is detected from the device. In Device mode, this interrupt is
+        *      asserted when the utmiotg_bvalid signal goes high.
+        *      For more information on how to use this interrupt, see "Partial
+        *      Power-Down and Clock Gating Programming Model" on
+        *      page 353.
+        * @disconnint: Disconnect Detected Interrupt (DisconnInt)
+        *      Asserted when a device disconnect is detected.
+        * @conidstschng: Connector ID Status Change (ConIDStsChng)
+        *      The core sets this bit when there is a change in connector ID
+        *      status.
+        * @ptxfemp: Periodic TxFIFO Empty (PTxFEmp)
+        *      Asserted when the Periodic Transmit FIFO is either half or
+        *      completely empty and there is space for at least one entry to be
+        *      written in the Periodic Request Queue. The half or completely
+        *      empty status is determined by the Periodic TxFIFO Empty Level
+        *      bit in the Core AHB Configuration register
+        *      (GAHBCFG.PTxFEmpLvl).
+        * @hchint: Host Channels Interrupt (HChInt)
+        *      The core sets this bit to indicate that an interrupt is pending on
+        *      one of the channels of the core (in Host mode). The application
+        *      must read the Host All Channels Interrupt (HAINT) register to
+        *      determine the exact number of the channel on which the
+        *      interrupt occurred, and then read the corresponding Host
+        *      Channel-n Interrupt (HCINTn) register to determine the exact
+        *      cause of the interrupt. The application must clear the
+        *      appropriate status bit in the HCINTn register to clear this bit.
+        * @prtint: Host Port Interrupt (PrtInt)
+        *      The core sets this bit to indicate a change in port status of one
+        *      of the O2P USB core ports in Host mode. The application must
+        *      read the Host Port Control and Status (HPRT) register to
+        *      determine the exact event that caused this interrupt. The
+        *      application must clear the appropriate status bit in the Host Port
+        *      Control and Status register to clear this bit.
+        * @fetsusp: Data Fetch Suspended (FetSusp)
+        *      This interrupt is valid only in DMA mode. This interrupt indicates
+        *      that the core has stopped fetching data for IN endpoints due to
+        *      the unavailability of TxFIFO space or Request Queue space.
+        *      This interrupt is used by the application for an endpoint
+        *      mismatch algorithm.
+        * @incomplp: Incomplete Periodic Transfer (incomplP)
+        *      In Host mode, the core sets this interrupt bit when there are
+        *      incomplete periodic transactions still pending which are
+        *      scheduled for the current microframe.
+        *      Incomplete Isochronous OUT Transfer (incompISOOUT)
+        *      The Device mode, the core sets this interrupt to indicate that
+        *      there is at least one isochronous OUT endpoint on which the
+        *      transfer is not completed in the current microframe. This
+        *      interrupt is asserted along with the End of Periodic Frame
+        *      Interrupt (EOPF) bit in this register.
+        * @incompisoin: Incomplete Isochronous IN Transfer (incompISOIN)
+        *      The core sets this interrupt to indicate that there is at least one
+        *      isochronous IN endpoint on which the transfer is not completed
+        *      in the current microframe. This interrupt is asserted along with
+        *      the End of Periodic Frame Interrupt (EOPF) bit in this register.
+        * @oepint: OUT Endpoints Interrupt (OEPInt)
+        *      The core sets this bit to indicate that an interrupt is pending on
+        *      one of the OUT endpoints of the core (in Device mode). The
+        *      application must read the Device All Endpoints Interrupt
+        *      (DAINT) register to determine the exact number of the OUT
+        *      endpoint on which the interrupt occurred, and then read the
+        *      corresponding Device OUT Endpoint-n Interrupt (DOEPINTn)
+        *      register to determine the exact cause of the interrupt. The
+        *      application must clear the appropriate status bit in the
+        *      corresponding DOEPINTn register to clear this bit.
+        * @iepint: IN Endpoints Interrupt (IEPInt)
+        *      The core sets this bit to indicate that an interrupt is pending on
+        *      one of the IN endpoints of the core (in Device mode). The
+        *      application must read the Device All Endpoints Interrupt
+        *      (DAINT) register to determine the exact number of the IN
+        *      endpoint on which the interrupt occurred, and then read the
+        *      corresponding Device IN Endpoint-n Interrupt (DIEPINTn)
+        *      register to determine the exact cause of the interrupt. The
+        *      application must clear the appropriate status bit in the
+        *      corresponding DIEPINTn register to clear this bit.
+        * @epmis: Endpoint Mismatch Interrupt (EPMis)
+        *      Indicates that an IN token has been received for a non-periodic
+        *      endpoint, but the data for another endpoint is present in the top
+        *      of the Non-Periodic Transmit FIFO and the IN endpoint
+        *      mismatch count programmed by the application has expired.
+        * @eopf: End of Periodic Frame Interrupt (EOPF)
+        *      Indicates that the period specified in the Periodic Frame Interval
+        *      field of the Device Configuration register (DCFG.PerFrInt) has
+        *      been reached in the current microframe.
+        * @isooutdrop: Isochronous OUT Packet Dropped Interrupt (ISOOutDrop)
+        *      The core sets this bit when it fails to write an isochronous OUT
+        *      packet into the RxFIFO because the RxFIFO doesn't have
+        *      enough space to accommodate a maximum packet size packet
+        *      for the isochronous OUT endpoint.
+        * @enumdone: Enumeration Done (EnumDone)
+        *      The core sets this bit to indicate that speed enumeration is
+        *      complete. The application must read the Device Status (DSTS)
+        *      register to obtain the enumerated speed.
+        * @usbrst: USB Reset (USBRst)
+        *      The core sets this bit to indicate that a reset is detected on the
+        *      USB.
+        * @usbsusp: USB Suspend (USBSusp)
+        *      The core sets this bit to indicate that a suspend was detected
+        *      on the USB. The core enters the Suspended state when there
+        *      is no activity on the phy_line_state_i signal for an extended
+        *      period of time.
+        * @erlysusp: Early Suspend (ErlySusp)
+        *      The core sets this bit to indicate that an Idle state has been
+        *      detected on the USB for 3 ms.
+        * @i2cint: I2C Interrupt (I2CINT)
+        *      This bit is always 0x0.
+        * @ulpickint: ULPI Carkit Interrupt (ULPICKINT)
+        *      This bit is always 0x0.
+        * @goutnakeff: Global OUT NAK Effective (GOUTNakEff)
+        *      Indicates that the Set Global OUT NAK bit in the Device Control
+        *      register (DCTL.SGOUTNak), set by the application, has taken
+        *      effect in the core. This bit can be cleared by writing the Clear
+        *      Global OUT NAK bit in the Device Control register
+        *      (DCTL.CGOUTNak).
+        * @ginnakeff: Global IN Non-Periodic NAK Effective (GINNakEff)
+        *      Indicates that the Set Global Non-Periodic IN NAK bit in the
+        *      Device Control register (DCTL.SGNPInNak), set by the
+        *      application, has taken effect in the core. That is, the core has
+        *      sampled the Global IN NAK bit set by the application. This bit
+        *      can be cleared by clearing the Clear Global Non-Periodic IN
+        *      NAK bit in the Device Control register (DCTL.CGNPInNak).
+        *      This interrupt does not necessarily mean that a NAK handshake
+        *      is sent out on the USB. The STALL bit takes precedence over
+        *      the NAK bit.
+        * @nptxfemp: Non-Periodic TxFIFO Empty (NPTxFEmp)
+        *      This interrupt is asserted when the Non-Periodic TxFIFO is
+        *      either half or completely empty, and there is space for at least
+        *      one entry to be written to the Non-Periodic Transmit Request
+        *      Queue. The half or completely empty status is determined by
+        *      the Non-Periodic TxFIFO Empty Level bit in the Core AHB
+        *      Configuration register (GAHBCFG.NPTxFEmpLvl).
+        * @rxflvl: RxFIFO Non-Empty (RxFLvl)
+        *      Indicates that there is at least one packet pending to be read
+        *      from the RxFIFO.
+        * @sof: Start of (micro)Frame (Sof)
+        *      In Host mode, the core sets this bit to indicate that an SOF
+        *      (FS), micro-SOF (HS), or Keep-Alive (LS) is transmitted on the
+        *      USB. The application must write a 1 to this bit to clear the
+        *      interrupt.
+        *      In Device mode, in the core sets this bit to indicate that an SOF
+        *      token has been received on the USB. The application can read
+        *      the Device Status register to get the current (micro)frame
+        *      number. This interrupt is seen only when the core is operating
+        *      at either HS or FS.
+        * @otgint: OTG Interrupt (OTGInt)
+        *      The core sets this bit to indicate an OTG protocol event. The
+        *      application must read the OTG Interrupt Status (GOTGINT)
+        *      register to determine the exact event that caused this interrupt.
+        *      The application must clear the appropriate status bit in the
+        *      GOTGINT register to clear this bit.
+        * @modemis: Mode Mismatch Interrupt (ModeMis)
+        *      The core sets this bit when the application is trying to access:
+        *      * A Host mode register, when the core is operating in Device
+        *      mode
+        *      * A Device mode register, when the core is operating in Host
+        *      mode
+        *      The register access is completed on the AHB with an OKAY
+        *      response, but is ignored by the core internally and doesn't
+        *      affect the operation of the core.
+        * @curmod: Current Mode of Operation (CurMod)
+        *      Indicates the current mode of operation.
+        *      * 1'b0: Device mode
+        *      * 1'b1: Host mode
+        */
        struct cvmx_usbcx_gintsts_s {
-               uint32_t wkupint        : 1;        /**< Resume/Remote Wakeup Detected Interrupt (WkUpInt)
-                                                         In Device mode, this interrupt is asserted when a resume is
-                                                         detected on the USB. In Host mode, this interrupt is asserted
-                                                         when a remote wakeup is detected on the USB.
-                                                         For more information on how to use this interrupt, see "Partial
-                                                         Power-Down and Clock Gating Programming Model" on
-                                                         page 353. */
-               uint32_t sessreqint     : 1;        /**< Session Request/New Session Detected Interrupt (SessReqInt)
-                                                         In Host mode, this interrupt is asserted when a session request
-                                                         is detected from the device. In Device mode, this interrupt is
-                                                         asserted when the utmiotg_bvalid signal goes high.
-                                                         For more information on how to use this interrupt, see "Partial
-                                                         Power-Down and Clock Gating Programming Model" on
-                                                         page 353. */
-               uint32_t disconnint     : 1;        /**< Disconnect Detected Interrupt (DisconnInt)
-                                                         Asserted when a device disconnect is detected. */
-               uint32_t conidstschng   : 1;    /**< Connector ID Status Change (ConIDStsChng)
-                                                         The core sets this bit when there is a change in connector ID
-                                                         status. */
+               uint32_t wkupint        : 1;
+               uint32_t sessreqint     : 1;
+               uint32_t disconnint     : 1;
+               uint32_t conidstschng   : 1;
                uint32_t reserved_27_27 : 1;
-               uint32_t ptxfemp        : 1;        /**< Periodic TxFIFO Empty (PTxFEmp)
-                                                         Asserted when the Periodic Transmit FIFO is either half or
-                                                         completely empty and there is space for at least one entry to be
-                                                         written in the Periodic Request Queue. The half or completely
-                                                         empty status is determined by the Periodic TxFIFO Empty Level
-                                                         bit in the Core AHB Configuration register
-                                                         (GAHBCFG.PTxFEmpLvl). */
-               uint32_t hchint         : 1;        /**< Host Channels Interrupt (HChInt)
-                                                         The core sets this bit to indicate that an interrupt is pending on
-                                                         one of the channels of the core (in Host mode). The application
-                                                         must read the Host All Channels Interrupt (HAINT) register to
-                                                         determine the exact number of the channel on which the
-                                                         interrupt occurred, and then read the corresponding Host
-                                                         Channel-n Interrupt (HCINTn) register to determine the exact
-                                                         cause of the interrupt. The application must clear the
-                                                         appropriate status bit in the HCINTn register to clear this bit. */
-               uint32_t prtint         : 1;        /**< Host Port Interrupt (PrtInt)
-                                                         The core sets this bit to indicate a change in port status of one
-                                                         of the O2P USB core ports in Host mode. The application must
-                                                         read the Host Port Control and Status (HPRT) register to
-                                                         determine the exact event that caused this interrupt. The
-                                                         application must clear the appropriate status bit in the Host Port
-                                                         Control and Status register to clear this bit. */
+               uint32_t ptxfemp        : 1;
+               uint32_t hchint         : 1;
+               uint32_t prtint         : 1;
                uint32_t reserved_23_23 : 1;
-               uint32_t fetsusp        : 1;        /**< Data Fetch Suspended (FetSusp)
-                                                         This interrupt is valid only in DMA mode. This interrupt indicates
-                                                         that the core has stopped fetching data for IN endpoints due to
-                                                         the unavailability of TxFIFO space or Request Queue space.
-                                                         This interrupt is used by the application for an endpoint
-                                                         mismatch algorithm. */
-               uint32_t incomplp       : 1;        /**< Incomplete Periodic Transfer (incomplP)
-                                                         In Host mode, the core sets this interrupt bit when there are
-                                                         incomplete periodic transactions still pending which are
-                                                         scheduled for the current microframe.
-                                                         Incomplete Isochronous OUT Transfer (incompISOOUT)
-                                                         The Device mode, the core sets this interrupt to indicate that
-                                                         there is at least one isochronous OUT endpoint on which the
-                                                         transfer is not completed in the current microframe. This
-                                                         interrupt is asserted along with the End of Periodic Frame
-                                                         Interrupt (EOPF) bit in this register. */
-               uint32_t incompisoin    : 1;        /**< Incomplete Isochronous IN Transfer (incompISOIN)
-                                                         The core sets this interrupt to indicate that there is at least one
-                                                         isochronous IN endpoint on which the transfer is not completed
-                                                         in the current microframe. This interrupt is asserted along with
-                                                         the End of Periodic Frame Interrupt (EOPF) bit in this register. */
-               uint32_t oepint         : 1;        /**< OUT Endpoints Interrupt (OEPInt)
-                                                         The core sets this bit to indicate that an interrupt is pending on
-                                                         one of the OUT endpoints of the core (in Device mode). The
-                                                         application must read the Device All Endpoints Interrupt
-                                                         (DAINT) register to determine the exact number of the OUT
-                                                         endpoint on which the interrupt occurred, and then read the
-                                                         corresponding Device OUT Endpoint-n Interrupt (DOEPINTn)
-                                                         register to determine the exact cause of the interrupt. The
-                                                         application must clear the appropriate status bit in the
-                                                         corresponding DOEPINTn register to clear this bit. */
-               uint32_t iepint         : 1;        /**< IN Endpoints Interrupt (IEPInt)
-                                                         The core sets this bit to indicate that an interrupt is pending on
-                                                         one of the IN endpoints of the core (in Device mode). The
-                                                         application must read the Device All Endpoints Interrupt
-                                                         (DAINT) register to determine the exact number of the IN
-                                                         endpoint on which the interrupt occurred, and then read the
-                                                         corresponding Device IN Endpoint-n Interrupt (DIEPINTn)
-                                                         register to determine the exact cause of the interrupt. The
-                                                         application must clear the appropriate status bit in the
-                                                         corresponding DIEPINTn register to clear this bit. */
-               uint32_t epmis          : 1;        /**< Endpoint Mismatch Interrupt (EPMis)
-                                                         Indicates that an IN token has been received for a non-periodic
-                                                         endpoint, but the data for another endpoint is present in the top
-                                                         of the Non-Periodic Transmit FIFO and the IN endpoint
-                                                         mismatch count programmed by the application has expired. */
+               uint32_t fetsusp        : 1;
+               uint32_t incomplp       : 1;
+               uint32_t incompisoin    : 1;
+               uint32_t oepint         : 1;
+               uint32_t iepint         : 1;
+               uint32_t epmis          : 1;
                uint32_t reserved_16_16 : 1;
-               uint32_t eopf           : 1;        /**< End of Periodic Frame Interrupt (EOPF)
-                                                         Indicates that the period specified in the Periodic Frame Interval
-                                                         field of the Device Configuration register (DCFG.PerFrInt) has
-                                                         been reached in the current microframe. */
-               uint32_t isooutdrop     : 1;        /**< Isochronous OUT Packet Dropped Interrupt (ISOOutDrop)
-                                                         The core sets this bit when it fails to write an isochronous OUT
-                                                         packet into the RxFIFO because the RxFIFO doesn't have
-                                                         enough space to accommodate a maximum packet size packet
-                                                         for the isochronous OUT endpoint. */
-               uint32_t enumdone       : 1;        /**< Enumeration Done (EnumDone)
-                                                         The core sets this bit to indicate that speed enumeration is
-                                                         complete. The application must read the Device Status (DSTS)
-                                                         register to obtain the enumerated speed. */
-               uint32_t usbrst         : 1;        /**< USB Reset (USBRst)
-                                                         The core sets this bit to indicate that a reset is detected on the
-                                                         USB. */
-               uint32_t usbsusp        : 1;        /**< USB Suspend (USBSusp)
-                                                         The core sets this bit to indicate that a suspend was detected
-                                                         on the USB. The core enters the Suspended state when there
-                                                         is no activity on the phy_line_state_i signal for an extended
-                                                         period of time. */
-               uint32_t erlysusp       : 1;        /**< Early Suspend (ErlySusp)
-                                                         The core sets this bit to indicate that an Idle state has been
-                                                         detected on the USB for 3 ms. */
-               uint32_t i2cint         : 1;        /**< I2C Interrupt (I2CINT)
-                                                         This bit is always 0x0. */
-               uint32_t ulpickint      : 1;        /**< ULPI Carkit Interrupt (ULPICKINT)
-                                                         This bit is always 0x0. */
-               uint32_t goutnakeff     : 1;        /**< Global OUT NAK Effective (GOUTNakEff)
-                                                         Indicates that the Set Global OUT NAK bit in the Device Control
-                                                         register (DCTL.SGOUTNak), set by the application, has taken
-                                                         effect in the core. This bit can be cleared by writing the Clear
-                                                         Global OUT NAK bit in the Device Control register
-                                                         (DCTL.CGOUTNak). */
-               uint32_t ginnakeff      : 1;        /**< Global IN Non-Periodic NAK Effective (GINNakEff)
-                                                         Indicates that the Set Global Non-Periodic IN NAK bit in the
-                                                         Device Control register (DCTL.SGNPInNak), set by the
-                                                         application, has taken effect in the core. That is, the core has
-                                                         sampled the Global IN NAK bit set by the application. This bit
-                                                         can be cleared by clearing the Clear Global Non-Periodic IN
-                                                         NAK bit in the Device Control register (DCTL.CGNPInNak).
-                                                         This interrupt does not necessarily mean that a NAK handshake
-                                                         is sent out on the USB. The STALL bit takes precedence over
-                                                         the NAK bit. */
-               uint32_t nptxfemp       : 1;        /**< Non-Periodic TxFIFO Empty (NPTxFEmp)
-                                                         This interrupt is asserted when the Non-Periodic TxFIFO is
-                                                         either half or completely empty, and there is space for at least
-                                                         one entry to be written to the Non-Periodic Transmit Request
-                                                         Queue. The half or completely empty status is determined by
-                                                         the Non-Periodic TxFIFO Empty Level bit in the Core AHB
-                                                         Configuration register (GAHBCFG.NPTxFEmpLvl). */
-               uint32_t rxflvl         : 1;        /**< RxFIFO Non-Empty (RxFLvl)
-                                                         Indicates that there is at least one packet pending to be read
-                                                         from the RxFIFO. */
-               uint32_t sof            : 1;        /**< Start of (micro)Frame (Sof)
-                                                         In Host mode, the core sets this bit to indicate that an SOF
-                                                         (FS), micro-SOF (HS), or Keep-Alive (LS) is transmitted on the
-                                                         USB. The application must write a 1 to this bit to clear the
-                                                         interrupt.
-                                                         In Device mode, in the core sets this bit to indicate that an SOF
-                                                         token has been received on the USB. The application can read
-                                                         the Device Status register to get the current (micro)frame
-                                                         number. This interrupt is seen only when the core is operating
-                                                         at either HS or FS. */
-               uint32_t otgint         : 1;        /**< OTG Interrupt (OTGInt)
-                                                         The core sets this bit to indicate an OTG protocol event. The
-                                                         application must read the OTG Interrupt Status (GOTGINT)
-                                                         register to determine the exact event that caused this interrupt.
-                                                         The application must clear the appropriate status bit in the
-                                                         GOTGINT register to clear this bit. */
-               uint32_t modemis        : 1;        /**< Mode Mismatch Interrupt (ModeMis)
-                                                         The core sets this bit when the application is trying to access:
-                                                         * A Host mode register, when the core is operating in Device
-                                                         mode
-                                                         * A Device mode register, when the core is operating in Host
-                                                           mode
-                                                           The register access is completed on the AHB with an OKAY
-                                                           response, but is ignored by the core internally and doesn't
-                                                         affect the operation of the core. */
-               uint32_t curmod         : 1;        /**< Current Mode of Operation (CurMod)
-                                                         Indicates the current mode of operation.
-                                                         * 1'b0: Device mode
-                                                         * 1'b1: Host mode */
+               uint32_t eopf           : 1;
+               uint32_t isooutdrop     : 1;
+               uint32_t enumdone       : 1;
+               uint32_t usbrst         : 1;
+               uint32_t usbsusp        : 1;
+               uint32_t erlysusp       : 1;
+               uint32_t i2cint         : 1;
+               uint32_t ulpickint      : 1;
+               uint32_t goutnakeff     : 1;
+               uint32_t ginnakeff      : 1;
+               uint32_t nptxfemp       : 1;
+               uint32_t rxflvl         : 1;
+               uint32_t sof            : 1;
+               uint32_t otgint         : 1;
+               uint32_t modemis        : 1;
+               uint32_t curmod         : 1;
        } s;
 };
 typedef union cvmx_usbcx_gintsts cvmx_usbcx_gintsts_t;
@@ -472,14 +555,19 @@ typedef union cvmx_usbcx_gintsts cvmx_usbcx_gintsts_t;
  */
 union cvmx_usbcx_gnptxfsiz {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_gnptxfsiz_s
+        * @nptxfdep: Non-Periodic TxFIFO Depth (NPTxFDep)
+        *      This value is in terms of 32-bit words.
+        *      Minimum value is 16
+        *      Maximum value is 32768
+        * @nptxfstaddr: Non-Periodic Transmit RAM Start Address (NPTxFStAddr)
+        *      This field contains the memory start address for Non-Periodic
+        *      Transmit FIFO RAM.
+        */
        struct cvmx_usbcx_gnptxfsiz_s {
-               uint32_t nptxfdep       : 16;    /**< Non-Periodic TxFIFO Depth (NPTxFDep)
-                                                         This value is in terms of 32-bit words.
-                                                         Minimum value is 16
-                                                         Maximum value is 32768 */
-               uint32_t nptxfstaddr    : 16;    /**< Non-Periodic Transmit RAM Start Address (NPTxFStAddr)
-                                                         This field contains the memory start address for Non-Periodic
-                                                         Transmit FIFO RAM. */
+               uint32_t nptxfdep       : 16;
+               uint32_t nptxfstaddr    : 16;
        } s;
 };
 typedef union cvmx_usbcx_gnptxfsiz cvmx_usbcx_gnptxfsiz_t;
@@ -494,39 +582,45 @@ typedef union cvmx_usbcx_gnptxfsiz cvmx_usbcx_gnptxfsiz_t;
  */
 union cvmx_usbcx_gnptxsts {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_gnptxsts_s
+        * @nptxqtop: Top of the Non-Periodic Transmit Request Queue (NPTxQTop)
+        *      Entry in the Non-Periodic Tx Request Queue that is currently
+        *      being processed by the MAC.
+        *      * Bits [30:27]: Channel/endpoint number
+        *      * Bits [26:25]:
+        *      - 2'b00: IN/OUT token
+        *      - 2'b01: Zero-length transmit packet (device IN/host OUT)
+        *      - 2'b10: PING/CSPLIT token
+        *      - 2'b11: Channel halt command
+        *      * Bit [24]: Terminate (last entry for selected channel/endpoint)
+        * @nptxqspcavail: Non-Periodic Transmit Request Queue Space Available
+        *      (NPTxQSpcAvail)
+        *      Indicates the amount of free space available in the Non-
+        *      Periodic Transmit Request Queue. This queue holds both IN
+        *      and OUT requests in Host mode. Device mode has only IN
+        *      requests.
+        *      * 8'h0: Non-Periodic Transmit Request Queue is full
+        *      * 8'h1: 1 location available
+        *      * 8'h2: 2 locations available
+        *      * n: n locations available (0..8)
+        *      * Others: Reserved
+        * @nptxfspcavail: Non-Periodic TxFIFO Space Avail (NPTxFSpcAvail)
+        *      Indicates the amount of free space available in the Non-
+        *      Periodic TxFIFO.
+        *      Values are in terms of 32-bit words.
+        *      * 16'h0: Non-Periodic TxFIFO is full
+        *      * 16'h1: 1 word available
+        *      * 16'h2: 2 words available
+        *      * 16'hn: n words available (where 0..32768)
+        *      * 16'h8000: 32768 words available
+        *      * Others: Reserved
+        */
        struct cvmx_usbcx_gnptxsts_s {
                uint32_t reserved_31_31 : 1;
-               uint32_t nptxqtop       : 7;        /**< Top of the Non-Periodic Transmit Request Queue (NPTxQTop)
-                                                         Entry in the Non-Periodic Tx Request Queue that is currently
-                                                         being processed by the MAC.
-                                                         * Bits [30:27]: Channel/endpoint number
-                                                         * Bits [26:25]:
-                                                           - 2'b00: IN/OUT token
-                                                           - 2'b01: Zero-length transmit packet (device IN/host OUT)
-                                                           - 2'b10: PING/CSPLIT token
-                                                           - 2'b11: Channel halt command
-                                                         * Bit [24]: Terminate (last entry for selected channel/endpoint) */
-               uint32_t nptxqspcavail  : 8;    /**< Non-Periodic Transmit Request Queue Space Available
-                                                         (NPTxQSpcAvail)
-                                                         Indicates the amount of free space available in the Non-
-                                                         Periodic Transmit Request Queue. This queue holds both IN
-                                                         and OUT requests in Host mode. Device mode has only IN
-                                                         requests.
-                                                         * 8'h0: Non-Periodic Transmit Request Queue is full
-                                                         * 8'h1: 1 location available
-                                                         * 8'h2: 2 locations available
-                                                         * n: n locations available (0..8)
-                                                         * Others: Reserved */
-               uint32_t nptxfspcavail  : 16;    /**< Non-Periodic TxFIFO Space Avail (NPTxFSpcAvail)
-                                                         Indicates the amount of free space available in the Non-
-                                                         Periodic TxFIFO.
-                                                         Values are in terms of 32-bit words.
-                                                         * 16'h0: Non-Periodic TxFIFO is full
-                                                         * 16'h1: 1 word available
-                                                         * 16'h2: 2 words available
-                                                         * 16'hn: n words available (where 0..32768)
-                                                         * 16'h8000: 32768 words available
-                                                         * Others: Reserved */
+               uint32_t nptxqtop       : 7;
+               uint32_t nptxqspcavail  : 8;
+               uint32_t nptxfspcavail  : 16;
        } s;
 };
 typedef union cvmx_usbcx_gnptxsts cvmx_usbcx_gnptxsts_t;
@@ -540,108 +634,120 @@ typedef union cvmx_usbcx_gnptxsts cvmx_usbcx_gnptxsts_t;
  */
 union cvmx_usbcx_grstctl {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_grstctl_s
+        * @ahbidle: AHB Master Idle (AHBIdle)
+        *      Indicates that the AHB Master State Machine is in the IDLE
+        *      condition.
+        * @dmareq: DMA Request Signal (DMAReq)
+        *      Indicates that the DMA request is in progress. Used for debug.
+        * @txfnum: TxFIFO Number (TxFNum)
+        *      This is the FIFO number that must be flushed using the TxFIFO
+        *      Flush bit. This field must not be changed until the core clears
+        *      the TxFIFO Flush bit.
+        *      * 5'h0: Non-Periodic TxFIFO flush
+        *      * 5'h1: Periodic TxFIFO 1 flush in Device mode or Periodic
+        *      TxFIFO flush in Host mode
+        *      * 5'h2: Periodic TxFIFO 2 flush in Device mode
+        *      - ...
+        *      * 5'hF: Periodic TxFIFO 15 flush in Device mode
+        *      * 5'h10: Flush all the Periodic and Non-Periodic TxFIFOs in the
+        *      core
+        * @txfflsh: TxFIFO Flush (TxFFlsh)
+        *      This bit selectively flushes a single or all transmit FIFOs, but
+        *      cannot do so if the core is in the midst of a transaction.
+        *      The application must only write this bit after checking that the
+        *      core is neither writing to the TxFIFO nor reading from the
+        *      TxFIFO.
+        *      The application must wait until the core clears this bit before
+        *      performing any operations. This bit takes 8 clocks (of phy_clk or
+        *      hclk, whichever is slower) to clear.
+        * @rxfflsh: RxFIFO Flush (RxFFlsh)
+        *      The application can flush the entire RxFIFO using this bit, but
+        *      must first ensure that the core is not in the middle of a
+        *      transaction.
+        *      The application must only write to this bit after checking that the
+        *      core is neither reading from the RxFIFO nor writing to the
+        *      RxFIFO.
+        *      The application must wait until the bit is cleared before
+        *      performing any other operations. This bit will take 8 clocks
+        *      (slowest of PHY or AHB clock) to clear.
+        * @intknqflsh: IN Token Sequence Learning Queue Flush (INTknQFlsh)
+        *      The application writes this bit to flush the IN Token Sequence
+        *      Learning Queue.
+        * @frmcntrrst: Host Frame Counter Reset (FrmCntrRst)
+        *      The application writes this bit to reset the (micro)frame number
+        *      counter inside the core. When the (micro)frame counter is reset,
+        *      the subsequent SOF sent out by the core will have a
+        *      (micro)frame number of 0.
+        * @hsftrst: HClk Soft Reset (HSftRst)
+        *      The application uses this bit to flush the control logic in the AHB
+        *      Clock domain. Only AHB Clock Domain pipelines are reset.
+        *      * FIFOs are not flushed with this bit.
+        *      * All state machines in the AHB clock domain are reset to the
+        *      Idle state after terminating the transactions on the AHB,
+        *      following the protocol.
+        *      * CSR control bits used by the AHB clock domain state
+        *      machines are cleared.
+        *      * To clear this interrupt, status mask bits that control the
+        *      interrupt status and are generated by the AHB clock domain
+        *      state machine are cleared.
+        *      * Because interrupt status bits are not cleared, the application
+        *      can get the status of any core events that occurred after it set
+        *      this bit.
+        *      This is a self-clearing bit that the core clears after all necessary
+        *      logic is reset in the core. This may take several clocks,
+        *      depending on the core's current state.
+        * @csftrst: Core Soft Reset (CSftRst)
+        *      Resets the hclk and phy_clock domains as follows:
+        *      * Clears the interrupts and all the CSR registers except the
+        *      following register bits:
+        *      - PCGCCTL.RstPdwnModule
+        *      - PCGCCTL.GateHclk
+        *      - PCGCCTL.PwrClmp
+        *      - PCGCCTL.StopPPhyLPwrClkSelclk
+        *      - GUSBCFG.PhyLPwrClkSel
+        *      - GUSBCFG.DDRSel
+        *      - GUSBCFG.PHYSel
+        *      - GUSBCFG.FSIntf
+        *      - GUSBCFG.ULPI_UTMI_Sel
+        *      - GUSBCFG.PHYIf
+        *      - HCFG.FSLSPclkSel
+        *      - DCFG.DevSpd
+        *      * All module state machines (except the AHB Slave Unit) are
+        *      reset to the IDLE state, and all the transmit FIFOs and the
+        *      receive FIFO are flushed.
+        *      * Any transactions on the AHB Master are terminated as soon
+        *      as possible, after gracefully completing the last data phase of
+        *      an AHB transfer. Any transactions on the USB are terminated
+        *      immediately.
+        *      The application can write to this bit any time it wants to reset
+        *      the core. This is a self-clearing bit and the core clears this bit
+        *      after all the necessary logic is reset in the core, which may take
+        *      several clocks, depending on the current state of the core.
+        *      Once this bit is cleared software should wait at least 3 PHY
+        *      clocks before doing any access to the PHY domain
+        *      (synchronization delay). Software should also should check that
+        *      bit 31 of this register is 1 (AHB Master is IDLE) before starting
+        *      any operation.
+        *      Typically software reset is used during software development
+        *      and also when you dynamically change the PHY selection bits
+        *      in the USB configuration registers listed above. When you
+        *      change the PHY, the corresponding clock for the PHY is
+        *      selected and used in the PHY domain. Once a new clock is
+        *      selected, the PHY domain has to be reset for proper operation.
+        */
        struct cvmx_usbcx_grstctl_s {
-               uint32_t ahbidle        : 1;        /**< AHB Master Idle (AHBIdle)
-                                                         Indicates that the AHB Master State Machine is in the IDLE
-                                                         condition. */
-               uint32_t dmareq         : 1;        /**< DMA Request Signal (DMAReq)
-                                                         Indicates that the DMA request is in progress. Used for debug. */
+               uint32_t ahbidle        : 1;
+               uint32_t dmareq         : 1;
                uint32_t reserved_11_29 : 19;
-               uint32_t txfnum         : 5;        /**< TxFIFO Number (TxFNum)
-                                                         This is the FIFO number that must be flushed using the TxFIFO
-                                                         Flush bit. This field must not be changed until the core clears
-                                                         the TxFIFO Flush bit.
-                                                         * 5'h0: Non-Periodic TxFIFO flush
-                                                         * 5'h1: Periodic TxFIFO 1 flush in Device mode or Periodic
-                                                         TxFIFO flush in Host mode
-                                                         * 5'h2: Periodic TxFIFO 2 flush in Device mode
-                                                         - ...
-                                                         * 5'hF: Periodic TxFIFO 15 flush in Device mode
-                                                         * 5'h10: Flush all the Periodic and Non-Periodic TxFIFOs in the
-                                                         core */
-               uint32_t txfflsh        : 1;        /**< TxFIFO Flush (TxFFlsh)
-                                                         This bit selectively flushes a single or all transmit FIFOs, but
-                                                         cannot do so if the core is in the midst of a transaction.
-                                                         The application must only write this bit after checking that the
-                                                         core is neither writing to the TxFIFO nor reading from the
-                                                         TxFIFO.
-                                                         The application must wait until the core clears this bit before
-                                                         performing any operations. This bit takes 8 clocks (of phy_clk or
-                                                         hclk, whichever is slower) to clear. */
-               uint32_t rxfflsh        : 1;        /**< RxFIFO Flush (RxFFlsh)
-                                                         The application can flush the entire RxFIFO using this bit, but
-                                                         must first ensure that the core is not in the middle of a
-                                                         transaction.
-                                                         The application must only write to this bit after checking that the
-                                                         core is neither reading from the RxFIFO nor writing to the
-                                                         RxFIFO.
-                                                         The application must wait until the bit is cleared before
-                                                         performing any other operations. This bit will take 8 clocks
-                                                         (slowest of PHY or AHB clock) to clear. */
-               uint32_t intknqflsh     : 1;        /**< IN Token Sequence Learning Queue Flush (INTknQFlsh)
-                                                         The application writes this bit to flush the IN Token Sequence
-                                                         Learning Queue. */
-               uint32_t frmcntrrst     : 1;        /**< Host Frame Counter Reset (FrmCntrRst)
-                                                         The application writes this bit to reset the (micro)frame number
-                                                         counter inside the core. When the (micro)frame counter is reset,
-                                                         the subsequent SOF sent out by the core will have a
-                                                         (micro)frame number of 0. */
-               uint32_t hsftrst        : 1;        /**< HClk Soft Reset (HSftRst)
-                                                         The application uses this bit to flush the control logic in the AHB
-                                                         Clock domain. Only AHB Clock Domain pipelines are reset.
-                                                         * FIFOs are not flushed with this bit.
-                                                         * All state machines in the AHB clock domain are reset to the
-                                                           Idle state after terminating the transactions on the AHB,
-                                                           following the protocol.
-                                                         * CSR control bits used by the AHB clock domain state
-                                                           machines are cleared.
-                                                         * To clear this interrupt, status mask bits that control the
-                                                           interrupt status and are generated by the AHB clock domain
-                                                           state machine are cleared.
-                                                         * Because interrupt status bits are not cleared, the application
-                                                           can get the status of any core events that occurred after it set
-                                                           this bit.
-                                                           This is a self-clearing bit that the core clears after all necessary
-                                                           logic is reset in the core. This may take several clocks,
-                                                           depending on the core's current state. */
-               uint32_t csftrst        : 1;        /**< Core Soft Reset (CSftRst)
-                                                         Resets the hclk and phy_clock domains as follows:
-                                                         * Clears the interrupts and all the CSR registers except the
-                                                           following register bits:
-                                                           - PCGCCTL.RstPdwnModule
-                                                           - PCGCCTL.GateHclk
-                                                           - PCGCCTL.PwrClmp
-                                                           - PCGCCTL.StopPPhyLPwrClkSelclk
-                                                           - GUSBCFG.PhyLPwrClkSel
-                                                           - GUSBCFG.DDRSel
-                                                           - GUSBCFG.PHYSel
-                                                           - GUSBCFG.FSIntf
-                                                           - GUSBCFG.ULPI_UTMI_Sel
-                                                           - GUSBCFG.PHYIf
-                                                           - HCFG.FSLSPclkSel
-                                                           - DCFG.DevSpd
-                                                         * All module state machines (except the AHB Slave Unit) are
-                                                           reset to the IDLE state, and all the transmit FIFOs and the
-                                                           receive FIFO are flushed.
-                                                         * Any transactions on the AHB Master are terminated as soon
-                                                           as possible, after gracefully completing the last data phase of
-                                                           an AHB transfer. Any transactions on the USB are terminated
-                                                           immediately.
-                                                           The application can write to this bit any time it wants to reset
-                                                           the core. This is a self-clearing bit and the core clears this bit
-                                                           after all the necessary logic is reset in the core, which may take
-                                                           several clocks, depending on the current state of the core.
-                                                           Once this bit is cleared software should wait at least 3 PHY
-                                                           clocks before doing any access to the PHY domain
-                                                           (synchronization delay). Software should also should check that
-                                                           bit 31 of this register is 1 (AHB Master is IDLE) before starting
-                                                           any operation.
-                                                           Typically software reset is used during software development
-                                                           and also when you dynamically change the PHY selection bits
-                                                           in the USB configuration registers listed above. When you
-                                                           change the PHY, the corresponding clock for the PHY is
-                                                           selected and used in the PHY domain. Once a new clock is
-                                                           selected, the PHY domain has to be reset for proper operation. */
+               uint32_t txfnum         : 5;
+               uint32_t txfflsh        : 1;
+               uint32_t rxfflsh        : 1;
+               uint32_t intknqflsh     : 1;
+               uint32_t frmcntrrst     : 1;
+               uint32_t hsftrst        : 1;
+               uint32_t csftrst        : 1;
        } s;
 };
 typedef union cvmx_usbcx_grstctl cvmx_usbcx_grstctl_t;
@@ -655,12 +761,16 @@ typedef union cvmx_usbcx_grstctl cvmx_usbcx_grstctl_t;
  */
 union cvmx_usbcx_grxfsiz {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_grxfsiz_s
+        * @rxfdep: RxFIFO Depth (RxFDep)
+        *      This value is in terms of 32-bit words.
+        *      * Minimum value is 16
+        *      * Maximum value is 32768
+        */
        struct cvmx_usbcx_grxfsiz_s {
                uint32_t reserved_16_31 : 16;
-               uint32_t rxfdep         : 16;       /**< RxFIFO Depth (RxFDep)
-                                                         This value is in terms of 32-bit words.
-                                                         * Minimum value is 16
-                                                         * Maximum value is 32768 */
+               uint32_t rxfdep         : 16;
        } s;
 };
 typedef union cvmx_usbcx_grxfsiz cvmx_usbcx_grxfsiz_t;
@@ -678,25 +788,32 @@ typedef union cvmx_usbcx_grxfsiz cvmx_usbcx_grxfsiz_t;
  */
 union cvmx_usbcx_grxstsph {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_grxstsph_s
+        * @pktsts: Packet Status (PktSts)
+        *      Indicates the status of the received packet
+        *      * 4'b0010: IN data packet received
+        *      * 4'b0011: IN transfer completed (triggers an interrupt)
+        *      * 4'b0101: Data toggle error (triggers an interrupt)
+        *      * 4'b0111: Channel halted (triggers an interrupt)
+        *      * Others: Reserved
+        * @dpid: Data PID (DPID)
+        *      * 2'b00: DATA0
+        *      * 2'b10: DATA1
+        *      * 2'b01: DATA2
+        *      * 2'b11: MDATA
+        * @bcnt: Byte Count (BCnt)
+        *      Indicates the byte count of the received IN data packet
+        * @chnum: Channel Number (ChNum)
+        *      Indicates the channel number to which the current received
+        *      packet belongs.
+        */
        struct cvmx_usbcx_grxstsph_s {
                uint32_t reserved_21_31 : 11;
-               uint32_t pktsts         : 4;        /**< Packet Status (PktSts)
-                                                         Indicates the status of the received packet
-                                                         * 4'b0010: IN data packet received
-                                                         * 4'b0011: IN transfer completed (triggers an interrupt)
-                                                         * 4'b0101: Data toggle error (triggers an interrupt)
-                                                         * 4'b0111: Channel halted (triggers an interrupt)
-                                                         * Others: Reserved */
-               uint32_t dpid           : 2;        /**< Data PID (DPID)
-                                                         * 2'b00: DATA0
-                                                         * 2'b10: DATA1
-                                                         * 2'b01: DATA2
-                                                         * 2'b11: MDATA */
-               uint32_t bcnt           : 11;       /**< Byte Count (BCnt)
-                                                         Indicates the byte count of the received IN data packet */
-               uint32_t chnum          : 4;        /**< Channel Number (ChNum)
-                                                         Indicates the channel number to which the current received
-                                                         packet belongs. */
+               uint32_t pktsts         : 4;
+               uint32_t dpid           : 2;
+               uint32_t bcnt           : 11;
+               uint32_t chnum          : 4;
        } s;
 };
 typedef union cvmx_usbcx_grxstsph cvmx_usbcx_grxstsph_t;
@@ -713,63 +830,77 @@ typedef union cvmx_usbcx_grxstsph cvmx_usbcx_grxstsph_t;
  */
 union cvmx_usbcx_gusbcfg {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_gusbcfg_s
+        * @otgi2csel: UTMIFS or I2C Interface Select (OtgI2CSel)
+        *      This bit is always 0x0.
+        * @phylpwrclksel: PHY Low-Power Clock Select (PhyLPwrClkSel)
+        *      Software should set this bit to 0x0.
+        *      Selects either 480-MHz or 48-MHz (low-power) PHY mode. In
+        *      FS and LS modes, the PHY can usually operate on a 48-MHz
+        *      clock to save power.
+        *      * 1'b0: 480-MHz Internal PLL clock
+        *      * 1'b1: 48-MHz External Clock
+        *      In 480 MHz mode, the UTMI interface operates at either 60 or
+        *      30-MHz, depending upon whether 8- or 16-bit data width is
+        *      selected. In 48-MHz mode, the UTMI interface operates at 48
+        *      MHz in FS mode and at either 48 or 6 MHz in LS mode
+        *      (depending on the PHY vendor).
+        *      This bit drives the utmi_fsls_low_power core output signal, and
+        *      is valid only for UTMI+ PHYs.
+        * @usbtrdtim: USB Turnaround Time (USBTrdTim)
+        *      Sets the turnaround time in PHY clocks.
+        *      Specifies the response time for a MAC request to the Packet
+        *      FIFO Controller (PFC) to fetch data from the DFIFO (SPRAM).
+        *      This must be programmed to 0x5.
+        * @hnpcap: HNP-Capable (HNPCap)
+        *      This bit is always 0x0.
+        * @srpcap: SRP-Capable (SRPCap)
+        *      This bit is always 0x0.
+        * @ddrsel: ULPI DDR Select (DDRSel)
+        *      Software should set this bit to 0x0.
+        * @physel: USB 2.0 High-Speed PHY or USB 1.1 Full-Speed Serial
+        *      Software should set this bit to 0x0.
+        * @fsintf: Full-Speed Serial Interface Select (FSIntf)
+        *      Software should set this bit to 0x0.
+        * @ulpi_utmi_sel: ULPI or UTMI+ Select (ULPI_UTMI_Sel)
+        *      This bit is always 0x0.
+        * @phyif: PHY Interface (PHYIf)
+        *      This bit is always 0x1.
+        * @toutcal: HS/FS Timeout Calibration (TOutCal)
+        *      The number of PHY clocks that the application programs in this
+        *      field is added to the high-speed/full-speed interpacket timeout
+        *      duration in the core to account for any additional delays
+        *      introduced by the PHY. This may be required, since the delay
+        *      introduced by the PHY in generating the linestate condition may
+        *      vary from one PHY to another.
+        *      The USB standard timeout value for high-speed operation is
+        *      736 to 816 (inclusive) bit times. The USB standard timeout
+        *      value for full-speed operation is 16 to 18 (inclusive) bit times.
+        *      The application must program this field based on the speed of
+        *      enumeration. The number of bit times added per PHY clock are:
+        *      High-speed operation:
+        *      * One 30-MHz PHY clock = 16 bit times
+        *      * One 60-MHz PHY clock = 8 bit times
+        *      Full-speed operation:
+        *      * One 30-MHz PHY clock = 0.4 bit times
+        *      * One 60-MHz PHY clock = 0.2 bit times
+        *      * One 48-MHz PHY clock = 0.25 bit times
+        */
        struct cvmx_usbcx_gusbcfg_s {
                uint32_t reserved_17_31 : 15;
-               uint32_t otgi2csel      : 1;    /**< UTMIFS or I2C Interface Select (OtgI2CSel)
-                                                         This bit is always 0x0. */
-               uint32_t phylpwrclksel  : 1;    /**< PHY Low-Power Clock Select (PhyLPwrClkSel)
-                                                         Software should set this bit to 0x0.
-                                                         Selects either 480-MHz or 48-MHz (low-power) PHY mode. In
-                                                         FS and LS modes, the PHY can usually operate on a 48-MHz
-                                                         clock to save power.
-                                                         * 1'b0: 480-MHz Internal PLL clock
-                                                         * 1'b1: 48-MHz External Clock
-                                                         In 480 MHz mode, the UTMI interface operates at either 60 or
-                                                         30-MHz, depending upon whether 8- or 16-bit data width is
-                                                         selected. In 48-MHz mode, the UTMI interface operates at 48
-                                                         MHz in FS mode and at either 48 or 6 MHz in LS mode
-                                                         (depending on the PHY vendor).
-                                                         This bit drives the utmi_fsls_low_power core output signal, and
-                                                         is valid only for UTMI+ PHYs. */
+               uint32_t otgi2csel      : 1;
+               uint32_t phylpwrclksel  : 1;
                uint32_t reserved_14_14 : 1;
-               uint32_t usbtrdtim      : 4;        /**< USB Turnaround Time (USBTrdTim)
-                                                         Sets the turnaround time in PHY clocks.
-                                                         Specifies the response time for a MAC request to the Packet
-                                                         FIFO Controller (PFC) to fetch data from the DFIFO (SPRAM).
-                                                         This must be programmed to 0x5. */
-               uint32_t hnpcap         : 1;        /**< HNP-Capable (HNPCap)
-                                                         This bit is always 0x0. */
-               uint32_t srpcap         : 1;        /**< SRP-Capable (SRPCap)
-                                                         This bit is always 0x0. */
-               uint32_t ddrsel         : 1;        /**< ULPI DDR Select (DDRSel)
-                                                         Software should set this bit to 0x0. */
-               uint32_t physel         : 1;        /**< USB 2.0 High-Speed PHY or USB 1.1 Full-Speed Serial
-                                                         Software should set this bit to 0x0. */
-               uint32_t fsintf         : 1;        /**< Full-Speed Serial Interface Select (FSIntf)
-                                                         Software should set this bit to 0x0. */
-               uint32_t ulpi_utmi_sel  : 1;    /**< ULPI or UTMI+ Select (ULPI_UTMI_Sel)
-                                                         This bit is always 0x0. */
-               uint32_t phyif          : 1;        /**< PHY Interface (PHYIf)
-                                                         This bit is always 0x1. */
-               uint32_t toutcal        : 3;        /**< HS/FS Timeout Calibration (TOutCal)
-                                                         The number of PHY clocks that the application programs in this
-                                                         field is added to the high-speed/full-speed interpacket timeout
-                                                         duration in the core to account for any additional delays
-                                                         introduced by the PHY. This may be required, since the delay
-                                                         introduced by the PHY in generating the linestate condition may
-                                                         vary from one PHY to another.
-                                                         The USB standard timeout value for high-speed operation is
-                                                         736 to 816 (inclusive) bit times. The USB standard timeout
-                                                         value for full-speed operation is 16 to 18 (inclusive) bit times.
-                                                         The application must program this field based on the speed of
-                                                         enumeration. The number of bit times added per PHY clock are:
-                                                         High-speed operation:
-                                                         * One 30-MHz PHY clock = 16 bit times
-                                                         * One 60-MHz PHY clock = 8 bit times
-                                                         Full-speed operation:
-                                                         * One 30-MHz PHY clock = 0.4 bit times
-                                                         * One 60-MHz PHY clock = 0.2 bit times
-                                                         * One 48-MHz PHY clock = 0.25 bit times */
+               uint32_t usbtrdtim      : 4;
+               uint32_t hnpcap         : 1;
+               uint32_t srpcap         : 1;
+               uint32_t ddrsel         : 1;
+               uint32_t physel         : 1;
+               uint32_t fsintf         : 1;
+               uint32_t ulpi_utmi_sel  : 1;
+               uint32_t phyif          : 1;
+               uint32_t toutcal        : 3;
        } s;
 };
 typedef union cvmx_usbcx_gusbcfg cvmx_usbcx_gusbcfg_t;
@@ -787,10 +918,14 @@ typedef union cvmx_usbcx_gusbcfg cvmx_usbcx_gusbcfg_t;
  */
 union cvmx_usbcx_haint {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_haint_s
+        * @haint: Channel Interrupts (HAINT)
+        *      One bit per channel: Bit 0 for Channel 0, bit 15 for Channel 15
+        */
        struct cvmx_usbcx_haint_s {
                uint32_t reserved_16_31 : 16;
-               uint32_t haint          : 16;       /**< Channel Interrupts (HAINT)
-                                                         One bit per channel: Bit 0 for Channel 0, bit 15 for Channel 15 */
+               uint32_t haint          : 16;
        } s;
 };
 typedef union cvmx_usbcx_haint cvmx_usbcx_haint_t;
@@ -807,10 +942,14 @@ typedef union cvmx_usbcx_haint cvmx_usbcx_haint_t;
  */
 union cvmx_usbcx_haintmsk {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_haintmsk_s
+        * @haintmsk: Channel Interrupt Mask (HAINTMsk)
+        *      One bit per channel: Bit 0 for channel 0, bit 15 for channel 15
+        */
        struct cvmx_usbcx_haintmsk_s {
                uint32_t reserved_16_31 : 16;
-               uint32_t haintmsk       : 16;       /**< Channel Interrupt Mask (HAINTMsk)
-                                                         One bit per channel: Bit 0 for channel 0, bit 15 for channel 15 */
+               uint32_t haintmsk       : 16;
        } s;
 };
 typedef union cvmx_usbcx_haintmsk cvmx_usbcx_haintmsk_t;
@@ -823,60 +962,73 @@ typedef union cvmx_usbcx_haintmsk cvmx_usbcx_haintmsk_t;
  */
 union cvmx_usbcx_hccharx {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hccharx_s
+        * @chena: Channel Enable (ChEna)
+        *      This field is set by the application and cleared by the OTG host.
+        *      * 1'b0: Channel disabled
+        *      * 1'b1: Channel enabled
+        * @chdis: Channel Disable (ChDis)
+        *      The application sets this bit to stop transmitting/receiving data
+        *      on a channel, even before the transfer for that channel is
+        *      complete. The application must wait for the Channel Disabled
+        *      interrupt before treating the channel as disabled.
+        * @oddfrm: Odd Frame (OddFrm)
+        *      This field is set (reset) by the application to indicate that the
+        *      OTG host must perform a transfer in an odd (micro)frame. This
+        *      field is applicable for only periodic (isochronous and interrupt)
+        *      transactions.
+        *      * 1'b0: Even (micro)frame
+        *      * 1'b1: Odd (micro)frame
+        * @devaddr: Device Address (DevAddr)
+        *      This field selects the specific device serving as the data source
+        *      or sink.
+        * @ec: Multi Count (MC) / Error Count (EC)
+        *      When the Split Enable bit of the Host Channel-n Split Control
+        *      register (HCSPLTn.SpltEna) is reset (1'b0), this field indicates
+        *      to the host the number of transactions that should be executed
+        *      per microframe for this endpoint.
+        *      * 2'b00: Reserved. This field yields undefined results.
+        *      * 2'b01: 1 transaction
+        *      * 2'b10: 2 transactions to be issued for this endpoint per
+        *      microframe
+        *      * 2'b11: 3 transactions to be issued for this endpoint per
+        *      microframe
+        *      When HCSPLTn.SpltEna is set (1'b1), this field indicates the
+        *      number of immediate retries to be performed for a periodic split
+        *      transactions on transaction errors. This field must be set to at
+        *      least 2'b01.
+        * @eptype: Endpoint Type (EPType)
+        *      Indicates the transfer type selected.
+        *      * 2'b00: Control
+        *      * 2'b01: Isochronous
+        *      * 2'b10: Bulk
+        *      * 2'b11: Interrupt
+        * @lspddev: Low-Speed Device (LSpdDev)
+        *      This field is set by the application to indicate that this channel is
+        *      communicating to a low-speed device.
+        * @epdir: Endpoint Direction (EPDir)
+        *      Indicates whether the transaction is IN or OUT.
+        *      * 1'b0: OUT
+        *      * 1'b1: IN
+        * @epnum: Endpoint Number (EPNum)
+        *      Indicates the endpoint number on the device serving as the
+        *      data source or sink.
+        * @mps: Maximum Packet Size (MPS)
+        *      Indicates the maximum packet size of the associated endpoint.
+        */
        struct cvmx_usbcx_hccharx_s {
-               uint32_t chena          : 1;        /**< Channel Enable (ChEna)
-                                                         This field is set by the application and cleared by the OTG host.
-                                                         * 1'b0: Channel disabled
-                                                         * 1'b1: Channel enabled */
-               uint32_t chdis          : 1;        /**< Channel Disable (ChDis)
-                                                         The application sets this bit to stop transmitting/receiving data
-                                                         on a channel, even before the transfer for that channel is
-                                                         complete. The application must wait for the Channel Disabled
-                                                         interrupt before treating the channel as disabled. */
-               uint32_t oddfrm         : 1;        /**< Odd Frame (OddFrm)
-                                                         This field is set (reset) by the application to indicate that the
-                                                         OTG host must perform a transfer in an odd (micro)frame. This
-                                                         field is applicable for only periodic (isochronous and interrupt)
-                                                         transactions.
-                                                         * 1'b0: Even (micro)frame
-                                                         * 1'b1: Odd (micro)frame */
-               uint32_t devaddr        : 7;        /**< Device Address (DevAddr)
-                                                         This field selects the specific device serving as the data source
-                                                         or sink. */
-               uint32_t ec             : 2;        /**< Multi Count (MC) / Error Count (EC)
-                                                         When the Split Enable bit of the Host Channel-n Split Control
-                                                         register (HCSPLTn.SpltEna) is reset (1'b0), this field indicates
-                                                         to the host the number of transactions that should be executed
-                                                         per microframe for this endpoint.
-                                                         * 2'b00: Reserved. This field yields undefined results.
-                                                         * 2'b01: 1 transaction
-                                                         * 2'b10: 2 transactions to be issued for this endpoint per
-                                                                  microframe
-                                                         * 2'b11: 3 transactions to be issued for this endpoint per
-                                                                  microframe
-                                                         When HCSPLTn.SpltEna is set (1'b1), this field indicates the
-                                                         number of immediate retries to be performed for a periodic split
-                                                         transactions on transaction errors. This field must be set to at
-                                                         least 2'b01. */
-               uint32_t eptype         : 2;        /**< Endpoint Type (EPType)
-                                                         Indicates the transfer type selected.
-                                                         * 2'b00: Control
-                                                         * 2'b01: Isochronous
-                                                         * 2'b10: Bulk
-                                                         * 2'b11: Interrupt */
-               uint32_t lspddev        : 1;        /**< Low-Speed Device (LSpdDev)
-                                                         This field is set by the application to indicate that this channel is
-                                                         communicating to a low-speed device. */
+               uint32_t chena          : 1;
+               uint32_t chdis          : 1;
+               uint32_t oddfrm         : 1;
+               uint32_t devaddr        : 7;
+               uint32_t ec             : 2;
+               uint32_t eptype         : 2;
+               uint32_t lspddev        : 1;
                uint32_t reserved_16_16 : 1;
-               uint32_t epdir          : 1;        /**< Endpoint Direction (EPDir)
-                                                         Indicates whether the transaction is IN or OUT.
-                                                         * 1'b0: OUT
-                                                         * 1'b1: IN */
-               uint32_t epnum          : 4;        /**< Endpoint Number (EPNum)
-                                                         Indicates the endpoint number on the device serving as the
-                                                         data source or sink. */
-               uint32_t mps            : 11;       /**< Maximum Packet Size (MPS)
-                                                         Indicates the maximum packet size of the associated endpoint. */
+               uint32_t epdir          : 1;
+               uint32_t epnum          : 4;
+               uint32_t mps            : 11;
        } s;
 };
 typedef union cvmx_usbcx_hccharx cvmx_usbcx_hccharx_t;
@@ -890,35 +1042,40 @@ typedef union cvmx_usbcx_hccharx cvmx_usbcx_hccharx_t;
  */
 union cvmx_usbcx_hcfg {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hcfg_s
+        * @fslssupp: FS- and LS-Only Support (FSLSSupp)
+        *      The application uses this bit to control the core's enumeration
+        *      speed. Using this bit, the application can make the core
+        *      enumerate as a FS host, even if the connected device supports
+        *      HS traffic. Do not make changes to this field after initial
+        *      programming.
+        *      * 1'b0: HS/FS/LS, based on the maximum speed supported by
+        *      the connected device
+        *      * 1'b1: FS/LS-only, even if the connected device can support HS
+        * @fslspclksel: FS/LS PHY Clock Select (FSLSPclkSel)
+        *      When the core is in FS Host mode
+        *      * 2'b00: PHY clock is running at 30/60 MHz
+        *      * 2'b01: PHY clock is running at 48 MHz
+        *      * Others: Reserved
+        *      When the core is in LS Host mode
+        *      * 2'b00: PHY clock is running at 30/60 MHz. When the
+        *      UTMI+/ULPI PHY Low Power mode is not selected, use
+        *      30/60 MHz.
+        *      * 2'b01: PHY clock is running at 48 MHz. When the UTMI+
+        *      PHY Low Power mode is selected, use 48MHz if the PHY
+        *      supplies a 48 MHz clock during LS mode.
+        *      * 2'b10: PHY clock is running at 6 MHz. In USB 1.1 FS mode,
+        *      use 6 MHz when the UTMI+ PHY Low Power mode is
+        *      selected and the PHY supplies a 6 MHz clock during LS
+        *      mode. If you select a 6 MHz clock during LS mode, you must
+        *      do a soft reset.
+        *      * 2'b11: Reserved
+        */
        struct cvmx_usbcx_hcfg_s {
                uint32_t reserved_3_31  : 29;
-               uint32_t fslssupp       : 1;        /**< FS- and LS-Only Support (FSLSSupp)
-                                                         The application uses this bit to control the core's enumeration
-                                                         speed. Using this bit, the application can make the core
-                                                         enumerate as a FS host, even if the connected device supports
-                                                         HS traffic. Do not make changes to this field after initial
-                                                         programming.
-                                                         * 1'b0: HS/FS/LS, based on the maximum speed supported by
-                                                           the connected device
-                                                         * 1'b1: FS/LS-only, even if the connected device can support HS */
-               uint32_t fslspclksel    : 2;        /**< FS/LS PHY Clock Select (FSLSPclkSel)
-                                                         When the core is in FS Host mode
-                                                         * 2'b00: PHY clock is running at 30/60 MHz
-                                                         * 2'b01: PHY clock is running at 48 MHz
-                                                         * Others: Reserved
-                                                         When the core is in LS Host mode
-                                                         * 2'b00: PHY clock is running at 30/60 MHz. When the
-                                                                  UTMI+/ULPI PHY Low Power mode is not selected, use
-                                                                  30/60 MHz.
-                                                         * 2'b01: PHY clock is running at 48 MHz. When the UTMI+
-                                                                  PHY Low Power mode is selected, use 48MHz if the PHY
-                                                                  supplies a 48 MHz clock during LS mode.
-                                                         * 2'b10: PHY clock is running at 6 MHz. In USB 1.1 FS mode,
-                                                                  use 6 MHz when the UTMI+ PHY Low Power mode is
-                                                                  selected and the PHY supplies a 6 MHz clock during LS
-                                                                  mode. If you select a 6 MHz clock during LS mode, you must
-                                                                  do a soft reset.
-                                                         * 2'b11: Reserved */
+               uint32_t fslssupp       : 1;
+               uint32_t fslspclksel    : 2;
        } s;
 };
 typedef union cvmx_usbcx_hcfg cvmx_usbcx_hcfg_t;
@@ -937,23 +1094,37 @@ typedef union cvmx_usbcx_hcfg cvmx_usbcx_hcfg_t;
  */
 union cvmx_usbcx_hcintx {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hcintx_s
+        * @datatglerr: Data Toggle Error (DataTglErr)
+        * @frmovrun: Frame Overrun (FrmOvrun)
+        * @bblerr: Babble Error (BblErr)
+        * @xacterr: Transaction Error (XactErr)
+        * @nyet: NYET Response Received Interrupt (NYET)
+        * @ack: ACK Response Received Interrupt (ACK)
+        * @nak: NAK Response Received Interrupt (NAK)
+        * @stall: STALL Response Received Interrupt (STALL)
+        * @ahberr: This bit is always 0x0.
+        * @chhltd: Channel Halted (ChHltd)
+        *      Indicates the transfer completed abnormally either because of
+        *      any USB transaction error or in response to disable request by
+        *      the application.
+        * @xfercompl: Transfer Completed (XferCompl)
+        *      Transfer completed normally without any errors.
+        */
        struct cvmx_usbcx_hcintx_s {
                uint32_t reserved_11_31 : 21;
-               uint32_t datatglerr     : 1;        /**< Data Toggle Error (DataTglErr) */
-               uint32_t frmovrun       : 1;        /**< Frame Overrun (FrmOvrun) */
-               uint32_t bblerr         : 1;        /**< Babble Error (BblErr) */
-               uint32_t xacterr        : 1;        /**< Transaction Error (XactErr) */
-               uint32_t nyet           : 1;        /**< NYET Response Received Interrupt (NYET) */
-               uint32_t ack            : 1;        /**< ACK Response Received Interrupt (ACK) */
-               uint32_t nak            : 1;        /**< NAK Response Received Interrupt (NAK) */
-               uint32_t stall          : 1;        /**< STALL Response Received Interrupt (STALL) */
-               uint32_t ahberr         : 1;        /**< This bit is always 0x0. */
-               uint32_t chhltd         : 1;        /**< Channel Halted (ChHltd)
-                                                         Indicates the transfer completed abnormally either because of
-                                                         any USB transaction error or in response to disable request by
-                                                         the application. */
-               uint32_t xfercompl      : 1;        /**< Transfer Completed (XferCompl)
-                                                         Transfer completed normally without any errors. */
+               uint32_t datatglerr     : 1;
+               uint32_t frmovrun       : 1;
+               uint32_t bblerr         : 1;
+               uint32_t xacterr        : 1;
+               uint32_t nyet           : 1;
+               uint32_t ack            : 1;
+               uint32_t nak            : 1;
+               uint32_t stall          : 1;
+               uint32_t ahberr         : 1;
+               uint32_t chhltd         : 1;
+               uint32_t xfercompl      : 1;
        } s;
 };
 typedef union cvmx_usbcx_hcintx cvmx_usbcx_hcintx_t;
@@ -968,19 +1139,33 @@ typedef union cvmx_usbcx_hcintx cvmx_usbcx_hcintx_t;
  */
 union cvmx_usbcx_hcintmskx {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hcintmskx_s
+        * @datatglerrmsk: Data Toggle Error Mask (DataTglErrMsk)
+        * @frmovrunmsk: Frame Overrun Mask (FrmOvrunMsk)
+        * @bblerrmsk: Babble Error Mask (BblErrMsk)
+        * @xacterrmsk: Transaction Error Mask (XactErrMsk)
+        * @nyetmsk: NYET Response Received Interrupt Mask (NyetMsk)
+        * @ackmsk: ACK Response Received Interrupt Mask (AckMsk)
+        * @nakmsk: NAK Response Received Interrupt Mask (NakMsk)
+        * @stallmsk: STALL Response Received Interrupt Mask (StallMsk)
+        * @ahberrmsk: AHB Error Mask (AHBErrMsk)
+        * @chhltdmsk: Channel Halted Mask (ChHltdMsk)
+        * @xfercomplmsk: Transfer Completed Mask (XferComplMsk)
+        */
        struct cvmx_usbcx_hcintmskx_s {
                uint32_t reserved_11_31 : 21;
-               uint32_t datatglerrmsk  : 1;    /**< Data Toggle Error Mask (DataTglErrMsk) */
-               uint32_t frmovrunmsk    : 1;    /**< Frame Overrun Mask (FrmOvrunMsk) */
-               uint32_t bblerrmsk      : 1;    /**< Babble Error Mask (BblErrMsk) */
-               uint32_t xacterrmsk     : 1;    /**< Transaction Error Mask (XactErrMsk) */
-               uint32_t nyetmsk        : 1;    /**< NYET Response Received Interrupt Mask (NyetMsk) */
-               uint32_t ackmsk         : 1;    /**< ACK Response Received Interrupt Mask (AckMsk) */
-               uint32_t nakmsk         : 1;    /**< NAK Response Received Interrupt Mask (NakMsk) */
-               uint32_t stallmsk       : 1;    /**< STALL Response Received Interrupt Mask (StallMsk) */
-               uint32_t ahberrmsk      : 1;    /**< AHB Error Mask (AHBErrMsk) */
-               uint32_t chhltdmsk      : 1;    /**< Channel Halted Mask (ChHltdMsk) */
-               uint32_t xfercomplmsk   : 1;    /**< Transfer Completed Mask (XferComplMsk) */
+               uint32_t datatglerrmsk  : 1;
+               uint32_t frmovrunmsk    : 1;
+               uint32_t bblerrmsk      : 1;
+               uint32_t xacterrmsk     : 1;
+               uint32_t nyetmsk        : 1;
+               uint32_t ackmsk         : 1;
+               uint32_t nakmsk         : 1;
+               uint32_t stallmsk       : 1;
+               uint32_t ahberrmsk      : 1;
+               uint32_t chhltdmsk      : 1;
+               uint32_t xfercomplmsk   : 1;
        } s;
 };
 typedef union cvmx_usbcx_hcintmskx cvmx_usbcx_hcintmskx_t;
@@ -993,31 +1178,39 @@ typedef union cvmx_usbcx_hcintmskx cvmx_usbcx_hcintmskx_t;
  */
 union cvmx_usbcx_hcspltx {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hcspltx_s
+        * @spltena: Split Enable (SpltEna)
+        *      The application sets this field to indicate that this channel is
+        *      enabled to perform split transactions.
+        * @compsplt: Do Complete Split (CompSplt)
+        *      The application sets this field to request the OTG host to
+        *      perform a complete split transaction.
+        * @xactpos: Transaction Position (XactPos)
+        *      This field is used to determine whether to send all, first, middle,
+        *      or last payloads with each OUT transaction.
+        *      * 2'b11: All. This is the entire data payload is of this transaction
+        *      (which is less than or equal to 188 bytes).
+        *      * 2'b10: Begin. This is the first data payload of this transaction
+        *      (which is larger than 188 bytes).
+        *      * 2'b00: Mid. This is the middle payload of this transaction
+        *      (which is larger than 188 bytes).
+        *      * 2'b01: End. This is the last payload of this transaction (which
+        *      is larger than 188 bytes).
+        * @hubaddr: Hub Address (HubAddr)
+        *      This field holds the device address of the transaction
+        *      translator's hub.
+        * @prtaddr: Port Address (PrtAddr)
+        *      This field is the port number of the recipient transaction
+        *      translator.
+        */
        struct cvmx_usbcx_hcspltx_s {
-               uint32_t spltena        : 1;        /**< Split Enable (SpltEna)
-                                                         The application sets this field to indicate that this channel is
-                                                         enabled to perform split transactions. */
+               uint32_t spltena        : 1;
                uint32_t reserved_17_30 : 14;
-               uint32_t compsplt       : 1;        /**< Do Complete Split (CompSplt)
-                                                         The application sets this field to request the OTG host to
-                                                         perform a complete split transaction. */
-               uint32_t xactpos        : 2;        /**< Transaction Position (XactPos)
-                                                         This field is used to determine whether to send all, first, middle,
-                                                         or last payloads with each OUT transaction.
-                                                         * 2'b11: All. This is the entire data payload is of this transaction
-                                                                  (which is less than or equal to 188 bytes).
-                                                         * 2'b10: Begin. This is the first data payload of this transaction
-                                                                  (which is larger than 188 bytes).
-                                                         * 2'b00: Mid. This is the middle payload of this transaction
-                                                                  (which is larger than 188 bytes).
-                                                         * 2'b01: End. This is the last payload of this transaction (which
-                                                                  is larger than 188 bytes). */
-               uint32_t hubaddr        : 7;        /**< Hub Address (HubAddr)
-                                                         This field holds the device address of the transaction
-                                                         translator's hub. */
-               uint32_t prtaddr        : 7;        /**< Port Address (PrtAddr)
-                                                         This field is the port number of the recipient transaction
-                                                         translator. */
+               uint32_t compsplt       : 1;
+               uint32_t xactpos        : 2;
+               uint32_t hubaddr        : 7;
+               uint32_t prtaddr        : 7;
        } s;
 };
 typedef union cvmx_usbcx_hcspltx cvmx_usbcx_hcspltx_t;
@@ -1030,31 +1223,38 @@ typedef union cvmx_usbcx_hcspltx cvmx_usbcx_hcspltx_t;
  */
 union cvmx_usbcx_hctsizx {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hctsizx_s
+        * @dopng: Do Ping (DoPng)
+        *      Setting this field to 1 directs the host to do PING protocol.
+        * @pid: PID (Pid)
+        *      The application programs this field with the type of PID to use
+        *      for the initial transaction. The host will maintain this field for the
+        *      rest of the transfer.
+        *      * 2'b00: DATA0
+        *      * 2'b01: DATA2
+        *      * 2'b10: DATA1
+        *      * 2'b11: MDATA (non-control)/SETUP (control)
+        * @pktcnt: Packet Count (PktCnt)
+        *      This field is programmed by the application with the expected
+        *      number of packets to be transmitted (OUT) or received (IN).
+        *      The host decrements this count on every successful
+        *      transmission or reception of an OUT/IN packet. Once this count
+        *      reaches zero, the application is interrupted to indicate normal
+        *      completion.
+        * @xfersize: Transfer Size (XferSize)
+        *      For an OUT, this field is the number of data bytes the host will
+        *      send during the transfer.
+        *      For an IN, this field is the buffer size that the application has
+        *      reserved for the transfer. The application is expected to
+        *      program this field as an integer multiple of the maximum packet
+        *      size for IN transactions (periodic and non-periodic).
+        */
        struct cvmx_usbcx_hctsizx_s {
-               uint32_t dopng          : 1;        /**< Do Ping (DoPng)
-                                                         Setting this field to 1 directs the host to do PING protocol. */
-               uint32_t pid            : 2;        /**< PID (Pid)
-                                                         The application programs this field with the type of PID to use
-                                                         for the initial transaction. The host will maintain this field for the
-                                                         rest of the transfer.
-                                                         * 2'b00: DATA0
-                                                         * 2'b01: DATA2
-                                                         * 2'b10: DATA1
-                                                         * 2'b11: MDATA (non-control)/SETUP (control) */
-               uint32_t pktcnt         : 10;       /**< Packet Count (PktCnt)
-                                                         This field is programmed by the application with the expected
-                                                         number of packets to be transmitted (OUT) or received (IN).
-                                                         The host decrements this count on every successful
-                                                         transmission or reception of an OUT/IN packet. Once this count
-                                                         reaches zero, the application is interrupted to indicate normal
-                                                         completion. */
-               uint32_t xfersize       : 19;       /**< Transfer Size (XferSize)
-                                                         For an OUT, this field is the number of data bytes the host will
-                                                         send during the transfer.
-                                                         For an IN, this field is the buffer size that the application has
-                                                         reserved for the transfer. The application is expected to
-                                                         program this field as an integer multiple of the maximum packet
-                                                         size for IN transactions (periodic and non-periodic). */
+               uint32_t dopng          : 1;
+               uint32_t pid            : 2;
+               uint32_t pktcnt         : 10;
+               uint32_t xfersize       : 19;
        } s;
 };
 typedef union cvmx_usbcx_hctsizx cvmx_usbcx_hctsizx_t;
@@ -1068,24 +1268,28 @@ typedef union cvmx_usbcx_hctsizx cvmx_usbcx_hctsizx_t;
  */
 union cvmx_usbcx_hfir {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hfir_s
+        * @frint: Frame Interval (FrInt)
+        *      The value that the application programs to this field specifies
+        *      the interval between two consecutive SOFs (FS) or micro-
+        *      SOFs (HS) or Keep-Alive tokens (HS). This field contains the
+        *      number of PHY clocks that constitute the required frame
+        *      interval. The default value set in this field for a FS operation
+        *      when the PHY clock frequency is 60 MHz. The application can
+        *      write a value to this register only after the Port Enable bit of
+        *      the Host Port Control and Status register (HPRT.PrtEnaPort)
+        *      has been set. If no value is programmed, the core calculates
+        *      the value based on the PHY clock specified in the FS/LS PHY
+        *      Clock Select field of the Host Configuration register
+        *      (HCFG.FSLSPclkSel). Do not change the value of this field
+        *      after the initial configuration.
+        *      * 125 us (PHY clock frequency for HS)
+        *      * 1 ms (PHY clock frequency for FS/LS)
+        */
        struct cvmx_usbcx_hfir_s {
                uint32_t reserved_16_31 : 16;
-               uint32_t frint          : 16;       /**< Frame Interval (FrInt)
-                                                         The value that the application programs to this field specifies
-                                                         the interval between two consecutive SOFs (FS) or micro-
-                                                         SOFs (HS) or Keep-Alive tokens (HS). This field contains the
-                                                         number of PHY clocks that constitute the required frame
-                                                         interval. The default value set in this field for a FS operation
-                                                         when the PHY clock frequency is 60 MHz. The application can
-                                                         write a value to this register only after the Port Enable bit of
-                                                         the Host Port Control and Status register (HPRT.PrtEnaPort)
-                                                         has been set. If no value is programmed, the core calculates
-                                                         the value based on the PHY clock specified in the FS/LS PHY
-                                                         Clock Select field of the Host Configuration register
-                                                         (HCFG.FSLSPclkSel). Do not change the value of this field
-                                                         after the initial configuration.
-                                                         * 125 us (PHY clock frequency for HS)
-                                                         * 1 ms (PHY clock frequency for FS/LS) */
+               uint32_t frint          : 16;
        } s;
 };
 typedef union cvmx_usbcx_hfir cvmx_usbcx_hfir_t;
@@ -1101,16 +1305,21 @@ typedef union cvmx_usbcx_hfir cvmx_usbcx_hfir_t;
  */
 union cvmx_usbcx_hfnum {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hfnum_s
+        * @frrem: Frame Time Remaining (FrRem)
+        *      Indicates the amount of time remaining in the current
+        *      microframe (HS) or frame (FS/LS), in terms of PHY clocks.
+        *      This field decrements on each PHY clock. When it reaches
+        *      zero, this field is reloaded with the value in the Frame Interval
+        *      register and a new SOF is transmitted on the USB.
+        * @frnum: Frame Number (FrNum)
+        *      This field increments when a new SOF is transmitted on the
+        *      USB, and is reset to 0 when it reaches 16'h3FFF.
+        */
        struct cvmx_usbcx_hfnum_s {
-               uint32_t frrem  : 16;       /**< Frame Time Remaining (FrRem)
-                                                         Indicates the amount of time remaining in the current
-                                                         microframe (HS) or frame (FS/LS), in terms of PHY clocks.
-                                                         This field decrements on each PHY clock. When it reaches
-                                                         zero, this field is reloaded with the value in the Frame Interval
-                                                         register and a new SOF is transmitted on the USB. */
-               uint32_t frnum  : 16;       /**< Frame Number (FrNum)
-                                                         This field increments when a new SOF is transmitted on the
-                                                         USB, and is reset to 0 when it reaches 16'h3FFF. */
+               uint32_t frrem  : 16;
+               uint32_t frnum  : 16;
        } s;
 };
 typedef union cvmx_usbcx_hfnum cvmx_usbcx_hfnum_t;
@@ -1131,110 +1340,126 @@ typedef union cvmx_usbcx_hfnum cvmx_usbcx_hfnum_t;
  */
 union cvmx_usbcx_hprt {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hprt_s
+        * @prtspd: Port Speed (PrtSpd)
+        *      Indicates the speed of the device attached to this port.
+        *      * 2'b00: High speed
+        *      * 2'b01: Full speed
+        *      * 2'b10: Low speed
+        *      * 2'b11: Reserved
+        * @prttstctl: Port Test Control (PrtTstCtl)
+        *      The application writes a nonzero value to this field to put
+        *      the port into a Test mode, and the corresponding pattern is
+        *      signaled on the port.
+        *      * 4'b0000: Test mode disabled
+        *      * 4'b0001: Test_J mode
+        *      * 4'b0010: Test_K mode
+        *      * 4'b0011: Test_SE0_NAK mode
+        *      * 4'b0100: Test_Packet mode
+        *      * 4'b0101: Test_Force_Enable
+        *      * Others: Reserved
+        *      PrtSpd must be zero (i.e. the interface must be in high-speed
+        *      mode) to use the PrtTstCtl test modes.
+        * @prtpwr: Port Power (PrtPwr)
+        *      The application uses this field to control power to this port,
+        *      and the core clears this bit on an overcurrent condition.
+        *      * 1'b0: Power off
+        *      * 1'b1: Power on
+        * @prtlnsts: Port Line Status (PrtLnSts)
+        *      Indicates the current logic level USB data lines
+        *      * Bit [10]: Logic level of D-
+        *      * Bit [11]: Logic level of D+
+        * @prtrst: Port Reset (PrtRst)
+        *      When the application sets this bit, a reset sequence is
+        *      started on this port. The application must time the reset
+        *      period and clear this bit after the reset sequence is
+        *      complete.
+        *      * 1'b0: Port not in reset
+        *      * 1'b1: Port in reset
+        *      The application must leave this bit set for at least a
+        *      minimum duration mentioned below to start a reset on the
+        *      port. The application can leave it set for another 10 ms in
+        *      addition to the required minimum duration, before clearing
+        *      the bit, even though there is no maximum limit set by the
+        *      USB standard.
+        *      * High speed: 50 ms
+        *      * Full speed/Low speed: 10 ms
+        * @prtsusp: Port Suspend (PrtSusp)
+        *      The application sets this bit to put this port in Suspend
+        *      mode. The core only stops sending SOFs when this is set.
+        *      To stop the PHY clock, the application must set the Port
+        *      Clock Stop bit, which will assert the suspend input pin of
+        *      the PHY.
+        *      The read value of this bit reflects the current suspend
+        *      status of the port. This bit is cleared by the core after a
+        *      remote wakeup signal is detected or the application sets
+        *      the Port Reset bit or Port Resume bit in this register or the
+        *      Resume/Remote Wakeup Detected Interrupt bit or
+        *      Disconnect Detected Interrupt bit in the Core Interrupt
+        *      register (GINTSTS.WkUpInt or GINTSTS.DisconnInt,
+        *      respectively).
+        *      * 1'b0: Port not in Suspend mode
+        *      * 1'b1: Port in Suspend mode
+        * @prtres: Port Resume (PrtRes)
+        *      The application sets this bit to drive resume signaling on
+        *      the port. The core continues to drive the resume signal
+        *      until the application clears this bit.
+        *      If the core detects a USB remote wakeup sequence, as
+        *      indicated by the Port Resume/Remote Wakeup Detected
+        *      Interrupt bit of the Core Interrupt register
+        *      (GINTSTS.WkUpInt), the core starts driving resume
+        *      signaling without application intervention and clears this bit
+        *      when it detects a disconnect condition. The read value of
+        *      this bit indicates whether the core is currently driving
+        *      resume signaling.
+        *      * 1'b0: No resume driven
+        *      * 1'b1: Resume driven
+        * @prtovrcurrchng: Port Overcurrent Change (PrtOvrCurrChng)
+        *      The core sets this bit when the status of the Port
+        *      Overcurrent Active bit (bit 4) in this register changes.
+        * @prtovrcurract: Port Overcurrent Active (PrtOvrCurrAct)
+        *      Indicates the overcurrent condition of the port.
+        *      * 1'b0: No overcurrent condition
+        *      * 1'b1: Overcurrent condition
+        * @prtenchng: Port Enable/Disable Change (PrtEnChng)
+        *      The core sets this bit when the status of the Port Enable bit
+        *      [2] of this register changes.
+        * @prtena: Port Enable (PrtEna)
+        *      A port is enabled only by the core after a reset sequence,
+        *      and is disabled by an overcurrent condition, a disconnect
+        *      condition, or by the application clearing this bit. The
+        *      application cannot set this bit by a register write. It can only
+        *      clear it to disable the port. This bit does not trigger any
+        *      interrupt to the application.
+        *      * 1'b0: Port disabled
+        *      * 1'b1: Port enabled
+        * @prtconndet: Port Connect Detected (PrtConnDet)
+        *      The core sets this bit when a device connection is detected
+        *      to trigger an interrupt to the application using the Host Port
+        *      Interrupt bit of the Core Interrupt register (GINTSTS.PrtInt).
+        *      The application must write a 1 to this bit to clear the
+        *      interrupt.
+        * @prtconnsts: Port Connect Status (PrtConnSts)
+        *      * 0: No device is attached to the port.
+        *      * 1: A device is attached to the port.
+        */
        struct cvmx_usbcx_hprt_s {
                uint32_t reserved_19_31 : 13;
-               uint32_t prtspd         : 2;        /**< Port Speed (PrtSpd)
-                                                         Indicates the speed of the device attached to this port.
-                                                         * 2'b00: High speed
-                                                         * 2'b01: Full speed
-                                                         * 2'b10: Low speed
-                                                         * 2'b11: Reserved */
-               uint32_t prttstctl      : 4;        /**< Port Test Control (PrtTstCtl)
-                                                         The application writes a nonzero value to this field to put
-                                                         the port into a Test mode, and the corresponding pattern is
-                                                         signaled on the port.
-                                                         * 4'b0000: Test mode disabled
-                                                         * 4'b0001: Test_J mode
-                                                         * 4'b0010: Test_K mode
-                                                         * 4'b0011: Test_SE0_NAK mode
-                                                         * 4'b0100: Test_Packet mode
-                                                         * 4'b0101: Test_Force_Enable
-                                                         * Others: Reserved
-                                                         PrtSpd must be zero (i.e. the interface must be in high-speed
-                                                         mode) to use the PrtTstCtl test modes. */
-               uint32_t prtpwr         : 1;        /**< Port Power (PrtPwr)
-                                                         The application uses this field to control power to this port,
-                                                         and the core clears this bit on an overcurrent condition.
-                                                         * 1'b0: Power off
-                                                         * 1'b1: Power on */
-               uint32_t prtlnsts       : 2;        /**< Port Line Status (PrtLnSts)
-                                                         Indicates the current logic level USB data lines
-                                                         * Bit [10]: Logic level of D-
-                                                         * Bit [11]: Logic level of D+ */
+               uint32_t prtspd         : 2;
+               uint32_t prttstctl      : 4;
+               uint32_t prtpwr         : 1;
+               uint32_t prtlnsts       : 2;
                uint32_t reserved_9_9   : 1;
-               uint32_t prtrst         : 1;        /**< Port Reset (PrtRst)
-                                                         When the application sets this bit, a reset sequence is
-                                                         started on this port. The application must time the reset
-                                                         period and clear this bit after the reset sequence is
-                                                         complete.
-                                                         * 1'b0: Port not in reset
-                                                         * 1'b1: Port in reset
-                                                         The application must leave this bit set for at least a
-                                                         minimum duration mentioned below to start a reset on the
-                                                         port. The application can leave it set for another 10 ms in
-                                                         addition to the required minimum duration, before clearing
-                                                         the bit, even though there is no maximum limit set by the
-                                                         USB standard.
-                                                         * High speed: 50 ms
-                                                         * Full speed/Low speed: 10 ms */
-               uint32_t prtsusp        : 1;        /**< Port Suspend (PrtSusp)
-                                                         The application sets this bit to put this port in Suspend
-                                                         mode. The core only stops sending SOFs when this is set.
-                                                         To stop the PHY clock, the application must set the Port
-                                                         Clock Stop bit, which will assert the suspend input pin of
-                                                         the PHY.
-                                                         The read value of this bit reflects the current suspend
-                                                         status of the port. This bit is cleared by the core after a
-                                                         remote wakeup signal is detected or the application sets
-                                                         the Port Reset bit or Port Resume bit in this register or the
-                                                         Resume/Remote Wakeup Detected Interrupt bit or
-                                                         Disconnect Detected Interrupt bit in the Core Interrupt
-                                                         register (GINTSTS.WkUpInt or GINTSTS.DisconnInt,
-                                                         respectively).
-                                                         * 1'b0: Port not in Suspend mode
-                                                         * 1'b1: Port in Suspend mode */
-               uint32_t prtres         : 1;        /**< Port Resume (PrtRes)
-                                                         The application sets this bit to drive resume signaling on
-                                                         the port. The core continues to drive the resume signal
-                                                         until the application clears this bit.
-                                                         If the core detects a USB remote wakeup sequence, as
-                                                         indicated by the Port Resume/Remote Wakeup Detected
-                                                         Interrupt bit of the Core Interrupt register
-                                                         (GINTSTS.WkUpInt), the core starts driving resume
-                                                         signaling without application intervention and clears this bit
-                                                         when it detects a disconnect condition. The read value of
-                                                         this bit indicates whether the core is currently driving
-                                                         resume signaling.
-                                                         * 1'b0: No resume driven
-                                                         * 1'b1: Resume driven */
-               uint32_t prtovrcurrchng : 1;    /**< Port Overcurrent Change (PrtOvrCurrChng)
-                                                         The core sets this bit when the status of the Port
-                                                         Overcurrent Active bit (bit 4) in this register changes. */
-               uint32_t prtovrcurract  : 1;    /**< Port Overcurrent Active (PrtOvrCurrAct)
-                                                         Indicates the overcurrent condition of the port.
-                                                         * 1'b0: No overcurrent condition
-                                                         * 1'b1: Overcurrent condition */
-               uint32_t prtenchng      : 1;        /**< Port Enable/Disable Change (PrtEnChng)
-                                                         The core sets this bit when the status of the Port Enable bit
-                                                         [2] of this register changes. */
-               uint32_t prtena         : 1;        /**< Port Enable (PrtEna)
-                                                         A port is enabled only by the core after a reset sequence,
-                                                         and is disabled by an overcurrent condition, a disconnect
-                                                         condition, or by the application clearing this bit. The
-                                                         application cannot set this bit by a register write. It can only
-                                                         clear it to disable the port. This bit does not trigger any
-                                                         interrupt to the application.
-                                                         * 1'b0: Port disabled
-                                                         * 1'b1: Port enabled */
-               uint32_t prtconndet     : 1;        /**< Port Connect Detected (PrtConnDet)
-                                                         The core sets this bit when a device connection is detected
-                                                         to trigger an interrupt to the application using the Host Port
-                                                         Interrupt bit of the Core Interrupt register (GINTSTS.PrtInt).
-                                                         The application must write a 1 to this bit to clear the
-                                                         interrupt. */
-               uint32_t prtconnsts     : 1;        /**< Port Connect Status (PrtConnSts)
-                                                         * 0: No device is attached to the port.
-                                                         * 1: A device is attached to the port. */
+               uint32_t prtrst         : 1;
+               uint32_t prtsusp        : 1;
+               uint32_t prtres         : 1;
+               uint32_t prtovrcurrchng : 1;
+               uint32_t prtovrcurract  : 1;
+               uint32_t prtenchng      : 1;
+               uint32_t prtena         : 1;
+               uint32_t prtconndet     : 1;
+               uint32_t prtconnsts     : 1;
        } s;
 };
 typedef union cvmx_usbcx_hprt cvmx_usbcx_hprt_t;
@@ -1248,12 +1473,17 @@ typedef union cvmx_usbcx_hprt cvmx_usbcx_hprt_t;
  */
 union cvmx_usbcx_hptxfsiz {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hptxfsiz_s
+        * @ptxfsize: Host Periodic TxFIFO Depth (PTxFSize)
+        *      This value is in terms of 32-bit words.
+        *      * Minimum value is 16
+        *      * Maximum value is 32768
+        * @ptxfstaddr: Host Periodic TxFIFO Start Address (PTxFStAddr)
+        */
        struct cvmx_usbcx_hptxfsiz_s {
-               uint32_t ptxfsize       : 16;       /**< Host Periodic TxFIFO Depth (PTxFSize)
-                                                         This value is in terms of 32-bit words.
-                                                         * Minimum value is 16
-                                                         * Maximum value is 32768 */
-               uint32_t ptxfstaddr     : 16;       /**< Host Periodic TxFIFO Start Address (PTxFStAddr) */
+               uint32_t ptxfsize       : 16;
+               uint32_t ptxfstaddr     : 16;
        } s;
 };
 typedef union cvmx_usbcx_hptxfsiz cvmx_usbcx_hptxfsiz_t;
@@ -1268,42 +1498,48 @@ typedef union cvmx_usbcx_hptxfsiz cvmx_usbcx_hptxfsiz_t;
  */
 union cvmx_usbcx_hptxsts {
        uint32_t u32;
+       /**
+        * struct cvmx_usbcx_hptxsts_s
+        * @ptxqtop: Top of the Periodic Transmit Request Queue (PTxQTop)
+        *      This indicates the entry in the Periodic Tx Request Queue that
+        *      is currently being processes by the MAC.
+        *      This register is used for debugging.
+        *      * Bit [31]: Odd/Even (micro)frame
+        *      - 1'b0: send in even (micro)frame
+        *      - 1'b1: send in odd (micro)frame
+        *      * Bits [30:27]: Channel/endpoint number
+        *      * Bits [26:25]: Type
+        *      - 2'b00: IN/OUT
+        *      - 2'b01: Zero-length packet
+        *      - 2'b10: CSPLIT
+        *      - 2'b11: Disable channel command
+        *      * Bit [24]: Terminate (last entry for the selected
+        *      channel/endpoint)
+        * @ptxqspcavail: Periodic Transmit Request Queue Space Available
+        *      (PTxQSpcAvail)
+        *      Indicates the number of free locations available to be written in
+        *      the Periodic Transmit Request Queue. This queue holds both
+        *      IN and OUT requests.
+        *      * 8'h0: Periodic Transmit Request Queue is full
+        *      * 8'h1: 1 location available
+        *      * 8'h2: 2 locations available
+        *      * n: n locations available (0..8)
+        *      * Others: Reserved
+        * @ptxfspcavail: Periodic Transmit Data FIFO Space Available (PTxFSpcAvail)
+        *      Indicates the number of free locations available to be written to
+        *      in the Periodic TxFIFO.
+        *      Values are in terms of 32-bit words
+        *      * 16'h0: Periodic TxFIFO is full
+        *      * 16'h1: 1 word available
+        *      * 16'h2: 2 words available
+        *      * 16'hn: n words available (where 0..32768)
+        *      * 16'h8000: 32768 words available
+        *      * Others: Reserved
+        */
        struct cvmx_usbcx_hptxsts_s {
-               uint32_t ptxqtop        : 8;        /**< Top of the Periodic Transmit Request Queue (PTxQTop)
-                                                         This indicates the entry in the Periodic Tx Request Queue that
-                                                         is currently being processes by the MAC.
-                                                         This register is used for debugging.
-                                                         * Bit [31]: Odd/Even (micro)frame
-                                                           - 1'b0: send in even (micro)frame
-                                                           - 1'b1: send in odd (micro)frame
-                                                         * Bits [30:27]: Channel/endpoint number
-                                                         * Bits [26:25]: Type
-                                                           - 2'b00: IN/OUT
-                                                           - 2'b01: Zero-length packet
-                                                           - 2'b10: CSPLIT
-                                                           - 2'b11: Disable channel command
-                                                         * Bit [24]: Terminate (last entry for the selected
-                                                           channel/endpoint) */
-               uint32_t ptxqspcavail   : 8;    /**< Periodic Transmit Request Queue Space Available
-                                                         (PTxQSpcAvail)
-                                                         Indicates the number of free locations available to be written in
-                                                         the Periodic Transmit Request Queue. This queue holds both
-                                                         IN and OUT requests.
-                                                         * 8'h0: Periodic Transmit Request Queue is full
-                                                         * 8'h1: 1 location available
-                                                         * 8'h2: 2 locations available
-                                                         * n: n locations available (0..8)
-                                                         * Others: Reserved */
-               uint32_t ptxfspcavail   : 16;    /**< Periodic Transmit Data FIFO Space Available (PTxFSpcAvail)
-                                                         Indicates the number of free locations available to be written to
-                                                         in the Periodic TxFIFO.
-                                                         Values are in terms of 32-bit words
-                                                         * 16'h0: Periodic TxFIFO is full
-                                                         * 16'h1: 1 word available
-                                                         * 16'h2: 2 words available
-                                                         * 16'hn: n words available (where 0..32768)
-                                                         * 16'h8000: 32768 words available
-                                                         * Others: Reserved */
+               uint32_t ptxqtop        : 8;
+               uint32_t ptxqspcavail   : 8;
+               uint32_t ptxfspcavail   : 16;
        } s;
 };
 typedef union cvmx_usbcx_hptxsts cvmx_usbcx_hptxsts_t;