DEENESPTFRRUARHIKOZHNL

类 ara::tsync::SynchronizedTimeBaseProvider

[SWS_TS_01100] Upstream: RS_TS_00030 原文尚未导入

class SynchronizedTimeBaseProvider final {...};

Class SynchronizedTimeBaseProvider is the access to the synchronized timebase referenced by the IntstanceSpecifier. It allows to get the current time_point, the rate deviation, the current status and the received user data

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Forwarding-Header#include "ara/tsync/tsync_fwd.h"
Scopenamespace ara::tsync

用户指南人工智能生成

用于时间提供者应用程序在总线上设置、校正和验证同步时间基准。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 29af5ad2e896 来源 未决问题(2)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

用于时间提供者应用程序在总线上设置、校正和验证同步时间基准。

仅移动类 ara::tsync::SynchronizedTimeBaseProvider 用于时间提供者应用程序注入、速率校正和验证同步时间基准 [SWS_TS_01101] [SWS_TS_01110]。更新既可触发即时总线传输,也可作为本地更新调度给下一个传输周期 [SWS_TS_01107] [SWS_TS_01108]。读取访问是线程安全的,而所有修改方法以及通知器注册均需要线程局部或同步调用 [SWS_TS_01109] [SWS_TS_01114]。

上下文

类 ara::tsync::SynchronizedTimeBaseProvider 为时间提供者应用程序提供对通过 ara::core::InstanceSpecifier 建模的同步时间基准的主动控制访问 [SWS_TS_01101]。在 AUTOSAR Adaptive 中,该实例充当提供方应用逻辑、本地 Time-Sync-Daemon 与相连通信总线之间的接口。应用程序通过该组件将新的时间值和用户特定有效负载注入系统,通过速率校正补偿漂移,并采集验证参数 [SWS_TS_01107] [SWS_TS_01110] [SWS_TS_01114]。

Kontext Anwendung Anwendung SynchronizedTimeBaseProvider SynchronizedTimeBaseProvider Anwendung->SynchronizedTimeBaseProvider SetTime / UpdateTime / GetCurrentTime TimeSyncDaemon TimeSyncDaemon SynchronizedTimeBaseProvider->TimeSyncDaemon Zeitaktualisierung ProviderTimeBaseValidationNotification ProviderTimeBaseValidationNotification SynchronizedTimeBaseProvider->ProviderTimeBaseValidationNotification Benachrichtigung TimeSyncDaemon->SynchronizedTimeBaseProvider Validierungsdaten Kommunikationsbus Kommunikationsbus TimeSyncDaemon->Kommunikationsbus Bussynchronisation

上下文图:SynchronizedTimeBaseProvider 在提供者应用程序、验证与总线传输之间的集成。来源:[SWS_TS_01101]、[SWS_TS_01107]、[SWS_TS_01114]

生命周期

实例化显式通过一个 ara::core::InstanceSpecifier 执行,该对象必须引用由 SynchronizedTimeBaseProviderInterface 定型的 PortPrototype [SWS_TS_01101]。构造函数被声明为异常安全且线程安全 [SWS_TS_01101]。该类的对象为互斥的仅移动对象:复制构造函数与复制赋值运算符被显式删除 [SWS_TS_01104] [SWS_TS_01105],而支持移动构造和移动赋值 [SWS_TS_01102] [SWS_TS_01103]。

在并发性方面适用严格的分离:对状态的纯读取操作(如 GetCurrentTime()、GetRateDeviation() 和 GetUserData())是线程安全的,可以并发执行 [SWS_TS_01109] [SWS_TS_01111] [SWS_TS_01113]。相反,所有修改操作、通知注册以及通过析构函数销毁对象的操作均不是线程安全的,需要在应用程序端进行同步 [SWS_TS_01106] [SWS_TS_01107] [SWS_TS_01114]。

使用路径

典型使用划分为验证反馈注册以及周期性或事件驱动的时间传输:

  • 注册验证:根据需要,提供者应用程序通过 RegisterTimeValidationNotification() 存放一个通知对象,以接收新记录的时间同步数据块 [SWS_TS_01114]。最多可有一个活动的通知接收器;重新注册会覆盖现有的注册 [SWS_TS_01114],而 UnregisterTimeValidationNotification() 则解除绑定 [SWS_TS_01115]。
  • 设置时间值:在需要立即分发时,应用程序调用 SetTime()。这会设置本地时间值并立即触发总线上的传输 [SWS_TS_01107]。若总线传输改为仅在下一个常规周期中进行,则使用 UpdateTime(),由此时钟最初仅在本地更新 [SWS_TS_01108]。
  • 校正与有效负载:通过 SetRateCorrection() 可通过校正因子调整本地时钟的漂移(小于 1.0 的值减慢时钟,大于 1.0 的值加快时钟)[SWS_TS_01110]。额外的用户特定时间基准数据可通过 SetUserData() 更新 [SWS_TS_01112]。
时间提供与通知流程应用SynchronizedTimeBaseProviderTimeSyncDaemonRegisterTimeValidationNotification(notifier)voidUse Case: Zeitaktualisierungalt即时总线传输SetTime(timePoint, userData)传输时间值并触发总线传输Result<void> (Erfolg)周期性传输UpdateTime(timePoint, userData)本地更新时钟(在下一周期发送)Result<void> (Erfolg)Use Case: ValidierungsereignisNeuer Datenblock aufgezeichnet通过 timeBaseValidationNotification 通知

时序图:通知器注册与时间更新的流程,包含替代的总线传输路径。来源:[SWS_TS_01107]、[SWS_TS_01108]、[SWS_TS_01114]

错误场景

返回值为 ara::core::Result<void> 的方法通过类型为 TsyncErrc 的错误代码指示失败,不具有回滚语义:

  • TsyncErrc::kInvalidUserDataSize:当传递的 UserData 超过 UserData::kMaxUserDataSize 的最大长度(当前为 3 字节)时,在 SetTime()、UpdateTime() 和 SetUserData() 中发生 [SWS_TS_01107] [SWS_TS_01108] [SWS_TS_01112]。
  • TsyncErrc::kDaemonConnectionLost:若调用时到 Time-Sync-Daemon 的 IPC 连接中断,则在 SetTime() 中发生 [SWS_TS_01107]。
  • TsyncErrc::kLimitsExceeded:当请求的速率校正因子超出允许的值范围时,由 SetRateCorrection() 返回 [SWS_TS_01110]。
  • TsyncErrc::kFunctionNotSupported:当底层平台或时间基准不支持速率校正时,由 SetRateCorrection() 报告 [SWS_TS_01110]。

本指南基于 AUTOSAR Adaptive Platform R25-11 规范(tsync 模块),并为 autodocs 编制。

成员图

类图

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__tsync__SynchronizedTimeBaseProvider954 SynchronizedTimeBaseProvider + SynchronizedTimeBaseProvider() + operator=() + ~SynchronizedTimeBaseProvider() + GetCurrentTime() + GetRateDeviation() + GetUserData() + RegisterTimeValidationNotification() + SetRateCorrection() + SetTime() + SetUserData() + UnregisterTimeValidationNotification() + UpdateTime()

详细视图

请在大纲中选择一个条目。

构造函数和析构函数

SynchronizedTimeBaseProvider constructor.

重载 SynchronizedTimeBaseProvider 3
explicit SynchronizedTimeBaseProvider (const ara::core::Instance Specifier &specifier) noexcept; SWS_TS_01101
SynchronizedTimeBaseProvider (SynchronizedTimeBaseProvider &&stbc) noexcept; SWS_TS_01102
SynchronizedTimeBaseProvider (const SynchronizedTimeBaseProvider &)=delete; SWS_TS_01104

Destructor for SynchronizedTimeBaseProvider.

方法

Method to obtain the current time (regardless of the current sync status).

ara::tsync::Timestamp GetCurrentTime () const noexcept;

Method to obtain the current rate deviation of the clock.

double GetRateDeviation () const noexcept;

A method to return the user defined data of the time base.

UserData GetUserData () const noexcept;

Method that can be used by time provider applications to receive time sync parameters. A maximum of one notifier can be registered. Every further registration overwrites the current registration.

void RegisterTimeValidationNotification (ProviderTimeBaseValidation Notification &timeBaseValidationNotification) noexcept;

This method can be used to set the rate correction that will be applied to time values.

ara::core::Result< void > SetRateCorrection (double rateCorrection) noexcept;
SetTime 函数

A method that can be used to set a new time value for the clock. Setting a new time also triggers transmission on the bus.

ara::core::Result< void > SetTime (ara::tsync::Timestamp timePoint, const UserData &userData) noexcept;

Method that can be used to set user data.

ara::core::Result< void > SetUserData (const UserData &userData) noexcept;

Method that can be used by time provider applications to receive time sync parameters.

void UnregisterTimeValidationNotification () noexcept;
UpdateTime 函数

A method that can be used to set a new time value for the clock. The clock value is only updated locally, transmission on the bus will happen in the next cycle.

ara::core::Result< void > UpdateTime (ara::tsync::Timestamp timePoint, const UserData &userData) noexcept;

运算符

operator= 函数 2

Move assignment operator for SynchronizedTimeBaseProvider.

重载 = 2
SynchronizedTimeBaseProvider & operator= (const SynchronizedTimeBase Provider &)=delete; SWS_TS_01105

方法文档

函数 GetCurrentTime [SWS_TS_01109] Upstream: RS_TS_00026 原文尚未导入, RS_TS_00005 原文尚未导入

ara::tsync::Timestamp GetCurrentTime () const noexcept;

Method to obtain the current time (regardless of the current sync status).

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::tsync::TimestampThe current time as clock specific time point.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01109
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01109@rel:R25-11#9a4c3657
Content hash
9a4c3657
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01109
Status: valid/unmigrated Version: rel:R25-11#e536c303 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01109@rel:R25-11#e536c303
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#d1ba831e2026-09-30
  • R20-11rel:R20-11#94ccbc272026-10-14
  • R21-11rel:R21-11#783be03b2026-10-14
  • R22-11rel:R22-11#6f8525752026-10-14
  • R23-11rel:R23-11#8db206c62026-10-14
  • R24-11rel:R24-11#e536c3032026-10-14
  • R25-11rel:R25-11#e536c3032026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 GetRateDeviation [SWS_TS_01111] Upstream: RS_TS_00018 原文尚未导入

double GetRateDeviation () const noexcept;

Method to obtain the current rate deviation of the clock.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
doubleThe current rate deviation.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01111
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01111@rel:R25-11#59ddd2de
Content hash
59ddd2de
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01111
Status: valid/unmigrated Version: rel:R25-11#0bfa82ee Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01111@rel:R25-11#0bfa82ee
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#db156b212026-09-30
  • R20-11rel:R20-11#5f3215b52026-10-14
  • R21-11rel:R21-11#74e7a9a92026-10-14
  • R22-11rel:R22-11#f8bfd2e22026-10-14
  • R23-11rel:R23-11#653c6ada2026-10-14
  • R24-11rel:R24-11#0bfa82ee2026-10-14
  • R25-11rel:R25-11#0bfa82ee2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 GetUserData [SWS_TS_01113] Upstream: RS_TS_00021 原文尚未导入, RS_TS_00014 原文尚未导入

UserData GetUserData () const noexcept;

