rmi_read(9)

🌸 rmi_read(9) — a Kernel API Manual moment 💅

okay so bestie, welcome to the <pink>rmi_read</pink> page, straight out of the <purple>Kernel API Manual</purple> ✨ this one is genuinely tiny and iconic and it does exactly one (1) thing. no cap.

---

💖 NAME 💖

rmi_read — read a single byte 🎀 like literally one. one byte. that's the whole vibe check.

---

✨ SYNOPSIS ✨

int rmi_read (struct rmi_device *d , u16 addr , u8 *buf );

that's it, that's the whole function signature 🫶 look at it. so clean. so main character energy.

---

🦋 ARGUMENTS 🦋

so you're passing in three things, and here's what each one is giving:

• d — pointer to an RMI device 💜 this is the device you're reading from, she's the one with the transport protocol iykyk
• addr — the address to read from 🎯 literally just tell it where, bestie
• buf — the read buffer 🍓 the memory that's gonna get the byte dropped into it

---

🌈 DESCRIPTION 🌈

okay so here's the whole deal 👑 rmi_read reads a single byte of data using the underlying transport protocol, and puts it into the memory that buf points to. that's it. one byte in, one byte out, no drama 💅

and the return value? it returns 0 on success 🥳 or a negative error code 😭 so like, if you get a negative number back, that's not a slay, that's an error — check it, don't ignore it, fr fr.

ngl bestie, always check that return value. a negative error code is the function telling you something went sideways 🙈

---

🧚 SEE ALSO 🧚

go read these next, they're all in the kernel file ./drivers/input/rmi4/rmi_bus.h and they're all linked below, no skipping ✨

• struct rmi_function(9)
• struct rmi_function_handler(9)
• rmi_reset(9)
• rmi_read_block(9)
• rmi_write(9)
• rmi_write_block(9)

like, rmi_read_block(9) is literally her bigger sister — if you need more than one byte, that's where you go 🦋

---

so yeah, that's rmi_read. one byte. three arguments. zero notes. periodt 💅

this page lives in ./drivers/input/rmi4 and was dated <pink>October 2026</pink>, so like… a little time capsule moment 🎀 mwah, hope this helped, love u, bye 💖✨🫶