AUTOSAR进阶图解==＞AUTOSAR_SWS_OCUDriver

AUTOSAR OCU驱动程序详解

目录

1. 概述
   1.1 什么是OCU驱动程序
   1.2 OCU的主要功能
   1.3 应用场景
2. 架构设计
   2.1 OCU驱动程序架构
   2.2 与其他模块的依赖关系
3. 配置结构
   3.1 OCU驱动程序配置
   3.2 配置参数详解
4. 状态管理
   4.1 OCU通道状态机
   4.2 状态转换
5. 交互流程
   5.1 典型操作序列
   5.2 初始化流程
   5.3 通道操作流程
6. 组件结构
   6.1 OCU驱动程序组件
   6.2 文件结构
7. 总结

1. 概述

1.1 什么是OCU驱动程序

OCU (Output Compare Unit) 驱动程序是AUTOSAR基础软件的一部分，属于微控制器抽象层 (MCAL) 中的一个基础驱动模块。它作为硬件抽象层，为上层软件提供与微控制器OCU硬件无关的统一接口，屏蔽了不同微控制器间OCU硬件实现的差异。

OCU驱动程序负责初始化和控制微控制器内部OCU功能，它允许软件通过将计数器值与预定义的阈值进行比较，并在匹配时触发特定动作。

1.2 OCU的主要功能

OCU驱动程序提供了以下主要功能：

• 初始化和配置：初始化OCU硬件单元，根据预定义配置设置OCU通道
• 阈值设置：支持设置绝对和相对比较阈值
• 通道控制：启动和停止OCU通道的比较操作
• 通知管理：启用和禁用比较匹配通知
• 引脚状态控制：设置与OCU通道关联的输出引脚状态
• 计数器值获取：获取OCU计数器当前值
• 错误处理：提供错误检测和报告机制

1.3 应用场景

OCU驱动程序在汽车电子系统中有广泛的应用场景：

• 精确定时控制：例如喷油器控制、点火系统控制
• PWM信号生成：用于马达控制、LED调光等
• 触发其他硬件单元：例如在特定时间触发ADC采样或DMA传输
• 周期性中断生成：用于实现精确的定时任务

2. 架构设计

2.1 OCU驱动程序架构

下图展示了AUTOSAR OCU驱动程序的系统架构，说明了它与其他AUTOSAR模块的关系：

OCU驱动程序架构具有以下特点：

• 模块化设计：OCU驱动程序作为独立模块，具有明确定义的接口
• 层次化结构：位于AUTOSAR微控制器抽象层，为上层软件提供硬件抽象
• 标准化接口：提供符合AUTOSAR标准的API，确保可移植性
• 依赖明确：与DET、DEM、MCU和PORT等模块有明确的依赖关系

2.1.1 OCU驱动程序职责

OCU驱动程序负责：

• 初始化和控制微控制器内部OCU功能
• 提供比较阈值和计数器值的服务
• 管理通知机制
• 控制输出引脚状态
• 触发硬件资源(如ADC、DMA)

2.2 与其他模块的依赖关系

OCU驱动程序与以下AUTOSAR模块有依赖关系：

1. DET模块：当启用开发错误检测时，OCU驱动程序使用DET模块报告开发错误

   /* 开发错误检测示例 */
   if (Channel >= OCU_MAX_CHANNELS) {
       Det_ReportError(OCU_MODULE_ID, OCU_INSTANCE_ID, 
                      OCU_START_CHANNEL_SID, OCU_E_PARAM_INVALID_CHANNEL);
       return;
   }
   

2. DEM模块：OCU驱动程序向DEM模块报告生产错误

   /* 生产错误报告示例 */
   if (OcuInit_Result != E_OK) {
       Dem_ReportErrorStatus(OCU_E_INIT_FAILED, DEM_EVENT_STATUS_FAILED);
   }
   

