STRUCT MTK_VCODEC_DEC_DEV(9)

💖 NAME 💖

struct mtk_vcodec_dec_dev — driver data, bestie. it's the main-character struct of the MediaTek decoder driver 🎀

✨ SYNOPSIS ✨

okay so picture the whole vibe of this thing, like literally every field, no skips:

struct mtk_vcodec_dec_dev {
    struct v4l2_device v4l2_dev;
    struct video_device *vfd_dec;
    struct media_device mdev_dec;
    struct v4l2_m2m_dev *m2m_dev_dec;
    struct platform_device *plat_dev;
    struct list_head ctx_list;
    struct mtk_vcodec_dec_ctx *curr_ctx;
    void __iomem *reg_base[NUM_MAX_VCODEC_REG_BASE];
    const struct mtk_vcodec_dec_pdata *vdec_pdata;
    struct regmap *vdecsys_regmap;
    struct mtk_vcodec_fw *fw_handler;
    u64 id_counter;
    struct mutex dec_mutex[MTK_VDEC_HW_MAX];
    struct mutex dev_mutex;
    spinlock_t dev_ctx_lock;
    struct workqueue_struct *decode_workqueue;
    spinlock_t irqlock;
    int dec_irq;
    struct mtk_vcodec_pm pm;
    unsigned int dec_capability;
    struct workqueue_struct *core_workqueue;
    void *subdev_dev[MTK_VDEC_HW_MAX];
    int (*subdev_prob_done)(struct mtk_vcodec_dec_dev *vdec_dev);
    unsigned long subdev_bitmap[BITS_TO_LONGS( MTK_VDEC_HW_MAX)];
    atomic_t dec_active_cnt;
    u32 vdec_racing_info[132];
    struct mutex dec_racing_info_mutex;
    struct mtk_vcodec_dbgfs dbgfs;
    enum mtk_vcodec_dec_chip_name chip_name;
 };

like, that's a lot of fields but we're gonna go through every single one, periodt 💅

🦋 MEMBERS 🦋

get comfy, we're doing a full tour 🫶

• v4l2_dev — the V4L2 device you register your video devices for ✨
• vfd_dec — the video device for the decoder, its whole moment 🎥
• mdev_dec — media device for the decoder, iconic
• m2m_dev_dec — m2m device for the decoder, mem2mem core girlies know
• plat_dev — platform device, the origin story
• ctx_list — list of struct mtk_vcodec_ctx, the whole friend group 💖
• curr_ctx — the context that is waiting for codec hardware, like waiting for the bathroom at a party 😭
• reg_base — mapped address of MTK Vcodec registers 💅
• vdec_pdata — decoder IC-specific data, the per-chip lore
• vdecsys_regmap — VDEC_SYS register space passed through syscon
• fw_handler — used to communicate with the firmware, her little hotline 📞
• id_counter — used to identify current opened instance
• dec_mutex — decoder hardware lock
• dev_mutex — video_device lock
• dev_ctx_lock — the lock of context list 🔒
• decode_workqueue — decode work queue, getting stuff done fr fr
• irqlock — protect data access by irq handler and work thread
• dec_irq — decoder irq resource
• pm — power management control ⚡
• dec_capability — used to identify decode capability, ex: 4k
• core_workqueue — queue used for core hardware decode
• subdev_dev — subdev hardware device
• subdev_prob_done — check whether all used hw device is prob done 👀
• subdev_bitmap — used to record hardware is ready or not
• dec_active_cnt — used to mark whether need to record register value
• vdec_racing_info — record register value
• dec_racing_info_mutex — mutex lock used for inner racing mode
• dbgfs — debug log related information, the receipts 🧾
• chip_name — used to distinguish platforms and select the correct codec configuration values 👑

🌈 SEE ALSO 🌈

• Kernel file ./drivers/media/platform/mediatek/vcodec/decoder/mtk_vcodec_dec_drv.h — yes that exact path, go read her
• struct vdec_pic_info(9)
• struct mtk_vcodec_dec_pdata(9)
• struct mtk_vcodec_dec_request(9)
• struct mtk_vcodec_dec_ctx(9)

okay so that's the whole page 💜 sign-off time: this came from ./drivers/media/platform/media... and it's dated October 2026, and the header said struct mtk_vcodec_dec_dev(9) from the Kernel API Manual — slay, ate, no cap 🦋✨🎀