01开发指令

控制与采集

远程控制分合闸

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：switch.control

指令简介

控制智能断路器机构执行合闸（通电供电）或分闸（切断供电）操作。机械执行过程约 200~500ms。若设备当前处于保护跳闸锁定状态或存在未排除的物理故障，合闸将被拒绝并返回 denied 错误码。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001001",
  "cmd": "switch.control",
  "data": {
    "key": 1
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001001",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "switch.control",
  "ok": true,
  "err": "",
  "data": {
    "key": 1
  }
}

字段属性

💡 注意事项：

- 机构动作切换期间（约 0.5 秒）收到新指令，设备将返回 busy 错误码。

- 保护跳闸后必须排除现场隐患，经故障复位（或下发指令前确认故障消除）后方可允许合闸。

获取电气计量数据

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：energy.info

指令简介

查询 2P 断路器的完整电气运行数据：包含单相电压、电流、有功功率、累计用电量以及断路器内部板载温度传感器数值（测量精度 ±2%）。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001007",
  "cmd": "energy.info"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001007",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "energy.info",
  "ok": true,
  "err": "",
  "data": {
    "energyKwh": 1285.64,
    "temperatureC": 41.5,
    "voltageV": 226.5,
    "currentA": 18.24,
    "powerW": 4131.3
  }
}

字段属性

查询保护阈值与动作

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：protect.info

指令简介

获取断路器当前生效的全部安全保护阈值（漏电、过载、过温、过流、过压、欠压）及其触发动作模式。下表示例值为设备出厂默认阈值，各参数的可设置范围见「设置保护阈值与动作」章节的参数一览表。

动作策略字段（xxxAction / leakAction）取值统一为：0 = 达到阈值时仅上报告警、不跳闸；1 = 达到阈值时上报告警并执行跳闸，跳闸后须排除现场故障方可重新合闸。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001010",
  "cmd": "protect.info"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001010",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "protect.info",
  "ok": true,
  "err": "",
  "data": {
    "leakMa": 30,
    "leakAction": 1,
    "overPowerW": 13,
    "overPowerAction": 1,
    "overTempC": 80,
    "overTempAction": 1,
    "overCurA": 63,
    "overCurAction": 1,
    "overVoltV": 275,
    "overVoltAction": 1,
    "underVoltV": 160,
    "underVoltAction": 1
  }
}

字段属性

获取设备基础信息

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：device.info

指令简介

查询设备的硬件规格型号、固件版本号、协议版本号、Wi-Fi 网络详情、当前合分闸状态、锁扣状态。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001002",
  "cmd": "device.info"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001002",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "device.info",
  "ok": true,
  "err": "",
  "data": {
    "productModel": "MFCB-2PL-63",
    "firmwareVersion": "1.0.0",
    "hardwareVersion": "1.0",
    "protocolVersion": "0.1",
    "wifiData": {
      "ssid": "Office_WiFi",
      "rssi": -52,
      "ip": "192.168.1.188"
    },
    "key": 1,
    "keyLockState": 0,
    "wifiLockState": 0
  }
}

字段属性

查询网络及通讯参数

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.info

指令简介

查询设备当前的 Wi-Fi 网络参数以及正在启用的远程通道配置（MQTT 或 TCP Client）。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001012",
  "cmd": "config.info"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001012",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.info",
  "ok": true,
  "err": "",
  "data": {
    "wifiData": {
      "ssid": "Office_WiFi",
      "ip": "192.168.1.188",
      "gateway": "192.168.1.1",
      "netmask": "255.255.255.0",
      "rssi": -52
    },
    "mqttData": {
      "server": "iot.move-lan.com",
      "port": 1883,
      "clientId": "MFCB-2PL-63_a0b1c2d3e4f5",
      "username": "device_user",
      "subscribe": "/tenant01/user01/MFCB-2PL-63/a0b1c2d3e4f5/sub",
      "publish": "/tenant01/user01/MFCB-2PL-63/a0b1c2d3e4f5/pub"
    }
  }
}

字段属性

数据定时上报与预警上报

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/pub

指令：device.report

指令简介

设备向服务端发布的主动上报消息。服务端订阅上述主题接收。 触发场景：

1. 周期定时：cause: "periodic", source: "device"
2. 远程控制状态变化：cause: "remote", source: "remote"
3. 本地手动手柄/按键操作：cause: "localKey", source: "localKey"
4. 安全保护跳闸：cause: "protect", source: "device"（附带 fault 故障掩码及告警特征值）
5. 通电上线/重启首报：cause: "boot", source: "device"

设备向服务端上报消息 (以保护跳闸上报为例)

{
  "messageId": "evt-1725257000000-001",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "device.report",
  "ts": 1725257000000,
  "cause": "protect",
  "source": "device",
  "data": {
    "key": 0,
    "energyKwh": 1285.64,
    "temperatureC": 41.5,
    "rssi": -52,
    "fault": 8,
    "leakagecurr": 36,
    "voltageV": 226.5,
    "currentA": 0.0,
    "powerW": 0.0
  }
}

字段属性

故障位掩码定义表 (faultBits)

断路器若检测到多项异常，将按各故障位对应的数值进行十进制累加。例如漏电（8）+ 过压（1024）同时发生时，fault = 1032。

管理与维护

设置保护阈值与动作

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：protect.set

指令简介

配置断路器的保护阈值和动作策略。支持增量修改（只传递需要变更的字段，其余参数自动保持原值），修改后立即生效并持久化写入 NVS。

• 阈值参数：各字段的单位、可设置范围与出厂默认值见下方「保护阈值参数一览」，传入范围外的数值将返回 bad_param 错误码。
• 动作策略参数：0 = 达到阈值时仅上报告警、不跳闸；1 = 达到阈值时上报告警并执行跳闸。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001011",
  "cmd": "protect.set",
  "data": {
    "leakMa": 30,
    "leakAction": 1,
    "overCurA": 63
  }
}

字段属性

保护阈值参数一览

下列为 data 中全部可设置参数，「出厂默认值」为设备恢复出厂设置后的取值，所有参数均支持单独下发（增量修改）。动作策略字段统一为：0 = 达到阈值时仅上报告警、不跳闸；1 = 达到阈值时上报告警并执行跳闸，跳闸后须排除现场故障方可重新合闸。传入可设置范围外的数值将返回 bad_param 错误码。过载阈值字段名沿用协议既有命名 overPowerW，取值单位为 kW。

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001011",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "protect.set",
  "ok": true,
  "err": "",
  "data": {
    "leakMa": 30,
    "leakAction": 1,
    "overPowerW": 13,
    "overPowerAction": 1,
    "overTempC": 80,
    "overTempAction": 1,
    "overCurA": 63,
    "overCurAction": 1,
    "overVoltV": 275,
    "overVoltAction": 1,
    "underVoltV": 160,
    "underVoltAction": 1
  }
}

