LIN Transceiver Driver (LinTrcv)

LIN Transceiver Driver控制通道的物理LIN收发器，并将LinIf与硬件解耦。根据LinTrcv_Init，初始模式为SLEEP。LinTrcv_SetOpMode在NORMAL、STANDBY和SLEEP之间切换，并在切换失败时返回E_NOT_OK [SWS_LinTrcv_00002]。外部唤醒通过ICU进行检测，并在LinIf调用LinTrcv_CheckWakeup时进行报告。在R20-11中，E_OK在此表示“检测到唤醒”[SWS_LinTrcv_00012]。状态切换的等待时间应使用Tm_BusyWait1us16bit实现。

更多 ›

LIN Transceiver Driver控制通道的物理LIN收发器，并将LIN接口与硬件解耦。LinIf直接调用其服务：例如LinIf_SetTrcvMode调用LinTrcv_SetOpMode并不加修改地返回其结果[SWS_LinTrcv_00002] LinIf-SWS 第90页。软件状态和硬件状态是分离的。软件模式覆盖哪些硬件状态由实现决定LinTrcv-SWS 第16页。

驱动程序支持模式LINTRCV_TRCV_MODE_NORMAL、LINTRCV_TRCV_MODE_STANDBY和LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]。上电后，它处于未激活状态。LinTrcv_Init使用配置集[SWS_LinTrcv_00001]将其激活，初始模式为SLEEP LinTrcv-SWS 第1页。STANDBY是可选的，可以是一个纯内部状态LinTrcv-SWS 图 7.1 第15页。

状态图：从上电经过LinTrcv_Init直至使用LinTrcv_SetOpMode进行模式切换的生命周期。可选转换经过重建（解释）。来源：LinTrcv-SWS 图 7.1 第15页 [SWS_LinTrcv_00168]

驱动程序不通过自身的ISR检测外部唤醒，而是通过ICU检测LinTrcv-SWS 第17页。LinIf使用LinTrcv_CheckWakeup对其进行查询。在R20-11中，E_OK在此表示“检测到唤醒”[SWS_LinTrcv_00012]。后续版本对此有不同的定义。检测到的唤醒通过LinIf_WakeupConfirmation报告[SWS_LinTrcv_91002]。LinTrcv_SetWakeupMode启用、禁用通知或清除已存储的事件[SWS_LinTrcv_00169]。

时序图：从ICU检测经过LinTrcv_CheckWakeup和LinIf_WakeupConfirmation直至查询原因的外部唤醒。来源：[SWS_LinTrcv_00012] [SWS_LinTrcv_91002] LinTrcv-SWS 第17页

运行适用以下边界条件：

• 状态切换时的等待时间应使用Tm_BusyWait1us16bit实现[SWS_LinTrcv_00171]。
• 在多核系统上，通道的LinTrcvChannel和LinChannel必须引用相同的分区[SWS_LinTrcv_00177]。
• 与收发器的通信发生故障时，查询返回E_NOT_OK LinTrcv-SWS 第26页。

DET错误码仅在后续版本中得到证实。由于R21-11清理了错误码，它们的名称在R20-11中可能会有所不同LinTrcv-SWS 第1页。

更多 ›

在LIN接口与收发器芯片之间的角色

LIN Transceiver Driver（LinTrcv）封装了物理LIN收发器的控制。其接口由七个服务组成：

• 使用LinTrcv_Init进行初始化[SWS_LinTrcv_00001]
• 使用LinTrcv_SetOpMode进行模式切换[SWS_LinTrcv_00002]
• 使用 LinTrcv_GetOpMode 查询模式 [SWS_LinTrcv_00005]
• 使用 LinTrcv_GetBusWuReason 查询唤醒原因 [SWS_LinTrcv_00007]
• 使用 LinTrcv_SetWakeupMode 控制唤醒通知 [SWS_LinTrcv_00009]
• 使用 LinTrcv_CheckWakeup 进行唤醒检查 [SWS_LinTrcv_00012]
• 使用 LinTrcv_GetVersionInfo 进行版本查询 [SWS_LinTrcv_00008]

所有服务均为同步服务。驱动程序的软件状态与器件的硬件状态相互独立。器件支持的状态转换可以多于驱动程序。软件状态具体涵盖哪些硬件状态由实现决定。但实现必须完整提供所描述的功能 LinTrcv-SWS 第16页。

在向上方向，LIN 接口（LinIf）是有效负载中占用的用户。各 LinIf 服务分别调用一个 LinTrcv 服务：

• LinIf_SetTrcvMode 调用 LinTrcv_SetOpMode 并原样返回其返回值 LinIf-SWS 第90页。
• LinIf_GetTrcvMode 调用 LinTrcv_GetOpMode LinIf-SWS 第91页。
• LinIf_GetTrcvWakeupReason 调用 LinTrcv_GetBusWuReason LinIf-SWS 第92页。
• LinIf_SetTrcvWakeupMode 调用 LinTrcv_SetWakeupMode LinIf-SWS 第93页。

类型 LinTrcv_TrcvModeType 和 LinTrcv_TrcvWakeupModeType 可通过 Lin_GeneralTypes.h 获取 [SWS_LinTrcv_00168] [SWS_LinTrcv_00169]。LinIf 在其签名中直接使用它们。原有的专有类型 LinIf_TrcvModeType 在版本 3.1.5 中被 LinTrcv_TrcvModeType 取代 LinIf-SWS 第4页。

在向下方向，驱动程序使用以下服务：

• Dio、Det_ReportError 和 EcuM_SetWakeupEvent 的读写服务 [SWS_LinTrcv_91003]
• 来自 Dio、Spi、Icu 和 EcuM 的类型 [SWS_LinTrcv_91001]
• 用于唤醒通知的 Icu_EnableNotification 和 Icu_DisableNotification LinTrcv-SWS 第17页
• 用于状态切换期间等待时间的时间服务 Tm_BusyWait1us16bit [SWS_LinTrcv_00171]

驱动程序通过 LinIf_WakeupConfirmation 向 LinIf 报告检测到的唤醒 [SWS_LinTrcv_91002]。LinIf 随后设置受影响通道的唤醒标志 LinIf-SWS 第98页。

上下文图：LinTrcv 位于 LinIf 与底层硬件服务 Dio/Spi、Icu 及 Tm 之间，并将唤醒报告回 LinIf。来源：[SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003] [SWS_LinTrcv_00171] LinTrcv-SWS 第17页 LinTrcv-SWS 图 10.3 第45页

从上电到 Sleep 的操作模式生命周期

该驱动程序具有三种软件操作模式：LINTRCV_TRCV_MODE_NORMAL、LINTRCV_TRCV_MODE_STANDBY 和 LINTRCV_TRCV_MODE_SLEEP [SWS_LinTrcv_00168]。规范中的图 7.1 将它们归入一个生命周期中 LinTrcv-SWS 图 7.1 第15页：

• 上电后，驱动程序处于状态 NOT_ACTIVE。
• LinTrcv_Init 将其转换为状态 ACTIVE。这三种模式均位于 ACTIVE 之内。
• 掉电将终止该生命周期。

LinTrcv_Init 接收指向所选配置集的指针 [SWS_LinTrcv_00001]。结构体 LinTrcv_ConfigType 是特定于实现的 [SWS_LinTrcv_00172]。自版本 4.3.1 起，初始化后的初始模式被限制为 LINTRCV_TRCV_MODE_SLEEP LinTrcv-SWS 第1页。

