STRUCT SUN4I_I2S_QUIRKS(9)

💖 struct sun4i_i2s_quirks(9) — the Kernel API Manual, bestie edition 💖

okay so first of all, this is a page from the Kernel API Manual, and the whole thing is literally just a big ol' struct called sun4i_i2s_quirks. no cap, it's the vibe-check struct for the sun4i i2s driver. 🎀

---

✨ NAME ✨

struct sun4i_i2s_quirks — Differences between SoC variants. that's it. that's the whole name. it's the "every SoC is a lil different" struct and honestly? iconic. 💅

---

🌸 SYNOPSIS 🌸

struct sun4i_i2s_quirks {
    bool has_reset;
    u64 pcm_formats;
    unsigned int                    reg_offset_txdata;
    const struct regmap_config      *sun4i_i2s_regmap;
    struct reg_field                field_clkdiv_mclk_en;
    struct reg_field                field_fmt_wss;
    struct reg_field                field_fmt_sr;
    unsigned int                    num_din_pins;
    unsigned int                    num_dout_pins;
    const struct sun4i_i2s_clk_div  *bclk_dividers;
    unsigned int                    num_bclk_dividers;
    const struct sun4i_i2s_clk_div  *mclk_dividers;
    unsigned int                    num_mclk_dividers;
    unsigned long (*get_bclk_parent_rate)(const struct sun4i_i2s *i2s);
    int (*get_sr)(unsigned int width);
    int (*get_wss)(unsigned int width);
    int (*set_chan_cfg)(const struct sun4i_i2s *i2s, unsigned int channels,  unsigned int slots, unsigned int slot_width);
    int (*set_fmt)(const struct sun4i_i2s *i2s, unsigned int fmt);
 };

like look at all those function pointers. main character energy fr fr. 🔥

---

🦋 MEMBERS 🦋

each of these is one field of the struct, and yes we are covering every single one, no skipping, we don't do that here:

• has_reset — tells you whether this SoC needs its reset deasserted. so like, if it's true, go deassert that reset bestie. ⭐
• pcm_formats — the PCM formats that are available. the menu of formats, basically. 🍓
• reg_offset_txdata — the offset of the tx fifo. yes, the fifo. the tx one. that offset. 💜
• sun4i_i2s_regmap — the regmap config to use. pointer to it, obviously. 🎀
• field_clkdiv_mclk_en — a regmap field, and it enables mclk output. that's the whole job. ✨
• field_fmt_wss — a regmap field that sets the word select size. wss = word select size, iykyk. 🌸
• field_fmt_sr — a regmap field that sets the sample resolution. sr = sample resolution, we love an abbreviation. 💅
• num_din_pins — the input pins. that's it, that's the description. 🫶
• num_dout_pins — the output pins, and ngl it's currently set but unused. so like, it's there, it's chilling, nobody's calling it. 💀
• bclk_dividers — the bit clock dividers array. an array of them. 💖
• num_bclk_dividers — the number of bit clock dividers. the count. the quantity. 🔥
• mclk_dividers — the mclk dividers array. same energy, different clock. 🦋
• num_mclk_dividers — the number of mclk dividers. yes, again, the count. 👑
• get_bclk_parent_rate — a callback to get the bclk parent rate. callback!! it's a function pointer, it does a thing. ⭐
• get_sr — a callback to get the sample resolution. returns an int, takes a width. 🌈
• get_wss — a callback to get the word select size. also returns an int, also takes a width. 🌸
• set_chan_cfg — a callback to set the channel configuration. it's the big one — takes the i2s struct plus channels, slots and slot_width. 💜
• set_fmt — a callback to set the format. takes the i2s struct and the fmt. 🎀

---

👑 SEE ALSO 👑

• Kernel file ./sound/soc/sunxi/sun4i-i2s.c — that's where all the real action lives, go read it bestie. 📖

---

lowkey reminder: this whole struct is just the differences between SoC variants, so if something behaves differently on your board than on someone else's, it's probably one of these fields being extra. 🙈

---

and that's the page!! it lives in ./sound/soc/sunxi, it's dated October 2026, and the manual page itself is titled struct sun4i_i2s_quirks(9) — okay bye bestie, go deassert some resets 💖✨🎀🦋