TM4C123x ROM API实战：NVIC、MPU与PWM模块深度解析与应用

1. 项目概述

在嵌入式开发领域，尤其是基于ARM Cortex-M内核的微控制器项目中，直接操作硬件寄存器是基本功，但TI的Tiva C系列（如TM4C123x）提供了一个更优雅的解决方案：固化在芯片ROM中的驱动库（ROM API）。这套API将复杂的寄存器操作封装成直观的函数，不仅能显著减少Flash占用，还能提升代码的可靠性和开发效率。今天，我们就来深入聊聊这套ROM API中的三个核心模块：嵌套向量中断控制器（NVIC）、内存保护单元（MPU）和脉冲宽度调制器（PWM）。如果你正在使用TM4C123x做项目，或者对Cortex-M4的系统级编程感兴趣，这篇文章将带你绕过文档的晦涩，直击实战应用的核心。

很多开发者拿到芯片后，习惯性地去翻数据手册和编程指南，面对动辄几十个寄存器位域，常常感到无从下手。ROM API的价值就在于，它把这些底层细节都封装好了。比如，你想设置一个中断优先级，不用再去查SCB->SHP[]寄存器的偏移地址和位域定义，直接调用ROM_IntPrioritySet()就行。这不仅仅是省了几行代码，更重要的是减少了因寄存器操作失误导致的隐性BUG。对于NVIC和MPU这类关乎系统稳定性和实时性的核心模块，使用经过芯片厂商严格测试的ROM API，无疑是更稳妥的选择。接下来，我将结合自己的项目经验，为你拆解这三个模块的API使用方法、背后的原理，以及那些官方手册里不会明说的“坑”和技巧。

2. NVIC ROM API深度解析与实战应用

中断是嵌入式系统的“神经系统”，负责响应外部事件的紧急呼叫。Cortex-M4的NVIC设计得非常高效，而Tiva的ROM API则让它的使用变得异常简单。但简单不代表可以随意用，理解其机制才能用好。

2.1 NVIC核心机制与API映射

NVIC的核心是“向量化”和“嵌套”。向量化意味着每个中断源都有独立的中断服务程序（ISR）入口地址，CPU收到中断后能直接跳转，省去了传统软件查询中断源的时间。嵌套则允许高优先级中断打断低优先级中断的服务，这对于多任务实时系统至关重要。

ROM API完美封装了这些硬件特性。我们来看几个最常用的函数及其背后的操作：

• ROM_IntEnable/Disable(uint32_t ui32Interrupt): 这两个函数操作的是NVIC中的ISER（中断设置使能寄存器）和ICER（中断清除使能寄存器）。你传入一个中断号（如INT_GPIOA），它帮你设置对应的位。这里有个细节：中断号的定义在inc/hw_ints.h头文件中，它实际上是中断向量表（Vector Table）中的偏移位置。使能一个中断前，务必确保其外设模块本身的中断也已使能（例如GPIO模块的中断）。
• ROM_IntPrioritySet(uint32_t ui32Interrupt, uint8_t ui8Priority): 这是最需要小心使用的函数之一。Cortex-M4的优先级数值越小，优先级越高。但硬件只使用优先级寄存器的高几位（对于TM4C123x，是最高3位）。这意味着，如果你设置优先级为5（二进制0101），硬件实际使用的是010（即2），因为低1位被忽略了。ROM API已经帮你处理了这个移位操作，你传入的ui8Priority就是0-7之间的值，对应8个优先级级别。一个常见的误区是以为有256个优先级（因为uint8_t），其实只有8级。
• ROM_IntMasterEnable/Disable(void): 这两个函数操作的是PRIMASK寄存器。ROM_IntMasterDisable()就是执行CPSID I指令，全局关闭中断；ROM_IntMasterEnable()则是CPSIE I。务必注意：ROM_IntMasterDisable()的返回值是一个bool类型，它告诉你调用前中断是否是使能状态。这在创建临界区代码时非常有用，可以用于安全地恢复之前的中断状态，避免盲目打开中断可能引入的问题。

// 示例：安全地进入临界区 bool bIntStatus = ROM_IntMasterDisable(); // 关中断，并保存之前状态 // ... 执行临界区代码（如操作共享链表） if(bIntStatus) { ROM_IntMasterEnable(); // 如果之前是开的，才重新打开 }

