LiuJuan20260223Zimage部署STM32F103C8T6开发环境

LiuJuan20260223Zimage部署STM32F103C8T6开发环境

1. 场景引入：为什么选择这个方案

如果你手头有一块STM32F103C8T6最小系统板，想要快速开始开发，但又被繁琐的环境配置和工具链安装劝退，那么今天介绍的方案可能会让你眼前一亮。

传统的STM32开发环境搭建需要安装IDE、配置编译器、安装驱动、设置烧录工具...一套流程下来半天时间就没了。而现在，通过LiuJuan20260223Zimage，你可以在几分钟内获得一个完整的开发环境，直接开始写代码和烧录。

这个方案特别适合：

• 刚接触STM32的初学者，不想在环境配置上浪费时间
• 需要快速验证想法的开发者，追求极致的开发效率
• 团队协作场景，保证所有人的开发环境一致

2. 环境准备与快速启动

在开始之前，你需要准备以下硬件：

• STM32F103C8T6最小系统板（就是那种蓝色的核心板）
• USB转TTL串口模块（用于程序烧录和调试）
• 几根杜邦线用于连接
• 一台能运行Docker的电脑

软件方面反而简单，因为所有开发工具都已经打包在LiuJuan20260223Zimage中了。你只需要确保系统安装了Docker，然后一行命令就能启动开发环境：

docker run -it --privileged -v $(pwd):/workspace liujuan20260223zimage:stm32

这个命令做了三件事：启动容器、挂载当前目录作为工作区、赋予设备访问权限。完成后你就获得了一个完整的STM32开发环境，包含了编译器、烧录工具、调试工具等所有必要组件。

3. 工具链配置详解

进入容器后，你会发现所有工具都已经配置好了。这里简单介绍几个核心工具：

ARM GCC编译器- 用于将C代码编译成STM32可执行的二进制文件

arm-none-eabi-gcc --version # 输出显示编译器版本，确认工具链正常工作

OpenOCD- 开源调试和烧录工具，支持多种调试器

openocd --version # 验证调试工具是否就绪

STM32CubeProgrammer- 官方的烧录工具，也包含在环境中

STM32_Programmer_CLI --version # 检查烧录工具状态

环境还预装了STM32CubeMX的项目配置文件，你可以直接基于这些配置开始开发，无需从头创建工程。

4. 第一个程序：点亮LED

让我们从一个简单的例子开始，点亮板载的PC13 LED。

首先创建项目目录结构：

mkdir led_blink && cd led_blink mkdir src include build

创建主程序文件src/main.c：

#include "stm32f1xx.h" void delay(void) { for (volatile int i = 0; i < 500000; i++); } int main(void) { // 启用GPIOC时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPCEN; // 配置PC13为推挽输出模式 GPIOC->CRH &= ~(GPIO_CRH_MODE13 | GPIO_CRH_CNF13); GPIOC->CRH |= GPIO_CRH_MODE13_0; while (1) { // 翻转PC13引脚状态 GPIOC->ODR ^= GPIO_ODR_ODR13; delay(); } }

创建编译脚本build.sh：

#!/bin/bash arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb -Wall -g -O0 \ -I../include -c ../src/main.c -o main.o arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb -Tstm32f103c8t6.ld \ -nostdlib -Wl,-Map=output.map main.o -o output.elf arm-none-eabi-objcopy -O binary output.elf output.bin

给脚本执行权限并运行：

chmod +x build.sh ./build.sh

编译成功后会在build目录生成output.bin文件，这就是我们要烧录的二进制程序。

5. 程序烧录实战

有了编译好的程序，接下来就是烧录到板子上。根据你使用的烧录方式，选择对应的方法。

使用USB转TTL烧录（最常用方式）：

1. 连接硬件：TX接A9（RX）、RX接A10（TX）、GND接GND
2. 设置启动模式：BOOT0跳线帽接1，BOOT1接0
3. 执行烧录命令：

