Tuya-Local项目：STB3L-125/WJ智能断路器设备支持详解

设备概述

STB3L-125/WJ是一款三相智能断路器设备，由SMTONOFF公司生产。该设备通过Wi-Fi连接，支持远程监控和控制，具备电能计量、故障检测、预付费管理等多种功能。作为一款工业级智能断路器，它特别适合需要远程监控和电能管理的应用场景。

核心功能特性

电能计量功能

1. 总电能计量：设备可精确测量正向总有功电量，计量范围为0-999999.99kWh，分辨率为0.01kWh
2. 分相计量：支持A、B、C三相独立计量，可测量各相电压、电流和功率
   • 电压测量精度：0.1V
   • 电流测量精度：0.001A
   • 功率测量精度：0.0001kW
3. 数据上报机制：在Wi-Fi模式下每15秒上报一次数据，NB-IoT模式下每小时上报一次

安全保护功能

1. 多重故障检测：支持17种故障类型检测，包括：
   • 短路报警
   • 浪涌报警
   • 过载报警
   • 漏电流报警
   • 温度异常报警等
2. 剩余电流检测：实时监测漏电流，范围0-1000mA
3. 远程控制：支持通过云端远程开关断路器

预付费管理

1. 电量充值：支持远程电量充值功能
2. 剩余电量显示：实时显示剩余可用电量
3. 电量清零：管理员可远程清零电量数据

技术实现细节

通信协议

设备采用自定义二进制协议进行数据传输，主要特点包括：

1. 大端模式：所有数据采用大端字节序
2. HEX格式：多数参数以十六进制格式传输
3. 变长报文：根据功能不同，报文长度从4字节到128字节不等

告警处理机制

1. 告警阈值设置：支持通过两个独立的告警设置寄存器配置17种告警的阈值和动作
2. 告警上报：采用位图方式上报，每个位代表一种告警状态
3. 自动动作：可配置为仅告警或自动跳闸

设备识别

1. 唯一设备号：每个设备具有唯一识别字符串
2. 上报机制：配网时主动上报三次设备号，确保识别成功

应用场景建议

1. 工业用电监控：适合工厂、车间等三相用电场所
2. 智能楼宇：可用于商业楼宇的电力管理系统
3. 预付费电表：支持预付费模式的电力供应场景
4. 安全监控：需要实时监测电气安全的场所

开发注意事项

1. 数据处理：需特别注意大端模式的字节序处理
2. 精度转换：原始数据需要根据定义的scale值进行转换
3. 告警解析：故障字段采用位图方式，需要逐位解析
4. 通信频率：在Wi-Fi模式下数据更新频率较高，需考虑服务器负载

该设备的加入丰富了Tuya-Local项目在工业电力监控领域的支持能力，为开发者提供了更多物联网电力监控的解决方案选择。