這篇文章我們將會來講講嵌入式系統中非常重要的概念 —— 寄存器。因為單片機對于外界響應和自身功能的控制基本上全部都要通過寄存器進行交互，所以寄存器的使用將會貫穿整個單片機的學習過程。這篇文章將通過手把手重寫我們的 Blinky 程序來介紹寄存器的概念和操作方法。

文章前半部分會先講寄存器的基本原理，然后后半部分再通過代碼示范寄存器的操作方法。

這里使用的嵌入式平臺是 STM32F103，它的的寄存器手冊可以在 這里 下載。

寄存器操作

在之前我們說過： ? 寄存器指代的是一段特殊的內存地址區域，但是它沒有實際對應的 SRAM (Static Random-Access Memor, 靜態隨機存取存儲器) 存儲，對寄存器的操作與對內存的操作完全一致，可以將寄存器當作內存來讀寫，而對寄存器內存段的讀寫將會被轉化為總線上與外設的數據交換。 ? 所以對寄存器的操作實際上就是對特殊地址的內存進行讀寫操作。在手冊中我們可以找到各寄存器的起始地址 (28頁): ?

我們拿 GPIOA 外設的寄存器來做個例子，我們跳到手冊中 GPIO 的章節 (115頁)，這里有一張表格列出了 GPIO_BSRR 寄存器的結構。 ? 這個寄存器到底有什么用并不重要，我們這里只需掌握如何讀懂寄存器表格： ?

? 第一行是偏移地址。偏移地址指明了這個寄存器相對于外設寄存器區段的位置，從起始地址表中我們可以知道 GPIOA 寄存器區段的起始地址是 0x4001_0800，而 GPIO_BSRR 的偏移地址為 0x10，因此 GPIOA 的 GPIOA_BSRR 寄存器的真正地址即為 0x4001_0800 + 0x10 = 0x4001_0810。 ? 下面的兩行格子是寄存器位的說明。格子上的數字是位偏移地址，格子中間的是位的名稱，格子下面的是可讀寫性，這里格子下方都是 w，也就是說這些位都是只寫位。 ? 根據下方說明，如果我們要對 ODR3(另一個寄存器的位) 清0，我們就要對 BR3 寫1。這個操作實際上就是對 0x4001_0810 內存地址寫 0x1 << 19 （除第19位以外都是0的32位無符號整數）。 ? 使用 Rust 來操作就是這樣： ?

core::write_volatile(0x4001_0810 as *mut u32, 1 << 19);

? ? ? ?GPIO（通用接口）

Blinky 的原理很簡單，只需定時改變連接 LED 的引腳的電平，就可以讓 LED 閃爍起來了。我們查看核心板的電路原理圖可以發現 LED 被連接在了 PC13 引腳上，而且從原理圖中可以看出 LED 采用了共陽極接法，當引腳輸出低電平時 LED 才會點亮： ?

?

STM32F103C8T6 引腳圖 ? 注意：有的 STM32F103 核心板 LED 會連接在 PB12 引腳上，需要查看原理圖來確定。 ? STM32 中的引腳被分為了 GPIOA，GPIOB，GPIOC，GPIOD ... 等等多個組，每組中各控制有 16 個引腳，每個組都是一個獨立的外設。 ? 在這里，我們需要學習 GPIO 兩個關鍵寄存器：配置寄存器 (GPIOx_CRL，GPIOx_CRH) 和置位/復位寄存器 (GPIOx_BSRR)。(寄存器名中的 x 即為 GPIO 分組中的 A, B, C .. 等等) ? ?

GPIO 配置寄存器

單片機的引腳往往兼有多種功能，比如輸入或輸出，因此在使用引腳之前要通過配置寄存器配置它的功能。 ? 我們注意到這里出現了兩個配置寄存器 GPIOx_CRL 和 GPIOx_CRH，這其實是配置寄存器的高/低部分，低寄存器 (GPIOx_CRL) 負責配置 0..7 號引腳，高寄存器 (GPIOx_CRH) 負責配置 8..15 號引腳。 ?

GPIO 擁有以下幾種模式：

輸入浮空

輸入上拉

輸入下拉

模擬輸入

開漏輸出

推挽式輸出

推挽式復用功能 ─ 開漏復用功能

輸入可以理解為讀取引腳上的電平，相反，輸出就是控制引腳電平。因為我們想要通過控制引腳電平來點亮 LED，所以我們這里選擇輸出模式。