python3 /tools/stm32loader.py -e -w -v output.bin

使用ST-Link烧录（调试时推荐）：

openocd -f interface/stlink.cfg -f target/stm32f1x.cfg \ -c "program output.bin verify reset exit"

烧录完成后，将BOOT0跳线帽接回0，按复位键就能看到LED开始闪烁了。

6. 外设驱动开发示例

掌握了基本流程后，我们来尝试更复杂的外设驱动。以串口通信为例，实现printf功能。

首先在include目录创建头文件uart.h：

#ifndef UART_H #define UART_H void uart_init(void); void uart_send_char(char c); void uart_send_string(const char *str); #endif

然后实现串口驱动src/uart.c：

#include "stm32f1xx.h" #include "uart.h" void uart_init(void) { // 启用GPIOA和USART1时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPAEN | RCC_APB2ENR_USART1EN; // 配置PA9为复用推挽输出（TX） GPIOA->CRH &= ~(GPIO_CRH_MODE9 | GPIO_CRH_CNF9); GPIOA->CRH |= GPIO_CRH_MODE9_0 | GPIO_CRH_CNF9_1; // 配置PA10为浮空输入（RX） GPIOA->CRH &= ~(GPIO_CRH_MODE10 | GPIO_CRH_CNF10); GPIOA->CRH |= GPIO_CRH_CNF10_0; // 配置USART1：115200波特率，8位数据，无校验 USART1->BRR = 72000000 / 115200; USART1->CR1 = USART_CR1_UE | USART_CR1_TE | USART_CR1_RE; } void uart_send_char(char c) { while (!(USART1->SR & USART_SR_TXE)); USART1->DR = c; } void uart_send_string(const char *str) { while (*str) { uart_send_char(*str++); } }

修改主程序使用串口功能：

#include "stm32f1xx.h" #include "uart.h" int main(void) { uart_init(); uart_send_string("Hello STM32!\r\n"); while (1) { uart_send_string("UART is working...\r\n"); for (volatile int i = 0; i < 1000000; i++); } }

重新编译烧录后，用串口调试工具连接板子，就能看到发送的数据了。

7. 调试技巧与问题排查

在实际开发中，难免会遇到各种问题。这里分享几个实用的调试技巧：

常见问题1：程序烧录失败

• 检查BOOT引脚设置是否正确
• 确认串口模块连接正确（TX-RX交叉连接）
• 尝试降低烧录波特率：-b 9600

常见问题2：程序运行不正常

• 检查电源是否稳定（最好外接供电）
• 确认复位电路正常工作
• 使用LED或串口输出调试信息

使用printf调试：

// 重定义fputc函数，支持printf int fputc(int ch, FILE *f) { uart_send_char(ch); return ch; } // 然后在代码中可以直接使用 printf("变量值: %d\r\n", value);

逻辑分析仪调试：对于时序要求严格的场景，可以用逻辑分析仪查看引脚波形，确认程序执行是否符合预期。

8. 开发体验总结

实际使用下来，这个基于LiuJuan20260223Zimage的开发方案确实带来了不少便利。最大的优点就是环境配置极其简单，省去了大量前期准备工作。所有工具都是开箱即用，版本也经过验证，避免了因工具版本不匹配导致的各种奇怪问题。

性能方面，在容器中编译代码的速度完全可以接受，日常开发不会感到明显延迟。而且由于环境是容器化的，在不同机器间迁移项目特别方便，只需要保证D环境一致即可。

对于初学者来说，这个方案大大降低了入门门槛。你不需要了解复杂的工具链配置，也不需要处理各种依赖问题，只需要专注在STM32本身的学习和开发上。

当然也有一些需要注意的地方，比如对宿主机的Docker环境有要求，在某些Windows版本上可能需要额外配置。但总体而言，利远大于弊，特别适合快速原型开发和教学场景。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。