故障排除

本页面帮助您使用板载 LED、蜂鸣器和软件工具诊断 PiPower 5 问题。从下面的快速参考表开始，然后按照基于症状的指南进行详细步骤。

LED 与蜂鸣器快速参考 

在深入研究具体症状之前，使用这些表格解读板子在告诉您什么。

电源和状态 LED 

LED	状态	含义
PWR LED（绿色）	亮	输出电源已激活 — 板子正在向您的设备提供 5V 电源。
	灭	输出已关闭。按一次电源按钮将其打开。
BAT LED（黄色）	亮	电池当前正在供电。如果连接了外部电源，这表示输入功率不足。
	灭	电池处于待机状态 — 外部电源充足。
电池反接 LED（2× 红色）	亮（两个）	电池极性接反！立即断开并纠正接线。

电池电量 LED 

LED 模式	含义
4 个 LED 亮	电池 > 80%
3 个 LED 亮	电池 60% – 80%
2 个 LED 亮	电池 40% – 60%
1 个 LED 亮	电池 20% – 40%
第一个 LED 闪烁	电池 < 20% — 请尽快充电
LED 循环顺序亮起	正在充电
中间两个 LED 闪烁	等待 Raspberry Pi 的关机信号
所有 LED 灭	板子未通电或处于休眠模式

备注

电池 LED 在充电期间保持活动状态，即使板子处于关闭状态。只有在充电完成时它们才会熄灭。

蜂鸣器信号 

如果蜂鸣器已启用，这些声音表示特定事件：

事件	典型声音	含义
`battery_activated`	两个升调	电池已接管供电（外部电源丢失或不足）。
`low_battery`	两个相同音高的重复音	电池电量已低于配置的关机百分比。请立即充电。
`power_disconnected`	高音 → 低音	外部电源已断开。系统现在使用电池运行。
`power_restored`	低音 → 高音	外部电源已恢复。电池不再放电。
`power_insufficient`	三个相同音高的快速音	外部电源已连接但太弱。电池正在补充供电。请检查您的电源适配器。
`battery_critical_shutdown`	三个快速降调	电池容量严重不足。系统将关机。
`battery_voltage_critical_shutdown`	四个快速降调	电池电压严重过低（故障安全）。系统将立即关机。

小技巧

如果您从未听到蜂鸣器声音，蜂鸣器可能已禁用或其音量设置为 0。运行 pipower5 -bzv 检查当前音量，或用 pipower5 -bzt low_battery 测试。

基于症状的诊断 

“无电源” — 所有 LED 灭，无输出 

您看到的情况：PWR LED 灭，电池 LED 灭，连接的设备无电源显示。

请按顺序检查以下内容：

电池是否安装？ PiPower 5 没有电池无法运行。确保电池连接器（XH2.54 3P）牢固插入。请参阅电池连接器。
电池是否完全耗尽？ 深度放电的电池（< 2.5V 每节）会进入涓流充电模式，可能无法在几分钟内为板子供电。
- 连接外部电源，等待 10–15 分钟。
- 如果 15 分钟后电池 LED 仍然不亮，电池可能有缺陷。
外部电源是否正确连接？ - 使用 USB-C PD 电源（5V–15V）或通过螺丝端子使用 DC 电源。 - 确保 USB-C 线缆支持电源输送 — 某些仅数据传输的线缆无法工作。 - 尝试不同的电源适配器和线缆。
按一次电源按钮。 PiPower 5 需要按一下按钮来激活输出，除非设置了默认开机跳线。
检查默认开机跳线。 请参阅默认 ON/OFF 跳线。 - 跳线在 ON：连接外部电源时自动激活输出。 - 跳线在 OFF：每次都需要按电源按钮。
检查电池是否反接。 如果电池连接器附近的红色 LED 都亮起，电池极性接反。立即断电，断开电池，按正确极性重新连接。请参阅电池连接器。

“BAT LED 常亮” — 外部电源似乎不足 

您看到的情况：外部电源已连接，但 BAT LED 保持亮起。尽管外部电源存在，电池仍在放电。