A method to return the user defined data of the time base.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
UserDataThe current user data of the Time Base.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01113
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01113@rel:R25-11#e2761b1b
Content hash
e2761b1b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01113
Status: valid/unmigrated Version: rel:R25-11#66040507 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01113@rel:R25-11#66040507
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#7aa1ba2f2026-09-30
  • R20-11rel:R20-11#9110470c2026-10-14
  • R21-11rel:R21-11#9110470c2026-10-14
  • R22-11rel:R22-11#9709ff892026-10-14
  • R23-11rel:R23-11#40998e0a2026-10-14
  • R24-11rel:R24-11#660405072026-10-14
  • R25-11rel:R25-11#660405072026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 RegisterTimeValidationNotification [SWS_TS_01114] Upstream: RS_TS_00034 原文尚未导入, RS_TS_00030 原文尚未导入

void RegisterTimeValidationNotification (ProviderTimeBaseValidation Notification &timeBaseValidationNotification) noexcept;

Method that can be used by time provider applications to receive time sync parameters. A maximum of one notifier can be registered. Every further registration overwrites the current registration.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 89b44278d606 来源
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

方法 RegisterTimeValidationNotification 是类 ara::tsync::SynchronizedTimeBaseProvider 的组成部分,并通过头文件 #include "ara/tsync/synchronized_time_base_provider.h" 包含 [SWS_TS_01114]。它用于时间提供者应用程序接收时间同步参数 [SWS_TS_01114]。通过参数 timeBaseValidationNotification 传递对类型为 ProviderTimeBaseValidationNotification 的通知对象的引用,一旦该时间基准有新的数据块就绪,该对象就会收到通知 [SWS_TS_01114]。该方法不提供返回值(void)[SWS_TS_01114]。

错误处理

该方法声明为 noexcept 并具有属性 exception safe [SWS_TS_01114]。它不抛出异常,也不返回错误码 [SWS_TS_01114]。

并发性与限制

使用时必须注意以下限制:

  • 注册限制:最多只能注册一个 Notifier;任何后续注册都会覆盖当前注册 [SWS_TS_01114]。
  • 线程安全性:该函数被指定为 non_threadsafe [SWS_TS_01114]。在并行访问时,对同一实例的调用必须由应用端进行同步。

相互作用

虽然该函数在时间提供者(Provider)端实现了注册 [SWS_TS_01114],但类 ara::tsync::SynchronizedTimeBaseConsumer 及其 RegisterTimeValidationNotification 和类型 ConsumerTimeBaseValidationNotification 代表了面向时间消费者(Consumer)的功能对应项 [SWS_TS_01016]。

本使用说明是基于 AUTOSAR 规范自动生成的。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
timeBaseValidationNotificationtime provider application notification object that will be notified about the availability of a new data block recorded for the Time Base

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01114
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01114@rel:R25-11#a9f66ef0
Content hash
a9f66ef0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01114
Status: valid/unmigrated Version: rel:R25-11#5b0c66e7 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01114@rel:R25-11#5b0c66e7
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#43de0cea2026-09-30
  • R20-11rel:R20-11#3753493e2026-10-14
  • R21-11rel:R21-11#87d3b5002026-10-14
  • R22-11rel:R22-11#c5387b082026-10-14
  • R23-11rel:R23-11#e5b34ad22026-10-14
  • R24-11rel:R24-11#5b0c66e72026-10-14
  • R25-11rel:R25-11#5b0c66e72026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 SetRateCorrection [SWS_TS_01110] Upstream: RS_TS_00029 原文尚未导入, RS_TS_00026 原文尚未导入, RS_TS_00018 原文尚未导入

ara::core::Result< void > SetRateCorrection (double rateCorrection) noexcept;

This method can be used to set the rate correction that will be applied to time values.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
rateCorrectionRate correction factor applied to the local clock value. A factor smaller than 1.0 slows down the local clock by that factor, a value greater than 1.0 speeds up the clock.

Rückgabewert

TypBeschreibung
ara::core::Result< void >-

Fehler

