用Arduino Wire库玩转IIC主从通信一个ESP32读取温湿度传感器的完整项目在嵌入式开发中IICInter-Integrated Circuit总线因其简洁的两线制设计和多设备支持特性成为传感器通信的首选方案之一。本文将带你从零开始构建一个完整的ESP32 IIC通信项目不仅实现主设备读取SHT30温湿度传感器数据还会模拟从设备响应控制指令覆盖硬件连接、代码实现到调试技巧的全流程。1. 项目规划与硬件准备1.1 硬件选型与连接我们需要以下硬件组件ESP32开发板主设备SHT30温湿度传感器IIC地址0x44另一个MCU如Arduino Uno模拟从设备4.7kΩ上拉电阻×2面包板和杜邦线关键连接示意图ESP32 (主设备) SHT30传感器 Arduino (从设备) GPIO21 (SDA) ---- SDA ---- A4 (SDA) GPIO22 (SCL) ---- SCL ---- A5 (SCL) 3.3V ----------- VCC ---- 5V GND ------------ GND ---- GND ▲ ▲ │ │ 4.7kΩ 4.7kΩ注意ESP32与SHT30需使用3.3V供电而Arduino Uno使用5V时需注意电平兼容性。若出现通信不稳定可尝试降低IIC时钟频率。1.2 开发环境配置确保已安装以下软件环境Arduino IDE 2.0必要的库文件Wire.h内置Adafruit_SHT31.h用于SHT30ESP32Servo若需扩展功能安装库的命令示例arduino-cli lib install Adafruit SHT31 Library2. 主设备实现ESP32读取SHT302.1 基础数据读取首先实现最基本的传感器数据获取#include Wire.h #include Adafruit_SHT31.h Adafruit_SHT31 sht31 Adafruit_SHT31(); void setup() { Serial.begin(115200); while (!Serial) delay(10); if (!sht31.begin(0x44)) { // 默认地址0x44 Serial.println(Could not find SHT31); while (1) delay(1); } } void loop() { float temp sht31.readTemperature(); float hum sht31.readHumidity(); if (!isnan(temp) !isnan(hum)) { Serial.print(Temp: ); Serial.print(temp); Serial.print( °C\t); Serial.print(Hum: ); Serial.print(hum); Serial.println( %); } else { Serial.println(Failed to read data); } delay(2000); }2.2 高级功能实现扩展加热器控制与精度设置// 在setup()后添加 sht31.heater(false); // 默认关闭加热器 sht31.setPrecision(SHT3X_HIGH_PRECISION); // 设置高精度模式 // 添加加热器控制函数 void toggleHeater(bool state) { sht31.heater(state); Serial.print(Heater: ); Serial.println(state ? ON : OFF); }3. 从设备模拟响应控制指令3.1 基础从机框架使用Arduino Uno实现一个可接收控制命令的从设备#include Wire.h #define I2C_ADDRESS 0x08 byte receivedCommand 0; void setup() { Wire.begin(I2C_ADDRESS); Wire.onReceive(receiveEvent); Wire.onRequest(requestEvent); Serial.begin(9600); } void loop() { delay(100); } void receiveEvent(int bytes) { receivedCommand Wire.read(); Serial.print(Received: 0x); Serial.println(receivedCommand, HEX); } void requestEvent() { switch(receivedCommand) { case 0xA1: Wire.write(ACK); break; default: Wire.write(0x00); } }3.2 双向通信协议设计设计一个简单的控制协议命令码功能描述响应数据0xA1获取设备状态READY0xB2开启传感器加热HEAT_ON0xB3关闭传感器加热HEAT_OFF更新后的requestEvent()实现void requestEvent() { switch(receivedCommand) { case 0xA1: Wire.write(READY); break; case 0xB2: Wire.write(HEAT_ON); break; case 0xB3: Wire.write(HEAT_OFF); break; default: Wire.write(UNKNOWN_CMD); } }4. 系统集成与调试技巧4.1 主从设备协同工作ESP32主设备代码增加从设备控制逻辑void controlSlave(byte command) { Wire.beginTransmission(0x08); Wire.write(command); Wire.endTransmission(); Wire.requestFrom(0x08, 6); while(Wire.available()) { char c Wire.read(); Serial.print(c); } Serial.println(); } // 在loop()中添加测试代码 if (Serial.available()) { char cmd Serial.read(); if (cmd 1) controlSlave(0xA1); else if (cmd 2) controlSlave(0xB2); else if (cmd 3) controlSlave(0xB3); }4.2 常见问题排查IIC通信故障检查清单确认所有设备共地检查上拉电阻值通常4.7kΩ-10kΩ使用逻辑分析仪捕获波形尝试降低时钟频率Wire.setClock(100000); // 100kHz检查地址冲突void scanI2C() { byte error, address; for(address1; address127; address) { Wire.beginTransmission(address); error Wire.endTransmission(); if (error 0) { Serial.print(Found device at 0x); Serial.println(address, HEX); } } }5. 性能优化与扩展5.1 时钟拉伸处理某些传感器如SHT30会使用时钟拉伸// 在setup()中增加 #if defined(ESP32) Wire.setClockStretchLimit(150000); // 150ms #endif5.2 多从设备管理管理多个IIC设备的示例框架struct I2CDevice { uint8_t address; const char* name; }; I2CDevice devices[] { {0x44, SHT30}, {0x08, Control Unit}, {0x68, RTC Module} }; void checkAllDevices() { for(auto dev : devices) { Wire.beginTransmission(dev.address); byte error Wire.endTransmission(); Serial.print(dev.name); Serial.println(error ? : Disconnected : : Active); } }实际部署中发现当总线负载较重时适当增加延迟能显著提高稳定性。例如在连续访问不同设备间插入5ms延迟可避免从设备响应超时问题。