AUTOSAR_SWS_LINTransceiverDriver

Specification of LIN Transceiver Driver


简介和功能概述


本规范规定了 LIN 收发器驱动程序的功能、API 和配置。它负责对 ECU 上的 LIN 收发器硬件进行处理。

LIN 收发器是一种硬件设备。它是 LIN 控制器和物理 LIN 总线之间的接口。一方面，LIN 控制器的传输（发送）数据流被转换为物理 LIN 总线上的信号。另一方面，物理 LIN 总线上的数据流被转换为 LIN 控制器的输入信号。LIN 控制器通常被实现在微控制器中。

大多数 LIN 收发器支持通过总线进行电源控制和唤醒。市面上有许多不同的唤醒/休眠和电源控制机制。

此外，还有所谓的系统基础芯片 (SBC) 可供选择。除了 LIN 收发器的功能外，这些设备还提供其他功能，例如电气故障检测（例如，接地 (GND) 短路）、电源控制、高级看门狗、LIN 收发器、SPI 等。

LIN 收发器驱动程序的目标

本文档的目标是指定适用于大多数当前 LIN 收发器硬件实现的接口和行为。

[SWS_LinTrcv_00042]

[SRS_BSW_00162]
  • LIN 收发器驱动程序抽象了被应用的 LIN 收发器硬件，并涵盖了与硬件无关的对上层进行调用的接口。它还通过 MCAL 层的 API 来访问 LIN 收发器硬件，从而在 ECU 布局中实现抽象。

未涵盖（明确地）的 LIN 收发器功能

一些 LIN 收发器提供额外的功能，例如 ECU 自检或被用于诊断的错误检测功能。

AUTOSAR 并未对 ECU 自检和错误检测功能进行定义，通常情况下，此类功能将会锁定大多数当前被使用的收发器硬件芯片。因此，“接地偏移检测”、“选择性唤醒”、“斜率控制”等功能均不受支持。

首字母缩略词、缩写和词汇表



相关文档


AUTOSAR 的交付文档

[1] List of Basic Software Modules 
  • AUTOSAR_TR_BSWModuleList   

[2] Layered Software Architecture 
  • AUTOSAR_EXP_LayeredSoftwareArchitecture   

[3] General Requirements on Basic Software Modules 
  • AUTOSAR_SRS_BSWGeneral   

[4] Requirements on LIN 
  • AUTOSAR_SRS_LIN   

[5] Specification of ECU Configuration 
  • AUTOSAR_TPS_ECUConfiguration   

[6] General Specification of Basic Software Modules 
  • AUTOSAR_SWS_BSWGeneral 

相关标准及规范

[7] Specification of LIN Driver 
  • AUTOSAR_SWS_LINDriver 

[8] Specification of LIN Interface 
  • AUTOSAR_SWS_LINInterface 

[9] Specification of ECU State Manager 
  • AUTOSAR_SWS_ECUStateManager 

[10] Specification of Standard Types 
  • AUTOSAR_SWS_StandardTypes 

[11] Specification of Communication Stack Types 
  • AUTOSAR_SWS_CommunicationStackTypes 

[12] Basic Software Module Description Template 
  • AUTOSAR_TPS_BSWModuleDescriptionTemplate

相关规范

AUTOSAR 提供了关于基础软件模块 [6] 的通用规范，该规范也适用于 LIN 收发器驱动程序。

因此，[6] 应被视为 LIN 收发器驱动程序的附加规范和必需规范。

约束和假设


限制

底层驱动程序（例如 DIO 或 SPI）所使用的 API 必须是同步的。不支持同步行为的底层驱动程序的实现不能与 LIN 收发器驱动程序一起被使用。

对于汽车领域的适用性

该规范可能适用于所有使用 LIN 的汽车领域。

对其他模块的依赖



文件结构

LIN 收发器驱动程序的实现的命名约定

[SWS_LinTrcv_00070]

[SRS_BSW_00347]
  • 如果在一个 ECU 中使用了不同的 LIN 收发器硬件实现，则必须修改不同的 LIN 收发器驱动程序的函数名称，以确保不会生成两个具有相同名称的函数。这些名称可以通过供应商 ID 或类型 ID 进行扩展。

代码文件结构

详细内容请参考 [6] 中的第 5.1.6 节“代码文件结构”。

头文件结构

[SWS_LinTrcv_00067]

[SRS_BSW_00301]
[SRS_BSW_00409]
  • 头文件结构如下： 如果启用了模块 LinTrcv 的开发错误检测，则 LinTrcv.c 应包含 Det.h（被用于上报开发错误）。 LinTrcv.c 应包含 Dio.h（被用于对 DIO 的 API 进行访问，以访问 LIN 收发器的引脚）。 LinTrcv.c 应包含 Icu.h（被用于对 ICU 的 API 进行访问，以处理 LIN 收发器的硬件中断）。 LinTrcv.c 应包含 Spi.h（被用于对通过 SPI 驱动程序控制的 LIN 收发器硬件进行控制）。 LinTrcv.c 应包含 Tm.h（被用于对 LIN 收发器的模式切换的目标模式（内部状态）进行等待）。

需求可追溯性



功能定义


LIN 收发器驱动程序的运行模式

[SWS_LinTrcv_00055]

[SRS_Lin_01566]
[SRS_Lin_01524]
[SRS_Can_01098]
[SRS_Can_01099]
[SRS_Can_01100]
  • LIN 收发器驱动程序的运行模式如以下状态图所示。

该图背后的主要思想是在一个通用模型视图中对大多数可用的 LIN 收发器进行支持。根据 LIN 收发器硬件的不同，该模型可能比给定的 LIN 收发器硬件所需的模式（内部状态）多一至两个，但这将明确地使 ComM 和 EcuM 与给定的 LIN 收发器硬件分离。


提示：

