手把手教你为嵌入式设备编写一个简单的电池驱动（基于Linux Power Supply框架）

手把手教你为嵌入式设备编写一个简单的电池驱动基于Linux Power Supply框架当你拿到一款新的嵌入式设备尤其是带有电池的便携式产品时如何快速为其开发一个可靠的电池状态监控驱动Linux内核提供的Power Supply子系统正是为此而生。不同于传统的字符设备或块设备驱动电源管理驱动有其独特的架构和设计哲学。1. 开发环境准备与基础概念在开始编写驱动之前我们需要先搭建好开发环境并理解几个核心概念。嵌入式Linux驱动开发通常需要目标设备的交叉编译工具链与设备内核版本匹配的内核源码树电池管理IC的数据手册基本的硬件调试工具如逻辑分析仪、万用表等Power Supply子系统的核心思想是将各种电源设备电池、USB充电器、AC适配器等抽象为统一的软件接口。每个电源设备在内核中表现为一个power_supply结构体实例通过sysfs向用户空间暴露标准化的属性接口。典型的电池驱动需要关注以下属性enum power_supply_property { POWER_SUPPLY_PROP_STATUS, // 充电状态 POWER_SUPPLY_PROP_CAPACITY, // 剩余电量百分比 POWER_SUPPLY_PROP_VOLTAGE_NOW, // 当前电压 POWER_SUPPLY_PROP_TEMP, // 电池温度 // ...其他属性根据硬件支持情况添加 };提示在开始编码前务必仔细阅读电池管理IC的数据手册确定其支持的通信接口I2C/SPI/SMBus等和寄存器映射。2. 驱动框架搭建与初始化创建一个基础的Power Supply驱动需要遵循Linux设备驱动的标准模式。我们以Platform Driver为例#include linux/power_supply.h #include linux/platform_device.h struct my_battery { struct power_supply *psy; struct i2c_client *client; // 其他设备特定数据 }; static int my_battery_probe(struct platform_device *pdev) { struct my_battery *battery; struct power_supply_config psy_cfg {}; // 分配设备结构体 battery devm_kzalloc(pdev-dev, sizeof(*battery), GFP_KERNEL); if (!battery) return -ENOMEM; // 初始化power_supply描述 battery-psy_desc.name battery; battery-psy_desc.type POWER_SUPPLY_TYPE_BATTERY; battery-psy_desc.properties my_battery_props; battery-psy_desc.num_properties ARRAY_SIZE(my_battery_props); battery-psy_desc.get_property my_battery_get_property; // 注册power_supply设备 psy_cfg.drv_data battery; battery-psy devm_power_supply_register(pdev-dev, battery-psy_desc, psy_cfg); if (IS_ERR(battery-psy)) return PTR_ERR(battery-psy); // 初始化硬件接口如I2C battery-client i2c_get_client_device(...); platform_set_drvdata(pdev, battery); return 0; } static const struct of_device_id my_battery_of_match[] { { .compatible vendor,battery-ic }, {}, }; MODULE_DEVICE_TABLE(of, my_battery_of_match); static struct platform_driver my_battery_driver { .driver { .name my-battery, .of_match_table my_battery_of_match, }, .probe my_battery_probe, }; module_platform_driver(my_battery_driver);关键点解析power_supply_desc结构体定义了设备的基本属性和回调函数devm_power_supply_register是资源管理版本的注册函数设备树兼容性字符串应与硬件匹配3. 属性获取与硬件交互驱动最核心的部分是实现属性获取回调函数这需要与硬件实际交互static enum power_supply_property my_battery_props[] { POWER_SUPPLY_PROP_STATUS, POWER_SUPPLY_PROP_HEALTH, POWER_SUPPLY_PROP_PRESENT, POWER_SUPPLY_PROP_VOLTAGE_NOW, POWER_SUPPLY_PROP_CURRENT_NOW, POWER_SUPPLY_PROP_CAPACITY, POWER_SUPPLY_PROP_TEMP, }; static int my_battery_get_property(struct power_supply *psy, enum power_supply_property psp, union power_supply_propval *val) { struct my_battery *battery power_supply_get_drvdata(psy); int ret 0; switch (psp) { case POWER_SUPPLY_PROP_STATUS: val-intval read_battery_status(battery); break; case POWER_SUPPLY_PROP_CAPACITY: val-intval read_battery_soc(battery); break; case POWER_SUPPLY_PROP_VOLTAGE_NOW: val-intval read_battery_voltage(battery); break; // 其他属性处理... default: ret -EINVAL; break; } return ret; }硬件访问示例假设使用I2C接口static int read_battery_voltage(struct my_battery *battery) { u8 reg VOLTAGE_REGISTER; u16 raw_value; // 读取电压寄存器 int ret i2c_smbus_read_word_data(battery-client, reg); if (ret 0) return ret; raw_value (u16)ret; // 根据数据手册转换原始值为微伏 return (raw_value * 1000) / 2; // 示例转换公式 }注意实际硬件寄存器地址和转换公式需参考具体芯片手册。某些高级电池管理IC可能还需要解锁寄存器访问等额外步骤。4. 状态监控与事件通知电池状态需要持续监控常见实现方式有两种中断驱动利用硬件提供的中断引脚如低电量警报轮询方式定时器定期检查状态变化中断方式实现示例static irqreturn_t battery_irq_handler(int irq, void *dev_id) { struct my_battery *battery dev_id; // 读取中断状态寄存器确定事件类型 u8 status i2c_smbus_read_byte_data(battery-client, STATUS_REG); if (status LOW_BATTERY_BIT) { pr_info(Low battery warning!\n); } // 通知power supply子系统状态变化 power_supply_changed(battery-psy); return IRQ_HANDLED; }轮询方式实现示例static void battery_monitor_work(struct work_struct *work) { struct my_battery *battery container_of(work, struct my_battery, monitor_work.work); // 检查状态变化 int old_soc battery-last_soc; int new_soc read_battery_soc(battery); if (old_soc ! new_soc) { battery-last_soc new_soc; power_supply_changed(battery-psy); } // 重新调度工作队列例如每30秒检查一次 schedule_delayed_work(battery-monitor_work, msecs_to_jiffies(30000)); }调试技巧通过sysfs查看驱动状态cat /sys/class/power_supply/battery/status cat /sys/class/power_supply/battery/capacity使用内核日志观察驱动行为dmesg | grep battery模拟状态变化测试驱动响应echo 50 /sys/class/power_supply/battery/capacity5. 高级功能与优化基础功能实现后可以考虑添加以下增强功能温度补偿static int get_compensated_capacity(struct my_battery *battery, int raw_soc) { int temp read_battery_temp(battery); // 简单的线性温度补偿 if (temp 10) return raw_soc - (10 - temp); else if (temp 45) return raw_soc - (temp - 45); return raw_soc; }充电曲线优化static int calculate_time_to_full(struct my_battery *battery) { int current_ma read_battery_current(battery); int capacity_mah battery-design_capacity; int remaining_mah (capacity_mah * battery-soc) / 100; if (current_ma 0) // 不在充电状态 return -1; return (capacity_mah - remaining_mah) * 3600 / current_ma; }电源路径管理适用于同时有电池和外部电源的设备static void handle_power_source_change(struct my_battery *battery) { if (is_external_power_connected()) { // 切换到外部电源供电 set_charge_current(MAX_CHARGE_CURRENT); } else { // 切换到电池供电 set_charge_current(0); limit_power_consumption(); } power_supply_changed(battery-psy); }常见问题排查表问题现象可能原因解决方案sysfs属性不显示属性未在驱动中定义检查power_supply_property数组电量显示不更新未调用power_supply_changed在状态变化时触发通知读取值不正确寄存器解析错误验证数据手册和转换公式驱动加载失败设备树配置错误检查compatible字符串和资源定义6. 设备树配置与内核集成要让驱动正常工作通常需要配置设备树battery: battery55 { compatible vendor,battery-ic; reg 0x55; interrupt-parent gpio; interrupts 17 IRQ_TYPE_EDGE_FALLING; monitored-battery main_battery; // 电池参数 voltage-min-design-microvolt 3000000; voltage-max-design-microvolt 4200000; energy-full-design-microwatt-hours 10000000; };内核配置选项CONFIG_POWER_SUPPLYy CONFIG_BATTERY_MY_VENDORy # 你的驱动配置项在驱动中解析设备树参数static int parse_dt(struct device *dev, struct my_battery *battery) { struct device_node *np dev-of_node; if (!np) return -ENODEV; of_property_read_u32(np, voltage-min-design-microvolt, battery-min_voltage); of_property_read_u32(np, voltage-max-design-microvolt, battery-max_voltage); // 其他参数解析... return 0; }7. 用户空间交互与系统集成完整的电池解决方案还需要用户空间配合uevent通知 当驱动调用power_supply_changed()时内核会发送uevent用户空间服务如upower可以监听并处理这些事件。典型的uevent内容POWER_SUPPLY_NAMEbattery POWER_SUPPLY_STATUSCharging POWER_SUPPLY_CAPACITY85 POWER_SUPPLY_VOLTAGE_NOW4200000Android电源管理集成 Android系统通过BatteryService监听这些属性变化更新系统状态并触发相关广播。低电量处理策略static void check_low_battery(struct my_battery *battery) { if (battery-soc LOW_BATTERY_THRESHOLD) { // 触发低电量通知 battery-psy_desc.set_property my_battery_set_property; power_supply_changed(battery-psy); // 可以在这里限制设备性能以延长续航 if (battery-soc CRITICAL_BATTERY_THRESHOLD) { initiate_graceful_shutdown(); } } }在实际项目中电池驱动的稳定性至关重要。建议添加充分的错误处理和恢复机制比如I2C通信失败时的重试逻辑以及无效寄存器值的过滤处理。