輸出模式有 推挽式輸出 和 開漏輸出 兩種。推挽輸出模式下引腳可以自行輸出高低兩種電平，但是電流驅動力較弱，適合于和數字元件通訊或驅動 LED；開漏輸出只有低電平和截止兩種狀態，所以需要在電路上加上 上拉電阻 (一端電源一端接引腳的電阻) 才能在截止狀態下輸出高電平，開漏輸出的電流驅動能力更強， 適合于做電流型的驅動。 ? 這里我們選擇最簡單的推挽式輸出模式就可以了。 ? 查閱手冊我們可以找到配置寄存器的結構 (114頁)： ?

? PC13 引腳對應了 MODE13 和 CNF13 兩段寄存器位，我們將 MODE13 設置為輸出模式即 0x11 (最大速度指的是最大電平翻轉頻率，這里任選一個都行)，然后將 CNF13 設為 0x00 就可以推挽輸出了。 ? ?

GPIO 置位/復位寄存器

置位/復位寄存器專門用于操作引腳輸出電平，對 BR (R意為Reset) 寫1會讓對應引腳輸出低電平，對 BS (S意為Set) 寫1會讓對應引腳輸出高電平。操作十分簡單，這里就不贅述了。 ?

? ?

RCC 總線開關

總線就是之前提到過的時間總線 APB1 和 APB2。單片機中的任何外設都需要從總線上獲取時間信號，然而在單片機啟動復位后，所有外設都是默認關閉來節省能源，因此在使用外設前需要手動打開總線開關。 ? RCC (Reset and Clock Control，復位和時鐘控制器) 負責單片機時間總線相關的配置，它的 APB2ENR 寄存器用于開關 APB2 總線上的外設。而 GPIO 外設位于 APB2 總線上，我們查找 RCC_APB2ENR 寄存器 (95頁)： ?

?

? 從圖中可知，對 APB2ENR 的 IOPCEN 寫 1 就可以啟動 GPIOC 外設。 ? ?

Blinky 示例

我們打開之前文章建立的工程項目，修改 src/main.rs 恢復為最小可編譯版本：

#![no_std]
#![no_main]
 extern crate panic_halt;
use core::ptr;
use cortex_m::asm;
use cortex_m_rt::entry;
use stm32f103xx;
#[entry]
 fn main() -> ! {
     asm::nop();
     loop { }
  }

修改 Cargo.toml 中的依賴。在這里我們暫時沒有使用 stm32f103xx 的寄存器功能，只是讓編譯器自動鏈接它提供的中斷向量表，否則會無法編譯：

 [denpendencies] cortex-m = "0.5.8" cortex-m-rt = "0.6.5" panic-halt = "0.2.0" stm32f103xx = "0.11"

我們根據手冊的信息定義寄存器的地址：

const RCC_APB2ENR: *mut u32 = (0x4002_1000 + 0x18) as *mut u32;
const GPIOC_CRH: *mut u32 = (0x4001_1000 + 0x04) as *mut u32;
const GPIOC_BSRR: *mut u32 = (0x4001_1000 + 0x10) as *mut u32;

再定義要用到的寄存器位偏移量：

const APB2ENR_IOPCEN: usize = 4;
const CRH_MODE13: usize = 20;
const BSRR_BS13: usize = 13;
const BSRR_BR13: usize = 13 + 16;

修改 main 函數。

#[entry]
fn main() -> ! {
    unsafe {
// 啟用 GPIOC
        ptr::write_volatile(RCC_APB2ENR, 1 << APB2ENR_IOPCEN);
// 配置 GPIOC - PC13 為推挽輸出
        ptr::write_volatile(GPIOC_CRH, 0b0011 << CRH_MODE13);
// 重置 PC13 以輸出低電平
        ptr::write_volatile(GPIOC_BSRR, 1 << BSRR_BR13);
    }
    loop { }
}

注意這里使用了 ptr::write_volatile() 進行內存寫入操作，這是因為如果使用 ptr::write() 函數，編譯器有可能會把內存的寫入操作優化掉或者調換執行順序，這在內存操作上可以提高效率，但在寄存器上會完全改變我們程序的意圖，導致不可預測的后果。對寄存器的讀操作也同樣不能使用 ptr::read() 而要使用 ptr::read_volatile()。 ? 此時編譯運行就能看到點亮的 LED 了。 ? 接下來我們制造一個簡單的延遲函數：

fn delay() {
for _ in 0..2_000 {
asm::nop();
    }
}

