单片机的半主机模式与 MicroLib 机制(Keil UseMicroLIB)

[1. 引言](#1. 引言)

[2. 什么是半主机模式？](#2. 什么是半主机模式？)

为什么会卡死？

[3. 什么是 MicroLib？（新手必看）](#3. 什么是 MicroLib？（新手必看）)

[MicroLib 的核心特点](#MicroLib 的核心特点)

一句话总结

[4. 两种解决方案（任选其一即可）](#4. 两种解决方案（任选其一即可）)

[方案 1：勾选 MicroLib（最简单，新手首选）](#方案 1：勾选 MicroLib（最简单，新手首选）)

[方案 2：手动禁用半主机（不勾选 MicroLib 也能用）](#方案 2：手动禁用半主机（不勾选 MicroLib 也能用）)

1. 引言

最近闲下来翻出了之前的开发板，想着重温一下嵌入式开发的乐趣，结果刚上手就栽了跟头。

按照记忆里的参数一通配置，编译下载后程序死活不执行，无奈换回之前备份的一套老程序，居然能正常跑起来！我当场就纳闷了：两套工程晶振配置一模一样，总不能是晶振不起振吧？不死心，直接切换成芯片内部晶振，重新编译、仿真，程序依旧纹丝不动。

行，今天不把你搞定，我就不罢休！

抱着排查问题的心态开启仿真调试，一眼就看到了关键异常：程序执行到了 0xAB 指令。

查资料才知道，BKPT 0xAB 是 ARM 半主机模式的标准触发指令，程序跑到这里，会主动向调试器请求主机服务；再往下看，调用栈里还蹦出个从没见过的 _sys_open 函数，一查才明白，这是标准 C 库（Newlib/ARM 库）里，专门依赖半主机模式实现的文件操作函数。

到这里直接锁定元凶：程序卡死在半主机模式了！

为啥会触发半主机卡死？根源就是我自己写的 fputc 重定向（用来做串口打印）。

翻遍各种教程，排除了晶振、供电、引脚配置所有问题后，终于抓到了最后一个关键：MicroLib。

抱着试一试的心态勾选上 MicroLib，程序瞬间正常运行了！可我另一套能跑的老工程，压根没勾选这个选项啊？琢磨了半天恍然大悟：老程序里早就写了禁用半主机的代码，相当于手动关掉了这个坑人的模式。

下面就把我踩坑后搞明白的知识点，一次性讲清楚！

2. 什么是半主机模式？

半主机模式，简单说就是ARM 芯片的一种调试专用机制。

它的作用是：让单片机（开发板）不直接操作硬件，而是通过调试器（比如仿真器），借用电脑的资源完成操作 ------ 比如用电脑的屏幕打印日志、用电脑的硬盘读写文件。

实现这个功能的核心，就是我们看到的 BKPT 0xAB 指令，还有 _sys_open、_sys_write 这类系统函数。

为什么会卡死？

正常调试 + 开启半主机 时：程序执行 BKPT 0xAB，调试器会接住请求，帮单片机完成操作，程序继续跑；
我们日常独立运行时：没有调试器响应这个指令，单片机就会一直等、一直等，直接卡死不动。

我遇到的情况就是：写了 fputc 重定向，却没禁用半主机，标准库默认调用了半主机相关函数，程序直接卡在原地。

3. 什么是 MicroLib？（新手必看）

MicroLib 全称 ARM MicroLIB ，是 Keil 专门为单片机这种嵌入式小资源设备 设计的精简版标准 C 库。

我们平时电脑用的标准 C 库（Newlib）功能全，但体积大、还依赖半主机模式，不适合单片机；而 MicroLib 就是它的 "轻量化平替"。

MicroLib 的核心特点

体积超小：砍掉了单片机用不到的复杂功能，代码占用空间极小，特别适合 Flash、RAM 有限的开发板；
默认禁用半主机模式 ：这是最关键的！不用自己写禁用代码，不会触发 BKPT 0xAB 卡死，直接适配串口 printf 重定向；
兼容基础 C 库函数 ：printf、malloc、memset 这些常用函数都能用，完全满足日常开发；
专为嵌入式裸机开发：不依赖操作系统，拿来就能用，对新手极度友好。

一句话总结

不勾选 MicroLib + 没写禁用半主机代码 → 必卡死（就是我踩的坑）；
勾选 MicroLib → 自动避开半主机坑，程序直接跑；
不勾选 MicroLib + 手动写禁用半主机代码 → 也能正常跑（我那套老工程的做法）。

4. 两种解决方案（任选其一即可）

方案 1：勾选 MicroLib（最简单，新手首选）

Keil 操作路径：Target → 勾选 Use MicroLIB → 重新编译下载，直接解决问题。

方案 2：手动禁用半主机（不勾选 MicroLib 也能用）

就是我老工程里用的方法，直接复制这段代码到工程里即可：

复制代码

#include <stdio.h>

// 1. 声明禁止半主机模式
#pragma import(__use_no_semihosting)

// 2. 定义标准库需要的结构体
struct __FILE {
    int handle;
};
FILE __stdout;

// 3. 串口重定向fputc（printf核心函数）
int fputc(int ch, FILE *f) {
    HAL_UART_Transmit(&huart2, (uint8_t *)&ch, 1, 100);
    return ch;
}

// 4. 实现退出函数，解决链接报错
void _sys_exit(int x) {
    x = x;
}

问题到这就解决了，希望可以帮到各位。