有几个可选接口可能不被当前 LIN 收发器硬件需要。例如，LINTRCV_TRCV_MODE_STANDBY 模式可能只是硬件内部模式切换操作中的中间模式（内部状态）。尤其是在使用“禁用引脚（Inhibit Pin）”功能控制 uC 时，仅需要关注 LINTRCV_TRCV_MODE_SLEEP 和 LINTRCV_TRCV_MODE_NORMAL。


如果 LIN 收发器驱动程序包含多个 LIN 通道，则所有通道要么处于 NOT_ACTIVE 状态，要么处于 ACTIVE 状态。在 ACTIVE 状态下，每个通道可能处于不同的子状态。

LIN 收发器硬件的运行模式

LIN 收发器硬件可能比软件支持更多的模式切换。本章将解释依赖关系和推荐的实现的行为。

LIN 收发器硬件的模式（内部状态）与 LIN 收发器驱动程序的模式（内部状态）的对应关系由具体实现决定。具体实现必须确保其包含本规范所述的 LIN 收发器驱动程序的全部功能。

LIN 收发器的唤醒类型

有四种不同的场景，通称为唤醒：
  • MCU 未上电，ECU 的部件（包括 LIN 收发器硬件）已上电。此处假设 LIN 收发器硬件处于 LINTRCV_TRCV_MODE_SLEEP 模式。LIN 收发器硬件检测到 LIN 总线上的唤醒事件。LIN 收发器硬件导致 MCU 上电（例如，通过禁用引脚（Inhibit Pin））。对于 AUTOSAR 而言，这被视为冷启动，而非唤醒。
  • MCU 处于低功耗模式，ECU 的部件（包括 LIN 收发器硬件）已上电。根据硬件实现，此处假设 LIN 收发器硬件处于 LINTRCV_TRCV_MODE_STANDBY 或 LINTRCV_TRCV_MODE_SLEEP 模式。LIN 收发器硬件检测到 LIN 总线上的唤醒事件。LIN 收发器硬件通知 MCU 关于唤醒事件。对于 AUTOSAR 而言，这被视为 LIN 通道唤醒及 MCU 唤醒。
  • MCU 处于全功率模式，ECU 的部件（包括 LIN 收发器硬件）已上电。根据硬件实现，此处假设 LIN 收发器硬件处于 LINTRCV_TRCV_MODE_STANDBY 或 LINTRCV_TRCV_MODE_SLEEP 模式。LIN 收发器硬件检测到 LIN 总线上的唤醒事件。LIN 收发器硬件通知 MCU 关于唤醒事件或周期性轮询唤醒事件。对于 AUTOSAR 而言，这被视为 LIN 通道唤醒。
  • MCU 处于全功率模式，ECU 的部件（包括 LIN 收发器硬件）已上电。根据硬件实现，此处假设 LIN 收发器硬件处于 LINTRCV_TRCV_MODE_STANDBY 或 LINTRCV_TRCV_MODE_SLEEP 模式。MCU 将 LIN 收发器硬件设置为 LINTRCV_TRCV_MODE_NORMAL 模式，并唤醒 LIN 通道。对于 AUTOSAR 而言，这被视为 LIN 通道内部唤醒（通过 MCU）。

LIN 收发器的唤醒模式

[SWS_LinTrcv_00066]

[SRS_Lin_01514]
[SRS_Lin_01563]
  • LIN 收发器驱动程序应支持唤醒通知，因此 LIN 收发器驱动程序包含 2 种唤醒模式：上层发起的内部唤醒或 LIN 通道发起的外部唤醒。

内部唤醒
  • 内部唤醒由上层发起，例如，对 LinTrcv_Init 或 LinTrcv_SetOpMode 进行调用。

外部唤醒
  • LIN 收发器驱动程序检测到唤醒事件，通过对 LinTrcv_CheckWakeup 进行调用将唤醒事件转发至上层，该 API 必须由 LinIf 调用。

提示：

LIN 收发器驱动程序不支持通过 ISR 唤醒，其只能通过 ICU 唤醒。

[SWS_LinTrcv_00074]

[SRS_Lin_01580]
  • 应通过对参数 LinTrcvWakeUpSupport 进行配置选择唤醒模式。

[SWS_LinTrcv_00075]

[SRS_Lin_01580]
  • 应通过对参数 LinTrcvWakeupByBusUsed 进行配置单独地启用或禁用每个 LIN 收发器的通道的唤醒功能。

[SWS_LinTrcv_00161]

[ ]
  • LIN 收发器驱动程序应通过对 ICU 驱动程序提供的以下 API 进行调用启用或禁用唤醒事件通知：
    • Icu_EnableNotification 
    • Icu_DisableNotification

[SWS_LinTrcv_00162]

[ ]
  • 当 LIN 收发器的模式被切换为 LINTRCV_TRCV_MODE_STANDBY 时，LIN 收发器驱动程序应启用 ICU 通道。

[SWS_LinTrcv_00163]

[ ]
  • 当 LIN 收发器的模式被切换为 LINTRCV_TRCV_MODE_NORMAL 时，LIN 收发器驱动程序应禁用 ICU 通道。

原因：

LIN 收发器驱动程序应避免丢失唤醒事件。

错误分类

开发错误

[SWS_LinTrcv_00050]

[SRS_BSW_00327]
[SRS_BSW_00385]
[SRS_BSW_00386]

驱动程序初始化的先决条件

[SWS_LinTrcv_00099]

[ ]
  • LIN 收发器驱动程序可能通过 DIO 或 SPI 驱动程序控制 LIN 收发器硬件。因此，在 LIN 收发器驱动程序被初始化之前这些驱动程序应被初始化。

LIN 收发器驱动程序可能对初始化序列及对 LIN 收发器硬件的访问有时序上的要求，在这些过程中被使用的底层驱动程序必须满足这些要求。

时序上的要求可能是：对 LIN 收发器驱动程序的初始化必须在上电后被尽早地执行，以便能够及时地从 LIN 收发器硬件中读取所有必要的信息，以供 ECU 中的所有其他用户使用。所使用的底层服务的运行时间应非常短且对服务的调用应为同步的，以确保 LIN 收发器驱动程序符合其访问的 LIN 收发器硬件在时序上的要求。LIN 收发器驱动程序的运行时间可能会被延长，因为对某些硬件的操作可能包含在指定的时间（例如，50μs）内将某个引脚驱动为高电平或低电平，然后将硬件的模式（内部状态）切换为指定的模式（内部状态）（例如，休眠状态）。

实例概念

[SWS_LinTrcv_00016]

[SRS_BSW_00347]
[SRS_BSW_00413]
  • 对于每种 LIN 收发器硬件类型，ECU 都有一个 LIN 收发器驱动程序实例。每个实例将服务于所有相同类型的 LIN 收发器硬件。

等待状态

为了切换运行模式，在 LIN 收发器硬件的模式（内部状态）切换操作完成前可能必须等待。

[SWS_LinTrcv_00171]

[ ]
  • LIN 收发器驱动程序应通过对 Tm_BusyWait1us16bit 进行调用实现等待（在 LIN 收发器硬件的模式（内部状态）切换操作完成前）操作。

API 规范


导入的类型

[SWS_LinTrcv_91001]

[ ]

类型定义

LinTrcv_ConfigType 

[SWS_LinTrcv_00172]

[SRS_BSW_00414]

LinTrcv_TrcvModeType 

[SWS_LinTrcv_00168]

[ ]

LinTrcv_TrcvWakeupModeType 

[SWS_LinTrcv_00169]

[ ]

LinTrcv_TrcvWakeupReasonType 

[SWS_LinTrcv_00170]

[ ]

函数定义

LinTrcv_Init 

[SWS_LinTrcv_00001]

[SRS_BSW_00310]
[SRS_BSW_00358]
[SRS_BSW_00414]
[SRS_BSW_00101]
[SRS_Can_01096]
[SRS_Can_01097]

[SWS_LinTrcv_00173]

[SRS_BSW_00414]
  • 参数 ConfigPtr 应始终为 NULL。

参数 ConfigPtr 当前未被使用，因此应被设置为 NULL。

[SWS_LinTrcv_00119]

[ ]
  • 函数 LinTrcv_Init 应将 LIN 收发器硬件的模式（内部状态）设置为 LINTRCV_TRCV_MODE_SLEEP。

警告：

复位（例如，上电）后的初始化序列对于 LIN 收发器驱动程序来说至关重要。该驱动程序将使用 SPAL 功能 (DIO) 对 LIN 收发器硬件进行访问。因此，所有必要的驱动程序（MCAL）必须在此之前被初始化。

LinTrcv_SetOpMode 

[SWS_LinTrcv_00002]

[SRS_BSW_00310]
[SRS_BSW_00357]
[SRS_BSW_00369]
[SRS_BSW_00406]
[SRS_Lin_01566]
[SRS_Lin_01524]
[SRS_Can_01097]
[SRS_Can_01098]
[SRS_Can_01099]
[SRS_Can_01100]

[SWS_LinTrcv_00108]

[ ]
  • 函数 LinTrcv_SetOpMode 将通道 LinNetwork 的模式（内部状态）切换为参数 OpMode 的值，该值可以为 LINTRCV_TRCV_MODE_NORMAL、LINTRCV_TRCV_MODE_STANDBY 或 LINTRCV_TRCV_MODE_SLEEP。

[SWS_LinTrcv_00109]

[ ]
  • 如果满足以下条件之一，函数 LinTrcv_SetOpMode 应将通道 LinNetwork 的模式（内部状态）切换为 LINTRCV_TRCV_MODE_STANDBY：
    • 通道 LinNetwork 处于 LINTRCV_TRCV_MODE_SLEEP，并且可以从该模式被切换至 LINTRCV_TRCV_MODE_STANDBY。
    • 通道 LinNetwork 处于 LINTRCV_TRCV_MODE_NORMAL，并且可以从该模式被切换至 LINTRCV_TRCV_MODE_STANDBY。

[SWS_LinTrcv_00110]

[ ]
  • 如果满足以下条件之一，函数 LinTrcv_SetOpMode 应将通道 LinNetwork 的模式（内部状态）切换为 LINTRCV_TRCV_MODE_SLEEP：
    • 通道 LinNetwork 处于 LINTRCV_TRCV_MODE_NORMAL。
    • 通道 LinNetwork 处于 LINTRCV_TRCV_MODE_STANDBY，并且可以从该模式被切换至 LINTRCV_TRCV_MODE_SLEEP。

[SWS_LinTrcv_00147]

[ ]
  • 如果满足以下条件之一，函数 LinTrcv_SetOpMode 应将通道 LinNetwork 的模式（内部状态）切换为 LINTRCV_TRCV_MODE_NORMAL：
    • 通道 LinNetwork 处于 LINTRCV_TRCV_MODE_SLEEP。
    • 通道 LinNetwork 处于 LINTRCV_TRCV_MODE_STANDBY，并且可以从该模式被切换至 LINTRCV_TRCV_MODE_NORMAL。

[SWS_LinTrcv_00111]

[ ]
  • 对于每个 LIN 收发器而言，函数 LinTrcv_SetOpMode 的参数都是适用的，无论参数 OpMode 的值是否被 LIN 收发器硬件支持。对于 LIN 总线而言，这是为了简化 LinIf 模块。

[SWS_LinTrcv_00112]

[ ]
  • 如果模式切换请求不被 LIN 收发器硬件支持，则函数 LinTrcv_SetOpMode 应返回 E_NOT_OK。

[SWS_LinTrcv_00113]

[ ]
  • 如果无法访问 LIN 收发器硬件或在访问过程中出现错误，则函数 LinTrcv_SetOpMode 应返回 E_NOT_OK。

[SWS_LinTrcv_00114]

[ ]
  • 如果启用了开发错误检测：如果对函数 LinTrcv_SetOpMode 进行调用（参数 OpMode 的值为 LINTRCV_TRCV_MODE_STANDBY），且通道 LinNetwork 处于 LINTRCV_TRCV_MODE_SLEEP，及不支持从 LINTRCV_TRCV_MODE_SLEEP 被切换至 LINTRCV_TRCV_MODE_STANDBY，则函数 LinTrcv_SetOpMode 应上报开发错误 LINTRCV_E_INVALID_TRCV_OPMODE。

[SWS_LinTrcv_00148]

[ ]
  • 如果启用了开发错误检测：如果对函数 LinTrcv_SetOpMode 进行调用（参数 OpMode 的值为 LINTRCV_TRCV_MODE_STANDBY），且通道 LinNetwork 处于 LINTRCV_TRCV_MODE_NORMAL，及不支持从 LINTRCV_TRCV_MODE_NORMAL 被切换至 LINTRCV_TRCV_MODE_STANDBY，则函数 LinTrcv_SetOpMode 应上报开发错误 LINTRCV_E_INVALID_TRCV_OPMODE。

[SWS_LinTrcv_00115]

[ ]
  • 如果启用了开发错误检测：如果对函数 LinTrcv_SetOpMode 进行调用（参数 OpMode 的值为 LINTRCV_TRCV_MODE_SLEEP），且通道 LinNetwork 未处于 LINTRCV_TRCV_MODE_NORMAL，及不支持从 LINTRCV_TRCV_MODE_STANDBY 被切换至 LINTRCV_TRCV_MODE_SLEEP，则函数 LinTrcv_SetOpMode 应上报开发错误 LINTRCV_E_TRCV_NOT_NORMAL。

[SWS_LinTrcv_00149]

[ ]
  • 如果启用了开发错误检测：如果对函数 LinTrcv_SetOpMode 进行调用（参数 OpMode 的值为 LINTRCV_TRCV_MODE_NORMAL），且通道 LinNetwork 未处于 LINTRCV_TRCV_MODE_SLEEP，及不支持从 LINTRCV_TRCV_MODE_STANDBY 被切换至 LINTRCV_TRCV_MODE_NORMAL，则函数 LinTrcv_SetOpMode 应上报开发错误 LINTRCV_E_TRCV_NOT_SLEEP。

[SWS_LinTrcv_00116]

[ ]
  • 如果启用了开发错误检测：如果在 LIN 收发器驱动程序被初始化之前，对 LinTrcv_SetOpMode 进行调用，则函数 LinTrcv_SetOpMode 应上报开发错误 LINTRCV_E_UNINIT。

[SWS_LinTrcv_00117]

[ ]
  • 如果启用了开发错误检测：如果参数 LinNetwork 的值为无效值，则函数 LinTrcv_SetOpMode 应上报开发错误 LINTRCV_E_INVALID_LIN_NETWORK。

[SWS_LinTrcv_00157]

[ ]
  • 参数 OpMode 的值与当前的模式相同是被允许的且不应引发错误（即使启用了开发错误检测）。

LinTrcv_GetOpMode 

[SWS_LinTrcv_00005]

[SRS_BSW_00310]
[SRS_BSW_00369]
[SRS_BSW_00377]
[SRS_Can_01097]
[SRS_Can_01101]

[SWS_LinTrcv_00121]

[ ]
  • 函数 LinTrcv_GetOpMode 应通过参数 OpMode 返回 LIN 收发器驱动程序的当前模式（内部状态）。

[SWS_LinTrcv_00122]

[ ]
  • 如果无法访问 LIN 收发器硬件或在访问过程中出现错误，则函数 LinTrcv_GetOpMode 应返回 E_NOT_OK。

[SWS_LinTrcv_00123]

[ ]
  • 如果启用了开发错误检测：如果在 LIN 收发器驱动程序被初始化之前，对 LinTrcv_GetOpMode 进行调用，则函数 LinTrcv_GetOpMode 应上报开发错误 LINTRCV_E_UNINIT。

[SWS_LinTrcv_00124]

[ ]
  • 如果启用了开发错误检测：如果参数 LinNetwork 的值为无效值，则函数 LinTrcv_GetOpMode 应上报开发错误 LINTRCV_E_INVALID_LIN_NETWORK。

[SWS_LinTrcv_00125]

[ ]
  • 如果启用了开发错误检测：如果参数 OpMode 的值为 NULL，则函数 LinTrcv_GetOpMode 应上报开发错误 LINTRCV_E_PARAM_POINTER。

配置：

支持的总线的数量应在配置阶段被静态地设置。

LinTrcv_GetBusWuReason 

[SWS_LinTrcv_00007]

[SRS_BSW_00310]
[SRS_BSW_00369]
[SRS_BSW_00377]
[SRS_BSW_00406]
[SRS_Can_01097]
[SRS_Can_01103]

[SWS_LinTrcv_00126]

[ ]
  • 函数 LinTrcv_GetBusWuReason 应通过参数 Reason 返回 LIN 收发器硬件检测到的唤醒原因。

[SWS_LinTrcv_00127]

[ ]
  • 如果无法访问 LIN 收发器硬件或在访问过程中出现错误，则函数 LinTrcv_GetBusWuReason 应返回 E_NOT_OK。

[SWS_LinTrcv_00128]

[ ]
  • 如果启用了开发错误检测：如果在 LIN 收发器驱动程序被初始化之前，对 LinTrcv_GetBusWuReason 进行调用，则函数 LinTrcv_GetBusWuReason 应上报开发错误 LINTRCV_E_UNINIT。

[SWS_LinTrcv_00129]

[ ]
  • 如果启用了开发错误检测：如果参数 LinNetwork 的值为无效值，则函数 LinTrcv_GetBusWuReason 应上报开发错误 LINTRCV_E_INVALID_LIN_NETWORK。

[SWS_LinTrcv_00130]

[ ]
  • 如果启用了开发错误检测：如果参数 Reason 的值为 NULL，则函数 LinTrcv_GetBusWuReason 应上报开发错误 LINTRCV_E_PARAM_POINTER。

配置：

支持的总线的数量应在配置阶段被静态地设置。

警告：

