智能插座本地化改造：基于BK7231芯片刷OpenBeken固件接入Home Assistant

1. 项目概述：从“云控”到“本地化”的智能插座改造

如果你家里有几个涂鸦平台的Wi-Fi智能插座，用着用着可能就会觉得有点“膈应”。功能是能用，但总感觉不踏实——设备响应时不时要看云服务的“脸色”，断网就抓瞎，隐私数据也总让人心里犯嘀咕。更重要的是，想把它深度集成到像Home Assistant这样的本地智能家居大脑里，总隔着一层官方的云API，延迟和稳定性都不可控。最近，我发现手头几个基于BK7231N和BK7231T芯片的涂鸦插座，其实藏着巨大的潜力，它们的内核完全可以通过刷写开源固件来“重获新生”，彻底摆脱云依赖，实现纯本地的MQTT协议接入。这不仅仅是换个固件那么简单，而是一次将设备所有权和控制权真正夺回自己手中的实践。

BK7231N和BK7231T是博通集成（Beken）推出的高性价比Wi-Fi SOC，在大量白牌智能插座、灯泡中非常常见。原厂涂鸦固件将其“锁”在了自家的生态里，而开源社区的力量则为我们打开了另一扇门。通过刷入诸如OpenBeken或LibreTiny等项目固件，我们可以让插座直接连接本地的MQTT服务器（比如Home Assistant内置的Mosquitto broker），所有指令（开关、功率查询）和数据（实时功率、电压）都在局域网内流转，响应速度极快，且完全断网可用。这非常适合追求稳定性、隐私和高级自动化的玩家。整个过程涉及硬件识别、固件编译（或下载）、刷机操作和Home Assistant配置四大环节，我会结合我多次实操的经验，把每个环节的细节、坑点以及背后的原理都捋清楚。

2. 核心思路与方案选型：为什么是开源固件+MQTT？

在决定动手之前，我们得先搞清楚改造的底层逻辑和为什么选择这套方案。原涂鸦插座的工作流程是：插座连接家庭Wi-Fi -> 连接涂鸦云服务器 -> 手机App通过云服务器控制插座。这个链条中，云服务器是不可或缺且不受你控制的一环。

我们的目标是切断这个云链路，变为：插座连接家庭Wi-Fi -> 连接你本地网络中的MQTT服务器 -> Home Assistant通过MQTT协议控制插座。这样一来，所有通信都在你的路由器管辖范围内完成。要实现这个转变，关键就在于替换设备上的“大脑”——固件。原厂固件只认涂鸦云，所以我们需要一个能理解MQTT协议，并且能驱动BK7231芯片硬件（GPIO控制继电器、ADC读取功率数据）的新固件。

目前，针对BK7231系列芯片，主要有两个活跃的开源项目可选：OpenBeken和LibreTiny（后者常与Tasmota固件搭配使用）。这两个项目都实现了对BK7231芯片的良好支持，提供了MQTT客户端、Web配置页面、硬件GPIO映射等核心功能。

我为什么更倾向于OpenBeken（OBK）作为入门首选？

1. 上手友好：OBK提供了现成的、针对常见插座型号预编译好的固件文件（.bin），对于新手来说，不需要搭建编译环境，下载即刷，成功率很高。
2. 配置直观：其Web配置界面非常直观，MQTT设置、Wi-Fi配置、GPIO绑定等都可以在网页上点点鼠标完成，降低了命令行操作的门槛。
3. 社区支持：针对涂鸦改装的教程和配置文件分享较多，遇到特定型号容易找到参考方案。

而LibreTiny+Tasmota方案功能更强大、更灵活，但通常需要从源码编译，以精确匹配你插座上的硬件（比如功率计量芯片的型号）。这对于进阶用户是更好的选择。本次我们将以OpenBeken为例进行详解，因为它最能体现“快速实现本地化”这个目标。选择MQTT协议，是因为它是智能家居本地化通信的事实标准，轻量、开源、跨平台，且Home Assistant对其有原生、强大的支持，集成起来非常简单稳定。

3. 准备工作与风险须知：工欲善其事，必先利其器

