1. ARM 裸板开发从零起步Makefile、链接脚本与裸板 shell 到底解决什么问题如果你手里有一块 ARM 开发板串口线也接好了但敲下make之后只看到一堆.o文件散落在目录里或者烧录进去的 bin 跑起来毫无反应那大概率不是代码写错了而是编译体系和内存布局没搭对。ARM 裸板开发和写单片机点灯最大的区别在于没有操作系统帮你管理内存没有标准库帮你处理输入输出甚至连main函数的第一条指令放在哪个地址都得你自己在链接脚本里说清楚。这一篇要交付的东西很具体一套可以直接复制的 Makefile 模板、一份能控制代码段起始地址的链接脚本、一个跑在串口上的简易裸板 shell 框架以及编译、烧录、串口验证的完整操作步骤。适合刚接触 ARM 裸板、能看懂 C 语言指针、但对「编译产物怎么变成可执行镜像」这件事还比较模糊的开发者。核心检索词就是 ARM 裸板开发、Makefile 编写、链接脚本、裸板 shell 框架。我试过在没有任何构建系统的情况下手动敲gcc -c逐个编译文件一多就彻底乱套改一个头文件要重新编译七八个源文件还容易漏。Makefile 的价值就在这里它根据文件修改时间自动判断哪些文件需要重新编译把「编译—链接—格式转换—拷贝到 tftp 目录」这一整条链路串起来。链接脚本则负责告诉链接器代码段从0x48000000开始放main.o排在最前面数据段和 BSS 段依次往后排。裸板 shell 框架是验证这套体系是否跑通的最好载体——它需要串口驱动、字符串比较、命令解析正好覆盖了裸板开发最基础的几个模块。下面按「先搭编译体系再写链接脚本最后实现 shell 并验证」的顺序展开。每一步都有可复制的代码和命令你跟着敲就能在自己的板子上跑起来。2. TaoToken 调试环境前置准备给裸板 shell 加一个模型对话入口裸板 shell 跑通之后你可能会想能不能在串口里直接问模型一些寄存器配置问题或者让模型帮我检查链接脚本的地址有没有重叠这个思路是可行的但需要先把调试环境准备好。TaoToken 在这里的角色是一个统一的模型调用入口你不需要在本地装一堆 SDK只要拿到 API Key 和 Base URL就能在 PC 端写个小脚本把串口收到的命令转发给模型再把回答通过串口回显到裸板终端上。先做前置准备。打开浏览器访问 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册并登录后进入控制台。在控制台左侧找到「API Keys」菜单创建一个新的 Key复制下来保存好。这个 Key 只显示一次丢了就得重新建。Base URL 固定为https://taotoken.net/api注意这个地址后面不加任何 UTM 参数直接用在代码里。模型 ID 的选择取决于你要做什么。如果只是做命令解释、寄存器位含义查询这类轻量对话选一个响应快的对话模型就够了如果要让模型帮你分析链接脚本的段布局、检查 Makefile 的依赖关系可以选推理能力更强的模型。具体可用的模型 ID 在控制台的模型列表里能看到复制那个字符串就行。这里要强调一点TaoToken 不是用来替代你的编译器和编辑器的它只是调试环节的一个辅助入口。你的 Makefile 该怎么写还怎么写链接脚本该怎么排还怎么排模型对话只是帮你更快定位问题。比如串口输出乱码你可以把 UART 初始化代码贴给模型让它帮你核对波特率分频计算比如链接后main.o没有排在代码段最前面你可以把链接脚本和objdump的输出一起发过去让模型帮你找原因。如果你打算长期在裸板开发里用模型辅助调试可以了解一下 Coding Plan它适合需要频繁调用模型做代码审查和排障的场景。入口在控制台的套餐页面按需选择就行。拿到 Key 之后先别急着写代码用 curl 验证一下 Key 是否有效curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的API_KEY \ -d { model: 你的模型ID, messages: [{role: user, content: 用一句话解释ARM链接脚本里.text段的作用}] }如果返回 JSON 里choices[0].message.content有内容说明 Key 和 Base URL 都配对了。这一步验证通过之后再往下做裸板 shell 的串口转发脚本心里就有底了。3. 可复制配置Makefile 模板、链接脚本与 shell 命令解析代码这一节是全文的核心所有代码都可以直接复制到你的工程目录里。先建一个干净的目录比如arm_shell然后把下面这些文件按名字创建好。3.1 Makefile 模板目标文件、依赖文件与规则Makefile 的结构就三部分目标、依赖、规则。规则前面必须是一个 Tab不能用空格。下面这份模板适配arm-cortex_a9-linux-gnueabi-工具链如果你的交叉编译器前缀不同把CC、LD、OBJCOPY三个变量改掉就行。NAME shell ELF $(NAME).elf BIN $(NAME).bin OBJS main.o uart.o mystrcmp.o led.o beep.o CC arm-cortex_a9-linux-gnueabi-gcc LD arm-cortex_a9-linux-gnueabi-ld OBJCOPY arm-cortex_a9-linux-gnueabi-objcopy CFLAGS -nostdlib -Wall LDFLAGS -nostdlib -nostartfiles $(BIN): $(ELF) $(OBJCOPY) -O binary $(ELF) $(BIN) cp $(BIN) /tftpboot/ $(ELF): $(OBJS) $(LD) $(LDFLAGS) -Tshell.lds $(OBJS) -o $(ELF) %.o: %.c $(CC) $(CFLAGS) -c $ -o $ clean: rm -rf $(BIN) $(ELF) $(OBJS) /tftpboot/$(BIN)这里有几个点值得展开。$代表依赖文件$代表目标文件%.o: %.c是一条模式规则意思是「所有.o文件都从对应的.c文件编译而来」。-nostdlib告诉编译器不要链接标准库因为裸板环境没有printf、malloc这些函数的实现。-nostartfiles告诉链接器不要用默认的启动文件入口地址由链接脚本里的ENTRY指定。cp $(BIN) /tftpboot/这一行是为了配合 tftp 烧录如果你的烧录方式不同把这行删掉或者改成你的拷贝路径。clean目标里用rm -rf把中间产物和 tftp 目录里的 bin 一起清掉避免旧文件干扰。3.2 链接脚本 shell.lds控制代码段起始地址与段布局链接脚本的语法不复杂但每一行都影响最终镜像的内存布局。下面这份脚本把代码段起始地址定在0x48000000并且强制main.o的.text排在最前面。ENTRY(main) SECTIONS { . 0x48000000; .text : { main.o (.text) * (.text) } .data : { * (.data) } .bss : { * (.bss) } }ENTRY(main)指定入口符号为main链接器会把main函数的地址写到 ELF 头里。. 0x48000000是定位计数器表示接下来的段从0x48000000开始排。.text段里先放main.o (.text)再放* (.text)星号代表所有其他输入文件的代码段。这样做的目的是确保main函数一定在镜像的最前面CPU 复位后从起始地址取指第一条指令就是main的第一条指令。.data段放已初始化的全局变量和静态变量.bss段放未初始化的全局变量。裸板环境下.data段的初始值需要你在启动代码里从 Flash 拷贝到 RAM.bss段需要清零否则变量的初始值是随机的。这份脚本只负责布局拷贝和清零的逻辑要写在汇编启动文件里或者用 C 语言在main开头手动做。3.3 裸板 shell 框架串口驱动与命令解析shell 框架的核心是一个死循环打印提示符、读取一行输入、比较命令字符串、执行对应动作。下面把关键文件列出来。main.c#define CMD_MAX_LEN 32 char cmd_buf[CMD_MAX_LEN]; int main(void) { uart_init(); led_init(); beep_init(); while (1) { uart_puts(\nmyArmShell#: ); uart_gets(cmd_buf, CMD_MAX_LEN); if (!mystrcmp(cmd_buf, ledon)) { led_on(); uart_puts(\nledon success...); } if (!mystrcmp(cmd_buf, ledoff)) { led_off(); uart_puts(\nledoff success...); } if (!mystrcmp(cmd_buf, beepon)) { beep_on(); uart_puts(\nbeepon success...); } if (!mystrcmp(cmd_buf, beepoff)) { beep_off(); uart_puts(\nbeepoff success...); } } return 0; }uart.c里的寄存器定义和初始化函数比较长核心是配置 GPIO 复用功能、时钟分频、波特率。波特率计算公式是UBRDIV0 50000000 / (115200 * 16) - 1 26小数部分UFRACVAL0 2。uart_gets逐字符接收遇到\r就结束并在末尾补\0。mystrcmp.c是自己实现的字符串比较不能用标准库的strcmp因为-nostdlib之后标准库不可用int mystrcmp(const char *s1, const char *s2) { while (*s1) { if (*s1 *s2) return 1; else if (*s1 *s2) return -1; s1; s2; } return *s2 0 ? 0 : -1; }led.c和beep.c分别操作 GPIOC 的输出寄存器和输出使能寄存器led_on是清零对应位led_off是置位对应位具体位号看你的板子原理图。3.4 串口转发脚本把 shell 命令发给模型在 PC 端写一个 Python 脚本监听串口把收到的命令通过 TaoToken API 转发给模型再把回答写回串口。这样你在裸板终端里敲ask 什么是BSS段就能看到模型的解释。import serial import requests ser serial.Serial(/dev/ttyUSB0, 115200, timeout1) API_KEY 你的API_KEY BASE_URL https://taotoken.net/api/v1/chat/completions while True: line ser.readline().decode(utf-8, errorsignore).strip() if line.startswith(ask ): question line[4:] resp requests.post(BASE_URL, headers{ Authorization: fBearer {API_KEY}, Content-Type: application/json }, json{ model: 你的模型ID, messages: [{role: user, content: question}] }) answer resp.json()[choices][0][message][content] ser.write((\n answer \n).encode())这个脚本只是调试辅助不参与裸板编译。串口设备名根据你的系统改Linux 下通常是/dev/ttyUSB0Windows 下是COM3之类。4. 验证请求与成功结果编译、烧录、串口交互全流程代码写完之后按下面的顺序操作。每一步都有预期结果如果对不上就去第 5 节找对应的报错。第一步在工程目录下执行make。预期输出是依次编译各个.c文件然后链接生成shell.elf再用objcopy转成shell.bin最后拷贝到/tftpboot/。如果看到arm-cortex_a9-linux-gnueabi-gcc: command not found说明工具链没装或者没加到 PATH 里。第二步用arm-cortex_a9-linux-gnueabi-objdump -h shell.elf查看段布局。预期看到.text段的 VMA 是0x48000000.data和.bss紧随其后。如果.text的地址不是0x48000000检查链接脚本里的. 0x48000000有没有写错以及 Makefile 里-Tshell.lds有没有生效。第三步烧录。如果你的板子支持 tftp在 U-Boot 里执行tftp 0x48000000 shell.bin然后go 0x48000000。如果不支持用你的烧录器把 bin 写到 Flash 的对应地址。第四步打开串口终端波特率 1152008N1无流控。预期看到myArmShell#:提示符。输入ledon回车预期看到ledon success...同时板子上的 LED 点亮。输入beepon蜂鸣器响。输入一个不存在的命令比如abc预期没有任何动作直接回到提示符。第五步验证模型转发。在串口里输入ask 链接脚本里.data段和.bss段有什么区别预期几秒后串口回显一段解释文字。如果串口没反应检查 Python 脚本是否在运行、串口设备名是否正确、API Key 是否有效。到这里Makefile 编译体系、链接脚本布局、裸板 shell 交互、模型调试入口这四件事就串起来了。你可以在这个框架上继续加命令比如read 0x48000000读内存、write 0x48000000 0x12345678写内存逐步把 shell 做成一个简易的调试器。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错裸板开发本身报错就多加上模型转发环节问题会出现在两个层面。下面按真实遇到的报错逐个说。401 Unauthorized。这个报错来自 TaoToken API说明 API Key 无效或者没带上。检查 curl 命令里的Authorization: Bearer后面有没有空格Key 有没有复制完整。如果你用的是 Python 脚本检查API_KEY变量有没有被引号包住以及请求头里的Bearer拼写。还有一种情况是 Key 被删除了去控制台重新建一个。local proxy failed。这个报错通常出现在你本地设置了网络代理但代理没有正常工作时。裸板开发环境里如果装了某些网络工具可能会干扰 API 请求。检查你的环境变量http_proxy和https_proxy如果不需要就清掉。注意这里说的是本地网络配置问题不是让你去用什么特殊工具直接把代理关掉用直连就行。reading choices 报错。Python 脚本里resp.json()[choices][0]抛 KeyError说明返回的 JSON 里没有choices字段。先打印resp.text看完整返回内容。常见原因是模型 ID 写错了或者请求体里的messages格式不对。正确的格式是[{role: user, content: 你的问题}]注意content是字符串不是列表。OAuth 相关报错。如果你在配置某些开发工具时看到 OAuth 失败检查回调地址有没有写对。TaoToken 的 API 调用不需要 OAuth直接用 API Key 就行。如果你在用 Claude Code 这类工具配置项里要填的是 Base URL 和 Key不是 OAuth 客户端 ID。Base URL 填https://taotoken.net/apiKey 填你创建的那个。链接报错 undefined reference tomain。检查链接脚本里的ENTRY(main)和 Makefile 里-Tshell.lds有没有同时生效。如果main.o没有参与链接也会报这个错检查OBJS变量里有没有main.o。串口乱码。先确认波特率是不是 115200再确认时钟分频计算对不对。UBRDIV0 26、UFRACVAL0 2是在 50MHz 时钟下算出来的如果你的板子时钟不同重新算。另外检查ULCON0 0x03是不是 8N1UCON0 0x05是不是轮询模式。烧录后没反应。用objdump -h确认.text起始地址和你的烧录地址一致。如果链接脚本写的是0x48000000但烧录到了0x40000000CPU 从0x48000000取指就会读到空数据。另外确认 bin 文件大小和烧录范围匹配。6. 继续往下走把裸板 shell 变成你的调试工作台这套框架跑通之后最实用的扩展方向是加内存操作命令。比如md 0x48000000 16读 16 个字mw 0x48000000 0x12345678写一个字。实现方式是在main.c的命令比较里加分支解析地址和长度参数然后直接解引用指针。注意裸板环境下访问非法地址会触发异常所以命令解析里要做好地址范围检查。另一个方向是把模型转发做得更顺滑。现在的 Python 脚本是轮询串口你可以改成用pyserial的in_waiting属性做非阻塞读取避免readline卡住。还可以加一个本地命令缓存把常用的寄存器查询结果存下来减少 API 调用次数。如果你在多个板子之间切换Makefile 里的工具链前缀和链接脚本起始地址会不一样。可以把这些做成变量用make BOARDxxx的方式传入或者建几个不同的.lds文件在 Makefile 里根据目标选择。这样一套代码就能适配多块板子。调试环境方面TaoToken 的 API Keys 页面可以管理多个 Key给不同的项目建不同的 Key方便排查问题时定位是哪个项目在调用。接入文档里有完整的请求示例和错误码说明遇到不认识的报错先去文档里查。模型对话页面可以直接在浏览器里测试模型是否可用不用写代码。如果你打算把模型辅助调试长期用下去Coding Plan 的入口在控制台套餐页按需开通就行。最后提醒一句裸板开发里最耗时间的往往不是写代码而是确认「代码到底被链接到了哪个地址」。养成每次改完链接脚本就用objdump -h看一眼段布局的习惯能省下大量烧录试错的时间。