这意味着什么：外部电源无法满足总功率需求。电池正在补充不足的部分。

请按顺序检查以下内容：

您的电源适配器功率是否足够？ 公式是：适配器功率 ≥ Raspberry Pi 功率（约 20–25W）+ 充电功率（通过 DIP 开关设置）。
- Raspberry Pi 5 负载时可能消耗 > 25W。
- 如果充电功率设置为 20W（两个 DIP 开关都 ON），您需要一个 45W+ 的适配器。
- 对于 30W 适配器，将充电功率降低到 10W 或 5W。
检查 DIP 开关（充电功率选择器）。 请参阅电源输入中的充电功率表。如果适配器功率不足，降低充电功率。
尝试不同的 USB-C 线缆。 并非所有线缆都支持更高功率的 USB PD。使用电源适配器随附的线缆。
检查适配器的 PD 配置文件。 某些适配器声称高功率但仅在特定的电压/电流组合下。PiPower 5 需要兼容 PD 的电源。非 PD 适配器（如固定 5V）可能无法提供足够的电流。
对于螺丝端子输入，确保输入电压 ≥ 9V 以获得最佳性能。请参阅电源输入了解电压对电流的限制。

“PWR LED 灭” — 设备未收到电源 

您看到的情况：电池 LED 亮（板子有电），但 PWR LED 灭，连接的设备无法启动。

请检查：

按一次电源按钮。 板子有电但输出未启用。
GPIO 排针是否正确插入？ 如果使用 Raspberry Pi，取下并重新安装 PiPower 5 HAT。检查排针是否有弯曲的引脚或杂物。
尝试替代输出。 将设备连接到 USB-A 端口或 2x4P 排针。如果这些能工作，问题出在 GPIO 直通。

“设备不断意外关机”

您看到的情况：Raspberry Pi 或连接的设备在没有任何警告的情况下关机。

请检查：

检查关机百分比。 运行 pipower5 -sp。如果设置过高（如 50% 或更高），板子会提前触发关机。如有需要设置更低的值：
```
pipower5 -sp 10
sudo systemctl restart pipower5.service
```
检查电池是否真的在放电。 运行 pipower5 -a 并查看： - source：连接外部电源时应为 “0 - External”。 - battery current：负 = 充电，正 = 放电。
对于带有高功率外设（SSD、HAT）的 Raspberry Pi 5：考虑设置 pipower5 -sp 100 以在外部电源丢失时立即触发安全关机。请参阅 PiPower 5 工具。
检查电源适配器。 如果触发了 power_insufficient 事件（蜂鸣器或日志），适配器太弱。升级到更高功率的电源或降低充电功率 DIP 开关。

“电池不充电”

您看到的情况：外部电源已连接，但电池 LED 不显示充电动画（顺序循环）。

请检查：

电池是否已经充满？ 4 个 LED 常亮 = 电池 > 80%。充电电路可能因为电池已满或处于恒压阶段而停止。
通过软件检查充电状态。 运行 pipower5 -ichg。如果返回 False，板子报告未充电。检查 pipower5 -bp 了解当前电池百分比。
过温保护激活。 如果板子在温暖环境中高负载运行，充电芯片可能超过 125°C 并停止充电。让板子冷却后再试。
螺丝端子输入电压过低。 如果使用螺丝端子且电压 ≤ 6.5V，充电电流受限。使用 ≥ 9V 以获得可靠的充电。
检查电池健康状态。 从未完全充满或充电非常缓慢的电池可能电芯已退化。尝试使用其他兼容电池（7.4V 2 节锂离子，XH2.54 3P）。

“I2C 通信失败” — pipower5 命令返回错误 

您看到的情况：运行 pipower5 -a 产生错误或无数据。

请检查：

