bq25896_charger.ino

Go to the documentation of this file.

 
#include <Arduino.h>
#include <Wire.h>
#include <PmicDrv.hpp>
 
#ifndef PMIC_SDA
#define PMIC_SDA  3
#endif
 
#ifndef PMIC_SCL
#define PMIC_SCL  2
#endif
 
#ifndef PMIC_IRQ
#define PMIC_IRQ  -1
#endif
 
uint32_t interval = 0;
PmicBQ25896 bmu;
 
#define CHECK_FOR_ERRORS(condition) if (condition) {Serial.println("BQ25896 error"); while(1)delay(1000);}
 
void printBanner()
{
    Serial.println("");
    Serial.println("╔══════════════════════════════════════════╗");
    Serial.println("║     BQ25896 Charger Test                 ║");
    Serial.println("╚══════════════════════════════════════════╝");
    Serial.println("");
}
 
void setup()
{
    bool rlst;
 
    Serial.begin(115200);
    while (!Serial) {
        delay(10);
    }
 
    printBanner();
 
    rlst = bmu.begin(Wire, BQ25896_SLAVE_ADDRESS, PMIC_SDA, PMIC_SCL);
    if (!rlst) {
        Serial.println("BQ25896 begin() failed. Check wiring.");
        while (1) {
            delay(1000);
        }
    }
 
    Serial.println("BQ25896 initialized successfully");
 
    // bmu.led().setMode(PmicLedBase::Mode::AUTO); // STAT pin indicates charging status
    bmu.led().setMode(PmicLedBase::Mode::DISABLE); // DISABLE LED to save power (if STAT pin is not used for indication)
 
    // Charge current: 64-1024mA, 64mA steps (fuzzy: auto-adjusts to nearest valid value)
    rlst = bmu.charger().setPreChargeCurrent(256);
    CHECK_FOR_ERRORS(!rlst);
    // Fast charge current: 0-3008mA, 64mA steps (fuzzy: auto-adjusts to nearest valid value)
    rlst = bmu.charger().setFastChargeCurrent(1024);
    CHECK_FOR_ERRORS(!rlst);
    // Termination current: 64-1024mA, 64mA steps (fuzzy: auto-adjusts to nearest valid value)
    rlst = bmu.charger().setTerminationCurrent(64);
    CHECK_FOR_ERRORS(!rlst);
    // Charge voltage: 3840-4608mV, 16mV steps (fuzzy: auto-adjusts to nearest valid value)
    rlst = bmu.charger().setChargeVoltage(4350);
    CHECK_FOR_ERRORS(!rlst);
 
    Serial.print("Pre Charge Current: ");
    Serial.println(bmu.charger().getPreChargeCurrent());
    Serial.print("Fast Charge Current: ");
    Serial.println(bmu.charger().getFastChargeCurrent());
    Serial.print("Termination Current: ");
    Serial.println(bmu.charger().getTerminationCurrent());
    Serial.print("Charge Voltage: ");
    Serial.println(bmu.charger().getChargeVoltage());
 
    // Input current limit: 100-3008mA, 100mA steps (fuzzy: auto-adjusts to nearest valid value)
    bmu.power().setInputCurrentLimit(1000);
    // Input voltage limit: 3900-14000mV, 100mV steps (fuzzy: auto-adjusts to nearest valid value)
    bmu.power().setInputVoltageLimit(5000);
    // System minimum voltage: 3000-3700mV, 100mV steps (fuzzy: auto-adjusts to nearest valid value)
    bmu.power().setMinimumSystemVoltage(3300);
 
    Serial.print("Input Current Limit: ");
    Serial.println(bmu.power().getInputCurrentLimit());
    Serial.print("Input Voltage Limit: ");
    Serial.println(bmu.power().getInputVoltageLimit());
    Serial.print("Minimum System Voltage: ");
    Serial.println(bmu.power().getMinimumSystemVoltage());
 
    // Enable ADC channels (VBUS voltage, Battery voltage, VSYS voltage, Charging current, NTC temperature)
    bmu.adc().enableChannels(BQ25896Adc::ADC_CONV_START);
 
    // Disabling ADC can reduce quiescent current.
    // If call `read` directly after disabling `adc`, it will trigger a single read operation.
    // bmu.adc().disableChannels(0); // No specific channels to disable, but call for compatibility
 
    Serial.println("Setup complete!");
}
 
 
void loop()
{
    if (millis() > interval) {
        interval = millis() + 3000;
 
        Serial.println("\n========== BQ25896 Status ==========");
 
        float val;
        bool ret;
 
        ret = bmu.adc().read(PmicAdcBase::Channel::VBUS_VOLTAGE, val);
        Serial.print("VBUS Voltage: ");
        Serial.print(ret ? val : -1);
        Serial.println(" mV");
 
        ret = bmu.adc().read(PmicAdcBase::Channel::BAT_VOLTAGE, val);
        Serial.print("Battery Voltage: ");
        Serial.print(ret ? val : -1);
        Serial.println(" mV");
 
        ret = bmu.adc().read(PmicAdcBase::Channel::VSYS_VOLTAGE, val);
        Serial.print("VSYS Voltage: ");
        Serial.print(ret ? val : -1);
        Serial.println(" mV");
 
        ret = bmu.adc().read(PmicAdcBase::Channel::BAT_CURRENT, val);
        Serial.print("Battery Current: ");
        Serial.print(ret ? val : -1);
        Serial.println(" mA");
 
        ret = bmu.adc().read(PmicAdcBase::Channel::BAT_TEMPERATURE, val);
        Serial.print("NTC Temperature: ");
        Serial.print(ret ? val : -1);
        Serial.println(" %");
 
        Serial.print("Charging: ");
        Serial.println(bmu.charger().isCharging() ? "Yes" : "No");
 
        PmicChargerBase::Status status = bmu.charger().getStatus();
        Serial.print("Online: ");
        Serial.println(status.online ? "Yes" : "No");
        Serial.print("VBUS Present: ");
        Serial.println(status.vbusPresent ? "Yes" : "No");
        Serial.print("Charge Done: ");
        Serial.println(status.chargeDone ? "Yes" : "No");
        Serial.print("Fault: ");
        Serial.println(status.fault ? "Yes" : "No");
 
        Serial.print("Boost Enabled: ");
        Serial.println(bmu.power().isBoostEnabled() ? "Yes" : "No");
 
        Serial.print("Boost Voltage: ");
        Serial.println(bmu.power().getBoostVoltage());
 
        Serial.print("ICO Optimized: ");
        Serial.println(bmu.core().isInputCurrentOptimizerOptimized() ? "Yes" : "No");
 
        Serial.print("VINDPM Active: ");
        Serial.println(bmu.core().isVindpmActive() ? "Yes" : "No");
 
        Serial.print("IINDPM Active: ");
        Serial.println(bmu.core().isIindpmActive() ? "Yes" : "No");
 
        Serial.print("VSYS in Regulation: ");
        Serial.println(bmu.core().isVsysInRegulation() ? "Yes" : "No");
 
        Serial.println("===================================\n");
    }
}