STRUCT TEGRA_PMC(9)

📦 version 7.3.1, in nixpkgs unstable

🎀 struct tegra_pmc(9) — the Kernel API Manual, bestie edition 🎀

okay so. this page is from the Kernel API Manual, section 9 (that's the kernel-API girlies), and it's literally all about struct tegra_pmc — aka the NVIDIA Tegra PMC. no cap, it's a big one. let's get into it 💅

✨ NAME ✨

struct tegra_pmc — NVIDIA Tegra PMC. that's it, that's the name, she's iconic 👑

🌸 SYNOPSIS 🌸

here's the whole struct, copy-pasted exact because we do NOT play with code integrity, bestie:

struct tegra_pmc {
    struct device *dev;
    void __iomem *base;
    void __iomem *wake;
    void __iomem *aotag;
    void __iomem *scratch;
    struct clk *clk;
    const struct tegra_pmc_soc *soc;
    bool tz_only;
    unsigned long rate;
    enum tegra_suspend_mode suspend_mode;
    u32 cpu_good_time;
    u32 cpu_off_time;
    u32 core_osc_time;
    u32 core_pmu_time;
    u32 core_off_time;
    bool corereq_high;
    bool sysclkreq_high;
    bool combined_req;
    bool cpu_pwr_good_en;
    u32 lp0_vec_phys;
    u32 lp0_vec_size;
    bool invert_irq;
    unsigned long powergates_available[BITS_TO_LONGS(
TEGRA_POWERGATE_MAX)];
    struct mutex powergates_lock;
    struct pinctrl_dev *pctl_dev;
    struct irq_domain *domain;
    struct irq_chip irq;
    struct notifier_block clk_nb;
    bool core_domain_state_synced;
    unsigned long *wake_type_level_map;
    unsigned long *wake_type_dual_edge_map;
    unsigned long *wake_sw_status_map;
    unsigned long *wake_cntrl_level_map;
    struct notifier_block reboot_notifier;
    struct syscore syscore;
    struct irq_work wake_work;
    u32 *wake_status;
 };

🦋 Members 🦋

time for the member-by-member tour, and yes i'm gonna hype up every single one because they all matter 💖

  • dev — pointer to the PMC device structure. the whole thing's home base 🏠
  • base — pointer to the I/O remapped register region. where the registers actually live ✨
  • wake — pointer to the I/O remapped region for WAKE registers. wake-up business goes here 👀
  • aotag — pointer to the I/O remapped region for AOTAG registers. yes bestie, its own remapped region 🎀
  • scratch — pointer to the I/O remapped region for scratch registers. scribble notes here 📝
  • clk — pointer to the pclk clock. clock girlie ⏰
  • soc — pointer to the SoC data structure. tells you which chip you're on, iykyk 🔥
  • tz_only — flag specifying if the PMC can only be accessed via TrustZone. so like, if this is set, no direct poking at it, periodt 🚫
  • rate — currently configured rate of pclk. how fast she's running rn 🏃‍♀️
  • suspend_mode — lowest suspend mode available. the deepest nap she can take 😴
  • cpu_good_time — CPU power good time (in microseconds). ⏱️
  • cpu_off_time — CPU power off time (in microsecends). (that typo is in the original, i'm keeping it, it's canon 🫶)
  • core_osc_time — core power good OSC time (in microseconds). ✨
  • core_pmu_time — core power good PMU time (in microseconds). 💜
  • core_off_time — core power off time (in microseconds). 🔌
  • corereq_high — core power request is active-high. polarity tea ☕
  • sysclkreq_high — system clock request is active-high. also polarity tea ☕
  • combined_req — combined power request for CPU & core. they share, cute 🤝
  • cpu_pwr_good_en — CPU power good signal is enabled. she's on ✅
  • lp0_vec_phys — physical base address of the LP0 warm boot code. where the warm-boot code sits in phys memory 🔥
  • lp0_vec_size — size of the LP0 warm boot code. how big that chunk is 📏
  • invert_irq — polarity of the PMU IRQ is inverted. upside-down interrupt vibes 🙃
  • powergates_available — Bitmap of available power gates. the roster of gates you're allowed to touch 👑
  • powergates_lock — mutex for power gate register access. keep your hands to yourself while someone else is in there 🔒
  • pctl_dev — pin controller exposed by the PMC. yes, the PMC hands out a pin controller too, multitalented 💅
  • domain — IRQ domain provided by the PMC. interrupt turf 🗺️
  • irq — chip implementation for the IRQ domain. the actual chip logic 🧠
  • clk_nb — pclk clock changes handler. she listens for clock drama 👂
  • core_domain_state_synced — flag marking the core domain's state as synced. synced = ✅
  • wake_type_level_map — Bitmap indicating level type for non-dual edge wakes. 📊
  • wake_type_dual_edge_map — Bitmap indicating if a wake is dual-edge or not. deux edges or nah 🦋
  • wake_sw_status_map — Bitmap to hold raw status of wakes without mask. the unfiltered truth 💀
  • wake_cntrl_level_map — Bitmap to hold wake levels to be programmed in cntrl register associated with each wake during system suspend. so during suspend, every wake gets its level written into the cntrl register, and this bitmap keeps track 🎯
  • reboot_notifier — PMC reboot notifier handler. she gets pinged on reboot 🔔
  • syscore — syscore suspend/resume callbacks. the suspend/resume hookup 😴
  • wake_work — IRQ work handler for processing wake-up events. queue that work 📬
  • wake_status — Status of wake-up events. what woke us up, bestie 👀

🌈 SEE ALSO 🌈

Kernel file ./drivers/soc/tegra/pmc.c, plus all these siblings — go read them, they're the rest of the family fr fr:

💖 and that's the whole page, bestie. go forth and powergate responsibly.

and finally, the sign-off 🌸: this one lives at ./drivers/soc/tegra, dated October 2026, and the footer names her struct tegra_pmc(9) — same as the header. no notes, she ate 💅✨

📦 where this page comes from