npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

iobroker.goodwe-pv

v0.2.3

Published

Communication with GoodWe Inverter ET/EH/BH/BT Series

Readme

Logo

iobroker.goodwe-pv

NPM version Downloads node-lts Libraries.io dependency status for latest release

GitHub GitHub repo size GitHub commit activity GitHub last commit GitHub issues

GitHub Workflow Status CodeQL Appveyor-CI SNYK Known Vulnerabilities

Versions

Beta Stable Installed

NPM

Sentry

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information on how to disable error reporting, see Sentry-Plugin Documentation!

goodwe-pv adapter for ioBroker

Communication with GoodWe hybrid inverters of the ET, EH, BH and BT series via the local UDP interface (port 8899). No cloud connection required — the adapter talks directly to the inverter on your LAN.

Supported devices

All GoodWe hybrid inverters that expose the local Modbus-over-UDP interface on port 8899:

  • ET series (e.g. GW5-ET, GW8-ET, …)
  • EH series
  • BH series
  • BT series

Configuration

IP address — Local IP address of the GoodWe inverter (default: 127.0.0.1). Find it in your router's DHCP lease table or in the SEMS portal / ShinePhone app under "Device Info". A static IP or DHCP reservation is recommended.

Poll cycle — How often in seconds each data group is re-read from the inverter (default: 10). The four data groups (DeviceInfo, RunningData, ExtComData, BMSInfo) are staggered so only one UDP request is in flight per second.

Tip: Find the inverter's IP address in your router's DHCP lease table, or check the GoodWe SEMS portal / ShinePhone app under "Device Info". Assigning a static IP or DHCP reservation is recommended so the address does not change.

Based on

This adapter is based on ioBroker.goodwe by FossyTom (Thomas Schönberger), licensed under MIT. Copyright (c) 2023 Thomas Schönberger [email protected]

Donate


If you enjoyed this project — or just feeling generous, consider buying me a beer. Cheers! :beers:

Changelog

0.2.3 (2026-07-18)

  • (hombach) replace deprecated role value.power.consumption with value.energy.consumed
  • (hombach) replace value.power.produced with value.energy.produced for accumulated kWh states
  • (hombach) replace invalid roles value.power.apparent and value.signal with valid alternatives

0.2.2 (2026-07-12)

  • (hombach) assign semantic ioBroker roles to many states
  • (hombach) fix PowerFactor scaling: signed int / 1000 instead of uint / 100
  • (hombach) fix TotalReactivePower sign: use signed int (VAR can be negative)
  • (hombach) fix EnergyTotalSell/Buy unit: GM3000 meter float is in Wh, divide by 1000

0.2.1 (2026-07-12)

  • (hombach) add GoodWe manufacturer link to README
  • (hombach) remove debug code (checkPasswordAsync/checkGroupAsync) from onReady
  • (hombach) disable unused onStateChange handler (no writable states)
  • (hombach) add runtime validation for pollCycle config parameter
  • (hombach) expose DerateFlag as ioBroker state in RunningData
  • (hombach) fix UTF-8 encoding corruption in all i18n translation files

0.2.0 (2026-07-05)

  • (hombach) added units
  • (hombach) replace chai/sinon-chai test dependencies with node:assert
  • (hombach) fix test runner TS5011 rootDir error
  • (hombach) remove redundant mocha/@types/mocha devDependencies (already included in @iobroker/testing)

0.1.0 (2026-06-19)

  • (ioBroker-Bot) Adapter requires admin >= 7.8.23 now.
  • (hombach) refactored to TypeScript
  • (hombach) upgraded adapter-core
  • (hombach) added units
  • (hombach) fixed repoChecker warnings

Older changelogs can be found there

License

MIT License

Copyright (c) 2026 hombach [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.