{"id":15176938,"url":"https://github.com/jollyjinx/sma2mqtt","last_synced_at":"2025-10-08T23:06:02.397Z","repository":{"id":54176514,"uuid":"341892295","full_name":"jollyjinx/sma2mqtt","owner":"jollyjinx","description":"sma2mqtt - autodiscover and publish SMA inverters and Sunny Home Manager to MQTT. Docker container provided.","archived":false,"fork":false,"pushed_at":"2025-04-02T05:38:40.000Z","size":1906,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-18T04:07:06.186Z","etag":null,"topics":["home-assistant","inverter","mqtt","netspot","node-red","sma","speedwire","sunny-home-manager"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jollyjinx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-24T12:24:34.000Z","updated_at":"2025-01-09T11:05:22.000Z","dependencies_parsed_at":"2025-03-31T16:46:47.323Z","dependency_job_id":"d261fb0d-9d5e-460c-a654-e9e242a223ef","html_url":"https://github.com/jollyjinx/sma2mqtt","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/jollyjinx/sma2mqtt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollyjinx%2Fsma2mqtt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollyjinx%2Fsma2mqtt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollyjinx%2Fsma2mqtt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollyjinx%2Fsma2mqtt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jollyjinx","download_url":"https://codeload.github.com/jollyjinx/sma2mqtt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jollyjinx%2Fsma2mqtt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278740818,"owners_count":26037480,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["home-assistant","inverter","mqtt","netspot","node-red","sma","speedwire","sunny-home-manager"],"created_at":"2024-09-27T14:00:58.730Z","updated_at":"2025-10-08T23:06:02.375Z","avatar_url":"https://github.com/jollyjinx.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"## sma2mqtt Overview\n\nThe __sma2mqtt__ tool is designed to discover SMA devices, such as inverters and Sunny HomeManagers, on a local network. It identifies the data these devices can publish and subsequently delivers this information to an MQTT server.\n\nWithin the local network, __sma2mqtt__ joins the SMA multicast to listen to announcements from Sunny HomeManager. Please note, this functionality is strictly limited to the local network due to the inherent restrictions of multicast.\n\nThe repository includes a build.sh shell script that constructs a Docker container encapsulating the __sma2mqtt__ tool. It's likely necessary to adjust this script to suit the specifics of individual Docker setups.\n\nUpon execution, __sma2mqtt__ produces output on MQTT similar to the one shown on the left, which in turn can be used to drive a node-red dashboard shown on the right.\n\n\u003cimg src=\"Images/mqtt-explorer.png\" width=\"50%\" alt=\"MQTT Explorer Screenshot\"/\u003e\u003cimg src=\"Images/node-red-dashboard.png\" width=\"50%\" alt=\"Node-Red Dashboard Screenshot\"/\u003e\n\n## Docker Container Use\n\nA multi-architecture Docker image, specifically engineered for both 64-bit ARM and x86 architectures, is available. This image is compatible with a range of devices, including the Raspberry Pi, Apple Silicon Macs, x86-based machines, and other 64-bit ARM computers. It can be employed directly using the following command:\n```\ndocker run --name \"sma2mqtt\" --net service16  jollyjinx/sma2mqtt:latest sma2mqtt --inverter-password MySimplePassword\n```\n\nThe --net option is included in this command to specify a separate network for SMA devices. If there is no dedicated network in use, port 9522 should be open for the container.\n\n### Available Docker Tags\n- `latest`: Includes support for both ARM64 and x86 platforms.\n- `3.1.2`: The specific version with multi-architecture support.\n\n## Usage\n\n```\nUSAGE: sma2mqtt \u003coptions\u003e\n\nOPTIONS:\n  --log-level \u003clog-level\u003e Set the log level. (default: debug)\n  --json-output           send json output to stdout\n  --mqtt-servername \u003cmqtt-servername\u003e\n                          MQTT Server hostname (default: mqtt)\n  --mqtt-port \u003cmqtt-port\u003e MQTT Server port (default: 1883)\n  --mqtt-username \u003cmqtt-username\u003e\n                          MQTT Server username (default: mqtt)\n  --mqtt-password \u003cmqtt-password\u003e\n                          MQTT Server password\n  -e, --emit-interval \u003cemit-interval\u003e\n                          Minimum Emit Interval to send updates to mqtt Server. (default: 1.0)\n  -b, --basetopic \u003cbasetopic\u003e\n                          MQTT Server topic. (default: example/sma/)\n  --bind-address \u003cbind-address\u003e\n                          Multicast Binding Listening Interface Address. (default: 0.0.0.0)\n  --bind-port \u003cbind-port\u003e Multicast Binding Listening Port number. (default: 9522)\n  --mcast-address \u003cmcast-address\u003e\n                          Multicast Group Address. (default: 239.12.255.254)\n  --mcast-port \u003cmcast-port\u003e\n                          Multicast Group Port number. (default: 9522)\n  --inverter-password \u003cinverter-password\u003e\n                          Inverter Password. (default: 0000)\n  --interesting-paths-and-values \u003cinteresting-paths-and-values\u003e\n                          Array of path:interval values we are interested in (default: dc-side/dc-measurements/power:2, ac-side/grid-measurements/power:2, ac-side/measured-values/daily-yield:30, battery/state-of-charge:20, battery/battery/temperature:30,\n                          battery/battery-charge/battery-charge:20)\n  -h, --help              Show help information.\n\n```\n\nThe option __--interesting-paths-and-values__ is currently defaulted to the things I like to see, but you probably have different needs. To find out what your inverter supports you can use the catch all argument __\\*:600__ which will show all paths your inverter supports.\n\n__sma2mqtt__ does support signaling. When you send:\n\n- __SIG_USR1__:  it switches the log level between trace/debug/info.\n- __SIG_USR2__: it prints the description of the SMALighthouse object including all currently used SMADevices and their state.\n\n\nSo you can use ```killall -USR2 sma2mqtt``` in a shell to let __sma2mqtt__ print out the SMALighthouse status.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjollyjinx%2Fsma2mqtt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjollyjinx%2Fsma2mqtt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjollyjinx%2Fsma2mqtt/lists"}