请注意，如果存在多个总线，则每个总线可能会报告不同的唤醒原因。例如，ECU 中的某个 LIN 收发器硬件被总线唤醒，另一个 LIN 收发器硬件则被内部唤醒。在 LIN 收发器驱动程序中每个 LIN 总线相互独立，且不会在其内部对唤醒原因及序列进行优先级排序。例如，一个 LIN 收发器硬件控制上电或下电，而另一个 LIN 收发器硬件只是被动上电或下电。

LinTrcv_GetVersionInfo 

[SWS_LinTrcv_00008]

[SRS_BSW_00310]
[SRS_BSW_00369]
[SRS_BSW_00406]
[SRS_BSW_00407]

[SWS_LinTrcv_00131]

[ ]
  • 函数 LinTrcv_GetVersionInfo 应返回 LIN 收发器驱动程序的版本信息。版本信息包含在“AUTOSAR_SWS_StandardTypes”中的 Std_VersionInfoType 中被定义的所有数据。

[SWS_LinTrcv_00134]

[ ]
  • 如果启用了开发错误检测：如果参数 versionInfo 的值为 NULL，则函数 LinTrcv_GetVersionInfo 应上报开发错误 LINTRCV_E_PARAM_POINTER。

LinTrcv_CheckWakeup 

[SWS_LinTrcv_00012]

[SRS_BSW_00310]
[SRS_BSW_00369]
[SRS_BSW_00375]
[SRS_BSW_00406]
[SRS_Can_01097]

[SWS_LinTrcv_00144]

[ ]
  • 如果启用了开发错误检测：如果在 LIN 收发器驱动程序被初始化之前，对 LinTrcv_CheckWakeup 进行调用，则函数 LinTrcv_CheckWakeup 应上报开发错误 LINTRCV_E_UNINIT。

[SWS_LinTrcv_00145]

[ ]
  • 如果启用了开发错误检测：如果参数 LinNetwork 的值为无效值，则函数 LinTrcv_CheckWakeup 应上报开发错误 LINTRCV_E_INVALID_LIN_NETWORK。

[SWS_LinTrcv_00166]

[ ]
  • 函数 LinTrcv_CheckWakeup 应评估参数 LinNetwork 寻址的 LIN 网络上的唤醒事件。当检测到唤醒事件（例如，LIN 总线上的显性状态或唤醒引脚的下降沿）时，LinTrcv_CheckWakeup 函数应立即通过对 EcuM_SetWakeupEvent 进行调用通知 EcuM 模块，并通过对 LinIf_WakeupConfirmation 进行调用通知 LinIf 模块。

[SWS_LinTrcv_00167]

[ ]
  • 如果启用了开发错误检测：如果参数 LinNetwork 寻址的 LIN 网络未处于 LINTRCV_TRCV_MODE_SLEEP，则函数 LinTrcv_CheckWakeup 应上报开发错误 LINTRCV_E_TRCV_NOT_SLEEP。

配置：

参见参数 LinTrcvWakeUpSupport。

LinTrcv_SetWakeupMode 

[SWS_LinTrcv_00009]

[ ]

[SWS_LinTrcv_00135]

[ ]
  • 如果对函数 LinTrcv_SetWakeupMode 进行调用（参数 TrcvWakeupMode 的值为 LINTRCV_WUMODE_ENABLE），且在参数 LinNetwork 寻址的 LIN 网络上存在唤醒事件，则 LIN 收发器驱动程序应在 LinTrcv_SetWakeupMode 的上下文中或在对函数 LinTrcv_SetWakeupMode 的调用结束后立即进行通知（取决于具体实现）。

[SWS_LinTrcv_00136]

[ ]
  • 如果对函数 LinTrcv_SetWakeupMode 进行调用（参数 TrcvWakeupMode 的值为 LINTRCV_WUMODE_DISABLE），则将禁用通知其他模块关于参数 LinNetwork 寻址的 LIN 网络上的唤醒事件。LIN 收发器硬件及与 LIN 收发器硬件进行通信的底层驱动程序应对唤醒事件进行存储，以便在唤醒通知被启用时通知其他模块关于此唤醒事件。

[SWS_LinTrcv_00137]

[ ]
  • 如果对函数 LinTrcv_SetWakeupMode 进行调用（参数 TrcvWakeupMode 的值为 LINTRCV_WUMODE_CLEAR），则将清除参数 LinNetwork 寻址的 LIN 网络上的唤醒事件。必须在唤醒通知被禁用时对唤醒事件进行清除，以清除所有被存储的唤醒事件。

[SWS_LinTrcv_00138]

[ ]
  • 如果无法访问 LIN 收发器硬件或在访问过程中出现错误，则函数 LinTrcv_SetWakeupMode 应返回 E_NOT_OK。

[SWS_LinTrcv_00139]

[ ]
  • 如果启用了开发错误检测：如果在 LIN 收发器驱动程序被初始化之前，对 LinTrcv_SetWakeupMode 进行调用，则函数 LinTrcv_SetWakeupMode 应上报开发错误 LINTRCV_E_UNINIT。

[SWS_LinTrcv_00140]

[ ]
  • 如果启用了开发错误检测：如果参数 LinNetwork 的值为无效值，则函数 LinTrcv_SetWakeupMode 应上报开发错误 LINTRCV_E_INVALID_LIN_NETWORK。

预期接口

本章列出了 LIN 收发器驱动程序所需的由其他模块提供的所有函数。

强制接口

LIN 收发器驱动程序需要以下接口以实现其核心功能。

[SWS_LinTrcv_91002]

[ ]

可选接口

LIN 收发器驱动程序需要以下接口以实现其可选功能。

[SWS_LinTrcv_91003]

[ ]

[SWS_LinTrcv_00165]

[ ]
  • 仅当参数 LinTrcvIcuChannelRef 被配置了有效的引用时，LIN 收发器驱动程序才应启用/禁用 ICU 通道。

配置规范


LinTrcv




LinTrcvGeneral









[SWS_LinTrcv_00175]

