荔枝派Nano电池电量监控实战：用F1C100s的LRADC做个简易电量计（附完整驱动代码）

荔枝派Nano电池监控系统开发指南：从硬件设计到软件实现

荔枝派Nano作为一款性价比极高的嵌入式开发板，在便携式设备和物联网项目中广受欢迎。但很多开发者在使用过程中都会遇到一个共同的问题：如何准确监测电池电量？本文将带你从零开始构建一个完整的电池监控系统，涵盖硬件电路设计、Linux驱动开发、用户空间应用编写以及校准测试全流程。

1. 锂电池特性与分压电路设计

锂电池因其高能量密度和稳定的放电特性，成为便携设备的首选电源。典型的3.7V锂电池工作电压范围在4.2V（满电）到2.75V（放电截止）之间。F1C100s芯片内置的LRADC（Low Resolution Analog to Digital Converter）模块最大只能检测0-2V的电压，因此需要设计合适的分压电路。

1.1 分压电阻计算与选型

分压电路的设计需要考虑几个关键因素：

• ADC输入范围限制（0-2V）
• 电阻功耗（应尽量减小电流消耗）
• 电阻精度（至少5%精度，1%更佳）

常见的分压电阻组合如下表所示：

选择330K/300K组合的优势在于：

• 满电时正好达到ADC上限2V，充分利用ADC量程
• 功耗极低，不会显著影响电池续航
• 常见阻值，容易采购

计算分压比的公式为：

V_adc = V_bat * (R2 / (R1 + R2))

1.2 硬件连接示意图

完整的硬件连接应包括：

1. 锂电池正极接R1（330K）
2. R1另一端接R2（300K）和LRADC输入引脚
3. R2另一端接地
4. 建议在ADC输入引脚添加0.1μF滤波电容

注意：实际布线时应尽量缩短ADC引线长度，避免引入噪声干扰

2. Linux驱动开发实战

F1C100s的LRADC模块寄存器配置相对简单，但需要注意几个关键点才能获得稳定读数。

2.1 寄存器配置详解

LRADC主要涉及三个寄存器：

• LRADC_CTRL：控制采样率、通道选择等
• LRADC_INTC：中断控制
• LRADC_DATA0：通道0的采样数据

关键配置参数如下：

#define FIRST_CONVERT_DLY(x) ((x) << 24) /* 首次转换延迟 */ #define LEVELA_B_CNT(x) ((x) << 8) /* 电平检测计数 */ #define HOLD_EN(x) ((x) << 6) /* 保持使能 */ #define SAMPLE_RATE(x) ((x) << 2) /* 采样率 */ #define ENABLE(x) ((x) << 0) /* 模块使能 */

推荐的初始化配置为：

writel(FIRST_CONVERT_DLY(2) | LEVELA_B_CNT(2) | HOLD_EN(1) | SAMPLE_RATE(0) | ENABLE(1), KEYADC_CTRL_REG);

2.2 完整驱动代码实现

下面是一个经过优化的字符设备驱动实现：

#include <linux/module.h> #include <linux/fs.h> #include <linux/io.h> #include <linux/miscdevice.h> #define LRADC_BASE 0x01C23400 #define LRADC_CTRL 0x00 #define LRADC_DATA0 0x0c static volatile unsigned int *lradc_ctrl; static volatile unsigned int *lradc_data; static int lradc_open(struct inode *inode, struct file *file) { lradc_ctrl = ioremap(LRADC_BASE + LRADC_CTRL, 4); lradc_data = ioremap(LRADC_BASE + LRADC_DATA0, 4); if (!lradc_ctrl || !lradc_data) { printk(KERN_ERR "Failed to ioremap LRADC registers\n"); return -EFAULT; } // 配置LRADC：2个时钟延迟，采样率最低，持续模式 *lradc_ctrl = (2 << 24) | (2 << 8) | (1 << 6) | (0 << 2) | 1; return 0; } static ssize_t lradc_read(struct file *file, char __user *buf, size_t count, loff_t *ppos) { unsigned int val = *lradc_data & 0x3F; // 取低6位 unsigned int voltage = val * 2000 / 63; // 转换为mV if (copy_to_user(buf, &voltage, sizeof(voltage))) return -EFAULT; return sizeof(voltage); } static struct file_operations lradc_fops = { .owner = THIS_MODULE, .open = lradc_open, .read = lradc_read, }; static struct miscdevice lradc_miscdev = { .minor = MISC_DYNAMIC_MINOR, .name = "lradc", .fops = &lradc_fops, }; module_misc_device(lradc_miscdev); MODULE_LICENSE("GPL");

驱动开发中的几个关键点：

