SMPL 模块分析

smpl 模块
├── smpl.c          # 主逻辑（重启原因检测、DMD 上报）
├── smpl.h          # 数据结构定义
├── Kconfig         # 内核配置
└── Makefile        # 编译配置

+---------------------------------------------------------------+
|                    Bootloader (U-Boot/ABL)                    |
|  检测重启原因 → 设置 Kernel Cmdline 参数                       |
|  - normal_reset_type=SMPL                                     |
|  - reboot_reason=power_loss                                   |
|  - reboot_reason=2sec_reboot                                  |
|  - normal_reset_type=BR_POWERON_BY_SMPL                       |
+---------------------------------------------------------------+
                              ↓
+---------------------------------------------------------------+
|                    Kernel (smpl.c)                            |
|  1. 启动 10 秒后执行检测                                       |
|  2. 解析 Cmdline 参数识别 SMPL                                |
|  3. 采集电池状态信息                                           |
|  4. 上报 DMD 告警                                             |
+---------------------------------------------------------------+
                              ↓
+---------------------------------------------------------------+
|                    DMD System (Device Monitor)                |
|  - 错误码: POWER_DSM_ERROR_NO_SMPL                            |
|  - 错误类型: POWER_DSM_SMPL                                   |
|  - 告警内容: 电池品牌、温度、电压、电量                         |
+---------------------------------------------------------------+
                              ↓
+---------------------------------------------------------------+
|                    Cloud Analysis Platform                    |
|  - 统计 SMPL 发生频率                                         |
|  - 分析故障模式                                                |
|  - 生成维修建议                                                |
+---------------------------------------------------------------+

设备启动
    ↓
Kernel 初始化
    ↓
smpl_init() 执行
    ↓
创建延迟工作队列（10 秒）
    ↓
等待 10 秒（确保电池驱动就绪）
    ↓
smpl_error_monitor_work() 执行
    ↓
┌─────────────────────────────────────────────────┐
│  检查 Kernel Cmdline 参数                        │
│  1. strstr("normal_reset_type=SMPL")            │
│  2. strstr("reboot_reason=power_loss")          │
│  3. strstr("reboot_reason=2sec_reboot")         │
│  4. strstr("normal_reset_type=BR_POWERON_BY_SMPL") │
└─────────────────────────────────────────────────┘
    ↓
发现 SMPL 标识？
    ├─ 否 → 退出（正常启动）
    └─ 是 → 继续
        ↓
采集电池状态信息
    ├─ 电池品牌: power_supply_app_get_bat_brand()
    ├─ 电池温度: power_supply_app_get_bat_temp()
    ├─ 电池电压: power_supply_app_get_bat_voltage_now()
    └─ 电池电量: power_supply_app_get_bat_capacity()
    ↓
构造 DMD 告警字符串
    ↓
上报 DMD
    ↓
记录日志
    ↓
完成

struct smpl_dev {
    struct device *dev;              // 设备节点（未使用）
    struct delayed_work monitor_work; // 延迟工作队列
};

#define DELAY_TIME_FOR_MONITOR_WORK 10000  // 10 秒延迟

static bool smpl_check_reboot_reason(void)
{
    // 检测方式 1: normal_reset_type=SMPL（高通平台）
    if (strstr(saved_command_line, "normal_reset_type=SMPL")) {
        hwlog_info("smpl happened: normal_reset_type=smpl\n");
        return true;
    }
    
    // 检测方式 2: reboot_reason=power_loss（MTK 平台）
    if (strstr(saved_command_line, "reboot_reason=power_loss")) {
        hwlog_info("smpl happened: reboot_reason=power_loss\n");
        return true;
    }
    
    // 检测方式 3: reboot_reason=2sec_reboot（特殊情况）
    if (strstr(saved_command_line, "reboot_reason=2sec_reboot")) {
        hwlog_info("smpl happened: reboot_reason=2sec_reboot\n");
        return true;
    }
    
    // 检测方式 4: BR_POWERON_BY_SMPL（华为自研平台）
    if (strstr(saved_command_line, "normal_reset_type=BR_POWERON_BY_SMPL")) {
        hwlog_info("smpl happened: normal_reset_type=BR_POWERON_BY_SMPL\n");
        return true;
    }
    
    return false;  // 未检测到 SMPL
}

