Lastmanagement

cmd/configure/configure.go

@@ -25,13 +25,23 @@ type loadpoint struct {
 	MinCurrent  int
 	MaxCurrent  int
 	Phases      int
+	Circuit     string
+}
+
+type circuit struct {
+	Name       string  `mapstructure:"name"`       // unique name, used as reference in lp
+	MaxCurrent float64 `mapstructure:"maxCurrent"` // the max allowed current of this circuit
+	MaxPower   float64 `mapstructure:"maxPower"`   // the max allowed power of this circuit
+	MeterRef   string  `mapstructure:"meter"`      // Charge meter reference
+	ParentRef  string  `mapstructure:"parent"`     // name of parent circuit
 }
 
 type globalConfig struct {
 	Meters     []device
 	Chargers   []device
 	Vehicles   []device
 	Loadpoints []loadpoint
+	Circuits   []circuit
 	Site       struct { // TODO Perspektivisch können wir was aus core wiederverwenden, für später
 		Title     string
 		Grid      string

cmd/configure/configure.tpl

@@ -54,7 +54,18 @@ loadpoints:
   vehicle: {{ .Vehicle }}
 {{- end }}
   mode: {{ .Mode }}
+{{-     if .Circuit }}
+  circuit: {{ .Circuit }}
+{{-   end }}
 {{- end }}
+
+circuits:
+{{-   range .Circuits }}
+- name: {{ .Name }}
+  maxCurrent: {{ .MaxCurrent }}
+  maxPower: {{ .MaxPower }}
+  meter: {{ .MeterRef }}
+  parent: {{ .ParentRef }}
 {{- end }}
 
 site:

cmd/configure/localization/de.toml

@@ -37,6 +37,9 @@ Category_SystemAdditional = "ein weiteres"
 Category_GridMeterTitle = "Netz-Stromzähler"
 Category_GridMeterArticle = "einen"
 Category_GridMeterAdditional = "einen weiteren"
+Category_CircuitMeterTitle = "Unterverteilungs-Stromzähler"
+Category_CircuitMeterArticle = "einen"
+Category_CircuitMeterAdditional = "einen weiteren"
 Category_PVMeterTitle = "PV Wechselrichter (oder entsprechender Stromzähler)"
 Category_PVMeterArticle = "einen"
 Category_PVMeterAdditional = "einen weiteren"
@@ -90,8 +93,10 @@ Loadpoint_Setup = "- Ladepunkt(e) einrichten"
 Loadpoint_Title = "Titel des Ladepunktes"
 Loadpoint_AddAnother = "Möchtest du einen weiteren Ladepunkt hinzufügen?"
 Loadpoint_DefaultTitle = "Garage"
-Loadpoint_ResetOnDisconnect = "Soll beim Abstecken des Ladekabels von einem Fahrzeug, die Lade-Standardeinstellungen wieder hergestellt werden?"
-Loadpoint_WallboxWOMeter = "Das System konnte nicht erkennen, ob ein Ladestromzähler in der Wallbox eingebaut ist. Möchtest du einen externen Ladestromzähler hinzufügen?"
+Loadpoint_CircuitYesNo = "Soll der Ladepunkt einem Stromkreis zugeordnet werden (für Lastmanagement)?"
+Loadpoint_Circuit = "Stromkreis auswählen:"
+Loadpoint_ResetOnDisconnect = "Soll beim Abstecken des Ladekables von einem Fahrzeug, die Lade-Standardeinstellungen wieder hergestellt werden?"
+Loadpoint_WallboxWOMeter = "Das System konnte nicht erkennen ob ein Ladestromzähler in der Wallbox eingebaut ist. Möchtest du einen externen Ladestromzähler hinzufügen?"
 Loadpoint_WallboxMaxPower = "Was ist die maximale Leistung, welche die Wallbox zur Verfügung stellen kann?"
 Loadpoint_WallboxMinAmperage = "Was ist die MINIMALE Stromstärke, welche die Wallbox auf einer Phase zur Verfügung stellen kann?"
 Loadpoint_WallboxMaxAmperage = "Was ist die MAXIMALE Stromstärke, welche die Wallbox auf einer Phase zur Verfügung stellen kann?"
@@ -111,3 +116,32 @@ ChargeModeNone = "Keinen (Benutzt den im Ladepunkt gesetzten Lademodus)"
 Site_Setup = "- Standort einrichten"
 Site_Title = "Titel des Standortes"
 Site_DefaultTitle = "Mein Zuhause"
+Circuit_Setup = "Stromkreise einrichten"
+Circuit_Add = "Sollen ein oder mehrere Stromkreise konfiguriert werden?"
+Circuit_AddAnother = "Möchtest Du einen weiteren Stromkreis hinzufügen?"
+Circuit_Title = "Name des Stromkreises"
+Circuit_TitleHelp = "Eindeutiger Name des Stromkreises"
+Circuit_NameAlreadyUsed = "Name bereits vergeben"
+Circuit_HasParent = "Ist der Stromkreis Teil eines anderen Stromkreises?"
+Circuit_Parent = "Stromkreis auswählen"
+Circuit_Meter = "Haben sie einen Stromzähler für diesen Stromkreis?"
+Circuit_MaxCurrent = "Wie hoch ist der maximal zulässige Phasenstrom im Stromkreis?"
+Circuit_MaxCurrentDisable = "kein Lastmanagement auf Basis Phasenstrom"
+Circuit_MaxCurrent16A = "16A (max. 11 kVA)"
+Circuit_MaxCurrent20A = "20A (max. 13,8 kVA)"
+Circuit_MaxCurrent25A = "25A (max. 17,2 kVA)"
+Circuit_MaxCurrent32A = "32A (max. 22 kVA)"
+Circuit_MaxCurrent35A = "35A (max. 24 kVA)"
+Circuit_MaxCurrent50A = "50A (max. 34,5 kVA)"
+Circuit_MaxCurrent63A = "63A (max. 43 kVA)"
+Circuit_MaxCurrent80A = "80A (max. 55,2 kVA)"
+Circuit_MaxCurrent100A = "100A (max. 69 kVA)"
+Circuit_MaxCurrentCustom = "anderer Wert (manuelle Eingabe)"
+Circuit_MaxCurrentCustomInput = "Maximaler Strom"
+Circuit_MaxPowerDisable = "kein Lastmanagement aus Basis der Leistung"
+Circuit_MaxPower11kW = "11kW"
+Circuit_MaxPower20kW = "20kW"
+Circuit_MaxPower50kW = "50kW"
+Circuit_MaxPower100kW = "100kW"
+Circuit_MaxPowerCustom = "anderer Wert (manuelle Eingabe)"
+Circuit_MaxPower = "Maximale Leistung"

cmd/configure/localization/en.toml

@@ -36,7 +36,10 @@ Category_SystemArticle = "an"
 Category_SystemAdditional = "another"
 Category_GridMeterTitle = "grid meter"
 Category_GridMeterArticle = "a"
-Category_GridMeterAdditional = "another"
+Category_GridMeterAdditional = "one more"
+Category_CircuitMeterTitle = "circuit meter"
+Category_CircuitMeterArticle = "a"
+Category_CircuitMeterAdditional = "one more"
 Category_PVMeterTitle = "PV inverter (or corresponding meter)"
 Category_PVMeterArticle = "a"
 Category_PVMeterAdditional = "another"
@@ -90,6 +93,8 @@ Loadpoint_Setup = "- Setup loadpoint(s), i.e. group of colocated chargers"
 Loadpoint_Title = "Loadpoint title"
 Loadpoint_AddAnother = "Do you want to add another loadpoint?"
 Loadpoint_DefaultTitle = "Garage"
+Loadpoint_CircuitYesNo = "Is this laodpoint attached to a circuit (for load management)?"
+Loadpoint_Circuit = "Select circuit:"
 Loadpoint_ResetOnDisconnect = "Will disconnecting the charging cable from the vehicle reset the charging settings to the defaults?"
 Loadpoint_WallboxWOMeter = "The system could not detect if the charger provides power data. Do you want to add an external meter instead?"
 Loadpoint_WallboxMaxPower = "What is the maximum power your charger can provide?"
@@ -111,3 +116,32 @@ ChargeModeNone = "None (Use what is set at the loadpoint)"
 Site_Setup = "- Setup site"
 Site_Title = "Site title"
 Site_DefaultTitle = "My home"
+Circuit_Setup = "Circuit Setup"
+Circuit_Add = "Do you want to add circuits?"
+Circuit_AddAnother = "Add more circuits?"
+Circuit_Title = "Name of Circuit"
+Circuit_TitleHelp = "Unique circuit name"
+Circuit_NameAlreadyUsed = "Name already in use"
+Circuit_HasParent = "Is this circuit member of another circuit?"
+Circuit_Parent = "Select parent circuit"
+Circuit_Meter = "Do you have a dedicated meter installed for this circuit?"
+Circuit_MaxCurrent = "What is the max current (amperes) in this circuit?"
+Circuit_MaxCurrentDisable = "no load management based on phase currents"
+Circuit_MaxCurrent16A = "16A (max. 11 kVA)"
+Circuit_MaxCurrent20A = "20A (max. 13,8 kVA)"
+Circuit_MaxCurrent25A = "25A (max. 17,2 kVA)"
+Circuit_MaxCurrent32A = "32A (max. 22 kVA)"
+Circuit_MaxCurrent35A = "35A (max. 24 kVA)"
+Circuit_MaxCurrent50A = "50A (max. 34,5 kVA)"
+Circuit_MaxCurrent63A = "63A (max. 43 kVA)"
+Circuit_MaxCurrent80A = "80A (max. 55,2 kVA)"
+Circuit_MaxCurrent100A = "100A (max. 69 kVA)"
+Circuit_MaxCurrentCustom = "other value (manual input)"
+Circuit_MaxCurrentCustomInput = "max current in amperes"
+Circuit_MaxPowerDisable = "no load management based on power"
+Circuit_MaxPower11kW = "11kW"
+Circuit_MaxPower20kW = "20kW"
+Circuit_MaxPower50kW = "50kW"
+Circuit_MaxPower100kW = "100kW"
+Circuit_MaxPowerCustom = "other value (manual input)"
+Circuit_MaxPower = "max power in kW"

cmd/configure/main.go

@@ -7,6 +7,7 @@ import (
 	"fmt"
 	"os"
 	"slices"
+	"sort"
 	"strconv"
 	"strings"
 
@@ -179,8 +180,11 @@ func (c *CmdConfigure) flowNewConfigFile() {
 	_ = c.configureDevices(DeviceCategoryBatteryMeter, true, true)
 	_ = c.configureDevices(DeviceCategoryVehicle, true, true)
 
-	c.configureLoadpoints()
 	c.configureSite()
+	if c.advancedMode {
+		c.configureCircuits()
+	}
+	c.configureLoadpoints()
 
 	// check if SMA HEMS is available and ask the user if it should be added
 	if c.capabilitySMAHems {
@@ -426,6 +430,17 @@ func (c *CmdConfigure) configureLoadpoints() {
 
 		fmt.Println()
 		loadpoint.Mode = c.askValue(question{valueType: templates.TypeChargeModes, excludeNone: true})
+
+		if len(c.configuration.config.Circuits) > 0 && c.askYesNo(c.localizedString("Loadpoint_CircuitYesNo")) {
+			var circuitNames []string
+			for _, cc := range c.configuration.config.Circuits {
+				circuitNames = append(circuitNames, cc.Name)
+			}
+
+			ccNameId, _ := c.askChoice(c.localizedString("Loadpoint_Circuit"), circuitNames)
+			loadpoint.Circuit = circuitNames[ccNameId]
+		}
+
 		c.configuration.AddLoadpoint(loadpoint)
 
 		fmt.Println()
@@ -447,3 +462,135 @@ func (c *CmdConfigure) configureSite() {
 	})
 	c.configuration.config.Site.Title = siteTitle
 }
+
+// configureCircuits asks for circuits
+func (c *CmdConfigure) configureCircuits() {
+	fmt.Println()
+	fmt.Println(c.localizedString("Circuit_Setup"))
+
+	if !c.askYesNo(c.localizedString("Circuit_Add")) {
+		return
+	}
+
+	// helper to know used circuit names
+	circuitNames := []string{}
+
+	for {
+		ccName := c.askValue(question{
+			label:    c.localizedString("Circuit_Title"),
+			help:     c.localizedString("Circuit_TitleHelp"),
+			required: true,
+		})
+
+		if slices.Contains(circuitNames, ccName) {
+			fmt.Println(c.localizedString("Circuit_NameAlreadyUsed"))
+			continue
+		}
+		curCircuit := &circuit{Name: ccName}
+
+		curChoices := []string{
+			c.localizedString("Circuit_MaxCurrentDisable"), // no current checking
+			c.localizedString("Circuit_MaxCurrent16A"),     // 11kVA
+			c.localizedString("Circuit_MaxCurrent20A"),     // 13kVA
+			c.localizedString("Circuit_MaxCurrent25A"),     // 17kVA
+			c.localizedString("Circuit_MaxCurrent32A"),     // 22kVA
+			c.localizedString("Circuit_MaxCurrent35A"),     // 24kVA
+			c.localizedString("Circuit_MaxCurrent50A"),     // 34kVA
+			c.localizedString("Circuit_MaxCurrent63A"),     // 43kVA
+			c.localizedString("Circuit_MaxCurrent80A"),     // 55kVA
+			c.localizedString("Circuit_MaxCurrent100A"),    // 69kVA
+			c.localizedString("Circuit_MaxCurrentCustom"),
+		}
+		fmt.Println()
+		curIndex, _ := c.askChoice(c.localizedString("Circuit_MaxCurrent"), curChoices)
+		switch curIndex {
+		case 0:
+			curCircuit.MaxCurrent = 16.0
+		case 1:
+			curCircuit.MaxCurrent = 16.0
+		case 2:
+			curCircuit.MaxCurrent = 20.0
+		case 3:
+			curCircuit.MaxCurrent = 25.0
+		case 4:
+			curCircuit.MaxCurrent = 32.0
+		case 5:
+			curCircuit.MaxCurrent = 35.0
+		case 6:
+			curCircuit.MaxCurrent = 50.0
+		case 7:
+			curCircuit.MaxCurrent = 63.0
+		case 8:
+			curCircuit.MaxCurrent = 80.0
+		case 9:
+			curCircuit.MaxCurrent = 100.0
+		case 10:
+			amperage := c.askValue(
+				question{
+					label:          c.localizedString("Circuit_MaxCurrentCustomInput"),
+					valueType:      templates.TypeNumber,
+					maxNumberValue: 1000, // 600kW ... enough?
+					required:       true,
+				})
+			curCircuit.MaxCurrent, _ = strconv.ParseFloat(amperage, 64)
+		}
+		pwrChoices := []string{
+			c.localizedString("Circuit_MaxPowerDisable"), // no current checking
+			c.localizedString("Circuit_MaxPower11kW"),
+			c.localizedString("Circuit_MaxPower20kW"),
+			c.localizedString("Circuit_MaxPower50kW"),
+			c.localizedString("Circuit_MaxPower100kW"),
+			c.localizedString("Circuit_MaxCurrentCustom"),
+		}
+		fmt.Println()
+		pwrIndex, _ := c.askChoice(c.localizedString("Circuit_MaxPower"), pwrChoices)
+		switch pwrIndex {
+		case 0:
+			curCircuit.MaxPower = 0.0
+		case 1:
+			curCircuit.MaxPower = 11.0
+		case 2:
+			curCircuit.MaxPower = 20.0
+		case 3:
+			curCircuit.MaxPower = 50.0
+		case 4:
+			curCircuit.MaxPower = 100.0
+		case 5:
+			power := c.askValue(
+				question{
+					label:          c.localizedString("Circuit_MaxPowerCustomInput"),
+					valueType:      templates.TypeNumber,
+					maxNumberValue: 1000, // 1GkW ... enough?
+					required:       true,
+				})
+			curCircuit.MaxPower, _ = strconv.ParseFloat(power, 64)
+		}
+
+		// check meter
+		if c.askYesNo(c.localizedString("Circuit_Meter")) {
+			ccMeter, _, err := c.configureDeviceCategory(DeviceCategoryGridMeter)
+			if err == nil {
+				curCircuit.MeterRef = ccMeter.Name
+			}
+		}
+
+		// in case we have already circuits, ask for parent circuit
+		if len(circuitNames) > 0 {
+			// circuits exist already, ask for parent
+			if c.askYesNo(c.localizedString("Circuit_HasParent")) {
+				sort.Strings(circuitNames)
+				parentCCNameId, _ := c.askChoice(c.localizedString("Circuit_Parent"), circuitNames)
+
+				// assign this circuit as child to the requested parent
+				curCircuit.ParentRef = circuitNames[parentCCNameId]
+			}
+		}
+		// append to known names for later lookup
+		circuitNames = append(circuitNames, curCircuit.Name)
+		c.configuration.config.Circuits = append(c.configuration.config.Circuits, *curCircuit)
+		fmt.Println()
+		if !c.askYesNo(c.localizedString("Circuit_AddAnother")) {
+			break
+		}
+	}
+}