1. 项目背景与目标
最近在照顾冬眠的巴西龟时，突然意识到需要监测水温。市面上现成的水温计虽然方便，但作为一个嵌入式开发爱好者，手头正好有STM32最小系统板、DS18B20温度传感器和LCD显示屏，为什么不自己动手做一个智能水温监测系统呢？
这个想法很快扩展成了更完整的方案：除了基础的温度显示功能外，还可以加入ESP8266 WiFi模块实现远程监控和报警功能。相比单一功能的水温计，这个方案不仅更具挑战性和学习价值，还能根据需求灵活扩展功能。
2. 开发环境搭建
2.1 硬件准备清单
在开始之前，我整理了手头现有的硬件设备：
- 主控芯片：STM32F103C6T6A最小系统板（虽然市面上更常见的是C8T6版本，但C6T6A价格更实惠且功能足够）
- 编程调试器：ST-LINK V2（必备的烧录和调试工具）
- 温度传感器：DS18B20防水探头（单总线协议，精度±0.5℃）
- 显示模块：LCD1602A字符液晶屏（16x2字符显示）
- 通信模块：ESP8266（ESP-01S型号，用于WiFi通信）
注意：ST-LINK V2的3.3V供电输出能力有限，建议开发板使用外部独立电源供电，避免因供电不足导致系统不稳定。
2.2 软件工具链配置
作为macOS用户，我选择了以下开发工具：
- CLion 2023.2：JetBrains家的专业C/C++ IDE，智能代码补全和调试功能强大
- STM32CubeMX 6.8：ST官方图形化配置工具，支持HAL库代码生成
- ARM工具链：arm-none-eabi-gcc 10.3（交叉编译工具）
- OpenOCD 0.12：开源片上调试工具，支持多种调试探头
在macOS上安装这些工具非常方便：
bash复制# 安装ARM工具链和OpenOCD
brew install --cask gcc-arm-embedded
brew install openocd
# 验证安装
arm-none-eabi-gcc --version
openocd --version
安装时遇到一个小坑：最初安装的arm-none-eabi-gcc缺少gdb调试器，改用gcc-arm-embedded包后问题解决。
3. STM32CubeMX工程配置
3.1 创建新项目
启动STM32CubeMX后，选择"ACCESS TO MCU SELECTOR"，搜索并选择STM32F103C6Tx系列芯片。这里特别注意要选择带"A"后缀的型号（STM32F103C6T6A），因为不同后缀的芯片在引脚和功能上可能有差异。
3.2 时钟系统配置
时钟配置是STM32开发的关键第一步：
- 在"RCC"配置中启用外部高速时钟（HSE）
- 切换到"Clock Configuration"标签页
- 将HCLK设置为72MHz（STM32F103系列的最高主频）
- 系统会自动计算PLL倍频参数
经验分享：初学者可以直接输入目标频率，让工具自动计算分频系数，比手动配置更不容易出错。
3.3 调试接口配置
在"SYS"配置中，将"Debug"设置为"Serial Wire"。这一步非常重要，如果忘记配置，芯片的SWD调试接口可能会被禁用，导致无法再次烧录程序，只能通过按住复位键强制进入烧录模式。
3.4 GPIO配置
为了测试基本功能，我配置了PC13引脚作为GPIO输出（推挽模式），因为开发板上这个引脚连接了一个LED。在芯片引脚图上直接点击PC13引脚，选择"GPIO_Output"即可。
3.5 工程生成设置
在"Project Manager"标签页中设置：
- 项目名称：WaterTempMonitor
- 工具链：STM32CubeIDE（虽然我们用CLion，但选择这个可以生成更通用的工程结构）
- 代码生成选项：勾选"Generate peripheral initialization as a pair of .c/.h files"
点击"GENERATE CODE"按钮生成工程。
4. CLion工程配置
4.1 导入STM32CubeMX工程
在CLion中直接"Open"刚才生成的工程目录。初次打开时可能会有一些报错，这是因为工具链还未正确配置，暂时可以忽略。
4.2 配置工具链
进入"Preferences → Build, Execution, Deployment → Toolchains"，添加一个新的工具链：
- 名称：STM32 (ARM GCC)
- C编译器：/usr/local/bin/arm-none-eabi-gcc
- C++编译器：/usr/local/bin/arm-none-eabi-g++
- 调试器：/usr/local/bin/arm-none-eabi-gdb
4.3 配置OpenOCD
在项目根目录下创建stlink.cfg文件，内容如下：
bash复制# ST-LINK/V2配置
source [find interface/stlink.cfg]
transport select hla_swd
# STM32F1系列目标芯片配置
source [find target/stm32f1x.cfg]
# 设置下载速度为10MHz
adapter speed 10000
然后在CLion的"Run/Debug Configurations"中添加一个"OpenOCD Download & Run"配置，指定刚才创建的配置文件。
5. 第一个测试程序
5.1 修改主程序
打开Core/Src/main.c文件，在main函数的while循环中添加LED闪烁代码：
c复制while (1)
{
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500);
}
这段代码会让PC13引脚每500ms切换一次电平状态，实现LED闪烁效果。
5.2 编译与下载
- 点击CLion的"Build"按钮编译工程
- 确保ST-LINK已正确连接到开发板
- 点击"Run"按钮下载程序
如果一切正常，CLion的控制台会显示OpenOCD的烧录日志，开发板上的LED开始规律闪烁。
6. 常见问题与解决方案
6.1 无法识别ST-LINK
现象：OpenOCD报错无法找到ST-LINK设备
解决方法：
- 检查USB连接是否正常
- 在macOS上可能需要安装ST-LINK驱动：
bash复制
brew install stlink - 尝试降低通信速度，在stlink.cfg中将
adapter speed改为1000
6.2 程序下载后不运行
现象：程序下载成功但开发板无反应
解决方法：
- 检查开发板供电是否充足
- 确认启动模式引脚（BOOT0/BOOT1）配置正确（通常BOOT0接地）
- 在STM32CubeMX中检查时钟配置是否正确
6.3 调试时断点不生效
现象：设置断点但程序不暂停
解决方法：
- 确认编译时开启了调试信息（-g选项）
- 检查OpenOCD配置是否正确
- 尝试在main函数开始处手动添加
__asm__("nop");作为临时断点
7. 开发环境优化技巧
7.1 使用CLion的Live Template
在CLion中可以创建代码模板，快速插入常用代码片段。例如创建一个"HAL_Delay"模板：
- 进入"Preferences → Editor → Live Templates"
- 添加新的"C Template"：
- Abbreviation: hdelay
- Template text: HAL_Delay($DELAY$);$END$
- 指定适用场景为"C expression"
之后只需输入"hdelay"加Tab键就能快速插入延时函数。
7.2 串口调试输出
虽然本项目暂时不需要串口，但添加调试输出很有用：
- 在STM32CubeMX中启用USART外设
- 重定向printf到串口：
c复制int _write(int file, char *ptr, int len) { HAL_UART_Transmit(&huart1, (uint8_t*)ptr, len, HAL_MAX_DELAY); return len; } - 然后就可以直接使用printf输出调试信息
7.3 使用CLion的Memory View
在调试模式下，CLion可以查看内存内容：
- 启动调试会话
- 在"Debug"工具窗口点击"Memory"标签
- 输入外设寄存器地址（如GPIOA的0x40010800）
这对于检查寄存器配置是否正确非常有用。
8. 项目扩展方向
基础环境搭建完成后，可以考虑以下功能扩展：
-
温度采集功能：
- 实现DS18B20的单总线协议驱动
- 添加温度校准功能
- 设置温度报警阈值
-
显示界面优化：
- 改用I2C接口的OLED显示屏，节省IO口
- 设计多级菜单系统
- 添加温度历史曲线显示
-
网络功能：
- 通过ESP8266连接WiFi
- 实现MQTT协议上传数据
- 开发手机APP远程监控
-
低功耗优化：
- 使用STM32的睡眠模式
- 优化传感器采样频率
- 设计电池供电方案
这套开发环境不仅适用于当前的水温监测项目，也可以作为其他STM32项目的基础框架。HAL库的硬件抽象层设计使得代码在不同STM32系列间具有较好的可移植性。