简体中文
English
简体中文
日本語

Arduino 上手教程

2. 设备开发 & 案例程序

5. 扩展模块

6. 应用案例

PaperMono Battery 电池状态

PaperMono 电池状态读取相关 API 与案例程序。

案例程序

编译要求

  • M5Stack 板管理版本 >= 3.3.9
  • 开发板选项 = M5PaperMono
  • M5Unified 库版本 >= 0.2.20
  • M5GFX 库版本 >= 0.2.27
cpp
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
#include <M5Unified.h>

M5Canvas canvas(&M5.Display);

void drawBatteryStatus()
{
    const int w = M5.Display.width();
    const bool charging = M5.Power.isCharging() == m5::Power_Class::is_charging;
    const int level = M5.Power.getBatteryLevel();
    const int voltage = M5.Power.getBatteryVoltage();
    const int vbusVoltage = M5.Power.getVBUSVoltage();

    canvas.fillSprite(TFT_WHITE);
    canvas.setTextDatum(top_center);
    canvas.setFont(&fonts::FreeSansBold18pt7b);
    canvas.setTextColor(TFT_BLACK);
    canvas.drawString("PaperMono Battery Test", w / 2, 42);

    canvas.setFont(&fonts::FreeSansBold18pt7b);
    canvas.setTextColor(TFT_BLACK);
    canvas.drawString(charging ? "Charging: Yes" : "Charging: No", w / 2, 170);

    char text[40];
    snprintf(text, sizeof(text), "Battery: %d%%", level);
    canvas.drawString(text, w / 2, 270);
    snprintf(text, sizeof(text), "Voltage: %d mV", voltage);
    canvas.drawString(text, w / 2, 370);

    if (vbusVoltage >= 0) {
        snprintf(text, sizeof(text), "VBUS: %d mV", vbusVoltage);
    } else {
        snprintf(text, sizeof(text), "VBUS: N/A");
    }
    canvas.drawString(text, w / 2, 470);
    canvas.drawString("Refresh: 10 sec", w / 2, 590);
    canvas.pushSprite(0, 0);
}

void setup()
{
    auto cfg = M5.config();
    cfg.clear_display = false;
    M5.begin(cfg);
    M5.Display.setEpdMode(epd_mode_t::epd_text);

    canvas.createSprite(M5.Display.width(), M5.Display.height());
    drawBatteryStatus();
}

void loop()
{
    M5.update();
    static uint32_t lastUpdate = 0;
    if (millis() - lastUpdate >= 10000) {
        lastUpdate = millis();
        drawBatteryStatus();
    }
    delay(20);
}

程序会显示充电状态、电池电量、电池电压和 VBUS 输入电压,每 10 秒刷新一次。

API

PaperMono 电池状态部分使用了 M5Unified 库中的 Power_Class,更多相关的API可以参考下方文档:

Page Tools
PDF
On This Page