rmi_set_page(9)

✨ rmi_set_page(9) ✨

okay so bestie, welcome to the kernel API manual 💖 this one's a little function with a big job — let's get into it 🫶

---

💅 NAME 💅

rmi_set_page — set the RMI page, that's literally it, that's the whole vibe 🎀

---

✨ SYNOPSIS ✨

int rmi_set_page (struct hid_device *hdev , u8 page );

---

🌸 ARGUMENTS 🌸

• hdev — the pointer to the hid_device struct 👑 you know, the usual suspect
• page — the new page address, i.e. where we're headed 🦋

---

💜 DESCRIPTION 💜

okay so here's the situation ngl 😭 RMI devices have 16-bit addressing, but some of the physical implementations (like SMBus) only have 8-bit addressing. tragic, I know 💀

so RMI implements a page address at 0xff of every page, so we can reliably page addresses every 256 registers ✨ like, that's the whole trick, and it ate 🔥

⚠️ bestie listen to me: the page_mutex lock must be held when this function is entered. no cap, don't skip this 💅

Returns zero on success, non-zero on failure 🌈 (iconic return value behaviour, honestly)

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/hid/hid-rmi.c
• struct rmi_data(9)

---

🎀 the cute sign-off 🎀

this little page lives over in ./drivers/hid, dated October 2026, and it's part of the Kernel API Manual — periodt 💖 go forth and page responsibly, bestie 🧚⭐

rmi_set_page(9) … rmi_set_page(9) — yes it says it twice, it's giving symmetry 💅