ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

STM32F107软件实现PTP IEEE1588V2:无硬件时间戳的微秒级同步实践

STM32F107软件实现PTP IEEE1588V2:无硬件时间戳的微秒级同步实践

简介:面向嵌入式开发者的PTP IEEE1588v2在STM32F107上的完整实现方案,聚焦于利用LwIP轻量级协议栈完成高精度时钟同步这一典型难题,适合具备STM32与网络协议基础、需要落地工业自动化或通信设备时间同步功能的中高级开发者参考。压缩包共316个文件、约3.2MB,以C源码与头文件为主体,辅以汇编启动文件、Keil工程配置、说明文档及可烧录的hex固件,覆盖从协议栈移植到评估板验证的完整链路。已有1979人学习下载,说明其在同类实现中具备一定参考价值。资源内含LwIP与PTP模块的源码组织、评估板手册、烧录指引及两个固件版本,读者可据此理解协议栈裁剪、网络接口配置与时间戳处理的实现思路,并对照工程结构完成自己的移植与调试。

1. 从一块没有晶振温补的板子说起:PTP IEEE1588V2 在 STM32F107 上到底能跑成什么样

手里有一块 STM32F107 的开发板,网口是 LAN8720 那套 RMII 方案,板子上只有一颗 25MHz 的普通无源晶振,没有 TCXO,也没有 GPS 驯服。第一次把 PTP 协议栈塞进去的时候,我盯着示波器上主从两块板子的秒脉冲输出,偏差在几十微秒量级来回跳,心里其实是有数的——这活儿能做,但别指望做到亚微秒。PTP IEEE1588V2 在 STM32F107 这种 Cortex-M3 加 72MHz 主频、没有硬件时间戳单元的平台上,本质上是一场「软件补偿 + 中断抖动控制」的硬仗。这个项目要解决的就是:在没有专用 PTP 硬件的前提下,用 STM32F107 的 MAC 加软件时间戳,把 IEEE1588V2 的同步报文收发、偏移计算、频率调整这条链路完整跑通,让两块板子之间的时间偏差收敛到可用的量级。适合谁?适合那些手上有 STM32F107 或同系列带以太网的 MCU、想做分布式设备时间同步、又不想上 FPGA 或专用 PHY 的开发者。下面我按「这东西怎么搭起来 → 怎么跑起来 → 怎么改」的顺序,把踩过的坑和关键代码一段段拆开。

2. 协议栈与硬件底子:STM32F107 上跑 PTP 的架构选型

2.1 为什么是「软件时间戳 + MAC 中断」这条路

STM32F107 的以太网外设是 Synopsys 的 MAC 10/100,支持 RMII 接口,但它没有 IEEE1588 硬件时间戳单元——这一点很关键,很多 STM32 型号(比如 F4/F7 的部分型号)MAC 里带 PTP 时间戳寄存器,而 F107 没有。所以整个方案的时间基准只能靠软件在中断里打时间戳。常见做法是:在 MAC 接收中断里,报文刚被 DMA 搬进缓冲区的那一刻读一次定时器,作为接收时间戳;在发送完成中断里读定时器作为发送时间戳。这个「读定时器的时刻」和报文真正上线的时刻之间,隔着中断延迟、DMA 搬运、MAC 内部 FIFO 的排队,这几段抖动就是精度的天花板。

我一般会把时间基准挂在 TIM2 上,配置成 1MHz 计数、32 位自由运行,这样每个计数就是 1 微秒,换算简单。为什么不直接用 SysTick?因为 SysTick 是 1ms 中断,做时间戳分辨率不够,而且它被 RTOS 或延时函数占用,改起来牵扯太多。TIM2 独立跑,中断里只读 CNT 寄存器,开销小。频率调整则通过修改 TIM2 的 ARR 或者用预分频微调来实现,后面第 4 章会讲具体怎么调。

架构上分三层:底层是 MAC 驱动加 TIM2 时间基准,中间是 PTP 报文解析与状态机(Sync / Follow_Up / Delay_Req / Delay_Resp 四类报文),上层是时钟伺服(偏移计算 + 频率调整)。这个分层不是为了好看,是为了让「时间戳从哪来」和「偏移怎么算」解耦——换硬件平台时只动底层,伺服算法不动。

2.2 目录结构与模块职责

项目按功能切分,目录大致是这样:

