From bedebe29571bc62604d00df40b2cbdbe7029ab8f Mon Sep 17 00:00:00 2001 From: andig Date: Tue, 21 Dec 2021 09:32:29 +0100 Subject: [PATCH] Add Innogy eBox (#2091) --- README.md | 3 +- charger/innogy.go | 196 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 198 insertions(+), 1 deletion(-) create mode 100644 charger/innogy.go diff --git a/README.md b/README.md index d4b962aa7..b1aeff9c8 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ EVCC is an extensible EV Charge Controller with PV integration implemented in [G - simple and clean user interface - multiple [chargers](#charger): - Open source: [openWB](https://openwb.de/), [EVSEWifi](https://www.evse-wifi.de) (includes smartWB) - - Other commercial: ABL eMH1, Alfen Eve, cFos PowerBrain, Daheimladen, go-eCharger, Heidelberg Energy Control, KEBA/BMW, NRGkick, Wallbe, Mobile Charger Connect, EEBUS (experimental) + - Other commercial: ABL eMH1, Alfen Eve, cFos PowerBrain, Daheimladen, go-eCharger, Heidelberg Energy Control, Innogy eBox, KEBA/BMW, NRGkick, Wallbe, Mobile Charger Connect, EEBUS (experimental) - Build-your-own: Phoenix (includes ESL Walli), [SimpleEVSE](https://www.evse-wifi.de/produkt-schlagwort/simple-evse-wb/) - Smart-Home outlets: FritzDECT, Shelly, Tasmota, TP-Link - multiple [meters](#meter): ModBus (Eastron SDM, MPM3PM, SBC ALE3 and many more), Discovergy (using HTTP plugin), SMA Sunny Home Manager and Energy Meter, KOSTAL Smart Energy Meter (KSEM, EMxx), any Sunspec-compatible inverter or home battery devices (Fronius, SMA, SolarEdge, KOSTAL, STECA, E3DC, ...), Tesla PowerWall, LG ESS HOME @@ -200,6 +200,7 @@ Available charger implementations are: - `evsewifi`: chargers with SimpleEVSE controllers using [EVSE-WiFi](https://www.evse-wifi.de/) (includes smartWB) - `go-e`: go-eCharger chargers (both local and cloud API are supported, at least firmware 040.0 required) - `heidelberg`: Heidelberg Energy Control (requires Modbus adapter; [sponsors only](#sponsorship)) +- `innogy`: Innogy eBox - `keba`: KEBA KeContact P20/P30 and BMW chargers (see [Preparation](#keba-preparation-)) - `mcc`: Mobile Charger Connect devices (Audi, Bentley, Porsche) - `nrgkick-bluetooth`: NRGkick chargers with Bluetooth connector (Linux only, not supported on Docker) diff --git a/charger/innogy.go b/charger/innogy.go new file mode 100644 index 000000000..41947d4ce --- /dev/null +++ b/charger/innogy.go @@ -0,0 +1,196 @@ +package charger + +// LICENSE + +// Copyright (c) 2019-2021 andig + +// This module is NOT covered by the MIT license. All rights reserved. + +// The above copyright notice and this permission notice shall be included in all +// copies or substantial portions of the Software. + +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +// SOFTWARE. + +import ( + "encoding/binary" + "fmt" + "math" + + "github.com/evcc-io/evcc/api" + "github.com/evcc-io/evcc/util" + "github.com/evcc-io/evcc/util/modbus" + "github.com/evcc-io/evcc/util/sponsor" +) + +const ( + igyRegID = 0 // Input + igyRegSerial = 25 // Input + igyRegProtocol = 50 // Input + igyRegManufacturer = 100 // Input + igyRegFirmware = 200 // Input + igyRegStatus = 275 // Input + igyRegEnable = 1028 // Holding +) + +var ( + igyRegMaxCurrents = []uint16{1012, 1014, 1016} // max current per phase + igyRegCurrents = []uint16{1006, 1008, 1010} // current readings per phase +) + +// Innogy is an api.Charger implementation for Innogy eBox wallboxes. +type Innogy struct { + conn *modbus.Connection +} + +func init() { + registry.Add("innogy", NewInnogyFromConfig) +} + +// NewInnogyFromConfig creates a Innogy charger from generic config +func NewInnogyFromConfig(other map[string]interface{}) (api.Charger, error) { + cc := struct { + URI string + ID uint8 + }{ + ID: 1, + } + + if err := util.DecodeOther(other, &cc); err != nil { + return nil, err + } + + return NewInnogy(cc.URI, cc.ID) +} + +// NewInnogy creates a Innogy charger +func NewInnogy(uri string, id uint8) (*Innogy, error) { + conn, err := modbus.NewConnection(uri, "", "", 0, modbus.TcpFormat, id) + if err != nil { + return nil, err + } + + if !sponsor.IsAuthorized() { + return nil, api.ErrSponsorRequired + } + + log := util.NewLogger("innogy") + conn.Logger(log.TRACE) + + wb := &Innogy{ + conn: conn, + } + + return wb, nil +} + +// Status implements the api.Charger interface +func (wb *Innogy) Status() (api.ChargeStatus, error) { + b, err := wb.conn.ReadInputRegisters(igyRegStatus, 2) + if err != nil { + return api.StatusNone, err + } + + switch r := rune(b[0]); r { + case 'A', 'B', 'D', 'E', 'F': + return api.ChargeStatus(r), nil + case 'C': + // C1 is "connected" + if rune(b[1]) == '1' { + return api.StatusB, nil + } + return api.StatusC, nil + default: + return api.StatusNone, fmt.Errorf("invalid status: %0x", b[:1]) + } +} + +// Enabled implements the api.Charger interface +func (wb *Innogy) Enabled() (bool, error) { + b, err := wb.conn.ReadHoldingRegisters(igyRegEnable, 1) + if err != nil { + return false, err + } + + return binary.BigEndian.Uint16(b) > 0, nil +} + +// Enable implements the api.Charger interface +func (wb *Innogy) Enable(enable bool) error { + var u uint16 + if enable { + u = 1 + } + + _, err := wb.conn.WriteSingleRegister(igyRegEnable, u) + + return err +} + +// MaxCurrent implements the api.Charger interface +func (wb *Innogy) MaxCurrent(current int64) error { + return wb.MaxCurrentMillis(float64(current)) +} + +var _ api.ChargerEx = (*Innogy)(nil) + +// MaxCurrentMillis implements the api.ChargerEx interface +func (wb *Innogy) MaxCurrentMillis(current float64) error { + if current < 6 { + return fmt.Errorf("invalid current %.5g", current) + } + + b := make([]byte, 4) + binary.BigEndian.PutUint32(b, math.Float32bits(float32(current))) + + for _, reg := range igyRegMaxCurrents { + if _, err := wb.conn.WriteMultipleRegisters(reg, 2, b); err != nil { + return err + } + } + + return nil +} + +var _ api.MeterCurrent = (*Innogy)(nil) + +// Currents implements the api.MeterCurrent interface +func (wb *Innogy) Currents() (float64, float64, float64, error) { + var currents []float64 + for _, regCurrent := range igyRegCurrents { + b, err := wb.conn.ReadInputRegisters(regCurrent, 2) + if err != nil { + return 0, 0, 0, err + } + + currents = append(currents, float64(math.Float32frombits(binary.BigEndian.Uint32(b)))) + } + + return currents[0], currents[1], currents[2], nil +} + +var _ api.Diagnosis = (*Innogy)(nil) + +// Diagnose implements the Diagnosis interface +func (wb *Innogy) Diagnose() { + if b, err := wb.conn.ReadInputRegisters(igyRegManufacturer, 25); err == nil { + fmt.Printf("Manufacturer:\t%s\n", b) + } + if b, err := wb.conn.ReadInputRegisters(igyRegID, 25); err == nil { + fmt.Printf("Id:\t%s\n", b) + } + if b, err := wb.conn.ReadInputRegisters(igyRegSerial, 25); err == nil { + fmt.Printf("Serial:\t%s\n", b) + } + if b, err := wb.conn.ReadInputRegisters(igyRegProtocol, 25); err == nil { + fmt.Printf("Protocol:\t%s\n", b) + } + if b, err := wb.conn.ReadInputRegisters(igyRegFirmware, 25); err == nil { + fmt.Printf("Firmware:\t%s\n", b) + } +}