MMM-Solarman
This module is an extention for the MagicMirror.
The module monitors the values of a Solarman PV device. The needed App_ID and App_Secret can be requested from Solarman customer Service (preferably by chat: ask for API access)
Installation
Open a terminal session, navigate to your MagicMirror's modules
folder and execute git clone https://github.com/utzl/MMM-Solarman.git
, such that a new folder called MMM-Solarman will be created.
Navigate inside the folder and execute npm install
to install all dependencies.
Activate the module by adding it to the config.js
file of the MagicMirror as shown below.
The table below lists all possible configuration options.
Using the module
modules: [
{
module: 'MMM-Solarman',
position: 'top_right',
config: {
accessToken: 'Enter your accessToken here',
deviceSn: 'Enter your deviceSn here',
appId: 'Enter your appId here',
}
}
]
Configuration options
The following configuration options can be set and/or changed:
Module
Option | Type | Default | Description |
---|---|---|---|
accessToken |
string |
"eyJhbGci..." |
accessToken to be requested with App_Secret every 60 days: see below |
deviceSn |
string |
"220107..." |
Device Serial Number of your inverter |
appId |
string |
"10220727..." |
AppId, provided by Solarman customer service |
showTempWhenOnline |
boolean |
true |
Temperature of device will be displayed in header |
updateInterval |
Int |
2 * 60 * 1000 |
How often the table shall be updated [milliseconds] (2 minutes) |
animationSpeed |
Int |
2 * 1000 |
Animation speed to fade in the module on startup [milliseconds] (2 seconds) |
Request an accessToken
Go to https://reqbin.com/curl
Paste the below into the left window, make sure you changed (four!) the relevant sections.
You can hash your password by visiting SHA256 Online.
curl --request POST \
--url 'https://globalapi.solarmanpv.com/account/v1.0/token?appId=<appId>&language=en&=' \
--header 'Content-Type: application/json' \
--data '{
"appSecret": "<appSecret>",
"email": "<email>",
"password": "<passwordConvertedToSHA256>"
}'
Grab your accessToken in the right box.
(based on link)
Updating
To update the module to the latest version, use your terminal to go to your MMM-Solarman module folder and type the following command:
git pull
Feel free to open any Issue 😃