1. 時(shí)間操作簡(jiǎn)介

在應(yīng)用開(kāi)發(fā)中，特別是設(shè)計(jì)日記記錄功能中，經(jīng)常涉及時(shí)間戳的操作，時(shí)間戳可直觀的體現(xiàn)程序的運(yùn)行時(shí)間，運(yùn)行效率。

1.1 查看系統(tǒng)時(shí)間(鐘)

查看系統(tǒng)時(shí)間命令如下所示。

* date命令查看的是系統(tǒng)時(shí)間(UTC+時(shí)區(qū))，當(dāng)前設(shè)置為CST，即北京時(shí)間；

1.2 設(shè)置系統(tǒng)時(shí)間(鐘)

設(shè)置系統(tǒng)時(shí)間有兩種方法，可【手動(dòng)設(shè)置時(shí)間】以及【NTP設(shè)置時(shí)間】。

【手動(dòng)設(shè)置時(shí)間】：通過(guò)date命令可以設(shè)置系統(tǒng)時(shí)間，設(shè)置格式為“yyyy-MM-dd HH:mm:ss”。

* 如有RTC時(shí)：設(shè)置系統(tǒng)時(shí)間之后，還需要輸入“hwclock -w”來(lái)寫(xiě)入硬件RTC時(shí)間。

* 修改時(shí)間一般需要管理員權(quán)限，若非管理員用戶，需加上“sudo”

【NTP設(shè)置時(shí)間】：NTP就是網(wǎng)絡(luò)時(shí)間同步協(xié)議。通過(guò)在互聯(lián)網(wǎng)上的校時(shí)服務(wù)器對(duì)板卡按照一定規(guī)律（不同的ntp-client策略會(huì)不一樣）進(jìn)行自動(dòng)校時(shí)。

1.3 RTC時(shí)鐘設(shè)置

本文著重介紹系統(tǒng)時(shí)間，RTC部分(如有)請(qǐng)參考閱讀《外設(shè)接口使用說(shuō)明/RTC》。

1.4 時(shí)區(qū)與校時(shí)服務(wù)

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

校時(shí)服務(wù)：【系統(tǒng)時(shí)鐘】除了可以被手動(dòng)操作外，校時(shí)服務(wù)也會(huì)影響系統(tǒng)時(shí)鐘。

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

1.5 系統(tǒng)運(yùn)行時(shí)長(zhǎng)

查看系統(tǒng)從上電到命令執(zhí)行的運(yùn)行信息。

uptime打印的信息分別如下：

當(dāng)前服務(wù)器時(shí)間；

當(dāng)前服務(wù)器運(yùn)行時(shí)長(zhǎng)；

當(dāng)前用戶數(shù)；

當(dāng)前的負(fù)載均衡，load average；

2. 快速上手

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

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

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

cd ~/develop_environment ./run.sh 2204

2.2 源碼下載以及例程編譯

在EASY-EAI編譯環(huán)境下創(chuàng)建存放源碼倉(cāng)庫(kù)的管理目錄：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通過(guò)git工具，在管理目錄內(nèi)克隆遠(yuǎn)程倉(cāng)庫(kù)

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git

注：

* 此處可能會(huì)因網(wǎng)絡(luò)原因造成卡頓，請(qǐng)耐心等待。

* 如果實(shí)在要在gitHub網(wǎng)頁(yè)上下載，也要把整個(gè)倉(cāng)庫(kù)下載下來(lái)，不能單獨(dú)下載本實(shí)例對(duì)應(yīng)的目錄。

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

cd EASY-EAI-Toolkit-1126B/Demos/common-system_opt/ ./build.sh

注：

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

2.3 例程運(yùn)行

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

cd /userdata/Demo/common-system_opt

運(yùn)行例程命令如下所示：

./test-timepara-opt

2.4 運(yùn)行效果

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

API的詳細(xì)說(shuō)明，以及API的調(diào)用（本例程源碼），詳細(xì)信息見(jiàn)下方說(shuō)明。

3. 時(shí)間操作API說(shuō)明

3.1 引用方式

EASY EAI api庫(kù)位于本倉(cāng)庫(kù)的easyeai-api目錄中。為方便客戶在本地工程中直接調(diào)用我們的EASY EAI api庫(kù)，此處列出工程中需要鏈接的庫(kù)以及頭文件等，方便用戶直接添加。

API源代碼路徑為EASY-EAI-Toolkit-1126B/easyeai-api/common/system_opt/。用戶可通過(guò)源代碼了解接口實(shí)現(xiàn)，甚至可對(duì)源碼進(jìn)行修改。

3.2 獲取時(shí)間戳（調(diào)試使用）

獲取時(shí)間戳函數(shù)用于獲取秒、毫秒、微秒，函數(shù)原型如下所示。

uint64_t get_timeval_us(); uint64_t get_timeval_ms(); uint64_t get_timeval_s();

具體介紹如下所示。

3.3 系統(tǒng)延時(shí)(基于nanosleep)

nanosleep一旦被調(diào)用，線/進(jìn)程就進(jìn)入 TASK_INTERRUPTIBLE 狀態(tài)，直到線/進(jìn)程被喚醒，就回到 TASK_RUNNIN 狀態(tài)。TASK_INTERRUPTIBLE 是可以被 [信號(hào)] 和 [wake_up()] 喚醒的，當(dāng)信號(hào)到來(lái)時(shí)，進(jìn)程會(huì)被設(shè)置為“可運(yùn)行”。

對(duì)線/進(jìn)程進(jìn)行秒、毫秒、微秒級(jí)別的延時(shí)，函數(shù)原型如下所示。

uint32_t osTask_usDelay(uint32_t us); uint32_t osTask_msDelay(uint32_t ms); uint32_t osTask_sDelay(uint32_t s);

具體介紹如下所示。

3.4 系統(tǒng)延時(shí)(基于usleep)

對(duì)線/進(jìn)程進(jìn)行秒、毫秒、微秒級(jí)別的延時(shí)，函數(shù)原型如下所示。

uint32_t msleep(uint32_t ms);

具體介紹如下所示。

3.5 獲取時(shí)間

獲取當(dāng)前系統(tǒng)時(shí)間，其值表示從CUT（Coordinated Universal Time）時(shí)間1970年1月1日00:00:00到當(dāng)前時(shí)刻的秒數(shù)。函數(shù)原型如下所示。

int get_time_stamp();

具體描述如下所示。

3.6 獲取系統(tǒng)日期，系統(tǒng)時(shí)間

獲取系統(tǒng)日期，系統(tǒng)時(shí)間函數(shù)原型如下。

void get_system_date_time(uint32_t *curDate, uint32_t *curTime);

具體描述如下所示。

3.7 設(shè)置系統(tǒng)日期，系統(tǒng)時(shí)間

設(shè)置系統(tǒng)日期，系統(tǒng)時(shí)間的操作函數(shù)原型如下所示。

void set_system_date_time(int year, int mon, int day, int hour, int min, int second);

具體描述如下所示。

4. API測(cè)試案例

示例代碼路徑為EASY-EAI-Toolkit-1126B/Demos/common-system_opt/test-timepara-opt.c。