No Comments

AUTOSAR MCAL DIO 模块入门指南

1. DIO 模块简介与 AUTOSAR 分层定位

在 AUTOSAR（汽车开放系统架构）软件架构中，DIO Driver（数字 I/O 驱动）模块属于最底层的 MCAL(Microcontroller Abstraction Layer，微控制器抽象层)。

DIO 模块的主要职责是提供一个标准化的接口，用于直接访问微控制器（MCU）的数字输入/输出引脚（Digital I/O Pins）。它向上层的 I/O 硬件抽象层（IoHwAb）或其它 BSW 模块提供读写数字信号（高电平或低电平）的服务。

核心目标：

  • 硬件抽象： 将上层软件与具体的微控制器寄存器操作隔离开。
  • 标准化接口： 无论使用哪种 MCU，提供一套统一的 API 进行数字 I/O 操作。
  • 高效访问： 提供的 API 旨在实现对数字 I/O 的快速、原子性访问

模块定义：

DIO，即Digital Input/Output，该模块用于读取数字引脚输入及控制数字输出引脚电平状态。AUTOSAR标准中对于DIO模块的要求是需要定义这样一些函数，以满足读写某Port口、读写某个通道、读写某个通道组的操作，分别对应下图1、2、3。

17910-4crxax0zqov.png

23621-x2daqaz4fxe.png

其中，要实现读写通道组，首先需要用户自行定义通道组。定义规则：同一Port口用到2个或2个以上连续通道时（如图中的pin8、9、10），即可配置为一个通道组，调用读写通道组函数即可实现对这几个通道的同步操作。

2. I/O 抽象设计思维（IoHwAb 与 DIO 的配合）

DIO 模块和 IoHwAb（I/O Hardware Abstraction，I/O 硬件抽象层）共同构成了 AUTOSAR 中 I/O 抽象设计的核心。这种分层设计是为了实现软件的可移植性和 ECU 硬件的独立性。

35057-p0qmsr6l7m.png

IoHwAb 的角色：抽象“信号”

I/O 抽象设计的核心思想是将底层的物理 I/O 引脚抽象成上层应用关注的ECU 信号。

抽象层模块关注对象独立性目标
ECU 抽象层IoHwAbECU 信号(Signal)对 MCAL 驱动的独立性。IoHwAb 将各种 MCAL 驱动（如 DIO、ADC、PWM 等）的输出/输入进行整合和统一处理，并以功能性信号的视角提供给上层软件组件（SWC）。
MCAL 层DIO Driver物理引脚/通道(Channel)对 MCU 寄存器操作的独立性。DIO 专注于高效、原子地操作微控制器上的数字 I/O 寄存器。

设计意义：

如果一个应用程序信号需要由两个 DIO 通道组合而成，或者需要经过一个电平转换芯片，那么这种复杂的逻辑和硬件依赖性就由 IoHwAb 承担。应用程序组件（SWC）只需要调用 IoHwAb 提供的接口（例如 IoHwAb_SetMotorPower()），完全不必关心底层是哪个 DIO Port 的哪个 Pin。

3. DIO 模块核心概念

DIO 模块对 I/O 硬件引脚进行了三种逻辑上的组织：

3.1. Channel (通道)

  • Dio_ChannelType：代表微控制器上的一个单独的数字 I/O 引脚。这是最基本的操作单元。

3.2. Port (端口)

  • Dio_PortType：代表微控制器上的一组物理 I/O 引脚的集合，通常对应于 MCU 寄存器中定义的一个端口（例如 Port A、Port B）。操作 Port 可以一次性读写多个通道。

3.3. Channel Group (通道组)

  • Dio_ChannelGroupType：代表一个用户自定义的通道集合。
  • 通道组可以是连续的（Adjacent）或不连续的（Non-adjacent）引脚。
  • 使用通道组的主要优势在于效率：它允许通过单次原子操作（通常是读-改-写操作）来访问多个引脚，而无需单独操作每个通道。

4. DIO 模块配置与使用

4.1. DIO 模块的配置 (Configuration)

DIO 模块的配置主要通过 AUTOSAR 配置工具（如 DaVinci Configurator Pro）进行。配置数据通常定义在 Dio_Cfg.h 文件中，用于初始化 DIO 模块。

关键配置项：

配置项描述
DioChannel必须定义系统中使用的所有数字 I/O 通道，并分配唯一的符号名称（Symbolic Name）和 ID。
DioPort定义 MCU 上所有可用的 Port，并分配唯一的 ID。
DioChannelGroup定义一个或多个通道组。配置时需指定通道组中包含的通道 ID、通道组在 Port 中的起始位（Offset）和长度（Mask）。
DioDevErrorDetect使能 (TRUE) 或禁用 (FALSE) 开发错误检测（DET）。建议在开发阶段启用。
DioVersionInfoApi配置是否提供 Dio_GetVersionInfo() API。

4.2. DIO 模块的具体使用方法 (APIs)

DIO 驱动提供了一系列 C 语言函数接口（APIs）供上层模块调用。所有 DIO 接口函数定义在 Dio.h 头文件中。

需要注意的是Dio模块并没有Init函数，相关的初始化操作都是在Port模块中完成的。

API 函数描述
Dio_LevelType Dio_ReadChannel(Dio_ChannelType ChannelId)读取指定通道的数字电平（HIGH 或 LOW）。
void Dio_WriteChannel(Dio_ChannelType ChannelId, Dio_LevelType Level)写入指定的数字电平到指定通道。
Dio_LevelType Dio_FlipChannel(Dio_ChannelType ChannelId)翻转指定通道的当前电平（HIGH 变 LOW，LOW 变 HIGH），并返回翻转后的新电平。
Dio_PortLevelType Dio_ReadPort(Dio_PortType PortId)读取指定端口上所有通道的电平值。
void Dio_WritePort(Dio_PortType PortId, Dio_PortLevelType Level)写入指定的电平值到指定端口上所有通道。
Dio_PortLevelType Dio_ReadChannelGroup(const Dio_ChannelGroupType* ChannelGroupPtr)读取指定通道组的电平值。
void Dio_WriteChannelGroup(const Dio_ChannelGroupType* ChannelGroupPtr, Dio_PortLevelType Level)写入指定的电平值到指定通道组。
void Dio_MaskedWritePort(Dio_PortType PortId, Dio_PortLevelType Level, Dio_PortLevelType Mask)遮罩写入端口。允许只修改端口中由 Mask 指定的位，而不影响其他位。

5. DIO 模块使用注意事项（Precautions）

5.1. 关键的原子性要求 (Atomicity)

  • 必须保证原子性： DIO 驱动程序中所有访问通道、端口或通道组的函数，特别是可重入函数，必须以原子性的方式执行。
  • 并发访问的风险： 许多微控制器在操作单个引脚时，可能需要对整个端口寄存器进行“读-改-写（Read-Modify-Write）”操作。如果两个并发任务（例如一个主函数任务和一个中断）同时对同一个 Port 上的不同 Pin 进行读-改-写操作，就可能出现数据完整性问题（即“竞态条件”）。
  • 实现方法： DIO 模块的实现必须阻止这种并发访问。通常是通过禁用全局中断或使用自旋锁（Spinlock）等同步机制来保证原子性。云途MCU中GPIO模块本身支持Set、Clear等原子写操作，所以可以不需要禁用全局中断即可实现原子操作。

5.2. 开发错误检测 (DET)

  • 如果配置中启用了 DioDevErrorDetect，DIO 模块在运行时会检查 API 调用中的开发错误（Development Errors），例如：

    • 调用 Dio_Init() 以外的任何 API 时，DIO 模块尚未初始化 (DIO_E_UNINIT)。
    • 传入的通道 ID 或端口 ID 无效 (DIO_E_PARAM_INVALID_CHANNEL_ID, DIO_E_PARAM_INVALID_PORT_ID)。
  • 检测到错误后，DIO 模块应向 DET 模块报告错误。在正式发布版本中，通常会禁用 DET 以提高性能。

5.3. 端口配置和驱动的依赖性

  • DIO 模块只负责读写数字电平。引脚的方向（输入/输出）、模式（推挽/开漏/上拉/下拉）等物理特性配置，则由另一个 MCAL 模块 Port Driver 负责。
  • 使用顺序： 在 ECU 初始化过程中，通常先由 Port Driver 配置引脚的物理属性，然后再由 DIO Driver 或其他驱动模块（如 PWM、ADC）使用这些引脚进行数据操作。

6. DIO模块使用总结

DIO模块属于MCAL中比较基础的模块，主要实现IO的读写操作，并且为了便于操作多个IO，也集成了Group的概念，而在芯片GPIO控制模块中本身也遵守了Group的概念，硬件本身也是支持

最后更新于 2025-10-15 12:15:39 并被添加「MCU MCAL」标签，已有 92 位童鞋阅读过。


本作品采用知识共享署名-非商业性使用-禁止演绎 4.0 国际许可协议进行许可。

相关文章

发表新评论