ptp_f107/ ├── drivers/ │ ├── eth_mac.c # MAC 初始化、DMA 描述符、收发中断 │ ├── tim_base.c # TIM2 1MHz 时间基准、读写时间戳 │ └── lan8720.c # PHY 初始化与链路状态 ├── ptp/ │ ├── ptp_msg.c # 1588v2 报文头解析与构造 │ ├── ptp_fsm.c # 主从状态机、报文收发调度 │ ├── ptp_servo.c # 偏移计算、频率调整 │ └── ptp_cfg.h # 时钟身份、域号、报文间隔 ├── app/ │ └── main.c # 初始化顺序、主循环 └── lwip/ # 精简协议栈,仅用于 UDP/IP 封装

这里有个取舍要说清楚:PTP 报文走的是以太网二层(EtherType 0x88F7)还是 UDP 四层(319/320 端口)?项目里两种都留了入口,默认走二层,因为二层省掉 IP/UDP 头解析,时间戳打点更靠近 MAC,抖动小。但二层要求同一广播域,跨网段就得切 UDP。ptp_cfg.h里用一个宏PTP_USE_L2控制,编译期切换,运行期不折腾。

2.3 初始化顺序:先时间基准,再 MAC,最后协议栈

初始化顺序错了会出玄学问题。血泪经验是:TIM2 必须先于 MAC 初始化,因为 MAC 中断一开就可能来报文,此时时间戳函数还没准备好,读出来是 0,后面偏移计算直接飞掉。main.c里的顺序我固定成:

int main(void) { /* 1. 时钟树:HSE 8MHz -> PLL -> 72MHz,APB1 36MHz 给 TIM2 */ SystemClock_Config(); /* 2. 时间基准先起来,保证任何时刻读时间戳都有效 */ TIM_Base_Init(); /* TIM2, 1MHz, 32bit free-run */ /* 3. PHY 与 MAC,DMA 描述符建好后再开中断 */ LAN8720_Init(); ETH_MAC_Init(); /* 内部完成 DMA 描述符链、MAC 地址、过滤器 */ /* 4. PTP 协议层:读配置、定角色(主/从)、启动报文调度 */ PTP_Init(); while (1) { PTP_Poll(); /* 状态机推进、超时检测 */ } }

TIM_Base_Init里把 PSC 设成 71(72MHz/72 = 1MHz),ARR 设成 0xFFFFFFFF 自由运行,不使能更新中断——时间戳只需要读,不需要溢出中断,少一个中断源少一份抖动。ETH_MAC_Init里注意 DMA 描述符要放在 SRAM 里且地址对齐,F107 的 SRAM 只有 64KB,描述符数量和缓冲区大小要算着用,后面避坑章节会讲。

3. 核心链路拆解:从报文进 MAC 到时间偏差收敛

3.1 接收时间戳:中断里那几行代码决定精度上限

接收路径是整个方案里最敏感的一段。报文被 DMA 搬进缓冲区后触发 RX 中断,中断服务程序里第一件事就是读 TIM2->CNT,然后才做报文解析。顺序不能反,反了就把解析耗时算进时间戳里了。

void ETH_IRQHandler(void) { if (ETH->DMASR & ETH_DMASR_RS) { /* 收到帧 */ /* 关键:先打时间戳,再做任何判断 */ uint32_t ts = TIM2->CNT; FrameTypeDef frame = ETH_ReadFrame(); /* 取描述符、拿长度和指针 */ if (frame.length >= 14) { uint16_t ethertype = (frame.buffer[12] << 8) | frame.buffer[13]; if (ethertype == 0x88F7) { /* 是 PTP 二层报文 */ PTP_RxCallback(frame.buffer, frame.length, ts); } } ETH_ReleaseFrame(&frame); /* 归还描述符,必须做 */ ETH->DMASR = ETH_DMASR_RS; /* 清中断标志 */ } }

ts是 1MHz 计数,单位微秒,32 位在 1MHz 下约 71 分钟回绕一次,伺服层要处理回绕差值,不能直接相减。ETH_ReadFrame里遍历 DMA 描述符,注意 F107 的增强型描述符带帧长和状态位,读的时候要判断 OWN 位是否已由 DMA 归还给 CPU,没归还就说明数据还没到齐,直接跳过。ETH_ReleaseFrame把描述符 OWN 位重新置给 DMA,漏了这一步,收几十帧后接收就停了——这个坑我踩过,现象是 ping 通但 PTP 报文收着收着就断,查了半天以为是 PHY 链路问题。

