Skip to content

HomeAssistant integration for the Ginlong Solis PV Monitoring portal. This integration supports the current Platform v2.0 portal (m.ginlong.com) which supports Solis and Solarman PV inverter brands. Also supports new SolisCloud platform

License

Notifications You must be signed in to change notification settings

snigehere/solis-sensor

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hacs_badge

Solis sensor integration

HomeAssistant sensor for Solis portal platform V2 (m.ginlong.com) and SolisCloud portal.

Platform v2

The platform v2 support logs in to the platform and exposes the data retrieved as sensors. Also confirmed to work with:

  • Solarman (home.solarman.cn)
  • Sofar solar (home.solarman.cn)

Platform V2 backend is used by Ginlong and MyEvolveCloud and the same backend is also used for different PV inverter brand portals. I've only tested it in context of Solis with the Ginlong platform. Let me know if it works with for other inverter types as well and I'll add them to the list of confirmed portals.

SolisCloud

❗This feature is in beta. The server still has some issues. Join the discussion here to find out about known limitations and to ask questions.

SolisCloud is the next generation Portal for Solis branded PV systems from Ginlong. It's unknown to me if the other brands are also supported. The new portal requires a key-id, secret and username to function. Key and secret can be obtained via support: Look at https://www.ginlong.com/global/aftersales.html for the initial contact email address in your region.

HACS installation

The use of HACS is supported and is the preferred means of installing this integration.

Manual installation

Create a directory called solis in the <config directory>/custom_components/ directory on your Home Assistant instance. Install this component by copying the files in [/custom_components/solis/]

This is how your custom_components directory should be:

custom_components
├── solis
│   ├── __init__.py
│   ├── const.py
│   ├── ginlong_api.py
│   ├── ginlong_base.py
│   ├── ginlong_const.py
│   ├── manifest.json
│   ├── sensor.py
│   ├── service.py
│   └── soliscloud_api.py

Configuration

Ginlong platform v2

To enable this integration for Ginlong Solis platform v2 support, add the following lines to your configuration.yaml file:

sensor:
  - platform: solis
    name: "My Solis Inverter"
    portal_domain: "m.ginlong.com" (replace for Solarman, Sofar)
    portal_username: "portal_username"
    portal_password: "portal_password"
    portal_plant_id: "plantId"

Soliscloud

To enable this integration for SolisCloud, add the following lines to your configuration.yaml file:

sensor:
  - platform: solis
    name: "My Solis Inverter"
    portal_domain: "www.soliscloud.com:13333"
    portal_username: "portal_username"
    portal_key_id: "portal_key_id"
    portal_secret: "portal_secret"
    portal_plant_id: "plantId/stationID as string"

Configuration variables:

  • name (Optional): Let you overwrite the name of the device in the frontend. Default value: Solis
  • portal_domain (Required): Portal domain name Default value: m.ginlong.com.
  • portal_username (Required): Username of your portal account.
  • portal_password (Optional): Password of the portal account.

Note: The integration uses https to communicate with the portal, but the username and password are sent over in plain text!

  • portal_key_id (Optional): Key ID needed for communication with SolisCloud (obtain via Ginlong support)
  • portal_secret (Optional): Secret needed for communication with SolisCloud (obtain via Ginlong support)
  • portal_plant_id (Required): PlantId (Ginlong v2 portal) or StationId (SolisCloud) on the platform the inverter belongs to. Can be found on the portal.

Dutch: Tab installatie: Installatie ID.

The integration will detect automatically which data is available at the backend and create the relevant sensors. Names are backward compatible with old manual configuaration.

Energy dashboard

The Solis integration now supports the energy dashboard introduced in Release 2021.8.

Note: This integration requires Home Assistant version 2021.9 or higher

dashboard integration energy production

Thanks

Big thanks & kudo's to @LucidityCrash for all the work on getting the SolisCloud support working!

About

HomeAssistant integration for the Ginlong Solis PV Monitoring portal. This integration supports the current Platform v2.0 portal (m.ginlong.com) which supports Solis and Solarman PV inverter brands. Also supports new SolisCloud platform

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%