This node-based import script can be used to import data from the latest GoodWe API and upload it to PVOutput.org. The previous API from Goodwe has been deprecated and was supposed to be taken down in October 2018, it's still up & running though (dec.2018). To keep my PV data synced to PVOutput.org I've written this small utility. For now it only supports PVOutput.org, but I will take a look into syncing with Domoticz as well.
- Linux or Mac. Windows might work, but I didn't test and honestly; I don't care
- Shell access (and experience :)
- Node v8.9.0 or above
- NPM v5.8.0 or above
- Clone repo or download from releases-page
cdinto the downloaded/cloned folder- run
npm i - Make
db-folder writeable (easiest way;chmod +w db/) - Setup environment (see "Environment")
- Transpile the code ;
npm run build - check if building succeeded
- link the cli-command;
npm link
Currently this tool runs from commandline, usually from a cronjob. I have not looked into daemonizing it yet, it's on the backlog.
These examples run assuming you setup the environment correctly
Get stations:
semsSync --list-powerstations
Print last output:
semsSync --station-id [stationID] --get-last-output
Sync:
semsSync --station-id [stationID] --sync PVOutput
These variables should be set from environment-variables or can be passed using CLI-arguments
GOODWE_LOGIN_API=https://globalapi.sems.com.cn/api/v1/
GOODWE_API_URI=https://euapi.sems.com.cn/api/
GOODWE_USERNAME=[Goodwe username]
GOODWE_PASSWORD=[Goodwe pass]
GOODWE_API_VERION=v2.0.4
GOODWE_CLIENT_TYPE=ios
CACHE_ID=[insert random GUID here]
CACHE_FOLDER=./db
PVapiKey=[API Key From PVOutput.org]
PVSystemId=[SystemID from PVOutput.org]
--list-powerstations prints a list of powerstations connected to your account
--get-last-output prints the last PAC value, expects the station-id in --station-id unfinished
--sync [target] syncs output to targets (comma-separated). Currently only one target is supported (which is PVOutput.org). Each target has a set of configuration options which are checked before executing the sync.
--dry-run uses mock data instead of real data and does not post to targets
--log-to-file [filename] write log to file instead of console.
This tool is written to allow syncing of GoodWe-API-data to multiple targets. Currently PVOutput is the only target which is supported. Possibly more to come in the future:)
Configuration options;
--PVapiKey [key] the PVOutput API Key
--PVSystemId [systemId] the PVOUtput systemID
- Edit your crontab;
crontab -e
- Copy the contents of your env file to the top of the crontab
- Paste the following at the end of your crontab, this will run the semsSync task every 5 minutes
*/5 * * * * /[Path to]node /[path to the GoodWe package]/dist/index.js --sync PVOutput --station-id [station-ID you get from running semsSync --list-powerstations] 2>&1 | while read line; do echo `/bin/date` "$line" >> /[path to you log-directory]/semsSync.log; done
My Crontab looks like this (I have NVM running, so node is probably in a different path from most stock setups):
GOODWE_LOGIN_API=https://globalapi.sems.com.cn/api/v1/
GOODWE_API_URI=https://euapi.sems.com.cn/api/
GOODWE_USERNAME=<your goodwe-username>
GOODWE_PASSWORD=<your goodwe-password>
GOODWE_API_VERION=v2.0.4
GOODWE_CLIENT_TYPE=ios
CACHE_ID=[insert random GUID here]
CACHE_FOLDER=./db
PVapiKey=[API Key From PVOutput.org]
PVSystemId=[SystemID from PVOutput.org]
*/5 * * * * /root/.nvm/versions/node/v8.14.0/bin/node /root/goodwe-api/dist/index.js --sync PVOutput --station-id 5368e8a7-3966-4250-8c0d-0d90faad52eb 2>&1 | while read line; do echo `/bin/date` "$line" >> /var/log/semsSync.log; done
To monitor the log, you can use tail:
tail -F /var/log/semsSync.log
v0.3.2
- Update NPM Packages (security)
- PVOutput : Fix wrong month-prefix in API call
v0.3.0
- Add colors to terminal output
- Add option to write output to file
v0.2.0
- Added CLI-command (semsSync)
- Fixed building with babel
- Fixed expired logins
v0.1.0
First draft-release. Should be able to sync if you set a cronjob to execute every x minutes, but still very alpha!
- Login flow SEMS GoodWe-API
- Retrieve list of powerstations from SEMS/GoodWe
- Retrieve PAC (output) of single powerstation from SEMS/GoodWe
- Post values to PVOutput.org
See GitHub