3. MCU驱动：OCU驱动程序依赖MCU驱动配置的系统时钟

   • MCU驱动负责初始化和控制芯片内部时钟源
   • 设置全局时钟预分频器
   • OCU驱动程序只配置OCU外设的特定资源

4. PORT驱动：OCU驱动程序通过PORT驱动配置的I/O引脚

   • PORT驱动必须在使用OCU功能前初始化
   • 用于配置OCU使用的输出引脚

3. 配置结构

3.1 OCU驱动程序配置

下图展示了OCU驱动程序的配置结构：

OCU驱动程序配置由多个结构体组成，主要包括：

• Ocu：顶层配置容器
• OcuGeneral：通用配置参数
• OcuConfigSet：配置集合，包含通道配置
• OcuChannel：通道特定配置
• OcuConfigurationOfOptionalApis：可选API的配置

3.2 配置参数详解

3.2.1 Ocu 配置容器

Ocu是顶级配置容器，包含OCU驱动程序的所有配置项：

• OcuGeneral：全局通用配置，例如错误检测开关
• OcuConfigSet：一个或多个配置集，用于不同的操作模式

3.2.2 OcuGeneral 配置容器

OcuGeneral容器包含OCU驱动程序的全局配置参数：

• OcuDevErrorDetect：

  • 描述：开发错误检测和通知开关
  • 类型：布尔值
  • 默认值：false
  • 配置时机：预编译时间

• OcuVersionInfoApi：

  • 描述：版本信息API开关
  • 类型：布尔值
  • 默认值：false
  • 配置时机：预编译时间

• OcuDeInitApi：

  • 描述：反初始化API开关
  • 类型：布尔值
  • 默认值：false
  • 配置时机：预编译时间

/* OcuGeneral配置示例 */
typedef struct {
    boolean OcuDevErrorDetect;        /* 开发错误检测开关 */
    boolean OcuVersionInfoApi;        /* 版本信息API是否可用 */
    boolean OcuDeInitApi;             /* 反初始化API是否可用 */
    EcucPartitionRefType OcuEcucPartitionRef[OCU_MAX_PARTITIONS]; /* ECUC分区引用 */
    EcucPartitionRefType OcuKernelEcucPartitionRef; /* 内核ECUC分区引用 */
} Ocu_GeneralType;

3.2.3 OcuConfigSet 配置容器

OcuConfigSet包含一组OCU通道配置和可选API配置：

• OcuChannel：一个或多个通道配置
• OcuConfigurationOfOptionalApis：可选API配置

3.2.4 OcuChannel 配置容器

OcuChannel定义了OCU通道的特定配置：

• OcuChannelId：

  • 描述：OCU通道的唯一标识符
  • 类型：无符号整数
  • 范围：0到最大通道数减1

• OcuDefaultThreshold：

  • 描述：通道的默认比较阈值
  • 类型：无符号整数
  • 范围：取决于具体实现

• OcuNotification：

  • 描述：比较匹配时调用的通知回调函数
  • 类型：函数指针
  • 可选性：可以不配置

• OcuOutputPinUsed：

  • 描述：是否使用输出引脚
  • 类型：布尔值

• OcuOutputPinDefaultState：

  • 描述：输出引脚的默认状态
  • 类型：Ocu_PinStateType (OCU_LOW/OCU_HIGH)

/* OCU通道配置示例 */
typedef struct {
    uint8 OcuChannelId;                           /* 通道ID */
    uint32 OcuDefaultThreshold;                   /* 默认阈值 */
    void (*OcuNotification)(void);                /* 通知回调函数 */
    boolean OcuOutputPinUsed;                     /* 是否使用输出引脚 */
    Ocu_PinStateType OcuOutputPinDefaultState;    /* 输出引脚默认状态 */
    uint8 OcuTimerCh;                             /* 定时器通道 */
    void* OcuHwUnitRef;                           /* 硬件单元引用 */
} Ocu_ChannelConfigType;

