cci_read(9)

💖 cci_read(9) — like, the CCI register reader bestie 💖

okay so welcome to the Kernel API Manual page for cci_read(9), and honestly? she's a little legend. this is the function you call when you just wanna grab one single value out of one single CCI register. no drama, no fuss, one register, one read. periodt. ✨

---

🌸 NAME 🌸

cci_read — read a value from a single CCI register

like, exactly one. one register. a single little value. she's not doing a whole batch for you, that's a different function's job (see SEE ALSO, iykyk 💅).

---

🦋 SYNOPSIS 🦋

int cci_read (struct regmap *map , u32 reg , u64 *val , int *err );

look at her. four arguments. iconic behavior. 🎀

---

✨ ARGUMENTS ✨

• map — the register map you're reading from. this is the vibe check of where the bits live. 🗺️
• reg — the register address you wanna read. and listen, bestie, use the CCI_REG#() macros to encode the reg width, okay? don't just rawdog the number in there. 🙈
• val — pointer to where the read value gets stored. she reads it, she drops it in here. that's the whole deal. 💖
• err — optional pointer for storing errors. and here's the tea: if a previous error is already set, then the read gets skipped entirely. no cap. so if you're passing this in, know that an errored-out err means nothing gets read at all. 🫶

---

🔥 RETURN 🔥

0 on success, or a negative error code on failure. that's it, that's the whole return situation. slay. ⭐

---

👑 SEE ALSO 👑

if you're obsessed (and you should be), go check these out too:

• Kernel file ./include/media/v4l2-cci.h
• struct cci_reg_sequence(9)
• cci_write(9)
• cci_update_bits(9)
• cci_multi_reg_write(9)
• devm_cci_regmap_init_i2c(9)

---

💀 friendly reminder: that err pointer is optional, but if it's already carrying a previous error in it, the read is skipped. so don't be out here expecting a fresh value with a stale error sitting in there. understand the assignment. 🧚

---

and that's the page!! mwah 💋 this little writeup lives in ./include/media, dated October 2026, and if you ever forget her name just remember: cci_read(9). bestie behavior from start to finish. 🌈🦋💜