异常处理

在"存储布局"部分,我们刚开始的时候决定说得简单点,所以忽略了对异常的处理。在这部分,我们将添加对异常处理的支持;这将作为一个如何在稳定版的Rust中(比如 不依赖不稳定的 #[linkage = "weak"] 属性,它让一个符号变成弱链接)实现编译时可重载行为的案例。

背景信息

简而言之,异常是Cortex-M和其它架构为了让应用可以响应异步的,通常是外部的,事件,所提供的一种机制。经典的(硬件)中断是大多数人所知道的最常见的异常类型。

Cortex-M异常机制工作起来像下面一样: 当处理器接收到与某个异常的类型相关的信号或者事件,它挂起现在的子程序的执行(通过将状态存进调用栈中)然后在一个新的栈帧中继续执行相关的异常处理函数,也就是另一个子程序。在异常处理函数执行完成之后(比如 从它返回后),处理器恢复被挂起的子程序的执行。

处理器使用向量表去确定执行哪个处理函数。表中的每一项包含一个指向一个处理函数的指针,每一项关联的异常类型都不一样。比如,第二项是重置处理函数,第三项是NMI(不可屏蔽中断)处理函数,等等。

像之前提到的,处理器希望向量表在存储中的某个特定的位置,在运行时处理器可能用到表中的每一项。因此,表中的各项必须包含有效的值。此外,我们希望rt crate是灵活的,因此终端用户可以定制每个异常处理函数的行为。最后,向量表要坐落在只读存储中,或者在不容易被修改的存储中,因此用户必须静态地注册处理函数,而不是在运行时。

为了满足所有的这些需求,我们将给rt crate中的向量表所有的项分配一个默认值,但是让这些值变以让终端用户可以在编译时重载它们。

Rust部分

让我们看下所有的这些要如何被实现。为了方便,我们将只使用向量表的前16个项;这些项不是特定于设备的,所以它们在所有类型的Cotex-M微控制器上都有相同的作用。

我们做的第一件事是在rt create的代码中创造一个向量(指向异常处理函数的指针)数组:

$ sed -n 56,91p ../rt/src/lib.rs
#![allow(unused)] fn main() { pub union Vector { reserved: u32, handler: unsafe extern "C" fn(), } extern "C" { fn NMI(); fn HardFault(); fn MemManage(); fn BusFault(); fn UsageFault(); fn SVCall(); fn PendSV(); fn SysTick(); } #[link_section = ".vector_table.exceptions"] #[no_mangle] pub static EXCEPTIONS: [Vector; 14] = [ Vector { handler: NMI }, Vector { handler: HardFault }, Vector { handler: MemManage }, Vector { handler: BusFault }, Vector { handler: UsageFault, }, Vector { reserved: 0 }, Vector { reserved: 0 }, Vector { reserved: 0 }, Vector { reserved: 0 }, Vector { handler: SVCall }, Vector { reserved: 0 }, Vector { reserved: 0 }, Vector { handler: PendSV }, Vector { handler: SysTick }, ]; }

向量表中的一些项是保留的;ARM文档说它们应该被分配成 0 值,所以我们使用一个联合体来完成它。需要指向一个处理函数的项必须使用external函数;这很重要,因为它可以让终端用户来提供实际的函数定义。

接下来,我们在Rust代码中定义一个默认的异常处理函数。没有被终端用户分配的异常将使用这个默认处理函数。

$ tail -n4 ../rt/src/lib.rs
#![allow(unused)] fn main() { #[no_mangle] pub extern "C" fn DefaultExceptionHandler() { loop {} } }

链接器脚本部分

在链接器脚本那部分,我们将这些新的异常向量放在重置向量之后。

$ sed -n 12,25p ../rt/link.x
EXTERN(RESET_VECTOR); EXTERN(EXCEPTIONS); /* <- NEW */ SECTIONS { .vector_table ORIGIN(FLASH) : { /* First entry: initial Stack Pointer value */ LONG(ORIGIN(RAM) + LENGTH(RAM)); /* Second entry: reset vector */ KEEP(*(.vector_table.reset_vector)); /* The next 14 entries are exception vectors */ KEEP(*(.vector_table.exceptions)); /* <- NEW */ } > FLASH

并且我们使用 PROVIDE 给我们在rt中未定义的处理函数赋予一个默认值 (NMI和上面的其它处理函数):

$ tail -n8 ../rt/link.x
PROVIDE(NMI = DefaultExceptionHandler); PROVIDE(HardFault = DefaultExceptionHandler); PROVIDE(MemManage = DefaultExceptionHandler); PROVIDE(BusFault = DefaultExceptionHandler); PROVIDE(UsageFault = DefaultExceptionHandler); PROVIDE(SVCall = DefaultExceptionHandler); PROVIDE(PendSV = DefaultExceptionHandler); PROVIDE(SysTick = DefaultExceptionHandler);

当检测完所有的输入目标文件而等号左侧的符号仍然没有定义的时候,PROVIDE 才会发挥作用。也就是用户没有为相关的异常实现处理函数时。

测试它

这就完了!rt crate现在支持异常处理函数了。我们可以用下列的应用测试它:

注意: 在QEMU中生成一个异常很难。在实际的硬件上对一个无效的存储地址进行 一个读取是足够产生一个中断的,但是QEMU却能接受这个操作并且返回零。一个陷入指 令在QEMU和硬件上都可以发挥中断的作用,但是不幸的是在稳定版上不可以用它,所以你需要 暂时切换到nightly版本中去运行这个和下个案例。

#![feature(core_intrinsics)] #![no_main] #![no_std] use core::intrinsics; use rt::entry; entry!(main); fn main() -> ! { // this executes the undefined instruction (UDF) and causes a HardFault exception intrinsics::abort() }
(gdb) target remote :3333 Remote debugging using :3333 Reset () at ../rt/src/lib.rs:7 7 pub unsafe extern "C" fn Reset() -> ! { (gdb) b DefaultExceptionHandler Breakpoint 1 at 0xec: file ../rt/src/lib.rs, line 95. (gdb) continue Continuing. Breakpoint 1, DefaultExceptionHandler () at ../rt/src/lib.rs:95 95 loop {} (gdb) list 90 Vector { handler: SysTick }, 91 ]; 92 93 #[no_mangle] 94 pub extern "C" fn DefaultExceptionHandler() { 95 loop {} 96 }

为了完整性,这里列出程序被优化过的版本的反汇编:

$ cargo objdump --bin app --release -- -d --no-show-raw-insn --print-imm-hex
app: file format elf32-littlearm Disassembly of section .text: <main>: trap trap <Reset>: push {r7, lr} mov r7, sp movw r1, #0x0 movw r0, #0x0 movt r1, #0x2000 movt r0, #0x2000 subs r1, r1, r0 bl 0x9c <__aeabi_memclr> @ imm = #0x3e movw r1, #0x0 movw r0, #0x0 movt r1, #0x2000 movt r0, #0x2000 subs r2, r1, r0 movw r1, #0x282 movt r1, #0x0 bl 0x84 <__aeabi_memcpy> @ imm = #0x8 bl 0x40 <main> @ imm = #-0x40 trap <UsageFault>:
$ cargo objdump --bin app --release -- -s -j .vector_table
app: file format elf32-littlearm Contents of section .vector_table: 0000 00000120 45000000 83000000 83000000 ... E........... 0010 83000000 83000000 83000000 00000000 ................ 0020 00000000 00000000 00000000 83000000 ................ 0030 00000000 00000000 83000000 83000000 ................

向量表现在像是集合了这本书中迄今为止所有的代码片段。总结下:

  • 在早期的存储章节的检查它部分,我们知道了:
    • 向量表中第一项包含了栈指针的初始值。
    • Objdump使用小端格式打印,所以栈开始于 0x2001_0000
    • 第二项指向地址 0x0000_0045,重置处理函数。
      • 在上面的反汇编中可以看到重置处理函数的地址,是 0x44
      • 由于对齐的要求被设置成1的第一位不会改变地址。而是,它让函数在 thumb mode 下执行。
  • 之后,可以看到在0x830x00之间交替的地址模式。
    • 看下上面的反汇编,很明显 0x83 指的是 DefaultExceptionHandler (0x84用thumb模式执行)。
    • 在这个章节早期所设置的向量表和Cortex-M的向量表布局的模式之间来回查看,很明显每次有个带处理函数的项出现在表中,DefaultExceptionHandler的地址就会出现。
    • 可以看到Rust代码中的向量表的数据结构的布局与Cortex-M向量表中的保留项依次对齐了。因此,所有的保留项被正确的设置成了零值。

重载一个处理函数

为了重载一个异常处理函数,用户必须提供一个函数,其符号名完全匹配我们在EXCEPTIONS中使用的名字。

#![feature(core_intrinsics)] #![no_main] #![no_std] use core::intrinsics; use rt::entry; entry!(main); fn main() -> ! { intrinsics::abort() } #[no_mangle] pub extern "C" fn HardFault() -> ! { // do something interesting here loop {} }

你可以在QEMU中测试它

(gdb) target remote :3333 Remote debugging using :3333 Reset () at /home/japaric/rust/embedonomicon/ci/exceptions/rt/src/lib.rs:7 7 pub unsafe extern "C" fn Reset() -> ! { (gdb) b HardFault Breakpoint 1 at 0x44: file src/main.rs, line 18. (gdb) continue Continuing. Breakpoint 1, HardFault () at src/main.rs:18 18 loop {} (gdb) list 13 } 14 15 #[no_mangle] 16 pub extern "C" fn HardFault() -> ! { 17 // do something interesting here 18 loop {} 19 }

程序现在执行了用户定义的HardFault函数而不是rt crate中的DefaultExceptionHandler

与我们在main接口中进行的第一次尝试一样,这个实现的问题是没有类型安全性。它也容易混淆异常的名字,但是不会生成一个错误或者警告。而仅仅是忽略用户定义的处理函数。这些问题可以使用一个像是在cortex-m-rt v0.5.x 中定义的exception!宏和cortex-m-rt v0.6.x中的exception属性来解决。