Port 配置使用说明

ChipON AE大约 5 分钟约 1465 字2025/8/11配置工具

Port 配置使用说明

简介

本手册详细介绍了如何使用灵犀配置KF32A158SQV芯片的Port模块。

环境准备

确保已安装以下软件：

灵犀（版本需支持KF32A158SQV芯片）
支持KF32A158SQV芯片的MCAL（Microcontroller Abstraction Layer）软件包

创建项目

打开灵犀。
点击主界面上的“新建项目”按钮，如图所示

选择MCU型号

在“MCU型号选择”窗口中，选择“MCAL”项目类型。
在“快速选择MCU”下拉菜单中，选择“KF32A158SQV”。
点击“创建”按钮，如图所示

添加PORT模块

在灵犀主界面，点击左侧的“》”按钮打开模块添加界面，如图所示
在灵犀主界面，点击“Apply Module”按钮。
在“Module Manager”窗口中，从“unUsed”列表中选择“Port”模块。
点击中间的“>”按钮，将“Port”模块移动到“used”列表中。
点击“Apply”按钮，完成模块添加，如图所示

配置PORT模块

配置PortGeneral

在左侧树状结构中，展开“Port”并选择“PortGeneral”。
配置以下参数：（示例配置仅供参考，根据实际使用修改）
- PortDevErrorDetect: Detect开关，默认为关闭，如果用户需要使用Detect功能，需要将此参数设置为true。
- PortSetPinDirectionApi：设置PIN方向函数Port_SetPinDirection开关。
- PortSetPinModeApi：设置PIN模式函数Port_SetPinMode开关。
- PortVersionInfoApi：获取版本信息函数Port_GetVersionInfo开关。
- PortPrecompileSupport：是否启用预编译支持。设置为true表示启用，调用初始化函数，入参应为空指针；为false表示不启用，调用初始化函数，入参为配置参数地址。
- PortEcucPartitionRef：将端口驱动程序映射到零个多个ECUC分区，以使模块的API在此分区中可用。暂不支持

配置PortConfigSet

PORT模块的配置参数，配置PIN端口具体信息，每个PortContainer包含一组PORT，配置下面需要的PIN信息。
增加PORT

PortNumberOfPortPins：本组信息中含有多少个PIN配置。
PortBase：PORT单元选择。实际可选项取决于芯片。
PortPin：具体PIN信息配置，根据使用情况，增加PIN个数。
- PinIndex：PIN编号选择。
- PinMode：PIN模式选择，模拟功能、GPIO模式、重映射模式。
- PortPinDirection：PIN方向设置，输入或输出；只有选择GPIO模式时，才需要配置此参数。
- PortPinDirectionChangeable：PIN方向可改变选择。配置为false时，函数Port_RefreshPortDirection才可使用；配置为true时，函数Port_SetPinDirection才可用。
- PortPinId：端口引脚的Pin Id。此值将被分配给从端口引脚容器短名称派生的符号名称，一般无需手动修改。
- PortPinInitialMode：端口引脚模式。暂不支持
- PortPinLevelValue：输出高低状态，只有选择GPIO模式起作用。
- PortPinModeChangeable：端口引脚模式是否可变；需要打开PortSetPinModeApi时才可配置。
- PinsControl：PIN具体信息配置
  - Remap：引脚配置为重映射模式时，选择具体的功能配置。具体参见数据手册IO相关章节
  - PullStatus：引脚上拉状态。
  - OpenDrain：开漏模式或推挽模式。（如I2C引脚配置为开漏模式）
  - SlewRate：端口输出速度，慢速模式10MHz，快速模式20MHz。
    引脚重映射功能：（仅适用于KF32A158SQV）
    在使用的时候，根据表格选择对应的功能后，就可知道对应的Group、Port
    
    根据数据手册，选择有FlexRM功能的引脚，查看对应的通道；通道信息，只有选择0-15，不能重复使用通道。同时需要配置对应的AF功能。
  - FlexRmGroup：Group分组，0-15。
  - FlexRmPort：Port分组，0-15。
  - FlexRmChannel：Channel分组，0-15。
  - FlexRmMode：输入或输出或输入输出功能。
  - FlexRmEnable：该PIN是否启用FlexRM功能。
- PortPinMode：端口引脚模式。暂不支持
- PortPinEcucPartitionRef：引脚所属分区。暂不支持