字段属性

设置定时上报频率

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.report.set

指令简介

配置断路器主动周期上报电气状态数据（device.report）的开关与上报周期（秒）。设置成功后设备立即触发一次上报，以便平台即刻对齐最新状态。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001019",
  "cmd": "config.report.set",
  "data": {
    "enable": 1,
    "intervalSec": 15
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001019",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.report.set",
  "ok": true,
  "err": "",
  "data": {
    "enable": 1,
    "intervalSec": 15
  }
}

字段属性

设置MQTT通信参数

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.mqtt.set

指令简介

配置设备外连的私有 MQTT Broker 地址、端口、客户端 Client ID、账号密码以及订阅/发布主题。修改后需软重启生效。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001017",
  "cmd": "config.mqtt.set",
  "data": {
    "server": "iot.yourdomain.com",
    "port": 1883,
    "clientId": "MFCB-2PL-63_a0b1c2d3e4f5",
    "username": "device_user",
    "password": "device_password123",
    "subscribe": "device/a0b1c2d3e4f5/command",
    "publish": "device/a0b1c2d3e4f5/event"
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001017",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.mqtt.set",
  "ok": true,
  "err": "need_restart",
  "data": {
    "server": "iot.yourdomain.com",
    "port": 1883,
    "clientId": "MFCB-2PL-63_a0b1c2d3e4f5",
    "username": "device_user",
    "subscribe": "device/a0b1c2d3e4f5/command",
    "publish": "device/a0b1c2d3e4f5/event"
  }
}

字段属性

设置TCP通信参数

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.tcp.set

指令简介

配置断路器的 TCP Client（外连客户端）参数。配置 server 与 port 即启用 TCP Client 模式；若将 server 设为空字符串 "" 则关闭该通道。本设备仅提供 TCP Client，不支持本地 TCP Server。修改后需重启生效。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001018",
  "cmd": "config.tcp.set",
  "data": {
    "tcpMode": 0,
    "server": "192.168.1.200",
    "port": 9000
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001018",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.tcp.set",
  "ok": true,
  "err": "need_restart",
  "data": {
    "server": "192.168.1.200",
    "port": 9000
  }
}

字段属性

设置WiFi联网参数

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.wifi.set

指令简介

通过指令直接下发目标 Wi-Fi 路由器的 SSID 与密码，设备联网后通过 DHCP 自动获取 IP 地址。修改后需软重启使网络生效（应答携带 err: "need_restart"）。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001016",
  "cmd": "config.wifi.set",
  "data": {
    "ssid": "Factory_AP_01",
    "password": "factory@password2026"
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001016",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.wifi.set",
  "ok": true,
  "err": "need_restart",
  "data": {
    "ssid": "Factory_AP_01"
  }
}

字段属性

设置配网锁

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.wifiLock.set

指令简介

锁定或解锁设备的物理按键进入配网权限。开启配网锁后，现场长按按键将无法使设备进入 AP 热点配网模式，防止公共场所设备被恶意篡改网络配置。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001015",
  "cmd": "config.wifiLock.set",
  "data": {
    "lockState": 1
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001015",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.wifiLock.set",
  "ok": true,
  "err": "",
  "data": {
    "lockState": 1
  }
}

字段属性

设置锁扣模式

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：config.keyLock.set

指令简介

配置断路器的本地机械手柄/物理按键操作权限，以及在电网异常跳闸恢复后的自动合闸行为。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001014",
  "cmd": "config.keyLock.set",
  "data": {
    "lockState": 1
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001014",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "config.keyLock.set",
  "ok": true,
  "err": "",
  "data": {
    "lockState": 1
  }
}

字段属性

漏电保护自检

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：device.leaktest

指令简介

远程模拟按下断路器面板上的机械 “TEST” 漏电自检按钮。设备在内部回路注入测试漏电信号以检验漏保检测与脱扣机构完整性。 前置条件：断路器必须处于合闸通电状态（key=1）。若当前处于分闸状态，设备拒绝执行并返回 denied。自检正常触发后断路器将执行脱扣分闸（key=0）；若注入信号后未脱扣，则置 fault 故障掩码第 7 位（128）并禁止合闸。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001005",
  "cmd": "device.leaktest"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001005",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "device.leaktest",
  "ok": true,
  "err": "",
  "data": {
    "key": 0,
    "fault": 0
  }
}

字段属性

固件升级

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：device.upgrade

指令简介

向断路器下发固件升级任务。设备校验 URL 合法性后，将在后台通过 HTTP/HTTPS 下载 .bin 固件包，进行 MD5/SHA256 完整性校验，确认无误后自动刷入 Flash 并重启上线。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001006",
  "cmd": "device.upgrade",
  "data": {
    "url": "http://oss.move-lan.com/firmware/MFCB-2PL-63_v1.1.0.bin"
  }
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001006",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "device.upgrade",
  "ok": true,
  "err": "",
  "data": {
    "state": "accepted"
  }
}

字段属性

设备重启

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：device.restart

指令简介

远程软重启断路器微控制器系统。重启不改变断路器现有的合分闸机械位置与故障记录，成功响应后 1 秒内重启。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001003",
  "cmd": "device.restart"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001003",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "device.restart",
  "ok": true,
  "err": ""
}

字段属性

设备恢复出厂