1. 使用ioremap正确映射物理地址
2. 采样率设置要平衡响应速度和噪声抑制
3. 数据读取后需要进行位掩码操作
4. 添加适当的错误检查和处理

3. 用户空间应用开发

有了内核驱动后，我们需要开发用户空间程序来读取电压并计算电量百分比。

3.1 基础电压读取程序

最简单的C语言实现：

#include <stdio.h> #include <fcntl.h> #include <unistd.h> int main() { int fd = open("/dev/lradc", O_RDONLY); if (fd < 0) { perror("Open device failed"); return -1; } unsigned int voltage; read(fd, &voltage, sizeof(voltage)); printf("Current voltage: %dmV\n", voltage); close(fd); return 0; }

3.2 电量百分比计算

锂电池电压与电量的关系是非线性的，典型曲线如下：

基于此，我们可以实现更精确的电量计算：

def voltage_to_percent(voltage): voltage = voltage / 1000 # 转换为V if voltage >= 4.2: return 100 elif voltage >= 3.95: return 80 + (voltage-3.95)*80/0.25 elif voltage >= 3.85: return 60 + (voltage-3.85)*20/0.1 elif voltage >= 3.75: return 40 + (voltage-3.75)*20/0.1 elif voltage >= 3.6: return 20 + (voltage-3.6)*20/0.15 elif voltage >= 3.3: return 5 + (voltage-3.3)*15/0.3 else: return 0

3.3 高级功能实现

一个完整的电池监控应用还应该包括：

• 低电量警告
• 历史数据记录
• 电量消耗分析
• 通过UART或网络远程监控

示例代码框架：

import time import sqlite3 class BatteryMonitor: def __init__(self): self.db = sqlite3.connect('battery.db') self.create_table() def create_table(self): self.db.execute('''CREATE TABLE IF NOT EXISTS logs (timestamp INTEGER, voltage REAL, percent REAL)''') def read_voltage(self): with open('/dev/lradc', 'rb') as f: return int.from_bytes(f.read(4), 'little') / 1000.0 def log_status(self): voltage = self.read_voltage() percent = self.voltage_to_percent(voltage) timestamp = int(time.time()) self.db.execute("INSERT INTO logs VALUES (?, ?, ?)", (timestamp, voltage, percent)) self.db.commit() if percent < 10: self.send_alert(f"Low battery: {percent}%") def run(self, interval=60): try: while True: self.log_status() time.sleep(interval) except KeyboardInterrupt: self.db.close()

4. 系统校准与优化

任何ADC测量系统都需要校准才能获得准确结果。以下是校准步骤和优化建议。

4.1 三点校准法

1. 准备工具：

   • 可调稳压电源
   • 高精度万用表
   • 已知阻值的精密电阻

2. 校准步骤：

   1. 设置电源输出3.0V，记录ADC读数和实际电压
   2. 设置电源输出3.7V（标称电压），记录读数
   3. 设置电源输出4.2V（满电电压），记录读数
   4. 使用最小二乘法计算校准系数

校准后的电��计算公式：

V_actual = a * V_raw + b

4.2 软件滤波算法

ADC读数容易受到噪声干扰，常用的滤波方法包括：

1. 移动平均滤波：

#define SAMPLE_SIZE 5 static int samples[SAMPLE_SIZE]; static int index = 0; int filtered_read() { samples[index++ % SAMPLE_SIZE] = read_adc(); int sum = 0; for (int i = 0; i < SAMPLE_SIZE; i++) { sum += samples[i]; } return sum / SAMPLE_SIZE; }

2. 指数加权移动平均：

alpha = 0.2 # 平滑系数 filtered = None def ewma_filter(new_value): global filtered if filtered is None: filtered = new_value else: filtered = alpha * new_value + (1 - alpha) * filtered return filtered

4.3 功耗优化技巧

对于电池供电设备，功耗优化至关重要：

• 降低采样频率（根据应用需求）
• 使用中断模式代替轮询
• 在驱动中添加休眠支持
• 用户空间应用采用事件驱动而非忙等待

修改后的驱动休眠实现示例：

static DECLARE_WAIT_QUEUE_HEAD(lradc_waitq); static atomic_t data_ready = ATOMIC_INIT(0); // 在中断处理函数中 irqreturn_t lradc_isr(int irq, void *dev_id) { atomic_set(&data_ready, 1); wake_up_interruptible(&lradc_waitq); return IRQ_HANDLED; } static ssize_t lradc_read(struct file *file, char __user *buf, size_t count, loff_t *ppos) { if (wait_event_interruptible(lradc_waitq, atomic_read(&data_ready))) return -ERESTARTSYS; atomic_set(&data_ready, 0); // ... 读取数据代码 ... }