STRUCT ATMEL_PIOCTRL(9)

✨ struct atmel_pioctrl(9) ✨

okay bestie, so this is from the Kernel API Manual — a whole struct atmel_pioctrl, which is literally the Atmel PIO controller (pinmux + gpio). it's giving "one struct to rule them all" and honestly? iconic. 🎀

💖 NAME 💖

struct atmel_pioctrl — the Atmel PIO controller, doing double duty as pinmux + gpio. yes ma'am, both. 💅

🌸 SYNOPSIS 🌸

struct atmel_pioctrl {
    void __iomem            *reg_base;
    struct clk              *clk;
    unsigned int            nbanks;
    struct pinctrl_dev      *pinctrl_dev;
    struct atmel_group      *groups;
    const char * const      *group_names;
    struct atmel_pin        **pins;
    unsigned int            npins;
    struct gpio_chip        *gpio_chip;
    struct irq_domain       *irq_domain;
    int *irqs;
    unsigned int            *pm_wakeup_sources;
    struct {
      u32 imr;
      u32 odsr;
      u32 cfgr[ATMEL_PIO_NPINS_PER_BANK];
    } *pm_suspend_backup;
    struct device           *dev;
    struct device_node      *node;
    unsigned int            slew_rate_support;
 };

no cap, that's the whole shape of it. let's go member by member 🫶

🦋 Members 🦋

• reg_base — base address of the controller. the home address, if you will 🏠
• clk — clock of the controller. it's the heartbeat, fr fr ⏰
• nbanks — number of PIO groups. heads up: it can vary depending on the SoC, so don't come for me if your board's count is different 💀
• pinctrl_dev — the pinctrl device that got registered.
• groups — the groups table, there to provide group name and pin in the group to pinctrl. very "here's your label, here's your pin" energy 🏷️
• group_names — group names table, providing all the group/pin names to pinctrl or gpio. sharing is caring.
• pins — pins table, used for both pinctrl and gpio. the pin_id, bank and line fields are set at probe time; the other ones are set when parsing dt pinctrl. so it's a two-phase glow-up ✨
• npins — number of pins, periodt.
• gpio_chip — the gpio chip that got registered.
• irq_domain — irq domain for the gpio controller. interrupt royalty 👑
• irqs — table containing the hw irq number of the bank. and the index of the table is the bank id — iykyk 🔥
• pm_wakeup_sources — bitmap of wakeup sources (lines).
• pm_suspend_backup — backup/restore register values on suspend/resume. it remembers so you don't have to 😭 inside it lives u32 imr, u32 odsr, and u32 cfgr[ATMEL_PIO_NPINS_PER_BANK].
• dev — device entry for the Atmel PIO controller.
• node — node of the Atmel PIO controller.
• slew_rate_support — slew rate support. yes that's the whole description and yes we're keeping it 💅

🌈 SEE ALSO 🌈

• Kernel file ./drivers/pinctrl/pinctrl-at91-pio4.c
• struct atmel_pioctrl_data(9)

and that's the vibe check, bestie 🧚 source lives under ./drivers/pinctrl, dated October 2026 — struct atmel_pioctrl(9), signed, sealed, slayed. 💜