如何使用NTP同步时间？

news/2025/3/17 8:55:55/文章来源:https://www.cnblogs.com/luatos/p/18503749

一、NTP通信概述

很多场景中，由于业务需要，模块需要保持正确的系统时钟，才能正常工作。但是模块上电后的初试时间戳是946713600（即2000/01/01,16:00:00），所以同步时钟成为了开发者要解决的重要问题。对于Cat.1模块,移动/电信卡,通常会下发基站时间,那么sntp就不是必要的,而联通卡通常不会下发,就需要sntp了。

NTP（NetworkTimeProtocol，网络时间协议）是用于同步系统时间的协议。它通过网络连接多个设备，确保这些设备的系统时钟保持一致。

本例程展示了如何使用SNTP授时服务来同步时间。

NTP和简化版的SNTP主要区别在于精确度和复杂性。
SNTP（SimpleNetworkTimeProtocol）通常用于不需要高精度同步的设备，如嵌入式系统。而NTP则用于要求较高时间精度的场景。

二、演示功能概述

本demo将连接NTP服务器进行时间同步。

三、准备硬件环境

3.1 Air780E开发板一套，包括天线、USB数据线；

编辑

此核心板的详细使用说明参考：

Air780E产品手册：
https://docs.openluat.com/air780e/product/
<<开发板Core_Air780E使用说明V1.0.5.pdf>>，X.X.X指版本号；核心板使用过程中遇到任何问题，可以直接参考这份使用说明pdf文档。

3.2 SIM卡

请准备一张可正常上网的SIM卡，该卡可以是物联网卡或您的个人手机卡。

特别提醒：请确保SIM卡未欠费且网络功能正常，以便顺利进行后续操作。

3.3 数据通信线

typec接口USB数据线即可。

3.4 PC电脑

WINDOWS系统。

四、准备软件环境

4.1 基本的下载调试工具

使用说明参考Luatools下载和详细使用：
https://docs.openluat.com/Luatools

五、获取NTP授时软硬件资料

5.1 文档和工具

780E模块使用固件：SDK&Demo-合宙文档中心，本demo使用的固件版本是：

LuatOS-SoC_V1112_EC618_FULL.soc
本教程使用的demo：

https://gitee.com/openLuat/LuatOS-Air780E/tree/master/demo/sntp
将固件和脚本烧录到模块中：Luatools下载和使用教程-合宙模组资料中心
源码和固件已打包，如下所示：右键点我,另存为,下载完整压缩文件包

5.2 demo使用api介绍

socket.sntp(sntp_server)

作用：sntp时间同步

传入值类型

解释

string/table

sntp服务器地址选填

int

适配器序号，
只能是socket.ETH0（外置以太网），
socket.LWIP_ETH（内置以太网），
socket.LWIP_STA（内置WIFI的STA），
socket.LWIP_AP（内置WIFI的AP），
socket.LWIP_GP（内置蜂窝网络的GPRS），
socket.USB（外置USB网卡），

如果不填，优先选择soc平台自带能上外网的适配器，
若仍然没有，选择最后一个注册的适配器。

返回值

无

os.time(mytime)

作用：时间戳函数

参数

传入值类型	解释
table	日期时间的table
return	时间戳

返回值

无

os.date(fmt,time)

作用：日期函数

参数

传入值类型	解释
string	格式化字符串,可以是nil
table	日期时间的table

返回值

返回值类型	解释
table/string	根据fmt的不同,返回值不同

json.encode(obj,t)

作用：将对象序列化为json字符串

参数

传入值类型	解释
obj	需要序列化的对象
string	浮点数精度和模式, 这项不存在的时候,为默认值”7f”, 数字只支持”0~14”,模式只支持”f/g”

返回值

返回值类型	解释
string	序列化后的json字符串, 失败的话返回nil
string	序列化失败的报错信息

json.decode(str)

作用：将字符串反序列化为对象

参数

传入值类型	解释
string	需要反序列化的json字符串

返回值

返回值类型	解释
obj	反序列化后的对象(通常是table), 失败的话返回nil
result	成功返回1,否则返回0
err	反序列化失败的报错信息