使用 Adafruit MCP9808 精密 I2C 温度传感器库从 Arduino 入门到 Tasmota 固件集成【免费下载链接】TasmotaAlternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at项目地址: https://gitcode.com/GitHub_Trending/ta/TasmotaMCP9808 是 Microchip 推出的一款高精度 I2C 数字温度传感器实测精度达 ±0.25°C典型值以 16 位分辨率输出环境温度。本文以 Tasmota 仓库中随附的 Adafruit_MCP9808_Tasmota 库为骨架系统讲解其安装方式、I2C 地址与分辨率配置、完整 API 用法并结合 xsns_72_mcp9808.ino 揭示该库在 Tasmota 固件中如何被驱动为原生温度传感器帮助读者在 Arduino 独立开发与 Tasmota 固件两条路径上都快速落地 MCP9808。一、库的定位与核心特性根据 README.md 的说明这是 Adafruit 出品的MCP9808 Precision I2C Temperature sensor libraryMCP9808 精密 I2C 温度传感器库专门面向 Adafruit MCP9808 Breakout 开发板产品编号 1782设计并验证。该芯片通过 I2C 总线通信硬件上仅需两根信号线SDA、SCL即可完成接口。仓库内的这份库是 Tasmota 项目的定制分支在 Adafruit_MCP9808.h 的文件头中明确标注了改动记录changes by Martin Wagner for tasmota project: the library supports variable I2C address库支持可变 I2C 地址这一点正是 Tasmota 分支与上游版本的关键差异原版库在创建对象后固定使用默认地址而本仓库版本的所有读写 API 都接受一个addr参数允许同一对象动态切换总线上的不同器件为同一条 I2C 总线上挂载最多 8 颗 MCP9808 提供了底层支持。按 library.properties 的元数据本库版本号为1.1.2作者为 Adafruit类别为 Sensors架构支持*即不限架构并声明依赖 Adafruit Unified Sensor。许可证为 BSD详见 license.txt。二、硬件接线与 I2C 地址配置2.1 最小接线MCP9808 是纯 I2C 器件共需 4 根连线引脚连接目标VDD3.3V芯片工作电压 2.7V–3.6VGND地SDA主控 I2C 数据线SCL主控 I2C 时钟线在 Arduino 上通常接 A4/A5UNO或 SDA/SCLMega、ESP8266、ESP32 等开发板即可。2.2 地址选择A2/A1/A0 引脚MCP9808 提供 3 个地址选择引脚 A2、A1、A0通过焊接跳线或拉高/拉低组合出8 个可用地址0x18–0x1F这也是同一条总线上可挂 8 颗传感器的硬件基础。示例程序 mcp9808test.ino 中给出了完整的地址对照表A2A1A0I2C 地址0000x18默认地址0010x190100x1A0110x1B1000x1C1010x1D1100x1E1110x1F代码中对应宏定义MCP9808_I2CADDR_DEFAULT 0x18位于 Adafruit_MCP9808.h。示例程序特别提醒连接多个传感器时只需为每颗芯片配置不同地址并定义多个库对象即可。三、安装方式README 给出的安装路径是Arduino Library ManagerArduino 库管理器在 Arduino IDE 中打开工具 → 管理库搜索Adafruit MCP9808并安装即可。本仓库中的这份库则属于 Tasmota 的 vendored 库位于 lib/lib_i2c/Adafruit_MCP9808_Tasmota由平台构建系统直接引用无需手动安装。四、核心 API 详解本节基于 Adafruit_MCP9808.h 与 Adafruit_MCP9808.cpp 的完整源码展开API 均支持传入addr参数Tasmota 分支特性。4.1 初始化begin / init库提供 4 个重载的begin方法bool begin(); // 默认地址 0x18 默认 Wire bool begin(TwoWire *theWire); // 默认地址 指定 Wire 总线 bool begin(uint8_t addr); // 指定地址 默认 Wire bool begin(uint8_t addr, TwoWire *theWire); // 指定地址 指定 Wire 总线四个重载最终都会调用init()其内部逻辑Adafruit_MCP9808.cpp依次执行_wire-begin()启动 I2C 总线读取制造商 ID 寄存器0x06校验是否为0x0054Microchip读取器件 ID 寄存器0x07校验是否为0x0400将配置寄存器0x01写 0恢复默认工作状态。只有 ID 校验全部通过才返回true因此begin的返回值就是传感器是否在线且正确的可靠判据——示例代码正是利用这一点做启动自检见第五节。4.2 温度读取readTempC / readTempFfloat readTempC(uint8_t addr); // 返回摄氏度 float readTempF(uint8_t addr); // 返回华氏度读取寄存器MCP9808_REG_AMBIENT_TEMP0x05中的 16 位环境温度值换算逻辑Adafruit_MCP9808.cpp为temp t 0x0FFF; // 低 12 位为温度有效位0.0625°C/LSB temp / 16.0; // 除以 16 还原温度 if (t 0x1000) // bit12 为符号位置 1 表示负温度 temp - 256; // 负温度按补码减去 256即温度 原始值 / 16符号位bit12为 1 时再减 256最小分辨率 0.0625°C。readTempF在摄氏度结果基础上执行temp * 9.0 / 5.0 32完成换算。当寄存器读到0xFFFF总线无响应时返回NAN便于上层做异常判断。4.3 分辨率控制setResolution / getResolutionvoid setResolution(uint8_t addr, uint8_t value); // value 只取低 2 位 0x03 uint8_t getResolution(uint8_t addr);分辨率寄存器0x08的低 2 位决定 ADC 转换精度与采样时间示例程序中给出了完整对照表模式分辨率采样时间00.5°C30 ms10.25°C65 ms20.125°C130 ms30.0625°C250 ms模式 3 精度最高但采样最慢需根据应用场景在功耗、速度与精度间权衡。4.4 低功耗控制shutdown / wake / shutdown_wakevoid shutdown_wake(uint8_t addr, boolean sw); // true关断false唤醒 void shutdown(uint8_t addr); void wake(uint8_t addr);这是本库的特色功能之一通过读写配置寄存器0x01的 bit8MCP9808_REG_CONFIG_SHUTDOWN 0x0100实现关断与唤醒Adafruit_MCP9808.cpp。示例程序给出的功耗数据为唤醒/正常采样状态约 200 µA关断状态约 0.1 µA停止温度采样。wake()内部在清除关断位后额外delay(250)等待传感器稳定确保唤醒后立刻读取到有效数据。4.5 底层寄存器读写void write16(uint8_t reg, uint16_t val); uint16_t read16(uint8_t reg); void write8(uint8_t reg, uint8_t val); uint8_t read8(uint8_t reg);这四个方法是所有上层 API 的 I2C 原语Adafruit_MCP9808.cppread16先写寄存器地址若endTransmission()返回 0ACK 正常再requestFrom读 2 字节按大端序拼装失败时返回0xFFFFwrite16寄存器地址后先发高字节再发低字节I2C 大端序要求read8/write8单字节版本的读写。理解这些原语有助于自行扩展报警阈值、临界温度等未封装的寄存器功能。五、完整示例程序解读示例 mcp9808test.ino 演示了完整的探测 → 配置 → 唤醒读取 → 关断工作循环核心流程如下#include Wire.h #include Adafruit_MCP9808.h Adafruit_MCP9808 tempsensor Adafruit_MCP9808(); // 创建传感器对象 void setup() { Serial.begin(9600); while (!Serial); // 等待串口就绪较新 Arduino 板必需 // 传入地址做初始化自检也可省略参数使用默认地址 0x18 if (!tempsensor.begin(0x18)) { Serial.println(Couldnt find MCP9808! Check your connections and verify the address is correct.); while (1); // 找不到传感器则停机 } Serial.println(Found MCP9808!); tempsensor.setResolution(3); // 设为最高分辨率 0.0625°C / 250ms } void loop() { Serial.println(wake up MCP9808.... ); tempsensor.wake(); // 唤醒若处于关断态 Serial.print(Resolution in mode: ); Serial.println(tempsensor.getResolution()); float c tempsensor.readTempC(); float f tempsensor.readTempF(); Serial.print(Temp: ); Serial.print(c, 4); Serial.print(*C\t and ); Serial.print(f, 4); Serial.println(*F.); delay(2000); Serial.println(Shutdown MCP9808.... ); tempsensor.shutdown_wake(1); // 关断电流降至约 0.1 µA delay(200); }要点归纳启动自检begin()返回 false 即提示检查接线与地址这是排查 I2C 连接问题的第一道防线分辨率演示setResolution(3)配合getResolution()展示当前分辨率模式摄氏度/华氏度双输出readTempC()与readTempF()分别以 4 位小数打印节能循环每轮读取后调用shutdown_wake(1)关断下次循环再wake()实现周期采样下的低功耗运行。六、在 Tasmota 固件中的集成实现6.1 驱动挂载与探测流程Tasmota 通过 xsns_72_mcp9808.ino传感器驱动编号 XSNS_72接入该库。驱动的启用由编译宏控制默认配置模板中声明为//#define USE_MCP9808 // [I2cDriver51] Enable MCP9808 temperature sensor (I2C addresses 0x18 - 0x1F) (0k9 code)该宏位于 tasmota_configurations.h同时需要USE_I2C启用 I2C 子系统并在my_user_config.h中按需打开。宏注释中的[I2cDriver51]表明该驱动的 I2C 设备编号为 XI2C_51对应 I2CDEVICES.md 中的驱动清单。6.2 多传感器轮询机制驱动源码充分利用了 Tasmota 分支可变 I2C 地址的特性#define MCP9808_MAX_SENSORS 8与#define MCP9808_START_ADDRESS 0x18xsns_72_mcp9808.ino对应芯片 8 个可配置地址MCP9808Detect()在FUNC_INIT阶段从 0x18 到 0x1F 逐地址调用mcp9808.begin(addr)探测命中即登记为在线传感器并统一调用setResolution(..., 2)将分辨率设为 0.125°C/130ms精度与采样速度的折中选择MCP9808EverySecond()在FUNC_EVERY_SECOND每秒钟轮询一次所有已发现的传感器温度经ConvertTemp()换算后存入结构体。6.3 数据上报与展示MCP9808Show()负责数据输出xsns_72_mcp9808.inoJSON 上报FUNC_JSON_APPEND通过ResponseAppend_P(JSON_SNS_F_TEMP, ...)输出到 MQTT 的Tele/.../SENSOR主题多传感器时按地址生成MCP9808-18、MCP9808-1A等命名使用IndexSeparator()分隔Domoticz / KNX 联动在遥测周期为 0 时将第一个传感器温度同步到DomoticzFloatSensor(DZ_TEMP, ...)与KnxSensor(KNX_TEMPERATURE, ...)Web 界面FUNC_WEB_SENSOR通过WSContentSend_Temp()在设备主页的传感器区域显示温度。Xsns72()调度函数还在入口处调用I2cEnabled(XI2C_51)做可用性检查未启用时直接返回保证与其他 I2C 驱动并存时的行为正确。七、从库到固件的完整链路小结把前文串联起来MCP9808 在 Tasmota 中的完整数据链路为MCP9808 芯片0x18–0x1F → Adafruit_MCP9808 库readTempC / setResolution / shutdown_wake → xsns_72_mcp9808.inoI2cDriver51 探测、每秒轮询、ConvertTemp 换算 → Tasmota 框架JSON/MQTT、Web 界面、Domoticz/KNX 转发对独立 Arduino 开发而言只需引入本库头文件、按地址表配置跳线、调用begin()自检并循环readTempC()/readTempF()即可获得 ±0.25°C 级精度的温度数据对 Tasmota 用户而言启用USE_MCP9808编译宏后即可在 Web 界面与 MQTT 主题中直接读到传感器数据无需编写任何应用代码。两条路径共用同一份驱动源码这也是本仓库随附该库的核心价值所在。【免费下载链接】TasmotaAlternative firmware for ESP8266 and ESP32 based devices with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and entirely local control over MQTT, HTTP, Serial or KNX. Full documentation at项目地址: https://gitcode.com/GitHub_Trending/ta/Tasmota创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考