2.2 优先级分组与抢占机制详解

NVIC支持优先级分组，这决定了多少位用于抢占优先级（Preemption Priority），多少位用于子优先级（Sub-priority）。抢占优先级高的可以打断低的；抢占优先级相同的中断，子优先级高的先执行，但不能互相打断。

ROM_IntPriorityGroupingSet(uint32_t ui32Bits)函数用于设置分组。参数ui32Bits表示用于抢占优先级的位数。对于TM4C123x，总共有3位用于优先级，所以ui32Bits可以是0到3。

• 如果ui32Bits=3，表示3位全用于抢占优先级，没有子优先级。这样就有8个可抢占的优先级级别。
• 如果ui32Bits=2，表示高2位用于抢占优先级（4个级别），低1位用于子优先级（2个级别）。
• 如果ui32Bits=0，则表示没有抢占优先级，所有中断的抢占优先级都为0，此时只有子优先级生效，中断之间不能互相抢占，只能按顺序处理或尾链（Tail-chaining）。

如何选择分组？这取决于你的系统设计。在复杂的实时系统中，你可能需要将关键任务（如电机控制PWM中断）设置为高抢占优先级，将非实时任务（如日志打印）设置为低抢占优先级。如果多个中断属于同一逻辑层级且需要确定性的执行顺序，但又不需要互相抢占，则可以使用子优先级来排序。

2.3 中断挂起与清除的注意事项

ROM_IntPendSet和ROM_IntPendClear这两个函数用于软件触发和清除中断挂起状态。它们操作的是NVIC的ISPR（中断设置挂起寄存器）和ICPR（中断清除挂起寄存器）。

一个关键的实战场景是中断共享。假设两个GPIO引脚共享同一个中断向量（例如GPIO Port A和Port B都映射到同一个中断号）。在ISR中，你需要读取两个端口的中断状态寄存器来判断是哪个引脚触发了中断。处理完一个引脚的事件后，如果你直接ROM_IntPendClear，可能会清除另一个尚未处理的引脚的中断挂起状态，导致事件丢失。正确的做法是，只在确认所有共享该中断源的事件都已处理完毕后，才清除外设模块的中断标志，NVIC的挂起位通常会在中断服务程序退出时由硬件自动处理，或通过ROM_IntPendClear谨慎操作。

关于中断延迟的优化：NVIC的尾链（Tail-chaining）机制是降低中断延迟的关键。当CPU处理完一个中断，准备返回时，如果有一个已挂起且优先级不低于当前中断（对于同优先级或子优先级情况）的中断在等待，CPU会直接跳转到新的ISR，而不会先进行出栈和入栈操作。ROM API的优先级设置直接影响这一行为。合理规划优先级，让高频、短小的中断具有相同（或更高）的优先级，可以充分利用尾链减少上下文切换开销。

3. MPU ROM API配置指南与内存保护策略

在无操作系统的裸机环境或简单的RTOS中，内存保护常常被忽视，但这恰恰是系统稳健性的重要防线。MPU可以防止错误的指针操作覆盖关键代码区或数据区，也可以将不同任务或模块隔离，提升安全性。

3.1 MPU区域配置详解

TM4C123x的MPU支持最多8个保护区域。每个区域由基地址、大小和属性组成。ROM_MPURegionSet函数是配置的核心。

关键参数解析：

