Air780EPM开发板NTP对时教程：LuatOS脚本开发入门指南

通过简单的LuatOS脚本，Air780EPM即可实现NTP时间同步。本指南从零开始，带你掌握嵌入式设备联网校时的核心方法。

一、NTP通信概述

1.1 NTP

网络时间协议（英语：Network Time Protocol，简称NTP）是在数据网络潜伏时间可变的计算机系统之间通过分组交换进行时钟同步的一个网络协议。自1985年以来，NTP是仍在使用的最古老的互联网协议之一。NTP由特拉华大学的David L. Mills设计。 NTP意图将所有参与计算机的协调世界时（UTC）时间同步到几毫秒的误差内。它使用Marzullo算法的修改版来选择准确的时间服务器，其设计旨在减轻可变网络延迟造成的影响。NTP通常可以在公共互联网保持几十毫秒的误差，并且在理想的局域网环境中可以实现超过1毫秒的精度。不对称路由和拥塞控制可能导致100毫秒（或更高）的错误。 该协议通常描述为一种主从式架构，但它也可以用在点对点网上中，对等体双方可将另一端认定为潜在的时间源。发送和接收时间戳采用用户数据报协议（UDP）的通信端口123实现。这也可以使用广播或多播，其中的客户端在最初的往返校准交换后被动地监听时间更新。NTP提供一个即将到来闰秒调整的警告，但不会传输有关本地时区或夏时制的信息。

1.2 SNTP

简单网络时间协议（Simple Network Time Protocol），由 NTP 改编而来，主要用来同步因特网中的计算机时钟。在 RFC2030 中定义。 SNTP是简化版的NTP，NTP（Network Time Protocol，网络时间协议）是用于同步系统时间的协议。它通过网络连接多个设备，确保这些设备的系统时钟保持一致。SNTP相比较NTP主要区别在于精确度和复杂性。SNTP通常用于不需要高精度同步的设备。而NTP则用于要求较高时间精度的场景。

虽然现在的程序名字使用的是SNTP，但现在底层的实现已经改成NTP了，只是名字还没改过来。对模组来说, 没多大区别。

二、演示功能概述

本demo将演示使用NTP授时服务来同步时间。

三、准备硬件环境

参考：硬件环境清单第二章节内容，准备以及组装好硬件环境。

四、软件环境

在开始实践本示例之前，先筹备一下软件环境：

1.Luatools工具；

2. 内核固件文件（底层core固件文件）：LuatOS-SoC_V2003_Air780EPM；参考项目使用的内核固件；

3. luatos需要的脚本和资源文件

脚本和资源文件：复制查看demo链接：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/ntp

lib脚本文件：使用Luatools烧录时，勾选 添加默认lib 选项，使用默认lib脚本文件；

准备好软件环境之后，接下来查看如何烧录项目文件到Air780EPM开发板，将本篇文章中演示使用的项目文件烧录到Air780EP开发板中。

五、代码示例介绍

5.1 API说明

5.1.1 socket.ntptm()

网络对时后的时间戳(ms级别)

参数

无

返回值

例子

5.1.2 socket.sntp_port(port)

设置SNTP服务器的端口号

参数

返回值

例子

5.2 使用NTP授时服务来同步时间

5.2.1 demo 介绍

六、功能验证

七、总结

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

常见问题

1、NTP同步时间后，这个clock精度高吗，需要多久同步一次

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

2、多长时间NTP同步一次

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

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

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

4、NTP白名单地址是什么？

默认的ntp服务器为ntp.aliyun.com，自定义ntp地址可以通过socket.sntp("ntp.aliyun.com")设置。

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

今天的内容就分享到这里了~

审核编辑 黄宇