jnk-cons/easy-rscp

A library written in Kotlin to access home power plants from E3DC using RSCP interface.

easy-rscp's Issues

Extend services with wallbox live data

Own Wallboxservices:

• Abfrage der angeschlossenen Wallboxen

LiveDataService

• Supply current wallbox energy quantity
• If possible, separate function to query individual wallboxes or a series of boxes

New Service: EmergencyPowerService

• new Service EmergencyPowerService
• function readEmergencyPowerState():
  NOT_POSSIBLE
  ACTIVE
  NOT_ACTIVE
  NOT_AVAILABLE
  SWITCH_IN_ISLAND_STATE -> Unclear what this state means; Maybe the process, that the HPS is currently switching?

-function to configure the emergency power reserve
-- Strech goal: Unclear how to get/set this information via RSCP

SOH and ASOC meaning interchanged

• Documentation is incorrect
• BatteryStatus is interpreted incorrectly

Erweiterung des ChargingService: Writing the IdlePeriods

The charging and discharging locks should be able to be written via the ChargingService

Add missing WallBox Tags

• Add more Wallbox Tags to WBTag.kt

Remove deprecated trainingModeActive in version 2.4

Remove deprecated trainingModeActive

Update documentation

• Link to easy-rscp-js
• Battery Service description
• Update Roadmap

Add more Tags to the Battery namespace and provide service to read out battery informations

• Add new Battery Tags (see attachment)
• Add a Battery Service to read out battery informations

newTags.txt

Temperature and voltage data are read out incorrectly for the DCB modules

• The values are only correct for the DCB module with the index 0 all the following also contain the values from module 0

Service to control the manual charge system

• new function for the ChargingService: to read out the current state of the manual start system
• new function for the ChargingService: to start a manual charging process

Configure Dependabot

• Activate and configure dependabot

Wrong TrainingMode interpretation

The Traning Mode in the BatteryService must be an enum and not a Boolean

Add missing Tags

• Namespace DCDC, HA, INFO, PM, PVI, RSCP, SYS and UM

Extension of the ChargingService: Readout of the IdlePeriods

At the home power plant, it is possible to set charging and discharging locks according to the day of the week and the time of day. These should be readable via the ChargingService

Add switch to remove authentication data from StringFrameConverter

• Adding a switch, that ensures, that no authentication credentials are parsed into the string

RSCP

ad DERATE_AT_PERCENT_VALUE

Empirische Erkenntnis:
Das ist das Verältnis max. Einspeiseleistung / INSTALLED_PEAK_POWER in Prozent.

Beispiel: Die Anlage hat 7,7 kWp und darf nur 70% dieser Peakleistung einspeisen.
INSTALLED_PEAK_POWER = 7700 [W]
DERATE_AT_PERCENT_VALUE = 70 [%]
7700 * 70 / 100 = 5390
Die Anlage wird bei 5.390 W Einspeisung abgeregelt.
Den Wert DERATE_AT_PERCENT_VALUE kann nur der Installateur ändern.

Documentation improvement for EMSTag.BALANCED_PHASES

Documentation update for enum EMSTag.BALANCED_PHASES:

Balanced phases are code as follows:
0: "PHASE_000"
1: "PHASE_001"
2: "PHASE_010"
3: "PHASE_011"
4: "PHASE_100"
5: "PHASE_101"
6: "PHASE_110"
7: "PHASE_111"

Replace Enum.values() with Enum.entries

Since Kotlin 1.9 Enum.entries is recommended

Old:

BatTag.values()

New:

BatTag.entries

DataBuilder().none() should be optional

If a data block is to get the value none(), it would be easy to omit the call

Old:

DataBuilder().tag(...).none().build()

New:

DataBuilder().tag(...).build()

Read Wallbox History Data

• DB Service is being expanded to include the retrieval of wallbox data

Documentation improvement for EMSTag.MODE

Documentation update for enum EMSTag.MODE:

MODE contains the EMS operating mode coded as follows:
0: "IDLE",
1: "DISCHARGE"
2: "CHARGE"

Update Dependencies to newest version

Check dependencies and add