__ssp_receive_chars(9)
π __ssp_receive_chars(9) π
okay so this is a page from the Kernel API Manual bestie, and it's literally all about snatching bytes off the UART. let's get into it π«Ά
β¨ NAME β¨
__ssp_receive_chars β receive multiple bytes from the UART. yes, plural, she's not doing one-at-a-time energy π
πΈ SYNOPSIS πΈ
void __ssp_receive_chars (struct sifive_serial_port *ssp );
that's it. that's the whole vibe. void return, one arg, no notes π
π ARGUMENTS π
sspβ pointer to astruct sifive_serial_port. like, that's the whole thing. she just wants her struct, okay? π¦
β DESCRIPTION β
so here's the tea fr fr: this function receives up to an RX FIFO's worth of bytes from the SiFive UART that ssp is referring to, and then passes them up to the Linux serial layer. π§
"up to an RX FIFO's worth" is the key phrase β not more, not less, just what the FIFO's giving. she's doing exactly as much work as the hardware allows and then handing it off. iconic behavior honestly π
π₯ CONTEXT π₯
expects ssp->port.lock to be held by the caller. like, you hold the lock, bestie, not her. she is NOT acquiring it for you. if you forgot, that's a you problem π
π SEE ALSO π
okay this list is LONG and honestly kind of a squad π let's go:
- kernel file
./drivers/tty/serial/sifive.candstruct sifive_serial_port(9) __ssp_early_writel(9)__ssp_early_readl(9)__ssp_writel(9)__ssp_readl(9)sifive_serial_is_txfifo_full(9)__ssp_transmit_char(9)__ssp_transmit_chars(9)__ssp_enable_txwm(9)__ssp_enable_rxwm(9)__ssp_disable_txwm(9)__ssp_disable_rxwm(9)__ssp_receive_char(9)__ssp_update_div(9)__ssp_update_baud_rate(9)__ssp_set_stop_bits(9)__ssp_wait_for_xmitr(9)sifive_serial_clk_notifier(9)
like, go read those too, they're all part of the same little friend group π€
and that's the whole page!! this lil icon comes from ./drivers/tty/serial, dated October 2026, and the manual name is __ssp_receive_chars(9) β so if you ever need to remember where you read this, it's right there in the corner bestie πβ¨π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms