ZHCAF08 February 2025 AM2612 , AM2631 , AM2632 , AM2634 , AM263P2 , AM263P4 , AM2732 , AM2732-Q1 , AM620-Q1 , AM623 , AM625 , AM625-Q1 , AM62A3 , AM62A3-Q1 , AM62A7 , AM62A7-Q1 , AM62D-Q1 , AM62P , AM62P-Q1 , AM67 , AM68A , AM69A , DRA821U , TDA4AEN-Q1 , TDA4AH-Q1 , TDA4AL-Q1 , TDA4AP-Q1 , TDA4VE-Q1 , TDA4VEN-Q1 , TDA4VH-Q1 , TDA4VL-Q1 , TDA4VM , TDA4VP-Q1
源文件包括驱动程序实现和相关标头文件。其中包括多个文件、这些文件分为面向驱动程序用户的接口和更接近特定目标硬件 MCU 的私有源以及中断源。
特定驱动程序的标头 (.h) 和源 (.c) 文件以 Pascal_Snake_Case 中的模块实现前缀 <Mip> 开头(即 PascalCase 和 snake_case 的组合)命名,以符合 AUTOSAR 命名和目录结构规范。<Mip> 命名文件是具有公共接口内容(包括可从设备驱动程序中使用的宏、数据类型和 API)的文件。该源保持通用状态,并符合模块 SRS 和 SWS 规范。针对该层预期的任何给定功能,API 都具有一个固定的且定义明确的接口,从而使 API 可以可靠地与源库一同使用。API 能向后兼容;因此,无需清理或更改版本迁移。
不建议在驱动程序应用中使用名为 <Mip>_Priv (包含专用实现)且硬件高度特定的源。只要迁移硬件设计,就可以更新 <Mip>_Priv 标识符和符号,并且由于有任何特性支持和错误修复功能,在现有源实现后不需要提供向后兼容性。
名为 <Mip>_Irq 的文件包含 IRQ 和中断处理源,该源用于为中断例程 (ISR) 提供服务。采用 TI 矢量中断模块 (VIM) 实现 ARM 嵌套矢量中断控制器,可设置中断例程。除 <Mip> 命名文件以外的任何文件均被视为专用驱动程序源,建议不要将其内容直接视为可从构建驱动程序库使用的接口,即使文件或符号仍然暴露给源或捆绑库的任何部分也是如此。
在通过对软件包中的任何模块进行初始化来设置依赖项时,示例应用程序源可用作参考,甚至可以作为基于驱动程序自定义程序的启动应用程序。示例源可用作示例演示,并保留任何驱动程序库没有应用程序依赖项的情况,但为示例生成的配置文件标头除外,在不使用各种不同的生成式配置标头时,可使用此类配置文件标头构建驱动程序源库。