无Root权限下用C/C++检测BeagleBone Black硬件RTC模块电池状态

一、模块安装检测 #

• 系统中RTC设备以/dev/rtcX形式存在（板载RTC通常为/dev/rtc0），PCF8523加载后会生成新的设备节点（如/dev/rtc1）
• 可通过sysfs属性判断设备是否为PCF8523，普通用户默认拥有读权限：
  1. 遍历/sys/class/rtc下的子目录
  2. 读取每个子目录下的name文件，PCF8523的名称固定为pcf8523
• 示例C++代码片段：

#include <fstream>
#include <string>
#include <dirent.h>

bool isPCF8523Installed() {
    DIR* dir = opendir("/sys/class/rtc");
    if (!dir) return false;

    struct dirent* entry;
    while ((entry = readdir(dir)) != nullptr) {
        if (entry->d_name[0] == '.') continue;
        std::string path = std::string("/sys/class/rtc/") + entry->d_name + "/name";
        std::ifstream file(path);
        std::string name;
        if (file >> name && name == "pcf8523") {
            closedir(dir);
            return true;
        }
    }
    closedir(dir);
    return false;
}

二、电池状态检测（无Root权限） #

PCF8523的低电压状态会被驱动映射到sysfs的电源供应属性中，无需直接操作I2C或/dev/rtc设备：

• 找到PCF8523对应的rtcX节点后，读取其关联的power_supply属性文件：
  1. 读取/sys/class/rtc/rtcX/device/power_supply/rtc-battery/status，低电压时会返回Low或类似标识
  2. 若status文件不存在，可读取capacity文件，通过阈值判断电池状态（如容量<20%判定为低电压）
• 示例C++代码片段：

#include <fstream>
#include <string>
#include <dirent.h>

std::string getPCF8523BatteryStatus() {
    DIR* dir = opendir("/sys/class/rtc");
    if (!dir) return "unknown";

    struct dirent* entry;
    std::string status = "unknown";
    while ((entry = readdir(dir)) != nullptr) {
        if (entry->d_name[0] == '.') continue;
        std::string namePath = std::string("/sys/class/rtc/") + entry->d_name + "/name";
        std::ifstream nameFile(namePath);
        std::string name;
        if (nameFile >> name && name == "pcf8523") {
            // 优先读取status文件
            std::string statusPath = std::string("/sys/class/rtc/") + entry->d_name + "/device/power_supply/rtc-battery/status";
            std::ifstream statusFile(statusPath);
            if (statusFile >> status) {
                break;
            }
            //  fallback到capacity判断
            std::string capPath = std::string("/sys/class/rtc/") + entry->d_name + "/device/power_supply/rtc-battery/capacity";
            std::ifstream capFile(capPath);
            int cap;
            if (capFile >> cap) {
                status = (cap < 20) ? "low" : "ok";
            }
            break;
        }
    }
    closedir(dir);
    return status;
}

关键说明 #

• 所有操作基于sysfs文件系统，普通用户默认拥有读权限，无需Root
• 系统日志中的“低电压”错误对应PCF8523内部的检测位，驱动会自动将其映射到power_supply属性
• 若power_supply路径存在差异，可通过udevadm info -a /sys/class/rtc/rtcX查看设备的完整属性关联路径

内容的提问来源于stack exchange，提问作者Parduz