3.2.5 OcuConfigurationOfOptionalApis 配置容器

这个容器用于配置哪些可选API可用：

• OcuDeInitApi：反初始化API可用性
• OcuGetCounterApi：获取计数器值API可用性
• OcuNotificationSupported：通知支持可用性
• OcuSetAbsoluteThresholdApi：设置绝对阈值API可用性
• OcuSetPinStateApi：设置引脚状态API可用性
• OcuSetRelativeThresholdApi：设置相对阈值API可用性

这些可选API配置项都是预编译时配置，不能在运行时更改。

/* 可选API配置示例 */
typedef struct {
    boolean OcuDeInitApi;                /* 是否支持Ocu_DeInit */
    boolean OcuGetCounterApi;            /* 是否支持Ocu_GetCounter */
    boolean OcuNotificationSupported;    /* 是否支持通知功能 */
    boolean OcuSetAbsoluteThresholdApi;  /* 是否支持设置绝对阈值 */
    boolean OcuSetPinStateApi;           /* 是否支持设置引脚状态 */
    boolean OcuSetRelativeThresholdApi;  /* 是否支持设置相对阈值 */
} Ocu_OptionalApiConfigType;

4. 状态管理

4.1 OCU通道状态机

下图展示了OCU驱动程序通道的状态机：

OCU通道可以处于以下四种状态之一：

1. 未初始化（UNININITIALIZED）：

   • 驱动程序上电或复位后的初始状态
   • 调用任何API（除Ocu_Init外）会触发OCU_E_UNINIT错误

2. 已初始化（INITIALIZED）：

   • 成功调用Ocu_Init()后进入
   • 所有通道处于已停止状态
   • 可以使用所有配置的API

3. 已停止（STOPPED）：

   • 通道比较功能未激活
   • 不执行比较匹配动作
   • 可以设置阈值和引脚状态
   • 可以读取计数器值

4. 运行中（RUNNING）：

   • 通道比较功能已激活
   • 计数器与阈值比较执行
   • 在比较匹配时执行配置的动作
   • 如果配置了通知，将调用通知函数

4.2 状态转换

OCU通道状态机包含以下状态转换：

1. 上电或复位 → 未初始化：驱动程序上电或系统复位时进入未初始化状态

2. 未初始化 → 已初始化：调用Ocu_Init()初始化驱动程序

3. 已初始化 → 未初始化：调用Ocu_DeInit()反初始化驱动程序

4. 已初始化 → 已停止：初始化后，所有通道处于已停止状态

5. 已停止 → 运行中：调用Ocu_StartChannel()启动通道

6. 运行中 → 已停止：调用Ocu_StopChannel()停止通道

此外，状态机还包含以下错误转换：

• 运行中 → 运行中：在通道已经运行时调用Ocu_StartChannel()会触发OCU_E_BUSY错误
• 未初始化 → 未初始化：在未初始化状态下调用除Ocu_Init外的任何API会触发OCU_E_UNINIT错误
• 已初始化 → 已初始化：如果有通道处于运行中状态时调用Ocu_DeInit()会触发OCU_E_PARAM_INVALID_STATE错误

/* OCU状态机实现示例 */
typedef enum {
    OCU_STATE_UNINIT  = 0,  /* 未初始化状态 */
    OCU_STATE_INIT    = 1,  /* 已初始化状态 */
    OCU_STATE_STOPPED = 2,  /* 已停止状态 */
    OCU_STATE_RUNNING = 3   /* 运行中状态 */
} Ocu_StateType;

/* 驱动程序状态变量 */
static Ocu_StateType Ocu_DriverState = OCU_STATE_UNINIT;
static Ocu_StateType Ocu_ChannelState[OCU_MAX_CHANNELS];

/* 状态检查示例 */
Std_ReturnType Ocu_StartChannel(Ocu_ChannelType ChannelNumber) {
    /* 驱动程序初始化检查 */
    if (Ocu_DriverState != OCU_STATE_INIT) {
        #if (OCU_DEV_ERROR_DETECT == STD_ON)
        Det_ReportError(OCU_MODULE_ID, OCU_INSTANCE_ID,
                       OCU_START_CHANNEL_SID, OCU_E_UNINIT);
        #endif
        return E_NOT_OK;
    }
    
    /* 通道状态检查 */
    if (Ocu_ChannelState[ChannelNumber] == OCU_STATE_RUNNING) {
        #if (OCU_DEV_ERROR_DETECT == STD_ON)
        Det_ReportError(OCU_MODULE_ID, OCU_INSTANCE_ID,
                       OCU_START_CHANNEL_SID, OCU_E_BUSY);
        #endif
        return E_NOT_OK;
    }
    
    /* 启动通道 */
    /* ... 通道启动代码 ... */
    
    /* 更新通道状态 */
    Ocu_ChannelState[ChannelNumber] = OCU_STATE_RUNNING;
    
    return E_OK;
}

5. 交互流程

5.1 典型操作序列

下图展示了OCU驱动程序的典型操作序列，从初始化到通道操作再到反初始化：

这个序列图展示了OCU驱动程序使用的完整流程，包括：

• 初始化阶段
• 通道操作阶段
• 比较匹配处理
• 通道停止与反初始化

5.2 初始化流程

OCU驱动程序初始化流程包括以下步骤：

1. 应用软件首先初始化MCU驱动，配置全局时钟和预分频器
2. 然后初始化PORT驱动，配置OCU使用的IO引脚
3. 最后初始化OCU驱动程序：

   /* OCU初始化示例 */
   void OCU_Init_Example(void) {
       /* 首先初始化MCU驱动 */
       Mcu_Init(&Mcu_Config);
       
       /* 然后初始化PORT驱动 */
       Port_Init(&Port_Config);
       
       /* 最后初始化OCU驱动 */
       Ocu_Init(&Ocu_Config);
   }
   

初始化过程中可能出现的错误情况：

• 配置指针为NULL：如果配置指针为NULL且OCU需要配置指针，将触发OCU_E_PARAM_POINTER错误
• 硬件初始化失败：如果OCU硬件初始化失败，将触发OCU_E_INIT_FAILED错误

5.3 通道操作流程

OCU通道操作通常包括以下步骤：

1. 使能通知（可选）：如果需要在比较匹配时接收通知

   Ocu_EnableNotification(OcuChannel);
   

2. 设置阈值：设置比较阈值，可以是绝对阈值或相对阈值

   /* 设置绝对阈值 */
   Ocu_SetAbsoluteThreshold(OcuChannel, AbsoluteValue);
   
   /* 设置相对阈值 */
   Ocu_SetRelativeThreshold(OcuChannel, RelativeValue);
   

3. 启动通道：激活通道的比较功能

   Ocu_StartChannel(OcuChannel);
   

4. 比较匹配处理：当计数器值与阈值匹配时，OCU硬件会产生中断，OCU驱动程序处理这个中断并调用通知回调函数

   /* 通知回调函数示例 */
   void Ocu_NotificationFunction(void) {
       /* 处理比较匹配事件 */
       /* 例如更新应用软件状态或触发其他操作 */
   }
   

5. 停止通道和禁用通知：操作完成后停止通道并禁用通知

   Ocu_StopChannel(OcuChannel);
   Ocu_DisableNotification(OcuChannel);
   

6. 反初始化：如果不再需要OCU驱动程序，可以反初始化它

   /* 所有通道都必须先停止 */
   Ocu_DeInit();
   

需要注意的是，在调用Ocu_DeInit()之前，必须确保所有通道都已停止，否则会触发OCU_E_PARAM_INVALID_STATE错误。

6. 组件结构

6.1 OCU驱动程序组件

下图展示了OCU驱动程序的组件结构：

OCU驱动程序由以下主要组件组成：

1. OCU核心模块（Ocu.c）：实现所有驱动功能

   • 初始化/反初始化：Ocu_Init/DeInit
   • 通道管理：Ocu_StartChannel/StopChannel
   • 阈值控制：Ocu_SetAbsoluteThreshold/SetRelativeThreshold
   • 通知管理：Ocu_EnableNotification/DisableNotification
   • 杂项服务：Ocu_GetCounter/SetPinState/GetVersionInfo

2. 配置文件：

   • Ocu_Cfg.h：配置头文件
   • Ocu_PBcfg.c：后期构建配置
   • Ocu_Lcfg.c：链接时配置

3. 头文件：

   • Ocu.h：驱动程序API头文件
   • Ocu_PrivateTypes.h：私有类型定义

6.2 文件结构

OCU驱动程序的文件结构如下：

1. Ocu.h：公共头文件，包含API定义和公共数据类型

   /* Ocu.h示例片段 */
   #ifndef OCU_H
   #define OCU_H
   
   #include "Std_Types.h"
   #include "Ocu_Cfg.h"
   
   /* API服务ID定义 */
   #define OCU_INIT_SID                  0x00
   #define OCU_DEINIT_SID                0x01
   #define OCU_STARTCHANNEL_SID          0x02
   #define OCU_STOPCHANNEL_SID           0x03
   /* ... 更多服务ID ... */
   
   /* 错误代码 */
   #define OCU_E_UNINIT                  0x01
   #define OCU_E_PARAM_INVALID_CHANNEL   0x02
   #define OCU_E_PARAM_POINTER           0x03
   /* ... 更多错误代码 ... */
   
   /* 数据类型定义 */
   typedef uint8 Ocu_ChannelType;
   
   typedef enum {
       OCU_LOW = 0,
       OCU_HIGH = 1
   } Ocu_PinStateType;
   
   /* API声明 */
   void Ocu_Init(const Ocu_ConfigType* ConfigPtr);
   void Ocu_DeInit(void);
   void Ocu_StartChannel(Ocu_ChannelType ChannelNumber);
   void Ocu_StopChannel(Ocu_ChannelType ChannelNumber);
   /* ... 更多API声明 ... */
   
   #endif /* OCU_H */
   

2. Ocu.c：核心实现文件

   /* Ocu.c示例片段 */
   #include "Ocu.h"
   #include "Det.h"
   #include "Ocu_PrivateTypes.h"
   
   /* 驱动程序状态变量 */
   static Ocu_StateType Ocu_DriverState = OCU_STATE_UNINIT;
   static Ocu_ConfigType* Ocu_Configuration = NULL;
   
   void Ocu_Init(const Ocu_ConfigType* ConfigPtr) {
       uint8 channel;
       
       /* 错误检查 */
       #if (OCU_DEV_ERROR_DETECT == STD_ON)
       if (ConfigPtr == NULL) {
           Det_ReportError(OCU_MODULE_ID, OCU_INSTANCE_ID,
                         OCU_INIT_SID, OCU_E_PARAM_POINTER);
           return;
       }
       #endif
       
       /* 保存配置指针 */
       Ocu_Configuration = (Ocu_ConfigType*)ConfigPtr;
       
       /* 初始化硬件 */
       /* ... 硬件初始化代码 ... */
       
       /* 初始化所有通道为停止状态 */
       for (channel = 0; channel < OCU_MAX_CHANNELS; channel++) {
           Ocu_ChannelState[channel] = OCU_STATE_STOPPED;
       }
       
       /* 更新驱动程序状态 */
       Ocu_DriverState = OCU_STATE_INIT;
   }
   
   /* ... 更多函数实现 ... */
   

