Power

The APIs related to power management and example programs for M5CoreS3.

Example

Power Input Mode

In this mode, the device can be powered by the Grove interface or the DC power interface. (For the CoreS3 Base DIN base, the power switch needs to be set to ON.)

#include "M5CoreS3.h"

void setup()
{
    auto cfg = M5.config();
    // if using ext power input(Grove Port or DC input power supply) needs to be set to false.
    cfg.output_power = false;
    CoreS3.begin(cfg);
}

Power Output Mode

In this mode, the Grove interface will supply power externally. This is the default initialization mode.

#include "M5CoreS3.h"
void setup()
{
    auto cfg = M5.config();
    cfg.output_power = true;
    CoreS3.begin(cfg);
}

Power Status

#include "M5CoreS3.h"

void setup()
{
    auto cfg = M5.config();
    // if using ext power input(Grove Port or DC input power supply) needs to be set to false.
    // cfg.output_power = false;
    CoreS3.begin(cfg);
    CoreS3.Display.setTextSize(2);

    CoreS3.Power.setChargeCurrent(200);
}

void loop()
{
    CoreS3.Display.clear();

    bool bat_ischarging = CoreS3.Power.isCharging();
    CoreS3.Display.setCursor(10, 30);
    CoreS3.Display.printf("Bat Charging: %d", bat_ischarging);

    int bat_vol = CoreS3.Power.getBatteryVoltage();
    CoreS3.Display.setCursor(10, 50);
    CoreS3.Display.printf("Bat Voltage: %dmv", bat_vol);

    int bat_level = CoreS3.Power.getBatteryLevel();
    CoreS3.Display.setCursor(10, 70);
    CoreS3.Display.printf("Bat Level: %d", bat_level);

    int vbus_vol = CoreS3.Power.getVBUSVoltage();
    CoreS3.Display.setCursor(10, 90);
    CoreS3.Display.printf("VBus Voltage: %dmv", vbus_vol);
    delay(1000);
}

API

The M5CoreS3 library is based on the M5Unified library implementation, the power supply part uses the Power_Class from the M5Unified library, for more related APIs you can refer to the following document:

• M5Unified - Power Class