【ESPHome】米家WHDZ04智能插座 拆解分析&esphome适配移植

gasment

WHDZ04计量插座 ESPHome适配

产品图

• 之前90块买了3个，不知名品牌，带计量功能
  ​
• 外壳信息，出自深圳的一家公司，型号是WHDZ04
  

拆解

• 沿着背面边框缝隙可以撬开，用的胶水固定，强度不高，可以较为轻松撬开，心细一点可以无损
• 主控信息，丝印MHCWB6S-B，小米定制的MCU模块，是esp32c3的换皮，带的4MB Flash
  

• 我还挺喜欢这个模块的，体积比标准版C3-WROOM要小，价格差不多，某宝挺多货源的，如果引脚用的不多，后面考虑用这个替换C3-WROOM来做diy

  

• 跑了下IO分布，得
  
• 计量IC依旧是老朋友BL0942,esphome官方组件支持 ,当前已通过固件分析取得原厂的校准参数并还原，计量准度为官方固件水平
  ​
• 外设，一个绿色LED，一个继电器，一个微动按键
• 预留了焊点，串口和boot，而且留在了空旷面，这样不用把模块拆下来就能焊接上连接线（我拆是为了方便跑线路）
  烧录和BL0942用的不是同一路串口，因为c3支持双串口配置
  ​

‍

固件操作

• 连接串口与进入下载模式

  1. 按上图焊接好TX、RX、BOOT，这3个引脚，<span data-type="text" style="background-color: var(--b3-card-error-background); color: var(--b3-card-error-color);">供电不要直接上220V！！！</span>，可以把5V并入下图这里，注意正负极，否则放烟花
     ​
  2. 将TX/RX/GND连接到USB串口工具，将BOOT也连接到GND，然后5V上电，等待5秒左右，可以断开BOOT到GND的连接

  3. 这里使用esphome cli本做示例（cli版本自带有esptool工具），先检测连接是否成功，执行esptool chip-id，连接成功并处于下载模式会返回如下：

     (venv) D:\>esptool chip-id
     esptool v5.3.1
     Connected to ESP32-C3 on COM3:
     Chip type:          ESP32-C3 (QFN32) (revision v0.4)
     Features:           Wi-Fi, BT 5 (LE), Single Core, 160MHz, Embedded Flash 4MB (XMC)
     Crystal frequency:  40MHz
     MAC:                cc:4d:75:xx:xx:xx
     Stub flasher is already running. No upload is necessary.
     Warning: ESP32-C3 has no chip ID. Reading MAC address instead.
     MAC:                cc:4d:75:xx:xx:xx
     Hard resetting via RTS pin...

• 备份米家固件

  1. 在处于下载模式时，esphome cli执行esptool --chip esp32c3 --baud 460800 read_flash 0x000000 0x400000 origin_flash_dump.bin
     备份的固件会存放在cli所在的当前目录

  2. 如需要还原为米家固件，则处于下载模式时cli执行esptool --chip esp32c3 --baud 460800 write_flash 0x000000 origin_flash_dump.bin

     ‍

• 编译并刷写esphome固件

  1. 下载文末示列固件配置：【WHDZ04_ESPHome_FW.zip】
  2. 打开并修改main.yaml顶部的substitutions配置，按你自己实际的修改
  3. 连接串口与进入下载模式
  4. 在固件配置文件夹内运行esphome cli，执行编译：esphome run main.yaml
  5. 编译完成后会提示串口烧录，烧录完成后，断开5V供电，重新上电。
  6. 系统启动，wifi未连接时，绿灯快闪，wifi连接成功则熄灭或常亮（根据继电器状态而定）
  7. 进入HA的esphome集成，添加该设备，实体列表示例如下，其中Child Lock为童锁，启用时，物理按键无效
     ​
  8. 后续固件更新，通过无线OTA即可

示列固件配置：【WHDZ04_ESPHome_FW.zip】

游客，如果您要查看本帖隐藏内容请回复

✅以上

nbywj

学习了

xunqing

买了几个MCU变成了LN882HK，计量芯片是BL0937

gasment

xunqing 发表于 2026-8-14 10:51
买了几个MCU变成了LN882HK，计量芯片是BL0937

LN882HK走的涂鸦方案，esphome也支持该芯片

sorrypqa

厂家还算可以，不是用那种只有1M的8266主控，但依然不舍得用磁保持

wbc

esp 没有锁？！真奇怪了

xunqing

gasment 发表于 2026-8-14 11:13
LN882HK走的涂鸦方案，esphome也支持该芯片

ln882x:
  board: generic-ln882h-tuya /generic-ln882h 选择这两个能编译过，但刷进去启动不了

gasment

wbc 发表于 2026-8-16 08:42
esp 没有锁？！真奇怪了

倒不如说有锁才奇怪，厂家吃饱了撑的锁flash

冬瓜HA

哈哈，品牌文光汇

tettr

xunqing 发表于 2026-8-16 10:14
ln882x:
  board: generic-ln882h-tuya /generic-ln882h 选择这两个能编译过，但刷进去启动不了 ...

能不能成功？