在状态 ACTIVE 下，LinTrcv_SetOpMode 将寻址通道的内部状态切换至传入的模式 [SWS_LinTrcv_00002] LinTrcv-SWS 第25页。模式 LINTRCV_TRCV_MODE_STANDBY 是可选的。它可以是一个纯内部状态，供硬件用于状态转换。具体的硬件可能不需要所有接口 LinTrcv-SWS 图 7.1 第15页。此外，规范还指出了 LinTrcv_SetOpMode 将通道切换至 STANDBY 的条件。这些条件在当前摘录中被截断，在此不予展开 LinTrcv-SWS 第25页。

LinTrcv_GetOpMode 在输出参数 OpMode 中返回驱动程序的当前软件状态 [SWS_LinTrcv_00005] LinTrcv-SWS 第26页。这并不一定是器件的状态。调用者可借此在模式切换之前检查通道处于何种模式。通过 LinIf，该查询作为 LinIf_GetTrcvMode 提供 LinIf-SWS 第91页。

状态图：上电后驱动程序处于非活动状态。LinTrcv_Init 进入初始模式为 SLEEP 的活动区域，LinTrcv_SetOpMode 在各模式之间切换。可选转换是根据图 7.1 的图注文字重构的（解释）。未展示切换至 STANDBY 的条件转换。来源：LinTrcv-SWS 图 7.1 第15页 [SWS_LinTrcv_00168] [SWS_LinTrcv_00001] LinTrcv-SWS 第1页

通过 LIN 接口进行模式切换与查询

各服务均通过类型为 uint8 的参数 LinNetwork 来寻址通道 [SWS_LinTrcv_00002] [SWS_LinTrcv_00005]。在 LinIf 中，对应的参数名为 Channel，类型为 NetworkHandleType LinIf-SWS 第90页。

LinTrcv_SetOpMode 是同步且不可重入的，服务 ID 为 0x01。返回值的含义如下 [SWS_LinTrcv_00002]：

• E_OK：收发器状态已切换至请求的模式。
• E_NOT_OK：切换未被接受、已失败，或参数超出允许范围。

即使硬件不支持某种模式，LinIf 也必须允许对所有收发器和所有模式进行调用 LinIf-SWS 第90页。因此，映射到硬件仍属于 LinTrcv 的职责。

驱动程序使用 Tm_BusyWait1us16bit 实现状态切换期间的等待时间 [SWS_LinTrcv_00171]。由于 LinTrcv_SetOpMode 采用同步工作方式 [SWS_LinTrcv_00002]，这种主动等待时间很可能会产生在调用内部并延长其执行时间（解释）。 问题 Q-54fe21bbe7c737d9 (未决)在切换至待机模式时，驱动程序还会激活用于唤醒检测的 ICU 通道 LinTrcv-SWS 第17页。

查询服务是可重入的。LinTrcv_GetBusWuReason 以类型 LinTrcv_TrcvWakeupReasonType 返回检测到的唤醒原因 [SWS_LinTrcv_00007]。其取值包括 LINTRCV_WU_ERROR、LINTRCV_WU_NOT_SUPPORTED、LINTRCV_WU_BY_BUS 和 LINTRCV_WU_BY_PIN [SWS_LinTrcv_00170]。具体能以何种精度区分唤醒原因，在很大程度上取决于收发器硬件 LinTrcv-SWS 第28页。LinTrcv_GetVersionInfo 以 Std_VersionInfoType 形式返回版本信息 [SWS_LinTrcv_00008] LinTrcv-SWS 第29页。

时序图：模式切换流程从 LinIf 执行至 LinTrcv。LinTrcv 通过 Tm 等待，在切换至 STANDBY 时激活 ICU 通知，并通过 LinIf 原样返回其结果。通过 Dio/Spi 的控制以及调用内等待时间的位置属于解释。来源：[SWS_LinTrcv_00002] [SWS_LinTrcv_00171] LinIf-SWS 第90页 LinTrcv-SWS 第17页

检测、报告与控制唤醒

驱动程序区分两种唤醒类型 LinTrcv-SWS 第17页：

