概述
簡單網絡時間協議（Simple Network Time Protocol），由NTP發展而來，為聯網設備提供了一種同步網絡時間的方式。AliOS Things為用戶提供了sntp獲取的接口，開發者在聯網后，可方便獲取網絡時間。
版權信息
Apache license v2.0
目錄結構
├── example
│ └── sntp_example.c # sntp使用示例代碼
├── include
│ └── sntp
│ └── sntp.h # sntp頭文件
├── package.yaml # 編譯配置文件
├── README.md # README文檔
└── src
└── sntp.c # sntp核心實現代碼依賴組件
lwip
常用配置
// sntp.h
SNTP端口號：
#define SNTP_PORT 123
SNTP是否支持多服務器，以及服務器的個數
#define SNTP_SUPPORT_MULTIPLE_SERVERS 1
#if SNTP_SUPPORT_MULTIPLE_SERVERS
#define SNTP_MAX_SERVERS 3
#endif
SNTP接收超時時間
#define SNTP_RECV_TIMEOUT 3000 /* ms */
SNTP重傳時的接收超時
#define SNTP_RETRY_TIMEOUT SNTP_RECV_TIMEOUT
SNTP最大重傳次數
#define SNTP_RETRY_TIMES 3
SNTP服務器地址
#define SNTP_SERVER_ADDRESS "pool.ntp.org"API說明
參考 sntp_api
發送獲取sntp請求
int sntp_request(void *arg)args | description |
arg | 用戶數據結構體指針 |
獲取sntp請求結果
sntp_time *sntp_obtain_time(void)args | description |
void | NA |
使用示例
組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具，所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》，下載安裝。 待開發環境搭建完成后，可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
打開已有工程
如果用于測試的案例工程已存在，可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。
創建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例（solution）來運行，這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。
步驟2 添加組件
案例下載完成后，需要在helloworld_demo組件的package.yaml中添加對組件的依賴：
depends:
- sntp: dev_aos步驟3 下載組件
在已安裝了 的開發環境工具欄中，選擇Terminal -> New Terminal啟動終端，并且默認工作路徑為當前工程的workspace，此時在終端命令行中輸入：
aos install sntp上述命令執行成功后，組件源碼則被下載到了./components/sntp路徑中。
步驟4 添加示例
sntp組件的package.yaml中添加example示例代碼：
source_file:
- src/*.c
- example/*.c步驟5 編譯固件
在示例代碼已經添加至組件的配置文件，并且helloworld_demo已添加了對該組件的依賴后，就可以編譯helloworld_demo案例來生成固件了，具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后，可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后，可以通過串口查看示例的運行結果，打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。
當串口終端打開成功后，可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
CLI命令行輸入：
sntp_example關鍵日志
CLI日志：
sntp test
21-3-19: week: 5, 17:59:20注意事項
使用sntp服務，需要先連接網絡