static void smpl_error_monitor_work(struct work_struct *work)
{
    char buf[POWER_DSM_BUF_SIZE_0128] = { 0 };
    
    hwlog_info("monitor_work begin\n");
    
    // 1. 检查是否发生 SMPL
    if (!smpl_check_reboot_reason())
        return;  // 未发生 SMPL，直接退出
    
    // 2. 采集电池状态信息并构造告警字符串
    snprintf(buf, POWER_DSM_BUF_SIZE_0128 - 1,
        "smpl happened : brand=%s t_bat=%d, volt=%d, soc=%d\n",
        power_supply_app_get_bat_brand(),        // 电池品牌（如 "ATL", "SUNWODA"）
        power_supply_app_get_bat_temp(),         // 电池温度（0.1°C，如 250 = 25.0°C）
        power_supply_app_get_bat_voltage_now(),  // 电池电压（mV，如 3850）
        power_supply_app_get_bat_capacity());    // 电池电量（%，如 65）
    
    // 3. 上报 DMD 告警
    power_dsm_report_dmd(POWER_DSM_SMPL,
        POWER_DSM_ERROR_NO_SMPL, buf);
    
    // 4. 记录日志
    hwlog_info("smpl happened: %s\n", buf);
}

smpl happened : brand=ATL t_bat=250, volt=3850, soc=65

static int __init smpl_init(void)
{
    struct smpl_dev *l_dev = NULL;
    
    // 1. 分配设备结构内存
    l_dev = kzalloc(sizeof(*l_dev), GFP_KERNEL);
    if (!l_dev)
        return -ENOMEM;
    
    g_smpl_dev = l_dev;
    
    // 2. 初始化延迟工作队列
    INIT_DELAYED_WORK(&l_dev->monitor_work, smpl_error_monitor_work);
    
    // 3. 调度延迟 10 秒后执行
    schedule_delayed_work(&l_dev->monitor_work,
        msecs_to_jiffies(DELAY_TIME_FOR_MONITOR_WORK));
    
    return 0;
}

static void __exit smpl_exit(void)
{
    if (!g_smpl_dev)
        return;
    
    // 取消延迟工作队列
    cancel_delayed_work(&g_smpl_dev->monitor_work);
    
    // 释放内存
    kfree(g_smpl_dev);
    g_smpl_dev = NULL;
}

用户场景：
设备使用 2 年，电池老化，内阻升高

触发过程：
1. 用户运行大型游戏（高功耗负载）
   ↓
2. CPU/GPU 突发功耗峰值 6W
   ↓
3. 电池瞬时放电电流 2A
   ↓
4. 电池内阻 300mΩ（新电池约 100mΩ）
   ↓
5. 压降 = 2A × 0.3Ω = 0.6V
   ↓
6. VBAT 从 3.8V 跌落至 3.2V
   ↓
7. PMIC 欠压保护触发（阈值 3.3V）
   ↓
8. 系统复位重启（SMPL 事件）
   ↓
9. Bootloader 检测到 PMIC PONSTS 寄存器 = SMPL
   ↓
10. 设置 Cmdline: normal_reset_type=SMPL
    ↓
11. Kernel 启动，smpl 模块检测到 SMPL
    ↓
12. 上报 DMD：
    brand=ATL t_bat=350 volt=3200 soc=45
    ↓
13. 分析结论：
    - 电压 3200mV 过低
    - 电量 45% 不应该出现 SMPL
    - 怀疑电池老化

用户场景：
设备跌落后，电池连接器松动

触发过程：
1. 用户手机意外跌落
   ↓
2. BTB 连接器受冲击松动
   ↓
3. 接触电阻从 5mΩ 升至 100mΩ
   ↓
4. 正常使用中，瞬间断开 → 重新接触
   ↓
5. 电池断开瞬间 → VBAT = 0V
   ↓
6. PMIC 检测到掉电 → 系统复位
   ↓
