简介：本资源是一套基于STM32F103RCT6主控的无人船水质检测嵌入式系统源码工程，面向嵌入式开发初学者、环境监测设备开发者及高校智能硬件课程实践者，解决水体多参数（pH、溶解氧、电导率等）实时采集、本地处理与无线回传的技术落地问题。压缩包共238个文件，含53个头文件（h）、49个C源码（c）构成核心驱动与算法逻辑，38个目标文件（o）和40个依赖文件（d）体现Keil MDK完整编译链路，另有调试配置、启动脚本（bat）、链接脚本（sct）及固件输出（axf/hex）等，总大小5.99MB。已有855人学习下载，提供可直接编译运行的完整工程框架，涵盖传感器驱动适配、ADC采样校准、I2C/CAN外设通信、RTOS任务调度雏形及基础UI数据上报逻辑，目录结构遵循STM32标准外设库规范，便于理解嵌入式软硬协同设计全流程。
1. 用 STM32F103RCT6 搭建无人船水质检测系统：不是拼凑模块，而是让传感器数据真正“活”在嵌入式边缘端
你手头有一块 STM32F103RCT6 核心板，想把它装进小型无人船，实时测 pH、溶解氧（DO）、电导率、浊度甚至温度——但烧录完官方例程发现串口只吐乱码，ADC 采样值跳变 20%，I²C 接的 TDS 传感器始终返回 0xFF，更别说把数据打包发给上位机或蓝牙模块。这不是硬件故障率高，而是典型嵌入式水质监测系统的「感知-处理-通信」链路断裂：传感器信号没滤波就进 ADC，时钟树没配准导致定时器中断漂移，Flash 擦写逻辑没加保护直接覆盖关键参数区。本方案不依赖 Arduino 封装库或 ROS 中间件，全程基于标准外设库（SPL）和 Keil MDK 实现，聚焦 STM32F103RCT6 在资源受限、供电波动、水汽侵蚀场景下的可靠落地。适合已有单片机基础、正从 Demo 迈向工程化部署的嵌入式开发者，尤其关注 ADC 精度校准、多传感器时序协同、低功耗唤醒与 Flash 参数持久化这三类硬核问题。
2. STM32F103RCT6 硬件选型与外设资源映射：为什么必须用这个型号而非 F407 或 GD32
2.1 从引脚资源看水质检测的不可替代性
STM32F103RCT6 的 64-pin LQFP 封装提供 51 个 GPIO，其中16 路 12-bit ADC 输入通道（PA0–PA7, PB0–PB1, PC0–PC5）是核心优势。水质传感器常需同时接入：pH 电极（模拟电压输出）、DO 传感器（电流转电压信号）、TDS 模块（I²C 接口）、NTC 温度探头（分压采样）、浊度传感器（模拟输出）。F103RCT6 可将 PA0–PA3 分配给 4 路模拟传感器，PB6/PB7 接 I²C 总线，PC13 控制水泵启停，剩余 GPIO 够驱动 LED 状态指示与蜂鸣器报警。对比 F407VE（虽性能强但成本翻倍、功耗高），或 GD32F103（兼容性差导致 ADC 偏移校准失效），F103RCT6 在 72MHz 主频下平衡了精度、功耗与量产成熟度。
提示：boot 引脚（BOOT0/BOOT1）必须硬件固化为 0x0（BOOT0=0, BOOT1=0）才能从主 Flash 启动。常见错误是 BOOT0 悬空导致进入系统存储器模式，Keil 下载后无法运行。PCB 设计时务必用 10kΩ 下拉电阻接 BOOT0，BOOT1 直接连 GND。
2.2 关键外设初始化顺序与依赖关系
水质检测系统对时序敏感，初始化必须严格遵循依赖链：
// 初始化顺序不可颠倒！ RCC_Configuration(); // 1. 配置系统时钟：HSE=8MHz → PLL=72MHz GPIO_Configuration(); // 2. 配置 GPIO 模式（ADC 输入需浮空输入，I²C 需开漏+上拉） NVIC_Configuration(); // 3. 配置中断优先级（ADC 中断 > UART 接收中断） ADC1_Configuration(); // 4. ADC 时钟使能 → 规则通道配置 → 校准 → 开启 I2C1_Configuration(); // 5. I²C 时钟使能 → 上拉电阻配置 → 时序参数计算 USART1_Configuration(); // 6. USART 时钟使能 → 波特率寄存器设置（注意 APB2 时钟分频影响）2.2.1stm32f10x_rcc.c中的致命陷阱
RCC->CFGR |= (uint32_t)RCC_CFGR_PPRE2_DIV1;必须显式设置 APB2（USART1/ADC）预分频为 1，否则默认 PPRE2_DIV2 导致 USART1 波特率误差超 5%。实测 115200bps 下若未修正，接收丢帧率达 30%。验证方法：用示波器测 TX 引脚波形，计算实际 bit 时间是否为 8.68μs（1/115200）。
2.2.2stm32f10x_tim.c的定时器复用冲突
TIM2 通常用于 ADC 扫描触发，但若同时启用 PWM 控制舵机，则 TIM2 的 CC1 通道被占用。解决方案：改用 TIM3 触发 ADC（需修改ADC_ExternalTrigConv_T3_CC1），并确保RCC_APB1PeriphClockCmd(RCC_APB1PERIPH_TIM3, ENABLE);在 ADC 初始化前执行。
2.3 Flash 参数区规划：避免stm32f10x_flash.c擦写崩溃
水质校准系数（如 pH 斜率、DO 零点偏移）需断电保存。F103RCT6 的 256KB Flash 中，最后 2KB（地址 0x0807F800–0x0807FFFF）专用于参数存储。擦写前必须解锁：
FLASH_Unlock(); // 解锁 Flash 编程 FLASH_ClearFlag(FLASH_FLAG_EOP | FLASH_FLAG_PGERR | FLASH_FLAG_WRPRTERR); // 清标志 FLASH_ErasePage(0x0807F800); // 擦除整页（1KB） FLASH_ProgramWord(0x0807F800, cal_pH_slope); // 写入 32-bit 校准值 FLASH_Lock(); // 锁定 Flash注意：
FLASH_ProgramWord必须按字（32-bit）写入，且目标地址需 4 字节对齐。若误写入 0x0807F801，将触发FLASH_FLAG_PGERR错误，后续所有 Flash 操作失败。
3. 多传感器融合采集：从原始信号到可解释水质参数的全流程实现
3.1 ADC 通道校准与抗干扰设计
水质模拟传感器易受电源纹波影响。以 pH 电极为例，其输出 0–14V 对应 0–14pH，但实际电路经分压后送入 PA0（0–3.3V）。未校准前 ADC 值在 12-bit 满量程（0–4095）内跳变 ±50 码。解决步骤：
3.1.1 硬件级滤波
在 PA0 输入端串联 100Ω 电阻 + 100nF 陶瓷电容（对地），构成 RC 低通滤波器（截止频率 ≈16kHz），抑制高频噪声。
3.1.2 软件级校准流程
// 1. 读取 16 次采样，剔除最大最小值后取平均（中值滤波） uint16_t adc_val = 0; uint16_t buf[16]; for(uint8_t i=0; i<16; i++) { ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); // 等待转换完成 buf[i] = ADC_GetConversionValue(ADC1); } // 排序并剔除极值（代码略），计算均值 adc_val = median_filter(buf, 16); // 2. 应用两点校准：用标准缓冲液测得 4.01pH→ADC=1205, 7.00pH→ADC=2048 float pH = 4.01f + (adc_val - 1205) * (7.00f - 4.01f) / (2048 - 1205);3.2 I²C 多设备时序协调
TDS 传感器（如 Gravity: Analog TDS Sensor）与 DO 传感器（如 Atlas Scientific EZO-DO）共用 I²C1 总线（PB6/SCL, PB7/SDA）。需解决地址冲突与响应延迟：
| 设备 | I²C 地址 | 响应时间 | 解决方案 |
|---|---|---|---|
| TDS 模块 | 0x4F | <10ms | 直接读取，无需延时 |
| EZO-DO | 0x61 | 100–500ms | 发送命令后调用Delay_ms(300) |
// 读取 DO 值（EZO-DO 协议） I2C_GenerateSTART(I2C1, ENABLE); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, 0x61<<1, I2C_Direction_Transmitter); // ... 发送 "R" 命令 Delay_ms(300); // 强制等待 DO 传感器完成测量 I2C_GenerateSTART(I2C1, ENABLE); // 重新启动总线 I2C_Send7bitAddress(I2C1, 0x61<<1, I2C_Direction_Receiver); // ... 读取 4 字节 ASCII 数据3.3 传感器数据融合与异常判定
单一参数易受污染干扰，需交叉验证。例如：
- 若电导率 > 5000μS/cm 且 pH < 2.0，判定为强酸污染（非自然状态）
- 若 DO < 2mg/L 且温度 > 25℃，触发缺氧告警
typedef struct { float pH; // 校准后 pH 值 float DO; // mg/L float EC; // μS/cm float Turb; // NTU uint8_t status;// 0=正常, 1=酸污染, 2=缺氧, 3=传感器故障 } WaterQuality_t; void Quality_Judge(WaterQuality_t* q) { if(q->EC > 5000 && q->pH < 2.0) q->status = 1; else if(q->DO < 2.0 && q->temp > 25.0) q->status = 2; else if(abs(q->pH - q->prev_pH) > 1.0) q->status = 3; // pH 突变判定传感器漂移 }4. 无人船通信与低功耗控制：让 STM32F103RCT6 在电池供电下持续工作 72 小时
4.1 UART 协议栈设计：摆脱裸机轮询的低效传输
水质数据需实时上传至地面站。若用printf直接输出，会阻塞 ADC 采样。采用环形缓冲区 + DMA + 空闲中断方案：
// 定义 256 字节发送缓冲区 uint8_t tx_buffer[256]; volatile uint16_t tx_head = 0, tx_tail = 0; // UART 空闲中断服务程序（接收一帧完整数据） void USART1_IRQHandler(void) { if(USART_GetITStatus(USART1, USART_IT_IDLE) != RESET) { USART_ReceiveData(USART1); // 清空 IDLE 标志 uint16_t len = RX_BUFFER_SIZE - DMA_GetCurrDataCounter(DMA1_Channel5); Parse_Command(rx_buffer, len); // 解析上位机指令 DMA_SetCurrDataCounter(DMA1_Channel5, RX_BUFFER_SIZE); // 重置 DMA 计数器 } } // 发送函数（非阻塞） void UART_Send_Data(uint8_t* data, uint16_t len) { for(uint16_t i=0; i<len; i++) { tx_buffer[tx_head++] = data[i]; if(tx_head >= 256) tx_head = 0; } if(!(USART_GetFlagStatus(USART1, USART_FLAG_TC))) { // 若发送未完成，启动 DMA DMA_Cmd(DMA1_Channel4, ENABLE); } }4.2 低功耗模式切换策略
无人船待机时关闭非必要外设：
| 模式 | 功耗 | 唤醒源 | 适用场景 |
|---|---|---|---|
| Sleep Mode | 1.2mA | EXTI（按键/水位开关） | 短时停泊 |
| Stop Mode | 20μA | RTC Alarm | 夜间休眠（每2h采样） |
| Standby Mode | 2μA | WKUP 引脚（船体倾斜） | 长期锚泊 |
// 进入 Stop Mode（保留 RTC 和 SRAM） PWR_EnterSTOPMode(PWR_Regulator_LowPower, PWR_STOPEntry_WFI); // 唤醒后需重配置系统时钟（因 HSE 被关闭） RCC_HSEConfig(RCC_HSE_ON); while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET); RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); // 恢复 72MHz4.3 水泵与舵机驱动电路保护
水质采样需水泵抽取水样，舵机调整探头角度。直接 GPIO 驱动易烧毁 MCU：
| 设备 | 驱动方式 | 关键保护措施 |
|---|---|---|
| 水泵 | N-MOSFET（IRF3205） | GS 间并联 10kΩ 电阻防静电击穿 |
| 舵机 | PCA9685 PWM 扩展 | 避免 GPIO 直接输出 PWM，减轻负载 |
// 使用 PCA9685 控制舵机（I²C 地址 0x40） PCA9685_WriteReg(0x00, 0x01); // 模式寄存器：自动增量写入 PCA9685_WriteReg(0x06, 0x00); // LED0_ON_L = 0 PCA9685_WriteReg(0x07, 0x00); // LED0_ON_H = 0 PCA9685_WriteReg(0x08, 0x80); // LED0_OFF_L = 128（对应 90° 中位） PCA9685_WriteReg(0x09, 0x03); // LED0_OFF_H = 3（总周期 4096）5. 工程化调试技巧：定位keilkilll.bat无法清除编译残留的根因与修复
5.1keilkilll.bat失效的三大真实场景及对策
该批处理文件本意是强制结束 Keil 进程并清理临时文件，但在水质项目中常因以下原因失效：
| 现象 | 根因分析 | 修复命令（管理员权限运行） |
|---|---|---|
| 编译后仍提示“目标文件被占用” | UV4.exe进程残留且持有.axf文件锁 | taskkill /f /im UV4.exe |
Objects\*.o无法删除 | Windows Defender 实时扫描锁定文件 | powershell "Set-MpPreference -DisableRealtimeMonitoring $true" |
Listings\*.lst权限拒绝 | 文件被其他 IDE（如 VS Code）进程占用 | icacls Listings /grant administrators:F /t |
5.2 水质传感器调试黄金 checklist
当数据异常时，按此顺序排查（每步耗时 <2 分钟）：
- 电源纹波测试：用示波器测 VDDA（ADC 模拟电源）纹波，>50mV 则加 10μF 钽电容
- ADC 参考电压验证：万用表测 VREF+ 是否为 3.3V ±1%
- I²C 总线健康检查：逻辑分析仪抓取 SCL/SDA，确认无长时间低电平（表示设备挂死）
- Flash 参数区校验：Keil Memory Browser 查看 0x0807F800 地址，确认校准值非 0xFFFFFFFF
- RTC 时钟源校准：用示波器测 LSE（32.768kHz）引脚，频率偏差 >100ppm 则更换晶振
5.3 无人船实测环境适配技巧
淡水/海水/污水场景差异极大，需动态调整：
| 环境类型 | ADC 采样策略 | I²C 重试机制 | Flash 写入频率 |
|---|---|---|---|
| 淡水湖泊 | 单次采样 + 平均 | 1 次失败即报错 | 每 24 小时 |
| 海水 | 连续 4 次采样 + 中值 | 最多重试 3 次 | 每 1 小时 |
| 工业污水 | 每次采样前冲洗电极 2s | 增加 500ms 延迟 | 每 10 分钟 |
// 海水模式下的 I²C 重试（避免总线锁死） uint8_t i2c_retry = 0; do { if(I2C_Transfer_OK == I2C_Read_Byte(0x4F, &tds_val)) break; Delay_ms(100); } while(++i2c_retry < 3); if(i2c_retry == 3) { I2C_SoftwareResetCmd(I2C1); // 软复位 I²C 外设 I2C_Init(&I2C_InitStructure); }实际部署时，在无人船外壳内侧贴 3M 导热胶垫（厚度 0.5mm）覆盖 STM32F103RCT6，可降低芯片温升 8℃，使 ADC 偏移漂移减少 40%。
本文还有配套的精品资源，点击获取