3. Ocu_Cfg.h：配置头文件

   /* Ocu_Cfg.h示例片段 */
   #ifndef OCU_CFG_H
   #define OCU_CFG_H
   
   #include "Std_Types.h"
   
   /* 模块配置参数 */
   #define OCU_DEV_ERROR_DETECT          STD_ON
   #define OCU_VERSION_INFO_API          STD_OFF
   #define OCU_DE_INIT_API               STD_ON
   #define OCU_SET_PIN_STATE_API         STD_ON
   #define OCU_SET_ABSOLUTE_THRESHOLD_API STD_ON
   #define OCU_SET_RELATIVE_THRESHOLD_API STD_OFF
   #define OCU_GET_COUNTER_API           STD_ON
   #define OCU_NOTIFICATION_SUPPORTED    STD_ON
   
   /* 最大通道数 */
   #define OCU_MAX_CHANNELS              8
   
   #endif /* OCU_CFG_H */
   

4. Ocu_PBcfg.c和Ocu_Lcfg.c：配置实现文件

   /* Ocu_PBcfg.c示例片段 */
   #include "Ocu.h"
   
   /* 通道配置 */
   const Ocu_ChannelConfigType OcuChannelConfig[OCU_MAX_CHANNELS] = {
       {
           .OcuChannelId = 0,
           .OcuDefaultThreshold = 1000,
           .OcuNotification = &Ocu_Channel0Notification,
           .OcuOutputPinUsed = TRUE,
           .OcuOutputPinDefaultState = OCU_LOW,
           .OcuTimerCh = 0,
           .OcuHwUnitRef = NULL
       },
       /* ... 更多通道配置 ... */
   };
   
   /* 可选API配置 */
   const Ocu_OptionalApiConfigType OcuOptionalApiConfig = {
       .OcuDeInitApi = TRUE,
       .OcuGetCounterApi = TRUE,
       .OcuNotificationSupported = TRUE,
       .OcuSetAbsoluteThresholdApi = TRUE,
       .OcuSetPinStateApi = TRUE,
       .OcuSetRelativeThresholdApi = FALSE
   };
   
   /* 通用配置 */
   const Ocu_GeneralType OcuGeneralConfig = {
       .OcuDevErrorDetect = TRUE,
       .OcuVersionInfoApi = FALSE,
       .OcuDeInitApi = TRUE,
       .OcuEcucPartitionRef = {NULL},
       .OcuKernelEcucPartitionRef = NULL
   };
   
   /* 配置集 */
   const Ocu_ConfigSetType OcuConfigSet = {
       .OcuChannel = OcuChannelConfig,
       .OcuConfigurationOfOptionalApis = &OcuOptionalApiConfig
   };
   
   /* 全局配置 */
   const Ocu_ConfigType Ocu_Config = {
       .OcuGeneral = &OcuGeneralConfig,
       .OcuConfigSet = &OcuConfigSet
   };
   

7. 总结

AUTOSAR OCU驱动程序是AUTOSAR基础软件栈中重要的微控制器抽象层组件，提供了对OCU硬件功能的标准化访问。它通过定义一系列API和配置结构，实现了硬件抽象，使上层软件能够以统一的方式访问不同微控制器的OCU功能。

OCU驱动程序的主要特点

• 标准化接口：提供符合AUTOSAR标准的API，确保跨平台兼容性
• 模块化设计：清晰的模块结构和接口定义，便于集成和维护
• 可配置性：丰富的配置选项，适应不同的应用需求
• 状态管理：严格的状态机控制，确保驱动程序的可靠性
• 错误处理：完善的错误检测和报告机制

应用建议

在使用OCU驱动程序时，建议遵循以下最佳实践：

1. 确保正确初始化依赖模块，特别是MCU和PORT驱动
2. 在调用Ocu_DeInit()前停止所有运行中的通道
3. 根据应用需求合理配置可选API，不需要的功能可以禁用以节省资源
4. 为每个通道设置适当的比较阈值和通知函数
5. 使用适当的错误处理机制，特别是在安全关键应用中