• ui32Addr(基地址): 必须按区域大小对齐。例如，一个大小为4KB（MPU_RGN_SIZE_4K）的区域，其基地址必须是4KB的整数倍（即低12位为0）。ROM API不会帮你检查对齐，配置错误会导致区域无法生效或行为异常。
• ui32Flags(属性标志): 这是配置的精华，由多个宏进行“或”运算组合而成。
  1. 大小(Size): 从MPU_RGN_SIZE_32B到MPU_RGN_SIZE_4G。大小必须是2的幂。
  2. 执行权限(Execute Permission):MPU_RGN_PERM_EXEC（允许执行）或MPU_RGN_PERM_NOEXEC（禁止执行）。强烈建议将数据区（如SRAM、外设寄存器区）设置为NOEXEC，这可以防止某些缓冲区溢出攻击将数据当作代码执行。
  3. 访问权限(Access Permission): 这是一组宏，定义了特权模式（Privileged）和用户模式（User）下的读/写权限。例如：
     • MPU_RGN_PERM_PRV_RW_USR_NO: 特权模式可读写，用户模式无访问权限。这常用于保护操作系统内核数据。
     • MPU_RGN_PERM_PRV_RO_USR_RO: 特权模式和用户模式都只读。适用于存储常量或共享的只读数据。
  4. 子区域禁用(Sub-region Disable): MPU将每个区域平均分为8个子区域。你可以禁用其中任意几个（MPU_SUB_RGN_DISABLE_0~MPU_SUB_RGN_DISABLE_7）。这有什么用？经典用例是外设寄存器映射。假设你的外设寄存器区是0x4000.0000开始的大小为1MB的区域，但其中0x4003.0000到0x4003.FFFF这一段是保留区域或未实现。你可以定义一个1MB的区域，然后禁用对应的子区域（比如第3个子区域），这样访问这个“空洞”就不会触发内存管理错误。
  5. 使能状态(Enable):MPU_RGN_ENABLE或MPU_RGN_DISABLE。区域可以先配置后使能。

3.2 MPU启用与配置流程实战

配置MPU需要遵循一个安全的流程，尤其是在运行时动态修改区域属性时。

标准的初始化流程如下：

1. 查询支持的区域数量：调用ROM_MPURegionCountGet()，虽然TM4C123x固定为8，但养成查询习惯有利于代码移植。
2. 禁用MPU：在修改配置前，先调用ROM_MPUDisable()。这是一个好习惯。
3. 配置所需区域：使用ROM_MPURegionSet()逐个配置区域。重要原则：先配置，后使能。对于要修改的已启用区域，最安全的做法是先ROM_MPURegionDisable()，再ROM_MPURegionSet()重新配置，最后ROM_MPURegionEnable()。
4. 启用MPU：调用ROM_MPUEnable(uint32_t ui32MPUConfig)。这里的配置参数决定了MPU在特权模式和故障处理程序中的行为：
   • MPU_CONFIG_PRIV_DEFAULT: 在特权模式下，如果没有任何使能的区域，则使用默认内存映射（即背景区域）。对于大多数裸机应用，建议启用此选项，否则在特权模式下访问未定义区域会立即触发MemFault。
   • MPU_CONFIG_HARDFLT_NMI: 在HardFault或NMI异常处理程序中启用MPU。通常，在调试严重的系统错误时，你希望MPU规则仍然生效，以捕捉非法访问，所以也建议启用。
   • MPU_CONFIG_NONE: 不使用任何特殊配置。

// 示例：配置一个保护代码Flash区（只读、可执行）和一个保护外设区（特权读写、不可执行） #define FLASH_BASE 0x00000000 #define PERIPH_BASE 0x40000000 // 1. 禁用MPU ROM_MPUDisable(); // 2. 配置区域0：保护256KB的Flash（假设代码在此范围） ROM_MPURegionSet(0, FLASH_BASE, MPU_RGN_SIZE_256K | MPU_RGN_PERM_EXEC | MPU_RGN_PERM_PRV_RO_USR_RO | MPU_RGN_ENABLE); // 3. 配置区域1：保护1MB的外设空间（特权读写，禁止执行） ROM_MPURegionSet(1, PERIPH_BASE, MPU_RGN_SIZE_1M | MPU_RGN_PERM_NOEXEC | MPU_RGN_PERM_PRV_RW_USR_NO | MPU_RGN_ENABLE); // 4. 启用MPU，在特权模式使用默认映射，在HardFault/NMI中也启用MPU ROM_MPUEnable(MPU_CONFIG_PRIV_DEFAULT | MPU_CONFIG_HARDFLT_NMI);

3.3 内存管理故障（MemFault）处理与调试

一旦MPU启用，违反区域规则的访问会触发内存管理故障（MemFault）。默认情况下，芯片会进入HardFault。为了调试，你需要在HardFault处理程序中分析故障原因。

Cortex-M4的MemFault状态寄存器（MFSR）会记录故障原因：

• IACCVIOL: 指令访问违规。
• DACCVIOL: 数据访问违规。
• MUNSTKERR: 异常返回时的出栈访问违规。
• MSTKERR: 异常进入时的入栈访问违规。
• MLSPERR: 浮点单元惰性状态保存时的访问违规（如果支持）。

