實時時鐘是個常用的外設，可以用來獲取年、月、日和時間等信息。目前大多數的芯片內部都自帶了實時時鐘外設模塊。例如本實驗所使用的I.MX6ULL芯片內部SNVS就提供了RTC（實時計數器）功能。SNVS（安全的非易性存儲）里面主要是一些低功耗的外設，其可以在芯片掉電后由電池供電繼續運行。RTC需要外接晶振來提供時鐘，本實驗中I.MX6ULL芯片外接了一個32.768KHz的晶振，原理圖如下

1. Linux內核RTC驅動簡介

RTC 設備驅動是一個標準的字符設備驅動，應用程序通過open、release、read、write和ioctl等函數完成對 RTC 設備的操作

內核將 RTC 設備抽象為 rtc_device 結構體，RTC設備驅動就是申請并初始化rtc_device，最后將 rtc_device 注冊到Linux內核里面，此結構體定義在include/linux/rtc.h文件中

struct rtc_device
{
 struct device dev; /* 設備 */
 struct module *owner;

 int id; /* ID */
 char name[RTC_DEVICE_NAME_SIZE]; /* 名字 */

 const struct rtc_class_ops *ops; /* RTC 設備底層操作函數 */
 struct mutex ops_lock;

 struct cdev char_dev; /* 字符設備 */
 unsigned long flags;
 ......
 ......
};

結構體中的ops成員變量是RTC設備的底層操作函數集合，是一個 rtc_class_ops 類型的指針變量，需要用戶根據所使用的RTC設備編寫的，此結構體定義在include/linux/rtc.h 文件中，內容如下

struct rtc_class_ops {
 int (*open)(struct device *);
 void (*release)(struct device *);
 int (*ioctl)(struct device *, unsigned int, unsigned long);
 int (*read_time)(struct device *, struct rtc_time *);
 int (*set_time)(struct device *, struct rtc_time *);
 int (*read_alarm)(struct device *, struct rtc_wkalrm *);
 int (*set_alarm)(struct device *, struct rtc_wkalrm *);
 int (*proc)(struct device *, struct seq_file *);
 int (*set_mmss64)(struct device *, time64_t secs);
 int (*set_mmss)(struct device *, unsigned long secs);
 int (*read_callback)(struct device *, int data);
 int (*alarm_irq_enable)(struct device *, unsigned int enabled);
};

rtc_class_ops 是最底層的 RTC 設備操作函數，并不是提供給應用層的。內核提供了一個 RTC 通用字符設備驅動文件，文件名為 drivers/rtc/rtc-dev.c， 理論提供了所有 RTC 設備共用的 file_operations 函數操作集，如下所示：

static const struct file_operations rtc_dev_fops = {
 .owner = THIS_MODULE,
 .llseek = no_llseek,
 .read = rtc_dev_read,
 .poll = rtc_dev_poll,
 .unlocked_ioctl = rtc_dev_ioctl,
 .open = rtc_dev_open,
 .release = rtc_dev_release,
 .fasync = rtc_dev_fasync,
};

應用程序可以通過 ioctl 函數來設置/讀取時間、設置/讀取鬧鐘的操作，那么對應的 rtc_dev_ioctl 函數就會執行，rtc_dev_ioctl 最終會通過操作 rtc_class_ops 中的 read_time、 set_time 等函數來對具體 RTC 設備的讀寫操作。內核中 RTC 驅動調用流程圖如下示

2. Linux內核RTC驅動分析

一般情況下，半導體廠商都會編寫好內部RTC驅動，無需我們自已動手編寫。但是有必要了解一下是如何編寫的

? 打開imx6ull.dtsi，然后找到 snvs_rtc 節點內容，如下所示：