刷机有风险，操作需谨慎。在拆开插座之前，请务必做好以下准备，并充分理解可能的风险。

3.1 硬件与工具准备

1. 智能插座：确认你的插座主控芯片是BK7231N或BK7231T。通常需要拆机查看，芯片上会有丝印。常见的涂鸦方案插座如某米、某欧瑞博等白牌产品很多采用此芯片。
2. USB转TTL串口模块：这是与插座主板通信的桥梁。推荐使用CP2102、CH340G等型号，稳定且便宜。需要引出GND、TX、RX、3.3V四根杜邦线。
3. 拆机工具：十字螺丝刀、撬棒（或塑料卡片）。注意插座外壳可能有隐藏的卡扣，暴力拆卸易损坏。
4. 焊接工具（可能需备）：主板的串口调试引脚（通常标记为GND、TX、RX、3.3V）可能是未焊接的焊盘。你需要准备电烙铁、焊锡丝和细导线，以便将杜邦线焊接上去。对于手巧的用户，也可以使用“探针”或“鳄鱼夹”临时接触，但稳定性差，不推荐。
5. 杜邦线若干：用于连接TTL模块和插座主板。
6. 一台电脑：用于操作刷机软件和后续的配置。

3.2 软件与信息准备

1. 固件文件：从OpenBeken的GitHub Releases页面下载最新的固件。对于BK7231N，通常选择openbeken_bk7231n_xxx.bin；对于BK7231T，选择openbeken_bk7231t_xxx.bin。如果不确定，可以后续通过命令查询芯片。
2. 刷机工具 - BKWriter：这是博通官方提供的烧录工具，比通用的esptool.py对BK芯片支持更好。需要在博通集成官网或相关开源仓库查找下载。
3. 串口终端软件：如PuTTY（Windows）、screen（macOS/Linux）或Arduino IDE的串口监视器。用于查看芯片启动日志，进入刷机模式。
4. 记录信息：拆机后，用手机清晰拍摄主板正反面照片。重点记录：
   • 主控芯片型号（BK7231N/T）。
   • 继电器连接的GPIO引脚编号（通常在继电器附近有标注，如P26）。
   • 指示灯LED连接的GPIO引脚编号。
   • 功率计量芯片型号（如果有）：这是实现用电统计的关键。常见的有BL0942、HLW8032、CS5460A等。丝印通常在小芯片上。

重要风险提示：刷机过程涉及硬件操作，错误接线可能导致芯片或模块损坏。确保TTL模块的电压是3.3V，绝不可接5V！焊接时注意防静电和短路。刷机后，原厂涂鸦App将永久失效，且可能失去官方保修。请确保你理解并接受这些风险。

4. 硬件拆解与引脚识别：找到设备的“对话接口”

这是实操的第一步，也是需要耐心和细心的一步。大部分智能插座采用上下盖卡扣式设计，先拧下底部的可见螺丝，然后用撬棒沿缝隙慢慢撬开。

打开后，你会看到内部的主板。我们的核心目标是找到串口调试引脚和关键元件连接的GPIO。

1. 定位主控芯片：找到最大的那个方形芯片，上面丝印通常为BK7231N或BK7231T。
2. 寻找串口焊盘：在BK芯片周围，寻找一组四个（或更多）的未焊接的焊盘。它们通常非常细小，可能标有GND、TX、RX、3.3V（或VCC）。这里的TX、RX是相对于芯片而言的。接线时需要交叉：TTL模块的TX接插座的RX，TTL模块的RX接插座的TX。GND接GND，3.3V接3.3V。
   • 如果找不到明确标记：可以尝试在芯片的数据手册中查找UART0引脚（通常是P6/RX， P7/TX），并在对应焊盘上测试。
3. 识别继电器控制脚：继电器一般是一个黑色方块。找到从BK芯片连接到继电器线圈的两根线（或焊盘），追踪到芯片引脚。这个引脚就是控制开关的GPIO。常见的是P26。
4. 识别状态指示灯：找到板载的LED，通常是一个贴片LED。追踪其连接到芯片的引脚，这就是指示灯GPIO。常见的是P24。
5. 识别功率计量芯片：如果插座支持电量统计，会有一颗额外的芯片。记下它的型号，后续配置固件时需要。

