简介：面向单片机开发者和海洋监测方向学生的这套基于STM32的海水盐度检测系统，包含下位机嵌入式代码与LabVIEW上位机软件，提供从采集、显示到无线传输的完整链路。系统采用STM32F1作为主控，运行uCOSII操作系统，配合OLED屏、DS18B20防水温度传感器、浑浊度传感器及ESP8266无线模块，实现盐度采集、温度测量、温补计算和无线传输；压缩包内还包含盐度算法资料、通信协议、取模软件及清晰注释，便于理解与二次开发。资源共1071个文件，以C语言源码（h/c）、工程配置（uvproj/uvopt）、PDF文档、LabVIEW的vi/lvproj、编译生成的hex/axf等类型为主，压缩包大小24.3MB，整体结构按上下位机及资料文档分类，方便按需查阅。目前已有1426人学习浏览，适合需要快速搭建海水盐度检测原型或完成相关课程设计的开发者。
1. 项目结构总览与需求拆解
1.1 这套系统到底要解决什么问题
看到“基于STM32的海水盐度检测系统，包括LabVIEW上位机软件.rar”这种命名，基本可以断定这是一个典型的嵌入式测控类课设或毕业设计工程包。压缩包里面装的无非就是三样东西：STM32下位机源码、LabVIEW上位机工程、以及一份说明文档，可能还带几张原理图或PCB截图。
盐度检测本身是个很成熟的方向，但本科阶段的完整方案基本都是“传感器采集 + MCU处理 + 上位机显示”这条线。STM32负责把传感器信号读进来，做完滤波、标定、温度补偿之后，通过串口发到电脑上；LabVIEW则承担人机交互部分，显示实时盐度数值、绘制趋势曲线、保存历史数据。这套架构要说难，真不难，但涉及跨平台协作，坑都藏在细节里。
这个项目的受众很明确：电子信息、自动化、海洋科学相关专业的本科生，以及在实验室里需要快速搭建水质监测演示系统的工程师。如果你只是想把盐度数据送进电脑画个曲线，这套方案是目前最省力、也最容易做出演示效果的组合。
1.2 三层架构与方案选型逻辑
整个系统可以拆成三层来理解。
感知层是盐度传感器，它输出的是微弱模拟信号，必须经过信号调理电路变成STM32 ADC可以识别的电压范围。控制层就是STM32，完成数据采集、数字滤波、盐度计算和串口协议打包。应用层是PC上的LabVIEW，负责串口收发、数据解析、波形显示和存储。
选型时为什么用STM32而不是51或者Arduino？理由很现实：一方面STM32的ADC精度更高，PGA等外设也更齐全，另一方面市面上参考资料最多、出问题最好查。很多学校实验室甚至直接用STM32F103系列开发板，搭配几个模块就能跑通全流程，成本和门槛都低。
上位机选LabVIEW而不选Python或者Qt，核心原因是图形化编程对学生的友好程度。不用深入理解和掌握串口底层API，拖几个控件、连几条线就能完成数据接收和显示，做完界面直接生成exe演示，答辩效果非常直观。
1.3 打开压缩包后先做什么
拿到这个工程包，千万别急着烧程序。我一般的习惯是先把目录结构摸清楚，重点确认三份东西：下位机代码用的标准库还是HAL库、LabVIEW版本是2018还是2020、串口通信协议里数据帧是ASCII字符串还是二进制定长帧。
这三种信息直接决定你后续的工作量。如果下位机是标准库的工程，而你的Keil版本比较新，可能需要先做工程迁移；如果LabVIEW版本比工程版本低，VI文件大概率打不开，得先装对应版本或者让发文件的人另存为低版本；协议格式就更关键了，解析错一位，整个曲线就乱了。
2. 硬件选型与信号链处理
2.1 为什么测盐度要先测电导率
这是整个系统最关键的一环。盐度不是直接测出来的，绝大多数低成本方案都是通过测量水体电导率，再换算成盐度值。原理很简单：海水中的可溶性盐电离出的离子越多，溶液导电能力越强，电导率和盐度之间在固定温度下有近似线性的关系。
传感器选型上，最常见的方案是电导率电极模块，两根铂黑或石墨电极插入水中，通过测量电极间的电阻值来推算电导率。这类模块价格便宜、响应快、电路也简单。但直流信号长时间加在电极上会发生极化效应，导致测量值漂移，所以模块内部通常用交流方波或正弦波激励，不推荐自己拿直流源硬测。
采集电路的核心是电阻分压法。电极等效为一个可变电阻，和一个已知精密电阻串联，从分压点取信号进ADC。电极阻抗范围从几百欧到几十千欧不等，ADC参考电压3.3V或内部基准都应该满足要求。如果你用的是F103，12位ADC在满量程3.3V下的分辨率大约0.8mV，对电导率测量来说完全够用。
一个容易忽略的点：ADC参考电压不稳定会直接导致数据跳动。如果开发板上的VDDA是从1117稳压器出来的，且板上还有其他大电流负载，建议在VDDA引脚加LC滤波，或者干脆用独立的基准源芯片给ADC做参考，保证采样稳定性。
2.2 温度和标定的关系
盐度测量最典型的坑是温度补偿。水温每变化1℃，电导率大约变化2%左右。海水环境下温度从10℃变到30℃，如果不做补偿，测出来的盐度会偏一大截，这个误差在答辩现场很可能被直接问穿。
正确的做法是同时采集温度信号，作为补偿因子参与计算。工程上最常用的标定公式是：
Sa = 1.80655 × C(15) / 35
其中C(15)表示15℃下的电导率值，没有恒温条件就需要利用温度系数折算到标准温度。简化处理时可以直接用线性补偿：C(15) = Ct / (1 + α × (t - 15))，α取0.02/℃作为近似系数。
实际操作中，先把电极放在已知盐度的标准溶液里，测出ADC值并记录温度，标定出零点和斜率两个参数。存储到STM32的Flash里，冷启动时可以自动加载，这样每次开机不用重新校准就能直接出数。做毕设时用35g/L的市售盐度标准液校准，效果比自制盐水可靠得多。
2.3 信号调理与PCB设计要点
传感器出来的信号幅度往往很小，STM32内部虽然有PGA，但增益档位有限。推荐前端用一颗高精度运放做一级放大，例如AD620或LM358这类常见器件，增益电阻选精密电阻，把信号放大到接近满量程再送ADC。
PCB布局上注意一点：模拟地要单点连接，运放电源做好去耦。仪表放大器供电如果纹波太大，输出信号会叠加噪声，拉偏ADC采样值。
如果不想自己画板和焊接，直接选现成的电导率传感器模块更省事。很多模块已经集成了运放调理和温度传感器接口，输出的是模拟电压信号，STM32拿ADC直接读就行。实测这类模块精度在±0.5%左右，应付课程设计绰绰有余，但千万注意传感器探头的线别太长，屏蔽层要单端接地，否则工频干扰会把信号淹掉。
3. STM32端程序设计与实现
3.1 工程与ADC采样设计
下位机我习惯用STM32CubeMX生成HAL库工程，省去手动配置寄存器的步骤。ADC用扫描模式连续采样，我一般采样64次取平均，这对50Hz工频干扰有很好的抑制效果，不需要额外做陷波。具体操作中，先把通道配置为连续转换模式，然后循环读取转换结果并累加，最后右移6位实现除以64。
温度采集用NTC热敏电阻加分压电阻，或者直接用DS18B20数字温度传感器也可以。相比之下DS18B20的接线少、精度够，代码也更简单，适合做温度补偿。唯一的坑是DS18B20时序敏感，如果用到中断里会导致读温度失败，建议在空闲时轮询读取。
ADC采到的值是电压，需要根据分压比反推出电极电阻，再根据电导池常数换算电导率。这一串换算写成一个专门的函数，输出单位直接用mS/cm，之后交给盐度换算模块处理。
3.2 通信协议与数据帧设计
串口通信协议是整个项目里最容易出错的地方。我见过不少同学上下位机各写各的，结果上位机收到的数据全是乱码或者错位。强烈建议在设计阶段就定好帧格式，我通常用定长二进制帧：
| 帧头 | 帧长度 | 盐度高字节 | 盐度低字节 | 温度高字节 | 温度低字节 | 校验和 |
|---|---|---|---|---|---|---|
| 0xAA | 0x06 | Data[0] | Data[1] | Data[2] | Data[3] | Sum |
数值全部放大100倍后再发整数，例如盐度35.42‰就发3542，这样做有两个好处：一是整数传输不会出现浮点精度损失，二是减少帧长，解析方便，上位机拿到后除以100还原即可。校验和采用累加和，上位机算一遍，对不上就丢弃这一帧，能省掉大量调式乱码的麻烦。
串口参数固定为115200，8位数据位，1位停止位，无校验。实测这个速率在USB转串口模块下非常稳定，而且数据量很小，一秒钟发10帧也不会丢数据。
3.3 下位机代码实现要点
核心采集循环用HAL库实现，简洁明了，核心代码框架如下：
uint16_t adc_buf[64]; uint32_t sum = 0; float voltage, resistance, conductivity, salinity, temperature; for (uint8_t i = 0; i < 64; i++) { HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 10); adc_buf[i] = HAL_ADC_GetValue(&hadc1); HAL_ADC_Stop(&hadc1); sum += adc_buf[i]; } voltage = (sum >> 6) * 3.3f / 4095.0f; // 根据分压电路计算电阻值 resistance = REF_RESISTOR * (voltage / (VCC - voltage)); // 查标定公式换算电导率和盐度 conductivity = 1.0f / resistance / CELL_CONSTANT; temperature = read_ds18b20(); salinity = conductivity_to_salinity(conductivity, temperature);一个重要的调试技巧：把标定参数、ADC原始值等调试信息，通过另一个串口或者同一个串口的特殊通道发出来，边运行边用串口助手查看。千万别等到上位机写完了再联调，到时候出问题根本不知道是下位机的锅还是上位机的锅。
4. LabVIEW上位机完整实现
4.1 界面布局与设计思路
LabVIEW上位机看起来功能复杂，拆开了无非就是三块：串口配置区、数据显示区、曲线记录区。前面板不需要堆太多控件，简洁清晰最重要，毕竟这是要拿去答辩展示的。
串口配置区放串口号下拉框、波特率下拉框、打开/关闭串口按钮。数据显示区放一个盐度数值指示器、一个温度指示器，盐度用仪表盘控件比较直观，方便在演示时让评委一眼看到数值变化。曲线记录区拖一个波形图，横轴是时间，纵轴是盐度值，用来展示实时趋势。最后加一个“停止并保存”按钮，按下后自动把本次数据存成Excel。
在LabVIEW 2018之后的版本中，前面板控件风格建议选“银色”主题，整体观感专业很多，答辩时印象分会高不少。
4.2 串口读取、解析与波形显示
LabVIEW端的串口操作核心是用VISA节点。VISA Configure Serial Port配置串口号和波特率，VISA Read读取缓冲区数据。由于下位机发的是二进制定长帧，直接按字节读出来再解析。
解析的核心是“Unflatten String from String”函数，配一个簇类型的“类型”输入，就能按自定义格式把字节流还原成数值。上面我们定义的帧结构，在LabVIEW里可以构建一个包含帧头和数据的簇，三个U16和一个温度值，直接用这个节点解包，跟C语言里的memcpy一个道理。
需要注意的细节：VISA Read是一次性读回当前缓冲区所有字节，所以要在循环里做帧同步。收到数据后先搜索帧头0xAA，找到后判断后面字节数是否够，再算校验和。校验通过才做拆分。这个逻辑用循环+条件结构实现，看似简单，但对流式数据的鲁棒性影响很大。
波形图更新频率建议不要高于下位机发送频率，否则曲线看起来像一条实心带。我的习惯是下位机发10Hz，上位机显示时用波形图的“缓冲区长度”限制为200点，这样一条曲线大概显示20秒的历史数据，既有趋势又不至于过于密集。
4.3 Excel数据导出与收尾
数据保存用LabVIEW的“Write to Measurement File”最省事，它会生成TDMS格式，Excel打不开。如果老师指定要Excel，就直接用“Excel Get Worksheet”函数集配合报表生成工具包，或者更简单的方法：把数据拼成表格字符串，用“Write Delimited Spreadsheet”VI写入csv文件，Excel双击就能打开。这个办法不依赖Microsoft Office是否安装，换到任何一台电脑都能运行。
在工程的“程序框图”里，把保存操作放在停止按钮的回调分支中，点击一次保存当前全部数据。建议文件名带上时间戳，用“Format Date/Time String”函数生成“salinity_20250320_153000.csv”这种格式，避免重复覆盖。
5. 实测联调与高频问题排查
5.1 联调中最常见的四个坑
第一，LabVIEW提示VISA资源找不到串口。这个问题八成出在驱动上，CH340或者CP2102芯片没有安装对应的虚拟串口驱动时，设备管理器里根本看不到COM口。另外STM32的Virtual COM Port驱动如果只显示黄色感叹号，USB转串口的通信就会中断，先右键更新驱动，指定到驱动目录重装一次。
第二，上位机收到的全是乱码。先不要急着改LabVIEW，用串口助手单独测试下位机输出，如果能正确显示帧结构，问题大概率出在LabVIEW的读取字节数和解析起始位置上。把VISA Read的字节数改成和帧结构严格一致，并做帧同步，乱码问题就能解决。
第三，LabVIEW 2018安装卡在“正在配置NI Package Manager”界面。这个是因为NI的包管理器默认联网下载组件，在国内网络环境下经常卡住或超时。解决方案是安装时选择“跳过登录”，关闭系统防火墙，或者找一个完整的离线安装包。建议装LabVIEW 2018 64位版本，兼容性比旧版本好得多。
第四，数据波形图上噪声很大。首先检查下位机有没有做滤波，ADC要不要做均值滤波和软件去抖；其次检查传感器探头的屏蔽线是否接好。把传感器从水里拿出来观察基线是否平稳，就能快速定位到底是谁引入的干扰。
5.2 排查速查表
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 串口打不开 | 串口号被占用或驱动异常 | 拔插USB，在设备管理器重装COM驱动，换个COM口号 |
| 数据全为0或最大 | 传感器没接好、分压电阻短路 | 先量传感器输出电压，再查ADC引脚是否悬空 |
| 曲线严重跳动 | 传感器线缆屏蔽差、电源纹波大 | 屏蔽层单端接地，ADC参考电压加LC滤波 |
| 上位机收不到数据 | 波特率不匹配、接线RX/TX接反 | 核对波特率，交叉换一下TX/RX |
| 温度读数异常 | DS18B20引脚时序不对 | 换用软件模拟单总线时序，关掉中断再读取 |
5.3 关于调试方法的两点体会
串口通信类系统，强烈建议先把数据链路打通，再去做传感器标定和上位机美化。先把下位机用串口助手发给电脑的数据调正确了，再开发上位机，否则两边同时出问题的时候，排查成本会成倍增加。
再有就是标定过程最好留痕。把标定用的标准液浓度、ADC原始值、温度值、最终计算结果做成一张表格，放进设计报告里作为附录。答辩时老师问起精度和误差，直接拿数据说话，比口头解释有说服力得多。
按这套流程走下来，整个项目从零跑到稳定出数据，大概也就两天时间。第一天搞定硬件焊接和STM32串口输出，第二天集中留整块时间给LabVIEW解析和界面调试。最耗时间的其实不是你写得慢，而是没想清楚协议就开始动手，结果两边反复改，来回炸。先把帧格式和标定流程钉死，后面就是快乐的填砖时间。
本文还有配套的精品资源，点击获取