snvs_rtc: snvs-rtc-lp {
 compatible = "fsl,sec-v4.0-mon-rtc-lp";
 regmap = <&snvs>;
 offset = <0x34>;
 interrupts =

? 根據compatible屬性值，在Linux源碼中搜索"fsl,sec-v4.0-mon-rtc-lp"符串，即可找到對應的驅動文件drivers//rtc/rtc-snvs.c

static const struct of_device_id snvs_dt_ids[] = {
 { .compatible = "fsl,sec-v4.0-mon-rtc-lp", },
 { /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, snvs_dt_ids);
static struct platform_driver snvs_rtc_driver = {
 .driver = {
  .name = "snvs_rtc",
  .pm = SNVS_RTC_PM_OPS,
  .of_match_table = snvs_dt_ids,
 },
 .probe = snvs_rtc_probe,
};
module_platform_driver(snvs_rtc_driver);

? 可見這是一個標準的platform驅動，當驅動和設備匹配以后snvs_rtc_probe函數就會執行

static int snvs_rtc_probe(struct platform_device *pdev){
 struct snvs_rtc_data *data;
 struct resource *res;
 int ret;
 void __iomem *mmio;

 data = devm_kzalloc(&pdev->dev, sizeof(*data), GFP_KERNEL);
 if (!data)
  return -ENOMEM;

 data->regmap = syscon_regmap_lookup_by_phandle(pdev->dev.of_node, "regmap");
 if (IS_ERR(data->regmap)) {
  dev_warn(&pdev->dev, "snvs rtc: you use old dts file,please update it\\n");
  //從設備樹中獲取RTC外設寄存器基地址
  res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
  //內存映射，獲得RTC外設寄存器物理基地址對應的虛擬地址
  mmio = devm_ioremap_resource(&pdev->dev, res);
  if (IS_ERR(mmio))
   return PTR_ERR(mmio);
  //采用regmap機制來讀寫RTC底層硬件寄存器
  data->regmap = devm_regmap_init_mmio(&pdev->dev, mmio, &snvs_rtc_config);
 } else {
  data->offset = SNVS_LPREGISTER_OFFSET;
  of_property_read_u32(pdev->dev.of_node, "offset", &data->offset);
 }

 if (!data->regmap) {
  dev_err(&pdev->dev, "Can't find snvs syscon\\n");
  return -ENODEV;
 }
 //從設備樹中獲取 RTC 的中斷號
 data->irq = platform_get_irq(pdev, 0);
 if (data->irq < 0)
  return data->irq;
 ......

 platform_set_drvdata(pdev, data);

 //用regmap機制的regmap_write函數完成對寄存器進行寫操作
 regmap_write(data->regmap, data->offset + SNVS_LPPGDR, SNVS_LPPGDR_INIT);
 //清除LPSR寄存器
 regmap_write(data->regmap, data->offset + SNVS_LPSR, 0xffffffff);
 //使能RTC
 snvs_rtc_enable(data, true);
 device_init_wakeup(&pdev->dev, true);
 //請求RTC中斷
 ret = devm_request_irq(&pdev->dev, data->irq,
         snvs_rtc_irq_handler,
         IRQF_SHARED, "rtc alarm", &pdev->dev);
 if (ret) {
  dev_err(&pdev->dev, "failed to request irq %d: %d\\n", data->irq, ret);
  goto error_rtc_device_register;
 }
 //向系統注冊rtc_devcie
 data->rtc = devm_rtc_device_register(&pdev->dev, pdev->name, &snvs_rtc_ops, THIS_MODULE);
 if (IS_ERR(data->rtc)) {
  ret = PTR_ERR(data->rtc);
  dev_err(&pdev->dev, "failed to register rtc: %d\\n", ret);
  goto error_rtc_device_register;
 }

 return 0;

 error_rtc_device_register:
 if (data->clk)
  clk_disable_unprepare(data->clk);
 return ret;
}

RTC 底層驅動snvs_rtc_ops操作集包含了讀取/設置RTC時間，讀取/設置鬧鐘等函數。其內容如下

static const struct rtc_class_ops snvs_rtc_ops = {
 .read_time = snvs_rtc_read_time,
 .set_time = snvs_rtc_set_time,
 .read_alarm = snvs_rtc_read_alarm,
 .set_alarm = snvs_rtc_set_alarm,
 .alarm_irq_enable = snvs_rtc_alarm_irq_enable,
};

以 snvs_rtc_read_time 函數為例，介紹RTC底層操作函數該如何去編寫，該函數用于讀取RTC時間值

static int snvs_rtc_read_time(struct device *dev,struct rtc_time *tm) {
 struct snvs_rtc_data *data = dev_get_drvdata(dev);
 //獲取RTC計數值，該值是秒數
 unsigned long time = rtc_read_lp_counter(data);
 //將獲取到的秒數轉換為時間值，也就是rtc_time結構體類型
 rtc_time_to_tm(time, tm);

 return 0;
}

rtc_time 結構體定義如下：

struct rtc_time {
 int tm_sec;
 int tm_min;
 int tm_hour;
 int tm_mday;
 int tm_mon;
 int tm_year;
 int tm_wday;
 int tm_yday;
 int tm_isdst;
};

rtc_read_lp_counter 函數，此函數用于讀取 RTC 計數值，函數內容如下

static u32 rtc_read_lp_counter(struct snvs_rtc_data *data) {
 u64 read1, read2;
 u32 val;
 //讀取RTC_LPSRTCMR和RTC_LPSRTCLR這兩個寄存器，得到RTC的計數值
 do {
  regmap_read(data->regmap, data->offset + SNVS_LPSRTCMR, &val);
  read1 = val;
  read1 <<= 32;
  regmap_read(data->regmap, data->offset + SNVS_LPSRTCLR, &val);
  read1 |= val;
  regmap_read(data->regmap, data->offset + SNVS_LPSRTCMR, &val);
  read2 = val;
  read2 <<= 32;
  regmap_read(data->regmap, data->offset + SNVS_LPSRTCLR, &val);
  read2 |= val;
 } while ((read1 >> CNTR_TO_SECS_SH) != (read2 >> CNTR_TO_SECS_SH));

 /* Convert 47-bit counter to 32-bit raw second count */
 return (u32) (read1 >> CNTR_TO_SECS_SH);
}

3. RTC時間相關設置

RTC 是用來計時的，最基本的就是查看時間，Linux內核啟動時可以看到系統時鐘設置信息

? 查看時間命令：date

? 設置當前時間：date -s

date -s "2022-08-15 13:20:00"

? 將當前時間寫入到RTC里：hwclock -w