AN12853 i.MX ROMs Log Events

# AN12853 i.MX ROMs Log Events ## 1. Introduction ### 1.1 Scope 本应用笔记旨在定义i.MX系列处理器ROM中的日志事件及其记录方式。这些事件对于ROM调试非常关键，当ROM代码执行到某个重要的节点时，会将特定的ROM事件记录在ROM的日志缓冲区中。这些事件记录涵盖了每次启动尝试（无论成功或失败），为开发者提供了ROM启动过程的一个快照以便于分析。 ### 1.2 术语表 #### 表1. 术语表 | 术语 | 定义 | |------------|------------------------------------------------------------------------------------------------------| | ROM事件 | 标识ROM启动处理过程中的一个特定点，用以显示与ROM启动相关的各种信息。例如，ROM从熔丝或GPIO读取的启动模式、使用的启动设备、启动设备初始化是否完成、从启动设备加载数据是否完成、启动映像验证是否通过等。 | | ROM事件日志缓冲区 | 存储ROM事件的RAM区域。某些设备可能包含一个或多个这样的缓冲区。 | ## 2. ROM事件 ### 2.1 ROM事件条目 ROM事件条目存储在ROM事件日志缓冲区中。每个单个ROM事件条目由ROM事件ID及其参数组成： #### 表2. 一个ROM事件条目 | 偏移量 | 位 [31:0] | |--------|------------------| | 0x0 | ROM事件ID | | 0x4 | 参数0 (可选，仅适用于某些事件) | | 0x8 | 参数1 (可选，仅适用于某些事件) | | 0xC | 参数2 (可选，仅适用于某些事件) | ### 2.2 ROM事件ID格式 ROM事件ID有两种版本的格式： #### 2.2.1 ROM事件ID格式版本0 适用于i.MX6系列处理器。 ##### 表3. ROM事件ID格式版本 | ROM事件ID格式版本 | 用户 | |-------------------|-------------------| | ROM事件ID格式版本0 | i.MX6系列 | ##### 表4. ROM事件ID格式版本0 | 位31-24 | 位23-0 | |---------|-------------| | 保留 | 日志事件ID | #### 2.2.2 ROM事件ID格式版本1 适用于i.MX7D、i.MX7ULT、i.MX8QM系列及i.MX mSCALE系列处理器。 ##### 表5. ROM事件ID格式版本1 | 位31-24 | 位23-16 | 位15-0 | |---------|---------|-----------------| | 保留 | 分类码 | 日志事件ID | 其中，“分类码”用于进一步区分事件的类别，比如是与启动模式相关还是与启动设备初始化相关。 ### 2.3 ROM事件ID定义 #### 2.3.1 版本0事件ID 该部分详细定义了i.MX6系列中使用的ROM事件ID的具体含义。 #### 2.3.2 版本1事件ID 该部分详细定义了i.MX7D、i.MX7ULT、i.MX8QM系列及i.MX mSCALE系列中使用的ROM事件ID的具体含义。 ## 3. ROM事件日志缓冲区 ### 3.1 ROM事件日志缓冲区基地址 该部分详细介绍了ROM事件日志缓冲区的基地址及其如何在内存中定位。 ### 3.2 ROM事件日志缓冲区空间 该部分描述了ROM事件日志缓冲区的空间大小以及如何管理这个空间，以确保不会溢出，并且能够保存尽可能多的事件信息。 ## 4. 修订历史 该部分记录了文档的修订历史，包括每次修订的日期、版本号和变更内容。 AN12853 i.MX ROMs Log Events 应用笔记详细介绍了i.MX6/7/8系列处理器ROM中的日志事件及其记录方式。这对于开发人员理解并调试ROM启动过程至关重要。通过记录和分析这些事件，可以更好地了解ROM启动过程中的关键点，有助于发现潜在的问题并进行优化。此外，不同系列的处理器采用不同的ROM事件ID格式，这使得事件的记录更加灵活和有针对性。