3.2 偏移计算:四时间戳公式与回绕处理

IEEE1588v2 的偏移计算核心是四个时间戳:t1(主钟发 Sync)、t2(从钟收 Sync)、t3(从钟发 Delay_Req)、t4(主钟收 Delay_Req)。从钟侧算偏移:

/* 所有时间戳单位:微秒,32 位 */ static int64_t ts_diff(uint32_t a, uint32_t b) { /* 处理 32 位回绕:差值落在 ±2^31 内认为有效 */ int32_t d = (int32_t)(a - b); return (int64_t)d; } void PTP_CalcOffset(uint32_t t1, uint32_t t2, uint32_t t3, uint32_t t4) { /* 路径延迟 = ((t2 - t1) + (t4 - t3)) / 2 */ int64_t delay = (ts_diff(t2, t1) + ts_diff(t4, t3)) / 2; /* 偏移 = (t2 - t1) - delay,正值表示从钟慢于主钟 */ int64_t offset = ts_diff(t2, t1) - delay; PTP_Servo_Update(offset, delay); /* 交给伺服层 */ }

ts_diff用有符号 32 位相减再扩成 64 位,这样回绕自动被吃掉,前提是两次时间戳间隔小于 2^31 微秒(约 35 分钟),PTP 报文间隔是秒级,完全够用。delay算出来是单程延迟,正常局域网在几十到几百微秒;如果算出来是负数或者大得离谱(比如超过 10ms),基本可以断定时间戳打点位置错了或者报文配对错了,伺服层要丢弃这次样本,不能硬跟。

3.3 频率调整:让从钟的「秒」和主钟的「秒」一样长

只调偏移不调频率,从钟会一直靠「跳变」追主钟,时间线不连续,对上层应用是灾难。频率调整的思路是:观察连续多次 offset 的变化趋势,如果 offset 持续往一个方向漂,说明从钟的 TIM2 实际频率和主钟有偏差,微调 TIM2 的 ARR 或 PSC 来补偿。

void PTP_Servo_Update(int64_t offset, int64_t delay) { static int64_t last_offset = 0; static int32_t freq_adj = 0; /* 频率调整量,单位 ppb 近似 */ /* 一阶低通,滤掉单次测量的抖动 */ int64_t filt = (offset + last_offset) / 2; /* 比例项:偏移大就多调;积分项:持续漂移就累积频率修正 */ int32_t p_term = (int32_t)(filt / 16); int32_t i_term = (int32_t)(filt / 256); freq_adj += i_term; /* 限幅,防止异常样本把频率拉飞 */ if (freq_adj > 5000) freq_adj = 5000; if (freq_adj < -5000) freq_adj = -5000; /* 应用到 TIM2:ARR 微调,1MHz 下 1 个计数 = 1us */ TIM2->ARR = 0xFFFFFFFF + freq_adj; /* 实际项目用预分频小数补偿更稳 */ last_offset = offset; }

这段是简化示意,真实项目里 F107 的 TIM2 没有小数分频,直接改 ARR 会引入量化误差,常见做法是用一个软件累加器做「微跳」:每 N 个周期补一个计数,等效出小数频率。freq_adj的限幅值 5000 对应约 0.5% 的频率修正范围,普通晶振偏差在 ±50ppm 以内,这个范围绰绰有余,限太宽反而容易被异常样本带偏。p_term和i_term的系数不是拍脑袋,是拿两块板子对跑、记录 offset 序列后调出来的,换晶振或换板子要重新标。

3.4 主从状态机:报文调度与超时兜底

状态机管的是「什么时候发什么报文」。从钟收到 Sync 后等 Follow_Up(如果走两步模式),然后发 Delay_Req,等 Delay_Resp;主钟收到 Delay_Req 回 Delay_Resp。任何一步超时(比如 3 个报文间隔没来),状态机回退到监听,重新等 Announce 选主。