[ ]
  • 在每个分区中该模块将作为独立运行的实例，这意味着被调用的 API 将仅针对对其进行调用的分区。

LinTrcvChannel









[SWS_LinTrcv_00176]

[ ]
  • LinTrcvChannelEcucPartitionRef 引用的 ECUC 分区应是 LinTrcvEcucPartitionRef 引用的 ECUC 分区的子集

[SWS_LinTrcv_00178]

[ ]
  • 如果 LinTrcvEcucPartitionRef 引用了一个或多个 ECUC 分区，则 LinTrcvChannelEcucPartitionRef 的多重性应为 1 ，并应引用 LinTrcvEcucPartitionRef 引用的 ECUC 分区中的一个。

[SWS_LinTrcv_00177]

[ ]
  • 一个通信通道的 LinTrcvChannel 和 LinChannel 应引用同一个 ECUC 分区。


LinTrcvAccess




LinTrcvDioAccess



LinTrcvDioChannelAccess





LinTrcvSpiSequence



评论

发表评论

此博客中的热门博文

AUTOSAR_SWS_CANDriver

图片
AUTOSAR_SWS_ CAN Driver 简介和功能概述 该规范指定了 AUTOSAR 基础软件模块 CAN 驱动程序（在本文档中称为“Can 模块”）的功能、 API 和配置。 CAN 模块属于最低层，执行硬件访问并向上层提供独立于 硬件 的 API 。 唯一可以访问  CAN  模块的上层是 Can If 模块（另请参阅  SRS _ SPAL _12092）。 CAN  模块提供启动传输的服务，并调用  Can If  模块的回调函数来通知 事件 ，独立于 硬件 。 此外，它还提供控制属于同一 CAN 硬件 单元的 CAN 控制器 的行为和状态的 服务 。 只要属于同一个 CAN 硬件 单元， 多 个 CAN 控制器 就可以由单个 CAN 模块控制。 有关 CAN 控制器 和 CAN 硬件 单元的详细描述，请参见首字母缩略词和缩写章节以及[5]中的图表。 首字母缩略词和缩写 优先级反转 如果只使用单个传输 缓冲区 ，则可能会发生内部 优先级 反转。 由于 优先级 较低，存储在 缓冲区 中的 消息 会等待，直到“总线上的流量平静下来”。 在等待期间，此 消息 可能会阻止同一微控制器生成通过总线传输的更高 优先级 的 消息 。 外部 优先级 反转问题可能出现在某些 CAN 实现中。 假设 CAN 节点希望传输一组具有高 优先级 的连续 消息 ，这些 消息 存储在不同的 消息 缓冲区 中。如果 CAN 网络上这些 消息 之间的 帧间空间 大于 CAN 标准定义的 最小 空间，则第 二 个节点能够开始传输较低 优先级 的 消息 。 最小 帧间空间 由 间歇字段 确定，该字段由 3 个隐性 bit 组成。 之前由于另一条 消息 的传输而处于待处理阶段的 消息 ，将在总线空闲期间开始被传输，最快可紧随 间歇字段 之后，从 间歇字 段 之后的第 一 个 bit 开始。 例外情况是，具有待传输的 消息 的节点会将 间歇字段 的第三个 bit 解释为显性 bit ，并以此 bit 作为帧的起始位，开始传输帧的第一个标识符位，而无需先传输 SOF 位。 CAN 模块的内部处理时间必须足够 短 ，以发送具有最小 帧间空间 的连续 消息 ，以避免在上述所有情况下出现外部 优先...
Read more »

Linux Driver Char Device 笔记

图片
1.打開設備 设备节点           本质上和文件节点相同，为操作驱动的基本单位 文件节点          只用来做文件操作 打开设备文件的步骤：           chrdev_open完成的主要工作是：首先根据设备号找到添加在内核中代表字符设备的cdev （cdev是放在cdev_map散列表中的，驱动加载时会构造相应的cdev并添加到这个散列表中，并且在构造这个cdev时还实现了一个操作方法集合，由cdev的ops成员指向它），找到对应的cdev对象后，用cdev关联的操作方法集合替代之前构造的file结构中的操作方法集合，然后调用cdev所关联的操作方法集合中的打开函数，完成设备真正的打开操作，这也标志着do_filp_open函数基本结束。 使用的时候是先用inode找到对应的cdev，然后cdev对象包含对应的操作集file_operations。 并且在以下情况时，驱动程序会根据入口函数 static int cdev_open ( struct inode* inodp, struct file* filp ) 将 和具体设备 相关的 驱动数据 与 file 结构建立关联： 打开代表设备的inode 初始化要作为file来操作的设备 这样 file 结构就包含对驱动操作的 操作集 及 与具体设备挂钩的 驱动私有数据 了，这样就能对 file 进行操作进而 控制相关设备 了。 打开一个 cdev 的步骤： 打开对应 inode 通过 indoe 找到对应 cdev 将与 cdev 相关的 设备数据 及 驱动操作集 与 要作为文件操作的代表驱动的 file 结构 相挂钩 2.IOCTL ioctl 命令编码规则 31 30 ----------(2 Byte) 00 00     -     命令不带参数 00 01     -     向驱动传递参数，写入 01 00     -     从 驱动获取数据，读出 01 01   ...
Read more »

AUTOSAR_SWS_PWMDriver