Raspberry Pi 上是否启用了 I2C？ 运行 sudo raspi-config → Interface Options → I2C → Enable。
是否检测到 I2C 设备？
```
sudo i2cdetect -y 1
```
PiPower 5 应出现在地址 0x5a。如果没有设备显示：
- 重新安装 HAT 到 GPIO 排针上。
- 检查 i2c-dev 是否加载：lsmod | grep i2c。
- 验证 dtparam=i2c_arm=on 是否在 /boot/firmware/config.txt 中。
`pipower5` 服务是否在运行？
```
sudo systemctl status pipower5.service
```
如果未激活，启动它：sudo systemctl start pipower5.service。
多个 I2C 设备冲突？ PiPower 5 使用 I2C 地址 0x5a。检查是否有其他 HAT 或设备使用此地址。请参阅 RPi 排针。
重启。 有时冷重启 Raspberry Pi 和 PiPower 5 可以解决 I2C 总线问题。完全断电，等待 10 秒，然后通电。

“蜂鸣器无声” — 事件发生时无声音 

您看到的情况：事件发生（电源断开、电池电量低等）但没有蜂鸣器声音。

请检查：

检查蜂鸣器音量。
```
pipower5 -bzv
```
如果返回 0，蜂鸣器已静音。设置音量（1–10）：
```
pipower5 -bzv 5
sudo systemctl restart pipower5.service
```
检查哪些事件启用了蜂鸣器。
```
pipower5 -bzo
```
确保您期望的事件在列表中。要添加事件：
```
pipower5 -bzo low_battery,power_disconnected
```
直接测试蜂鸣器。
```
pipower5 -bzt low_battery
```
如果听到声音，蜂鸣器硬件正常工作 — 问题出在事件配置。

“Raspberry Pi 显示低电压警告”

您看到的情况：Raspberry Pi 桌面或 dmesg 显示欠压警告。

在某些情况下这是预期行为：

从 PiPower 5 的 USB-A 端口（而不是 GPIO 排针）为 Raspberry Pi 供电时，Pi 可能会报告非 PD 电源警告。这可以安全忽略。
如果使用 GPIO 排针但仍然看到警告，PiPower 5 的输出可能处于重负载下。检查您设置的总电流消耗。

请检查：

运行 pipower5 -a 并检查 Output: voltage。应在 5.2–5.3V 左右保持稳定。如果在负载下降至 5.0V 以下，总电流消耗可能超过 5A 限制。
断开非必要的 USB 外设并重新测试。
如果问题仍然存在，DC-DC 转换器可能有故障。请联系支持。

软件诊断命令 

pipower5 CLI 工具是您的主要诊断接口。以下是最有用的命令：

命令	告诉您什么
`pipower5 -a`	完整状态快照：输入/输出电压、电池状态、充电状态、关机请求、按钮状态。
`pipower5 -bp`	电池百分比。
`pipower5 -ichg`	电池当前是否正在充电（`True` / `False`）。
`pipower5 -ii`	外部电源是否已连接。
`pipower5 -sp`	当前关机百分比阈值。
`pipower5 -sr`	当前关机请求状态（0 = 无，1 = 低电量，2 = 按钮）。
`pipower5 -pb`	当前电源按钮状态。
`pipower5 -bzv`	当前蜂鸣器音量。
`pipower5 -fv`	固件版本（验证您是否使用最新版本）。
`pipower5 -c`	完整配置转储。
`pipower5 -pfs 60`	运行 60 秒电源故障模拟以测试电池续航时间。
`sudo systemctl status pipower5.service`	检查 PiPower 5 后台服务是否在运行。
`cat /opt/pipower5/log`	查看服务日志中的错误消息。

小技巧

要快速进行健康检查，运行 pipower5 -a 并验证：

shutdown request 为 0 - NONE（无待处理关机）。
battery percentage 高于您的 shutdown percentage。
Output: voltage 在 5.1V 到 5.4V 之间。

仍有问题？

如果以上方法都无法解决您的问题，在联系支持之前收集以下信息：

系统信息：
```
pipower5 -a
pipower5 -fv
pipower5 -c
```

服务日志：

cat /opt/pipower5/log
sudo journalctl -u pipower5.service --no-pager -n 100

硬件详情： - Raspberry Pi 型号 - 电源适配器型号和额定功率 - 电池类型和使用时长 - PiPower 5 DIP 开关设置 - SDSIG 和默认 ON 跳线位置