OpenHarmony輕量系統(tǒng)-獲取當(dāng)?shù)貢r間
想了解更多關(guān)于開源的內(nèi)容，請?jiān)L問：
前言
在輕量設(shè)備里面，我們常常需要獲取本地時間，用于時間顯示，log記錄，幫助RTC芯片糾正時間等等。我們在之前設(shè)計(jì)了一個智慧時鐘，需要使用到本地當(dāng)前時間，因此本篇文章想在OpenHarmony上實(shí)現(xiàn)SNTP獲取本地時間，并將此功能集成為一個模塊，便于我們的主程序調(diào)用。
環(huán)境
OpenHarmony3.1
潤和hispark_pegasus Hi3861開發(fā)板
DevEco Device Tool
串口調(diào)試助手
SNTP介紹
SNTP(Simple Network Time Protocal簡單網(wǎng)絡(luò)時間協(xié)議)，用于跨廣域網(wǎng)或局域網(wǎng)同步時間的協(xié)議，主要用來同步因特網(wǎng)中的計(jì)算機(jī)時鐘，具有較高的精確度（幾十毫秒）。
SNTP協(xié)議相對于NTP，優(yōu)化了網(wǎng)絡(luò)傳播延時的影響，同時也能保證時間達(dá)到一定的精確度。
SNTP協(xié)議采用客戶端/服務(wù)器的工作方式，可以采用單播（點(diǎn)對點(diǎn)）或者廣播（一點(diǎn)對多點(diǎn)）模式操作。SNTP服務(wù)器通過接收 GPS信號或自帶的原子鐘作為系統(tǒng)的時間基準(zhǔn)。單播模式下，SNTP客戶端能夠通過定期訪問 SNTP服務(wù)器獲得準(zhǔn)確的時間信息，用于調(diào)整客戶端自身所在系統(tǒng)的時間，達(dá)到同步時間的目的。
時間戳
SNTP發(fā)送回來的時間戳是NTP時間戳。
NTP時間戳和UTC時間戳的主要區(qū)別在于它們的起始時間：
NTP時間戳的起始點(diǎn)是1900年1月1日00:00:00。
UTC時間戳（Unix時間戳）的起始點(diǎn)是1970年1月1日00:00:00。
軟件設(shè)計(jì)流程
流程圖
文件樹狀圖
.
├── include //sntp庫
│ └── lwip
│ └── apps
│ ├── sntp.h
│ └── sntp_opts.h
├── src //sntp源文件
│ ├── BUILD.gn
│ ├── sntp.c
│ ├── sntp_debug.c
│ ├── sntp_port.c
│ └── sntp_port.h
└── test //模塊主代碼
├── BUILD.gn
├── sntp_test.c //模塊源代碼
├── sntp_test.h //模塊接口、wifi配置
├── wifi_connecter.c //wifi連接庫
└── wifi_connecter.h使用方法
- 下載源碼。
- 將SNTP文件夾放入applications/sample/wifi-iot/app路徑下。
- 在applications/sample/wifi-iot/app/BUILD.gn的features內(nèi)添加以下代碼。
"sntp/src:sntp",
"sntp/test:sntp_test",在自己的主程序中引用sntp_test.h文件,調(diào)用set_sntp_init()函數(shù)初始化,隨后即可通過訪問sntp_time_sec變量獲取當(dāng)前時間(NTP時間戳0時區(qū))。
流程介紹
連接WIFI
連接的WIFI需要可以訪問互聯(lián)網(wǎng),否則設(shè)備無法聯(lián)網(wǎng)獲取時間。
WIFI當(dāng)前設(shè)置為：（配置在/sntp/test/sntp_test.h)。
- SSID：M20P
- PSK：12345678
設(shè)置SNTP服務(wù)器
常用SNTP服務(wù)器有以下四個：
"cn.ntp.org.cn", // 中國 NTP 快速授時服務(wù)
"ntp.ntsc.ac.cn", // 國家授時中心 NTP 服務(wù)器
"time.pool.aliyun.com", // 阿里云公共 NTP 服務(wù)器
"cn.pool.ntp.org", // 國際 NTP 快速授時服務(wù)在本文章中,SNTP_SERVER_DNS默認(rèn)為0,因此我們使用IP進(jìn)行配置SNTP服務(wù)器。
#if SNTP_SERVER_DNS
static const char* g_ntpServerList[] = {
// refers from https://dns.icoa.cn/ntp/#china
"cn.ntp.org.cn", // 中國 NTP 快速授時服務(wù)
"ntp.ntsc.ac.cn", // 國家授時中心 NTP 服務(wù)器
"time.pool.aliyun.com", // 阿里云公共 NTP 服務(wù)器
"cn.pool.ntp.org", // 國際 NTP 快速授時服務(wù)
};
#define SNTP_SERVERS ARRAY_SIZE(g_ntpServerList)
void SntpSetServernames(void)
{
for (size_t i = 0; i < SNTP_SERVERS; i++) {
sntp_setservername(i, g_ntpServerList[i]);
}
}
#else
ip4_addr_t g_ntpServerList[SNTP_MAX_SERVERS];
void SntpSetServers(void)
{
IP4_ADDR(&g_ntpServerList[0], 114, 67, 237, 130); // cn.ntp.org.cn
IP4_ADDR(&g_ntpServerList[1], 114, 118, 7, 163); // ntp.ntsc.ac.cn
IP4_ADDR(&g_ntpServerList[2], 182, 92, 12, 11); // time.pool.aliyun.com
IP4_ADDR(&g_ntpServerList[3], 193, 182, 111, 12); // cn.pool.ntp.org
#define SNTP_SERVERS 4
for (size_t i = 0; i < SNTP_SERVERS; i++) {
sntp_setserver(i, (ip_addr_t*)&g_ntpServerList[i]);
}
}
#endif
void set_sntp_init(void)
{
/****************************/
#if SNTP_SERVER_DNS
ip4_addr_t dnsServerAddr;
IP4_ADDR(&dnsServerAddr, 192, 168, 1, 1);
dns_setserver(0, (struct ip_addr *)&dnsServerAddr);
dns_init();
SntpSetServernames();
#else
SntpSetServers();
#endif
/****************************/
}SNTP初始化以及獲取時間
sntp_setoperatingmode(SNTP_OPMODE_POLL);
sntp_init();
printf("sntp_enabled: %d\r\n", sntp_enabled());
for (size_t i = 0; i < SNTP_SERVERS; i++) {
printf("sntp_getreachability(%d): %d\r\n", i, sntp_getreachability(i));
}
osDelay(500);
for (size_t i = 0; i < SNTP_SERVERS; i++) {
printf("sntp_getreachability(%d): %d\r\n", i, sntp_getreachability(i));
}時間顯示
本樣例源碼僅作為一個底層模塊，因此尚未有主程序?？梢宰孕袆?chuàng)建一個主程序進(jìn)行測試獲取時間，或者按照以下方式修改源碼：在sntp/test/sntp_test.c的SntpSetServers函數(shù)末尾添加以下代碼（顯示獲取到的時間）：
time_t ut;
ut = (unsigned int)((unsigned int)sntp_time_sec + ((unsigned int)2085978496L)); //轉(zhuǎn)換成UTC時間（0時區(qū)）
struct tm *now_time = gmtime(&ut);
printf("%d %d %d\n", now_time->tm_hour, now_time->tm_min, now_time->tm_sec);在sntp/test/sntp_test.c末尾添加以下代碼（開機(jī)自啟動）：
SYS_RUN(set_sntp_init);測試
文章相關(guān)附件可以點(diǎn)擊下面的原文鏈接前往下載：
https://ost.51cto.com/resource/3095。
