STRUCT S5P_MFC_DEV(9)

💖 struct s5p_mfc_dev(9) — Kernel API Manual 💖

okay so picture this: it's the kernel API manual, it's the struct s5p_mfc_dev, and it's the struct holding all the driver's internal parameters. everything. the whole vibe. one big beautiful bag of state and we're gonna go through it together, bestie 🫶

---

✨ NAME ✨

struct s5p_mfc_dev — the struct that contains all the driver's internal parameters, no cap 💅

---

🌸 SYNOPSIS 🌸

struct s5p_mfc_dev {
    struct v4l2_device      v4l2_dev;
    struct video_device     *vfd_dec;
    struct video_device     *vfd_enc;
    struct platform_device  *plat_dev;
    struct device           *mem_dev[BANK_CTX_NUM];
    void __iomem            *regs_base;
    int irq;
    struct v4l2_ctrl_handler dec_ctrl_handler;
    struct v4l2_ctrl_handler enc_ctrl_handler;
    struct s5p_mfc_pm       pm;
    const struct s5p_mfc_variant    *variant;
    int num_inst;
    spinlock_t irqlock;
    spinlock_t condlock;
    struct mutex mfc_mutex;
    int int_cond;
    int int_type;
    unsigned int int_err;
    wait_queue_head_t queue;
    struct s5p_mfc_priv_buf fw_buf;
    size_t mem_size;
    dma_addr_t mem_base;
    unsigned long *mem_bitmap;
    void *mem_virt;
    dma_addr_t dma_base[BANK_CTX_NUM];
    unsigned long hw_lock;
    struct s5p_mfc_ctx *ctx[MFC_NUM_CONTEXTS];
    int curr_ctx;
    unsigned long ctx_work_bits;
    atomic_t watchdog_cnt;
    struct timer_list watchdog_timer;
    struct workqueue_struct *watchdog_workqueue;
    struct work_struct watchdog_work;
    unsigned long enter_suspend;
    struct s5p_mfc_priv_buf ctx_buf;
    int warn_start;
    const struct s5p_mfc_hw_ops *mfc_ops;
    const struct s5p_mfc_hw_cmds *mfc_cmds;
    const struct s5p_mfc_regs *mfc_regs;
    enum s5p_mfc_fw_ver fw_ver;
    bool fw_get_done;
    bool risc_on;
};

like, look at her. main character energy fr fr 👑

---

🎀 Members 🎀

every single field, one by one, so you never have to guess what's what:

• v4l2_dev — type v4l2_device. the v4l2_device, obviously 💅
• vfd_dec — the video device for decoding
• vfd_enc — the video device for encoding
• plat_dev — the platform device
• mem_dev — the child devices of the memory banks
• regs_base — the base address of the MFC hw registers
• irq — the irq resource
• dec_ctrl_handler — the control framework handler for decoding
• enc_ctrl_handler — the control framework handler for encoding
• pm — power management control
• variant — MFC hardware variant information
• num_inst — counter of active MFC instances
• irqlock — the lock for operations on videobuf2 queues
• condlock — the lock for changing/checking if a context is ready to be processed
• mfc_mutex — the lock for video_device
• int_cond — variable used by the waitqueue
• int_type — the type of the last interrupt
• int_err — the error number for the last interrupt
• queue — the waitqueue for waiting for completion of device commands
• fw_buf — the firmware buffer data structure
• mem_size — the size of the firmware operation memory
• mem_base — the base DMA address of the firmware operation memory
• mem_bitmap — the bitmap for managing MFC internal buffer allocations
• mem_virt — the virtual address of the firmware operation memory
• dma_base — the address of the beginning of memory banks
• hw_lock — used for hardware locking
• ctx — the array of driver contexts
• curr_ctx — the number of the currently running context
• ctx_work_bits — used to mark which contexts are waiting for hardware
• watchdog_cnt — the counter for the watchdog
• watchdog_timer — the timer for the watchdog
• watchdog_workqueue — the workqueue for the watchdog
• watchdog_work — the worker for the watchdog
• enter_suspend — the flag set when entering suspend
• ctx_buf — the common context memory (MFCv6)
• warn_start — the hardware error code from which warnings start
• mfc_ops — the ops structure holding HW operation function pointers
• mfc_cmds — the cmd structure holding HW commands function pointers
• mfc_regs — the structure holding MFC registers
• fw_ver — the loaded firmware sub-version
• fw_get_done — the flag set when request_firmware is complete and copied into fw_buf
• risc_on — the flag indicating whether RISC is on or off

ngl there's a lot of locks in there — irqlock, condlock, mfc_mutex, hw_lock — and they're all doing different jobs. don't mix them up, bestie 😭

---

🦋 SEE ALSO 🦋

• the kernel file ./drivers/media/platform/samsung/s5p-mfc/s5p_mfc_common.h
• struct s5p_mfc_priv_buf(9)
• struct s5p_mfc_ctx(9)

---

that's the whole tour, and honestly? she ate. 🍓

this page came from ./drivers/media/platform/samsu... — dated October 2026, struct s5p_mfc_dev(9) 💜 slay, go read the headers now ✨