STRUCT I2C_TIMINGS(9)

💅 struct i2c_timings — like, the whole vibe of I2C timing, explained

okay so bestie, welcome to the Kernel API Manual ✨ this one's a struct page, which means it's basically a little ✨glossary✨ of every knob your I2C bus can turn. no cap, it's short but it's important, so let's get into it 🎀

---

🌸 NAME 🌸

struct i2c_timings — literally just "I2C timing information". that's the whole thing. that's the tweet 🦋

---

✨ SYNOPSIS ✨

here's the icon itself, bestie — every field, character for character, do not touch 🫶

struct i2c_timings {
    u32 bus_freq_hz;
    u32 scl_rise_ns;
    u32 scl_fall_ns;
    u32 scl_int_delay_ns;
    u32 sda_fall_ns;
    u32 sda_hold_ns;
    u32 digital_filter_width_ns;
    u32 analog_filter_cutoff_freq_hz;
 };

---

🎀 Members 🎀

okay this is the main character section, let's go one by one 💖

• bus_freq_hz — the bus frequency, in Hz. the speed. the tempo. the beat the bus dances to 🕺
• scl_rise_ns — how long the SCL signal takes to rise, in ns. that's t(r) in the I2C specification, iykyk 📈
• scl_fall_ns — how long SCL takes to fall, in ns. yes, that's t(f) in the I2C specification 📉
• scl_int_delay_ns — the extra time the IP core needs to, like, set up SCL, in ns. extra setup era ⏳
• sda_fall_ns — how long SDA takes to fall, in ns. also t(f) in the I2C specification (yes it's the same symbol, no I'm not making that up 😭)
• sda_hold_ns — the extra time the IP core needs to hold SDA, in ns. hold it. don't let go. 🫶
• digital_filter_width_ns — the width, in ns, of spikes on the i2c lines that the IP core's digital filter can filter out. so like, the little noise gremlins it can yeet 💀
• analog_filter_cutoff_freq_hz — the threshold frequency for the low pass IP core analog filter. the cutoff. the line. 🌈

---

👑 SEE ALSO 👑

the whole friend group, in the exact order they showed up 💜

kernel file ./include/linux/i2c.h, and then:

• 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_bus_recovery_info(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)

---

ok that's the whole page, you ate that 💅 now go set your scl_rise_ns correctly or the bus will simply not slay.

---

and that's a wrap, bestie 🎀 brought to you by ./include/linux, dated October 2026, and yes the header is struct i2c_timings(9) — iconic, no notes ⭐