STRUCT VENUS_CORE(9)

💖 struct venus_core — Kernel API Manual (core.h girlies rise up) 💖

okay so bestie, we're looking at struct venus_core(9) from the Kernel API Manual, and honestly? she's the main character of core.h. literally holds core parameters valid for all instances. no cap. every Venus instance out there is looking up to this one struct like she's the group chat admin 🫶

---

✨ NAME ✨

struct venus_core — holds core parameters valid for all instances 💅

---

🌸 SYNOPSIS 🌸

like, here's her whole personality, character for character, don't touch a single byte:

struct venus_core {
    void __iomem *base;
    void __iomem *vbif_base;
    void __iomem *cpu_base;
    void __iomem *cpu_cs_base;
    void __iomem *cpu_ic_base;
    void __iomem *wrapper_base;
    void __iomem *wrapper_tz_base;
    void __iomem *aon_base;
    int irq;
    struct clk *clks[VIDC_CLKS_NUM_MAX];
    struct clk *vcodec_clks[VIDC_VCODEC_CLKS_NUM_MAX];
    struct clk *vcodec0_clks[VIDC_VCODEC_CLKS_NUM_MAX];
    struct clk *vcodec1_clks[VIDC_VCODEC_CLKS_NUM_MAX];
    struct icc_path *video_path;
    struct icc_path *cpucfg_path;
    struct dev_pm_domain_list *pmdomains;
    struct dev_pm_domain_list *opp_pmdomain;
    struct reset_control *resets[VIDC_RESETS_NUM_MAX];
    struct video_device *vdev_dec;
    struct video_device *vdev_enc;
    struct v4l2_device v4l2_dev;
    const struct venus_resources *res;
    struct device *dev;
    struct device *dev_dec;
    struct device *dev_enc;
    unsigned int use_tz;
    struct video_firmware {
      struct device *dev;
      struct iommu_domain *iommu_domain;
      size_t mapped_mem_size;
      phys_addr_t mem_phys;
      size_t mem_size;
    } fw;
    struct mutex lock;
    struct list_head instances;
    atomic_t insts_count;
    unsigned int state;
    struct completion done;
    unsigned int error;
    unsigned long sys_error;
    wait_queue_head_t sys_err_done;
    const struct hfi_core_ops *core_ops;
    const struct venus_pm_ops *pm_ops;
    struct mutex pm_lock;
    unsigned long enc_codecs;
    unsigned long dec_codecs;
    unsigned int max_sessions_supported;
    void *priv;
    const struct hfi_ops *ops;
    struct delayed_work work;
    struct hfi_plat_caps caps[MAX_CODEC_NUM];
    unsigned int codecs_count;
    unsigned int core0_usage_count;
    unsigned int core1_usage_count;
    struct dentry *root;
    struct firmware_version venus_ver;
    unsigned long dump_core;
    struct of_changeset *ocs;
    bool hwmode_dev;
   };

it's giving "longest group chat bio ever" and I'm obsessed 😭

---

🦋 Members 🦋

okay so now we go member by member, and yes we're doing ALL of them, because every single field is iconic in her own way:

• base — IO memory base address ✨
• vbif_base — IO memory vbif base address
• cpu_base — IO memory cpu base address
• cpu_cs_base — IO memory cpu_cs base address
• cpu_ic_base — IO memory cpu_ic base address
• wrapper_base — IO memory wrapper base address 🎀
• wrapper_tz_base — IO memory wrapper TZ base address
• aon_base — AON base address
• irq — Venus irq 🔥
• clks — an array of struct clk pointers
• vcodec_clks — an array of vcodec struct clk pointers
• vcodec0_clks — an array of vcodec0 struct clk pointers
• vcodec1_clks — an array of vcodec1 struct clk pointers
• video_path — an interconnect handle to video to/from memory path 🌈
• cpucfg_path — an interconnect handle to cpu configuration path
• pmdomains — a pointer to a list of pmdomains
• opp_pmdomain — an OPP power-domain
• resets — an array of reset signals
• vdev_dec — a reference to video device structure for decoder instances
• vdev_enc — a reference to video device structure for encoder instances
• v4l2_dev — a holder for v4l2 device structure
• res — a reference to venus resources structure
• dev — convenience struct device pointer
• dev_dec — convenience struct device pointer for decoder device
• dev_enc — convenience struct device pointer for encoder device
• use_tz — a flag that suggests presence of trustzone 🕵️‍♀️
• fw — structure of firmware parameters
• lock — a lock for this strucure (yes, that's exactly how the original spells it, leaving it as is bestie, character for character 💀)
• instances — a list_head of all instances
• insts_count — num of instances
• state — the state of the venus core
• done — a completion for sync HFI operations
• error — an error returned during last HFI sync operations 😭
• sys_error — an error flag that signal system error event
• sys_err_done — a waitqueue to wait for system error recovery end
• core_ops — the core operations
• pm_ops — a pointer to pm operations
• pm_lock — a lock for PM operations
• enc_codecs — encoders supported by this core
• dec_codecs — decoders supported by this core
• max_sessions_supported — holds the maximum number of sessions 👑
• priv — a private filed for HFI operations (again, verbatim, don't come for me 🙈)
• ops — the core HFI operations
• work — a delayed work for handling system fatal error 💀
• caps — an array of supported HFI capabilities
• codecs_count — platform codecs count
• core0_usage_count — usage counter for core0
• core1_usage_count — usage counter for core1
• root — debugfs root directory 🌸
• venus_ver — the venus firmware version
• dump_core — a flag indicating that a core dump is required
• ocs — OF changeset pointer
• hwmode_dev — a flag indicating that HW_CTRL_TRIGGER is used in clock driver ⭐

lowkey a whole personality test in struct form. every field ate, no crumbs. 💅

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/media/platform/qcom/venus/core.h struct venus_inst(9)

like, go read her sister page too, iykyk 🦋

---

and that's the whole vibe check bestie 💖 this came from the source ./drivers/media/platform/qcom/... and the version/date on the original footer was October 2026 — so yeah, she's from the future, which honestly tracks. slay, struct venus_core(9), periodt. 👑✨