前言

前面準備了 RT-Thread qemu mps2-an385 bsp 制作相關的環境與相關文件，本篇開始講解 bsp 如何適配到 RT-Thread

CPU 部分已經適配好了，也就是通過 使能 ARCH_ARM_CORTEX_M3 ，來使能 rt-thread/libcpu/arm/cortex-m3，這部分不需要改動

定時器部分：systick 部分，這部分需要配置，mps2-an385 系統時鐘應該是 25MHz

RT-Thread 啟動入口的執行， 在使用 gcc 時，入口函數為 ：entry

mps2-an385 MCU 上電，第一次執行的是 Reset_Handler，可以查看 鏈接腳本 qemu-mps2-arm/drivers/CMSDK_CM3/Source/GCC/gcc_arm.ld ENTRY(Reset_Handler)

創建 main.c

創建 main.c，位置 qemu-mps2-arm/applications/main.c，可以其他的 bsp 復制一份，代碼簡單一點即可，注意把 構建腳本 SConscript 也復制一份過來

#include
int main(void)
{
rt_kprintf("Hello RT-Thread!n");
while (1)
{
rt_thread_mdelay(5000);
}
}

配置 VS Code gdb 調試

使用 qemu 最方便 gdb 調試，使用 VS Code，可以源碼調試，非常的方便，同時利于 代碼執行流程的梳理，問題的排查定位

在沒有配置或者啟動 RT-Thread 前，在沒有開啟 uart 串口前，使用 gdb 調試，無疑是必要的。

qemu 正常啟動腳本：qemu.sh chmod +x qemu.sh

qemu-system-arm --version
qemu-system-arm -M mps2-an385
-kernel rtthread.bin
-nographic

qemu 調試啟動腳本：qemu-dbg.sh chmod +x qemu-dbg.sh
qemu-system-arm --version
qemu-system-arm -M mps2-an385
-kernel rtthread.bin
-nographic
-s -S
VS Code debug 腳本： .vscode/launch.json，點擊VS Code 左欄 調試按鈕，初次創建 launch.json

{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Launch QEMU RTOSDemo",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/qemu-mps2-arm/rtthread.elf",
"cwd": "${workspaceFolder}",
"miDebuggerPath": "/home/zhangsz/linux/tools/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/bin/arm-none-eabi-gdb",
"miDebuggerServerAddress": "localhost:1234",
"stopAtEntry": true,
}
]
}

初次調試 確認是否進入 Reset_Handler

運行 qemu-dbg.sh， 進入 qemu-mps2-arm 目錄，先執行 ./qemu-dbg.sh，此時會 qemu 會卡住

點擊 VS Code 調試按鈕，然后點擊 開始調試按鈕，【Start Debugging F5】，我的 VS Code 不能直接點擊 F5，這里使用鼠標點擊 開始調試

如果正常進入 Reset_Handler，說明 啟動腳本參與編譯并工作了，接下來就需要對接 entry RT-Thread 入口函數了

系統時鐘 25MHz

Reset_Handler 是 程序的入口， 第一個執行的函數： SystemInit，單步進入，這里可以獲取到系統的時鐘：SYSTEM_CLOCK 為 25MHz94b8b39.html

Reset_Handler 繼續執行，復制 Flash 中的 .text 段 到 SRAM，并且 清零 .bss，啟動文件的一些符號，可以通過查看對比 鏈接腳本 獲取到

【備注】這里 bl _start 應該直接進入 main 函數，由于 RT-Thread 在 main 函數之前，做了初始操作，所以需要改為 RT-Thread entry 入口函數

進入 RT-Thread entry

Reset_Handler >> bl _start 改為 bl entry，這樣調試發現進入了 RT-Thread 的 entry 入口，開始 RT-Thread 系統初始化

RT-Thread 自動初始化等預留的符號

RT-Thread 自動初始化、MSH shell 等符號，在使用 gcc 編譯工具鏈時，需要在 鏈接腳本中預留，否則 RT-Thread 自動初始化失效、MSH shell cmd 也不能正常的使用

修改鏈接文件 qemu-mps2-arm/link.lds，在 .text 段，增加

/* section information for finsh shell /
. = ALIGN(4);
__fsymtab_start = .;
KEEP( (FSymTab))
__fsymtab_end = .;
. = ALIGN(4);
__vsymtab_start = .;
KEEP((VSymTab))
__vsymtab_end = .;
/ section information for initial. /
. = ALIGN(4);
__rt_init_start = .;
KEEP( (SORT(.rti_fn*)))
__rt_init_end = .;

待續： 接下來開啟 RT-Thread 系統 tick 定時器，適配 uart 串口，讓 RT-Thread 運行起來

小結

本篇主要通過 VS Code gdb 的方式，調試入口函數的執行，通過修改入口函數 _start，執行 RT-Thread 入口函數 entry，從而進入 RT-Thread 世界

由于沒有 tick 定時器、串口打印，所以需要進一步完善設備驅動

注意連接腳本：需要為 RT-Thread 自動初始化、MSH shell cmd 等預留 符號在 .text 段