IEEE 802.1AS-2011 第九章 应用接口(API)

本文翻译自IEEE Standard for Local and metropolitan area networks—Timing and Synchronization for Time-Sensitive Applications in Bridged Local Area Networks

9. 应用接口

9.1 接口总览

以下子条款定义了ClockSource实体和ClockMaster实体（见10.1.1）之间的一个应用程序接口，以及ClockTarget实体和ClockSlave实体之间的四个应用程序接口（见10.1.1）。 ClockSource是一个可以用作gPTP域的外部定时源的实体。 ClockSource实体包含或可以访问时钟（见3.3）。 ClockTarget实体表示使用ClockSlave实体通过任何应用程序接口提供的信息的任何应用程序。
注 - ClockSource实体获取时间的方式超出了本标准的范围。 ClockTarget使用应用程序接口提供的信息的方式超出了本标准的范围。
五个接口如图9-1所示。它们包括以下内容：
a) ClockSourceTime接口，为时间感知系统提供外部定时，
b) ClockTargetEventCapture接口，它返回由ClockTarget实体发出的捕捉事件信号的同步时间，
c) ClockTargetTriggerGenerate接口，它返回事件在ClockTarget实体指定发出信号时的同步时间，
d) ClockTargetClockGenerator接口，它导致生成周期性结果序列，其中相位和速率由ClockTarget实体指定，并且
e) ClockTargetPhaseDiscontinuity接口，它提供应用程序可用于确定是否发生了特级大师相位或频率不连续的信息。
注 - 本节中描述的应用程序接口是行为模型，而不是应用程序接口。除了上述a）到e）项之外的其他应用程序接口也是可能的，但这里不再描述。此外，可以有特定接口的多个实例。

9.2 ClockSourceTime

9.2.1 概述

ClockSource实体使用此接口为时间感知系统的ClockMaster实体提供时间。 ClockSource实体调用ClockSourceTime.invoke函数来提供，相对于ClockSource来说，调用此函数的时间。

9.2.2 ClockSourceTime.invoke函数参数

ClockSourceTime.invoke {
	sourceTime,
	timeBaseIndicator,
	lastGmPhaseChange,
	lastGmFreqChange
}

参数定义如下：

9.2.2.1 sourceTime(ExtendedTimestamp)

sourceTime的值是ClockSource实体调用此函数的时间。