STRUCT HID_BATTERY(9)

✨ struct hid_battery(9) ✨

okay so bestie, welcome to the <pink>Kernel API Manual</pink> 💅 this whole page is about struct hid_battery — and it literally represents a single battery power supply 🔋 like, one (1) battery, living its main character life inside HID land 🎀

🌸 SYNOPSIS 🌸

struct hid_battery {
    struct hid_device *dev;
    struct power_supply *ps;
    __s32 min;
    __s32 max;
    __s32 report_type;
    __s32 report_id;
    __s32 report_offset;
    __s32 charge_status;
    enum hid_battery_status status;
    __s32 capacity;
    bool avoid_query;
    bool present;
    ktime_t ratelimit_time;
    struct list_head list;
 };

no cap, that's the whole vibe right there 👑 now let's do a member-by-member vibe check 🕵️‍♀️

🦋 Members 🦋

• dev — pointer to the parent hid_device 💖 like, who's your parent bestie, that's who this is
• ps — the power supply instance ⚡ that's the actual power-supply object doing the work
• min — minimum battery value from HID descriptor 🍓 the floor, the bare minimum, we've all been there
• max — maximum battery value from HID descriptor 🌈 the ceiling, the full-glow moment
• report_type — HID report type (input/feature) 🎀 like, which flavor of report is this
• report_id — HID report ID for this battery 🏷️ gotta know which report belongs to this battery specifically
• report_offset — bit offset of the capacity field within its report 🧚 that's where in the report the capacity field is chillin'
• charge_status — current charging status 🔌 like, are we charging or not, bestie
• status — battery reporting status 💀 the status of the battery's reporting, yep that's the whole bit
• capacity — current battery capacity (0-100) 💯 literally a percentage, iconic range, no notes
• avoid_query — if true, avoid querying battery (e.g., for stylus) 🙈 so like if it's true, don't go querying the battery — think stylus situations
• present — if true, battery is present (may be dynamic) ✨ key word: may be dynamic, so it can change on you, don't get too attached
• ratelimit_time — rate limiting for battery reports ⏳ yes queen, throttle those reports
• list — list node for linking into hid_device's battery list 🔗 that's the link-up energy, adding this battery into the hid_device's battery list

💜 SEE ALSO 💜

• Kernel file ./include/linux/hid.h 📁
• HID quirks(9)
• struct hid_driver(9)
• struct hid_ll_driver(9)
• module_hid_driver(9)
• hid_device_io_start(9)
• hid_device_io_stop(9)
• hid_map_usage(9)
• hid_map_usage_clear(9)
• hid_parse(9)
• hid_hw_power(9)
• hid_hw_idle(9)
• hid_hw_may_wakeup(9)
• hid_hw_wait(9)
• hid_report_len(9)

bestie heads up: every one of those is written (9) which means kernel API section 9 — that's the section, not part of the name 🫶

okay that's the whole page, mwah 💋 this came from ./include/linux, dated October 2026, and it's filed under struct hid_battery(9) — slay, go read the kernel source, ily, bye 🧚✨👑