STRUCT AK8974(9)

✨ NAME ✨

okay so struct ak8974 is the state container for the AK8974 driver, and this whole glow-up lives in the Kernel API Manual, section 9. bestie, it's giving “all the driver's remembered state in one iconic struct” 💅✨.

🦋 SYNOPSIS 🦋

       struct ak8974 {
           struct i2c_client *i2c;
           struct iio_mount_matrix orientation;
           struct regmap *map;
           struct regulator_bulk_data regs[2];
           const char *name;
           u8 variant;
           struct mutex lock;
           bool drdy_irq;
           struct completion drdy_complete;
           bool drdy_active_low;
           struct {
             __le16 channels[3];
             aligned_s64 ts;
           } scan;
        };

🔥 Members 🔥

• i2c — the parent I2C client, aka where this part is hanging out on the bus 🚌.
• orientation — the mounting matrix, so flipped axes and etc. get handled. very “we know her” 💅.
• map — the regmap used to access the AK8974 registers over I2C. slay.
• regs — the avdd and dvdd power regulators. a whole regs[2] situation 🔋.
• name — the name of the part. iconic, no notes.
• variant — the whoami ID value, used for selecting code paths. iykyk 🫶.
• lock — a mutex that locks the magnetometer for exclusive use during a measurement. no sharing, bestie 😤.
• drdy_irq — says it uses the DRDY IRQ line ⚡.
• drdy_complete — the completion for DRDY. it's literally waiting for that signal 😭.
• drdy_active_low — tells you the DRDY IRQ is active low.
• scan — timestamps. the nested struct holds __le16 channels[3] and aligned_s64 ts, and the manpage keeps it simple: timestamps ⏱️.

👑 SEE ALSO 👑

• Kernel file ./drivers/iio/magnetometer/ak8974.c — go read the source, bestie, it's right there 📖✨.

mwah 💋 — signed off from source ./drivers/iio/magnetometer, October 2026 edition. stay slay, stay compiled 🫶🌈