图片
AUTOSAR_SWS_ PWM Driver 简介和功能概述 该规范指定了 AUTOSAR 基础软件模块 PWM 驱动程序的功能、 API 和配置。 每个  PWM  通道都链接到微控制器的硬件 PWM 。 PWM  信号的类型（例如居中对齐、左对齐等）未在本规范中定义，而由实现决定。 驱动程序提供微控制器内部  PWM  层（脉冲宽度调制）的初始化和控制功能。 PWM  模块生成具有可变脉冲宽度的脉冲。它允许选择 占空比 和信号 周期 时间。 首字母缩略词和缩写 具有本地范围的首字母缩略词和缩写词不包含在 AUTOSAR 词汇表中。这些必须出现在本地词汇表中。 约束和假设 限制 [ SWS _ Pwm _00001] [ SRS _ Pwm _12386] PWM SWS 不涵盖通用 I/O 上的 PWM 仿真。 仅当 MCAL 驱动程序拥有完整的底层硬件外设（即，其他 MCAL 模块无法访问硬件外设）时，才可实现电源状态控制 API 。 对其他模块的依赖 PWM  依赖于系统 时钟 。因此，系统 时钟 的变化（例如 PLL 开启 -> PLL 关闭）也会影响 PWM 硬件的 时钟 设置。 PWM  驱动器依赖于以下模块： Port 驱动程序： 设置端口 引脚 功能。（PWM141） MCU 驱动程序： 设置预分频器、系统 时钟 和 PLL 。（PWM142） DET ： 开发模式下的默认 错误 跟踪器。（PWM 143） 文档 087_ AUTOSAR _ ECU _ Configuration 包含第4.6章 时钟 树配置，其中详细介绍了向外围设备传送参考 时钟 信号的机制。 代码文件结构 [ SWS _ Pwm _00065] [SRS _ BSW _00346] [SRS _ BSW _00314] PWM SWS 不应定义代码文件结构。 头文件结构 [ SWS _ Pwm _50075] [ ] Pwm . c 应包括 Pwm . h 、 Det . h 和 。 [ SWS _ Pwm _70075] [ ] Pwm _ Irq . c 应包括 Pwm . h 。 需求可追溯性 功能规格 一般行为 [ SWS _ Pwm _0008...
Read more »

AUTOSAR_SWS_PortDriver

图片
AUTOSAR_SWS_ Port Driver 简介和功能概述 本规范规定了 AUTOSAR  基础软件模块 Port  驱动程序的： 功能 API 配置 本驱动程序规范适用于片上： 端口 端口 引脚 该模块应提供 初始化 微控制器整个  Port  结构的服务。 许多 端口 和端口 引脚 可分配给各种 功能 ，例如： General purpose I/O ADC SPI SCI PWM CAN LIN 其他 因此，应对 端口 结构进行 整体 配置和初始化。 这些端口 引脚 的 配置 和 模式 取决于微控制器和 ECU 。 应尽可能高效地将 端口 初始化数据写入每个 端口 。 Port  驱动程序模块应完成在  Dio 驱动程序模块中使用的 端口 结构的整体配置和初始化。 因此， Dio  驱动程序在由  Port  驱动程序配置的 引脚 和 端口 上工作。 在使用  Dio  功能之前，应初始化  Port  驱动程序。 否则， Dio  功能将表现出 未 定义的行为。 下图标识了  Port  驱动程序功能以及 MCAL 软件层中的  Port  驱动程序和  Dio  驱动程序的结构 [1]。 首字母缩略词和缩写 下表总结了  Port  驱动程序中使用的表达式。 约束和假设 Port  驱动程序的限制如下： 用户有责任确保同一系统中的 不 同实体 不 会并行访问同 一 端口 /端口 引脚 ，例如： 两 个任务配置同 一 端口 。 两 个任务配置同 一 引脚。 两 个任务配置同 一 端口 上的 不 同 引脚 。 对其他模块的依赖 其他驱动程序模块可能依赖于  Port  驱动程序，具体取决于 MCU 上各个端口 引脚 的可用功能。例如， MCU   引脚 可能可配置为  Dio  或 SPI   引脚 。因此， Dio  和/或  SPI  驱动程序模块可能依赖于  Port  模块来配置 引脚 以实现所...
Read more »

AUTOSAR_SWS_ECUStateManager

图片
Specification of ECU State Manager 简介和功能概述 Ecu M  模块（如本文档中所述）是一个基本软件模块（参见  AUTOSAR _ TR _ BSW ModuleList.pdf），用于管理 ECU 状态 的常见方面。具体来说， ECU 管理器 模块： 初始化和取消初始化 OS 、 Sch M 和 Bsw M 以及一些基本软件驱动模块 根据请求将 ECU 配置为 休眠 和 关机 管理 ECU 上的所有 唤醒 事件 ECU 管理器模块提供 唤醒 验证协议来区分 “ 真实 ” 唤醒 事件 “ 不稳定 ” 唤醒 事件 此外： 部分 或 快速 启动 其中 ECU 以有限的功能 启动 。 然后根据应用程序的决定，继续逐步 启动 。 交错 启动 ECU 以最低限度 启动 ，然后 启动   RTE 以尽快执行 软件 组件 中的功能。 然后它继续 启动 其他 BSW 和 软件 组件 ，从而交错 BSW 和应用程序功能。 多个 运行 状态 其中 ECU 具有多个 运行 状态。 除其他外，这改进了从 休眠 状态到 运行 状态的频谱概念。 现在可以有一系列 运行 状态，从 经典 运行 （完全 运行 ）到 最深 的 休眠 （处理器 停止 ）。 多核 ECU 启动 、 关机 、 休眠 和 唤醒 在 ECU 的所有核心上协调。 灵活的 ECU 管理采用以下模块提供的通用模式管理设施： RTE  和  BSW  的调度模块（参见   AUTOSAR _ SWS _ RTE .pdf）现在合并为一个模块： 该模块支持自由配置的  BSW  和应用程序模式以及切换模式功能。 BSW  模式管理器模块（参见   AUTOSAR _ SWS _ BSW ModeManager.pdf）： 该模块实现可配置规则和操作列表，以评估切换  ECU  模式的条件并实施必要的操作。 因此，通过灵活的  ECU   管理 ，大多数  ECU   状态 不再在 ECU 管理器 模块中被实现。通常，只有当通用模式 管理 设施在以下情况下不可用时， ECU 管理器 模块才会接管控制...
Read more »

EB - MCAL - MCU

图片
EB  - MCAL MCU MCU （微控制器单元）模块的 配置 。 General 此选项卡为  MCU  模块的 通用 配置 。 Config   Variant ： VariantPreCompile： 仅 预编译 时配置参数。 只有 一 组参数。 VariantPostBuild： 预编译 和 构建 后 时间配置 参数的混合。 只有 一 组参数。 VariantPostBuildSelectable： 预编译 和 构建 后 时间配置 参数的混合。 更多组参数。 General - McuGeneralConfiguration MCU   通用 配置 的 容器。 DevErrorDetect： 预处理器 开关，用于启用默认 错误 检测并向 Det  报告。 开关 DevErrorDetect 将打开或关闭默认 错误 跟踪器 ( Det ) 检测和通知。 默认 错误 的检测可在 预编译 时配置 (ON/OFF)。 #define MCU_DEV_ERROR_DETECT (STD_ON)/(STD_OFF) 将在 Mcu_Cfg .h 文件中生成。 MultiCoreSupport： 此参数全局使能了支持 多核 的可能性。 如果启用此参数，则至少需要定义一个 EcucPartition （在所有变体中）。 McuGetRamStateAPI： 预处理器 开关用于启用/禁用 API Mcu_GetRamState 。 #define MCU_GET_RAM_STATE_API (STD_ON)/(STD_OFF) 将在 Mcu_Cfg .h 文件中生成。 McuInitClockAPI： 如果将此参数设置为 FALSE ，则必须从 MCU 驱动程序禁用 时钟 初始化。 此概念适用于存在一些 一次性 写入 时钟 寄存器且存在 引导加载 程序的情况。 如果将此参数设置为 TRUE ，则 MCU 驱动程序负责 时钟 初始化。 #define MCU_INIT_CLOCK (STD_ON)/(STD_OFF) 将在 Mcu_Cfg .h 文件中生成。 McuNoPLL： 如果 H/W 没有 PLL 或 PLL 电路在开机后无需 S/W 干预即可启用，则此参数应设置为 True 。 在这种情...
Read more »

AUTOSAR_SWS_ICUDriver

图片
AUTOSAR_SWS_ ICU Driver 简介和功能概述 本规范规定了 AUTOSAR 基础软件模块 ICU 驱动程序的功能、 API 和配置。 ICU  驱动程序是一个使用输入捕获单元 ( ICU ) 来解调 PWM 信号、计数脉冲、测量频率和占空比、生成简单中断以及唤醒中断的模块。 ICU  驱动程序提供的服务： 信号 边缘 通知 控制唤醒中断 周期 性信号时间测量 边缘 时间戳，可用于获取非 周期 性信号 边缘 计数 首字母缩略词和缩写 对其他模块的依赖 模块 DET （默认 错误 追踪器） 检测到的 错误 的详细描述可以在第 7.2 章和第 8 章中找到。 模块 MCU ICU 驱动程序依赖于系统 时钟 、预分频器和 PLL 。因此， ICU 定时器刻度的长度取决于模块 MCU 中的 时钟 设置。 ICU 驱动程序不会负责在其 Init 函数中设置配置全局 时钟 、全局 预分频 器和 PLL 的寄存器。这必须由 MCU 模块完成。 ICU 驱动程序仅配置本地（ ICU 外设特定的）时钟、 预分频 器等。 OS （操作系统） ICU 驱动程序使用 中断 ，因此依赖于配置 中断 源的操作系统。它仅提供回调函数。 ICU 驱动程序不会在其 Init 函数中设置 中断 关联的寄存器。 中断 系统的整体分配和激活由操作系统完成。 模块 Port Port 驱动程序负责配置 ICU 用作输入的端口 引脚 。因此，在使用 ICU 功能之前必须初始化  Port  驱动程序。否则 ICU 功能将表现出未定义的行为。 模块 EcuM [ SWS _ Icu _00244] [ ] ICU 驱动程序将向 EcuM 报告唤醒中断。 需求可追溯性 功能规格 背景与理由 为了确保数据一致性，应提供可重入代码。 需求 [ SWS _ Icu _00050] [ ] 不同通道号的  ICU  模块功能应可重入，但以下情况除外： Icu _ Init () Icu _ De Init () Icu _Set Mode () Icu _Get Version Info () [ SWS _ Icu _00149] [ ] 如果在运行时在 不 同的任务或 ISR 中使用了对同一 ICU...
Read more »

EB - MCAL - PWM

图片
EB  - MCAL PWM PWM （脉冲宽度调制）模块的配置。 General 此选项卡为  PWM （脉冲宽度调制）模块的 通用 配置 。 Config Variant： VariantPreCompile：仅 预编译 时配置参数。只有一组参数。 VariantPostBuild：混合 预编译 和 构建后 配置参数。只有一组参数。 General - PwmConfigurationOfOptApiServices PwmConfigurationOfOptApiServices 容器用于存储所有可选 API 的配置。 PwmDeInitApi： 从代码中添加/删除服务 Pwm_DeInit ()。 PwmGetOutputState： 从代码中添加/删除服务 Pwm_GetOutputState ()。 PwmSetDutyCycle： 从代码中添加/删除服务 Pwm_SetDutyCycle ()。 PwmSetOutputToIdle： 从代码中添加/删除服务 Pwm_SetOutputToIdle ()。 PwmSetPeriodAndDuty： 从代码中添加/删除服务 Pwm_SetPeriodAndDuty ()。 PwmVersionInfoApi： 勾选以指示支持  Pwm_GetVersionInfo 。 PwmGetChannelStateApi： 勾选以指示支持  Pwm_GetChannelState 。 PwmEnableTriggerOut： 从代码中添加/删除服务： Pwm_EnableTriggerOut () Pwm_EnableTriggerOut () General - PwmGeneral PwmGeneral 容器用于存储  PWM  的通用配置。 Pwm Multi-Core Enable： 切换启用/禁用 多核 功能。 启用该功能时，需要在 PwmChannelEcucPartitionRef 容器中配置至少一个  ECUC  分区，并且  PwmChannel  容器中的每个  PWM  通道也需要配置至少 一 个  ECUC  分区。 PwmDev...
Read more »