SAJ eSolar Sensor Component

This is a Custom Component for Home-Assistant (https://home-assistant.io) reads and displays sensor values from the SAJ eSolar Portal private API.

NOTE: This component is built upon a none public API and can change/break at any time. The component is built with 2 device to test with used in the Netherlands and Malaysia. Please go to the Supported devides part to see if your device is supported

Installation

HACS - Recommended

• Have HACS installed, this will allow you to easily manage and track updates.
• Search for 'SAJ eSolar'.
• Click Install below the found integration.
• Configure using the configuration instructions below.
• Restart Home-Assistant.

Manual

• Copy directory custom_components/saj_esolar to your <config dir>/custom_components directory.
• Configure with config below.
• Restart Home-Assistant.

Note when updating from v1.0.0.4

- resources are renamed in de configuration, replace old ones. applies when updating v1.0.0.4 -> 1.0.0.5

Usage

To use this component in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry

sensor:
  - platform: saj_esolar
    username: [email protected]
    password: abcd1234
    resources:
      - nowPower
      - runningState
      - todayElectricity
      - monthElectricity
      - yearElectricity
      - totalElectricity
      - todayGridIncome
      - income
      - lastUploadTime
      - totalPlantTreeNum
      - totalReduceCo2
      - todayAlarmNum
      - status
      - plantuid
      - currency
      - address
      - isOnline
      - peakPower

If you have a Saj Sec module add the following config under platform:

    sensors: saj_sec # Optional will only work with SAJ Sec Module

Optional sensors when using an Saj Sec Module:

      - pvElec
      - useElec
      - buyElec
      - sellElec
      - buyRate
      - sellRate
      - selfConsumedRate1
      - selfConsumedRate2
      - selfConsumedEnergy1
      - selfConsumedEnergy2
      - plantTreeNum
      - reduceCo2
      - totalGridPower
      - totalLoadPower
      - totalPvgenPower
      - totalPvEnergy
      - totalLoadEnergy
      - totalBuyEnergy
      - totalSellEnergy

Configuration variables:

• username (Required): E-mail address used on the eSolar Portal.
• password (Required): Password used on the eSolar Portal, we advise you to save it in your secret.yaml.
• resources (Required): This section tells the component which values to display.
• sensors (Optional): saj_sec # Optional will only work with SAJ Sec Module

Devices

Supported Devices:

R5 solar Inverter:

R5 -0.7-3K-S1

R5-3~8K-S2

R5-3-20K-T2

eSolar Modules:

eSolar SEC-module

eSolar WiFi- D

eSolar 4G

AOI3

Not Supported Devices: (create github discussion to request)

Commercial Solar Inverter

Suntrio Plus 25-60K

Storage Solar Inverter

H1-3~6K-S2

AS1-3KS-5.1

B1-5.1-48

Screenshot

Debugging

Add the relevant lines below to the configuration.yaml:

logger:
  default: info
  logs:
    custom_components.saj_esolar: debug

Credits

Credits to @cyberjunky. I got inspired by his source code which helped me a lot to creating this Custom Component. https://github.com/cyberjunky/home-assistant-toon_smartmeter/

Donation

Buy me a coffee:

PayPal: