MCAL配置-PORT（EB23.0）

PORT配置项的介绍

一、General

1、PortDevErrorDetect 

启用/禁用开发错误检测的检测和报告。

TRUE:启用DET。

FALSE:关闭。

2、PortSetPinDirectionApi

用于启用API Port_SetPinDirection()的预处理器开关，该开关在运行时设置引用引脚的端口引脚方向。

TRUE: Port_SetPinDirection api可用。

FALSE:Port_SetPinDirection api不可用。

注意:默认情况下禁用api以最小化可执行代码大小。

PORT驱动程序提供了在运行时改变引脚方向的API。用户必须在配置工具中为所需引脚启用PortPinDirectionChangeable。只有当PortSetPinDirectionApi开关为ON时，这个api才可用。

3、PortSetPinModeApi

预处理器开关以启用/禁用API Port_SetPinMode()。

TRUE: Port_SetPinMode() api可用。

FALSE:Port_SetPinMode() api不可用。

注意:默认情况下禁用api以最小化可执行代码大小。

4、PortVersionInfoApi

预处理器开关启用/禁用API以读出模块版本信息。

TRUE:启用Port_GetVersionInfo API。

FALSE:关闭Port_GetVersionInfo API。

注意:默认情况下禁用API以最小化可执行代码大小。

5、PortInitApiMode

指定初始化API将在其中操作的特权模式。

注意:驱动程序访问的是SFRs，在supervisor模式下操作PORT驱动程序效率更高。

因此，默认的操作模式是supervisor。

6、PortSafetyEnable

指定是否启用或禁用安全标准强制的安全检查。

TRUE:启用安全检查。

FALSE:禁用安全检查。

注意:默认情况下启用安全相关错误的检测，以确保在产品生命周期内解决安全问题。

7、PortInitCheckApi 

启用/禁用 Port_InitCheck API。

TRUE:启用PortInitCheckApi api。

FALSE:禁用PortInitCheckApi api。

注意:默认情况下启用安全相关错误的检测，以确保在产品生命周期内解决安全问题。

二、PortContainer

1、PortPinId

2、PortPinSymbolicName

该参数是正在考虑的端口引脚的用户定义名称。

PORT 驱动模块的用户可以使用枚举器来标识PORT - pin对，而不是使用绝对数字。

3、PortPinDirection

指定端口引脚的方向。

备注:模拟输入端口不支持此配置。

备注:该参数的默认值为对应SFR的重置值。

4、PortPinDirectionChangeable

指定是否可以在运行时更改当前端口引脚的引脚方向。

此参数的配置对模拟或数字输入端口无效。

注意:默认情况下禁用可选功能以最小化可执行代码大小。

5、PortPinInitialMode

该参数允许配置工作模式，即每个引脚的不同备用功能。所选的工作模式在初始化期间被编程到寄存器中。

注意:仅当端口引脚方向设置为PORT_PIN_OUT时可编辑。

注意:portpininitialmode的工具提示给出了所有可用ALT模式的列表。

备注:该参数的默认值为对应SFR的重置值。

6、PortPinLevelValue 

该参数用于为每个引脚配置初始引脚级别。该电平在端口驱动程序初始化期间被设置为端口引脚的输出锁存，与引脚配置的方向无关。

注:对于模拟或数字输入端口，此参数配置无效。

备注:该参数的默认值为对应SFR的重置值。

7、PortPinModeChangeable

该参数允许配置是否允许在运行时更改端口引脚的模式，此参数的配置对模拟或数字输入端口无效。

FALSE:所选引脚的运行时模式不可更改。

TRUE:模式在运行时可更改所选引脚。

注意:默认情况下禁用可选功能以最小化可执行代码大小。

8、PortPinInputPullResistor

该参数允许为所选端口引脚配置内部拉电阻[上/下]。

备注:该参数的默认值为对应SFR的重置值。

9、PortPinOutputPadDriveStrength

此参数配置每个引脚的输出驱动强度和转换率。

备注:该参数的默认值为对应SFR的重置值。

PORT_PIN_DEFAULT_DRIVER:默认的驱动强度。

PORT_PIN_MEDIUM_DRIVER:中等驱动强度，适用于RFast、Fast和Slow pad。

PORT_PIN_MEDIUM_DRIVER_SHARP_EDGE:中等驱动强度，边缘锋利，仅适用于Slow pad。PORT_PIN_RGMII_DRIVER: RGMII驱动，仅适用于RFast pad

PORT_PIN_STRONG_DRIVER_MEDIUM_EDGE:该选项可用于RFast和Fast pad。PORT_PIN_STRONG_DRIVER_SHARP_EDGE:驱动器强度强，边缘锋利，适用于RFast和Fast pad。

10、PortPinOutputPinDriveMode 

该参数允许在开漏或推挽之间配置。

备注:该参数的默认值为对应SFR的重置值。

11、PortPinInputPadLevel

该参数允许配置所选端口引脚的电压水平。

备注:该参数的默认值为对应SFR的重置值。

12、PortPinEnableAnalogInputOnly

某些数字端口额外支持模拟输入功能。为了使用pad进行模拟输入，可以完全禁用pad的数字功能。

备注:该参数的默认值为对应SFR的重置值。

13、PortPinEmergencyStop

启用此功能后，当遇到紧急情况时，配置为输出引脚的引脚将自动重新配置为输入。

FALSE:关闭所选引脚的紧急停止功能。

TRUE:启用所选引脚的紧急停止功能。

备注:该参数的默认值为对应SFR的重置值。

14、PortPinControllerSelect

该参数启用/禁用SCR是否控制端口引脚配置和数据。

备注:该参数的默认值为对应SFR的重置值。