這里使用了一個匯編函數 nop，即為 No Operation。它會空轉耗費 CPU 一個時鐘周期，然后我們再對它循環來得到一個肉眼可見的延遲。 ? 其實按照 Cortex-M3 72MHz 的時鐘速率來計算，2000 周期級別的延遲也應該在毫秒級以下，然而這里的延遲竟然可以達到半秒左右。這是因為在單片機剛啟動的時候，芯片默認采用了啟動較快但是頻率較低的內部時鐘，頻率大概在 40kHz 左右，一般情況下我們在復位后要設置 RCC 的寄存器將時鐘源轉為外部高速時鐘，這部分我們留到之后再細講。 ? 修改 loop 循環：

loop {
    delay();
// Reset：輸出低電平，點亮 LED
    unsafe { ptr::write_volatile(GPIOC_BSRR, 1 << BSRR_BR13); }
    delay();
// Set：輸出高電平，LED 熄滅
    unsafe { ptr::write_volatile(GPIOC_BSRR, 1 << BSRR_BS13); }
}

至此我們的寄存器版本的 Blinky 就完成了！下面是完整代碼：

#![no_std]
#![no_main]
extern crate panic_halt;
use core::ptr;
use stm32f103xx;
use cortex_m::asm;
use cortex_m_rt::entry;
const RCC_APB2ENR: *mut u32 = (0x4002_1000 + 0x18) as *mut u32;
const GPIOC_CRH: *mut u32 = (0x4001_1000 + 0x04) as *mut u32;
const GPIOC_BSRR: *mut u32 = (0x4001_1000 + 0x10) as *mut u32;
const APB2ENR_IOPCEN: usize = 4;
const CRH_MODE13: usize = 20;
const BSRR_BS13: usize = 13;
const BSRR_BR13: usize = 13 + 16;
#[entry]
fn main() -> ! {
    unsafe {
// 啟用 GPIOC
         ptr::write_volatile(RCC_APB2ENR, 1 << APB2ENR_IOPCEN);
// 配置 GPIOC - PC13 為推挽輸出
        ptr::write_volatile(GPIOC_CRH, 0b0011 << CRH_MODE13);
// 重置 PC13 以輸出低電平
        ptr::write_volatile(GPIOC_BSRR, 1 << BSRR_BR13);
    }
     loop {
        delay();
// Reset：輸出低電平，點亮 LED
        unsafe { ptr::write_volatile(GPIOC_BSRR, 1 << BSRR_BR13); }
        delay();
// Set：輸出高電平，LED 熄滅
        unsafe { ptr::write_volatile(GPIOC_BSRR, 1 << BSRR_BS13); }
    }
}
fn delay() {
for _ in 0..2_000 {
        asm::nop();
    }
}

? ?Blinky：抽象

上面代碼中使用的就是 C 語言中操作寄存器的方法，簡單直接。雖然這樣可用，但是可以看出這樣操作的語義非常模糊，常常需要反復翻查手冊，而且這樣會大量使用 unsafe 內存操作，很容易發生人為錯誤。幸好，Rust 為我們提供了更安全的抽象，可以極大地改善以上兩個問題。 ? stm32f103xx 庫安全地封裝了寄存器的操作接口，而且它是由 svd2rust 自動生成的，所以可以杜絕人工錯誤。在 這里 可以找到它的文檔。 ? 我們來看看怎樣使用這個庫：

// 獲取 Peripheralslet dp = stm32f103xx::take().unwrap();// 啟用 GPIOCdp.RCC.apb2enr.write(|w| w.iopben().enabled());

第一行的 stm32f103xx::take() 只會在第一次調用時返回 Some(dp)，這樣避免了存在多個寄存器實例而的導致數據競爭。 ? Peripherals 是一個結構體，它擁有所有外設的接口定義，比如說這里的 RCC。可以對 RCC 的 apb2enr 寄存器進行寫操作，這個庫對寄存器的讀寫操作都被包含在了閉包中，這樣庫可以在讀寫前后執行一些保險操作（重置寄存器值或關閉中斷）。w 是 apb2enr 的寫入器，我們對其調用 w.iopben().enabled() 和之前使用 unsafe 寫入內存完全等價，而且 zero-cost，編譯后的指令一般不會有差別。 ? 同理我們對 GPIOC 的操作可以改寫為：

