**读者:**要把一块板子支起来,好让工程能用 mcpp build 面向它、用 mcpp run
抵达它的人。
**本章回答的那一个问题:**一个板级支持包供给什么,以及一个包怎样同时服务模拟器与 真实板子。
**不在这里:**使用一个 BSP,那是 40 —— 裸机与 freestanding 目标;消费者看到的 runner 机制,那是 41 —— 抵达一台设备;以及把模拟器或探针驱动本身打包,那是 32 —— 编写一个载荷。
在此之前:33 —— 编写运行时适配包。
freestanding 目标没有操作系统,所以 hosted 程序白得的一切都必须来自某处。BSP 就是 那个某处,它供给整个目标世界:
| 内容 | |
|---|---|
| 内存布局 | 一份链接脚本 —— 程序既推导不出、也猜不到的那一个事实 |
| 启动代码 | main 之前跑的东西,以及向量表 |
| 一个导出模块 | 程序 import 它来够到板子的控制台与外设 |
| runner | mcpp run 与 mcpp test 究竟怎样抵达这块板子 |
最容易被漏掉的是 runner;少了它,每个消费者都要自己写一遍模拟器的调用。
经模拟器抵达的板子,与经调试探针抵达的同一块板子,差别只在 runner 的 argv,别处 一个字都不差。链接脚本、启动代码、内存布局与导出模块是同一块板子。为了改四个字符串 而发两个包,会把这一切复制一遍,并让两份副本各自漂移。
所以环境是一个 feature:
[features]
default = ["emulator"]
emulator = {}
hardware = {}
[feature-xlings.emulator]
"xim:qemu-arm" = { version = "9.2.4-1", when = "run" }
[feature-xlings.hardware]
"xim:probe-rs" = { version = "", when = "run" }emulator 是默认,而这是一个关于「谁在读」的决定。 刚接触这个包的人手边没有
板子;手边有板子的人有理由把它说出来。一个要求硬件的默认值,会让所有还没买东西的人
的第一条命令就失败。
两张表刻意对称:哪种环境都不是引擎眼里的「正常」,而消费者只下载它所选 feature 需要 的那一份。
并且两者都在 run 档位上 —— 这是第二道独立的闸门。 feature 说谁需要这个工具;
档位说什么时候。编译固件两者都不需要,只有抵达板子才需要,所以一个只构建、从不
烧录的 CI 任务一个字节都不下载。
每一行 thumb*-none-eabi* 的 C 库列都是空的,所以面向它的工程一开始没有 libc,
除非它开口要。BSP 停在这一档:它不引用任何 C 库符号,它的控制台走 semihosting 而不是
stdio。
libc = {}
[feature-deps.libc]
picolibc.picolibc = "1.8.12.3"C 库以源码包的形式到达,用程序自己的旗标编译,于是没有 multilib 要匹配、也没有
ABI 约定会弄错。mcpp run --features libc 就是全部;不选它,零 libc 档原样保留。
int main() {
mcpp::link_script("cortex-m.ld");
mcpp::rerun_if_changed("cortex-m.ld");
const std::string target = mcpp::target() ? mcpp::target() : "";
if (mcpp::has_feature("hardware")) {
for (auto a : {"probe-rs", "run", "--chip", "STM32L475VG"})
mcpp::runner(a);
mcpp::run_exclusive();
} else {
/* 这个目标对应的模拟器 argv */
}
return 0;
}哪个机器型号对应哪个目标,是一张表,不是一个默认值。 为 thumbv6m 构建的镜像
在实现 thumbv7em 的型号上跑不起来,而猜错的结果是它启动了、然后在毫不相干的地方
faul。表里没有这一行时要点名报错,而不是静默缺席 —— 一个没有配置 runner 的 BSP
会让 mcpp run 报「缺少 runner」并建议加一个 runner 键,那句话一般而言是对的,而
在这里不是原因。
写程序名,不写路径。 mcpp 会搜索图中任何包声明过的每一个载荷的 bin/,然后才是
PATH,并且能准确报出它搜过哪些目录。用安装目录拼出来的绝对路径引入了一种失败形态:
查找返回空,而没有任何东西说明为什么。
引擎不认识上面任何一个 runner 名字。 flash、serve、erase 是这个包的词汇;
另一个包提供的 serve 可以是别的意思,而两者都不必被 mcpp 知道。
一个探针,一个使用者。 mcpp::run_exclusive() 声明这个目标的运行不可重叠,
mcpp test 随后把它们串行化。工程方永远不需要记得加 -j1。
- BSP 把它的模拟器与探针驱动声明为载荷,因此工具链未在某个平台发布的板子,就无法 从那个平台抵达。
- 机器型号表是按三元组组织的。需要表里没有的型号的板子,要改 BSP,而不是在工程侧 覆盖。