使用NTP，该如何同步时间？一文详解！

​

一、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数据线；

3.2 PC电脑

WINDOWS系统。

3.3 SIM卡

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

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

3.4 数据通信线

typec接口USB数据线即可。

四、软件环境

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 将程序下载到开发板

参考：将固件和脚本烧录到模块中：Luatools下载和使用教程-合宙模组资料中心

七、功能验证

​

八、总结

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

九、扩展

常见问题

9.1 多长时间ntp同步一次？

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

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

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

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

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

​审核编辑 黄宇