FehlercodeBeschreibung
TsyncErrc::kLimitsExceededno_rollback_semantics The value exceeds valid value range
TsyncErrc::kFunctionNotSupportedno_rollback_semantics The requested function is not supported

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01110
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01110@rel:R25-11#b1ee766d
Content hash
b1ee766d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01110
Status: valid/unmigrated Version: rel:R25-11#25dd7f54 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01110@rel:R25-11#25dd7f54
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#5bca40712026-09-30
  • R20-11rel:R20-11#439c1a362026-10-14
  • R21-11rel:R21-11#439c1a362026-10-14
  • R22-11rel:R22-11#fd3129132026-10-14
  • R23-11rel:R23-11#7279969d2026-10-14
  • R24-11rel:R24-11#46ceacc72026-10-14
  • R25-11rel:R25-11#25dd7f542026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 SetTime [SWS_TS_01107] Upstream: RS_TS_00010 原文尚未导入, RS_TS_00026 原文尚未导入

ara::core::Result< void > SetTime (ara::tsync::Timestamp timePoint, const UserData &userData) noexcept;

A method that can be used to set a new time value for the clock. Setting a new time also triggers transmission on the bus.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
timePointThe time information to be set.
userDataThe user data to be set.

Rückgabewert

TypBeschreibung
ara::core::Result< void >-

Fehler

FehlercodeBeschreibung
TsyncErrc::kInvalidUserDataSizeno_rollback_semantics The length of the user data exceeded the maximum allowed size, defined by UserData::kMaxUserDataSize (currently 3 bytes).
TsyncErrc::kDaemonConnectionLostno_rollback_semantics The action cannot be executed, because the connection to time sync daemon is currently lost.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01107
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01107@rel:R25-11#dff50133
Content hash
dff50133
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01107
Status: valid/unmigrated Version: rel:R25-11#89b07835 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01107@rel:R25-11#89b07835
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#a692af212026-09-30
  • R20-11rel:R20-11#f42eeb692026-10-14
  • R21-11rel:R21-11#c223935e2026-10-14
  • R22-11rel:R22-11#a92b79242026-10-14
  • R23-11rel:R23-11#cad045a82026-10-14
  • R24-11rel:R24-11#ad0b748c2026-10-14
  • R25-11rel:R25-11#89b078352026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 SetUserData [SWS_TS_01112] Upstream: RS_TS_00029 原文尚未导入, RS_TS_00026 原文尚未导入, RS_TS_00015 原文尚未导入

ara::core::Result< void > SetUserData (const UserData &userData) noexcept;

Method that can be used to set user data.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
userDataThe user data to be set.

Rückgabewert

TypBeschreibung
ara::core::Result< void >-

Fehler

FehlercodeBeschreibung
TsyncErrc::kInvalidUserDataSizeno_rollback_semantics The length of the user data exceeded the maximum allowed size, defined by UserData::kMaxUserDataSize (currently 3 bytes).

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01112
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01112@rel:R25-11#2da71010
Content hash
2da71010
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01112
Status: valid/unmigrated Version: rel:R25-11#2ff2b4dd Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01112@rel:R25-11#2ff2b4dd
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#30e077782026-09-30
  • R20-11rel:R20-11#9370f9812026-10-14
  • R21-11rel:R21-11#9370f9812026-10-14
  • R22-11rel:R22-11#73d4f8122026-10-14
  • R23-11rel:R23-11#bca80c8f2026-10-14
  • R24-11rel:R24-11#1af4259c2026-10-14
  • R25-11rel:R25-11#2ff2b4dd2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 SynchronizedTimeBaseProvider [SWS_TS_01101] Upstream: RS_TS_00005 原文尚未导入, RS_AP_00171, RS_AP_00172

explicit SynchronizedTimeBaseProvider (const ara::core::Instance Specifier &specifier) noexcept;

