diff options
author | Aaro Koskinen <aaro.koskinen@iki.fi> | 2013-06-06 22:35:00 +0300 |
---|---|---|
committer | Greg Kroah-Hartman <gregkh@linuxfoundation.org> | 2013-06-06 13:15:03 -0700 |
commit | ebf5950a9a34509373fdf45bd80e87d2355b5c56 (patch) | |
tree | facd7e7927c12a10f91473f1ff568bc133a3c28b /drivers/staging/octeon-usb | |
parent | 215f7493f5e4ab5107212b5754b17b8fb075ac19 (diff) | |
download | linux-ebf5950a9a34509373fdf45bd80e87d2355b5c56.tar.gz linux-ebf5950a9a34509373fdf45bd80e87d2355b5c56.tar.bz2 linux-ebf5950a9a34509373fdf45bd80e87d2355b5c56.zip |
staging: octeon-usb: cvmx-usbcx-defs.h: fix comment style
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>
Diffstat (limited to 'drivers/staging/octeon-usb')
-rw-r--r-- | drivers/staging/octeon-usb/cvmx-usbcx-defs.h | 1862 |
1 files changed, 1049 insertions, 813 deletions
diff --git a/drivers/staging/octeon-usb/cvmx-usbcx-defs.h b/drivers/staging/octeon-usb/cvmx-usbcx-defs.h index fe109ca392ea..744cefa23d84 100644 --- a/drivers/staging/octeon-usb/cvmx-usbcx-defs.h +++ b/drivers/staging/octeon-usb/cvmx-usbcx-defs.h @@ -120,39 +120,47 @@ */ 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; |