// 配置 PC13dp.GPIOC.crh.write(|w| w.mode13().output().cnf13().push());// Setdp.GPIOC.bsrr.write(|w| w.bs13().set());// Resetdp.GPIOC.bsrr.write(|w| w.br13().reset());

完整代碼：

#![no_std]
#![no_main]
extern crate panic_halt;
use core::ptr;
use stm32f103xx;
use cortex_m::asm;
use cortex_m_rt::entry;
#[entry]
fn main() -> ! {
// 獲取 Peripherals
    let dp = stm32f103xx::take().unwrap();
// 啟用 GPIOC
    dp.RCC.apb2enr.write(|w| w.iopben().enabled());
// 配置 PC13
    dp.GPIOC.crh.write(|w| w.mode13().output().cnf13().push());
    loop {
        delay();
// Reset：輸出低電平，點亮 LED
        dp.GPIOC.bsrr.write(|w| w.br13().reset());
        delay();
// Set：輸出高電平，LED 熄滅
        dp.GPIOC.bsrr.write(|w| w.bs13().set());
    }
}
fn delay() {
for _ in 0..2_000 {
        asm::nop();
    }
}

相比于 C style 的寄存器操作，svd2rust 封裝了所有寄存器地址信息，而且不需要使用任何 unsafe 代碼，這在 Rust 中保證了不會出現任何內存錯誤。 ? ?

Blinky：再抽象

stm32f103xx 的表現非常驚艷，但是這還沒能完全發掘 Rust 的潛力。嵌入式工作組為我們提供了 embedded-hal 抽象庫，stm32f103xx-hal 就是 embedded-hal 在 stm32f103 上的具體實現。stm32f103xx-hal 庫在 stm32f103xx 的基礎上再次抽象封裝了寄存器的邏輯細節。比如說，stm32f103xx-hal 可以在我們使用 GPIOC 前自動啟用 apb2enr 總線開關。同樣，這個庫也是 zero-cost 的。 ? 修改 Cargo.toml，添加依賴：

[dependencies.stm32f103xx-hal]features = ["rt"]git = "https://github.com/japaric/stm32f103xx-hal"

在 src/main.rs 里引入 hal：

extern crate stm32f103xx_hal as hal;use hal::*;

hal::prelude 中定義了許多 trait，這些 trait 默認實現于外設結構體（比如說 RCC）上來提供 constrain() 轉換函數。constrain() 會將 stm32f103xx 的外設實例轉化為 stm32f103xx-hal 中的外設類型。

let dp = stm32f103xx::Peripherals::take().unwrap();// 將 RCC 寄存器結構體轉換為進一步抽象的 hal 結構體let mut rcc = dp.RCC.constrain();// 獲取 GPIOC 實例，這里會自動打開總線開關let mut gpioc = dp.GPIOC.split(&mut rcc.apb2);// 獲取 PC13 實例，并進行引腳配置let mut led = gpioc.pc13.into_push_pull_output(&mut gpioc.crh);// 輸出高電平led.set_high();// 輸出低電平led.set_low();

完整代碼：

#![no_std]#![no_main]extern crate panic_halt;extern crate stm32f103xx_hal as hal;use core::ptr;use stm32f103xx;use cortex_m::asm;use cortex_m_rt::entry;use hal::*;#[entry]fn main() -> ! 
{// 獲取 Peripherals   
 let dp = stm32f103xx::take().unwrap();// 將 RCC 寄存器結構體轉換為進一步抽象的 hal 結構體  
  let mut rcc = dp.RCC.constrain();// 獲取 GPIOC 實例，這里會自動打開總線開關  
  let mut gpioc = dp.GPIOC.split(&mut rcc.apb2);// 獲取 PC13 實例，并進行引腳配置  
  let mut led = gpioc.pc13.into_push_pull_output(&mut gpioc.crh);   
 loop {  
      delay();// 輸出低電平       
 led.set_low();   
     delay();// 輸出高電平      
  led.set_high();
    }}fn delay() {for _ in 0..2_000 {  
      asm::nop();    }}

Conclusion

這篇文章篇幅較長，從寄存器原理一直講到了內存操作方法，然后展示了如何通過 Rust 強大的抽象能力將零散的內存操作隱藏在安全的操作接口后面，并且還基于 embedded-hal 對寄存器操作的邏輯再一次抽象，得到了安全且容易使用的 API，還可以根據需要靈活選擇抽象級別。相信讀者已經能感受到Rust 在嵌入式領域相對于 C 的巨大的優勢了。

編輯：黃飛

?