SynchronizedTimeBaseProvider constructor.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)PortInterfaceMap- A PortPrototype that is referenced by a pingViolation TimeSyncPortPrototypeToTimeBaseMapping needs to be typed by a SynchronizedTimeBaseProviderInterface.

Parameter (in)

ParameterBeschreibung
specifierInstanceSpecifier to an PortPrototype of a PortPrototype typed by a SynchronizedTimeBaseProviderInterface

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01101
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01101@rel:R25-11#d3d350ab
Content hash
d3d350ab
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01101
Status: valid/unmigrated Version: rel:R25-11#8264f9ed Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01101@rel:R25-11#8264f9ed
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#a6669f8b2026-09-30
  • R20-11rel:R20-11#897cd3202026-10-14
  • R21-11rel:R21-11#93f9733a2026-10-14
  • R22-11rel:R22-11#5dc9102a2026-10-14
  • R23-11rel:R23-11#de89ffd02026-10-14
  • R24-11rel:R24-11#8264f9ed2026-10-14
  • R25-11rel:R25-11#8264f9ed2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 SynchronizedTimeBaseProvider [SWS_TS_01102] Upstream: RS_TS_00005 原文尚未导入

SynchronizedTimeBaseProvider (SynchronizedTimeBaseProvider &&stbc) noexcept;

Move constructor for SynchronizedTimeBaseProvider.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
stbcThe SynchronizedTimeBaseProvider object to be moved.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01102
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01102@rel:R25-11#a5ee3518
Content hash
a5ee3518
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01102
Status: valid/unmigrated Version: rel:R25-11#5ccdf1e4 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01102@rel:R25-11#5ccdf1e4
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#cdeebd802026-09-30
  • R20-11rel:R20-11#5f6dc9f02026-10-14
  • R21-11rel:R21-11#5f6dc9f02026-10-14
  • R22-11rel:R22-11#549d5b802026-10-14
  • R23-11rel:R23-11#c3c5508d2026-10-14
  • R24-11rel:R24-11#5ccdf1e42026-10-14
  • R25-11rel:R25-11#5ccdf1e42026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 SynchronizedTimeBaseProvider [SWS_TS_01104] Upstream: RS_TS_00005 原文尚未导入

SynchronizedTimeBaseProvider (const SynchronizedTimeBaseProvider &)=delete;

The copy constructor for SynchronizedTimeBaseProvider shall not be used.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01104
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01104@rel:R25-11#d8ce2833
Content hash
d8ce2833
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01104
Status: valid/unmigrated Version: rel:R25-11#78d0d11f Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01104@rel:R25-11#78d0d11f
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#e81093912026-09-30
  • R20-11rel:R20-11#5de31eee2026-10-14
  • R21-11rel:R21-11#1c6424382026-10-14
  • R22-11rel:R22-11#5f747d002026-10-14
  • R23-11rel:R23-11#a0b2c2c32026-10-14
  • R24-11rel:R24-11#78d0d11f2026-10-14
  • R25-11rel:R25-11#78d0d11f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 UnregisterTimeValidationNotification [SWS_TS_01115] Upstream: RS_TS_00034 原文尚未导入, RS_TS_00030 原文尚未导入

void UnregisterTimeValidationNotification () noexcept;

Method that can be used by time provider applications to receive time sync parameters.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 4be2caa7a1a0 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

类 ara::tsync::SynchronizedTimeBaseProvider 的方法 UnregisterTimeValidationNotification 通过头文件 ara/tsync/synchronized_time_base_provider.h 提供 [SWS_TS_01115]。它用于时间同步上下文中的时间提供者应用程序(Time Provider Applications)以及接收时间同步参数 [SWS_TS_01115];根据标识符推测,其用途应当是注销先前注册的时间校验通知。 问题 Q-49ba26b4b16dd5c7 (未决)

