SunFounder PiPower
The capacity calculated by this integration is only the charge/discharge energy from the current moment. To associate
it with the actual capacity of the battery, a matching process is needed. The matching method here is simple. PiPower
Pro’s default battery capacity is the nominal capacity of the battery, which is 2000mAh. The actual battery capacity
will be less than this value. As long as the battery is charged, the capacity will be set to the maximum of 2000mAh (can
be changed using the service set_battery_factory_capacity), so when the battery is fully charged, the capacity
value matches the actual battery capacity of 2000mAh, and the integration calculation value matches the actual battery
capacity value.
Auto Calibration
Integration can accumulate errors, and the battery capacity will decrease as the battery is used over time, which may
not reach the nominal 2000mAh capacity. Therefore, some calibration methods need to be used to calibrate the battery
capacity.
Here, the Compensated End of Discharge Voltage (CEDV) calibration method is used. The principle of the CEDV
calibration method is that the voltage at the end of the battery discharge is relatively accurate, and the voltage curve
at this time is also the steepest. Using this voltage as a calibration point is more appropriate. So here we set 3 EDV
points: edv2 (7%), edv1 (3%), and edv0 (0%).
After setting these 3 calibration voltages, when the battery is discharged to these 3 points, PiPower Pro will calibrate the
battery: MaxCapacity = MaxCapacity - Capacity + MaxCapacity * 7% To avoid unlimited calibration at the
same point due to voltage fluctuations, calibration is limited to once before charging reaches RCV (Reset Calibration
Voltage, default 8.0V). Both edv2, edv1, edv0, and rcv can be configured in the service Service, see PiPower Pro Entity
for details.
Indicator
When the Coulomb Counter algorithm is enabled, the battery indicator will also switch to the Coulomb Counter mode.
However, there is a small chance of incorrect battery level readings or even the battery level resetting.
The relationship between the battery indicators and power is as follows:
• 4 LEDs all on: 75%
• 3 LEDs on: 50%
• 2 LEDs on: 25%
• 1 LED on: 10%
• 4 LEDs all off: 0%, batteries need to be charged.
4.8 Custom Development
If you find that the basic functionality of PiPower Pro is not enough for your needs, you can perform custom development
on PiPower Pro.
All software for PiPower Pro is open source. Below is the basic tutorial and preparation for custom development.
1. Open the developer mode of Home Assistant.
a. Open the Home Assistant management page.
b. Select “Configuration” in the lower-left corner.
2. Install ESPHome.
a. Open the Home Assistant management page.
b. Select “Configuration” in the lower-left corner.
c. Select “Add-ons.”
4.8. Custom Development 55
To Next Page
Loading...