7. BTB 重新接触 → 电池恢复供电
   ↓
8. 设备自动重启（SMPL 事件）
   ↓
9. Bootloader 设置 Cmdline: reboot_reason=power_loss
   ↓
10. smpl 模块检测并上报：
    brand=SUNWODA t_bat=280 volt=3900 soc=78
    ↓
11. 分析结论：
    - 电压 3900mV 正常
    - 电量 78% 充足
    - 温度 28°C 正常
    - 怀疑机械故障（BTB/电池接触不良）

用户场景：
充电过程中系统突然重启

触发过程：
1. 用户边充电边玩游戏
   ↓
2. 充电 IC 输出电流 = 充电电流 + 系统负载
   ↓
3. 充电 IC 内部 MOSFET 异常（批次缺陷）
   ↓
4. 输出电流能力下降至 1A（正常应 3A）
   ↓
5. 系统负载突增至 2A
   ↓
6. 充电 IC 过流保护触发 → 输出关断
   ↓
7. VSYS 跌落 → 系统掉电
   ↓
8. SMPL 重启
   ↓
9. Bootloader 设置 Cmdline: normal_reset_type=BR_POWERON_BY_SMPL
   ↓
10. smpl 模块上报：
    brand=ATL t_bat=420 volt=4100 soc=85
    ↓
11. 分析结论：
    - 电池状态良好
    - 充电中发生（电压 4.1V 为充电电压）
    - 温度 42°C 偏高（充电 + 游戏发热）
    - 怀疑充电 IC 或电源路径故障

用户场景：
设备启动过程中反复重启

触发过程：
1. 设备首次 SMPL 重启
   ↓
2. Bootloader 启动 → Kernel 加载
   ↓
3. 系统初始化过程中再次触发 SMPL
   ↓
4. 连续重启时间 < 2 秒
   ↓
5. Bootloader 检测到连续重启
   ↓
6. 设置 Cmdline: reboot_reason=2sec_reboot
   ↓
7. smpl 模块检测到异常重启模式
   ↓
8. 上报 DMD：
    brand=ATL t_bat=150 volt=3100 soc=2
    ↓
9. 分析结论：
    - 电量仅 2%（临界低电量）
    - 电压 3100mV（关机阈值附近）
    - 温度 15°C（低温环境）
    - 启动电流峰值导致电压跌落
    - 建议进入低电量保护模式

# 1. 模块初始化日志
[smpl] monitor_work begin

# 2. SMPL 检测日志（4 种模式）
[smpl] smpl happened: normal_reset_type=smpl
[smpl] smpl happened: reboot_reason=power_loss
[smpl] smpl happened: reboot_reason=2sec_reboot
[smpl] smpl happened: normal_reset_type=BR_POWERON_BY_SMPL

# 3. DMD 上报日志
[smpl] smpl happened: brand=ATL t_bat=250, volt=3850, soc=65

# 查看完整 Kernel Cmdline
cat /proc/cmdline

# 查看是否包含 SMPL 标识
cat /proc/cmdline | grep -E "SMPL|power_loss|2sec_reboot"

# 示例输出：
# ... normal_reset_type=SMPL ...

# 不同平台寄存器路径不同

# 高通平台
cat /sys/kernel/debug/pmic-debug/pon_reason

# MTK 平台
cat /sys/kernel/debug/mtk-pmic/pon_reason

# 华为平台
cat /sys/kernel/debug/hi6xxx-pmic/pon_reason

# 查看 DMD 上报记录
cat /sys/kernel/debug/power_dsm/power_dsm_dump | grep SMPL

# 或查看 logcat
logcat -b events | grep SMPL

# 修改 Cmdline 测试（需要 root 权限）
# 注意：仅用于开发调试，不应在量产版本使用

# 方法 1: 在 Bootloader 中添加参数
# U-Boot 命令行：
setenv bootargs "${bootargs} normal_reset_type=SMPL"
boot

# 方法 2: 修改 DTB 中的 bootargs（需要重新编译）
# 在 DTS 中添加：
chosen {
    bootargs = "... normal_reset_type=SMPL";
};