关于调用上下文和语义,适用以下规定:

  • 签名与返回:该函数不接收参数,且没有返回值(void)[SWS_TS_01115]。
  • 错误处理:该操作声明为 noexcept 并指定为异常安全(exception safe)[SWS_TS_01115]。该接口未规定错误码或向 DET 或 DEM 发送通知。
  • 并发性:该函数显式归类为 non_threadsafe [SWS_TS_01115]。因此,对 SynchronizedTimeBaseProvider 的同一实例的并行调用必须由调用方进行同步。

在时间同步架构的交互中,对于时间接收者(Time Consumer Applications),在类 ara::tsync::SynchronizedTimeBaseConsumer(定义于 ara/tsync/synchronized_time_base_consumer.h 中)中存在一个直接对应项,该对应项在线程安全性和异常安全性方面具有相同属性 [SWS_TS_01017]。

该使用说明系自动生成,并完全基于 R25-11 规范。

实现者指南即将推出(复杂度 I1)

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01115
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01115@rel:R25-11#10359a4d
Content hash
10359a4d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01115
Status: valid/unmigrated Version: rel:R25-11#0fcedc91 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01115@rel:R25-11#0fcedc91
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#6eb400f72026-09-30
  • R20-11rel:R20-11#4096e3f92026-10-14
  • R21-11rel:R21-11#4096e3f92026-10-14
  • R22-11rel:R22-11#1c4d64e72026-10-14
  • R23-11rel:R23-11#a284fe002026-10-14
  • R24-11rel:R24-11#10a03cb02026-10-14
  • R25-11rel:R25-11#0fcedc912026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 UpdateTime [SWS_TS_01108] Upstream: RS_TS_00010 原文尚未导入, RS_TS_00011 原文尚未导入, RS_TS_00029 原文尚未导入, RS_TS_00026 原文尚未导入, RS_TS_00009 原文尚未导入

ara::core::Result< void > UpdateTime (ara::tsync::Timestamp timePoint, const UserData &userData) noexcept;

A method that can be used to set a new time value for the clock. The clock value is only updated locally, transmission on the bus will happen in the next cycle.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: a90a9a9d69ee 来源
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

来自头文件 ara/tsync/synchronized_time_base_provider.h 的方法 UpdateTime 属于类 ara::tsync::SynchronizedTimeBaseProvider [SWS_TS_01108]。它用于为时钟指定新的时间值。该方法接收带有模板参数 Duration 的待设置时间点 timePoint 以及用户自定义应用数据 userData [SWS_TS_01108]。此时,时钟值在本地立即更新;而通过总线的传输则在随后的周期中才进行 [SWS_TS_01108]。

错误处理

该调用声明为 noexcept 并返回 ara::core::Result<void> [SWS_TS_01108]。如果传入的 userData 的长度超过当前由 UserData::kMaxUserDataSize 限制为 3 字节的最大允许大小,则操作失败 [SWS_TS_01108]。在此情况下,Result 对象提供错误码 TsyncErrc::kInvalidUserDataSize,并且针对错误情况未规定回滚语义(no_rollback_semantics)[SWS_TS_01108]。

并发性与限制

对于集成需要注意的是,UpdateTime 被指定为非线程安全(non_threadsafe)[SWS_TS_01108]。如果在并发执行上下文中利用 SynchronizedTimeBaseProvider 的实例,调用代码必须确保适当的同步。然而,该函数保证异常安全性(exception safe)[SWS_TS_01108]。

该文本由人工智能基于规范生成。

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Template-Parameter

ParameterBeschreibung
DurationThe duration type of the time point passed as parameter.

Parameter (in)

ParameterBeschreibung
timePointThe time information to be set.
userDataThe user data to be set.

Rückgabewert

TypBeschreibung
ara::core::Result< void >-

Fehler

