STRUCT CROS_EC_KEYB(9)

✨ NAME ✨

okay so bestie, this is the tea on struct cros_ec_keyb(9) from the Kernel API Manual 💅 it’s literally the structure representing EC keyboard device — the whole EC-keyboard-device vibe in one struct, no cap 🎀

🌸 SYNOPSIS 🌸

here’s the exact fit, bestie — keep it character for character or the compiler will absolutely side-eye you 😭

       struct cros_ec_keyb {
           unsigned int rows;
           unsigned int cols;
           int row_shift;
           bool ghost_filter;
           u8 valid_keys[CROS_EC_KEYBOARD_COLS_MAX];
           u8 old_kb_state[CROS_EC_KEYBOARD_COLS_MAX];
           struct device *dev;
           struct cros_ec_device *ec;
           struct input_dev *idev;
           struct input_dev *bs_idev;
           struct notifier_block notifier;
           struct vivaldi_data vdata;
           bool has_fn_map;
           bool fn_active;
           bool fn_combo_active;
        };

🎀 Members 🎀

okay now the member-by-member gossip — every single one is here, and yes we’re being thorough 💖

• rows — Number of rows in the keypad — literally the row count, bestie.
• cols — Number of columns in the keypad — the column count, periodt.
• row_shift — log2 or number of rows, rounded up — that’s the exact description, no cap.
• ghost_filter — true to enable the matrix key-ghosting filter — the ghosting-filter switch, cute.
• valid_keys — bitmap of existing keys for each matrix column — the existing-key bitmap for each matrix column 🦋
• old_kb_state — bitmap of keys pressed last scan — the keys-pressed-last-scan bitmap.
• dev — Device pointer — yep, just the device pointer.
• ec — Top level ChromeOS device to use to talk to EC — the top-level ChromeOS device you use to talk to the EC.
• idev — The input device for the matrix keys. — the matrix-keys input device.
• bs_idev — The input device for non-matrix buttons and switches (or NULL). — non-matrix buttons and switches input device, or NULL.
• notifier — interrupt event notifier for transport devices — the interrupt event notifier for transport devices.
• vdata — vivaldi function row data — the vivaldi function row data.
• has_fn_map — whether the driver uses an fn function-map layer — tells you whether the driver uses an fn function-map layer.
• fn_active — tracks whether the function key is currently pressed — tracks if the function key is pressed right now.
• fn_combo_active — tracks whether another key was pressed while fn is active — tracks if another key got pressed while fn is active.

💖 SEE ALSO 💖

• Kernel file ./drivers/input/keyboard/cros_ec_keyb.c
• struct cros_ec_bs_map(9)
• cros_ec_keyb_report_bs(9)
• cros_ec_keyb_info(9)
• cros_ec_keyb_query_switches(9)
• cros_ec_keyb_resume(9)
• cros_ec_keyb_register_bs(9)
• cros_ec_keyb_register_matrix(9)

xoxo bestie 💖 source/version: ./drivers/input/keyboard, date: October 2026, and the page is struct cros_ec_keyb(9). periodt. 👑