大家好，我是痞子衡，是正經(jīng)搞技術(shù)的痞子。今天痞子衡給大家分享的是**IAR下調(diào)試信息輸出機(jī)制之半主機(jī)(Semihosting)**。

在嵌入式世界里，輸出打印信息是一種非常常用的輔助調(diào)試手段，借助打印信息，我們可以比較容易地定位和分析程序問(wèn)題。在嵌入式應(yīng)用設(shè)計(jì)里實(shí)現(xiàn)打印信息輸出的方式有很多，本系列將以 IAR 環(huán)境為例逐一介紹 ARM Cortex-M 內(nèi)核 MCU 下打印信息輸出方法。

上一篇文章 《IAR下調(diào)試信息輸出機(jī)制之硬件UART外設(shè)》 里我們介紹了利用 MCU 芯片內(nèi)的硬件 UART 外設(shè)去做打印輸出的方式，這種方式很簡(jiǎn)單，還可以脫離在線調(diào)試環(huán)境去使用，但畢竟占用了芯片內(nèi)部的外設(shè)資源，而且調(diào)試的時(shí)候還需要額外連接串口線路，稍微麻煩了一點(diǎn)。今天痞子衡介紹一種在 IDE 中結(jié)合仿真器直接做打印輸出的方式，即半主機(jī)(Semihosting)技術(shù)。

• Note：本文使用的 IAR EWARM 軟件版本是 v9.10.2。

一、打印輸出整體框圖

老規(guī)矩先簡(jiǎn)介下本文介紹的打印輸出方法整體軟硬件框圖，硬件上主要是 PC 主機(jī)、MCU 目標(biāo)板、一個(gè) ARM 仿真器（DAP-Link 或者 J-Link 都可以）。

軟件上 PC 這邊就需要 IAR 開(kāi)發(fā)環(huán)境即可，這里在編譯目標(biāo)板 MCU 應(yīng)用程序時(shí)，除了需要包含打印輸出相關(guān)代碼（標(biāo)準(zhǔn) I/O 庫(kù)接口），底層接口實(shí)現(xiàn)必須選用 IAR 的 Semihosting 庫(kù)。當(dāng) MCU 程序運(yùn)行起來(lái)后（需要保持在線調(diào)試狀態(tài)），仿真器實(shí)時(shí)捕獲代碼里的打印輸出需求，將這種 I/O 訪問(wèn)需求轉(zhuǎn)移到 PC 主機(jī)上來(lái)完成，然后我們?cè)?IAR 的 Terminal I/O 窗口里可以看到打印信息。

上圖里 MCU 應(yīng)用程序中的 printf() 打印輸出需求到底是如何轉(zhuǎn)移到 PC 主機(jī)上 IAR 軟件里去完成的，這是本文要研究的重點(diǎn)。

二、Semihosting機(jī)制原理

Semihosting 中文為半主機(jī)(半托管)，這是一個(gè)在嵌入式系統(tǒng)中已經(jīng)流傳了幾十年的技術(shù)。Semihosting 技術(shù)將應(yīng)用程序中的 I/O 請(qǐng)求通過(guò)一定的通道傳送到主機(jī)(host)，由主機(jī)上的資源響應(yīng)應(yīng)用程序的 I/O 請(qǐng)求，而不是像在主機(jī)上執(zhí)行本地應(yīng)用程序一樣，由應(yīng)用程序所在的硬件系統(tǒng)來(lái)響應(yīng)應(yīng)用程序 I/O請(qǐng)求，簡(jiǎn)單說(shuō)就是將目標(biāo)板的輸入/輸出請(qǐng)求從應(yīng)用程序代碼傳遞到遠(yuǎn)程運(yùn)行調(diào)試器的主機(jī)上的一種機(jī)制。

