1.RTC介紹

RTC的英文全稱是Real-Time Clock，翻譯過來是實時時鐘芯片。實時時鐘芯片通過引腳對外提供時間讀寫接口，通常使用獨立電池供電，以保證在外部系統(tǒng)關(guān)電時，芯片電路正常工作，時間正常運行。

不同的時鐘芯片內(nèi)部機制不一樣，但在Linux系統(tǒng)中驅(qū)動封裝了不同時鐘芯片的操作細(xì)節(jié)，為應(yīng)用程序提供了統(tǒng)一的時間操作接口。

1.1 開發(fā)板的RTC資源

EASY EAI Nano-TB 【默認(rèn)不帶】RTC電路。若想底板支持RTC功能，可通過使用我司的RTC模塊進行【擴展】。

擴展RTC的具體操作：【首先】要把底板【斷電】，然后再把模塊【正面朝上】地插入到底板的40PIN接口上，如下圖所示。

插穩(wěn)后，再進行【上電】操作。

通過ls命令，可查看RTC芯片是否有被系統(tǒng)識別

ls /dev/rtc*

確認(rèn)驅(qū)動成功加載后，可通過下方命令訪問驅(qū)動，讀出RTC芯片的所有信息。

cat /proc/driver/rtc

1.2 RTC時間的讀寫

這里涉及2個時鐘，RTC芯片時鐘以及系統(tǒng)時鐘。手動管理RTC時鐘操作的本質(zhì)就是：同步時鐘（要么把系統(tǒng)時鐘同步到RTC芯片時鐘上，要么把RTC芯片時鐘同步到系統(tǒng)時鐘）。

系統(tǒng)時鐘：系統(tǒng)時鐘本質(zhì)是一個64位的整數(shù)，這個整數(shù)代表當(dāng)前與Epoch Time的時間差(以秒為單位)，我們稱之為時間戳。這個時鐘由CPU主芯片定時器維護，CPU掉電后，時鐘信息就會丟失。操作系統(tǒng)時鐘的命令為date。

date #查詢系統(tǒng)時間 date -s "2023-09-20 11:18:00" #修改系統(tǒng)時間

注：

* Epoch Time：是指一個特定的時間。1970年1月1日0時0分0秒。假設(shè)現(xiàn)在距離1970年1月1日0時0分0秒走了N秒，在Linux系統(tǒng)里，時間數(shù)值就是N。

RTC芯片時鐘：RTC芯片內(nèi)部所維護的時間。在系統(tǒng)掉電后由電池進行供電。因此系統(tǒng)電源掉電后RTC時間仍然能夠正常運行，RTC芯片時鐘的作用是在Linux不運行時，依然可以保持時間信息。

芯片時鐘同步到系統(tǒng)時鐘。

sudo hwclock --hctosys

系統(tǒng)時鐘同步到芯片時鐘（或者是sudo hwclock -w）。

sudo hwclock --systohc

如果只想查詢RTC芯片時鐘，但不同步到系統(tǒng)時鐘，可以采用以下命令。

sudo hwclock -r

1.3 系統(tǒng)時鐘的讀寫

本文著重介紹的是【RTC時鐘】，關(guān)于【系統(tǒng)時鐘】的詳細(xì)介紹和操作，可以通過閱讀《EASY-EAI-Toolkit/通用組件/系統(tǒng)操作-時間參數(shù)》一文進行了解。

1.4 時區(qū)和校時服務(wù)

時區(qū)：【RTC時鐘】和【系統(tǒng)時鐘】用的都是UTC時間，不同地區(qū)所使用的時間，還需要考慮上時區(qū)的影響。

校時服務(wù)：【RTC時鐘】除了可以被手動操作，校時服務(wù)也會影響RTC時鐘。

關(guān)于【時區(qū)設(shè)置】和【校時服務(wù)】，EASY-EAI-Nano-TB可以參考《應(yīng)用筆記/自動校時與時區(qū)設(shè)置》一文進行操作。更詳細(xì)的交互作用機制，可參考《系統(tǒng)時間管理介紹》。

2. 快速上手

2.1 開發(fā)環(huán)境準(zhǔn)備

如果您初次閱讀此文檔，請閱讀《入門指南/開發(fā)環(huán)境準(zhǔn)備/Easy-Eai編譯環(huán)境準(zhǔn)備與更新》，并按照其相關(guān)的操作，進行編譯環(huán)境的部署。

