STRUCT TEGRA_I2C_DEV(9)

💅 struct tegra_i2c_dev(9) — the kernel API manual, bestie edition ✨

okay so this page is from the Kernel API Manual, and it's literally all about struct tegra_i2c_dev — the per device I2C context. yes, that's a whole struct of I2C vibes. let's get into it 🎀

---

🦋 NAME 🦋

struct tegra_i2c_dev — per device I2C context. that's it, that's the whole name. main character energy fr.

---

✨ SYNOPSIS ✨

here she is in all her glory, no cap, copy-pasted exactly:

struct tegra_i2c_dev {
    struct device *dev;
    struct i2c_adapter adapter;
    const struct tegra_i2c_hw_feature *hw;
    unsigned int cont_id;
    unsigned int irq;
    phys_addr_t base_phys;
    void __iomem *base;
    struct clk_bulk_data clocks[2];
    unsigned int nclocks;
    struct clk *div_clk;
    struct i2c_timings timings;
    struct completion msg_complete;
    size_t msg_buf_remaining;
    unsigned int msg_len;
    int msg_err;
    u8 *msg_buf;
    struct completion dma_complete;
    struct dma_chan *dma_chan;
    unsigned int dma_buf_size;
    struct device *dma_dev;
    dma_addr_t dma_phys;
    void *dma_buf;
    bool multimaster_mode;
    bool is_mctp;
    bool atomic_mode;
    bool dma_mode;
    bool msg_read;
 };

look at all those fields 😭 she's stunning. now let's meet every single member one by one, because we do not skip members here 💖

---

🌸 Members 🌸

• dev — device reference for power management. like the parent who signs the permission slip 🫶
• adapter — core I2C layer adapter information. the actual I2C-ness of it all.
• hw — Tegra I2C HW feature. the hardware tea ☕
• cont_id — I2C controller ID, used for packet header. literally the controller's name tag 🏷️
• irq — IRQ number of transfer complete interrupt. the "we're done here!" buzzer 🔔
• base_phys — physical base address of the I2C controller. the real physical address, no fake vibes.
• base — ioremapped registers cookie. yes, the manpage calls it a cookie 🍪 iconic honestly.
• clocks — array of I2C controller clocks. it's an array, clock besties 🕐
• nclocks — number of clocks in the array. gotta know how many clocks are clocking.
• div_clk — clock reference for div clock of I2C controller. the divider clock, slaying divider duties.
• timings — i2c timings information like bus frequency. all the timing deets, so punctual ✨
• msg_complete — transfer completion notifier. the "message sent!!" notification 💌
• msg_buf_remaining — size of unsent data in the message buffer. how much message is still waiting to go out 😤
• msg_len — length of message in current transfer. the current transfer's message length, periodt.
• msg_err — error code for completed message. when the message says "well that happened" 💀
• msg_buf — pointer to current message data. pointing right at the message data, iykyk.
• dma_complete — DMA completion notifier. the DMA version of "we're so back" 🎀
• dma_chan — DMA channel. the channel. the DMA one.
• dma_buf_size — DMA buffer size. how big the DMA buffer is, obviously 💅
• dma_dev — DMA device used for transfers. the device doing the DMA transferring.
• dma_phys — handle to DMA resources. handles to the DMA resources, held gently 🫶
• dma_buf — pointer to allocated DMA buffer. pointing at the buffer we allocated, slay.
• multimaster_mode — indicates that I2C controller is in multi-master mode. multiple masters, honestly chaotic but we love her 🌈
• is_mctp — indicates that the I2C controller is used as an MCTP controller. MCTP mode: active or not, that's the question.
• atomic_mode — indicates active atomic transfer. atomic transfer currently active, lowkey powerful ⭐
• dma_mode — indicates active DMA transfer. DMA transfer currently active, highkey fast 🔥
• msg_read — indicates that the transfer is a read access. it's a read!! 📖

---

👑 SEE ALSO 👑

• Kernel file ./drivers/i2c/busses/i2c-tegra.c struct tegra_i2c_hw_feature(9)

go read those too bestie, they're the supporting cast 💜

---

🧚 Sign-off 🧚

this lil page lives in ./drivers/i2c/busses, and the version tag says October 2026 — so yeah, future vibes ✨. mwah, go forth and I2C 💖🦋🌸