简单理解：DS18B20 驱动的宏定义（部分）

// 宏定义 #define DS18B20_IO_OUT() GPIO_DirectionConfig(DS18B20_PORT, DS18B20_PIN, GPIO_DIR_OUT) #define DS18B20_IO_IN() GPIO_DirectionConfig(DS18B20_PORT, DS18B20_PIN, GPIO_DIR_IN) #define DS18B20_DQ_OUT GPIO_ClearOutBits(DS18B20_PORT, DS18B20_PIN) #define DS18B20_DQ_OUT_1 GPIO_SetOutBits(DS18B20_PORT, DS18B20_PIN) #define DS18B20_DQ_IN GPIO_ReadInBit(DS18B20_PORT, DS18B20_PIN)

逐行解释这段单片机（STM32 / 国产 MCU 通用）DS18B20 驱动的宏定义，讲清楚每个宏是干嘛的、怎么用。

整体作用

这是DS18B20 温度传感器单总线（1-Wire）驱动里最常见的 GPIO 操作封装，用宏把引脚方向、输出高低、读取电平藏起来，让主代码更干净、易移植。

逐行解释

1. 设置引脚为输出模式

#define DS18B20_IO_OUT() GPIO_DirectionConfig(DS18B20_PORT, DS18B20_PIN, GPIO_DIR_OUT)

• 功能：把 DS18B20 的 DQ 引脚设为推挽输出
• 使用：DS18B20_IO_OUT();

2. 设置引脚为输入模式

#define DS18B20_IO_IN() GPIO_DirectionConfig(DS18B20_PORT, DS18B20_PIN, GPIO_DIR_IN)

• 功能：把 DQ 引脚设为输入（上拉 / 浮空）
• 使用：DS18B20_IO_IN();

3. 输出低电平（拉低 DQ）

#define DS18B20_DQ_OUT GPIO_ClearOutBits(DS18B20_PORT, DS18B20_PIN)

• 功能：DQ =0
• 使用：DS18B20_DQ_OUT;

4. 输出高电平（拉高 DQ）

#define DS18B20_DQ_OUT_1 GPIO_SetOutBits(DS18B20_PORT, DS18B20_PIN)

• 功能：DQ =1
• 使用：DS18B20_DQ_OUT_1;

5. 读取引脚电平

#define DS18B20_DQ_IN GPIO_ReadInBit(DS18B20_PORT, DS18B20_PIN)

• 功能：读取当前 DQ 是高还是低
• 返回值：0或1
• 使用：level = DS18B20_DQ_IN;

典型使用片段（你能直接对照）

// 复位时序示例 DS18B20_IO_OUT(); // 设置DS18B20的DQ引脚为输出模式（准备发送复位脉冲） DS18B20_DQ_OUT = 0; // 将DQ引脚拉低（发送复位脉冲，协议要求低电平至少480us，这里用1ms满足要求） delay_ms(1); // 保持拉低状态1ms（远大于协议最小480us要求，确保DS18B20能检测到复位） DS18B20_DQ_OUT = 1; // 释放总线（拉高DQ引脚，结束复位脉冲） delay_us(40); // 等待40us（协议要求主机释放总线后，等待15~60us检测从机应答） DS18B20_IO_IN(); // 将DQ引脚切换为输入模式（释放总线，准备检测DS18B20的应答脉冲） if(DS18B20_DQ_IN == 0) // 检测DQ引脚电平：若为低，说明DS18B20发送了应答脉冲 { // 存在应答 }

// DS18B20状态机状态枚举 typedef enum { DS18B20_STATE_IDLE = 0, // 空闲状态 DS18B20_STATE_RESET_START, // 开始复位 DS18B20_STATE_RESET_WAIT, // 等待复位完成 DS18B20_STATE_CHECK_PRESENCE, // 检查存在脉冲 DS18B20_STATE_SEND_SKIP_ROM, // 发送跳过ROM命令 DS18B20_STATE_SEND_CONVERT, // 发送温度转换命令 DS18B20_STATE_CONVERT_WAIT, // 等待转换完成 DS18B20_STATE_READ_SCRATCHPAD, // 发送读取暂存器命令 DS18B20_STATE_READ_TEMP_LSB, // 读取温度低8位 DS18B20_STATE_READ_TEMP_MSB, // 读取温度高8位 DS18B20_STATE_COMPLETE, // 温度读取完成 DS18B20_STATE_ERROR // 错误状态 } DS18B20_State; // DS18B20状态机结构体 typedef struct { DS18B20_State state; // 当前状态 uint32_t timestamp; // 时间戳 short temperature; // 温度值 uint8_t temp_lsb; // 温度低8位 uint8_t temp_msb; // 温度高8位 uint8_t error; // 错误标志 } DS18B20_HandleTypeDef;

这段代码是针对 DS18B20 温度传感器设计的状态机相关定义，核心目的是通过枚举和结构体来规范化、模块化地管理 DS18B20 的工作流程和状态数据。下面我会详细拆解每一部分的含义和作用。

1. DS18B20 状态机状态枚举（DS18B20_State）

这个枚举定义了 DS18B20 传感器从空闲到完成温度读取的完整工作流程中的所有状态，每个状态对应传感器操作的一个具体步骤，是状态机的核心 “状态标识”。

2. DS18B20 状态机结构体（DS18B20_HandleTypeDef）

这个结构体是管理单个 DS18B20 传感器的 “数据容器”，整合了状态机的状态、时间戳、温度数据和错误信息，方便在程序中统一管理。

3. 实际使用逻辑示例（帮助理解）

状态机的执行流程通常是 “状态切换 + 时序判断”，比如：

// 初始化状态机 DS18B20_HandleTypeDef ds18b20 = { .state = DS18B20_STATE_IDLE, .timestamp = 0, .temperature = 0, .temp_lsb = 0, .temp_msb = 0, .error = 0 }; // 状态机处理函数（通常在定时器中断或主循环中调用） void DS18B20_StateMachine(DS18B20_HandleTypeDef *hdts) { switch(hdts->state) { case DS18B20_STATE_IDLE: // 触发读取，切换到复位开始状态 hdts->state = DS18B20_STATE_RESET_START; break; case DS18B20_STATE_RESET_START: // 执行复位操作（拉低总线） DS18B20_Reset(); hdts->timestamp = HAL_GetTick(); // 记录进入此状态的时间 hdts->state = DS18B20_STATE_RESET_WAIT; break; case DS18B20_STATE_RESET_WAIT: // 判断是否等待足够时间（如480us） if(HAL_GetTick() - hdts->timestamp > 1) { // 示例：简化的延时判断 hdts->state = DS18B20_STATE_CHECK_PRESENCE; } break; // 其他状态的处理逻辑... case DS18B20_STATE_ERROR: // 错误处理，比如重置状态机 hdts->state = DS18B20_STATE_IDLE; hdts->error = 0; break; } }

总结

1. 枚举DS18B20_State把 DS18B20 的读取流程拆分成多个独立状态，符合 “状态机” 设计思想，便于分步处理和故障定位；
2. 结构体DS18B20_HandleTypeDef整合了状态、时间、数据、错误信息，是管理单个传感器的核心数据结构；
3. 这种设计适用于嵌入式系统（如 STM32），能避免阻塞式延时，提高程序的实时性和可靠性。