Port
1. 简介和功能概述¶
本规范规定了AUTOSAR基础软件模块PORT驱动程序的功能、API和配置。
本驱动程序规范适用于片上端口和端口引脚。
本模块应提供初始化微控制器整个PORT结构的服务。许多端口和端口引脚可以被分配给各种功能，例如：
- 通用I/O
- ADC
- SPI
- SCI
- PWM
- CAN
- LIN
- 等等
因此，应对此端口结构进行整体配置和初始化。这些端口引脚的配置和模式取决于微控制器和ECU。
端口初始化数据应尽可能高效地写入每个端口。
本PORT驱动程序模块应完成DIO驱动程序模块中使用的端口结构的整体配置和初始化。因此，DIO驱动程序作用于由PORT驱动程序配置的引脚和端口。
PORT驱动程序应在使用DIO函数之前初始化。否则DIO函数将表现出未定义的行为。
下图标识了PORT驱动程序的功能，以及PORT驱动程序和DIO驱动程序在MCAL软件层中的结构[1]。
| 驱动程序 | 端口引脚的名称 | 同一端口上相邻引脚子集的名称 | 整个端口的名称 |
|---|---|---|---|
| DIO 驱动 | 通道 | 通道组 | 端口 |
| PORT 驱动 | 端口引脚 | - | 端口 |
2. 缩略语¶
以下总结了PORT驱动程序中使用的表述。
DEM
诊断事件管理器（Diagnostic Event Manager）
DET
默认错误跟踪器（Default Error Tracer）
MCU
微控制器单元（MicroController Unit）
Port Pin
表示MCU器件上单个可配置的输入或输出引脚。
Port
表示MCU器件上整个可配置的端口。
Physical Level (Input)
两种可能的状态：LOW/HIGH
Physical Level (Output)
两种可能的状态：LOW/HIGH
3. 相关文档¶
3.1. 输入文件¶
[1] Layered Software Architecture AUTOSAR_CP_EXP_LayeredSoftwareArchitecture
[2] Specification of Diagnostic Event Manager AUTOSAR_CP_SWS_DiagnosticEventManager
[3] Specification of Default Error Tracer AUTOSAR_CP_SWS_DefaultErrorTracer
[4] General Specification of Basic Software Modules AUTOSAR_CP_SWS_BSWGeneral
[5] General Requirements on Basic Software Modules AUTOSAR_CP_SRS_BSWGeneral
[6] General Requirements on SPAL AUTOSAR_CP_SRS_SPALGeneral
[7] Requirements on Port Driver AUTOSAR_CP_SRS_PortDriver
[8] Specification of MCU Driver AUTOSAR_CP_SWS_MCUDriver
3.2. 相关标准和规范¶
- IEC 7498-1 The Basic Model, IEC Norm, 1994
3.3. 相关规范¶
AUTOSAR提供了基础软件模块通用规范[4]（SWS BSW General），该规范同样适用于Port驱动程序。
因此，SWS BSW General规范应被视为Port驱动程序的附加必需规范。
4. 约束和假设¶
4.1. 限制¶
PORT驱动程序的限制规定如下：
- 用户有责任确保同一系统中不同的实体不会并行访问同一端口/端口引脚，例如两个任务配置同一端口、两个任务配置同一引脚，或两个任务配置同一端口上的不同引脚。
4.2. 汽车域的适用性¶
无限制
5. 对其他模块的依赖¶
其他驱动模块可能依赖于PORT驱动程序，具体取决于MCU上单个端口引脚的可用功能。例如，一个MCU引脚可能可配置为DIO或SPI引脚。因此，DIO和/或SPI驱动模块可能依赖PORT模块将引脚配置为所需的功能。
5.1. 文件结构¶
5.1.1. 代码文件结构¶
详情请参阅[4]中第 5.1.6 章"Code file structure"。
6. 功能规格¶
6.1. 一般行为¶
6.1.1. 背景与原理¶
PORT驱动程序模块应初始化微控制器的整个端口结构。
注意：定义端口和端口引脚的配置顺序是配置工具的任务。
6.1.2. 需求¶
6.1.2.1. 端口引脚属性的配置¶
PORT驱动程序模块应允许为每个端口和端口引脚配置不同的功能，例如ADC、SPI、DIO等。
端口（即整个端口或单个端口引脚）的配置取决于微控制器。
PORT驱动程序模块应为MCU端口/端口引脚提供以下附加配置：
- 引脚方向（输入/输出）
- 引脚电平初始值
- 引脚方向是否可在运行时更改（是/否）。
- 端口模式是否可在运行时更改。
PORT驱动程序模块应为MCU端口和端口引脚提供一些可选配置（如果硬件支持）：
- 斜率（Slew rate）控制
- 内部上拉的激活
- 输入阈值
- 引脚驱动模式（推挽/开漏）。
- 回读支持的类型（引脚电平、输出寄存器值）。
PORT驱动程序模块不应提供配置引脚电平反转的功能。应设置默认值（即不反转）。
注意：I/O硬件抽象层应执行电平反转。
6.1.2.2. 切换端口引脚方向¶
对于使用配置工具配置为可更改的端口引脚，PORT驱动程序应允许用户在运行时更改端口引脚的方向。
如果MCU端口控制硬件提供用于在端口引脚上设置输出电平的输出锁存器，切换端口引脚方向不应改变此输出锁存器中设置的电平。
6.1.2.3. 刷新端口方向¶
为了在微控制器上刷新端口，PORT驱动程序应允许用户刷新那些方向由配置设置且不能动态更改的端口引脚的方向。
6.1.2.4. 未使用的端口和端口引脚的配置¶
PORT驱动程序模块应将所有未使用（既不用作GPIO也不用作特殊用途IO）的端口和端口引脚配置为由PORT驱动程序模块配置设置为确定的状态。
6.1.2.5. 符号名称的配置¶
PORT驱动程序模块的用户应配置MCU端口引脚的符号名称。
单个端口引脚的这些符号名称（例如PORT_A_PIN_0）应在配置工具中定义。
PORT驱动程序模块的实现者应通过文件Port.h发布这些符号名称。
6.1.2.6. 端口访问的原子性¶
PORT驱动程序模块应提供对所有端口和端口引脚的原子访问。
注意：
原子访问是通过使用原子指令或使用由基础软件调度程序模块提供的独占区域（例如禁用中断）对微控制器寄存器的不可中断访问。
6.1.3. 版本检查¶
6.1.3.1. 背景和原理¶
应避免不兼容文件的集成。最低实现是在.c文件内检查头文件的版本（.c和.h文件的版本号应相同）。
6.1.3.2. 需求¶
Port模块应通过以下预处理器检查避免不兼容文件的集成：
详情请参阅[4]（SWS BSW General）中第 5.1.8 章"Version Check"。
6.2. 错误分类¶
| 错误类型 | 相关错误代码 | 错误值 |
|---|---|---|
| 请求的端口引脚 ID 无效 | PORT_E_PARAM_PIN | 0x0A |
| 端口引脚未配置为可更改 | PORT_E_DIRECTION_UNCHANGEABLE | 0x0B |
| API Port_Init服务以错误参数调用 | PORT_E_INIT_FAILED | 0x0C |
| 当模式不可更改时调用API Port_SetPinMode服务 | PORT_E_PARAM_INVALID_MODE | 0x0D |
| 当模式不可更改时调用API Port_SetPinMode服务 | PORT_E_MODE_UNCHANGEABLE | 0x0E |
| 未经模块初始化调用API服务 | PORT_E_UNINIT | 0x0F |
| 以空指针调用API | PORT_E_PARAM_POINTER | 0x10 |
6.2.1. 运行时错误¶
没有运行时错误。
6.2.2. 瞬态故障¶
没有瞬态故障。
6.2.3. 生产错误¶
没有生产错误。
6.2.4. 扩展生产错误¶
没有扩展生产错误。
6.3. API 参数检查¶
如果启用了开发错误检测，Port驱动程序模块应按参数传递的顺序检查函数参数，如果一项检查失败则跳过后续的参数检查。
示例：对于函数Port_SetPinDirection，传递的第一个参数是引脚ID。此参数应标识MCU端口的相关端口引脚。传递的第二个参数对应于要在端口引脚上更改的方向。
如果启用了开发错误检测且Port驱动程序模块检测到错误，应跳过所需功能，请求的服务应直接返回，不执行任何动作。
参见下表，了解每个函数报告的Det错误列表。
| 函数 | 错误条件 | 相关错误值 |
|---|---|---|
| Port_SetPinDirection | 传入的端口引脚 ID 不正确 | PORT_E_PARAM_PIN |
| Port_SetPinDirection | 端口引脚未配置为可更改 | PORT_E_DIRECTION_UNCHANGEABLE |
| Port_Init | Port_Init 服务以错误参数调用。 | PORT_E_INIT_FAILED |
| Port_SetPinMode | 传入的端口引脚 ID 不正确 | PORT_E_PARAM_PIN |
| Port_SetPinMode | 传入的端口引脚模式无效 | PORT_E_PARAM_INVALID_MODE |
| Port_SetPinMode | 当模式不可更改时调用Port_SetPinMode服务 | PORT_E_MODE_UNCHANGEABLE |
| Port_SetPinDirection, Port_SetPinMode, Port_RefreshPortDirection | 在模块初始化之前调用API服务 | PORT_E_UNINIT |
| Port_GetVersionInfo | 以空指针参数调用API | PORT_E_PARAM_POINTER |
7. API规范¶
7.1. 导入的类型¶
本章列出了从以下模块包含的所有类型：
Port模块的导入数据类型定义
| 模块 | 头文件 | 导入的类型 |
|---|---|---|
| Std | Std_Types.h | Std_ReturnType |
| Std | Std_Types.h | Std_VersionInfoType |
7.2. 类型定义¶
7.2.1. Port_ConfigType¶
结构类型。初始化数据结构的内容特定于微控制器。包含本模块初始化数据的外部数据结构的类型。可通过Port.h获得。
7.2.2. Port_PinType¶
类型，派生自 uint。范围为：0 - <端口引脚数量>：应覆盖所有可用的端口引脚。该类型应为特定MCU平台选择（最佳性能）。端口引脚符号名称的数据类型。可通过Port.h获得。
Port_PinType类型应用于端口引脚的符号名称。
Port_PinType类型应为uint8、uint16或uint32，基于特定MCU平台。
注意：用户应使用配置工具提供的符号名称。
7.2.3. Port_PinDirectionType¶
枚举类型，取值范围：
- PORT_PIN_IN（0x00）：将端口引脚设置为输入。
- PORT_PIN_OUT（0x01）：将端口引脚设置为输出。
端口引脚可能的方向。可通过Port.h获得。
Port_PinDirectionType是定义端口引脚方向的类型。
Port_PinDirectionType应为枚举类型，其范围为PORT_PIN_IN和PORT_PIN_OUT。
7.2.4. Port_PinModeType¶
类型，派生自 uint。范围为：实现特定 —— 由于一个引脚上应可配置多个端口引脚模式，范围应由实现确定。不同的端口引脚模式。可通过Port.h获得。
端口引脚应可配置多个端口引脚模式（Port_PinModeType类型）。
Port_PinModeType类型应与函数调用Port_SetPinMode一起使用。
Port_PinModeType类型应为uint8、uint16或uint32。
7.3. 函数定义¶
以下是提供给上层模块的函数列表。
7.3.1. Port_Init¶
说明: 初始化Port驱动程序模块。可通过Port.h获得。本服务为同步调用，不可重入。参数 ConfigPtr（in）：指向配置集的指针。
函数Port_Init应使用参数ConfigPtr指向的配置集初始化所有端口和端口引脚。
Port驱动程序模块的环境应首先调用函数Port_Init以初始化端口供使用。
如果未首先调用Port_Init函数，则无法对MCU端口和端口引脚执行任何操作。
函数Port_Init应初始化所有已配置的资源。
函数Port_Init应遵循以下关于控制器寄存器初始化的规则。
- 如果硬件只允许寄存器的一次使用，则实现该功能的驱动模块负责初始化该寄存器。
- 如果寄存器可以影响多个硬件模块且它是I/O寄存器，则它应由此PORT驱动程序初始化。
- 如果寄存器可以影响多个硬件模块且它不是I/O寄存器，则它应由MCU驱动程序[8]初始化。
- 需要在复位后直接初始化的单次可写寄存器应由启动代码初始化。
- 所有其他未提及的寄存器应由启动代码初始化。
函数Port_Init应避免在受影响的端口引脚上产生毛刺和尖峰。
Port驱动程序模块的环境应在复位后调用函数Port_Init，以重新配置MCU的端口和端口引脚。
函数Port_Init应将PORT驱动程序模块使用的所有变量初始化为初始状态。
Port驱动程序模块的环境也可以使用函数Port_Init来初始化驱动程序软件，并根据传递给此函数的配置集将端口和端口引脚重新初始化为另一个已配置状态。
注意：在某些情况下，MCU端口控制硬件提供输出锁存器，用于在可用作DIO端口引脚的端口引脚上设置输出电平。
函数Port_Init应在将端口引脚方向设置为输出之前，将端口引脚输出锁存器设置为默认电平（在配置期间定义）。
应确保当端口引脚被设置为输出端口引脚时，默认电平立即输出到端口引脚上。
示例：在某些MCU上，上电复位后，可配置为DIO的端口引脚将被配置为输入引脚。如果端口引脚所需的配置是输出引脚，则函数Port_Init应确保在将端口引脚功能从输入切换到输出之前设置默认电平。
函数Port_Init应始终具有一个指针作为参数，即使对于配置变体VARIANT-PRE-COMPILE，也不会给出配置集。在这种情况下，Port驱动程序模块的环境应向函数Port_Init传递NULL指针。
Port驱动程序模块的环境不应在运行操作期间调用函数Port_Init。这仅在PORT模块有多个调用者时适用。
Port_Init的配置：所有端口引脚及其功能、以及备用功能都应由配置工具配置。
7.3.2. Port_SetPinDirection¶
说明: 设置端口引脚方向。可通过Port.h获得。本服务为同步调用，可重入。参数 Pin（in）：端口引脚 ID 编号。参数 Direction（in）：端口引脚方向。
函数Port_SetPinDirection应在运行时设置端口引脚方向。
如果访问独立于端口的不同引脚，函数Port_SetPinDirection应是可重入的。
只有当预编译参数PortSetPinDirectionApi设置为TRUE时，函数Port_SetPinDirection才可提供给用户使用。如果设置为FALSE，则函数Port_SetPinDirection不可用。
Port_SetPinDirection的配置：所有端口和端口引脚应由配置工具配置。参见PORT117。
7.3.3. Port_RefreshPortDirection¶
说明: 刷新端口方向。可通过Port.h获得。本服务为同步调用，不可重入。
函数Port_RefreshPortDirection应将所有已配置端口的方向刷新为配置的方向（PortPinDirection）。
函数Port_RefreshPortDirection应将那些配置为"引脚方向可在运行时更改"的端口引脚排除在刷新之外。
配置工具应为每个配置的端口引脚提供名称。
7.3.4. Port_GetVersionInfo¶
说明: 返回本模块的版本信息。可通过Port.h获得。本服务为同步调用，可重入。参数 versioninfo（out）：指向存储本模块版本信息位置的指针。
如果启用了Det，应检查参数versioninfo是否为NULL。如果值为NULL指针，应报告错误PORT_E_PARAM_POINTER。
7.3.5. Port_SetPinMode¶
说明: 设置端口引脚模式。可通过Port.h获得。本服务为同步调用，可重入。参数 Pin（in）：端口引脚 ID 编号。参数 Mode（in）：要在端口引脚上设置的新端口引脚模式。
函数Port_SetPinMode应在运行时设置引用引脚的端口引脚模式。
如果访问独立于端口的不同引脚，函数Port_SetPinMode应是可重入的。
如果启用了Det，当参数PortPinModeChangeable设置为FALSE时，函数Port_SetPinMode应报告PORT_E_MODE_UNCHANGEABLE错误并直接返回，不执行任何其他动作。
Port_SetPinMode的配置：所有端口和端口引脚应由配置工具配置。参见PORT117。
7.4. 回调通知¶
PORT驱动程序没有回调通知。回调通知在其他模块（ICU驱动程序和/或复杂驱动程序）中实现。
7.5. 调度函数¶
PORT驱动程序中没有调度函数。
7.6. 期望接口¶
本章列出了需要从其他模块获得的所有接口。
7.6.1. 可选接口¶
本章定义了为实现模块的可选功能而需要的所有接口。
| API 函数 | 头文件 | 描述 |
|---|---|---|
| Det_ReportError | Det.h | 报告开发错误的服务 |
8. 配置规范¶
总体而言，本章定义配置参数及其到容器（container）的聚类组织。为支持本规范，第 8.1 章描述相关基础知识，并规定参数规范所应使用的模板（表格）。我们有意将第 8.1 章保留在规范中，以保证可理解性。
第 8.2 章规定 PORT 模块的结构（容器）与参数。
第 8.4 章规定 PORT 模块的发布信息。
8.1. 如何阅读本章¶
详情请参阅 [4] 中的第 10.1 章 "Introduction to configuration specification"（配置规范导论）。
8.2. 容器与配置参数¶
以下各节汇总所有配置参数。各参数的详细含义见第 6 章和第 7 章。
PORT 模块应拒绝实现所不支持的、带有分区映射的配置。
8.2.1. PortConfigSet¶
| SWS 条目 | |
|---|---|
| 容器名称 | PortConfigSet |
| 父容器 | Port |
| 描述 | 此容器包含 AUTOSAR Port 模块的配置参数与子容器。 |
| 配置参数 | 见下方参数表 |
| 容器名称 | 多重性 | 作用域/依赖 |
|---|---|---|
| PortContainer | 1..* | 收集 PortPin 的容器。 |
8.2.2. Port¶
| SWS 条目 | |
|---|---|
| 模块名称 | Port |
| 描述 | Port 模块的配置。 |
| Post-Build 变体支持 | true |
| 支持的配置变体 | VARIANT-POST-BUILD, VARIANT-PRE-COMPILE |
| 容器名称 | 多重性 | 作用域/依赖 |
|---|---|---|
| PortConfigSet | 1 | 此容器包含 AUTOSAR Port 模块的配置参数与子容器。 |
| PortGeneral | 1 | PORT 驱动的模块级配置参数。 |
8.2.3. PortContainer¶
| SWS 条目 | |
|---|---|
| 容器名称 | PortContainer |
| 父容器 | PortConfigSet |
| 描述 | 收集 PortPin 的容器。 |
| 配置参数 | 见下方参数表 |
| SWS 条目 | |
|---|---|
| 参数名称 | PortNumberOfPortPins |
| 父容器 | PortContainer |
| 描述 | 所指定 PortPin 的数量。 |
| 多重性 | 1 |
| 类型 | EcucIntegerParamDef |
| 范围 | 1 .. 65535 |
| 默认值 | - |
| Post-Build 变体值 | false |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 容器名称 | 多重性 |
|---|---|
| PortPin | 1..* |
8.2.4. PortGeneral¶
| SWS 条目 | |
|---|---|
| 容器名称 | PortGeneral |
| 父容器 | Port |
| 描述 | PORT 驱动的模块级配置参数。 |
| 配置参数 | 见下方参数表 |
| SWS 条目 | |
|---|---|
| 参数名称 | PortDevErrorDetect |
| 父容器 | PortGeneral |
| 描述 | 开启或关闭开发错误检测与通知（true：启用检测与通知；false：禁用检测与通知）。 |
| 多重性 | 1 |
| 类型 | EcucBooleanParamDef |
| 默认值 | false |
| Post-Build 变体值 | false |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortSetPinDirectionApi |
| 父容器 | PortGeneral |
| 描述 | 启用/禁用 Port_SetPinDirection() 函数的预处理器开关（TRUE：启用 —— Port_SetPinDirection() 函数可用；FALSE：禁用 —— Port_SetPinDirection() 函数不可用）。 |
| 多重性 | 1 |
| 类型 | EcucBooleanParamDef |
| 默认值 | - |
| Post-Build 变体值 | false |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortSetPinModeApi |
| 父容器 | PortGeneral |
| 描述 | 启用/禁用 Port_SetPinMode() 函数的预处理器开关（true：启用 —— Port_SetPinMode() 函数可用；false：禁用 —— Port_SetPinMode() 函数不可用）。 |
| 多重性 | 1 |
| 类型 | EcucBooleanParamDef |
| 默认值 | - |
| Post-Build 变体值 | false |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortVersionInfoApi |
| 父容器 | PortGeneral |
| 描述 | 启用/禁用读取模块版本信息的 API 的预处理器开关（true：版本信息 API 启用；false：版本信息 API 禁用）。 |
| 多重性 | 1 |
| 类型 | EcucBooleanParamDef |
| 默认值 | false |
| Post-Build 变体值 | false |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortEcucPartitionRef |
| 父容器 | PortGeneral |
| 描述 | 将 Port 驱动映射到零个或多个 ECUC 分区，以使模块 API 在该分区中可用。 |
| 多重性 | 0..* |
| 类型 | 对 EcucPartition 的引用 |
| Post-Build 变体多重性 | true |
| Post-Build 变体值 | true |
| 多重性配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: ECU |
无包含的容器。
顶层 Port 驱动容器包含适用于 PORT 配置的参数。
8.2.5. PortPin¶
| SWS 条目 | |
|---|---|
| 容器名称 | PortPin |
| 父容器 | PortContainer |
| 描述 | 单个端口引脚的配置。 |
| 配置参数 | 见下方参数表 |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinDirection |
| 父容器 | PortPin |
| 描述 | 引脚的初始方向（IN 或 OUT）。如果方向不可更改，则此处配置的值是固定的。方向必须与引脚模式匹配。例如：ADC 使用的引脚必须配置为输入端口。实现类型：Port_PinDirectionType。 |
| 多重性 | 1 |
| 类型 | EcucEnumerationParamDef |
| 范围 | PORT_PIN_IN（端口引脚方向设为输入）；PORT_PIN_OUT（端口引脚方向设为输出） |
| Post-Build 变体值 | true |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：x |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinDirectionChangeable |
| 父容器 | PortPin |
| 描述 | 指示端口引脚的方向在运行期间是否可更改的参数（true：启用端口引脚方向可更改；false：禁用端口引脚方向可更改）。 |
| 多重性 | 1 |
| 类型 | EcucBooleanParamDef |
| 默认值 | - |
| Post-Build 变体值 | true |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinId |
| 父容器 | PortPin |
| 描述 | 端口引脚容器所属端口的引脚 ID。 |
| 多重性 | 1 |
| 类型 | EcucIntegerParamDef |
| 范围 | 1 .. 65535 |
| 默认值 | - |
| Post-Build 变体值 | false |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinInitialMode |
| 父容器 | PortPin |
| 描述 | 供 Port_Init() 函数使用的、模式列表中的端口引脚模式。 |
| 多重性 | 1 |
| 类型 | EcucEnumerationParamDef |
| 范围 | PORT_PIN_MODE_ADC（ADC 使用的端口引脚）；PORT_PIN_MODE_CAN（CAN 使用的端口引脚）；PORT_PIN_MODE_DIO（配置为 DIO 的端口引脚，应在 DIO 驱动的控制下使用）；PORT_PIN_MODE_DIO_GPT（配置为 DIO 的端口引脚，应在通用定时器驱动的控制下使用）；PORT_PIN_MODE_DIO_WDG（配置为 DIO 的端口引脚，应在看门狗驱动的控制下使用）；PORT_PIN_MODE_FLEXRAY（FlexRay 使用的端口引脚）；PORT_PIN_MODE_ICU（ICU 使用的端口引脚）；PORT_PIN_MODE_LIN（LIN 使用的端口引脚）；PORT_PIN_MODE_MEM（在存储驱动控制下用于外部存储器的端口引脚）；PORT_PIN_MODE_PWM（PWM 使用的端口引脚）；PORT_PIN_MODE_SPI（SPI 使用的端口引脚） |
| Post-Build 变体值 | true |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：x |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinLevelValue |
| 父容器 | PortPin |
| 描述 | 端口引脚列表中的端口引脚电平值。 |
| 多重性 | 1 |
| 类型 | EcucEnumerationParamDef |
| 范围 | PORT_PIN_LEVEL_HIGH（端口引脚电平为高）；PORT_PIN_LEVEL_LOW（端口引脚电平为低） |
| Post-Build 变体值 | true |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：x |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinMode |
| 父容器 | PortPin |
| 描述 | 模式列表中的端口引脚模式。注意：默认允许多于一个模式，这样例如可以将 DIO 与 ICU 等其他模式组合。 |
| 多重性 | 1..* |
| 类型 | EcucEnumerationParamDef |
| 范围 | PORT_PIN_MODE_ADC（ADC 使用的端口引脚）；PORT_PIN_MODE_CAN（CAN 使用的端口引脚）；PORT_PIN_MODE_DIO（配置为 DIO 的端口引脚，应在 DIO 驱动的控制下使用）；PORT_PIN_MODE_DIO_GPT（配置为 DIO 的端口引脚，应在通用定时器驱动的控制下使用）；PORT_PIN_MODE_DIO_WDG（配置为 DIO 的端口引脚，应在看门狗驱动的控制下使用）；PORT_PIN_MODE_FLEXRAY（FlexRay 使用的端口引脚）；PORT_PIN_MODE_ICU（ICU 使用的端口引脚）；PORT_PIN_MODE_LIN（LIN 使用的端口引脚）；PORT_PIN_MODE_MEM（在存储驱动控制下用于外部存储器的端口引脚）；PORT_PIN_MODE_PWM（PWM 使用的端口引脚）；PORT_PIN_MODE_SPI（SPI 使用的端口引脚） |
| Post-Build 变体多重性 | true |
| Post-Build 变体值 | true |
| 多重性配置类 | Pre-compile time：x；Link time：-；Post-build time：x |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：x |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinModeChangeable |
| 父容器 | PortPin |
| 描述 | 指示端口引脚的模式在运行期间是否可更改的参数（True：允许端口引脚模式可更改；False：不允许端口引脚模式可更改）。 |
| 多重性 | 1 |
| 类型 | EcucBooleanParamDef |
| 默认值 | - |
| Post-Build 变体值 | true |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: local |
| SWS 条目 | |
|---|---|
| 参数名称 | PortPinEcucPartitionRef |
| 父容器 | PortPin |
| 描述 | 将 Port 引脚映射到零个或多个 ECUC 分区。所引用的 ECUC 分区是 Port 驱动所映射到的 ECUC 分区的子集。 |
| 多重性 | 0..* |
| 类型 | 对 EcucPartition 的引用 |
| Post-Build 变体多重性 | true |
| Post-Build 变体值 | true |
| 多重性配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 值配置类 | Pre-compile time：x；Link time：-；Post-build time：- |
| 作用域/依赖 | scope: ECU |
8.3. 约束¶
PortPinEcucPartitionRef 所引用的 ECUC 分区应是 PortEcucPartitionRef 所引用的 ECUC 分区的子集。
若 PortEcucPartitionRef 引用一个或多个 ECUC 分区，则 PortPinEcucPartitionRef 的多重性应大于零，并且也应引用这些 ECUC 分区中的一个或多个。
8.4. 发布信息¶
详情请参阅 [4] 中的第 10.3 章 "Published Information"（发布信息）。
微信扫一扫，获取更多及时资讯