FehlercodeBeschreibung
TsyncErrc::kInvalidUserDataSizeno_rollback_semantics The length of the user data exceeded the maximum allowed size, defined by UserData::kMaxUserDataSize (currently 3 bytes).

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01108
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01108@rel:R25-11#416a96f0
Content hash
416a96f0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01108
Status: valid/unmigrated Version: rel:R25-11#3e214e85 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01108@rel:R25-11#3e214e85
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#7a8c2c262026-09-30
  • R20-11rel:R20-11#1fc2a3642026-10-14
  • R21-11rel:R21-11#1fc2a3642026-10-14
  • R22-11rel:R22-11#00df04242026-10-14
  • R23-11rel:R23-11#23e34e062026-10-14
  • R24-11rel:R24-11#fe1c31432026-10-14
  • R25-11rel:R25-11#3e214e852026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 operator= [SWS_TS_01103] Upstream: RS_TS_00005 原文尚未导入

SynchronizedTimeBaseProvider & operator= (SynchronizedTimeBaseProvider &&stbc) & noexcept;

Move assignment operator for SynchronizedTimeBaseProvider.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Parameter (in)

ParameterBeschreibung
stbcThe SynchronizedTimeBaseProvider object to be moved.

Rückgabewert

TypBeschreibung
SynchronizedTimeBaseProvider &The moved SynchronizedTimeBaseProvider object.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01103
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01103@rel:R25-11#8c259f34
Content hash
8c259f34
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01103
Status: valid/unmigrated Version: rel:R25-11#3f83c7f0 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01103@rel:R25-11#3f83c7f0
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#f3b6eee22026-09-30
  • R20-11rel:R20-11#18afdf662026-10-14
  • R21-11rel:R21-11#18afdf662026-10-14
  • R22-11rel:R22-11#9f313dae2026-10-14
  • R23-11rel:R23-11#2e7c31dc2026-10-14
  • R24-11rel:R24-11#3f83c7f02026-10-14
  • R25-11rel:R25-11#3f83c7f02026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 operator= [SWS_TS_01105] Upstream: RS_TS_00005 原文尚未导入

SynchronizedTimeBaseProvider & operator= (const SynchronizedTimeBase Provider &)=delete;

The copy assignment operator for SynchronizedTimeBaseProvider shall not be used.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01105
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01105@rel:R25-11#16926466
Content hash
16926466
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01105
Status: valid/unmigrated Version: rel:R25-11#70f8fb4a Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01105@rel:R25-11#70f8fb4a
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#3f14e13b2026-09-30
  • R20-11rel:R20-11#b91c21862026-10-14
  • R21-11rel:R21-11#b91c21862026-10-14
  • R22-11rel:R22-11#84adf2a22026-10-14
  • R23-11rel:R23-11#ed4c3bf52026-10-14
  • R24-11rel:R24-11#70f8fb4a2026-10-14
  • R25-11rel:R25-11#70f8fb4a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

函数 ~SynchronizedTimeBaseProvider [SWS_TS_01106] Upstream: RS_TS_00005 原文尚未导入

~SynchronizedTimeBaseProvider () noexcept;

Destructor for SynchronizedTimeBaseProvider.

Header-Datei#include "ara/tsync/synchronized_time_base_provider.h"
Scopeclass ara::tsync::SynchronizedTimeBaseProvider
Exception-Sicherheitexception safe
Thread-Sicherheitnon_threadsafe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_TS_01106
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_TS_01106@rel:R25-11#7cb84b33
Content hash
7cb84b33
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_TimeSynchronization.pdf#nameddest=SWS_TS_01106
Status: valid/unmigrated Version: rel:R25-11#b1bfdc0e Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_TS_01106@rel:R25-11#b1bfdc0e
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#aabe16672026-09-30
  • R20-11rel:R20-11#86ef63302026-10-14
  • R21-11rel:R21-11#86ef63302026-10-14
  • R22-11rel:R22-11#868b1d042026-10-14
  • R23-11rel:R23-11#43500dab2026-10-14
  • R24-11rel:R24-11#b1bfdc0e2026-10-14
  • R25-11rel:R25-11#b1bfdc0e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill