ADW300 4G MQTT协议

ADW300 4G第三方平台对接文档

一、 协议内容说明 1

二、 电表配置说明 1

三、 数据通讯报文及格式 4

四、 常见故障分析 6

# 一 协议内容说明

ADW300-4G的通讯协议是基于TCP链路层协议，应用层采用MQTT协议，具体的应用协议格式内容Topic（订阅和发布）可通过软件自定义（**长度小于60字符**），参考如下：

Topic ：/<目标对象>/<厂商标识>/<设备类型>/<协议类型>/<设备ID>

/gw/acrelHW/ADW300/data/20240327880009

# 二 电表配置说明

1. 打开调试软件

![](/media/202407//1720167712.6465456.png)

1. 开启时如果提示COMX开启成功，点击“广播读ADW300地址”，显示版本号获取成功后右侧设置见面可视。

![](/media/202407//1720167712.6496148.png)

1. 开启时如果提示COMX开启失败，确认串口是否被占用，点击左上角设置，查看可用串口并选择对应串口。

![](/media/202407//1720167712.6525486.png)

1. 进入“环保参数设置1”界面设置IP，端口 以及上传时间，可选择以IP或者域名两种形式，**设置前请务必先读取一下**。具体配置如下图所示：

![](/media/202407//1720167712.6553082.png)

1. 找到通用MQTT该界面设置MQTT相关参数，同样设置前先读取一下，mqtt-theme1代表下发主题，mqtt-theme2代表上报主题。

MQTT username:MQTT服务器的登录用户名

MQTT password:MQTT服务器的登录密码

MQTT theme\_1:平台下主题（默认是不具备改功能，该项需要提前与研发沟通协商定制）

MQTT theme\_2:设备上报数据主题（平台可通过订阅该主题接收设备设备上报的实时数据）

![](/media/202407//1720167712.658746.png)

注：MQTT QOS默认设置“1”，与服务器端保持一致

**初次样机测试完成之后可以通过订单备注出厂默认指定配置项**

# 三 数据通讯报文及格式

1）通过勾选“串口打印”功能实时查看电表当前状态

![](/media/202407//1720167712.6616077.png)

2）报文举例：

发布主题:/gw/acrelHW/ADW300/data/20240327880009

发布到主题:/gw/acrelHW/ADW300/data/20240327880009

第一包：

{"data":[{"tp":1711510593531,"point":[{"id":0,"val":"20240327880009"},{"id":1,"val":0},{"id":2,"val":0},{"id":3,"val":0},{"id":4,"val":0},{"id":5,"val":0},{"id":6,"val":0},{"id":7,"val":0},{"id":8,"val":0},{"id":9,"val":0},{"id":10,"val":0},{"id":11,"val":0},{"id":12,"val":0},{"id":13,"val":0},{"id":14,"val":0},{"id":15,"val":0},{"id":16,"val":0},{"id":17,"val":0},{"id":18,"val":0},{"id":19,"val":0},{"id":20,"val":0},{"id":21,"val":0},{"id":22,"val":1},{"id":23,"val":1},{"id":24,"val":1},{"id":25,"val":1},{"id":26,"val":0},{"id":27,"val":27},{"id":28,"val":3.03},{"id":29,"val":0},{"id":30,"val":0.12},{"id":31,"val":0.02},{"id":32,"val":0},{"id":33,"val":"898604B0262270350991"},{"id":34,"val":1},{"id":35,"val":1}]}]}

第二包：

/gw/acrelHW/ADW300/data/20240327880009

{"data":[{"tp":1711510593531,"point":[{"id":0,"val":"20240327880009"},{"id":36,"val":0},{"id":37,"val":0},{"id":38,"val":0},{"id":39,"val":0},{"id":40,"val":0},{"id":41,"val":0},{"id":42,"val":0.64},{"id":43,"val":0},{"id":44,"val":0.04},{"id":45,"val":0},{"id":46,"val":1.04},{"id":47,"val":0},{"id":48,"val":0.03},{"id":49,"val":0},{"id":50,"val":1.16},{"id":51,"val":0},{"id":52,"val":0.02},{"id":53,"val":0},{"id":54,"val":0},{"id":55,"val":0},{"id":56,"val":0},{"id":57,"val":0},{"id":58,"val":0},{"id":59,"val":0},{"id":60,"val":0},{"id":61,"val":0},{"id":62,"val":0},{"id":63,"val":0},{"id":64,"val":0},{"id":65,"val":0.42},{"id":66,"val":0.22},{"id":67,"val":1.8},{"id":68,"val":0.57},{"id":69,"val":0},{"id":70,"val":0},{"id":71,"val":0},{"id":72,"val":0}]}]}

注：“tp”为数据报文时间戳单位ms，如第一包时间“1711510593531”

![](/media/202407//1720167712.6646864.png)

1. 数据内容及数据类型

![图片1](/media/202407//1720167712.6686165.png)

![图片2](/media/202407//1720167712.670896.png)

# 四 常见故障分析

![1711538243963](/media/202407//1720167712.673404.png)

1. 当电表正常连接服务器时，按左起第二个按键，显示”STATE 8”表示电表正常；
2. 当带电表显示非正常状态时，无法连接服务器，可以排查一下物联网卡的问题；

①可能是卡没有流量

②卡拔插之后会锁卡，导致用不了（联系运营商解绑）

③物联网卡没有绑定远程调试服务的域名，使用定向流量卡、物联网卡时需要联系卡商或运营商添加 “白名单”增加绑定域名和IP地址（safe.acrelcloud.cn，device.acrelcloud.cn） ，其中一个是远程调试 服务 ，另一个是远程升级服务!

1. 服务器端口是否正常打开
2. 通过MQTT客户端连接测试服务器