• 内部唤醒：由上层触发，例如通过 LinTrcv_Init 或 LinTrcv_SetOpMode。
• 外部唤醒：驱动程序在 LIN 通道上检测到该唤醒。LinIf 必须调用 LinTrcv_CheckWakeup，以便将唤醒向上传报。

驱动程序没有为唤醒提供专用的 ISR。检测通过带有 Icu_EnableNotification 和 Icu_DisableNotification 的 ICU 进行。唤醒类型通过配置参数 LinTrcvWakeUpSupport 选择。使用 LinTrcvWakeupByBusUsed 可以按通道启用和禁用唤醒支持 LinTrcv-SWS 第17页。

LinTrcv_CheckWakeup 评估被寻址网络上的唤醒，例如显性总线电平或唤醒引脚上的下降沿 LinTrcv-SWS 第30页。在 R20-11 中，返回值的含义为 [SWS_LinTrcv_00012]：

• E_OK：检测到唤醒。
• E_NOT_OK：未检测到唤醒。

来自后续版本中的文档位置对这些值的定义有所不同，定义为“调用已接受/未接受”。该变更引入自 R22-11，不适用于 R20-11 LinTrcv-SWS 第1页 LinTrcv-SWS 第30页。在成功检测后，驱动程序通过 LinIf_WakeupConfirmation 报告唤醒源 [SWS_LinTrcv_91002]。LinTrcv 不提供自身的回调通知 LinTrcv-SWS 第32页。因此必须主动调用 LinTrcv_CheckWakeup。

LinTrcv_SetWakeupMode 是同步且不可重入的。它通过 LinTrcv_TrcvWakeupModeType 控制各网络的唤醒通知 [SWS_LinTrcv_00009] [SWS_LinTrcv_00169]：

• LINTRCV_WUMODE_ENABLE 启用通知。
• LINTRCV_WUMODE_DISABLE 禁用通知。
• LINTRCV_WUMODE_CLEAR 清除已存储的唤醒事件。

如果在启用时已存在已存储的事件，驱动程序将在调用期间或紧随其后执行通知 LinTrcv-SWS 第31页。LinIf 将该控制作为 LinIf_SetTrcvWakeupMode 提供 LinIf-SWS 第93页。

时序图：外部唤醒通过 ICU 被检测到。LinIf 使用 LinTrcv_CheckWakeup 对其进行检查，LinTrcv 通过 LinIf_WakeupConfirmation 予以确认，随后可查询原因（返回值遵循 R20-11）。来源：[SWS_LinTrcv_00012] [SWS_LinTrcv_91002] [SWS_LinTrcv_00007] LinTrcv-SWS 第17页 LinIf-SWS 第98页

活动图：LinTrcv_SetWakeupMode 根据请求的模式进行分支。仅当在 ENABLE 且存在已存储事件的情况下，才会立即进行通知。来源：[SWS_LinTrcv_00009] [SWS_LinTrcv_00169] LinTrcv-SWS 第31页

硬件访问、通道配置与分区

选择容器 LinTrcvAccess 确定驱动程序如何访问器件 LinTrcv-SWS 图 10.3 第45页。必须在两种变体中严格选择一种：

• LinTrcvDioAccess：收发器引脚映射到 DIO 通道。
• LinTrcvSpiSequence：支持 SPI 的器件通过 SPI 序列进行寻址。

该图表源自 R23-11 及更高版本。但 DIO 读写服务以及 SPI 类型在 R20-11 中就已作为所使用的接口或导入的类型列出 [SWS_LinTrcv_91003] [SWS_LinTrcv_91001]。

对于多核系统，在 R20-11 中适用以下规则：

• 驱动程序必须拒绝具有不受支持的分区分配的配置 [SWS_LinTrcv_00174]。
• 通过 LinTrcvChannelEcucPartitionRef 引用的分区必须是通过 LinTrcvEcucPartitionRef 引用的分区的子集。若模块引用了分区，则每个通道必须恰好引用其中一个分区 [SWS_LinTrcv_00176]。
• 同一通信通道的 LinTrcvChannel 和 LinChannel 必须引用相同的分区 [SWS_LinTrcv_00177]。