调试技巧：在HardFault_Handler中，读取SCB->CFSR（配置和故障状态寄存器）的子寄存器SCB->CFSR的位段可以获取MFSR。同时，SCB->MMFAR（MemManage Fault Address Register）会保存触发故障的地址。将这些信息通过串口打印出来，是定位非法内存访问的最直接方法。ROM API本身不提供故障诊断函数，这需要你直接访问SCB寄存器。

4. PWM ROM API高级应用与电机控制实例

PWM是控制电机、LED亮度、开关电源等的核心。TM4C123x的PWM模块功能强大，支持互补带死区输出、故障保护等高级特性。ROM API让复杂的PWM配置变得清晰。

4.1 PWM发生器配置与同步模式

每个PWM发生器（Gen0-Gen3）包含一个计数器（支持递减和递增/递减模式）和两个比较器（A和B），分别控制PWMxA和PWMxB输出。

ROM_PWMGenConfigure()是配置发生器的总开关。其ui32Config参数组合了多种模式：

• 计数模式：PWM_GEN_MODE_DOWN（递减）产生左对齐PWM，PWM_GEN_MODE_UP_DOWN（递增/递减）产生中心对齐PWM。电机控制中，中心对齐模式可以减少谐波，降低电机噪音和开关损耗，是更常用的选择。
• 同步模式：PWM_GEN_MODE_SYNC（同步）和PWM_GEN_MODE_NO_SYNC（非同步）。在同步模式下，对周期(ROM_PWMGenPeriodSet)和脉宽(ROM_PWMPulseWidthSet)的修改不会立即生效，而是被缓存起来，直到调用ROM_PWMSyncUpdate()或计数器归零时才一次性更新。这对于需要多个PWM输出严格同步变化的应用（如三相逆变器）至关重要，可以避免更新时刻不一致导致的波形畸变。
• 调试行为：PWM_GEN_MODE_DBG_RUN（调试时继续运行）和PWM_GEN_MODE_DBG_STOP（调试时停止）。在电机控制中，如果调试时PWM停止，电机可能失速，需根据情况选择。

配置一个中心对齐、同步更新的PWM发生器的示例：

// 假设使用PWM0模块，发生器0 uint32_t ui32Base = PWM0_BASE; uint32_t ui32Gen = PWM_GEN_0; // 配置为中心对齐、同步更新模式、调试时继续运行 ROM_PWMGenConfigure(ui32Base, ui32Gen, PWM_GEN_MODE_UP_DOWN | PWM_GEN_MODE_SYNC | PWM_GEN_MODE_DBG_RUN); // 设置PWM频率为20kHz (假设系统时钟为50MHz) // 中心对齐模式下，周期值 = SysClk / (2 * PWM_Freq) - 1 uint32_t ui32Period = (50000000 / (2 * 20000)) - 1; // 计算结果为1249 ROM_PWMGenPeriodSet(ui32Base, ui32Gen, ui32Period); // 设置PWM0（Gen0的A输出）占空比为50% // 中心对齐模式下，脉宽值 = (占空比 * 周期值 * 2) / 100 uint32_t ui32Width = (50 * ui32Period * 2) / 100; // 计算结果为1249 ROM_PWMPulseWidthSet(ui32Base, PWM_OUT_0, ui32Width); // 使能PWM输出 ROM_PWMOutputState(ui32Base, PWM_OUT_0_BIT, true); // 使能发生器计数器 ROM_PWMGenEnable(ui32Base, ui32Gen); // 如果需要同步更新多个发生器的参数，最后调用 // ROM_PWMSyncUpdate(ui32Base, PWM_GEN_0_BIT | PWM_GEN_1_BIT);

4.2 死区生成与故障保护机制

在驱动半桥或全桥电路（如电机驱动H桥）时，必须避免上下桥臂直通。死区时间就是在互补的PWM信号（如PWMxA和PWMxB）的上升沿和下降沿之间插入的一段两者都为低电平的时间。

ROM_PWMDeadBandEnable()函数用于启用死区。ui16Rise和ui16Fall参数分别指定从PWMxA的上升沿和下降沿开始的延迟时钟周期数。关键点：启用死区后，PWMxB的输出将耦合到PWMxA，其波形由PWMxA的波形加上死区延迟决定。你不能再独立设置PWMxB的脉宽。

故障保护（Fault Handling）是工业控制中的安全底线。PWM模块可以监控外部故障引脚（FAULTn），一旦触发，可以立即将PWM输出强制设置为安全状态（高电平、低电平或高阻态）。

1. 故障配置：使用ROM_PWMGenFaultConfigure()设置故障引脚的有效电平（高有效或低有效）和最小故障保持时间（ui32MinFaultPeriod）。最小保持时间可以防止噪声毛刺误触发。
2. 故障触发源选择：通过ROM_PWMGenFaultTriggerSet()选择哪些故障输入信号会影响本发生器。在支持扩展故障处理的器件上，可以灵活映射。
3. 输出响应设置：ROM_PWMOutputFault()决定当故障发生时，哪些PWM输出被抑制（置为安全状态）。ROM_PWMOutputFaultLevel()则决定被抑制的输出是驱动为高电平还是低电平。对于电机驱动，通常将输出强制置低（或高阻）来关闭所有功率管，是最安全的选择。
4. 中断处理：使能故障中断（ROM_PWMIntEnable()），并在中断服务程序中查询状态（ROM_PWMGenFaultStatus()），清除标志（ROM_PWMGenFaultClear()或ROM_PWMFaultIntClearExt()），并执行安全恢复逻辑。

4.3 PWM中断与触发事件

PWM发生器可以产生多种中断和触发事件，用于精确定时控制。

• 中断事件：包括计数器为零(PWM_INT_CNT_ZERO)、计数器等于装载值(PWM_INT_CNT_LOAD)、比较器A/B匹配上/下(PWM_INT_CNT_AU/AD/BU/BD)等。这些中断可以用于在PWM周期的特定点触发ADC采样（例如在中心对齐PWM的峰值或谷值采样电流），实现电流环的同步控制。
• 触发事件：与中断事件类似，但触发信号是输出到芯片内部的ADC或DMA模块，用于硬件自动触发转换或数据传输，无需CPU干预，极大提高了实时性。

使用ROM_PWMGenIntTrigEnable()可以同时使能中断和触发。一个高级技巧：在中心对齐模式下，利用PWM_INT_CNT_ZERO和PWM_INT_CNT_LOAD中断，可以在PWM周期的开始和中间点执行不同的控制算法。

5. 常见问题排查与实战心得

在实际项目中，使用ROM API也会遇到各种问题。下面是我总结的一些常见坑点和解决思路。

5.1 NVIC相关问题

问题1：中断服务程序（ISR）进入了，但标志位似乎没清除，导致不断重复进入。

• 排查：首先检查ISR中是否清除了外设模块的中断标志。ROM的NVIC API（如ROM_IntPendClear）处理的是CPU层面的中断挂起位，而外设（如GPIO、UART）有自己的中断状态寄存器需要手动清除。这是最常见的疏忽。
• 心得：养成ISR编写模板：1. 读取并判断外设中断源；2. 处理业务逻辑；3.清除外设中断标志；4. （可选）如果需要软件清除NVIC挂起位，再调用ROM_IntPendClear。

问题2：低优先级中断被高优先级中断长时间阻塞，系统响应变慢。

• 排查：检查高优先级ISR的执行时间是否过长。高优先级ISR应尽可能短小精悍，只做最紧急的处理（如保存数据、设置标志），将非紧急任务放到主循环或低优先级任务中。
• 优化：合理使用中断嵌套。如果高优先级ISR中也需要处理一些稍慢的操作，可以考虑暂时降低自身优先级（通过ROM_IntPrioritySet），允许其他同等或更低优先级的中断得到处理，然后再恢复优先级。但这需要非常小心，避免造成优先级反转。

5.2 MPU相关问题

问题1：一启用MPU，程序就跑飞进入HardFault。

• 排查步骤：
  1. 检查区域配置是否重叠：MPU区域不允许地址重叠（除非使用子区域禁用创建“空洞”）。确保所有区域的地址范围是互斥的。
  2. 检查栈指针（SP）访问：确保为栈空间（通常是RAM末尾区域）配置了一个可读写的区域。在启用MPU前，栈操作是正常的，启用后如果栈区域被保护或未定义，第一次进行栈操作（如调用函数）就会触发故障。
  3. 检查向量表访问：Cortex-M4的向量表（存放中断服务程序地址）默认在Flash开头。确保包含向量表的Flash区域被配置为可执行、至少特权模式可读。
  4. 启用MPU_CONFIG_PRIV_DEFAULT：在开发初期，可以先启用这个选项，确保在特权模式下未覆盖的区域有默认映射，缩小问题范围。

问题2：在MemFault处理程序中，如何获取故障地址和原因？

• 解决方案：编写一个详细的HardFault_Handler。以下代码片段展示了如何提取关键信息：

__attribute__((naked)) void HardFault_Handler(void) { __asm volatile( " tst lr, #4 \n" // 检查EXC_RETURN的位2，判断使用的是MSP还是PSP " ite eq \n" " mrseq r0, msp \n" // 使用MSP " mrsne r0, psp \n" // 使用PSP " ldr r1, [r0, #24] \n" // 获取故障时的PC " ldr r2, =hard_fault_handler_c \n" " bx r2 \n" // 跳转到C函数 ); } void hard_fault_handler_c(uint32_t *stack_frame) { uint32_t cfsr = SCB->CFSR; // 配置和故障状态寄存器 uint32_t mmfar = SCB->MMFAR; // MemManage故障地址寄存器 uint32_t bfar = SCB->BFAR; // 总线故障地址寄存器 uint32_t pc = stack_frame[6]; // 出错的PC // 通过串口打印cfsr, mmfar, bfar, pc等信息 // 根据CFSR的位域分析是MemFault、BusFault还是UsageFault // ... 你的调试输出代码 ... while(1); // 挂起系统 }

5.3 PWM相关问题

问题1：PWM没有输出，或者输出频率不对。

• 排查清单：
  1. 时钟是否使能：在使用PWM模块前，必须通过SysCtlPeripheralEnable(SYSCTL_PERIPH_PWM0)使能PWM模块的时钟。ROM API不包含系统控制功能，这一步需要调用TI的DriverLib或直接写寄存器。
  2. 引脚复用配置：PWM输出引脚需要配置为PWM功能。使用GPIOPinConfigure()和GPIOPinTypePWM()函数（来自DriverLib）进行配置。
  3. 发生器是否使能：调用ROM_PWMGenEnable()了吗？输出是否使能：调用ROM_PWMOutputState()了吗？
  4. 周期和脉宽计算是否正确：牢记递减模式和递增/递减模式的公式不同。递减模式：频率 = 系统时钟 / (周期 + 1)；递增/递减模式：频率 = 系统时钟 / (2 * (周期 + 1))。脉宽值也必须对应模式计算。
  5. 同步更新：如果你配置了同步模式(PWM_GEN_MODE_SYNC)，设置周期和脉宽后，需要调用ROM_PWMSyncUpdate()或等待计数器归零，新值才会生效。

问题2：死区时间设置后，测量到的实际死区时间与计算值有偏差。

• 原因：死区时间由ui16Rise和ui16Fall参数设置，单位是PWM时钟周期。需要确保你的PWM时钟频率是已知且稳定的。此外，信号通过驱动芯片和功率管时，其本身的开启/关断延迟（几十到几百纳秒）也会叠加到软件设置的死区时间上。
• 建议：使用示波器实际测量互补的PWMxA和PWMxB信号。以测量值为准，微调ui16Rise和ui16Fall参数。通常，关断时间比开启时间长，因此上升沿死区(ui16Rise)和下降沿死区(ui16Fall)可能需要设置不同的值来补偿硬件不对称。

问题3：故障保护功能测试时，PWM输出没有按预期被拉低/拉高。

• 排查：
  1. 故障引脚配置：确保故障输入引脚已正确配置为硬件故障功能，并且上拉/下拉电阻设置正确，使得在无故障时处于非有效状态。
  2. 故障电平极性：检查ROM_PWMGenFaultConfigure()中ui32FaultSenses参数设置是否正确（PWM_FAULTn_SENSE_HIGH或PWM_FAULTn_SENSE_LOW）。
  3. 输出响应配置：确认ROM_PWMOutputFault()为需要保护的输出位设置了true（抑制）。确认ROM_PWMOutputFaultLevel()设置了正确的安全电平。
  4. 故障清除：故障条件解除后，需要清除故障状态，PWM输出才会恢复正常。检查是否调用了ROM_PWMGenFaultClear()或相关的故障清除函数。