结构体 ara::tsync::TimeMasterMeasurementType

该数据结构用于整合详细的测量数据，以对 Time Master 进行测量技术验证与运行时监控。对于发送的每个同步帧，它通过 preciseOriginTimestamp [SWS_TS_14140] 汇聚全局时基中的发送时刻、网络相关发送时间戳 syncEgressTimestamp 以及 Ethernet 帧标识 sequenceId [SWS_TS_14142]。这些聚合的测量值使下游分析实例能够对抖动和数据包序列进行完整的合理性检查。由于该类型被声明为无自身同步的 final 数据容器，因此并发交换可能需要调用方采取额外的保护措施。 问题 (未决)

更多 ›

上下文

结构体 ara::tsync::TimeMasterMeasurementType 是 AUTOSAR Adaptive Platform 的 tsync 模块中时间验证（Time Validation）的组成部分。根据规范，它汇聚了用于验证 Time Master 的详细测量数据。在分布式系统中，Time Master 为相连的网络节点提供时间参考。为了确保符合要求的同步精度并在运行期间检测时间偏差，测量技术特征数据将直接在 Time Master 的接口处进行采集。

该类型的定义存放在头文件 ara/tsync/time_validation_measurement_types.h 中 [SWS_TS_14140]。作为核心数据传输对象，该结构体汇集了通过 Ethernet 发送同步消息（Sync-Frame）时产生的三个基本测量量：

• preciseOriginTimestamp：Sync-Frame 相对于全局时基的发送时刻（Egress Timestamp），格式为 ara::tsync::Timestamp [SWS_TS_14140]。
• syncEgressTimestamp：Sync-Frame 接近网络的发送时刻，表示为 64 位整数（std::uint64_t）[SWS_TS_14141]。
• sequenceId：所发送 Ethernet 帧的序列标识，表示为 16 位值（std::uint16_t）[SWS_TS_14142]。

因此，该结构体充当了 Time Master 实际同步服务与下游监控或验证组件之间的标准化接口。

生命周期

其声明为 struct TimeMasterMeasurementType final，将该类标识为具有纯值语义的 final 数据结构。由于它不管理动态资源且没有继承层次结构，因此其实例化非常轻量。通常，在 Time Master 发送 Sync-Frame 后，一旦获得物理发送时间戳和序列号，就会立即创建一个实例。

实例的生命周期与评估周期紧密绑定。数据可以通过复制或 move 操作传递给消费端验证实例，并在合理性检查完成后丢弃。 问题 Q-c09487031c2b5638 (未决)该结构体不包含任何内部同步机制（如互斥锁）。如果实例在并发软件架构中跨线程边界交换，线程安全访问的责任可能完全由调用方承担。

使用路径

典型的使用流程包括在帧发送时确定测量值、封装在结构体中以及转发以进行验证：

1. 发送 Sync-Frame：Time Master 通过 Ethernet 网络发送同步帧，其中帧标识记录在 sequenceId 中 [SWS_TS_14142]。
2. 测量值采集：接近硬件或驱动程序的 Egress 时刻被采集为 syncEgressTimestamp [SWS_TS_14141]。同时确定对应的全局时间值并保存为 preciseOriginTimestamp [SWS_TS_14140]。
3. 填充结构体：采集到的值被聚合在 TimeMasterMeasurementType 的实例中。
4. 评估：该结构体被传递给验证子系统，后者根据序列号检测数据包丢失，并通过比对时间戳计算抖动或发送漂移。

时序图：TimeMasterMeasurementType 采集与转发的典型流程。来源：[SWS_TS_14140]、[SWS_TS_14141]、[SWS_TS_14142]。

解读：通过共同采集本地 Egress 时间戳 [SWS_TS_14141] 和全局参考时间 [SWS_TS_14140]，验证逻辑能够确定 Time Master 协议栈中是否发生了处理延迟。 问题 Q-7454a019d8b9e764 (未决)