实操心得：在焊接杜邦线之前，先用万用表蜂鸣档确认一下焊盘。将表笔一端接地（比如USB金属外壳或一个大的电容负极），另一端点焊盘，蜂鸣常响的就是GND。接着，在插座通电瞬间，用万用表直流电压档测量焊盘对GND的电压，有一个稳定在3.3V左右的，就是3.3V电源。剩下的两个大概率就是TX和RX。拍照记录你的接线方式和对应的GPIO编号，这张图在后续软件配置中至关重要。

5. 刷写OpenBeken固件：替换设备的“操作系统”

硬件接线确认无误后，就可以开始刷机了。请严格按照顺序操作。

5.1 连接串口与获取日志

1. 确保USB转TTL模块未插入电脑。
2. 按照“GND对GND， 3.3V对3.3V， TX接RX， RX接TX”的原则，连接插座主板和TTL模块。此时不要给插座上电。
3. 将TTL模块插入电脑USB口。打开串口终端软件（如PuTTY），选择正确的COM端口（在设备管理器中查看），设置波特率为115200，数据位8，停止位1，无奇偶校验，无流控。
4. 一切就绪后，给智能插座通电（插到市电插座上）。同时，在串口终端里快速、连续地按键盘上的Enter键。目的是打断芯片的正常启动流程，进入一个名为bootloader的刷机模式。
5. 如果成功，你会看到终端里出现boot>或者类似的提示符。如果没出现，可能是按键时机不对，多试几次。也可以尝试在通电瞬间将芯片的某个引脚（如P23）短暂接地来强制进入刷机模式，具体引脚需查芯片手册。

5.2 使用BKWriter刷入固件

1. 打开BKWriter工具。在MCU选项中选择你的芯片型号（BK7231N或BK7231T）。
2. 在COM端口选择你的TTL模块对应的端口。
3. 在Boot Mode选择UART。
4. 点击...按钮，选择你之前下载好的OpenBeken固件文件（.bin）。
5. 点击Download按钮。此时软件会通过串口与芯片通信，开始擦除、烧录。
6. 等待进度条完成，显示Download Success或类似的成功提示。

注意事项：整个刷写过程，插座必须保持供电稳定。如果中途失败，检查接线是否松动，串口端口是否被其他软件占用，然后重试。刷写成功后，先关闭BKWriter软件和串口终端，然后给插座断电再重新上电。

5.3 初始配置与网络连接

1. 重新打开串口终端（设置不变），给插座上电。这次我们不再按回车，而是观察启动日志。OpenBeken固件启动后，会在串口输出大量信息，并在最后创建一个名为OBK-XXXXXX的Wi-Fi接入点（AP）。
2. 用手机或电脑连接这个OBK-XXXXXX的Wi-Fi网络。连接后，通常会自动弹出配置页面，如果没有，在浏览器打开http://192.168.4.1或http://setup.obk.io。
3. 你会进入OpenBeken的初始配置向导。首先需要配置的是你的家庭Wi-Fi：
   • 在网络列表中选择你的家庭Wi-Fi SSID。
   • 输入Wi-Fi密码。
   • 点击连接。设备会重启并尝试连接你的路由器。
4. 连接成功后，记下串口日志或网页提示中设备获取到的IP地址（例如192.168.1.105）。以后就可以通过这个IP地址在浏览器中访问插座的Web管理界面了。

至此，开源固件刷写成功，设备已经脱离了涂鸦云，拥有了一个全新的、属于你的“大脑”。

6. 深入配置OpenBeken：定义硬件行为与MQTT连接

通过浏览器访问插座的IP地址，进入Web管理界面。这里是我们进行功能定制的核心。界面主要包含Main、Config、Console等标签页。

6.1 GPIO配置：告诉固件哪个脚控制什么

这是最关键的一步，将物理硬件与逻辑功能绑定。进入Config->Hardware或GPIO Configuration页面。

你会看到一个芯片引脚图列表。我们需要根据之前拆机识别的结果进行设置：

