第3章 NTP客户端实现

3、NTP客户端实现：报文解析、库移植与时间校准

好，咱们进入第三章。这一章我打算手把手带你实现一个NTP客户端。说实话，NTP协议本身并不复杂，但真正在VxWorks上跑起来，坑还是不少的。我当年第一次移植的时候，就因为一个字节序的问题折腾了一整天——嗯，后来长记性了。

3.1 NTP报文格式解析

先看报文。NTP报文格式其实挺简洁的，一共就64字节（不算扩展字段）。我习惯把它分成两部分看：头部和时间戳。

偏移（字节）	字段	长度（位）	说明
0	LI	2	闰秒指示器
0	VN	3	版本号（当前用4）
0	Mode	3	模式：3=客户端，4=服务器
1	Stratum	8	层数（1~15）
2	Poll	8	轮询间隔（秒的2次幂）
3	Precision	8	系统时钟精度
4~7	Root Delay	32	到主参考源的总延迟
8~11	Root Dispersion	32	最大误差
12~15	Reference ID	32	参考源标识
16~23	Reference Timestamp	64	上次校准时间
24~31	Originate Timestamp	64	客户端发送时间（T1）
32~39	Receive Timestamp	64	服务器接收时间（T2）
40~47	Transmit Timestamp	64	服务器发送时间（T3）

这里有个关键点：时间戳是64位的，前32位是整数秒，后32位是小数秒。基准时间是1900年1月1日。为什么不是1970年？因为NTP比Unix早啊。我刚开始做的时候直接拿Unix时间戳去算，结果差了70年——你说尴尬不尴尬。

核心公式：

偏移量 = ((T2 - T1) + (T3 - T4)) / 2

往返延迟 = (T4 - T1) - (T3 - T2)

其中T4是客户端收到响应的时间。

3.2 VxWorks下NTP客户端库移植

VxWorks本身不带NTP客户端库，得自己移植。我推荐用lwIP自带的NTP实现，或者用ntpclient这个开源库。我个人习惯用ntpclient，因为它够轻量，代码量也就几百行。

移植步骤其实就三步：

网络层适配：把socket相关的调用换成VxWorks的API。VxWorks的socket接口和BSD socket基本一致，改起来不费劲。
时间接口适配：VxWorks获取系统时间用的是clock_gettime()，设置时间用的是clock_settime()。注意VxWorks的时钟精度是纳秒级的，够用。
任务管理：NTP客户端需要周期性运行。我建议创建一个独立的任务，优先级设中等，别太高也别太低。

给你看个核心代码片段：

/* NTP报文发送函数 */
STATUS ntp_send_request(int sockfd, struct sockaddr_in *server_addr)
{
    NTP_PACKET packet;
    memset(&packet, 0, sizeof(packet));
    
    /* 填充报文头 */
    packet.li_vn_mode = 0x1B;  /* LI=0, VN=4, Mode=3 */
    
    /* 记录发送时间戳 T1 */
    struct timespec ts;
    clock_gettime(CLOCK_REALTIME, &ts);
    packet.tx_timestamp_sec = htonl(ts.tv_sec + NTP_TIMESTAMP_DELTA);
    packet.tx_timestamp_frac = htonl(ts.tv_nsec * (1ULL << 32) / 1000000000ULL);
    
    /* 发送报文 */
    return sendto(sockfd, &packet, sizeof(packet), 0,
                  (struct sockaddr *)server_addr, sizeof(*server_addr));
}

避坑指南：

我曾经在移植时忘了处理NTP_TIMESTAMP_DELTA这个偏移量。这个值是2208988800ULL，也就是1900年到1970年之间的秒数。不加上这个，你算出来的时间全是错的。

3.3 NTP时间获取与校准

时间拿到了，怎么校准？这里分两步：

第一步：计算偏移量

收到服务器响应后，你手里有T1、T2、T3、T4四个时间戳。用前面那个公式算出偏移量。注意，如果偏移量绝对值小于128毫秒，我建议用adjtime()做微调，而不是直接clock_settime()。为什么？因为直接设置时间会导致系统时间跳变，可能引发一些定时器任务出问题。

第二步：应用校准

VxWorks下设置系统时间有两种方式：

粗调：clock_settime()，适合偏移量大于1秒的情况。
微调：adjtime()，适合小范围调整，不会引起时间跳变。

我一般这么处理：

/* 时间校准函数 */
void ntp_adjust_time(int64_t offset_ns)
{
    struct timespec ts;
    
    if (llabs(offset_ns) > 1000000000LL) {
        /* 偏移超过1秒，直接设置 */
        clock_gettime(CLOCK_REALTIME, &ts);
        ts.tv_sec += offset_ns / 1000000000LL;
        ts.tv_nsec += offset_ns % 1000000000LL;
        /* 处理纳秒溢出 */
        if (ts.tv_nsec >= 1000000000L) {
            ts.tv_sec++;
            ts.tv_nsec -= 1000000000L;
        }
        clock_settime(CLOCK_REALTIME, &ts);
    } else {
        /* 小偏移，用adjtime微调 */
        struct timeval delta;
        delta.tv_sec = 0;
        delta.tv_usec = offset_ns / 1000;
        adjtime(&delta, NULL);
    }
}

注意：

VxWorks的adjtime()在有些BSP里可能没实现。如果你发现调用返回错误，那就只能用clock_settime()了。不过，我建议你在系统启动时先检查一下这个函数是否可用。

3.4 实战经验总结

最后，分享几个我踩过的坑：

字节序问题：NTP报文是大端字节序，而VxWorks跑在x86上是小端。别忘了用htonl()和ntohl()转换。
超时处理：NTP服务器可能没响应。我习惯设5秒超时，重试3次。如果都失败，就等下一个轮询周期再试。
轮询间隔：别太频繁。我一般设64秒一次。太频繁了浪费带宽，也增加服务器负担。
多服务器冗余：建议配2~3个NTP服务器。一个挂了还有备用的。我常用pool.ntp.org的服务器。