th1520_aon_call_rpc(9)

📦 version 7.3.1, in nixpkgs unstable

💅 th1520_aon_call_rpc(9) — Kernel API Manual, bestie edition

okay so this is from the Linux kernel API manual (section 9, the kernel-internals girlies 🧚) and it's about th1520_aon_call_rpc — the little function that picks up the phone and calls the TH1520 AON subsystem. no cap, it's lowkey important.

✨ NAME ✨

th1520_aon_call_rpc — send an RPC request to the TH1520 AON subsystem 🎀

🌸 SYNOPSIS 🌸

int th1520_aon_call_rpc (struct th1520_aon_chan *aon_chan , void *msg );

literally that's the whole signature. she's neat, she's tidy, she takes two pointers and gives you back an int. periodt. 👑

🦋 ARGUMENTS 🦋

  • aon_chan — a pointer to the AON channel structure. that's your lil phone, bestie 💖
  • msg — a pointer to the message (the RPC payload) that's gonna get sent. this is what you're actually saying on the call 📨

💜 DESCRIPTION 💜

so what she does is: this function sends an RPC message to the TH1520 AON subsystem via mailbox 📬. like, it's giving postal service but make it firmware.

she takes the msg buffer you handed her, formats it with version and service flags (it's giving ✨ putting on the lil outfit before the message goes out), and then she blocks until the RPC completes or times out. not "blocks" like a toxic ex, blocks like a synchronous kernel function. she is waiting, bestie 😭

the completion gets signaled by the aon_chan->done completion, which she waits on for a duration defined by MAX_RX_TIMEOUT ⏳. so that's the vibe check — if it doesn't come through in that window, we move on.

🔥 RETURN 🔥

  • 0 — slay! success ✨
  • -ETIMEDOUT — the RPC call timed out. she waited, it didn't show. we've all been there 💀
  • a negative error code — if the mailbox send fails, or if AON responds with a non-zero error code (that one gets converted via th1520_aon_to_linux_errno). so like, the error gets a whole translation, iykyk 🫶
ngl, always check the return value. 0 is the only happy path here — everything else is a negative number and she will notice 🙈

👑 SEE ALSO 👑

the whole friend group, fr fr 🌈

and that's the page!! brought to you by ./drivers/firmware, dated October 2026 — from the Kernel API Manual girlies, with love 💅💖🎀

📦 where this page comes from