Acrel_CloudPlatform (mqtt-json) Protocol

This protocol uses MQTT and JSON format.

upload：gateway to platform
download：platform to gateway
tab 1：
Commend cmd
1 Upload Login login
2 Upload/Download Parameters para
3 Upload Heart heart
4 Upload data data
5 Upload Alarm alarm

rule 1：
After the gateway connects to the server, the following topics will be subscribed. The
platform can publish data for data distribution on this topic.

topic: /server/acrelHW/product/cmd/SN
stage 1：who send, server-platform、gw-gateway、meter-meter device
stage 2：name of company
stage 3：name of product
stage 4：command
stage 5：SN - only serial of product
e.g.1：The platform sends parameters to the gateway with serial number 01234567890123
topic：/server/acrelHW/null/para/01234567890123

rule 2：
When the gateway uploads data, it will publish to the following topic, and the platform
subscribes to this topic to receive data.

topic: /gw/acrelHW/product/ cmd/SN

e.g.2：gateway 01234567890123 upload date
topic：/gw/acrelHW/null/data/01234567890123

1 login /gw/acrelHW/null/login/SN
After the device is connected to the server, a login frame is immediately sent to
indicate that the device is online.
upload:
 {"type":"login","gwSN":"01234567890123","time":"20200709130030","ver":"10
00","ccid":"00112233445566778899"}
download：
{"type":"login","res":1}

type: type of date

gwSN: SN of gateway
time: realtime
ver: app version
ccid: SIM card number
res: respond 1-success 0-fail

2 Parameter upload /gw/acrelHW/null/para/SN

It will be sent just after connection to refresh the parameter setting value. If the
instrument is directly transmitted, only one will be sent; if the gateway has multiple
instruments, one instrument will be sent.
upload：
{"type":"para","gwSN":"01234567890123","meterSN":"01234567890123","meterNa
me":"arcm300","time":"20200709130030","upInterval":"5"}
download：{"type":"para","res":1}

meterSN:MeterID
meterName:MeterName
upInterval：up interval (minute unit)

3 Parameter download /server/acrelHW/null/para/SN

The platform issues parameters to the device, and the device performs
corresponding operations according to the issued parameters. See appendix 3 for
specific parameters.
Download：
{"type":"para","gwSN":"01234567890123","meterSN":"01234567890123","time
":"20200710173000","ipAdd":"www.acrel.com","port":1883,"fwAdd":"
http://12345678.com "}
Upload：{"type":"para","res":1}

4 heart /gw/acrelHW/null/heart/SN
Upload according to the set heartbeat interval
 upload：
{"type":"heart","gateSn":"01234567890123","time":"20200709130030"}
download：{"type":"heart","res":1}（platform can no respond）

5 data up /gw/acrelHW/null/data/SN
See Appendix 1 for uploaded data items.
upload：
{"type":"data","gwSN":"01234567890123","time":"20200709130030","meterSN":"0
1234567890123","ua":220.1,"ub":0.000,"uc":0.000,"ia":0.050,"ib":0.040,"ic":0.040,"i
n":0.080,"pa":0.000,"pb":0.000,"pc":0.000,"p":0.000,"qa":0.000,"qb":0.000,"qc":0.0
00,"q":0.000,"pf":1.000,"wh":20.670,"wl":20.670,"varh":2.770,"varl":2.770,"ta":20.6,
"tb":21.6,"tc":22.6}
download：{"type":"data","res":1}

6 alarm up /gw/acrelHW/null/alarm/SN
See Appendix 2 for uploaded alarm items.
upload：
{"type":"alarm","gwSN":"01234567890123","time":"20200709130030","meterSN":"
01234567890123","voltageOver":400,"currentOver":80}

download：{"type":"alarm","res":1}
appendix 1：data
Unit Type
ua V float
ub V float
uc V float
ub V float
ia I float
ib I float
ic I float
in I float
pa KW float
pb KW float
pc KW float
p KW float
qa KW float
qb KW float
qc KW float
q KW float
pfa float
pfb float
pfc float
pf float
wh KWH float
wl KWH float
varh KWH float
varl KWH float

appendix 2：alarm
unit type
vOver V float
vUnder V float
iOver V float
appendix 3：para
unit type
upInterval minute int
ver int
ipAdd string
fwAdd string