void PTP_Poll(void) { uint32_t now = TIM2->CNT; switch (ptp_state) { case PTP_STATE_LISTEN: if (announce_received) ptp_state = PTP_STATE_SLAVE_SYNC; break; case PTP_STATE_SLAVE_SYNC: if (sync_received && followup_received) { PTP_SendDelayReq(now); ptp_state = PTP_STATE_SLAVE_DELAY; state_deadline = now + 3 * SYNC_INTERVAL_US; } break; case PTP_STATE_SLAVE_DELAY: if (delayresp_received) { PTP_CalcOffset(t1, t2, t3, t4); ptp_state = PTP_STATE_SLAVE_SYNC; } else if ((int32_t)(now - state_deadline) > 0) { ptp_state = PTP_STATE_LISTEN; /* 超时回退 */ } break; } }

state_deadline用无符号差值比较(int32_t)(now - deadline) > 0来判断超时,这样回绕也安全。SYNC_INTERVAL_US默认 1 秒(对应 2^0 的 logMessageInterval),调试时可以改成 125ms 加快收敛,但间隔太短会加重中断负担,F107 在 72MHz 下每秒处理 8 个 Sync 报文已经有点吃力,别贪快。

4. 跑起来:编译、烧录与双板对测的完整步骤

4.1 工具链与工程配置

工程用 ARM GCC 加 Makefile,不依赖特定 IDE,方便在命令行复现。关键编译选项:

arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb -O2 \ -ffunction-sections -fdata-sections \ -DSTM32F107xC -DUSE_HAL_DRIVER \ -I./drivers -I./ptp -I./lwip/include \ -T stm32f107.ld \ drivers/*.c ptp/*.c app/main.c lwip/*.c \ -Wl,--gc-sections -o ptp_f107.elf

-O2是必须的,-O0下中断服务程序里读时间戳的指令数多出十几条,抖动肉眼可见变大。--gc-sections配合-ffunction-sections把没用的代码裁掉,F107 的 Flash 只有 256KB,lwIP 加 PTP 加 HAL 很容易顶到上限,裁剪后能省出十几 KB。链接脚本里注意把 DMA 描述符段放到 SRAM 起始对齐位置,别和栈打架。

烧录用 ST-Link,openocd或st-flash都行:

st-flash write ptp_f107.bin 0x08000000

烧完先别急着测 PTP,先用ping确认网络通,再看串口打印的链路状态和 PHY 自协商结果。串口波特率 115200,main.c里留了printf重定向,调试信息都从这里出。

4.2 双板对测:主从角色怎么定

两块板子,一块配成主钟(PTP_ROLE_MASTER),一块从钟(PTP_ROLE_SLAVE),在ptp_cfg.h里改宏,重新编译烧录。主钟负责发 Announce、Sync、Follow_Up,从钟发 Delay_Req。测试时把两块板子接到同一个交换机(或直连交叉线),从钟串口每秒打印一次 offset 和 delay。

判断收敛的土办法:看 offset 序列。刚上电时 offset 可能在几百微秒,几十秒内应该收敛到 ±10 微秒以内并保持;如果一直大幅摆动,先查时间戳打点位置,再查两块板子的 TIM2 是不是都配成了 1MHz。直连和过交换机的延迟不一样,过交换机会多几微秒且抖动大一点,这是正常的,交换机转发有排队。

4.3 用示波器看秒脉冲:最直观的验证

从钟收到 Sync 后,在 PTP 回调里翻转一个 GPIO,主钟同样翻转一个 GPIO,两路信号上示波器,直接看相位差。这个办法比看串口数字可信,因为串口打印本身有延迟。代码就一行:

/* 在 PTP_RxCallback 处理完 Sync 后调用 */ GPIOB->ODR ^= GPIO_PIN_0; /* PB0 输出秒脉冲 */

示波器上两路方波的上升沿差值就是实际同步偏差。我实测在直连、-O2、1 秒 Sync 间隔下,峰峰值抖动在 5~15 微秒,均值能压到 3 微秒以内。这个数字对工业分布式采集够用,对需要亚微秒的场合就不够了——那是硬件时间戳的活,软件方案到头了。

5. 避坑与排查:五个让同步精度翻车的真实记录

5.1 现象:offset 一直为正且越来越大,从钟越走越慢

原因:TIM2 的 PSC 配错,实际不是 1MHz。比如 APB1 定时器时钟在 72MHz 主频下是 72MHz(APB1 预分频不为 1 时定时器时钟翻倍),有人按 36MHz 算 PSC,结果时间戳单位变成 2 微秒,所有差值翻倍。解决:用示波器或另一个已知准确的定时器校准 TIM2,确认 1 秒内计数正好 1000000,再往下调。

