{"id":21998330,"url":"https://github.com/simonswine/easymeter_mon","last_synced_at":"2026-05-02T05:34:19.231Z","repository":{"id":20900704,"uuid":"24188268","full_name":"simonswine/easymeter_mon","owner":"simonswine","description":"EasyMeter Q3CA (smart meter) monitor","archived":false,"fork":false,"pushed_at":"2014-09-18T14:44:09.000Z","size":336,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-12T20:22:23.157Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simonswine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-09-18T13:00:55.000Z","updated_at":"2016-01-23T08:57:46.000Z","dependencies_parsed_at":"2022-08-17T16:05:33.935Z","dependency_job_id":null,"html_url":"https://github.com/simonswine/easymeter_mon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/simonswine/easymeter_mon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonswine%2Feasymeter_mon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonswine%2Feasymeter_mon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonswine%2Feasymeter_mon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonswine%2Feasymeter_mon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonswine","download_url":"https://codeload.github.com/simonswine/easymeter_mon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonswine%2Feasymeter_mon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259846304,"owners_count":22920898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T22:21:15.274Z","updated_at":"2026-05-02T05:34:19.188Z","avatar_url":"https://github.com/simonswine.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"easymeter_mon\n=============\n\nQuery EasyMeter Q3CA smart meters via IR and output in Zabbix Active Check format.\n\nThe protocol on the IR interface is [Smart Message Language (SML)](http://de.wikipedia.org/wiki/Smart_Message_Language). The messages contain the values in the [OBIS](http://de.wikipedia.org/wiki/OBIS-Kennzahlen) format.\n\n## Acknowledgements\n\nThis project basically just puts the building blocks togehter. Thanks to:\n\n* [libsml](https://github.com/dailab/libsml) for SML parsing\n* [vzlogger](http://www.volkszaehler.org/) for obis.c\n* [Sven Jordan](http://www.s-jordan.de/index.php?page=easymeter_raspberrypi) for IR reader electronics\n* [Zabbix](http://www.zabbix.com/) for the montioring software\n\n## Dependencies \n\n### Hardware\n\n* EasyMeter Q3CA smart meter for solar inverters\n* IR - UART Interface ([PNG](/misc/easymon_reader.png) / [SCHEME](/misc/easymon_reader.sch))\n\n### Software\n\n* Compilation\n  * CMake\n  * libsml (https://github.com/dailab/libsml)\n  * Essentials build utils (git, gcc, ...)\n* Data usage\n  * Zabbix\n\n## Compilation \u0026 Installation\n\n#### Example for Debian/Ubuntu based systems\n\n* Tested for \n * Debian Wheezy (7) on RaspberryPi\n * Ubuntu Precise (12.04) x64\n * Q3CA\n\n```bash\n# Install dependencies\napt-get install build-essential cmake uuid-dev uuid-runtime git debhelper\n\n# Compile \u0026 install libsml\ngit clone git://github.com/simonswine/libsml.git\ncd libsml\ndpkg-buildpackage -b\ncd ..\ndpkg -i libsml*deb\n\n# Compile \u0026 install easymeter_mon\ngit clone git://github.com/simonswine/easymeter_mon.git\ncd easymeter_mon\nmkdir build \ncd build \ncmake ..\nmake \nmake install\n```\n\n## Usage\n\n### Parameters\n\n| Parameter    | Default value | Description                     |\n|--------------|---------------|---------------------------------|\n| `-d \u003cdevice\u003e`|`/dev/ttyAMA0` |Specify serial device to query   |\n| `-h \u003chost\u003e`  |`powermon`     |Hostname for Zabbix output format|    \n\n### Query smart meter\n\n```bash\neasymeter_mon -z powermon -d /dev/ttyAMA0\npowermon power.counter-in 8208517.71\npowermon power.counter-out 6000398.39\npowermon power.counter-in-t1 8202860.00\npowermon power.counter-in-t2 1130.00\npowermon power.counter-in-t3 1100.00\npowermon power.counter-in-t4 1110.00\npowermon power.counter-in-t5 1100.00\npowermon power.counter-in-t6 1210.00\npowermon power.counter-out-t7 5999270.00\npowermon power.counter-out-t8 1120.00\npowermon power.power -1561.21\npowermon power.power-l1 -1815.88\npowermon power.power-l2 236.09\npowermon power.power-l3 18.58\n```\n\n### Send values to Zabbix\n\n* Setup a Zabbix host which is linked to this template [Zabbix Template](/misc/zabbix_template_powermon.xml)\n* Make sure this script is run on a periodic basis:\n```bash\neasymeter_mon -z \u003czabbix_host\u003e -d /dev/ttyAMA0 | zabbix_sender -i - -z \u003czabbix_server\u003e\n```\n\n### Example charts from Zabbix\n\n* Inverter production vs. consumption of energy\n![Image](/misc/production_vs_consumption.png)\n* Power per phase\n![Image](/misc/power_per_phase.png)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonswine%2Feasymeter_mon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonswine%2Feasymeter_mon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonswine%2Feasymeter_mon/lists"}