STRUCT PCS_DEVICE(9)

struct pcs_device(9) — the Kernel API Manual, but make it a vibe 💅✨

NAME 🎀

struct pcs_device — pinctrl device instance. That's the name, bestie: it's the struct for a pinctrl device instance. 👑

SYNOPSIS 🦋

Okay so here's the full struct, no edits, no cap — every field and define exactly as it lives:

       struct pcs_device {
           struct resource *res;
           void __iomem *base;
           void *saved_vals;
           unsigned size;
           struct device *dev;
           struct device_node *np;
           struct pinctrl_dev *pctl;
           unsigned flags;
         #define PCS_CONTEXT_LOSS_OFF    (1 << 3);
         #define PCS_QUIRK_SHARED_IRQ    (1 << 2);
         #define PCS_FEAT_IRQ            (1 << 1);
         #define PCS_FEAT_PINCONF        (1 << 0);
           struct property *missing_nr_pinctrl_cells;
           struct pcs_soc_data socdata;
           raw_spinlock_t lock;
           struct mutex mutex;
           unsigned width;
           unsigned fmask;
           unsigned fshift;
           unsigned foff;
           unsigned fmax;
           bool bits_per_mux;
           unsigned bits_per_pin;
           struct pcs_data pins;
           struct list_head gpiofuncs;
           struct list_head irqs;
           struct irq_chip chip;
           struct irq_domain *domain;
           struct pinctrl_desc desc;
           unsigned (*read)(void __iomem *reg);
           void (*write)(unsigned val, void __iomem *reg);
        };

Members 💖

Every member gets its lil moment, because the whole cast matters:

• res — resources.
• base — virtual address of the controller.
• saved_vals — saved values for the controller.
• size — size of the ioremapped area.
• dev — device entry.
• np — device tree node.
• pctl — pin controller device.
• flags — mask of PCS_FEAT_xxx values.
• missing_nr_pinctrl_cells — for legacy binding, may go away. Lowkey don't get too attached, but that's literally what the page says.
• socdata — soc specific data.
• lock — spinlock for register access.
• mutex — mutex protecting the lists.
• width — bits per mux register.
• fmask — function register mask.
• fshift — function register shift.
• foff — value to turn mux off.
• fmax — max number of functions in fmask.
• bits_per_mux — number of bits per mux.
• bits_per_pin — number of bits per pin.
• pins — physical pins on the SoC.
• gpiofuncs — list of gpio functions.
• irqs — list of interrupt registers.
• chip — chip container for this instance.
• domain — IRQ domain for this instance.
• desc — pin controller descriptor.
• read — register read function to use.
• write — register write function to use.

SEE ALSO 🌈

The kernel file is ./drivers/pinctrl/pinctrl-single.c, and these are the linked faves — go read them, iykyk:

• struct pcs_func_vals(9)
• struct pcs_conf_vals(9)
• struct pcs_conf_type(9)
• struct pcs_function(9)
• struct pcs_gpiofunc_range(9)
• struct pcs_data(9)
• struct pcs_soc_data(9)
• pcs_add_pin(9)
• pcs_allocate_pin_table(9)
• pcs_add_function(9)
• pcs_get_pin_by_offset(9)
• pcs_parse_one_pinctrl_entry(9)
• pcs_dt_node_to_map(9)
• pcs_irq_free(9)
• pcs_free_resources(9)
• struct pcs_interrupt(9)
• pcs_irq_set(9)
• pcs_irq_mask(9)
• pcs_irq_unmask(9)
• pcs_irq_set_wake(9)
• pcs_irq_handle(9)
• pcs_irq_handler(9)
• pcs_irq_chain_handler(9)
• pcs_irq_init_chained_handler(9)
• pcs_quirk_missing_pinctrl_cells(9)

🎀 Source/version: ./drivers/pinctrl · date: October 2026 · manual: Kernel API Manual. Cute sign-off complete, bestie — periodt. 💖