Gpt 配置使用说明

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

Gpt 配置使用说明

简介

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

环境准备

确保已安装以下软件：

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

创建项目

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

选择MCU型号

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

添加GPT模块

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

配置Gpt模块

配置GptConfigurationOfOptApiServices

在左侧树状结构中，展开“Gpt”并选择“GptConfigurationOfOptApiServices”。
配置以下参数：(示例配置仅供参考，根据实际使用修改)
- GptDeinitApi：反初始化函数Gpt_DeInit开关。
- GptEnableDisableNotificationApi：通知函数Gpt_EnableNotification、Gpt_DisableNotification开关。
- GptTimeElapsedApi：运行时间函数Gpt_GetTimeElapsed开关。
- GptTimeRemainingApi：剩余函数Gpt_GetTimeRemaining开关。
- GptVersionInfoApi：获取版本信息函数Gpt_GetVersionInfo开关。
- GptWakeupFunctionalityApi: 唤醒功能开关。暂不支持
- GptPrecompileSupport：配置固定地址，如果用户需要使用此功能，需要将此参数设置为true。打开的时候调用初始化函数时入参为空指针，关闭的时候，入参为配置参数指针。
- GptPredefTimerFunctionalityApi：预定时期功能开关。

配置GptDriverConfiguration

GPT驱动程序的模块范围配置（参数）。

GptDevErrorDetect：错误检测开关。
GptPredefTimer100us32bitEnable：100us定时器32位功能开关。暂不支持
GptPredefTimer1usEnablingGrade：1us定时器功能等级。暂不支持
GptReportWakeupSource：唤醒源上报开关。暂不支持
GptEcucPartitionRef：GPT模块的分区引用。暂不支持
GptKernelEcucPartitionRef：GPT模块内核的分区引用。暂不支持
GptClockReferencePoint：GPT时钟参考点。暂不支持

配置GptChannelConfigSet

配置GptPredefConfig

GPT模块的预设配置，需要打开'GptPredefTimerFunctionalityApi'才可配置该功能。

GptClockSource：时钟源。
GptPredefHwChannel：硬件通道。
GptPrescaler：预分频。

配置GptChannelConfigSet

GPT通道配置，每个通道占用一个定时器资源。

GptChannelId：硬件单元选择。
- 1x8系列：0表示T0，1表示T1，2表示T2，3表示T3，4表示T4，5表示T18，6表示T19，7表示T21，8表示T22，9表示T23。只有T23是32位硬件单元，其余都是16位硬件单元。
- 158SF系列：0表示T0，1表示T1，2表示T2，3表示T3，4表示T4，5表示T20，6表示T21。只有T20\T21是32位硬件单元，其余都是16位硬件单元。
- 138SF系列：0表示T0，1表示T1，2表示T2，3表示T3，4表示T4，5表示T5，都是16位硬件单元。
GptChannelMode：单次模式或连续模式。
GptChannelTickFrequency：指定定时器通道的计时器频率，单位为赫兹（Hz）。暂不支持
GptChannelTickValueMax：定时器通道的计数器最大值，函数Gpt_StartTimer，会检测入参值是否大于配置值。
GptEnableWakeup：配置定时器通道是否支持唤醒。暂不支持
GptNotification：定时器通道的回调函数配置。如果使用不配置空指针且打开配置GptEnableDisableNotificationApi。
GptChannelClkSrcRef：定时器通道的时钟源选择。暂不支持
GptChannelEcucPartitionRef：定时器通道的分区选择。暂不支持
GptClkSrc：定时器通道的时钟源选择。
GptPrescale：定时器通道的预分频值(函数内部做了减1处理)。
GptChanHwType：定时器通道的硬件类型选择。暂不支持
GptWakeupConfiguration: 定时器通道的唤醒配置。暂不支持

设置项目路径及名称

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

保存配置并预览代码

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

生成代码

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

查看生成代码

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