實時時鐘(Real-Time Clock,RTC)常用于制作時鐘日歷。RTC電路分屬于兩個電源域:備份域和VDD電源域。RTC的核心計數(shù)部分在備份域中,可在VDD斷電VBAT供電時保持RTC的計數(shù),當系統(tǒng)復位或者從待機模式喚醒時,RTC的設置和時間也都保持不變。本期內(nèi)容將通過一個顯示當前時間的例程帶領(lǐng)大家初步了解GD32VF103的RTC外設的使用方法。
系統(tǒng)環(huán)境:Windows 10-64bit
軟件平臺:NucleiStudio IDE 202102版或 PlatformIO IDE
GD32VF103的RTC電路
GD32VF103的RTC電路包含兩個主要部分,分別是位于PCLK1時鐘域的APB接口和位于RTC時鐘域的RTC內(nèi)核:
APB接口與APB1總線相連,包含一組寄存器,可通過APB1總線對其進行訪問。
RTC內(nèi)核包含兩個主要模塊,一個是RTC預分頻模塊,模塊包含一個20位可編程預分頻器,該分頻器可以通過對RTC時鐘源分頻產(chǎn)生SC_CLK,如果RTC_INTEN寄存器中的秒中斷標志位被使能,在每個SC_CLK上升沿,RTC會產(chǎn)生一個秒中斷。另外一個模塊是一個32位可編程計數(shù)器,其數(shù)值可以被初始化為當前系統(tǒng)時間。如果RTC_INTEN的鬧鐘中斷標志位被使能,RTC會在系統(tǒng)時間等于鬧鐘時間(存儲于RTC_ALRMH/L寄存器)時產(chǎn)生一個鬧鐘中斷。
RTC的主要特征如下:
32位可編程計數(shù)器,用于計數(shù)運行時間
可編程的預分頻器,分頻系數(shù)最高可達2^20
獨立時鐘域:
PCLK1時鐘域
RTC時鐘域(該時鐘域必須比PCLK1時鐘至少慢4倍)
RTC時鐘源:
HXTAL時鐘除以128
LXTAL振蕩電路時鐘
IRC40K振蕩電路時鐘
可屏蔽的中斷源:
鬧鐘中斷
秒中斷
溢出中斷
實驗部分
本期的實驗將使用RV-STAR的RTC外設實現(xiàn)顯示當前時間的功能,例程的整體實現(xiàn)思路如下:
首先需要初始化RTC外設:使能時鐘源和配置預分頻系數(shù)等,對于是否通過串口打印輸出當前時間,聲明一個狀態(tài)變量并賦值為0;
然后用戶通過串口人工輸入當前的時間對RTC的寄存器進行配置,RTC進入自動計數(shù)模式,每秒產(chǎn)生一個中斷,在中斷服務程序中將狀態(tài)變量置1
主程序中運行一個循環(huán)體,判斷狀態(tài)變量的值,如果為1,則讀取RTC寄存器存儲的當前時間然后打印輸出到串口
重點講解一下RTC外設的初始化配置,其代碼片段如下:
void rtc_configuration(void)
{
/* enable PMU and BKPI clocks */
rcu_periph_clock_enable(RCU_BKPI);
rcu_periph_clock_enable(RCU_PMU);
/* allow access to BKP domain */
pmu_backup_write_enable();
/* reset backup domain */
bkp_deinit();
/* enable LXTAL */
rcu_osci_on(RCU_LXTAL);
/* wait till LXTAL is ready */
rcu_osci_stab_wait(RCU_LXTAL);
/* select RCU_LXTAL as RTC clock source */
rcu_rtc_clock_config(RCU_RTCSRC_LXTAL);
/* enable RTC Clock */
rcu_periph_clock_enable(RCU_RTC);
/* wait for RTC registers synchronization */
rtc_register_sync_wait();
/* wait until last write operation on RTC registers has finished */
rtc_lwoff_wait();
/* enable the RTC second interrupt*/
rtc_interrupt_enable(RTC_INT_SECOND);
/* wait until last write operation on RTC registers has finished */
rtc_lwoff_wait();
/* set RTC prescaler: set RTC period to 1s */
rtc_prescaler_set(32767);
/* wait until last write operation on RTC registers has finished */
rtc_lwoff_wait();
}
由于使用RV-STAR板載的32.768K的晶振作為RTC時鐘源,因此配置時要選擇LXTAL,同時要注意預分頻系數(shù)的設置,另外每次對RTC的寫操作,均要等待寫入完成,例程其余部分的代碼均有詳細注釋,讀者們可以自行閱讀,相關(guān)代碼請參考RVMCU網(wǎng)站專欄對應鏈接。
將完整代碼進行編譯上傳至RV-STAR開發(fā)板,打開串口終端(圖中使用PlatformIO的串口終端,也可以使用其他的串口工具):
然后在串口終端中依次輸入當前時間的時、分、秒數(shù)據(jù),時鐘功能就正常開啟了,將會每秒刷新輸出一次當前時間,如下圖:
如果按下復位按鈕,程序會重啟,但只要保持通電,RTC的計時會正常進行,數(shù)據(jù)也不會丟失,按下復位后的串口打印結(jié)果見下圖:
復位后依然正常顯示當前時間,說明RTC外設按照我們期望的功能在運行。如果拔掉USB數(shù)據(jù)線,供電完全切斷,那數(shù)據(jù)將會丟失,需要再次配置當前時間。
有條件的讀者也可以嘗試將鋰電池及底座焊接到RV-STAR背面預留的焊接處,那樣即使USB數(shù)據(jù)線的供電切斷,RTC也可以依靠電池電源保存數(shù)據(jù)并持續(xù)計時。
由于GD32VF103的RTC外設較為簡單,硬件上僅有時鐘(時/分/秒)相關(guān)的寄存器,而沒有日歷相關(guān)的寄存器,因此如果要實現(xiàn)完整的日歷時鐘顯示,需要用軟件來實現(xiàn)日歷,留給讀者自行探索。