十八、（正点原子）Linux内核RTC驱动

        RTC 也就是实时时钟，用于记录当前系统时间，对于 Linux 系统而言时间是非常重要的，就和我们使用 Windows 电脑或手机查看时间一样，我们在使用 Linux 设备的时候也需要查看时间。

一、Linux内核RTC驱动简介

        RTC 设备驱动是一个标准的字符设备驱动，应用程序通过 open、 release、 read、 write 和ioctl等函数完成对 RTC 设备的操作。
        Linux 内核将 RTC 设备抽象为 rtc_device 结构体，因此 RTC 设备驱动就是申请并初始化rtc_device，最后将 rtc_device 注册到 Linux 内核里面，这样 Linux 内核就有一个 RTC 设备了。
        至于 RTC 设备的操作肯定是用一个操作集合(结构体)来表示的，我们先来看一下 rtc_device结构体，此结构体内容如下(删除条件编译)：

定义在 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;

	unsigned long irq_data;
	spinlock_t irq_lock;
	wait_queue_head_t irq_queue;
	struct fasync_struct *async_queue;

	struct rtc_task *irq_task;
	spinlock_t irq_task_lock;
	int irq_freq;
	int max_user_freq;

	struct timerqueue_head timerqueue;
	struct rtc_timer aie_timer;
	struct rtc_timer uie_rtctimer;
	struct hrtimer pie_timer; /* sub second exp, so needs hrtimer */
	int pie_enabled;
	struct work_struct irqwork;
	/* Some hardware can't support UIE mode */
	int uie_unsupported;

};

        我们需要重点关注的是ops成员变量，这是一个rtc_class_ops类型的指针变量，rtc_class_ops
为 RTC 设备的最底层操作函数集合，包括从 RTC 设备中读取时间、向 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 设备操作函数，并不是提供给应用层的file_operations 函数操作集。 RTC 是个字符设备，那么肯定有字符设备的file_operations 函数操作集， Linux 内核提供了一个 RTC 通用字符设备驱动文件文件名为 drivers/rtc/rtc-dev.c， rtc-dev.c 文件提供了所有 RTC 设备共用的 file_operations 函数操作集，如下所示：

定义在drivers/rtc/rtc-dev.c种

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_dev_ioctl 函数内容如下(有省略)：

218 s