5.2 现象:收几十秒后 PTP 报文停止,ping 还通

原因:DMA 接收描述符没归还,OWN 位一直握在 CPU 手里,DMA 收满链后不再触发中断。常见于ETH_ReadFrame里异常分支提前 return,漏了ETH_ReleaseFrame。解决:把释放动作放到统一出口,或者用 goto cleanup 保证任何路径都归还;调试时在释放函数里加计数器,和接收计数对比,对不上就是漏了。

5.3 现象:offset 偶尔跳出一个巨大的负值,伺服被带偏

原因:Delay_Resp 和 Delay_Req 配对错,或者 t3 时间戳取的是「构造报文前」而不是「报文发出瞬间」。F107 没有发送时间戳硬件,只能在发送完成中断里读,如果代码在ETH_Transmit调用前就读 t3,等于把 MAC 排队时间算进去了。解决:t3 必须在发送完成中断里读,且用报文序列号(sequenceId)严格配对,配不上就丢弃该样本。

5.4 现象:两块板子都配成从钟,谁也不发 Sync,一直 LISTEN

原因:角色宏改了一边忘了另一边,或者 Announce 报文被 MAC 过滤器挡了。F107 的 MAC 过滤器默认可能只收广播和本机单播,PTP 的 Announce 如果是组播地址 01-1B-19-00-00-00,要在过滤器里显式放行。解决:检查ETH_MAC_Init里的组播过滤表,把 1588 的组播地址加进去;调试时临时把 MAC 设成混杂模式,能收到就说明是过滤问题。

5.5 现象:编译通过但运行 HardFault,栈溢出

原因:lwIP 的tcpip_thread栈和主栈抢空间,F107 只有 64KB SRAM,DMA 描述符、pbuf 池、PTP 缓冲区加起来很容易超。解决:链接脚本里把栈调到 2KB 以上,pbuf 池按实际报文数配(PTP 报文小,PBUF_POOL_SIZE 给 8 就够),DMA 描述符数量从默认 4 降到 3 省内存;用arm-none-eabi-size看 .bss 和 .data 占用,留出至少 8KB 余量。

6. 二次开发:换 PHY、加硬件时间戳、接 GPS 驯服的改造路径

拿到这套代码想往下走,三个方向最实际。第一是换 PHY,比如从 LAN8720 换到 DP83848,改动集中在lan8720.c的寄存器地址和自协商流程,MAC 层和 PTP 层不用动,因为时间戳打点在 MAC 中断里,和 PHY 型号无关。第二是加硬件时间戳,如果换到带 PTP 时间戳单元的 STM32 型号(MAC 里有 TSSR 寄存器),把ETH_IRQHandler里读 TIM2 的那行换成读 MAC 时间戳快照寄存器,精度能从微秒级跳到百纳秒级,伺服层的系数要重新标,因为噪声特性完全变了。第三是接 GPS 驯服,把主钟的 TIM2 用 GPS 的 PPS 做长期校准,消除晶振温漂,这样主钟本身就是一个可信时间源,从钟跟着走就行。

改造时我建议先做一件事:把 offset 和 delay 序列通过串口按 CSV 格式打出来,存成文件,用脚本画曲线。调伺服参数时,光看实时数字根本判断不了是过冲还是欠阻尼,曲线一画,P 和 I 的系数该往哪调一目了然。验证方法也简单:改完参数跑 30 分钟,看 offset 的均值和峰峰值,均值接近 0、峰峰值稳定不增长,就算收敛;如果峰峰值随时间缓慢变大,说明频率环没锁住,回去查积分项限幅。

有个习惯我后来一直保持:每次改完时间戳打点位置或者中断优先级,都强制用示波器看一遍秒脉冲相位差,不看串口数字。因为串口打印的 offset 是算出来的,而示波器看到的是物理世界的时间差,两者对不上,一定是代码里有环节在骗自己。从那以后我每次动 PTP 相关的中断或定时器配置,都先跑一遍双板示波器对测再往下写,省掉了很多「数字好看但实际不同步」的返工。希望帮到你。

本文还有配套的精品资源,点击获取

返回列表