sudo npm install --unsafe-perm# Solar serial inverter system (solar-sis)
Universal inverter protocol handler specially for solar electricity systems
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
You will need to install Nodejs to run this project. Please visit https://nodejs.org for more information how to install. You also need to install the nodejs package manager npm to get all dependencies.
Currently it only works with serialport 4.0.7 if you are running with the built in USB to Serial converter on the MPP inverters and chargers. This is an big issue but if you stick with 4.0.7 it works and also if you go with the pure serial interface. (This need to be bugged and sorted). The correct version of nodejs serialport package for this project will be installed by the solar-sis npm package scripts.
n You can install solar-sis with examples by clone this git repository or retrieve the solar-sis npm package.
Using Git and npm
Install by cloning git repository in your folder of choice.
git clone https://github.com/opengd/solar-sis.git or as sudo: sudo git clone https://github.com/opengd/solar-sis.git
This will retriev the solar-sis git repository. To use one of the example (MPI10kWHybrid, PCM60x, PIP4084..), go to the examaple of choice and retriev depended nodejs packages by using npm.
Install nodejs dependencies in example folder.
npm install OR if you are using sudo or as root user: sudo npm install --unsafe-perm
Now all dependencies for solar-sis should have been installed and you can run the service using Nodejs.
How to start a solar-sis example project.
node project.js OR as sudo: sudo node project.js OR if calls.json and session.json have been renamed: sudo node project.js my_new_calls.json my_new_session.json
sudo git clone https://github.com/opengd/solar-sis.git cd solar-sis/example/PIP4084 sudo npm install --unsafe-perm sudo node project.js
Or you can use nodejs npm service to get solar-sis running, first get the solars-sis npm package in your folder of choice.
sudo npm install solar-sis --unsafe-perm
You should then find the example projects folder in "node_modules/solar-sis/example".
Choose an example and start the service by running the project.js file using Nodejs.
sudo node project.js
Example installation using npm:
sudo npm install solar-sis --unsafe-perm cd node_modules/solar-sis/example/PIP4084 sudo node project.js
To update solar-sis scripts using git just pull for updates in the solar-sis folder. This will update the example projects but not the node modules.
sudo git pull
To update the node modules in one of the example folders you will have to go to folder then and run npm update.
sudo npm update --unsafe-perm
This will get any new dependencies and update the old against the solar-sis npm package.
Running the tests
No tests exist in this project
Feel free to send in bugs/features or any other requests. We will take a look at them all and incorporate them as much as we can. If you want to contribute to the time its spent on this getting it here you can always contribute to the authors below via any of their Patreon/Paypal links
See also the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE.md file for details
- Hat tip to anyone who's code was used