多核分布引入自 R19-11，并在 R24-11 中得到了进一步细化 LinTrcv-SWS 第1页。

发生错误时的行为

运行时错误体现在返回值中：

• 当与收发器的通信缺失或发生故障时，LinTrcv_GetOpMode LinTrcv-SWS 第26页 和 LinTrcv_GetBusWuReason 返回 LinTrcv-SWS 第28页 E_NOT_OK。
• 当切换未被接受或已失败时，LinTrcv_SetOpMode 返回 E_NOT_OK [SWS_LinTrcv_00002]。
• 当无法设置唤醒模式时，LinTrcv_SetWakeupMode 返回 E_NOT_OK LinTrcv-SWS 第31页。
• 如果由于错误而无法确定唤醒原因，则为此提供值 LINTRCV_WU_ERROR [SWS_LinTrcv_00170]。

驱动程序通过 Det_ReportError 报告开发错误 [SWS_LinTrcv_91003]。在 R20-11 中，它们在 LinTrcv_GetOpMode 和 LinTrcv_GetBusWuReason 时导致 E_NOT_OK [SWS_LinTrcv_00005] [SWS_LinTrcv_00007]。来自后续版本的文档位置给出了具体的检查项 LinTrcv-SWS 第26页 LinTrcv-SWS 第30页 LinTrcv-SWS 第29页：

• 初始化前调用：LINTRCV_E_UNINIT
• 无效网络编号：LINTRCV_E_INVALID_LIN_NETWORK
• LinTrcv_GetVersionInfo 处的空指针：LINTRCV_E_PARAM_POINTER

从内容上看，这些检查应该也适用于 R20-11（解释）。 问题 Q-58e3d310b525b810 (未决)然而，R20-11 清理了错误分类，而 R21-11 清理了错误代码。因此，这些标识符在 R20-11 中可能会有所不同 LinTrcv-SWS 第1页。

LinIf 已经拦截了部分误操作。在 Channel 无效时，LinIf_SetTrcvMode 和 LinIf_GetTrcvMode 报告错误 LINIF_E_NONEXISTENT_CHANNEL LinIf-SWS 第90页。在通道无效或存在空指针时，LinIf_GetTrcvMode 还会返回 E_NOT_OK LinIf-SWS 第91页。如果 LinIf_WakeupConfirmation 收到无效的唤醒源，则在错误检测已激活时触发 LINIF_E_PARAM_WAKEUPSOURCE LinIf-SWS 第98页。

进一步详细证据

• [SWS_LinTrcv_00002] 与 LinTrcv-SWS 第25页：模式切换、返回值以及切换至 STANDBY。
• [SWS_LinTrcv_00012] 与 LinTrcv-SWS 第30页：唤醒检查。R20-11 中的返回值与后续版本有所不同。
• [SWS_LinTrcv_00009] [SWS_LinTrcv_00169] 与 LinTrcv-SWS 第31页：启用、禁用和清除唤醒通知。
• [SWS_LinTrcv_00168] 与 LinTrcv-SWS 图 7.1 第15页：操作模式与生命周期。
• [SWS_LinTrcv_00170] 与 LinTrcv-SWS 第28页：唤醒原因及其对硬件的依赖性。
• [SWS_LinTrcv_00171]：通过 Tm_BusyWait1us16bit 的等待时间。
• [SWS_LinTrcv_00174] [SWS_LinTrcv_00176] [SWS_LinTrcv_00177]：多核 ECU 上的分区。
• [SWS_LinTrcv_91001] [SWS_LinTrcv_91002] [SWS_LinTrcv_91003]：导入的类型、向 LinIf 的唤醒确认以及其他使用的接口。
• LinTrcv-SWS 第17页：内部和外部唤醒、ICU 使用以及唤醒配置。