1. 继电器控制：找到你记录的继电器GPIO（例如P26）。在对应的下拉菜单中，选择Relay或Relay_i（i代表索引，第一个继电器选Relay_1）。
2. 状态指示灯：找到指示灯的GPIO（例如P24）。选择LED或LED_i。你还可以设置LED的逻辑（低电平点亮还是高电平点亮），这需要根据你的硬件电路来试。
3. 按钮配置（如果有）：如果插座上有实体按钮，找到其GPIO，选择Button或Button_i。可以用于本地手动控制。
4. 功率计量芯片：如果插座有电量统计功能，你需要配置对应的GPIO和芯片类型。例如，对于BL0942芯片，通常需要配置CF引脚（电流/功率脉冲）和CF1引脚（电压脉冲）对应的GPIO，并在Meter Type中选择BL0942。具体引脚定义需要查阅你的主板布局或社区分享的配置。

配置完成后，点击Save并重启设备。重启后，你应该能在Web界面的Main页面上看到一个物理开关按钮，点击它可以控制继电器吸合/断开，并能听到“咔嗒”声。这证明GPIO配置成功了。

6.2 MQTT配置：接入本地通信网络

进入Config->MQTT页面。这里配置设备如何与你的Home Assistant通信。

1. Host：填写你Home Assistant服务器（或独立运行的Mosquitto broker）的IP地址。
2. Port：默认是1883。
3. Client ID：可以保持默认（会基于设备MAC地址生成），也可以自定义一个易于识别的名字，如plug_living_room。
4. Username/Password：如果你的MQTT broker设置了认证，在此填写。Home Assistant默认的Mosquitto插件通常需要启用并设置用户名密码。
5. Topic：这是消息传递的“地址”。Main Topic是设备发布和订阅消息的根路径，例如home/obk/plug1。保持默认或按喜好修改即可。
6. 其他设置：Keep Alive、Clean Session通常保持默认。确保Enable MQTT是勾选状态。

保存并重启后，查看Web界面的Main页面或Console页面，应该能看到连接MQTT服务器成功的日志。同时，你的MQTT服务器（如Home Assistant的MQTT集成）应该能看到这个新设备上线。

6.3 校准与高级功能

1. 功率校准：如果配置了电量统计，在Main页面或Metering相关页面，你会看到实时电压、电流、功率、电量数据。但这些数据可能需要校准。通常需要用一个已知功率的电器（如100W白炽灯）作为负载，然后根据显示值与实际值的比例，在配置页面找到校准系数（如电压系数、电流系数、功率系数）进行调整。这是一个精细活，需要耐心。
2. 定时与自动化：OpenBeken固件内部也支持简单的定时任务和规则（在Config->Rules或Scheduler），但对于复杂自动化，建议交给Home Assistant处理，其能力更强大。

7. Home Assistant集成：完成智能控制的最后一环

当插座成功连接MQTT后，在Home Assistant中的集成就变得异常简单。Home Assistant支持MQTT的自动发现（Auto Discovery）功能。

1. 确保MQTT集成已正确运行：在HA的配置->设备与服务->集成中，确保MQTT集成已添加并状态正常。
2. 等待自动发现：OpenBeken固件默认启用了Home Assistant的自动发现协议。设备上线后，会自动向HA发送一个包含设备信息和实体（开关、传感器）的配置消息。稍等片刻（通常1-2分钟），在HA的同一页面，你应该能看到一个名为“OpenBeken”或类似的新设备被自动添加。
3. 检查实体：点击这个设备，你会看到它下面包含了若干实体，例如：
   • switch.plug_living_room：主开关。
   • sensor.plug_living_room_power：实时功率传感器。
   • sensor.plug_living_room_energy：累计电量传感器（如果支持）。
   • sensor.plug_living_room_voltage：电压传感器。
   • sensor.plug_living_room_current：电流传感器。
