STRUCT OMNIA_MCU(9)

💖 struct omnia_mcu(9) 💖

okay so bestie, welcome to the Kernel API Manual page for struct omnia_mcu — yes that's section 9, the kernel internals section, we love her 💅. This is the driver's own private little data structure, and I'm gonna walk you through every single field so you can actually read this header without spiraling 🫶.

---

✨ NAME ✨

struct omnia_mcu — driver private data structure

yeah that's it that's the name, short and iconic 👑

---

🌸 SYNOPSIS 🌸

struct omnia_mcu {
    struct i2c_client *client;
    const char *type;
    u32 features;
    u64 board_serial_number;
    u8 board_first_mac[ETH_ALEN];
    u8 board_revision;
  #ifdef CONFIG_TURRIS_OMNIA_MCU_GPIO;
    struct gpio_chip gc;
    struct mutex lock;
    unsigned long mask, rising, falling, both, cached, is_cached;
    struct delayed_work button_release_emul_work;
    unsigned long last_status;
    bool button_pressed_emul;
  #endif;
  #ifdef CONFIG_TURRIS_OMNIA_MCU_SYSOFF_WAKEUP;
    struct rtc_device *rtcdev;
    u32 rtc_alarm;
    bool front_button_poweron;
  #endif;
  #ifdef CONFIG_TURRIS_OMNIA_MCU_WATCHDOG;
    struct watchdog_device wdt;
  #endif;
  #ifdef CONFIG_TURRIS_OMNIA_MCU_TRNG;
    struct hwrng trng;
    struct completion trng_entropy_ready;
  #endif;
  #ifdef CONFIG_TURRIS_OMNIA_MCU_KEYCTL;
    struct completion msg_signed;
    struct mutex sign_lock;
    bool sign_requested;
    int sign_err;
    u8 signature[OMNIA_MCU_CRYPTO_SIGNATURE_LEN];
    u8 board_public_key[OMNIA_MCU_CRYPTO_PUBLIC_KEY_LEN];
  #endif;
 };

not me obsessing over how half the fields are wrapped in #ifdefs 😭 like she's modular, she's customizable, she adapts to your config — main character energy fr fr 💜

---

🎀 Members 🎀

okay bestie, here's the whole cast, one by one, no skips, no shortcuts 🌈

• client — the I2C client 🦋
• type — the MCU type, and it can be STM32, GD32, MKL, or unknown 👀
• features — a bitmap of the features the MCU firmware supports ✨
• board_serial_number — the board serial number, but only if it's stored in the MCU 💾
• board_first_mac — the board's first MAC address, again only if it's stored in the MCU 🍓
• board_revision — the board revision, if it's stored in the MCU (spotting a theme here? yes 💅)
• gc — the GPIO chip
• lock — a mutex protecting the internal GPIO chip state 🔒
• mask — bitmap of masked IRQs 🎀
• rising — bitmap of rising edge IRQs ⬆️
• falling — bitmap of falling edge IRQs ⬇️
• both — bitmap of both edges IRQs 🔥
• cached — bitmap of cached IRQ line values. The way this works: when an IRQ line is configured for both edges, we cache the corresponding GPIO values in the IRQ handler 🧠
• is_cached — bitmap of which IRQ line values are cached
• button_release_emul_work — front button release emulation work, used with old MCU firmware versions that didn't send button release events and only sent button press events 🙈
• last_status — the cached value of the status word, which gets compared against the new value to figure out which interrupt events actually happened. Used with old MCU firmware versions that only told us that the status word changed, but not which bits of the status word changed 💀
• button_pressed_emul — the front button is still being emulated as pressed 👑
• rtcdev — the RTC device. Plot twist: it doesn't actually count real-time 🕰️ it's only used for the RTC alarm mechanism, so that the board can be configured to wake up from poweroff state at a specific time ⏰
• rtc_alarm — the RTC alarm that was set for the board to wake up on, expressed in MCU time (that's seconds since the last MCU reset) 🌸
• front_button_poweron — whether the front button should power on the device after it's been powered off 🔌
• wdt — the watchdog driver structure 🐕
• trng — the RNG driver structure 🎲
• trng_entropy_ready — the RNG entropy ready completion ✅
• msg_signed — the message signed completion ✍️
• sign_lock — a mutex protecting the message signing state 🔐
• sign_requested — a flag saying that message signing was requested but not completed yet ⏳
• sign_err — the message signing error number, filled in by the interrupt handler 🚨
• signature — the message signing signature, also filled in by the interrupt handler 🖊️
• board_public_key — the board public key, if it's stored in the MCU 🔑

---

💅 SEE ALSO 💅

• Kernel file ./drivers/platform/cznic/turris-omnia-mcu.h

iykyk, go read the header, it's right there 🧚

---

okay that's the whole page bestie, you ate that 🫶. This one came to you from ./drivers/platform/cznic, dated October 2026, and it's struct omnia_mcu(9) — the Kernel API Manual. mwah 💖⭐