ARM 也定義了這種 Semihosting 機(jī)制實(shí)現(xiàn)，我們?cè)谀繕?biāo) ARM 開(kāi)發(fā)板代碼中加入 printf,scanf 等函數(shù)調(diào)用時(shí)，這些函數(shù)并不是鏈接到目標(biāo)開(kāi)發(fā)板的庫(kù)函數(shù)，而是遠(yuǎn)程主機(jī)交叉編譯器中帶有的庫(kù)函數(shù)，并且這些庫(kù)函數(shù)被編譯時(shí)會(huì)額外插入軟件中斷指令，早期的 ARMv7 架構(gòu)下軟中斷使用得是 SVC 指令（SWI 指令），而對(duì)于 Cortex-M 處理器（ARMv6-M 或者 ARMv7-M 架構(gòu)），這個(gè)軟件中斷指令是 BKPT。

我們可以在 ARMv6/7/8-M Architecture RM 手冊(cè)里找到 BKPT 指令定義，其中 imm8 是指定存儲(chǔ)在指令中的 8 位值，這個(gè)值會(huì)被處理器忽略，但是調(diào)試器可以使用它來(lái)存儲(chǔ)關(guān)于斷點(diǎn)的附加信息。

如果 BKPT 指令是用于觸發(fā) Semihosting 請(qǐng)求，其 imm8 值應(yīng)該被設(shè)為 0xAB，這是 ARM 的規(guī)定。因此當(dāng)仿真器捕獲到 BKPT #0xab 指令時(shí)便會(huì)讓主機(jī)響應(yīng)接下來(lái)的 I/O 請(qǐng)求。

現(xiàn)在可以觸發(fā) Semihosting 請(qǐng)求了，但是 I/O 請(qǐng)求的種類很多，主機(jī)該如何區(qū)分呢？別擔(dān)心，ARM 還規(guī)定了 R0 寄存器來(lái)存放請(qǐng)求的類型（編譯器應(yīng)該在 BKPT 指令前，將請(qǐng)求類型值放到 R0 寄存器里），我們可以在 ARM 開(kāi)發(fā)者官網(wǎng)找到這些請(qǐng)求類型定義以及詳細(xì)解釋。整個(gè) Semihosting 機(jī)制至此就清楚了，各大 IDE 只需要按照這個(gè)規(guī)定去具體實(shí)現(xiàn)即可。

https://developer.arm.com/documentation/dui0471/g/Semihosting/Semihosting-operations?lang=en

關(guān)于更詳細(xì)的 Semihosting 機(jī)制，可以參考 SEGGER 整理的一篇博客 https://wiki.segger.com/Semihosting 。

三、IAR 對(duì) Semihosting 機(jī)制的支持

IAR 對(duì) ARM 定義的 Semihosting 機(jī)制是有完善支持的，我們按上一篇的老辦法，看工程編譯鏈接后生成的 .map 文件，找到 IAR 實(shí)現(xiàn) Semihosting 的相關(guān)源文件。

3.1 Terminal I/O 查看打印效果

繼續(xù)以上一篇文章使用的 SDK_2.11.0_EVK-MIMXRT1060oardsevkmimxrt1060demo_appshello_worldiar 工程為例，簡(jiǎn)單改造一下工程里 hello_world.c 文件里的 main() 函數(shù)，將原來(lái)代碼全部刪掉（原來(lái)的打印輸出涉及恩智浦 SDK 封裝，本文沒(méi)必要關(guān)心其實(shí)現(xiàn)），只要如下一句打印即可：