4. 手动配置（如果自动发现失败）：如果自动发现未生效，我们可以手动添加。在HA的配置->设备与服务->集成页面，点击右下角“添加集成”，搜索并选择MQTT。
   • 添加一个开关：主题类型选择“通过MQTT添加”，设备类型选“开关”。在“主题”中，填写home/obk/plug1/switch/1/set（订阅，用于接收HA指令）和home/obk/plug1/switch/1（发布，用于向HA报告状态）。具体主题格式需参考OpenBeken的文档或Console中实际发布的消息。
   • 添加传感器：类似地，可以手动添加功率、电量等传感器，指定正确的状态主题和值模板。

集成完成后，你就可以在HA的仪表盘上添加这些实体卡片，像控制其他设备一样控制这个插座，并将其用于自动化：比如“当功率超过500W持续5分钟，则自动关闭插座”，或者“晚上12点自动关闭客厅鱼缸的氧气泵”。

8. 常见问题与排查实录：绕开我踩过的那些坑

即使按照步骤操作，也可能会遇到问题。这里记录了几个典型问题及其解决方法。

问题1：串口无任何输出，或乱码。

• 排查：首先检查接线，确保GND、3.3V、TX、RX交叉连接正确且接触良好。确认TTL模块的电压跳线帽是3.3V（不是5V）。在设备管理器中确认COM端口号正确，串口终端参数（波特率115200，8N1）设置无误。
• 解决：尝试交换TX和RX的连接线。如果还是乱码，尝试不同的波特率，如9600。确保在插座通电的瞬间开始观察串口。

问题2：无法进入bootloader模式（按回车没反应）。

• 排查：按键时机非常关键，需要在通电后极短时间内连续敲击回车。有些板子需要将特定引脚（如P23）在通电时拉低到地才能强制进入。
• 解决：多试几次通电和敲击回车的节奏。查阅BK7231芯片手册，找到强制下载的引脚，焊接一根线，在通电瞬间将其与GND短接一下。

问题3：刷机工具BKWriter连接失败或擦除/编程失败。

• 排查：确保已成功进入bootloader模式（串口有boot>提示）。关闭所有可能占用串口的软件（如串口终端）。检查USB线是否接触不良。
• 解决：尝试以管理员身份运行BKWriter。更换一个USB端口或另一条USB线。如果是在虚拟机中使用，检查串口透传设置是否正确。

问题4：刷机后无法找到OBK-XXXXXX的Wi-Fi热点。

• 排查：固件可能未刷写成功，或刷错了芯片型号的固件（如给BK7231N刷了BK7231T的固件）。也可能是GPIO配置严重错误导致系统异常。
• 解决：重新执行刷机流程，务必确认固件文件与芯片型号匹配。刷机后，尝试长按插座上的物理按钮（如果有）10秒以上，有时可以触发恢复出厂设置并重新开启AP模式。

问题5：Home Assistant中无法自动发现设备。

• 排查：检查OpenBeken的MQTT配置是否正确，IP、端口、用户名密码无误。查看HA的MQTT集成日志（配置->日志）是否有错误。在OpenBeken的Web Console中，输入MQTTStatus命令，查看连接状态。输入ListTopics查看它发布了哪些主题。
• 解决：确认HA的MQTT Broker和插座在同一个局域网网段，且防火墙没有阻止1883端口。在OpenBeken的MQTT配置中，检查Home Assistant Discovery选项是否启用。可以尝试手动添加实体。

问题6：功率计量数据不准或为0。

• 排查：首先确认GPIO配置中，功率计量芯片的引脚和型号选择正确。用万用表测量计量芯片的供电电压是否正常。
• 解决：进行功率校准。这是一个逐步调整系数的过程。在OBK的Web界面，找到计量校准页面，接入一个纯阻性负载（如电吹风或白炽灯，避免用开关电源的设备），记录实际功率（用功率计测量）和OBK显示功率，计算校准系数并填入。电压和电流的校准也类似。

整个改造过程，从硬件拆解到软件配置，最需要的就是耐心和细致的观察。每一次成功的本地化，不仅意味着多了一个稳定可靠的设备，更代表着你对自己智能家居环境控制权的进一步巩固。当你在家庭网络中断的情况下，依然能通过本地局域网流畅地控制所有灯光插座时，那种安全感和掌控感，是依赖云服务的方案无法比拟的。