Uart 配置使用说明

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

Uart 配置使用说明

简介

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

环境准备

确保已安装以下软件：

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

创建项目

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

选择MCU型号

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

添加UART模块

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

配置UART模块

配置UartGeneral

在左侧树状结构中，展开“Uart”并选择“UartGeneral”。
配置以下参数：（示例配置仅供参考，根据实际使用修改）
- UartPrecompileSupport：配置固定地址，如果用户需要使用此功能，需要将此参数设置为true。
- UartDevErrorDetect：Detect开关，默认为关闭，如果用户需要使用Detect功能，需要将此参数设置为true。
- UartRuntimeErrorDetect：反初始化UART(Uart_Deinit)时如果存在有未完成的UART传输，打开该配置，会报错。
- UartVersionInfoApi：获取版本信息函数(Uart_GetVersionInfo)开关。
- UartRxDataMaxSize：配置接收数据的最大长度；在接收不定长数据时，最大接收长度按照该配置来。
  
  1.用户在使用UART时，要预估出接收的最大长度，配置的最大长度不能小于实际中最大长度
  2.在使用'Uart_AsyncReceive'时，Buffer参数空间大小不能小于配置的'UartRxDataMaxSize'

配置UartChannelConfig

UartChannelConfig至少要配置一组信息，最多不可超过硬件单元个数（取决于芯片）
点击'UartChannelConfig'右侧'+'来增加配置个数或在'UartChannelConfig'界面，点击'Add'，如图所示
删除配置个数，在'UartChannelConfig'配置界面，选中增加的配置信息，点击'Delete'或左侧，点击'-'，如图所示
配置以下参数：（示例配置仅供参考，根据实际使用修改）
- UartModule：UART模块选择。
- UartBaudRateClkSrc：UART时钟源选择。
- UartBaudRateInteger：UART波特率整数部分。
- UartBaudRateNumerator：UART波特率小数部分分子部分。
- UartBaudRateDenominator：UART波特率小数部分分母部分。
  波特率计算公式：
  1.小数部分分母不能为0
  2.小数部分分子为0时，小数波特率发生器不影响波特率
- UartStopBit：停止位。
- UartParityMode：奇偶校验。
- UartReceiveOrder：接收数据顺序。
- UartSendOrder：发送数据顺序。
- UartTxSelect：串口发送管脚选择，根据实际选择TX0 或 TX1。（部分平台无此选项）
- UartReceiveCompleteCallback：接收完成回调函数。
- UartSendCompleteCallback：发送完成回调函数。
- UartDmaConfig
  - UartReceiveDmaSwitch：接收是否使用DMA开关
  - UartSendDmaSwitch：发送是否使用DMA开关
  - UartRxDmaSource：接收DMA通道选择，'UartReceiveDmaSwitch'配置为'true'时，该参数才可以配置
  - UartTxDmaSource：发送DMA通道选择，'UartSendDmaSwitch'配置为'true'时，该参数才可以配置
    DMA通道选择需与实际UART硬件单元匹配，其具体对应关系参见用户手册DMA章节