#include?
int?main(void)
{
????printf("hello?world.
");
????while?(1);
}

然后注意工程選項(xiàng)里 Library low-level interface implementation 選項(xiàng)，這里我們選 Semihosted 方式，并且 stdout/stderr 選擇 Via semihosting。這時(shí)候底層 I/O 完全由 IAR 內(nèi)置 Semihosting 庫(kù)來(lái)搞定了。

我們將 MCU 目標(biāo)板供上電，并連接調(diào)試器在線跑起來(lái)看看效果，在 IAR 菜單欄 View 里打開(kāi) Terminal I/O 窗口，全速運(yùn)行，可以看到有 hello world. 字樣打印輸出，沒(méi)有真實(shí)的串口線路物理連接，照樣能實(shí)現(xiàn)打印了。

3.2 Semihosting庫(kù)I/O響應(yīng)設(shè)計(jì)

IAR 的 Terminal I/O 窗口里怎么就能看到打印輸出的呢？我們?cè)?IAR SystemsEmbedded Workbench 9.10.2armdocEWARM_DevelopmentGuide.ENU 手冊(cè)里找到了玄機(jī)，其實(shí)是 IAR 里的調(diào)試組件 C-SPY 負(fù)責(zé)響應(yīng)調(diào)試器捕捉到的來(lái)自 MCU 的 I/O 訪問(wèn)需求，并負(fù)責(zé)解釋 Semihosting 庫(kù)源碼，然后模擬了對(duì)應(yīng) I/O 操作。

3.3 Semihosting庫(kù)相關(guān)源碼實(shí)現(xiàn)

現(xiàn)在我們?cè)賮?lái)查看生成的 hello_world.map 文件，除了 dl7M_tln.a 部分多了 XShttio.o 目標(biāo)文件外，還增加了 shb_l.a 庫(kù)（里面有一系列 .o 文件），這些增加的 .o 文件均是 Semihosting 庫(kù)相關(guān)源碼實(shí)現(xiàn)。我們可以在 IAR SystemsEmbedded Workbench 9.10.2armsrclibsemihosting 目錄下找到 XShttio.c 源文件，這個(gè)主要是 ARM 標(biāo)準(zhǔn) Semihosting 實(shí)現(xiàn)層，但是偏 IAR 這一層的 iarttio.o、iarwrite.o、iarwstd.o 并沒(méi)有公開(kāi)源碼，這可能屬于 IAR 軟件商業(yè)機(jī)密了吧。

*******************************************************************************
*** MODULE SUMMARY
***

    Module                ro code  ro data  rw data
    ------                -------  -------  -------
dl7M_tln.a: [10]
    XShttio.o                   8        8        8
    abort.o                     6
    exit.o                      4
    low_level_init.o            4
    printf.o                   40
    putchar.o                  32
    xfail_s.o                  64                 4
    xprintfsmall_nomb.o     1'281
    xprout.o                   22
    -----------------------------------------------
    Total:                  1'461        8       12

shb_l.a: [13]
    dwrite.o                   30
    exit.o                     20
    iarttio.o                 124
    iarwrite.o                 34
    iarwstd.o                  32
    write.o                    16
    -----------------------------------------------
    Total:                    256

3.4 從反匯編文件看Semihosting實(shí)現(xiàn)

最后我們?cè)購(gòu)墓こ谭磪R編文件角度看一下 Semihosting 機(jī)制是不是如第二小節(jié)原理里介紹得那樣，先借助 IAR 小工具 ielfdumparm.exe 將工程可執(zhí)行文件 hello_world.out 轉(zhuǎn)換成反匯編文件 hello_world.dump。

ielfdumparm.exe --source --code .hello_world.out -o .hello_world.dump

然后使用任意文本編輯器打開(kāi)這個(gè)反匯編文件 hello_world.dump，在里面搜索 BKPT 指令，確實(shí)能夠看到插入了多處軟中斷指令用于觸發(fā) Semihosting，并且軟中斷指令前都裝載了 R0 寄存器，痞子衡截取的片段里 R0 裝載的值是 5，從 ARM 文檔里查詢，這對(duì)應(yīng)了 SYS_WRITE 訪問(wèn)請(qǐng)求。

至此，IAR下調(diào)試信息輸出機(jī)制之半主機(jī)(Semihosting)痞子衡便介紹完畢了，掌聲在哪里~~~

?