ocores_wait(9)

🦋 ocores_wait(9) 🦋

okay bestie, this is the ocores_wait(9) page from the kernel API manual, and it's literally the “wait until something changes in a given register” icon. no cap, it's short but it ate. 💅

---

✨ NAME ✨

ocores_wait — wait until something changes in a given register. that's the whole vibe: you point it at a register, and it waits for the change you asked for.

📜 SYNOPSIS 📜

int ocores_wait (struct ocores_i2c *i2c , int reg , u8 mask , u8 val ,
       unsigned long timeout_us );

🧚 ARGUMENTS 🧚

• i2c — ocores I2C device instance. the device in question.
• reg — register to query. the register you're checking.
• mask — bitmask to apply on register value. the mask that gets applied, exactly as advertised.
• val — expected result. the value you're looking for.
• timeout_us — timeout in microseconds. the “not forever” number.

💖 DESCRIPTION 💖

A timeout is necessary so we don't stay here forever when the chip does not answer correctly. literally that's the safety net: the chip can ghost us, but the timeout means we don't just sit in the function being dramatic for eternity. 😭

no timeout = potential forever-stuck energy. the timeout is the moment that keeps the whole thing from becoming a horror movie.

🔥 RETURN 🔥

• 0 on success — slay, the wait worked.
• -ETIMEDOUT on timeout — the chip took too long, and we're out.

👑 SEE ALSO 👑

Kernel file ./drivers/i2c/busses/i2c-ocores.c plus these related besties:

• ocores_process_timeout(9)
• ocores_poll_wait(9)
• ocores_process_polling(9)

---

sign-off: this page lives in ./drivers/i2c/busses, dated October 2026, and it's the ocores_wait(9) manual page. periodt. 💖✨