stm32 tds传感器

### STM32与TDS传感器集成指南

#### 1. TDS传感器简介
总溶解固体(Total Dissolved Solids, TDS)测量水中除纯水外的物质总量。这些物质可以是矿物质、盐类或其他有机物。对于智能鱼缸控制系统而言，监控水质中的TDS水平至关重要。

#### 2. 硬件连接方式
为了实现STM32单片机对TDS传感器的有效控制，硬件连接需遵循特定模式：

- VCC 接入电源正极 (通常为3.3V 或者5V)
- GND 接地线
- DO 数字信号输出端口可选接至MCU GPIO引脚用于阈值判断
- AO 模拟电压输出则应接入STM32 ADC输入通道以便精确获取电导率数值[^1]

// 定义TDS传感器模拟量采集所使用的ADC通道编号
#define TDS_SENSOR_ADC_CHANNEL    ADC_Channel_0  

#### 3. 软件初始化配置
在程序启动阶段完成必要的初始化工作，确保能够正常接收来自TDS传感器的数据流并进行初步解析转换成有意义的信息单位(mg/L)[^2]:

#include "stm32f1xx_hal.h"

void MX_ADC_Init(void){
    __HAL_RCC_ADC1_CLK_ENABLE();
    
    hadc1.Instance = ADC1;
    hadc1.Init.ScanConvMode = DISABLE;
    hadc1.Init.ContinuousConvMode = ENABLE;
    hadc1.Init.DiscontinuousConvMode = DISABLE;
    HAL_ADC_Init(&hadc1);
}

#### 4. 数据读取函数开发
编写专门针对TDS传感器数据读取的功能模块，通过调用该接口可以获得实时更新后的溶液浓度参数:

float Read_TDS_Value(){
    uint32_t raw_value;
    float tdsValue;

    /* 启动一次AD转换 */
    HAL_ADC_Start(&hadc1);

    /* 阻塞等待直到本次采样结束 */
    if(HAL_OK != HAL_ADC_PollForConversion(&hadc1, 10)){
        Error_Handler();   
    }

    /* 获取最近一次有效的转换结果 */
    raw_value = HAL_ADC_GetValue(&hadc1); 

    /* 将原始ADC计数转化为实际物理意义下的TDS mg/L*/
    tdsValue = ((raw_value * REFERENCE_VOLTAGE / MAX_ADC_VALUE)-OFFSET)*CALIBRATION_COEFFICIENT;

    return tdsValue;
}

此处`REFERENCE_VOLTAGE`, `MAX_ADC_VALUE`, `OFFSET` 和 `CALIBRATION_COEFFICIENT`均为预定义常量，具体数值取决于选用的具体型号以及校准情况而定。