Module13.2 PPS Arduino 使用教程

1. 准备工作

环境配置：参考 Arduino IDE 上手教程完成 IDE 安装，并根据使用的主机安装对应的板管理和驱动。
使用到的驱动库：
使用到的硬件：
- CoreS3
- Module13.2 PPS
- DC 9 ~ 36V 外部电源

2. 注意事项

外部供电

Module13.2 PPS 必须连接 DC 9 ~ 36V 外部电源，否则模块无法正常工作，并会在主机屏幕上提示 No i2c device。实际最大输出能力取决于输入电源、负载及连接线的承载能力。

引脚兼容性

由于每款主机的引脚配置不同，使用前请参考产品文档中的引脚兼容表，并根据实际引脚连接情况修改案例程序。

3. 案例程序

本教程中使用的主控设备为 CoreS3，搭配 Module13.2 PPS 实现供电调节控制。Module13.2 PPS 使用 I2C 通讯，请根据实际的电路连接修改程序中的引脚定义，设备连接后对应的 I2C IO 为 G12 (SDA)、G11 (SCL)。

cpp 
#include <M5Unified.h>
#include <M5GFX.h>
#include "M5ModulePPS.h"

M5GFX display;
M5Canvas canvas(&display);
M5ModulePPS pps;

// PPS output voltage target and current limit.
#define OUTPUT_VOLTAGE 5.0f
#define OUTPUT_CURRENT 5.0f

void setup() {
    M5.begin();
    display.begin();

    // Create a full-screen canvas for flicker-free updates.
    canvas.setFont(&fonts::FreeMonoBoldOblique12pt7b);
    canvas.createSprite(display.width(), display.height());

    // Retry until the PPS responds on the CoreS3 internal I2C bus.
    while (!pps.begin(&Wire, M5.In_I2C.getSDA(), M5.In_I2C.getSCL(),
                      MODULE_POWER_ADDR, 400000U)) {
        Serial.println("module pps connect error");
        canvas.clear(BLACK);
        canvas.setTextColor(RED);
        canvas.drawCenterString("No i2c device", display.width() / 2,
                                display.height() / 2);
        canvas.pushSprite(0, 0);
        delay(100);
    }

    // Apply both setpoints before enabling the power output.
    pps.setOutputVoltage(OUTPUT_VOLTAGE);
    pps.setOutputCurrent(OUTPUT_CURRENT);
    pps.setPowerEnable(true);
}

void loop() {
    // Read the live input, output, temperature, and regulation state.
    float voltage_readback = pps.getReadbackVoltage();
    float current_readback = pps.getReadbackCurrent();
    float temperature      = pps.getTemperature();
    float vin              = pps.getVIN();
    uint8_t mode           = pps.getMode();

    // Render one complete status frame before updating the display.
    canvas.fillSprite(BLACK);
    canvas.setFont(&fonts::FreeMonoBold12pt7b);
    canvas.setTextColor(WHITE);
    canvas.drawCenterString("Module PPS", display.width() / 2, 0);

    canvas.setCursor(10, 40);
    canvas.setTextColor(WHITE);
    canvas.printf("VIN: ");
    canvas.setTextColor(GREEN);
    canvas.printf("%.2fV", vin);

    canvas.setCursor(10, 80);
    canvas.setTextColor(WHITE);
    canvas.printf("Mode: ");
    canvas.setTextColor(GREEN);
    // The PPS switches between CV and CC automatically as the load changes.
    if (mode <= 1)
        canvas.printf("Constant Voltage");
    else
        canvas.printf("Constant Current");

    canvas.setTextColor(WHITE);
    canvas.setCursor(10, 120);
    canvas.printf("Voltage: ");
    canvas.setTextColor(GREEN);
    canvas.printf("%.2fV", voltage_readback);

    canvas.setCursor(10, 160);
    canvas.setTextColor(WHITE);
    canvas.printf("Current: ");
    canvas.setTextColor(GREEN);
    canvas.printf("%.2fA", current_readback);

    canvas.setCursor(10, 200);
    canvas.setTextColor(WHITE);
    canvas.printf("Temperature: ");
    canvas.setTextColor(GREEN);
    canvas.printf("%.2fC", temperature);

    canvas.pushSprite(0, 0);
}