STRUCT I2C_BUS_RECOVERY_INFO(9)

✨ struct i2c_bus_recovery_info ✨

Okay so bestie, this is the kernel API manual for struct i2c_bus_recovery_info — it's literally the whole vibe for I2C bus recovery info 💅. If your I2C bus is acting up and needs a glow-up, this struct is the main character energy you need. Let's get into it fr fr.

---

🌸 NAME 🌸

struct i2c_bus_recovery_info — I2C bus recovery information 💖

---

🦋 SYNOPSIS 🦋

struct i2c_bus_recovery_info {
    int (*recover_bus)(struct i2c_adapter *adap);
    int (*get_scl)(struct i2c_adapter *adap);
    void (*set_scl)(struct i2c_adapter *adap, int val);
    int (*get_sda)(struct i2c_adapter *adap);
    void (*set_sda)(struct i2c_adapter *adap, int val);
    int (*get_bus_free)(struct i2c_adapter *adap);
    void (*prepare_recovery)(struct i2c_adapter *adap);
    void (*unprepare_recovery)(struct i2c_adapter *adap);
    struct gpio_desc *scl_gpiod;
    struct gpio_desc *sda_gpiod;
    struct pinctrl *pinctrl;
    struct pinctrl_state *pins_default;
    struct pinctrl_state *pins_gpio;
 };

---

🎀 Members 🎀

Let's do a little member-by-member tour, because each one is iconic in its own way 👑

• recover_bus — the actual recover routine, the star of the show. You either pass in your driver's own recover_bus routine, or you go with i2c_generic_scl_recovery. Slay.
• get_scl — this one gets the current value of the SCL line, like checking the temperature of the situation. It's mandatory for generic SCL recovery. And for generic GPIO recovery? It gets populated internally, no cap. 🫶
• set_scl — sets and clears the SCL line. Mandatory for generic SCL recovery, bestie. Populated internally for generic GPIO recovery. It's giving "I handle my own business."
• get_sda — grabs the current value of the SDA line. This or set_sda is mandatory for generic SCL recovery. If sda_gpio is a valid GPIO, it gets populated internally for generic GPIO recovery. 💫
• set_sda — sets and clears the SDA line. This or get_sda is mandatory for generic SCL recovery. Populated internally if sda_gpio is a valid GPIO, for generic GPIO recovery. Periodt.
• get_bus_free — returns the bus free state as seen from the IP core, for when it has more complex internal logic than just reading SDA. Totally optional, lowkey. 😌
• prepare_recovery — this gets called before starting recovery. Your platform can configure padmux here for the SDA/SCL line, or whatever else they want. Do your little pre-game ritual 💅
• unprepare_recovery — called after completing recovery. Platform may configure padmux here for SDA/SCL line, or anything else they want. The post-game debrief, if you will ✨
• scl_gpiod — the gpiod of the SCL line. Only required for GPIO recovery, bestie.
• sda_gpiod — the gpiod of the SDA line. Again, only required for GPIO recovery.
• pinctrl — the pinctrl used by GPIO recovery to change the state of the I2C pins. Optional, no pressure 🌈
• pins_default — default pinctrl state of SCL/SDA lines when they're assigned to the I2C bus. Optional. It gets populated internally for GPIO recovery if a state named PINCTRL_STATE_DEFAULT is found and pinctrl is valid. 💖
• pins_gpio — recovery pinctrl state of SCL/SDA lines when they're used as GPIOs. Optional. Populated internally for GPIO recovery if this state is called "gpio" or "recovery" and pinctrl is valid. Obsessed with the flexibility ngl.

---

🔥 SEE ALSO 🔥

Kernel file ./include/linux/i2c.h — plus the whole friend group:

i2c_master_recv(9), i2c_master_recv_dmasafe(9), i2c_master_send(9), i2c_master_send_dmasafe(9), struct i2c_device_identity(9), enum i2c_driver_flags(9), struct i2c_driver(9), struct i2c_client(9), struct i2c_board_info(9), I2C_BOARD_INFO(9), struct i2c_algorithm(9), struct i2c_lock_operations(9), struct i2c_timings(9), struct i2c_adapter_quirks(9), i2c_lock_bus(9), i2c_trylock_bus(9), i2c_unlock_bus(9), i2c_mark_adapter_suspended(9), i2c_mark_adapter_resumed(9), i2c_check_quirks(9), module_i2c_driver(9), builtin_i2c_driver(9)

---

Fr fr, if you're doing I2C bus recovery, this struct is your bestie. Don't skip the mandatory members or the vibe check will fail 😭

---

Okay that's the whole page, bestie! This came from ./include/linux, October 2026 edition — and yes, it's literally titled struct i2c_b...ecovery_info(9) in the footer because the terminal was being dramatic and truncating. Iconic behavior honestly 💅✨