关键流程设计

初始化流程

RTC 驱动的初始化过程见 aic_rtc_probe() 函数，除了普通 platform 设备的处理过程（申请 regs 资源、clk、reset）外，需要调用 RTC 子系统的接口 rtc_register_device() 来注册 RTC 设备。

#define rtc_register_device(device)   __rtc_register_device(THIS_MODULE, device)

static const struct rtc_class_ops aic_rtc_ops = {
    .read_time      = aic_rtc_read_time,
    .set_time           = aic_rtc_set_time,
    .read_alarm     = aic_rtc_read_alarm,
    .set_alarm      = aic_rtc_set_alarm,
    .alarm_irq_enable   = aic_rtc_alarm_irq_enable,
};

校准算法设计

(100 * 1024 * 1024 + 100 * calibrate) / (clock-rate / 32) = 1024
=> calibrate = (clock-rate * 32 - 100 * 1024 * 1024) / 100;

其中：

• clock-rate: 是用户实测 32K 晶振的频率值 * 100，需要配置在 DTS 中，详见 RTC 自定义参数

• calibrate: 最终要填入 RTC 控制器的校准值

  注：

  校准值 calibrate 分正负，正 - 表示 32K 晶振实际偏快了，负 - 表示 32K 晶振偏慢了。

系统状态的备份功能

RTC 控制器提供了 128-bit 备份寄存器 SYS_BAK，用于掉电时一些重要状态或者参数的保存。RTC 驱动将这几个寄存器封装为对外接口（ EXPORT_SYMBOL_GPL() 的形式)，Linux 中其他驱动都可以调用。

Reboot Reason 的设计

将系统状态的备份功能 中 系统备份寄存器 保存不同情况的 Reboot reason，可用于分析终端运行稳定性问题、进入快速启动模式等场景。

SYS_BAK 寄存器需要和 WRI 模块一起配合来完成 reason 的处理：

1. WRI

   负责记录 硬件可监测 到的 Reboot 原因，如过温保护、看门狗复位、外部输入复位等。

2. SYS_BAK

   负责记录 软件可监测 到的 Reboot 原因，如 Suspend、Panic、进入烧写模式、正常重启等。

关于 Reboot 原因，梳理分类如下：

enum aic_reboot_reason {
    REBOOT_REASON_COLD = 0,
    REBOOT_REASON_CMD_REBOOT = 1,
    REBOOT_REASON_CMD_SHUTDOWN = 2,
    REBOOT_REASON_SUSPEND = 3,
    REBOOT_REASON_UPGRADE = 4,
    REBOOT_REASON_FASTBOOT = 5,

    /* Some software exception reason */
    REBOOT_REASON_SW_LOCKUP = 8,
    REBOOT_REASON_HW_LOCKUP = 9,
    REBOOT_REASON_PANIC = 10,
    REBOOT_REASON_RAMDUMP = 11,

    /* Some hardware exception reason */
    REBOOT_REASON_RTC = 17,
    REBOOT_REASON_EXTEND = 18,
    REBOOT_REASON_DM = 19,
    REBOOT_REASON_OTP = 20,
    REBOOT_REASON_UNDER_VOL = 21,
};

针对不同场景，SYS_BAK0 寄存器中的 reason 和 WRI 中的 FLAG 值对应如下：