Free and Unrestricted Meter Data:
EKM Metering not only wants to provide great metering products that are reliable, accurate, and affordable, but we also want to be completely open about how you choose to access, utilize, and display your meter data. One of the reasons that we choose not to charge for meter data, is because we want to make our products as attractive as possible for developers and businesses. We believe that we offer the perfect metering system for developers to build a business around. This page is a good jumping off point for anyone who wants to develop their own apps or software solutions utilizing our products. You can choose to utilize data from the EKM Push system (easier to implement and more scalable) or access the meter data directly from the serial RS485 port on the meter itself.
EKM Push Open Energy API:
Now you can very easily access the EKM Push Data using the EKM Dash software. All you need is your EKM Push User Key and your Omnimeter number. You can use the dash to then create emails, generate .csv files, and store an unlimited number of meter reads in your local EKM Dash database. We have attempted to make the EKM Push system as scalable as possible. You can have from one to hundreds of thousands of meters in your EKM Push account. These could be meters that are spread all over the world on any number of EKM Push gateways, feeding data to this known, fixed location for super easy access. This is the most open, most scalable, most reliable, easiest to access meter data solution in the industry, and it is FREE.
Check out the Push App Store for examples of solutions that utilize EKM Push data: Push App Store
For examples of the EKM-Push's capabilities you can look at our widget here: Widget for EKM-Omnimeter 10068
Or this older widget: http://ekmpush.com/documents/ekm3/ (It doesn't work in Internet Explorer 8)
For more detailed live reads from around the world you can see them here:
A good meter to check out; EKM-Omnimeter #: 10068
Sample Group ID: 1010
Password is: 2020
Sample User Key is: MTAxMDoyMDIw
Firefox works well for viewing.
These are rudimentary graphs meant to convey the abilities of this new system.
You can change the number of reads to 360 or 720 to see more history
Or this .xml web data dump (best viewed with Firefox):
Or in Linux command line or Mac OSX Terminal (by default, you can retrieve from 1 to 1000 reads, this request is for 300 meter reads):
Create your own request:
curl http://io.ekmpush.com/**your Omnimeter Number here**~**number of reads requested**.xml?**your User Key here**
Create a solution using EKM Push data that we think our users will find useful and we will promote it for you on our EKM Push page. This could be a web app, mobile app, data analytics, billing solutions, BMS, or anything else you come up with.
Advanced API requests:
Find all meters and Read Rates in associated with EKM Push Key MTAxMDoyMDIw:
Request all meter data (up to 1000 reads) since Seq 1407875379561 from meter 10054:
(the seq number should be updated for each request to the seq from the latest read received)
Request data from multiple meters (10 reads from meter 10068 and 1 read from meter 10054):
EKM Push Spec Sheet: EKM Push Specs
EKM Push Schema: EKM Push .xml Data Parameters
EKM Push Sample Data: Data returned by Linux curl command
EKM Push to EKM Dash Setup: Setup Instructions
Push data to wattvision.com: Setting Up EKM Push to wattvision
EKM Push data to PVoutput.org: Omnimeter v.3 Pushed to PVoutput.org
EKM Push data to Excel (on a PC) Interface real-time data to Excel
Here is our widget displaying live Omnimeter data, using an EKM Push gateway:
To see the full version of this widget go here: Widget for EKM-Omnimeter: #10068
EKM Meter Serial RS-485 Communications:
This section is for developers that want to communicate with their EKM Meters directly using their own software or embedded solution.
Our meters use an IEC 62056-21 communication standard that has been optimized for our own needs. We are more than happy to share this with you. With this you can write your own software or embedded solution to access your meter data.
EKM-Omnimeter I v.3 and EKM-Omnimeter II v.3 UL:
EKM-Omnimeter Pulse v.4:
Here are the links to download the string parsing v.4 String Parsing, as well as the v.4 Settings Protocol for our EKM Omnimeter Pulse v.4. Here is an additional supplemental v.4 Parsing Example Document
General RS-485 Hex Parsing:
Send any of your meters on your RS-485 network the simple request (including the 12 digit meter number) and the targeted meter will respond with most of its data. If you use our EKM Dash software and utilize the "Hex Inspector" functionality under the "Help" menu item, it will simplify your job to be able to "see" the request and response (this is helpful for both the RS-485 parsing as well as parsing the EKM Push .xml data). The last 2 bytes of the RS-485 return string are a CRC-16 checksum. 30 represents a 0, 31 represents a 1, 32 represents a 2, etc.
Serial Settings for v.3 and v.4 meters: 9600 baud, 7 data bits, Even Parity, 1 Stop Bit, No Flow Control
Always send the "Close String" at the end of the transaction. This tells the meter that the communication session is over. Send: 01 42 30 03 75
Please either email us at firstname.lastname@example.org or join the discussion on Developers Section of our user User Forum.