STRUCT CDNS3_DEVICE(9)

💖 NAME

okay bestie, welcome to the Kernel API Manual page for struct cdns3_device(9) — and the NAME is literally: struct cdns3_device — represent USB device. That’s the whole vibe: this struct is how the driver represents a USB device. 🦋

✨ SYNOPSIS

Here’s the struct in all its glory, copied exactly so you can trust it:

struct cdns3_device {
    struct device                   *dev;
    struct device                   *sysdev;
    struct usb_gadget               gadget;
    struct usb_gadget_driver        *gadget_driver;
  #define CDNS_REVISION_V0                0x00024501;
  #define CDNS_REVISION_V1                0x00024509;
    u32 dev_ver;
    spinlock_t lock;
    struct cdns3_usb_regs           __iomem *regs;
    struct dma_pool                 *eps_dma_pool;
    struct usb_ctrlrequest          *setup_buf;
    dma_addr_t setup_dma;
    void *zlp_buf;
    u8 ep0_stage;
    int ep0_data_dir;
    struct cdns3_endpoint           *eps[CDNS3_ENDPOINTS_MAX_COUNT];
    struct list_head                aligned_buf_list;
    struct work_struct              aligned_buf_wq;
    u32 selected_ep;
    u16 isoch_delay;
    unsigned wait_for_setup:1;
    unsigned u1_allowed:1;
    unsigned u2_allowed:1;
    unsigned is_selfpowered:1;
    unsigned setup_pending:1;
    unsigned hw_configured_flag:1;
    unsigned wake_up_flag:1;
    unsigned status_completion_no_call:1;
    unsigned using_streams:1;
    int out_mem_is_allocated;
    struct work_struct              pending_status_wq;
    struct usb_request              *pending_status_request;
    u16 onchip_buffers;
    u16 onchip_used_size;
    u16 ep_buf_size;
    u16 ep_iso_burst;
};

Also peep the two revision defines living inside the struct: CDNS_REVISION_V0 is 0x00024501, and CDNS_REVISION_V1 is 0x00024509. Slay. 🎀

🎀 Members

• dev — pointer to the device structure associated with this controller.
• sysdev — pointer to the DMA capable device.
• gadget — device side representation of the peripheral controller.
• gadget_driver — pointer to the gadget driver.
• dev_ver — device controller version. 👑
• lock — for synchronizing.
• regs — base address for device side registers.
• setup_buf — used while processing USB control requests.
• setup_dma — DMA address for setup_buf.
• zlp_buf — zlp buffer.
• ep0_stage — ep0 stage during the enumeration process.
• ep0_data_dir — direction for control transfer.
• eps — array of pointers to all endpoints, with ep0 excluded. The array is eps[CDNS3_ENDPOINTS_MAX_COUNT]. ✨
• aligned_buf_list — list of aligned buffers internally allocated by driver.
• aligned_buf_wq — workqueue freeing no longer used aligned buf.
• selected_ep — actually selected endpoint. It’s used only to improve performance.
• isoch_delay — value from Set Isoch Delay request. Only valid on SS/SSP.
• u1_allowed:1 — allow device transition to u1 state.
• u2_allowed:1 — allow device transition to u2 state.
• is_selfpowered:1 — device is self powered.
• setup_pending:1 — setup packet is processing by gadget driver.
• hw_configured_flag:1 — hardware endpoint configuration was set.
• wake_up_flag:1 — allow device to remote up the host.
• status_completion_no_call:1 — indicate that driver is waiting for status s stage completion. It’s used in deferred SET_CONFIGURATION request.
• pending_status_wq — workqueue handling status stage for deferred requests.
• pending_status_request — request for which status stage was deferred.
• onchip_buffers — number of available on-chip buffers.
• onchip_used_size — actual size of on-chip memory assigned to endpoints.

🌸 Struct-only cameos (no separate member blurb in the original)

• eps_dma_pool — it’s in the struct as struct dma_pool *eps_dma_pool;; the Members list doesn’t give it its own description here.
• wait_for_setup:1 — bitfield in the struct, no separate member blurb in the original.
• using_streams:1 — bitfield in the struct, no separate member blurb in the original.
• out_mem_is_allocated — int in the struct, no separate member blurb in the original.
• ep_buf_size — u16 in the struct, no separate member blurb in the original.
• ep_iso_burst — u16 in the struct, no separate member blurb in the original.

🌈 SEE ALSO

Kernel file ./drivers/usb/cdns3/cdns3-gadget.h:

• struct cdns3_usb_regs(9)
• struct cdns3_trb(9)
• struct cdns3_endpoint(9)
• struct cdns3_aligned_buf(9)
• struct cdns3_request(9)

xoxo, this page lives under source/version ./drivers/usb/cdns3 and is dated October 2026 — go be iconic with your USB gadget struct, bestie! 💅✨