Ocu 配置使用说明

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

Ocu 配置使用说明

简介

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

环境准备

确保已安装以下软件：

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

创建项目

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

选择MCU型号

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

添加OCU模块

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

配置OCU模块

配置OcuGeneral

在左侧树状结构中，展开“Ocu”并选择“OcuGeneral”。
配置以下参数：（示例配置仅供参考，根据实际使用修改）
- OcuDevErrorDetectApi：打开或关闭开发错误检测和通知。
- OcuPbFixedAddress：打开或关闭预编译支持，打开的时候，调用初始化函数入参需要为空指针；关闭的时候，调用初始化函数入参为配置参数指针。
- OcuKernelEcucPartitionRef：配置Ocu模块使用的内核。暂不支持
- OcuEcucPartitionRef：配置Ocu模块使用的应用程序。暂不支持

配置OcuConfigurationOfOptionalApis

API模块的配置参数，用于配置Ocu模块的配置参数。

OcuDeInitApi：反初始化函数Ocu_DeInit开关。
OcuGetCounterApi：获取计数值函数Ocu_GetCounter开关。
OcuNotificationSupported：通知函数Ocu_EnableNotification、Ocu_DisableNotification开关。
OcuSetAbsoluteThresholdApi：设置绝对阈值函数Ocu_SetAbsoluteThreshold开关。
OcuSetPinActionApi：设置Pin动作函数Ocu_SetPinAction开关。
OcuSetRelativeThresholdApi：设置相对阈值函数Ocu_SetRelativeThreshold开关。
OcuVersionInfoApi：获取版本信息函数Ocu_GetVersionInfo开关。
OcuSetPinStateApi：设置Pin状态函数Ocu_SetPinState开关。

配置OcuConfigSet

OCU模块的配置参数，硬件单元和通道信息。

OcuCountdirection：此参数指示整个OCU驱动器的计数方向。
OcuHWSpecificSettings：硬件单元信息配置，硬件单元可配置多个
- OcuModuleInstance：硬件单元实例编号。实际可选项取决于芯片。
- OcuClockSource：时钟源选择。
- OcuPrescale：可选的OCU驱动程序特定时钟预分频因子。暂不支持
- OcuPrescaleVendor：可配置的OCU驱动程序特定时钟预分频系数。
- OcuMaxCounter：计时器计数器最大溢出值。
OcuChannel：通道具体参数配置
- OcuModuleIndex：硬件单元索引选择，只能选择已配置的OcuHWSpecificSettings。
- OcuAssignedHardwareChannel：通道配置，0表示通道1，1表示通道2，2表示通道3，3表示通道4。
- OcuChannelId：通道ID。用于在Ocu_Cfg.h文件中生成对应的宏定义，供上层接口使用。一般无需手动修改。
- OcuChannelTickDuration：指定增加通道计数器一次（即一个计数刻度）所需的输入时钟边沿数量（上升沿或下降沿）。暂不支持
- OcuDefaultThreshold：用于初始化的比较阈值的值。
- OcuHardwareTriggeredAdc：配置通道是否由ADC触发。暂不支持
- OcuHardwareTriggeredDMA：配置通道是否由DMA触发。暂不支持
- OcuMaxCounterValue：配置通道的计数器最大值。暂不支持
- OcuNotification：配置通知回调函数。
- OcuOuptutPinUsed：配置通道是否使用输出引脚（DET开启时，函数Ocu_SetPinState、Ocu_SetPinAction检查使用）。
- OcuOutputPinDefaultState：引脚在初始化后应设置的状态.暂不支持
- OcuPinAction：计时器达到阈值的输出状态：高、低、翻转等。
- OcuChannelEcucPartitionRef：配置通道的分区名称。暂不支持

设置项目路径及名称

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

保存配置并预览代码

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

生成代码

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

查看生成代码

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