Dio 配置使用说明

简介

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

---

环境准备

确保已安装以下软件：

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

---

创建项目

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

---

选择MCU型号

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

---

添加DIO模块

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

---

配置DIO模块

配置DioGeneral

1. 在左侧树状结构中，展开“Dio”并选择“DioGeneral”。
2. 配置以下参数：(示例配置仅供参考，根据实际使用修改)
   • DioDevErrorDetect: Detect开关，默认为关闭，如果用户需要使用Detect功能，需要将此参数设置为true
   • DioFlipChannelApi：翻转通道函数Dio_FlipChannel开关
   • DioMaskedWritePortApi：掩码写入端口函数Dio_MaskedWritePort开关
   • DioVersionInfoApi：获取版本信息函数Dio_GetVersionInfo开关
   • DioEcucPartitionRef： Dio模块的ECUC分区引用。暂不支持

配置DioConfig

DIO模块的配置参数，用于配置Port、ChannelGroup信息；每个DioPort就是一组PORT信息

• DioPortId：配置的PORT编号
  • 0表示PORTA，1标识PORTB，2表示PORTC，3表示PORTD，4表示PORTE，5表示PORTF，6表示PORTG，7表示PORTH，8表示PORTJ，9表示PORTK。
    158SF系列支持0-7即支持到PORTH，138SF系列支持0-3即支持到PORTD
  • 生成PORT配置信息，如配置1表示PORTB，生成#define DIO_CFG_PORT_B (0x1U)
  • 用于Dio_WritePort、Dio_ReadPort等函数入参
• DioPortEcucPartitionRef：配置的PORT编号对应的ECUC分区引用。暂不支持
• DioChannel：用于生成该PORT下的PIN信息
  • DioChannelId：配置的PIN编号
    • 0表示PIN0,1表示PIN1，2表示PIN2，3表示PIN3，4表示PIN4，5表示PIN5，6表示PIN6，7表示PIN7，8表示PIN8，9表示PIN9，10表示PIN10，11表示PIN11，12表示PIN12，13表示PIN13，14表示PIN14，15表示PIN15
    • 生成PIN配置信息，如配置PORT配置值为2,Channel配置2组，分别值是1，3，则生成
      #define DIO_CFG_CHANNEL_C_1 (0x21U) #define DIO_CFG_CHANNEL_C_3 (0x23U)
    • 用于Dio_WriteChannel、Dio_ReadChannel、Dio_FlipChannel函数入参
  • DioChannelEcucPartitionRef：配置的PORT编号下的PIN编号对应的ECUC分区引用。暂不支持
• DioChannelGroup：Group配置信息
  • DioChannelGroupIdentification:配置的是ChannelGroup名称。
    • DIO通道组在DIO API中通过指向数据结构（类型为Dio_ChannelGroupType）的指针进行标识。
    • 示例#define Dio_ChannelGroup_RGB (&Dio_ChannelGroupConfig[0])
    • 用于Dio_ReadChannelGroup、Dio_WriteChannelGroup函数使用
  • DioPortMask：配置的是ChannelGroup的端口掩码。
  • DioPortOffset：配置的是ChannelGroup的端口偏移量。
    • 这几个值的含义，DioPortMask是要修改的位，为1表示可修改位；DioPortOffset是偏移入参Level量；示意图
      
    • DioChannelGroupEcucPartitionRef：配置的是ChannelGroup的ECUC分区引用。暂不支持

---

设置项目路径及名称

1. 点击“Setting”按钮。
2. “Project Name”是配置的工程名称
3. 在“Project Path”设置工程保存路径。
4. “Configuration Code Folder Name”配置文件存放的文件加名称。
5. 点击“Confirm”保存设置，如图所示
   

---

保存配置并预览代码

1. 点击“Save”按钮，保存配置。
2. 点击“Preview Code”按钮，查看生成的代码文件列表，如图所示
   
3. 点击相应的文件名，可以预览文件内容，如图所示
   

---

生成代码

1. 点击“Generate code”按钮，生成相关配置文件，如图所示
   

---

查看生成代码

1. 生成代码后，可以在项目路径下找到生成的源文件。
2. 使用代码编辑器打开这些文件，进行查看或进一步编辑，如图所示