The "hidden" features in the firmware of the Wi-Fi energy meter
Because of the continued upgrading of the firmware, new features often appear in the latest firmware, this article is used to list all the features that have been supported by the firmware(will be updated continuously).
How to get the latest firmware
We will release the latest firmware version here.
Select the run mode of the energy meter
There are three run mode selections.
- Cloud: use the energy meter together with IAMMETER-cloud, this is the default mode.
- TCP: upload data to third-party server by TCP,TLS or MQTT.
- HTTP: upload data to third-party server by HTTP or HTTPS.
T
Cloud
This is the default mode. It will upload data to IAMMETER-cloud. Then you can monitor the energy data by the IAMMETER cloud, the effect is like this: visit the IAMMETER-cloud by the demo account
Please note: there would be the different effects when you click the demo link in the browser of desktop mode(web system effect) or phone mode(app effect)
TCP,TLS and MQTT
TCP && TLS
Please refer to https://www.iammeter.com/docs/integrate-with-thirdparty-server
Video: Upload the energy monitor data to a third-party server
MQTT
Please refer to https://www.iammeter.com/docs/integrate-with-mqtt-server
HTTP or HTTPS
- The data format of the http/https post is the same as tcp/mqtt/tls mode.
- you can use different port to do the http post.
- if you use the port of 443, the energy meter would do the https post (only support https in port 443)
For more details ,please refer to Upload data to 3rd party server by http/https
Local API
/api/monitorjson: return the measurement result
Return all measurement results of the Wi-Fi energy meter in Datas field.
The Datas contains such parameters below (if it is 3 phase energy meter,it will return all three phase readings)
Voltage, current,active power,forward kWh ,reverse kWh,frequency,power factor.
Besides the measurement results, it also returns the SN, mac, and the firmware Version.
{"method":"uploadsn","mac":"B0F8933C4F94","version":"i.75.97.9","server":"em","SN":"3E0BAF87","Datas":[[220.0,9.99,2198,11.337,11.201,49.99,1.00],[222.5,9.99,1100,11.039,10.908,49.99,0.50],[263.5,9.99,1213,10.975,10.846,49.99,0.55]]}
With the measurement of reactive power and reactive energy Utilize a Three-Phase Energy Meter to Measure KVAR and KVARH
/api/monitor: Advanced version of "monitorjson"
Add two more JOSN fields. SSID: connected AP name. Sig: signal strength of the connected AP.
{"ssid":"CMCC-laohe","sig":100,"mac":"B0F8933C4F94","version":"i.75.97.9","server":"em","SN":"3E0BAF87","Datas":[[220.0,9.99,2198,11.337,11.201,49.99,1.00],[222.5,9.99,1100,11.039,10.908,49.99,0.50],[263.5,9.99,1213,10.975,10.846,49.99,0.55]]}
/api/wifidata: return the Wi-Fi network configuration
{"version":"i.75.97.9","SN":"3E0BAF87","mac":"B0F8933C4F94","type":"PM","ssid":"CMCC-laohe","ip":"192.168.11.62","netmask":"255.255.255.0","gw":"192.168.11.253","dns":"114.114.114.114","dhcp":1,"runMode":"cloud","netmeter":0,"uploadinterval":60}
/api/uploadinterval?x=value: set the upload interval value
http://ip/api/uploadinterval?x=value
Set the upload interval in seconds. Please notes ,the upload interval of the cloud mode is fixed in 1 min. This interval only work after you have set the the energy meter to upload the data to third-party server (by tcp, tls,http or mqtt).
/api/mqtt: Set the username and password of MQTT
please refer to https://www.iammeter.com/docs/integrate-with-mqtt-server#22--set-the-username-and-password-of-mqtt
/api/netmetring : the net metering mode of the energy meter
Please refer to How to use the net energy metering mode in the Wi-Fi Energy meter
/api/ctcratio
You want to monitor a balanced output with two high legs and one neutral line, but there is only phase C left now (Phase A and phase B are already used to monitor the grid of 120/240V or 120/208V).
This parameter of "CTCratio" will help you solve this problem. If it is set to '2', the energy meter`s reading of current, active power reading, and Kwh will be doubled in phase C.
1 | /api/ctcratio | inquiry the reading of ctcratio |
---|---|---|
2 | /api/ctcratio?x=2 | set the CTCratio to 2 |
3 | /api/ctcratio?x=1 | set the CTCratio to 1 |
For more retails ,please refer to set CTCratio to '2', double the balanced solar output in the system of 120/240V or 120/208V
/api/reactive
Reactive parameters includes both Q(KVAR) and KVARh of the three phase.
Q(Kvar): reactive power, positive value means inductive, negative value means capacitive
KVARh: reactive energy, each phase contains two KVARh, KVARh for inductive load and KVARh for capacitor load.
For more details ,please refer to https://www.iammeter.com/newsshow/wem3080tr
/api/reactive?x=1
turn on the measurement of the reactive measurement
/api/reactive?x=0
turn off the measurement of the reactive measurement
JSON interpretation
Regardless of whether the meter is set up to upload data to a third-party server (using HTTP/HTTPS, TCP/TLS, MQTT) or to retrieve data through a local API, the JSON format remains consistent across all methods.
Interpreting the JSON Data from IAMMETER Products: JSON Data Definition of IAMMETER`s product
Modbus/TCP
This is a big upgrade of the firmware ,so we list it independently here.
Support Modbus/TCP in the Wi-Fi energy meter of IAMMETER
request the energy data from the Modbus/TCP in the home assistant
What is more
Video tutorial about IAMMETER` energy meter and system
IAMMETER`s Wi-Fi energy meter in the Home assistant
Develop your own energy monitoring system with IAMMETE products
Monitor your solar pv system by a 3 phase energy meter Wi-Fi