/{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/sub

指令：device.reset

指令简介

破坏型维护指令。清除设备内部 NVS 存储的所有用户配置（Wi-Fi、MQTT、TCP、保护阈值、锁状态等），分闸并清除所有保护跳闸锁定状态，恢复出厂默认 AP 待配网模式。业务层调用前必须弹窗二次确认。

向设备发送指令 | 服务端向设备下发

{
  "messageId": "202610191200001004",
  "cmd": "device.reset"
}

字段属性

设备返回信息 | 设备向服务端应答

{
  "messageId": "202610191200001004",
  "deviceId": "a0b1c2d3e4f5",
  "cmd": "device.reset",
  "ok": true,
  "err": ""
}

字段属性

错误码表

遵循全系通用基线规范，所有应答中的 err 字段统一遵循以下枚举：

02产品概述

适用型号：MFCB-2PL-63

文档版本：V1.0

产品概况

本设备是一款支持二次开发的智能断路器 220V 63A 漏保版（MFCB-2PL-63），专为单相用电场景与能效管理设计。设备采用标准 DIN 导轨安装结构，支持原位替换传统断路器，轻松完成智能化部署。设备内置 ESP8266 Wi-Fi 芯片，全面支持自定义 MQTT 与 TCP Client 双通信通道，具备合分闸远程控制、单相电气参数实时监测、保护阈值配置及漏电保护与远程自检能力。

设备全面开放控制与状态上报协议，开发者可通过标准的 MQTT/TCP 参数连接、API 接口调用，轻松接入自建业务平台与物联网系统，实现自定义功能开发与系统集成；设备亦支持接入各大主流物联网云平台（阿里云、腾讯云、华为云）以及开源系统（ThingsBoard、HomeAssistant），满足多样化部署需求。

外观及尺寸

产品尺寸

机身尺寸

外接天线尺寸（选配）

俯视尺寸

尺寸标注说明：

- 机身尺寸：53.7mm (宽) × 100.4mm (高) × 69mm (深)，正面操作手柄凸出 16mm。

- 天线规格：标配折叠胶棒天线高度 20mm / 长度 65mm；可选配外置磁吸天线（SMA 内针接口，内径 6mm，天线总高 198mm，磁吸底座直径 30mm，电线长度 2 米）。

- 安装方式：标准 35mm DIN 导轨卡装。

产品外观

产品参数

03开箱接线

适用型号：MFCB-2PL-63

文档版本：V1.0

⚠️ 重要提示：

本篇文档仅供研发人员、测试工程师在实验室或办公桌面环境下进行快速开箱体验、协议联调、配网测试及合分闸动作验证。

实际工程现场安装、动力配电柜施工及大功率负载接入，请务必严格参考 👉 07_安装施工篇。

安全提示

在进行接线与通电测试前，请务必注意以下安全守则：

1. 强电安全警示：接线与调整线路时必须先拔掉插头彻底断电，严禁带电作业。
2. 严禁零火反接：零线必须准确接入标有 N 的输入孔，严禁将火线与零线接反，以免损坏设备内部供电模块。
3. 务必安装天线：通电前必须先将附带的 Wi-Fi 胶棒天线拧紧安装在机身天线接口上，未装天线会导致无线信号极弱、无法配网或频繁离线。
4. 负载出线端悬空：桌面快速测试主要验证通信、配网和合分闸控制，下端出线口（负载端）建议全部保持悬空，严禁短路。

接线说明

🔌 接线示意图：

通电与自检

完成接线后，请按以下步骤进行初次通电与设备自检：

1. 接线检查：确认上端接线已插紧并拧紧螺丝，天线已安装牢固，下端出线端子无碰线短路。
2. 通电：将测试插头通电。
3. 指示灯状态自检：
   • 🟢 绿色指示灯（电源）：通电后常亮，表示断路器内部供电正常。
   • 🔴 红色指示灯（网络）：
     • 若为出厂未配网状态，红灯呈现慢速呼吸闪烁（周期约 1 秒），表示设备已进入待配网状态；
     • 若设备已配网联网，红灯将自动熄灭。
4. 手动分合闸测试：
   • 向上推起手柄至 ON，听到清脆机械动作声，手柄合闸就位；
   • 向下拉下手柄至 OFF，机械分闸断开。确认机构动作顺畅。

04设备配网

适用型号：MFCB-2PL-63

文档版本：V1.0

前置条件：断路器已按 03_开箱接线指南（桌面快速体验）或 07_安装施工指南（现场工程安装）完成接线通电，且正面绿色电源指示灯常亮。

配网流程

智能断路器在投入使用前，必须先将其接入现场的 2.4GHz Wi-Fi 无线局域网或互联网。设备采用标准的 AP 网页配网（Web Config） 模式，无需安装额外 App，使用带有 Wi-Fi 功能的手机、平板或笔记本电脑即可轻松完成。

┌─────────────────────────────────────────────────────────────┐
│ 1. 接线通电：断路器正确接线并通电，绿色指示灯亮起           │
└──────────────────────────────┬──────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 2. 进入配网：长按按键 6 秒，红色指示灯进入均匀呼吸闪烁      │
└──────────────────────────────┬──────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 3. 连接热点：手机连接设备热点 MosFlash_XXXXXX (密: mf12345678)│
└──────────────────────────────┬──────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 4. 网页配置：打开 192.168.4.1，选择现场 2.4G Wi-Fi 并输密   │
└──────────────────────────────┬──────────────────────────────┘
                               │
                               ▼
┌─────────────────────────────────────────────────────────────┐
│ 5. 联网成功：红灯熄灭，设备成功连接现场局域网并获取 IP      │
└─────────────────────────────────────────────────────────────┘

指示灯说明

断路器正面面板配备 LED 指示灯：绿色指示灯（🟢） 与 红色指示灯（🔴）：

配网环境要求与注意事项

⚠️ 注意事项：

- 仅支持 2.4GHz Wi-Fi：本设备 Wi-Fi 芯片工作于 2.4GHz 频段，不支持 5GHz Wi-Fi，且不支持需要 Web 页面二次点击认证的公共 Portal 网络。若现场路由器为 2.4G/5G 双频合一，请在路由器后台将 2.4G 单独拆分为独立 SSID 后再连接。

- 金属配电箱信号遮挡：若断路器安装于全封闭金属配电箱内，无线电波衰减显著，配网时建议将手机靠近断路器，必要时将配电箱外门开启或选配外置天线引出。

配网步骤

1. 使设备进入配网状态：
   • 断路器通电正常后，使用细绝缘针或手指连续长按保持约 6 秒，观察红色指示灯进入呼吸闪烁状态，设备即释放 AP 配网热点。
2. 连接设备 AP 热点：
   • 打开手机或笔记本电脑的 Wi-Fi 设置，搜索并连接设备释放的热点，热点名称通常为 MosFlash_XXXXXX（后 6 位为 MAC 尾缀，连接密码是 mf12345678）。

1. 打开配置页面：
   • 连接热点后，手机通常会自动弹出配置登录界面；若未自动弹出，请在浏览器中手动输入配网后台地址：http://192.168.4.1。默认登录密码为 mf12345678。

1. 选择现场 Wi-Fi 并连接：
   • 在正确输入登录热点密码后，进入后台配置界面，选择 WIFI 标签页。在弹出的 Web 页面中选择现场需要接入的 2.4GHz Wi-Fi 名称，输入密码后点击【连接网络】。

1. 配网成功与确认：
   • 设备将保存 Wi-Fi 参数并自动尝试连网。红灯由呼吸转为熄灭，页面显示【Wi-Fi 连接成功】及设备在局域网内分配到的 IP 地址。

常见问题

05接入调试

适用型号：MFCB-2PL-63

文档版本：V1.0

前置条件：断路器已正确接线通电，且完成 Wi-Fi 配网（正面红色指示灯熄灭，Wi-Fi 连接正常）。若尚未配网，请先参考 04_设备配网。

接入调试方式选择与对比

断路器出厂固件已默认内置官方开发者平台接入参数，配网成功后即可开箱即连。同时，设备也完全开放了私有通信后台，支持自主对接私有云。请根据您的角色与研发阶段选择最适合的调试路径：

运维助手小程序调试

💡 特点：无需携带电脑，掏出手机即可在施工现场或配电箱旁完成断路器的功能验证。

1. 适用场景与准备工作

• 适用场景：开箱初检、现场接线后通电测试、合分闸机构校验、回路负荷核对。
• 准备工作：
  1. 手机已安装微信，并连接现场 Wi-Fi 或处于移动网络状态。
  2. 获取断路器正面铭牌上的 12 位 MAC 地址（或机身二维码）。

2. 进入小程序与添加设备

1. 打开手机微信，在上方搜索栏搜索 “木澜设备助手”，或扫描设备配套的小程序码进入。
2. 用MosFlash开发者账号登录【木澜设备助手】。

1. 点击主界面右上角【+ 添加设备】，扫描断路器二维码，或手动输入机身 12 位 MAC 地址（例如 a0b1c2d3e4f5），点击【确认绑定】，另外也可通过发货单上提供的批次码将此次购买的所有设备一次全部添加。（每个批次码只能用一次）

1. 绑定成功后，设备列表中将立即显示该断路器卡片，在线状态图标呈 绿色在线。

3. 核心指令快速调试示例

智能断路器内置数十项电气采集、动作控制、保护阈值配置与告警事件指令。为了帮助您快速建立调试感受，此处仅以最基础的 1~2 项核心指令 作为快速验证示例：

1. 示例一：远程合闸与分闸控制（验证动作回路）：
   • 点击界面上的【合闸】或【分闸】开关。
   • 预期现象：断路器内部电机迅速动作（约 200~500ms），机械手柄推向对应闭合或断开位置，正面绿色指示灯（🟢）合闸亮起、分闸熄灭，小程序端状态同步刷新。

1. 示例二：单相用电数据读取（验证采集回路）：
   • 在详情页中查看或点击刷新电气数据。
   • 预期现象：界面实时展示断路器上报的电压（V）、电流（A）、有功功率（W）、机壳内部温度（℃）以及累计总电能（kWh）。

💡 探索更多功能与高级指令：

除上述基础动作外，断路器还支持漏电保护自检、过欠压保护定值设置等丰富能力。您可以：

- 小程序端快捷体验：直接在小程序控制页面的【快捷指令】面板中点击各功能按钮逐项体验；

- 深入接口研发：对照《01_开发指令.md》开发指令集，了解各指令完整的 JSON 请求参数与应答字段规范。

- 注意：小程序返回的数据只是针对下发指令的响应，并不是设备实时的上报数据。实时数据观察可参考 MQTTX客户端调试。

开发者控制台调试

💡 特点：官方全功能可视化工作台，适合在工位办公、需对照 API 报文格式、进行深层参数配置的开发人员。

1. 适用场景与平台登录

• 适用场景：API 指令集联调、协议报文校验、多台设备批量巡测、固件 OTA 升级验证。
• 登录平台：使用电脑浏览器访问官方开发者控制台：http://manage.move-lan.com，新用户请先注册并登录账号。

2. 添加设备与确认在线状态

1. 登录后，进入左侧导航栏【设备管理】 -> 【设备列表】，点击左上角【添加设备】按钮。
2. 在弹出窗口中，输入设备的 MAC 地址（12 位十六进制，不区分大小写）点击【确认添加】；也可以通过批次码将此次购买的所有设备一次全部添加。（每个批次码只能用一次）

1. 页面返回设备列表，确认设备成功绑定入库：

1. 确认在线状态：
   • 在线（绿色正常）：表示断路器已与官方云平台建立 MQTT 长连接，可以立即进行指令下发。
   • 离线（灰色）：表示断路器未连接云平台，请检查配电箱 Wi-Fi 信号，或参考 04_设备配网 重新配网。

3. 控制台在线指令调试示例

在设备列表中点击该断路器操作栏的【在线调试】进入可视化调试工作台。平台提供了丰富的可视化测试按钮与自定义指令下发面板，此处同样精选 1~2 项核心指令 进行联调演示：

1. 示例一：远程合闸与分闸控制（验证动作与报文闭环）：
   • 在控制开关面板中点击【合闸】或【分闸】。
   • 预期现象：断路器内部电机迅速动作（约 200~500ms），机械手柄推向对应位置，正面绿色指示灯（🟢）合亮分灭；控制台右侧事件流水中即刻接收到设备上报的 device.report。

1. 示例二：读取单相用电数据（验证电气量测量回路）：
   • 点击【读取实时数据】（触发 energy.info）。
   • 预期现象：界面即时刷新显示电压、电流、有功功率以及总电能累计值（kWh），误差在标称 ±2% 范围内；同屏还显示机壳内部温度（℃），用于判断内部温升是否正常。

1. 双向报文流水监控（开发者重点关注）：
   • 调试控制台底部配备了【实时日志】监控窗口，能完整展示下行的指令 JSON 与上行的应答/上报 JSON 帧。开发者可通过日志核对 messageId 对应关系、字段名称及响应耗时。

注意：控制台返回的数据只是针对下发指令的响应，并不是设备实时的上报数据。实时数据观察可参考 MQTTX客户端调试。

💡 探索更多控制台功能与高级指令：

断路器支持的完整功能涵盖保护阈值参数整定、漏电保护自检（device.leaktest）、定时策略等。您可以：

- 控制台快捷体验：直接在控制台界面的【快捷指令/调试面板】中点击对应按键或输入自定义 JSON 指令逐项体验；

- 深入接口研发：对照《01_开发指令.md》开发指令集，了解各指令完整的 JSON 请求参数与应答字段规范。

4. 调试实操视频教程

📺 *官方控制台实操调试全流程视频指引：*

- 视频指引：视频制作中（暂无，先按下方图文步骤操作）

<span id="mqttx-debug"></span>

MQTTX客户端调试

💡 特点：开发者无需自行搭建私有 MQTT Broker，即可使用桌面端专业工具（如 MQTTX）直接接入官方测试环境，在本地进行真实下行控制与上行数据监听。

1. 核心价值与运作原理

当断路器按出厂默认设置完成配网后，它会自动连接木澜官方开发者平台。官方平台为每个注册开发者提供了专属的 MQTT 调试接入测试账号：

1. 零部署成本：您无需搭建 EMQX、Mosquitto 等私有服务器，直接使用官方提供的 Broker 节点。
2. 安全隔离机制：该测试账号具备严格的数据隔离权限，仅允许测试控制绑定在当前登录用户下的设备，无法向其他未绑定的设备下发指令，也无法窥探他人数据。
3. 真实协议闭环：通过 MQTTX 客户端下发原始 JSON 指令，直接与断路器双向交互，非常适合用于前期编写自动化脚本或验证协议报文。

┌─────────────────────────┐          ┌─────────────────────────┐          ┌─────────────────────────┐
│     本地电脑 MQTTX 工具   │          │   木澜官方测试 Broker     │          │   现场断路器 (已配网)    │
│ (使用平台提供的测试账号)  │          │   manage.move-lan.com   │          │  (出厂默认直连官方平台)  │
└────────────┬────────────┘          └────────────┬────────────┘          └────────────┬────────────┘
             │                                    │                                    │
             │ 1. 订阅目标设备上报主题 (/pub 或 +/pub) │                                    │
             ├───────────────────────────────────►│                                    │
             │                                    │                                    │
             │ 2. 向指定设备发布下行控制 (/sub)     │                                    │
             ├───────────────────────────────────►│ 3. 匹配鉴权后转发至目标设备        │
             │                                    ├───────────────────────────────────►│
             │                                    │                                    │ 4. 机构动作合分闸
             │                                    │ 5. 设备应答及主动上报 (/pub)       │
             │ 6. 接收并打印应答与事件报文         │◄───────────────────────────────────┤
             │◄───────────────────────────────────┤                                    │

2. 获取专属 MQTT 调试测试凭据

登录 PC 端控制台（http://manage.move-lan.com），在【开发者参数】 -> 【MQTT 接入参数】中查阅您的专属连接凭据：

3. MQTTX 连接与交互调试实操

推荐使用开源跨平台的 MQTTX 客户端进行联调：

步骤 1：在 MQTTX 中新建连接

1. 打开 MQTTX 客户端，点击左上角【+ New Connection】：
   • Name：MoveLan_Cloud_Debug
   • Host：manage.move-lan.com
   • Port：1883
   • Client ID：点击右侧刷新按钮随机生成（如 debug_client_pc_01）
   • Username：填入控制台获取的专属测试用户名（例如 user_test_xxxxxx）
   • Password：填入控制台获取的测试密码
2. 点击右上角【Connect】按钮。当状态显示为绿色的 Connected 时，说明本地工具已成功连通官方平台。

📌 核心原理：直观理解设备的「发布主题」与「订阅主题」的对称关系

初学物联网协议时，最容易在客户端与设备的 pub / sub 方向上混淆。请牢记两者的对称收发关系：

| 角色与主体 | 动作方向 | 对应 MQTT 主题 | 交互场景说明 |

| :--- | :--- | :--- | :--- |

| 设备端（断路器） | 收听/订阅 (Sub) | .../{deviceId}/sub | 设备开机后在后台静默监听此主题，等待上位机下发指令 |

| 开发者（MQTTX） | 发送/发布 (Pub) | .../{deviceId}/sub | 【给设备发指令】：开发者向设备的 Sub 主题发消息，设备才能收到 |

| 设备端（断路器） | 发送/发布 (Pub) | .../{deviceId}/pub | 设备执行完毕、回复回执或周期上报时，向此主题对外广播数据 |

| 开发者（MQTTX） | 收听/订阅 (Sub) | .../{deviceId}/pub | 【收设备的回复】：开发者必须在 MQTTX 订阅设备的 Pub 主题，才能看到回包 |

步骤 2：精准订阅指定设备的对应上报主题（Pub）

在进行单台设备的定向调试时，首先通过精准订阅该设备的专属上报频道，直观观察其运行反馈：

1. 打开 PC 控制台【设备管理】-> 点击目标设备详情。
2. 找到并复制该设备的专属【发布主题】： /{tenantId}/{userId}/MFCB-2PL-63/{deviceId}/pub *(例如：/tenant01/user0088/MFCB-2PL-63/a0b1c2d3e4f5/pub)*
3. 在 MQTTX 中点击【+ New Subscription】：
   • Topic：粘贴上述设备的【发布主题】
   • QoS：选择 0
4. 点击【Confirm】确认。此时 MQTTX 已精准锁定该断路器的回显频道。

步骤 3：向该设备发布控制指令（Sub）

向已锁定的目标断路器（例如 MAC 为 a0b1c2d3e4f5）下发合闸指令：

1. 从控制台复制该设备的专属【订阅主题】： /{tenantId}/{userId}/MFCB-2PL-63/a0b1c2d3e4f5/sub
2. 在 MQTTX 下方的发布区域填写：
   • Topic：填入设备的【订阅主题】
   • Payload (JSON 格式)：

     {
       "messageId": "mqttx-test-001",
       "cmd": "switch.control",
       "data": {
         "key": 1
       }
     }

1. 点击右下角的【发送】箭头（或快捷键发送）。

步骤 4：验证物理动作与报文双向闭环

下发成功后，可即时验证以下物理与通信现象：

1. 物理断路器动作：断路器内部电机动作推起机械手柄至合闸位，面板合闸绿色指示灯（🟢）点亮。
2. 接收指令直接应答（Reply）：MQTTX 订阅窗口将立即回显设备的直接应答报文（确认操作已执行）：

   {
     "messageId": "mqttx-test-001",
     "deviceId": "a0b1c2d3e4f5",
     "cmd": "switch.control",
     "ok": true,
     "err": "",
     "data": {
       "key": 1
     }
   }

1. 接收状态变更主动上报（Event Report）：随后断路器会主动发出一包运行状态变更广播：

   {
     "messageId": "evt-1725257000000-001",
     "deviceId": "a0b1c2d3e4f5",
     "cmd": "device.report",
     "ts": 1725257000000,
     "cause": "remote",
     "source": "remote",
     "data": {
       "key": 1,
       "fault": 0
     }
   }

💡 调试提示：若需要调试单相电能读取，只需将 Payload 改为 {"messageId":"req-002","cmd":"energy.info"} 发送至同一 Sub 主题即可，其他高级指令请直接查阅《01_开发指令.md》。

步骤 5：通用进阶方案 —— 利用通配符（+）批量监听名下所有设备

在理解了单设备的精准订阅与发布闭环后，当项目现场或测试环境接入了多台断路器时，如果每台设备都单独复制 MAC 并创建一条订阅规则，操作将极为繁琐。此时可采用更通用的 单层通配符（+） 方式：

1. MQTT 通配符语法原理： MQTT 规范支持使用 + 作为单层主题占位符。只要把具体设备 MAC 替换为 +，即可匹配该层级的任意字符。
   • 通配订阅主题：/{tenantId}/{userId}/MFCB-2PL-63/+/pub *(控制台【开发者参数】->【MQTT 接入参数】中已为您预生成了专属的【通配订阅】字符串，可直接复制)*
2. 在 MQTTX 中配置通配订阅：
   • 点击【+ New Subscription】：
     • Topic：填入带 + 号的通配订阅主题（例如 /tenant01/user0088/MFCB-2PL-63/+/pub）
     • QoS：选择 0
   • 点击【Confirm】确认。

1. 批量监听效果： 无论您名下绑定了 1 台还是 100 台断路器，只要其中任意一台设备产生动作应答、事件上报或告警推送，该通配订阅都能在同一个 MQTTX 窗口中即时打印呈现，极大提升了多设备联动与批量工程调试的效率！

自定义平台接入

💡 特点：完全脱离官方云，将断路器直连至企业自有私有云平台、私有部署的 MQTT Broker（如 EMQX、Mosquitto）、工业控制上位机或自建物联网平台（ThingsBoard、HomeAssistant 等）。

1. 设备后台配置私有通信参数（MQTT / TCP）

断路器在连接现场 Wi-Fi 后，可在局域网内直接访问设备管理后台（或长按 6 秒进入 AP 模式连接设备热点访问 http://192.168.4.1）：

1.1 自定义 MQTT 参数配置表

进入后台【自定义MQTT】配置页面：

📌 生效说明：填写保存并重启后，设备断电重启，设备将断开官方测试平台，转而长连接至您填写的私有 MQTT Broker。

1.2 自定义 TCP Client 参数配置表

进入后台【自定义TCP】配置页面：

• TCP 服务器 IP：填写接收断路器主动外连的工控机或服务器 IP（例如 192.168.1.100）。
• 监听端口：目标服务端 TCP 端口（例如 9999）。
• 心跳周期：默认推荐 60 秒。

2. 方案 A：私有自建 MQTT 接入与联调

若您使用的是自建私有 Broker（如本地局域网搭建的 EMQX 或 Mosquitto）：

1. 在断路器后台将【MQTT服务器】指向自建 Broker 的 IP（如 192.168.1.200），填入自建 Broker 的账号密码后重启断路器。
2. 打开 MQTTX，配置连接到您的私有 Broker。
3. 同样订阅断路器的 Pub 主题 /{tenantId}/{userId}/MFCB-2PL-63/${MAC}/pub，并向 Sub 主题发布控制 JSON 指令，即可完成私有协议链路的闭环验证。

3. 方案 B：工控 TCP Client 接入与工具联调（NetAssist）

适用于工业物联网现场采用工控机、边缘网关或 PLC 作为 TCP Server 的架构。

步骤 1：电脑端开启 TCP Server 监听

1. 打开 NetAssist 网络调试助手。
2. 【协议类型】选择 TCP Server。
3. 【本地主机地址】选择本机局域网 IP（例如 192.168.0.142）。
4. 【本地端口号】输入监听端口（例如 9999）。
5. 点击【打开】，启动服务端监听。

步骤 2：断路器主动发起 Socket 连接

1. 断路器后台配置好目标 IP（192.168.1.100）与端口（9000）并重启。
2. 观察 NetAssist 左侧【连接对象】列表中出现断路器的 IP 与端口条目，表明 TCP Socket 建立成功。

步骤 3：双向指令透传测试

1. 选中该连接条目，在发送区输入 UTF-8 文本格式的控制 JSON：

   {"messageId":"tcp-001","cmd":"switch.control","data":{"key":1}}

1. 点击【发送】，断路器机构执行动作，NetAssist 接收区瞬间回显设备的应答报文。

4. 自定义接入报文交互规范要点

在开发自建平台服务时，请严格遵守《01_开发指令.md》中定义的通信规则：

1. 点分式动宾结构：指令名称采用 switch.control、energy.info、device.leaktest 等格式。
2. 消息 ID 透传：平台下发的 messageId 必须在设备应答中原样回传，用于异步 RPC 的请求-应答匹配。
3. 故障保护屏蔽机制：当断路器因过载/短路/漏电触发跳闸时，fault != 0，出于用电安全考量，此时任何合闸指令都会被拒绝并返回 denied。自建平台必须先确认现场故障排除，下发 device.reset 复位后方可恢复远程合闸控制。

调试常见问题排查

06运维工具

适用型号：MFCB-2PL-63

文档版本：V1.0

配套工具：木澜设备助手（微信小程序） / 木澜开发者控制台 (http://manage.move-lan.com)

1. 移动端运维：木澜设备助手小程序

“木澜设备助手”微信小程序是专门面向电气工程人员、物业巡检人员与现场调试开发者打造的轻量级移动运维工具。无需随身携带笔记本电脑，使用手机即可完成现场扫码绑机、合分闸控制、单相能耗实时巡检、保护跳闸告警排查与漏电自检。

1.1 工具简介与进入方式

您可以通过以下两种方式秒级打开小程序：

1. 微信搜索：打开手机微信，在上方搜索框输入 “木澜设备助手”，点击小程序进入。
2. 扫码进入：使用微信“扫一扫”扫描随设备包装盒附赠的「木澜设备助手」小程序码卡片进入。

📱 小程序码获取：二维码卡片随设备包装提供；如需电子版，请联系技术支持索取（本页暂不展示图片）。

1.2 账号登录与资产同步

• 打开小程序后，使用已在木澜开发者控制台（http://manage.move-lan.com）注册的账号和密码登录。
• 小程序与 PC 端控制台采用统一账号权限体系，登录后自动同步您名下的所有配电项目、网格分组及设备列表，实现移动端与 PC 端无缝联动。

1.3 设备扫码绑定与配网关联

1. 扫描绑定设备：
   • 登录进入小程序主界面，点击右上角【+ 添加设备】。
   • 对准断路器正面的设备二维码或机身铭牌扫描，亦可手动输入 12 位 MAC 地址（例如 a0b1c2d3e4f5），点击【确认绑定】。
2. 联网状态检查：
   • 绑定成功后，小程序将即时检测设备的通信状态。
   • > 📌 重要提示：若设备当前未配置 Wi-Fi 呈现离线状态，请先参考 04_设备配网 完成 Wi-Fi 配网，确认红灯熄灭后再进行线上调试。

1.4 状态监控与现场快捷运维

当断路器联网成功在小程序中显示为 在线（绿色） 时，可执行以下核心运维功能：

  +----------------------------------+
  |  MFCB-2PL-63 智能断路器          |
  |  当前状态: [已合闸 🟢]           |
  +----------------------------------+
  |  实时电气数据 (单相):             |
  |  L: 226.5V   18.2A   4131W       |
  |  总累计电量: 1285.64 kWh         |
  |  内部温度: 41.5℃  信号: -52 dBm  |
  +----------------------------------+
  | [分闸切断]  [远程合闸]  [漏保自检]|
  +----------------------------------+

1. 实时电气监控：
   • 实时查看单相实时电压 (V)、负荷电流 (A)、有功功率 (W) 以及累计总用电量 (kWh)。
   • 监控断路器机壳内部温度与 Wi-Fi 信号强度。
2. 快捷动作下发：
   • 分合闸控制：点击按钮远程分闸或合闸，实时接收执行状态回显。
   • 漏保模拟自检：在合闸状态下一键触发 device.leaktest，测试漏电脱扣功能是否正常，自检完毕后再次点击合闸恢复供电。
   • 远程重启：遇到临时网络波动时，可下发重启指令进行微控制器复位。
3. 故障告警与故障位分析：
   • 当设备发生保护跳闸时，小程序将即刻弹出高亮告警提示，详细解析 17 位 fault 故障掩码（如“漏电跳闸，当前漏电电流 36mA”、“过载跳闸，有功功率 11.8kW”等），极大缩减现场排查时间。

2. PC端运维：MosFlash开发者控制台

在需要处理大规模配电网络、复杂能源报表或批量维护任务时，推荐使用电脑端控制台：

• 控制台地址：http://manage.move-lan.com
• 主要运维能力：
  • 批量台账管理：支持通过 Excel 批量导入成百上千台断路器 MAC，按园区、楼栋、配电房层级划分管理。
  • 远程批量 OTA 升级：选中断路器批次，一键下发最新固件包下载 URL，监控升级进度，升级失败自动回滚，保障供电稳定。
  • 历史能耗与负荷曲线导出：支持分钟级、小时级与日级用电数据曲线查询，一键导出 CSV 报表。
  • Webhook 告警推送：支持将保护跳闸事件即时推送到企业微信机器人、钉钉或企业私有工单系统。

3. 常见运维问题排查 (FAQ)

07安装施工

适用型号：MFCB-2PL-63

文档版本：V1.0

接线指引与施工强调（第一步）

1. 施工安全与天线安装特别强调

⚠️ 特别强调（施工前必读）：

请按照下图指引连接火线、零线。本产品安装过程涉及强电，需由专业人员依照电工规范进行安装调试，强电产品，务必注意安全。

请务必安装天线，否则会影响设备通信信号。

2. 接线示意图

智能断路器遵循国际标准 “上进线、下出线” 施工准则。严禁倒接或反接！

🔌 接线安装指引图：

3. 端子引脚定义与接线规范

导轨安装与固定步骤

1. 安装环境与要求

1. 供电环境：适用于标准单相两线制交流供电系统，额定电压 AC 220V（50Hz）。
2. 温湿度要求：工作环境温度为 -25℃ ~ +65℃，相对湿度 5% ~ 95% RH（无凝露）。
3. 防护与环境：设备应安装在防尘、防滴水、通风良好的户内配电箱/配电柜内（配电箱外壳防护等级建议达到 IP54 以上）。
4. 介质要求：安装位置应避免剧烈机械振动、强磁场直接干扰，严禁安装在含有易燃易爆气体、导电尘埃或强腐蚀性化学气体的场所。

2. 35mm DIN 导轨卡装步骤

本产品采用标准的 35mm DIN 导轨卡装式 固定结构，安装极为便捷：

1. 第一步（断电安全确认）：在施工作业前，必须断开上级总电源断路器，使用经校验合格的验电笔确认施工母线完全无电。
2. 第二步（开启导轨卡扣）：使用平头螺丝刀插入断路器底部的滑块卡扣孔，轻轻向下拉开导轨锁扣。
3. 第三步（挂入导轨）：将断路器顶部的固定卡槽倾斜挂入标准 35mm DIN 导轨的上沿。
4. 第四步（锁紧固定）：将断路器向导轨方向贴合按压，松开或向上推回底部卡扣，听到“咔哒”一声确认锁死。左右轻晃断路器，确认固定牢靠无松动。

施工安全与重要警告

🚨 1. 强电生命安全警示（220V）

本断路器接入电压为单相 220V 交流电，具有高压电击危险！必须由持有特种作业操作证（低压电工证）的专业电工进行施工。严禁带电作业，施工前必须切断上级配电母线并悬挂“禁止合闸、有人工作”警示牌。

⚠️ 2. 绝缘摇表测试必须断开断路器！

在工程施工验收进行电缆绝缘耐压测试或摇表（兆欧表 500V/1000V）检测时，严禁将摇表直接施加于连接在断路器上的线路！摇表产生的高压脉冲会瞬间击穿断路器内部的高精度计量采样芯片与 ESP8266 处理器。进行绝缘摇测前，必须将断路器的进出线全部拆除脱离。

📌 3. 漏电保护零线规范（严禁共用零线）

漏电保护模块通过内置高灵敏度零序互感器检测火线与零线电流矢量和（$I_L + I_N = 0$）。因此：

1. 下级负载回路的所有工作零线必须全部经由本断路器的 N 极引出，严禁与配电箱内其他断路器的零线并联或混用。

2. 严禁将下端零线直接接在保护地线 (PE) 或箱体外壳上，否则通电负荷一经启动，零序电流即刻失衡，断路器将频繁误跳闸并报 fault=8（漏电告警）。

💡 4. 金属配电箱无线信号引出建议

若将断路器安装在全金属封闭的动力配电柜中，厚重的金属柜体会形成法拉第笼效应，造成 Wi-Fi 信号极度衰减，引发离线或通信延迟。建议：

- 柜内安装无线 AP 延长天线，或选用木澜外置延长吸盘天线引出至配电柜外部。

技术支持与服务

如在现场安装接线、导轨布局或工程调试中遇到任何技术问题，欢迎联系木澜技术支持团队：

• 服务专线：18086531530
• 支持邮箱：support@move-lan.com
• 官方网址：http://move-lan.com（暂未上线，上线后启用）

08资料下载

适用型号：MFCB-2PL-63

文档版本：V1.0

更新日期：2026-11-03

关于本页资料

本页提供 智能断路器 220V 63A 漏保版（MFCB-2PL-63） 全套技术文档的 Markdown 源文件，供开发者、集成商与工程人员在线查阅、离线归档或随项目二次编排。

📌 当前交付状态（请先看这里）：

1. 在线阅读已全量开放：下方 9 篇文档均可直接点击在线阅读，内容与官网文档站保持一致，无需下载即可查阅。

2. Markdown 源文件打包下载正在整理：9 篇 .md 与配套 img/ 图片的整包 ZIP 尚未上架。本页不提供占位死链，如项目急需源文件，请通过文末技术支持渠道索取。

3. 固件、PDF 手册、选型彩页、CAD 图纸 暂不在此页提供下载，当前状态见「工程与产品资料（筹备中）」一节。

⚠️ 固件升级安全提示：

1. 下发固件升级前，请仔细核对机身铭牌上的产品规格型号为 MFCB-2PL-63（220V 单相两线 63A 漏保版），严禁将三相版本（4P / 4PL）或无漏保版本（2P）的固件刷入本设备，以免损坏驱动与检测逻辑。

2. 固件刷写过程中请保持配电箱输入供电稳定，严禁在烧录过程中强制拉闸断电。

技术文档 Markdown 全集

📄 *共 9 篇，均为 UTF-8 编码的 Markdown 源文件，图片统一以 ./img/ 相对路径引用。*

💡 阅读顺序建议：首次上手按 02 → 03 → 04 → 05；现场施工按 07 → 04 → 06；二次开发按 01 → 05 → 09。

整包下载与离线使用

离线使用时请注意以下三点，否则容易出现图片丢失或文档间跳转失效：

1. 编码：源文件为 UTF-8，请勿用系统记事本另存为 ANSI/GBK，以免中文乱码；推荐使用 VS Code、Typora 等 Markdown 编辑器打开。
2. 目录结构：文档内的图片与互链均为相对路径（./img/xxx.png、./0X_xxx.md）。解压或归档时请保持 *.md 与 img/ 处于同一级目录，且不要修改文件名。
3. 版本口径：全套 9 篇当前均为 V1.0，以官网文档站在线版本为最新；若本地副本与在线内容不一致，以在线版本为准。

开发者配套资料

📌 本页只提供本型号技术文档的下载与索引。全系通用协议基线涉及未发布型号与版本变更记录，不随本页公开发布；对接所需的指令格式以 01_开发指令 为准。

工程与产品资料（筹备中）

以下资料正在整理，暂不提供公开下载。为避免使用到未定稿版本，如需用于投标、图纸深化或成套柜排版，请直接联系技术支持获取对应版本。

⚠️ 固件不提供公开 .bin 下载：升级必须经控制台或指令下发，并严格核对型号（见本页开篇安全提示），避免跨型号误刷。

售后支持与制造信息

如需索取 Markdown 源文件整包、示例代码、工程图纸，或处理设备绑定、固件定制与工控接入问题，请通过以下渠道联系：

09恢复出厂

文档编号：DOC-MFCB-2PL-63-09

适用型号：MFCB-2PL-63

文档版本：V1.0

⚠️ 恢复出厂设置请谨慎操作（执行前必读）：

1. 不可撤销：恢复出厂会清除设备 Flash 内保存的全部用户配置 —— Wi-Fi 账号密码、MQTT/TCP 服务器参数、保护阈值整定值、本地按键锁与配网锁状态，清除后无法恢复，设备回到出厂待配网状态，必须重新配网才能联网。

2. 会立即断电：执行后断路器立即机械分闸切断供电，请确认下游负载允许断电、现场已做好安全告知后再操作。

3. 固件不受影响：恢复出厂不会回滚固件版本，已升级的固件程序保持不变。

4. 仅在必要时执行：仅用于 Wi-Fi 密码变更、MQTT/TCP 配置错误导致彻底离线，或设备转场 / 返修需要重新初始化。日常联网异常请优先排查配网与信号，不要直接恢复出厂。

恢复出厂后，设备将复位至以下出厂默认状态：

- 网络状态：清除所有已保存的 Wi-Fi 与通信配置，自动释放 MosFlash_XXXXXX 待配网热点（管理后台 http://192.168.4.1，密码 mf12345678）；

- 连接平台：默认自动恢复直连官方开发者测试平台；

- 机构与开关：执行机构安全分闸切断（key = 0），解除本地按键锁与配网锁，清除保护跳闸锁定状态；

- 保护阈值：各项电气保护参数（过流、过压、欠压、漏电保护、过载、板载过温等）全部恢复为出厂标准安全阈值。

确认仍需执行后，可按下列 3 种方式之一操作。

方式一：设备配置页面重置

当设备断网、离线或无法通过网络访问时，推荐使用此方式在设备端本地进行恢复：

1. 按键长按 6 秒进入配网热点模式

断路器正面面板配备微动按键（蓝色按键）：

1. 在断路器正常通电状态下，用手指或细绝缘针长按蓝色按键保持 6 秒；
2. 观察正面面板 🔴 红色指示灯，当红灯进入慢速呼吸闪烁状态（周期约 1 秒）时松开按键，表明设备已成功开启 AP 配置热点。

2. 连接热点并进入配置后台

1. 打开手机或笔记本电脑的 Wi-Fi 设置，搜索并连接热点 MosFlash_XXXXXX（后 6 位为设备 MAC 尾缀）；
2. 输入默认连接密码：mf12345678 并确认连接；
3. 打开浏览器，访问设备后台管理地址：http://192.168.4.1，输入登录密码 mf12345678。

3. 在【状态】页面点击【恢复出厂】

1. 进入管理后台后，默认处于顶部的 【状态】 标签页（或点击左上角【状态】Tab）；
2. 页面中完整显示了当前设备的 Wi-Fi、MQTT、TCP 配置以及固件版本、MAC 地址等系统参数；
3. 滑动至页面最底部，点击粉红色的 【恢复出厂】 按钮；
4. 在二次确认弹窗中确认后，设备立即清空配置、执行分闸并自动重启，红灯重新呈现呼吸闪烁，完成出厂重置。

方式二：MQTT 指令下发重置

适用于自建 MQTT Broker、ThingsBoard、HomeAssistant、私有云平台或使用 MQTTX 调试工具的开发者，通过标准 MQTT 协议向设备下发重置指令：

• 下发主题 (Topic)：自定义Topic，以实际设备订阅的Topic为准
• 下发 JSON 请求：

{
  "messageId": "202610191200001004",
  "cmd": "device.reset"
}

方式三：TCP 指令下发重置

适用于断路器通过 TCP Client 模式主动连接至局域网工控机、边缘网关或自建私有 TCP Server（Socket 通信通道）：

1. 通信链路与传输规范

• 断路器作为 TCP Client，与服务端建立长连接后，使用与 MQTT 一致的纯文本 UTF-8 JSON 格式收发指令；
• 数据交互遵循相同的信封规范，发送与接收均为点分式 JSON 报文。

2. TCP 服务端下发数据包

服务端向已建立连接的设备 TCP Socket 链路直接写入 JSON 文本报文：

{
  "messageId": "202610191200001005",
  "cmd": "device.reset"
}

📌 TCP 链路动作说明：

设备在发出 ok: true 的应答报文后，会主动断开当前 TCP Socket 连接，执行机构机械分闸切断，并重启恢复出厂状态。