Lin 配置使用说明

简介

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

---

环境准备

确保已安装以下软件：

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

---

创建项目

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

---

选择MCU型号

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

---

添加LIN模块

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

---

配置LIN模块

配置LinGeneral

1. 在左侧树状结构中，展开“Lin”并选择“LinGeneral”。
2. 配置以下参数：（示例配置仅供参考，根据实际使用修改）
   • LinDevErrorDetect：启用或禁用设备错误检测
   • LinIndex：LIN索引
   • LinTimeoutDuration：LIN超时持续时间
   • LinVersionInfoApi：获取LIN版本信息
   • LinApiTailoring：定制信息
     • LinPrecompileSupport：启用或禁用预编译支持，打开的时候，调用初始化函数入参需要为空指针；关闭的时候，调用初始化函数入参为配置参数指针
     • LinStartUpSleepState：启动时进入休眠状态
     • LinSlaveMode：启用或禁用从机模式
     • LinDisableDemReportErrorStatus：禁用Dem报告错误状态；配置OFF模式，才会上报Dem。
     • LinMaxDataLength：LIN数据最大长度。（部分芯片的该配置固定为8，不可变更）
     • LinTimeoutLoops：LIN超时循环次数，发送前等待上一帧数据发送最大循环次数（如果已发送完不会循环等待）。
   • LinEcucPartitionRef：将Lin驱动程序映射到零个或多个ECUC分区，以在该分区中提供模块的API。

配置LinGlobalConfig

LIN通道配置信息，主从模式配置。

• LinTxConfirmationCallback：LIN发送完成回调函数（从机使用，打开LinSlaveMode时可配置）。
• LinRxIndicationCallback：LIN接收到数据回调函数（从机使用，打开LinSlaveMode时可配置）。
• LinHeaderIndicationCallback：LIN接收到帧头回调函数（从机使用，打开LinSlaveMode时可配置）。
• LinChannel：通道信息配置
  • LinChannelBaudRate：波特率参数，未使用，需要根据配置波特率参数决定。
  • LinChannelId：标识LIN通道。在Lin_Cfg.h文件中生成对应的宏定义，供上层接口使用。
  • LinChannelWakeupSupport：配置LIN通道是否支持唤醒。暂不支持
  • LinNodeType：主从模式选择。
  • LinChannelEcucPartitionRef：配置LIN通道所使用的ECUC分区。暂不支持
  • LinChannelEcuMWakeupSource：配置LIN通道所使用的ECUC唤醒源。暂不支持
  • LinClockRef：配置LIN通道所使用的时钟。暂不支持
  • LinHwModule：硬件UART单元选择。实际可选项取决于芯片。
  • LinClockSelect：时钟源选择。
  • LinBaudInteger：配置LIN通道的波特率整数部分。
  • LinBaudNumrator：配置LIN通道的小数波特率分子。
  • LinBaudDenom：配置LIN通道的小数波特率分母。
  • LinDmaConfig：DMA配置信息。（如果需要配置点击切换到绿色状态配置）
    
    • LinReceiveDmaSwitch：DMA接收使能。
    • LinSendDmaSwitch：DMA发送使能。
    • LinRxDmaSource：DMA接收通道选择，打开LinReceiveDmaSwitch才可选择。
    • LinTxDmaSource：DMA发送通道选择，打开LinSendDmaSwitch才可选择。
      DMA通道选择需与实际UART硬件单元匹配，其具体对应关系参见用户手册DMA章节

配置LinDemEventParameterRefs

包含对DemEventParameter元素的引用，这些元素应在发生相应错误时通过API Dem_SetEventStatus进行调用。EventId取自所引用的DemEventParameter的DemEventId符号值。此容器中提供了标准化错误，还可以通过供应商特定的错误引用进行扩展。暂不支持

---

设置项目路径及名称

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. 使用代码编辑器打开这些文件，进行查看或进一步编辑，如图所示