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)

screenshot

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. (and remove the < and >)

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 :smiley:

utzl / MMM-Solarman

readme