使用NTP同步时间，该如何操作？

最新推荐文章于 2025-12-05 12:11:05 发布

原创最新推荐文章于 2025-12-05 12:11:05 发布 · 871 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#嵌入式硬件 #硬件工程 #物联网

一、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下载和详细使用

五、获取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	反序列化失败的报错信息

六、代码示例介绍

6.1 使用ntp服务器同步时间

6.1.1 demo介绍

6.1.2 将程序下载到开发板

七、功能验证

八、总结

本demo介绍了如何使用ntp服务器同步时间。

九、扩展

常见问题

9.1 这个函数socket.sntp()后每次在程序中调用os.time也是实时时间了吗？

是的，只要时间同步成功了，就是实时时间了。

9.2 ntp同步时间后，这个clock精度高吗，需要多久同步一次？

并不能保证任何时间任何地点都能百分百同步到正确的时间。所以，如果用户项目中的业务逻辑严格依赖于时间同步功能则不要使用本功能模块，建议使用自己的应用服务器来同步时间。

9.3 多长时间ntp同步一次？

正常使用,一小时一次,已经足够了,甚至1天一次也可以。