package charger // LICENSE // Copyright (c) evcc.io (andig, naltatis, premultiply) // 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. // Supports all chargers based on Bender CC612/613 controller series // * The 'Modbus TCP Server for energy management systems' must be enabled. // * The setting 'Register Address Set' must NOT be set to 'Phoenix', 'TQ-DM100' or 'ISE/IGT Kassel'. // -> Use the third selection labeled 'Ebee', 'Bender', 'MENNEKES' etc. // * Set 'Allow UID Disclose' to On import ( "context" "encoding/binary" "fmt" "math" "strings" "time" "github.com/evcc-io/evcc/api" "github.com/evcc-io/evcc/api/implement" "github.com/evcc-io/evcc/charger/semp" "github.com/evcc-io/evcc/util" "github.com/evcc-io/evcc/util/modbus" "github.com/evcc-io/evcc/util/sponsor" ) type sempHandler struct { deviceID string conn *semp.Connection deviceG util.Cacheable[semp.Device2EM] phases int } // BenderCC charger implementation type BenderCC struct { implement.Caps conn *modbus.Connection current uint16 regCurr uint16 legacy bool log *util.Logger semp sempHandler } const ( // all holding type registers bendRegChargePointState = 122 // Vehicle (Control Pilot) state bendRegPhaseEnergy = 200 // Phase energy from primary meter (Wh) bendRegCurrents = 212 // Currents from primary meter (mA) bendRegTotalEnergy = 218 // Total Energy from primary meter (Wh) bendRegActivePower = 220 // Active Power from primary meter (W) bendRegVoltages = 222 // Voltages of the ocpp meter (V) bendRegUserID = 720 // User ID (OCPP IdTag) from the current session. Bytes 0 to 19. bendRegEVBatteryState = 730 // EV Battery State (% 0-100) bendRegEVCCID = 741 // ASCII representation of the Hex. Values corresponding to the EVCCID. Bytes 0 to 11. bendRegHemsCurrentLimit = 1000 // HEMS Current Limit (A). Only available on Mennekes Amtron 4You / 4Business chargers. bendRegHemsCurrentLimit10 = 1001 // HEMS Current Limit 1/10 (0.1 A). Only available on Mennekes Amtron 4You / 4Business chargers. bendRegHemsPowerLimit = 1002 // HEMS Power Limit (W). Only available on Mennekes Amtron 4You / 4Business chargers. bendRegFirmware = 100 // Application version number bendRegOcppCpStatus = 104 // Charge Point status according to the OCPP spec. enumaration bendRegProtocolVersion = 120 // Ebee Modbus TCP Server Protocol Version number bendRegRelayState = 140 // State of the internal relay (0: off, 1: 3 phases active 5: 1 phase active) bendRegChargePointModel = 142 // ChargePoint Model. Bytes 0 to 19. bendRegSmartVehicleDetected = 740 // Returns 1 if an EV currently connected is a smart vehicle, or 0 if no EV connected or it is not a smart vehicle // unused // bendRegChargedEnergyLegacy = 705 // Sum of charged energy for the current session (Wh) // bendRegChargingDurationLegacy = 709 // Duration since beginning of charge (Seconds) // bendRegChargedEnergy = 716 // Sum of charged energy for the current session (Wh) // bendRegChargingDuration = 718 // Duration since beginning of charge (Seconds) powerLimit1pMennekes uint16 = 3725 // 207V * 3p * 6A - 1W powerLimit3pMennekes uint16 = 0xffff ) func init() { registry.AddCtx("bender", NewBenderCCFromConfig) } // NewBenderCCFromConfig creates a BenderCC charger from generic config func NewBenderCCFromConfig(ctx context.Context, other map[string]any) (api.Charger, error) { cc := struct { modbus.TcpSettings `mapstructure:",squash"` Cache time.Duration }{ TcpSettings: modbus.TcpSettings{ ID: 255, // default }, Cache: 5 * time.Second, } if err := util.DecodeOther(other, &cc); err != nil { return nil, err } return NewBenderCC(ctx, cc.URI, cc.ID, cc.Cache) } // NewBenderCC creates BenderCC charger func NewBenderCC(ctx context.Context, uri string, id uint8, cache time.Duration) (api.Charger, error) { conn, err := modbus.NewConnection(ctx, uri, "", "", 0, modbus.Tcp, id) if err != nil { return nil, err } if !sponsor.IsAuthorized() { return nil, api.ErrSponsorRequired } log := util.NewLogger("bender") conn.Logger(log.TRACE) wb := &BenderCC{ Caps: implement.New(), conn: conn, current: 6, // assume min current regCurr: bendRegHemsCurrentLimit, log: log, } // check legacy register set if _, err := wb.conn.ReadHoldingRegisters(bendRegChargePointModel, 10); err != nil { wb.legacy = true } // check presence of metering reg := uint16(bendRegActivePower) if wb.legacy { reg = bendRegPhaseEnergy } if b, err := wb.conn.ReadHoldingRegisters(reg, 2); err == nil && binary.BigEndian.Uint32(b) != math.MaxUint32 { implement.Has(wb, implement.Meter(wb.currentPower)) implement.Has(wb, implement.PhaseCurrents(wb.currents)) implement.Has(wb, implement.MeterEnergy(wb.totalEnergy)) // check presence of "ocpp meter" if b, err := wb.conn.ReadHoldingRegisters(bendRegVoltages, 2); err == nil && binary.BigEndian.Uint32(b) > 0 { implement.Has(wb, implement.PhaseVoltages(wb.voltages)) } if !wb.legacy { if _, err := wb.conn.ReadHoldingRegisters(bendRegEVBatteryState, 1); err == nil { implement.Has(wb, implement.Battery(wb.soc)) } } } // check feature mA if _, err := wb.conn.ReadHoldingRegisters(bendRegHemsCurrentLimit10, 1); err == nil { implement.Has(wb, implement.ChargerEx(wb.maxCurrentMillis)) wb.regCurr = bendRegHemsCurrentLimit10 } // check feature modbus power control/1p3p for Mennekes 4you / 4business chargers if _, err := wb.conn.ReadHoldingRegisters(bendRegHemsPowerLimit, 1); err == nil { implement.Has(wb, implement.PhaseSwitcher(wb.phases1p3pMennekes)) implement.Has(wb, implement.PhaseGetter(wb.getPhasesMennekes)) } else { // check feature semp phase switching if wb.supportsSEMPPhaseSwitching(uri, cache) { // set initial SEMP power limit to max so modbus control from 6 to 16 A is possible if err := wb.semp.conn.SendDeviceControl(wb.semp.deviceID, 0xffff); err == nil { implement.Has(wb, implement.PhaseSwitcher(wb.phases1p3pSEMP)) implement.Has(wb, implement.PhaseGetter(wb.getPhases)) // start heartbeat to keep connection alive go wb.heartbeat(ctx) } else { log.ERROR.Println("SEMP phase switching: could not set initial SEMP power limit:", err) } } } // check feature rfid if _, err := wb.identify(); err == nil { implement.Has(wb, implement.Identifier(wb.identify)) } return wb, nil } // heartbeat ensures that SEMP device control updates are sent about once per minute func (wb *BenderCC) heartbeat(ctx context.Context) { for tick := time.Tick(5 * time.Second); ; { select { case <-tick: case <-ctx.Done(): return } if time.Since(wb.semp.conn.Updated()) >= time.Minute { // Send a very high power value to allow full control between 6 and 16A via modbus // Note: This will not trigger a phase switch, as the value is above the max. power consumption if err := wb.semp.conn.SendDeviceControl(wb.semp.deviceID, 0xffff); err != nil { wb.log.ERROR.Printf("heartbeat: failed to send update: %v", err) } } } } // supportsSEMPPhaseSwitching checks if SEMP phase switching is supported by querying device info func (wb *BenderCC) supportsSEMPPhaseSwitching(uri string, cache time.Duration) bool { wb.semp.conn = semp.NewConnection(wb.log, "http://"+strings.Split(uri, ":")[0]+":8888/SimpleEnergyManagementProtocol") wb.semp.deviceG = util.ResettableCached(func() (semp.Device2EM, error) { return wb.semp.conn.GetDeviceXML() }, cache) doc, err := wb.semp.deviceG.Get() if err != nil { wb.log.DEBUG.Println("SEMP phase switching: cannot get XML", err) return false } if len(doc.DeviceInfo) == 0 { wb.log.DEBUG.Println("SEMP phase switching: no devices found") return false } // Use first device ID found wb.semp.deviceID = doc.DeviceInfo[0].Identification.DeviceID wb.log.DEBUG.Printf("SEMP phase switching: found device ID: %s", wb.semp.deviceID) // Check if device supports phase switching by checking power characteristics info, err := wb.getDeviceInfo() if err != nil { wb.log.DEBUG.Println("SEMP phase switching: cannot get device info:", err) return false } // Assume Phase switching support if MinPowerConsumption < 4140W and MaxPowerConsumption > 4600W if info.Characteristics.MinPowerConsumption > 0 && info.Characteristics.MinPowerConsumption < 4140 && info.Characteristics.MaxPowerConsumption > 4600 { return true } wb.log.DEBUG.Println("SEMP phase switching: not supported") return false } // getDeviceInfo retrieves device info from cached document func (wb *BenderCC) getDeviceInfo() (semp.DeviceInfo, error) { doc, err := wb.semp.deviceG.Get() if err != nil { return semp.DeviceInfo{}, err } for _, info := range doc.DeviceInfo { if info.Identification.DeviceID == wb.semp.deviceID { return info, nil } } return semp.DeviceInfo{}, fmt.Errorf("device %s not found in info response", wb.semp.deviceID) } // Status implements the api.Charger interface func (wb *BenderCC) Status() (api.ChargeStatus, error) { b, err := wb.conn.ReadHoldingRegisters(bendRegChargePointState, 1) if err != nil { return api.StatusNone, err } switch s := binary.BigEndian.Uint16(b); s { case 1: return api.StatusA, nil case 2: return api.StatusB, nil case 3, 4: return api.StatusC, nil default: return api.StatusNone, fmt.Errorf("invalid status: %d", s) } } // Enabled implements the api.Charger interface func (wb *BenderCC) Enabled() (bool, error) { b, err := wb.conn.ReadHoldingRegisters(wb.regCurr, 1) if err != nil { return false, err } return binary.BigEndian.Uint16(b) != 0, nil } // Enable implements the api.Charger interface func (wb *BenderCC) Enable(enable bool) error { b := make([]byte, 2) if enable { binary.BigEndian.PutUint16(b, wb.current) } _, err := wb.conn.WriteMultipleRegisters(wb.regCurr, 1, b) return err } // MaxCurrent implements the api.Charger interface func (wb *BenderCC) MaxCurrent(current int64) error { if current < 6 { return fmt.Errorf("invalid current %d", current) } b := make([]byte, 2) binary.BigEndian.PutUint16(b, uint16(current)) _, err := wb.conn.WriteMultipleRegisters(bendRegHemsCurrentLimit, 1, b) if err == nil { wb.current = uint16(current) } return err } // maxCurrentMillis implements the api.ChargerEx interface (Wallbe Firmware only) func (wb *BenderCC) maxCurrentMillis(current float64) error { if current < 6 { return fmt.Errorf("invalid current %.5g", current) } curr := uint16(current * 10) // 0.1A Steps b := make([]byte, 2) binary.BigEndian.PutUint16(b, curr) _, err := wb.conn.WriteMultipleRegisters(bendRegHemsCurrentLimit10, 1, b) if err == nil { wb.current = curr } return err } // removed: https://github.com/evcc-io/evcc/issues/13555 // var _ api.ChargeTimer = (*BenderCC)(nil) // CurrentPower implements the api.Meter interface func (wb *BenderCC) currentPower() (float64, error) { if wb.legacy { l1, l2, l3, err := wb.currents() return 230 * (l1 + l2 + l3), err } b, err := wb.conn.ReadHoldingRegisters(bendRegActivePower, 2) if err != nil { return 0, err } u := binary.BigEndian.Uint32(b) // some Bender chargers temporarily return 0xffffffff // return error in this case to trigger retry and avoid wrong power readings // https://github.com/evcc-io/evcc/discussions/27736 if u == math.MaxUint32 { return 0, api.ErrMustRetry } return float64(u), nil } // removed: https://github.com/evcc-io/evcc/issues/13726 // var _ api.ChargeRater = (*BenderCC)(nil) // TotalEnergy implements the api.MeterEnergy interface func (wb *BenderCC) totalEnergy() (float64, error) { if wb.legacy { b, err := wb.conn.ReadHoldingRegisters(bendRegPhaseEnergy, 6) if err != nil { return 0, err } var total float64 for l := range 3 { total += float64(binary.BigEndian.Uint32(b[4*l:4*(l+1)])) / 1e3 } return total, nil } b, err := wb.conn.ReadHoldingRegisters(bendRegTotalEnergy, 2) if err != nil { return 0, err } return float64(binary.BigEndian.Uint32(b)) / 1e3, nil } // getPhaseValues returns 3 sequential register values func (wb *BenderCC) getPhaseValues(reg uint16, divider float64) (float64, float64, float64, error) { b, err := wb.conn.ReadHoldingRegisters(reg, 6) if err != nil { return 0, 0, 0, err } var res [3]float64 for i := range res { u32 := binary.BigEndian.Uint32(b[4*i:]) if u32 == math.MaxUint32 { u32 = 0 } res[i] = float64(u32) / divider } return res[0], res[1], res[2], nil } // currents implements the api.PhaseCurrents interface func (wb *BenderCC) currents() (float64, float64, float64, error) { return wb.getPhaseValues(bendRegCurrents, 1e3) } // voltages implements the api.PhaseVoltages interface func (wb *BenderCC) voltages() (float64, float64, float64, error) { return wb.getPhaseValues(bendRegVoltages, 1) } // phases1p3pMennekes implements the api.PhaseSwitcher interface for Mennekes AMTRON 4You / 4Business chargers func (wb *BenderCC) phases1p3pMennekes(phases int) error { b := make([]byte, 2) binary.BigEndian.PutUint16(b, powerLimit3pMennekes) if phases == 1 { binary.BigEndian.PutUint16(b, powerLimit1pMennekes) } _, err := wb.conn.WriteMultipleRegisters(bendRegHemsPowerLimit, 1, b) return err } // getPhases implements the api.PhaseGetter interface for Mennekes AMTRON 4You / 4Business chargers func (wb *BenderCC) getPhasesMennekes() (int, error) { b, err := wb.conn.ReadHoldingRegisters(bendRegHemsPowerLimit, 1) if err != nil { return 0, err } if binary.BigEndian.Uint16(b) <= powerLimit1pMennekes { return 1, nil } return 3, nil } // phases1p3pSEMP implements the api.PhaseSwitcher interface via SEMP func (wb *BenderCC) phases1p3pSEMP(phases int) error { // to switch to 3 phases, we have to uese a power value that is reachable with 3 phases // between 207 and 253V, but never with just 1 phase phaseSwitchPower := 9936 // 207V * 3p * 16A if phases == 1 { // to switch to 1 phase, we have to use a power value that is reachable with 1 phase // between 207 and 253V, but never with 3 phases phaseSwitchPower = 1518 // 253 * 1p * 6A } if err := wb.semp.conn.SendDeviceControl(wb.semp.deviceID, phaseSwitchPower); err != nil { return err } wb.semp.phases = phases wb.semp.deviceG.Reset() return nil } // getPhases implements the api.PhaseGetter interface for semp phase switching by reading the relay state through modbus func (wb *BenderCC) getPhases() (int, error) { // check relay register b, err := wb.conn.ReadHoldingRegisters(bendRegRelayState, 1) if err != nil { return 0, err } if binary.BigEndian.Uint16(b) == 5 { return 1, nil } if binary.BigEndian.Uint16(b) == 1 { return 3, nil } return wb.semp.phases, nil } // identify implements the api.Identifier interface func (wb *BenderCC) identify() (string, error) { if !wb.legacy { b, err := wb.conn.ReadHoldingRegisters(bendRegSmartVehicleDetected, 1) if err == nil && binary.BigEndian.Uint16(b) != 0 { b, err = wb.conn.ReadHoldingRegisters(bendRegEVCCID, 6) } if id := bytesAsString(b); id != "" || err != nil { return id, err } } b, err := wb.conn.ReadHoldingRegisters(bendRegUserID, 10) if err != nil { return "", err } return bytesAsString(b), nil } // soc implements the api.Battery interface func (wb *BenderCC) soc() (float64, error) { b, err := wb.conn.ReadHoldingRegisters(bendRegSmartVehicleDetected, 1) if err != nil { return 0, err } if binary.BigEndian.Uint16(b) == 1 { b, err = wb.conn.ReadHoldingRegisters(bendRegEVBatteryState, 1) if err != nil { return 0, err } if soc := binary.BigEndian.Uint16(b); soc <= 100 { return float64(soc), nil } } return 0, api.ErrNotAvailable } var _ api.Diagnosis = (*BenderCC)(nil) // Diagnose implements the api.Diagnosis interface func (wb *BenderCC) Diagnose() { fmt.Printf("\tLegacy:\t\t%t\n", wb.legacy) if !wb.legacy { if b, err := wb.conn.ReadHoldingRegisters(bendRegChargePointModel, 10); err == nil { fmt.Printf("\tModel:\t%s\n", b) } } if b, err := wb.conn.ReadHoldingRegisters(bendRegFirmware, 2); err == nil { fmt.Printf("\tFirmware:\t%s\n", b) } if b, err := wb.conn.ReadHoldingRegisters(bendRegProtocolVersion, 2); err == nil { fmt.Printf("\tProtocol:\t%s\n", b) } if b, err := wb.conn.ReadHoldingRegisters(bendRegOcppCpStatus, 1); err == nil { fmt.Printf("\tOCPP Status:\t%d\n", binary.BigEndian.Uint16(b)) } if !wb.legacy { if b, err := wb.conn.ReadHoldingRegisters(bendRegSmartVehicleDetected, 1); err == nil { fmt.Printf("\tSmart Vehicle:\t%t\n", binary.BigEndian.Uint16(b) != 0) } } if b, err := wb.conn.ReadHoldingRegisters(bendRegEVCCID, 6); err == nil { fmt.Printf("\tEVCCID:\t%s\n", b) } if b, err := wb.conn.ReadHoldingRegisters(bendRegUserID, 10); err == nil { fmt.Printf("\tUserID:\t%s\n", b) } if b, err := wb.conn.ReadHoldingRegisters(wb.regCurr, 1); err == nil { fmt.Printf("\tCurrent Limit:\t%d\n", binary.BigEndian.Uint16(b)) } }