这段时间给一个手持小设备做电源管理，主控选了树莓派RP2350，也就是Pico 2上那颗新MCU，电池呢是常见的3.7V锂电池。设备要做电量显示，最初我用电阻分压加ADC读电压、再换算成电量，结果在低电量阶段误差大得离谱，同一个电池，放电电流大一点电压就掉到3.2V，放一会又回弹。后来换上了MAX17048电量计，I2C接口，读电压和剩余电量都变成几行代码的事，从接线到跑通，实测下来确实5分钟就能看到数据。这篇文章把完整接线、原理、MicroPython代码和常见坑全记录下来，适合正在做Pico 2项目、毕设电源管理，或者想给DIY设备加电量显示的朋友参考。
1. 为什么不用电阻分压加ADC：MAX17048的定位
1.1 电量测量的三种常见方案对比
先别急着看代码，我觉得有必要把为什么选MAX17048讲清楚。很多做嵌入式的小伙伴一开始都会想着“不就是测个电压嘛，ADC加两个电阻就搞定了”，我以前也是这么干的，但踩过几次坑之后发现事情没那么简单。
现在主流的电量测量方案大概有三类。第一类是纯电压读取法，就是电阻分压加上单片机ADC，查一个电压-电量对照表来换算。这个方法成本最低，但是有两个很致命的问题：锂电池的放电曲线并不是一条直线，在3.7V到3.3V这段尤其陡峭，电压稍微波动一点，算出来的电量就偏差好几个百分点；而且电池内阻会随着放电电流变化，电机一转、屏幕一亮，电压马上掉下去，你读到的值根本不是真实的开路电压，而是带负载的瞬时电压，这时候算电量就是自欺欺人。
第二类是库仑计法，也叫电流积分法，通过一颗精密采样电阻串联在电池回路里，用ADC持续采样电流并积分，从而得到充放电电量。这个方法精度不错，但需要额外考虑采样电阻的温漂、放大电路的零点漂移，BOM成本和PCB面积都上去了，对于一个小型手持设备来说有点重。
第三类就是MAX17048这类ModelGauge电量计方案。它不需要外置采样电阻，芯片直接采集电池正端电压，内部通过电压曲线、电压变化率以及电池老化模型来估算剩余电量。整体外围电路就是一个去耦电容。它把复杂拟合过程全部做在芯片内部，对外提供I2C接口，你读两个寄存器就能拿到电压和SOC（State of Charge，剩余电量百分比），这也是它在消费电子产品里应用非常广的原因。
| 方案 | 精度 | 外围成本 | 适用场景 |
|---|---|---|---|
| 电阻分压+ADC | 较低，受负载影响大 | 最低 | 玩具、对电量要求不高的设备 |
| 库仑计 | 较高 | 高，需要精密采样电阻 | 高精度监测、容量分析 |
| MAX17048 ModelGauge | 中等偏上 | 低，只需一颗电容 | 手持设备、低功耗设备 |
1.2 我选择MAX17048的3个实际理由
第一是成本低，模块在市面上几块钱到十几块钱就能买到，芯片本身封装也很小，适合集成到自己的PCB里。第二是开发效率高，I2C通信大家都很熟，而且它提供的SOC寄存器直接就是百分比数据，不需要自己查表拟合，省掉了最麻烦的调试环节。第三是功耗低，MAX17048的工作电流据说在微安级别，对于电池供电的设备来说很友好，不会因为加了电量计反而加快掉电。
当然它也有不擅长的地方。ModelGauge本质上还是基于电压估算的，如果你要求的是“绝对严谨的库仑级计量精度”，它肯定不如带采样电阻的库仑计芯片。但是在大多数产品里，用户只是想看到“还有多少电、还能用多久”一个不太离谱的数值，MAX17048完全够用。至少在Pico 2这种级别的项目里，它的精度和成本平衡得非常漂亮。
2. 硬件准备与接线：5分钟里最关键的1分钟
2.1 物料清单和选型建议
做这个实验不需要太多东西，我列一下我实际用的物料。
- 树莓派RP2350开发板，也就是Raspberry Pi Pico 2，一定注意别买成老的RP2040 Pico，虽然代码逻辑一样，但标题既然说了RP2350，我们就用新的芯片。
- MAX17048电量计模块，买那种已经把I2C上拉电阻做好的成品模块最省事，很多模块还带引脚座，直接杜邦线就能连。
- 3.7V锂电池，最好是带保护板的，防止实验过程中过放。
- 面包板、杜邦线若干，如果模块没焊排针，需要先焊一下。
- 有条件的话准备一块万用表，排查问题时会很有帮助。
这里有个容易被忽略的点：MAX17048的VCC工作电压范围一般是2.5V到4.5V，所以可以直接接锂电池正极，不需要额外稳压。它测的就是VCC引脚上的电池电压。但如果你的模块上带稳压电路，那就要看模块说明书，搞清楚VCC到底应该接电池还是接3.3V。
2.2 接线表和接线要点
接线非常简单，我使用的是RP2350的I2C0控制器，引脚配置为SDA=GP0、SCL=GP1。这个引脚不是焊死的，MicroPython允许你把I2C功能映射到其他支持的GPIO上，但GP0和GP1是最常用、最容易记的一组。
| MAX17048模块引脚 | 接到哪里 |
|---|---|
| VCC | 锂电池正极 |
| GND | 锂电池负极，同时接到Pico 2的GND |
| SDA | Pico 2的GP0 |
| SCL | Pico 2的GP1 |
接线顺序我建议先接电源和地，再接SDA和SCL，这样不容易乱。特别要注意的是共地问题，MAX17048的GND必须和RP2350的GND连在一起，否则I2C信号根本没有参考电平，通信是不可能正常的。我之前遇到过一次怎么扫描都找不到设备，最后发现是电池负极和开发板没有共地，两个地之间悬空，总线完全瘫痪。
还有一个细节是，MAX17048模块上最好焊一个0.1uF的陶瓷电容在VCC和GND之间。很多成品模块已经带了，但如果是自己搭芯片，这个电容一定要加。原因很简单，电量计芯片内部需要稳定的参考电压来做AD转换，电源纹波太大会让读出来的电压值来回跳。加了去耦电容之后，读数会稳定不少。
2.3 I2C上拉电阻的两种常见情况
I2C总线的工作原理是开漏输出，也就是说设备只能把SDA和SCL拉低，不能主动拉高，所以必须外部接上拉电阻到电源。绝大多数MAX17048成品模块都自带4.7k或者10k的上拉电阻，接上就能用。
但如果你买的是裸芯片，那就得自己处理上拉电阻。我建议在SDA和SCL上各接一个4.7k电阻，另一端接到3.3V。为什么不建议直接拉到电池正极？因为电池满电的时候电压能到4.2V，而RP2350的GPIO耐压一般不推荐超过3.6V，如果模块的上拉电阻是拉到电池端的，SDA/SCL的高电平就会被拉到4.2V，长时间运行对GPIO有损伤风险。有些模块自己做了电平转换，那就没问题；没有的话，最好把上拉电阻拉到3.3V。不过由于RP2350的GPIO内部有钳位二极管，短时间实验一般不会烧，但长期产品设计不值得这么赌。
3. 核心原理：一次弄懂MAX17048的I2C寄存器
3.1 MAX17048到底是怎么算出电量的
既然用到了这个东西，最好还是理解一下它的工作思路，以后换芯片、调参数心里才有底。MAX17048用的是Maxim的ModelGauge算法，它不需要采样电阻，而是通过电池电压的变化来推断剩余电量。
你可以这样理解：锂电池在静置状态下，电压和电量之间存在一条相对稳定的关系曲线，这就是OCV（开路电压）曲线。但设备一旦开始工作，电池内阻会让端电压下降，而且下降的幅度和电流、温度、电池老化程度都有关系。如果单纯根据当前电压查表，年轻电池和老化电池的结果完全不一样。
MAX17048的做法是持续采样电压，并结合电压变化率和历史数据来动态修正估算结果。启动后它其实会花一点时间“学习”当前电池的状态，这也是为什么有些用户刚上电时发现SOC并不是很准，用一段时间之后就稳了。对开发者来说，这些过程都是芯片内部自动完成的，我们只需要通过I2C读寄存器就行。最重要的两个寄存器是VCELL和SOC，一个给电压，一个给百分比。
3.2 常用寄存器速查表
MAX17048的寄存器基本都是16位，也就是每次读两个字节，高位在前。我整理了一份常用寄存器表，方便大家对照使用。
| 寄存器地址 | 名称 | 功能说明 | 数据换算 |
|---|---|---|---|
| 0x00 | STATUS | 状态寄存器，包含低电量标志、SOC变化标志 | 按位解析 |
| 0x02 | VCELL | 电池电压读数 | 原始值乘以1.25，单位mV |
| 0x04 | SOC | 剩余电量 | 原始值除以256，单位% |
| 0x06 | VERSION | 芯片版本号 | 只读 |
| 0x0C | CONFIG | 配置寄存器，可设置报警阈值、休眠等 | 按位解析 |
VCELL的LSB（最低有效位）是1.25mV，也就是说你读到一个16位原始值raw，实际的电压毫伏数就是raw乘1.25。举个例子，如果寄存器值是0x0F20，十进制3872，那电压就是3872乘以1.25等于4840mV，也就是4.84V。不过正常锂电池满电也就4.2V左右，所以读出来的值通常不会超过这个。
SOC寄存器稍微特殊一点，它的高字节是百分比整数部分，低字节是百分比小数部分，整体除以256就能得到一个小数形式的百分比。比如寄存器值0x6400，十进制25600，除以256就是100.0%，表示电量满格。如果寄存器值0x3200，十进制12800，除以256就是50.0%。
3.3 I2C地址和读写时序的坑
MAX17048的7位I2C地址是0x36。这个地址在使用时有一个特别容易混淆的点：MicroPython的readfrom_mem函数里，我们传的是7位地址0x36；但如果你用Linux系统的i2c-tools或者某些库，可能会遇到要传8位地址的情况，写地址是0x6C，读地址是0x6D。其实0x6C就是0x36左移一位得到的，0x6D就是左移一位再加1。很多新手扫不到设备，就是因为地址形式搞错了。
I2C读取一个16位寄存器的完整过程是这样的：主机先发出START条件，然后发送设备地址加写位（也就是0x6C），从机应答；接着发送寄存器地址，比如0x04，从机应答；然后主机发出重复起始条件Repeated START，再发送设备地址加读位（也就是0x6D），从机应答；最后主机连续读两个字节，收到第二个字节后主机回复NACK并发送STOP条件。如果你用逻辑分析仪抓波形，看到的就是这么一串。MicroPython的readfrom_mem函数把这套流程封装好了，但明白原理对排查问题很有帮助。
I2C总线为什么需要上拉电阻、为什么是开漏输出，这里也顺带说一句。开漏输出意味着设备只能拉低总线，不能主动输出高电平，高电平完全靠上拉电阻提供。这样设计的最大好处是多个设备可以安全地共用总线，不会因为一个设备输出高、另一个输出低而导致短路。通信双方通过控制SDA和SCL的拉低时序来传输数据，逻辑上有点像几个水龙头共用一根排水管，谁放水谁拉低，不放水的时候管道靠上拉电阻维持“空管”状态。
4. 实操环节：RP2350上跑通MicroPython完整代码
4.1 第一步：给RP2350烧录MicroPython固件
如果你手头的Pico 2还是全新的，第一次使用需要烧录MicroPython固件。步骤很简单，去MicroPython官网的Download页面，找到针对RP2350或者Raspberry Pi Pico 2的.uf2文件下载下来。然后按住Pico 2板子上的BOOTSEL按键不放，用USB线连接到电脑，这时候电脑会出现一个名为RP2350的U盘盘符。把下载好的.uf2文件直接拖进这个U盘，板子会自动重启，MicroPython固件就烧录完成了。
开发环境我推荐用Thonny，界面简洁，还能直接在编辑器里设置解释器为MicroPython (Raspberry Pi Pico 2)。如果你喜欢命令行，也可以用串口终端连接板子上的虚拟串口，直接进REPL交互环境。这一步其实非常快，只要固件下载好了，整个烧录过程也就十几秒。
4.2 完整代码，可直接复制运行
下面是完整的MicroPython代码，实现了I2C扫描、读取电压、读取SOC、循环打印和低电压提醒。代码里加了详细注释，即使你之前没用过I2C，照着敲也能跑起来。
from machine import Pin, I2C import utime # MAX17048的7位I2C地址 MAX17048_ADDR = 0x36 # 常用寄存器地址 REG_VCELL = 0x02 # 电池电压寄存器的16位读数，LSB = 1.25mV REG_SOC = 0x04 # 剩余电量寄存器，除以256得到百分比 # 初始化I2C0，SDA=GP0，SCL=GP1，400kHz i2c = I2C(0, scl=Pin(1), sda=Pin(0), freq=400_000) def check_device(): """扫描I2C总线，确认MAX17048是否在线""" devices = i2c.scan() if MAX17048_ADDR in devices: return True return False def read_vcell(): """读取电池电压，返回单位：V""" data = i2c.readfrom_mem(MAX17048_ADDR, REG_VCELL, 2) raw = int.from_bytes(data, 'big') # 原始值 * 1.25mV，再转成V return raw * 1.25 / 1000.0 def read_soc(): """读取剩余电量百分比，返回单位：%""" data = i2c.readfrom_mem(MAX17048_ADDR, REG_SOC, 2) raw = int.from_bytes(data, 'big') # 高字节为整数百分比，低字节为小数部分，除以256得到百分比 return raw / 256.0 if not check_device(): print("未发现MAX17048，请检查接线和供电！") raise SystemExit print("MAX17048 连接正常！") print("Vcell( V ) SOC( % )") while True: v = read_vcell() soc = read_soc() print("{:.3f} {:.1f}".format(v, soc)) # 简单低电压提醒：低于3.0V时打印警告 if v < 3.0: print("警告：电池电压过低！") utime.sleep(1)代码逻辑不复杂，check_device先通过i2c.scan()确认0x36地址在总线上；read_vcell和read_soc分别读取两个关键寄存器，并做了单位换算；主循环每秒打印一次电压和电量，同时判断电压是不是跌破了3.0V。
这里要注意的是，readfrom_mem的第三个参数是读取字节数，对于VCELL和SOC都要读2字节，因为它们是16位寄存器。如果只读1字节，你拿到的就只有高字节，SOC的小数部分和VCELL的完整分辨率都会丢。int.from_bytes(data, 'big')是以大端方式把字节数组拼成整数，I2C设备寄存器基本都遵循大端。
4.3 运行效果和常见输出解读
接好线、烧好固件之后运行代码，我这里的实际输出大概是这样的。
MAX17048 连接正常！ Vcell( V ) SOC( % ) 4.112 98.4 4.105 98.0 4.101 97.7你可以拿万用表测一下电池正负极的实际电压，和代码里打印的Vcell对比，正常情况下误差应该在几十毫伏以内。如果误差很大，优先怀疑模块焊接或供电有问题。SOC会在充放电过程中缓慢变化，不会像电压那样瞬间跳动，这恰恰说明电量计做了一定平滑处理，比直接读ADC要稳定得多。
跑通这一步之后，你就可以把代码集成到自己的项目里。比如加一个OLED屏幕显示电量百分比，或者在电量低于20%时让蜂鸣器报警，甚至把数据通过USB串口发到上位机画实时曲线。代码本身不需要大改，核心就是读寄存器的三个函数，业务逻辑想怎么加都行。
5. 常见问题与排查实录：帮你少走弯路
5.1 I2C扫描不到0x36地址
这是出现频率最高的问题，没有之一。我总结了几个排查方向，按顺序试基本都能解决。
先看供电，MAX17048必须要有VCC供电才能工作，也就是锂电池要接在模块上，很多模块没有电池就表现为扫描不到。然后用万用表量一下模块上的VCC和GND之间电压，确认确实在2.5V到4.5V这个区间。
再看接线，SDA和SCL是不是接反了，GP0和GP1有没有弄混。逻辑线交叉接反是最常见的新手错误，因为很多模块排针顺序是VCC、GND、SDA、SCL，但有些模块可能是VCC、SDA、SCL、GND，拿到板子先对着丝印看清楚。
接着看上拉电阻，如果模块没带电阻，而你又没外接，那总线根本没有高电平，设备再正常也扫描不到。用万用表量SDA或SCL对GND电压，正常应该接近3.3V，如果一直是0，说明上拉电阻缺失或者SCL/SDA被拉死。
最后别忘了排除地址格式问题。i2c.scan()返回的是7位地址，所以你应该在里面找到0x36。如果你手里模块的资料上写了0x6C，那是8位写地址，换算成7位要右移一位，也就是0x36。我见过好几个朋友在代码里写0x6C，然后怎么扫都找不到，其实不是设备问题，是地址格式理解错了。
5.2 SOC读数明显不准，或者长时间卡在某个值
如果你刚焊好板子，第一次上电读取SOC，发现它和实际电量对不上，先别急着怀疑芯片坏了。ModelGauge算法有一个自学习过程，它需要根据电池的充放电历史慢慢修正。我的建议是让电池完整充放电一两个循环，SOC会逐渐趋向真实值。
还有一种情况是电池带保护板，而且保护板因为过放已经进入保护状态。这个时候你会量到电池有电压，但无法正常放电，SOC可能显示得奇奇怪怪。解决办法是换一块确认正常的电池，或者对保护板做个重新激活。
温度对SOC也有影响，冬天在室外做测试，电池电压会偏低，SOC可能会比预期低一些。MAX17048内部虽然有一些温度修正逻辑，但不同电池的特性差异还是会在极端温度下体现出来。如果你是做低温产品，最好在实际使用温度下做一轮充放电校准，然后把CONFIG寄存器里的RCOMP补偿值调整一下，不过这个属于进阶调优，正常室内项目可以不折腾。
5.3 通信偶尔失败、读数卡死的处理方法
如果代码运行一段时间后突然读不到数据，或者程序卡在I2C读取上，多半是总线进入了异常状态。比较常见的原因是设备地址占线或者时序被干扰。最简单的处理办法是给I2C初始化加个异常捕获，每次读取失败就重新初始化一次总线，这样比让程序死等要稳定得多。
还有一个值得养成的习惯是降低I2C频率。400kHz是高速模式，大多数情况下没问题，但如果你的杜邦线很长，或者面包板寄生电容太大，400kHz的边沿会变差，进而导致通信误码。这时候把freq改成100_000，问题往往迎刃而解。I2C的通信速率对MAX17048这种电量计来说完全够用，别为了追求高速而牺牲稳定性。
对了，调试I2C还有一个利器，就是逻辑分析仪。网上那种几十块钱的8通道逻辑分析仪，配Sigrok或者PulseView软件，把SDA和SCL两根线夹上去，就能直接解码出I2C的地址、寄存器号和数据。我在排查问题的时候，最喜欢用它来确认主控到底有没有发对地址、设备有没有回ACK。有时候代码看起来正确，但波形一抓就发现起始条件拼错了，这一类问题用逻辑分析仪十秒钟就能定位，比瞎改代码效率高得多。
6. 项目扩展：从读电量到完整低电量管理
6.1 低电量报警的实现思路
读完电压和SOC，很多人下一步就想着做低电量保护。MAX17048的STATUS寄存器里有低电量标志位，同时CONFIG寄存器可以配置报警阈值。比较简单的做法是在主循环里直接判断SOC，小于20%就点亮一个LED，小于10%就关掉一些外设。更严谨的做法是读取STATUS寄存器，让芯片在电量跨过阈值时主动拉低ALRT引脚，触发RP2350的外部中断。
不过要注意，MAX17048判断的报警阈值默认是32%还是多少来着，不同配置不太一样，具体要去看寄存器说明。我实际做的时候并没有依赖芯片的中断，而是直接在主循环里轮询SOC，然后根据电压值做双重判断。因为对于手持设备来说，1秒钟的轮询周期已经很快了，没必要为了省电去抠中断。
我建议你在做低电量逻辑时，不要只看电压值，也不要只看SOC，而是用SOC为主、电压为辅。SOC相对平滑，适合做趋势判断；电压响应快，适合做紧急保护。比如SOC低于15%开始提醒用户，电压低于3.1V直接强制关机，这种组合逻辑会可靠很多。
6.2 加上OLED显示电量
给Pico 2外接一个SSD1306的0.96寸OLED，显示效果会直观很多。MicroPython的ssd1306驱动是很成熟的开源库，I2C地址一般是0x3C。你的RP2350已经初始化了I2C0，你可以把OLED也挂到同一条I2C总线上，因为I2C本身支持多设备，MAX17048的0x36和OLED的0x3C不会冲突。
接线就更简单了，OLED的SDA和SCL分别接GP0和GP1，VCC和GND接3.3V和地。然后代码里初始化两个设备，循环读取MAX17048的数据，再通过OLED的text方法把电压和电量画出来。如果你在画电池图标的时候注意一下坐标，把百分比数字放在图标中间，看起来就跟真实手机状态栏差不多了。
这里有个小提示，OLED屏幕刷新不要太猛，每秒刷新一次就好，刷新太快不仅肉眼分辨不出来，还会浪费电。既然项目本身是做电源管理，那么功耗意识从第一天开始就要有。
6.3 多电池、多路电量计怎么做
如果项目里有两块电池，比如一个主电池加一个备用电池，你可以让RP2350分时读取两个MAX17048。但要注意I2C地址冲突的问题，因为MAX17048的地址固定是0x36，你没法直接用软件区分两块电池。解决办法有两个。
第一个办法是用RP2350的两个独立I2C控制器，I2C0挂第一块电池的电量计，I2C1挂第二块，用两套SDA和SCL引脚分开读取，互不干扰，代码也只多几行初始化。第二个办法是给每块电池的电量计增加I2C开关，比如用TCA9548A多路复用器，选通不同通道再去读取，适合需要接很多块电池的场景。
对于大多数人来说，第一块电池的电量计能不能稳定跑通才是重点。等你把单个MAX17048彻底吃透，再考虑扩展多电池方案也不迟。这个芯片的I2C时序不复杂，寄存器结构也清晰，是个非常适合练手的外设。
最后再分享一个我的实际感受：MAX17048这种“接口简单但内部有算法”的芯片，特别适合做嵌入式项目的电源管理模块。比起自己在ADC前端做滤波、建表、拟合曲线，直接在I2C上读两个寄存器就能拿到稳定的SOC，开发效率和可维护性都高非常多。你把通用的I2C读写封装成小函数，以后换任何一块I2C设备都能复用。这篇内容里提到的地址格式、上拉电阻、共地这些问题，其实也不只适用于MAX17048，你在调其他I2C传感器时同样会碰到。先把这条路走通，后面做低功耗设备、做电源管理，都会顺手很多。