在PC端Ubuntu系統(tǒng)中執(zhí)行run腳本，進入EASY-EAI編譯環(huán)境，具體如下所示。

cd ~/develop_environment ./run.sh

2.2 源碼下載以及例程編譯

首先，在虛擬機后臺終端，執(zhí)行以下命令，創(chuàng)建外設(shè)單例源碼管理目錄：

cd /opt mkdir -p EASY-EAI-Nano-TB/demo

首先，到【百度網(wǎng)盤】上下載相關(guān)的單例程序：

鏈接：https://pan.baidu.com/s/1Br608Hiff2Xs65PzWO_qWQ?pwd=1234

提取碼：1234

比如把單例程序下載到：此電腦\D:\BaiduNetdisk (無規(guī)定，用戶可自主選擇)，如下圖所示。

再將下載好的單例復(fù)制進入虛擬機的文件系統(tǒng)，過程如下圖所示。

最后，進入到對應(yīng)的例程目錄執(zhí)行編譯操作，具體命令如下所示：

cd EASY-EAI-Nano-TB/demo/12_RTC ./build.sh

注：

* 由于依賴庫部署在板卡上，因此交叉編譯過程中必須保持/mnt掛載。

編譯成功后，會生成一個test-rtc的可執(zhí)行程序在Release目錄下，并會自動部署到開發(fā)板的/userdata/目錄中。

2.3 例程運行

通過串口調(diào)試或ssh調(diào)試，進入板卡后臺，定位到例程部署的位置，如下所示：

cd /userdata

執(zhí)行例程命令，如下所示。

sudo ./test-rtc

執(zhí)行效果如下所示。

3. C語言使用案例

RTC的C語言使用案例，代碼地址為12_RTC/test-rtc/main.c，供用戶編碼參考。以下代碼展示了對RTC時鐘的讀寫操作流程：

int main(int argc, char const *argv[]) { const char *strDateTime = "2023-09-21 15:22:37"; // 將字符串轉(zhuǎn)換為tm結(jié)構(gòu)體類型的時間信息 struct tm tm = {0}; strptime(strDateTime, "%Y-%m-%d %H:%M:%S", &tm); // 打開RTC設(shè)備 int rtc_fd = open("/dev/rtc0", O_RDWR); if (rtc_fd < 0) { perror("open RTC device /dev/rtc0 faild."); close(rtc_fd); return -1; } printf("---設(shè)置參數(shù)前日期時間---\n"); system("date"); /*** 1.關(guān)閉網(wǎng)絡(luò)校時服務(wù) ***/ system("systemctl stop ntp.service"); /*** 2.將預(yù)設(shè)好的時間寫入【RTC時鐘】 ***/ struct rtc_time rtc_tm; rtc_tm.tm_sec = tm.tm_sec; rtc_tm.tm_min = tm.tm_min; rtc_tm.tm_hour = tm.tm_hour; rtc_tm.tm_mday = tm.tm_mday; rtc_tm.tm_mon = tm.tm_mon; rtc_tm.tm_year = tm.tm_year; if (ioctl(rtc_fd, RTC_SET_TIME, &rtc_tm) < 0) { perror("set data time to rtc0"); perror("RTC時間設(shè)置失敗"); close(rtc_fd); return -1; } /*** 3.將【RTC時鐘】同步回【系統(tǒng)時鐘】 ***/ // 讀出剛才寫入的RTC時鐘參數(shù) if (ioctl(rtc_fd, RTC_RD_TIME, &rtc_tm) < 0) { perror("RTC時間讀取失敗"); close(rtc_fd); return -1; } close(rtc_fd); tm.tm_sec = rtc_tm.tm_sec; tm.tm_min = rtc_tm.tm_min; tm.tm_hour = rtc_tm.tm_hour; tm.tm_mday = rtc_tm.tm_mday; tm.tm_mon = rtc_tm.tm_mon; tm.tm_year = rtc_tm.tm_year; struct timeval tv; tv.tv_sec = mktime(&tm); tv.tv_usec = 0; // 同步時間到系統(tǒng)時鐘 if(0 != settimeofday(&tv, (struct timezone *)0)){ perror("系統(tǒng)時間設(shè)置失敗"); } printf("---設(shè)置參數(shù)后日期時間---\n"); system("date"); return 0; }