STRUCT W1_UART_DEVICE(9)

🌸 NAME 🌸

struct w1_uart_device — the 1-Wire UART device structure, bestie 💖

okay so like, quick vibe check: this is from the Kernel API Manual, section 9, and it's the little struct that holds literally everything a 1-Wire-over-UART device needs to function. it's giving "main character energy" for the whole driver ngl 🎀

✨ SYNOPSIS ✨

struct w1_uart_device {
    struct serdev_device *serdev;
    struct w1_bus_master bus;
    struct w1_uart_config cfg_reset;
    struct w1_uart_config cfg_touch_0;
    struct w1_uart_config cfg_touch_1;
    struct completion rx_byte_received;
    struct mutex rx_mutex;
    int rx_err;
    u8 rx_byte;
 };

like yes, that's the whole glow-up 💅 copy it exactly, no cap.

🦋 Members 🦋

• serdev — the serial device, aka the actual hardware bestie this whole thing rides on 🫶
• bus — the w1-bus master, the icon that runs the 1-Wire show 👑
• cfg_reset — the config for a 1-Wire reset ✨
• cfg_touch_0 — the config for a 1-Wire write-0 cycle 💀 (yes, zero, that's not a typo)
• cfg_touch_1 — the config for a 1-Wire write-1 and read cycle 🌈 two jobs, one struct field, we love a multitasker
• rx_byte_received — completion for serdev receive, aka the "omg the byte arrived!!" notification 🎀
• rx_mutex — a mutex to protect rx_err and rx_byte, because sharing is caring but also race conditions are not it 🙈
• rx_err — indicates an error in serdev-receive 😭
• rx_byte — the result byte from serdev-receive 🍓

lowkey important: rx_mutex guards rx_err and rx_byte together. don't be out here touching those two without it, fr fr.

🔥 SEE ALSO 🔥

• Kernel file ./drivers/w1/masters/w1-uart.c
• struct w1_uart_config(9)
• struct w1_uart_limits(9)

go read those next, iykyk 💜

and that's the tea, bestie ☕ this page lives under Kernel file ./drivers/w1/masters, dated October 2026 — slay, go write some 1-Wire code, periodt 💅✨