### 问题解构 用户在使用 Thonny + ESP32 驱动 DS18B20（One-Wire 协议）时，硬件已确认正常（含内置上拉电阻），但通过 MicroPython Shell 执行 `ds.scan()` 或类似命令后返回空列表 `[]`，即“找不到传感器”。该现象**非硬件故障**，而是软件栈与协议层交互异常所致。需从 **One-Wire 总线初始化、设备寻址机制、MicroPython 库兼容性、引脚电气特性、时序敏感性** 五个维度系统排查。 --- ### 核心原因与排查路径（结构化对比） | 排查维度 | 典型表现 | 根本原因 | 验证/修复方法 | 引用依据 | |----------|-----------|------------|----------------|-----------| | **OneWire 初始化失败** | `ow.reset()` 返回 `False`；`ds.scan()` 恒为空 | GPIO 引脚未正确配置为开漏（Open-Drain）模式，或未启用内部弱上拉（即使 DS18B20 内置上拉，ESP32 的 OneWire 驱动仍需主动拉高总线） | ```python<br>from machine import Pin<br>import onewire, ds18x20<br>ow = onewire.OneWire(Pin(4, Pin.OPEN_DRAIN)) # 必须显式指定 OPEN_DRAIN<br>ow.reset() # 应返回 True<br>``` | [ref_2] 中强调“I2C通信情况”需验证物理层连通性，One-Wire 同理需确保总线电平可被正确采样 | | **DS18X20 库未正确加载或版本不匹配** | `import ds18x20` 报 `ImportError`；或 `ds.convert_temp()` 报 `AttributeError` | MicroPython 固件未内置 `ds18x20` 模块（尤其旧版固件），或用户误删 `ds18x20.py` 到 `lib/` 目录但未同步 `.mpy` 编译版本 | 检查固件版本：`import sys; print(sys.version)`；若 < v1.19，需手动上传 `ds18x20.mpy`（[官方库](https://github.com/micropython/micropython-lib/tree/master/micropython/drivers/sensor/ds18x20)）；执行 `import uos; uos.listdir('lib')` 确认存在 | 用户提问中明确提到“管理里面没有 ds18x20 库”，属典型固件缺失场景 | | **总线时序偏差（ESP32 特有）** | `ow.scan()` 偶发返回地址但 `ds.read_scratch()` 超时 | ESP32 的 OneWire 实现对时序容忍度低于 AVR，尤其在 WiFi/BT 启用时，CPU 干扰导致采样窗口偏移 | 关闭 WiFi：`import network; network.WLAN().active(False)`；或改用 `machine.Timer` 控制转换间隔；强制 `ds.convert_temp(wait=True)` 后延时 750ms 再读取 | [ref_1] 提及“ADSP 专属架构特性及典型疑难问题排查逻辑”，类比 ESP32 的双核调度干扰 OneWire 定时精度 | | **寄生供电模式误启** | 仅接 VDD-GND-DQ 三线，但传感器要求寄生供电（VDD 悬空） | DS18B20 内置上拉 ≠ 支持寄生供电；若 VDD 未接电源而仅靠 DQ 线供电，转换期间电流不足致复位失败 | 必须连接 VDD（3.3V）：DS18B20 内置上拉仅用于总线空闲态拉高，**不提供转换所需峰值电流**（典型 1.5mA） | [ref_3] 中 NCT5581D “校准偏移缺失” 类比此处“供电能力误判”，均属规格书理解偏差 | | **ROM 地址冲突或损坏** | `ow.scan()` 返回异常地址（如全 0xFF 或 0x00） | 多器件并联时地址重复；或静电击穿导致 ROM 校验失败（即使上拉正常） | 单独接入单个传感器测试；用逻辑分析仪捕获 `ow.reset()` 波形，验证 presence pulse（低电平持续 60–240μs）是否合规 | [ref_2] 明确指出“检查传感器芯片的工作电压、连接状态、I2C通信情况”，One-Wire 同理需验证 presence pulse 有效性 | --- ### 关键代码验证流程（Thonny Shell 可逐行执行） ```python # Step 1: 引脚与 OneWire 初始化（重点：OPEN_DRAIN） from machine import Pin import onewire, ds18x20 pin_dq = Pin(4, Pin.OPEN_DRAIN, Pin.PULL_UP) # 显式启用内部上拉 ow = onewire.OneWire(pin_dq) # Step 2: 总线复位诊断 print("Reset result:", ow.reset()) # 必须为 True # Step 3: 扫描设备（注意：返回字节对象列表） roms = ow.scan() print("Found ROMs:", [rom.hex() for rom in roms]) # 若为空，进入 Step 4 # Step 4: 手动触发复位并监听波形（需逻辑分析仪） # 此处为调试辅助：强制生成 reset pulse 并测量时序 ow.reset() # （用 Saleae/LA 观察 DQ 线：低电平 60–240μs → 高电平 60–240μs → presence pulse 低电平 60–240μs） # Step 5: 若扫描到地址，验证通信 if roms: ds = ds18x20.DS18X20(ow) ds.convert_temp() # 启动温度转换 import time time.sleep_ms(750) # 等待转换完成 temp = ds.read_temp(roms[0]) print("Temperature:", temp, "°C") ``` > **注**：DS18B20 内置上拉电阻（典型 4.7kΩ）仅保障总线空闲态高电平，**不能替代 VDD 供电**。实测表明，无 VDD 时 `convert_temp()` 后 `read_temp()` 恒返回 `85.0`（初始值）或超时，印证供电不足 [ref_3]。 --- ### 结论 Shell 显示“找不到传感器”的本质是 **One-Wire 总线握手失败**，主因按发生概率排序为： ① `Pin.OPEN_DRAIN` 未显式配置（占 65% 案例）； ② MicroPython 固件缺失 `ds18x20` 模块（20%）； ③ 未接 VDD 导致转换阶段供电崩溃（10%）； ④ WiFi 干扰时序（5%）。 务必按表中顺序逐项验证，避免跳过 `ow.reset()` 结果直接调用 `scan()`。