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. import ( "context" "encoding/binary" "fmt" "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" ) // KSE charger implementation type KSE struct { log *util.Logger conn *modbus.Connection curr uint16 hasRfid bool has1p3p bool } const ( kseRegSetMaxCurrent = 0x03 // Externe Stromvorgabe via Bussystem / Ladefreigabe kseRegChargeMode = 0x0E // Lademodus kseRegVehicleState = 0x10 // State der Statemachine kseRegVoltages = 0x11 // Phasenspannung (3) kseRegCurrents = 0x14 // Phasenstrom (3) kseRegCurrentLoadedEnergy = 0x17 // Zwischen anstecken und abstecken geladene Energie (10 Wh) kseRegActualPower = 0x18 // Aktuelle Ladeleistung (W) kseRegFirmwareVersion = 0x30 // Firmware Version kseRegRFIDinstalled = 0x31 // RFID-Leser vorhanden kseRegRelayMode = 0x35 // Umschalten 1 phasiges oder 3 phasiges Laden kseRegEnergy = 0x60 kseRegNFCTransactionID = 0x67 // Tag ID (8 Bytes) ) func init() { registry.AddCtx("kse", NewKSEFromConfig) } // NewKSEFromConfig creates a KSE charger from generic config func NewKSEFromConfig(ctx context.Context, other map[string]interface{}) (api.Charger, error) { cc := modbus.Settings{ ID: 100, Baudrate: 9600, Comset: "8E1", } if err := util.DecodeOther(other, &cc); err != nil { return nil, err } return NewKSE(ctx, cc.URI, cc.Device, cc.Comset, cc.Baudrate, cc.ID) } //go:generate go tool decorate -f decorateKSE -b *KSE -r api.Charger -t "api.PhaseSwitcher,Phases1p3p,func(int) error" -t "api.PhaseGetter,GetPhases,func() (int, error)" -t "api.Identifier,Identify,func() (string, error)" // NewKSE creates KSE charger func NewKSE(ctx context.Context, uri, device, comset string, baudrate int, slaveID uint8) (api.Charger, error) { conn, err := modbus.NewConnection(ctx, uri, device, comset, baudrate, modbus.Rtu, slaveID) if err != nil { return nil, err } if !sponsor.IsAuthorized() { return nil, api.ErrSponsorRequired } log := util.NewLogger("kse") conn.Logger(log.TRACE) wb := &KSE{ log: log, conn: conn, curr: 6, // assume min current } var ( phases1p3p func(int) error getPhases func() (int, error) identify func() (string, error) ) // check presence of 1p3p switching if b, err := wb.conn.ReadInputRegisters(kseRegFirmwareVersion, 1); err == nil && b[0] >= 0x52 { // >= HW Rev „R“ wb.has1p3p = true phases1p3p = wb.phases1p3p getPhases = wb.getPhases } // check presence of rfid if b, err := wb.conn.ReadDiscreteInputs(kseRegRFIDinstalled, 1); err == nil && b[0] != 0 { wb.hasRfid = true identify = wb.identify } return decorateKSE(wb, phases1p3p, getPhases, identify), nil } // Status implements the api.Charger interface func (wb *KSE) Status() (api.ChargeStatus, error) { b, err := wb.conn.ReadInputRegisters(kseRegVehicleState, 1) if err != nil { return api.StatusNone, err } switch status := binary.BigEndian.Uint16(b); status { case 0, 1, 3: return api.StatusA, nil case 4: return api.StatusB, nil case 5: return api.StatusC, nil default: return api.StatusNone, fmt.Errorf("invalid status: %d", status) } } // Enabled implements the api.Charger interface func (wb *KSE) Enabled() (bool, error) { b, err := wb.conn.ReadHoldingRegisters(kseRegSetMaxCurrent, 1) if err != nil { return false, err } cur := binary.BigEndian.Uint16(b) return cur != 0, nil } // Enable implements the api.Charger interface func (wb *KSE) Enable(enable bool) error { var u uint16 if enable { u = wb.curr } _, err := wb.conn.WriteSingleRegister(kseRegSetMaxCurrent, u) return err } // MaxCurrent implements the api.Charger interface func (wb *KSE) MaxCurrent(current int64) error { if current < 6 { return fmt.Errorf("invalid current %d", current) } _, err := wb.conn.WriteSingleRegister(kseRegSetMaxCurrent, uint16(current)) if err == nil { wb.curr = uint16(current) } return err } var _ api.Meter = (*KSE)(nil) // CurrentPower implements the api.Meter interface func (wb *KSE) CurrentPower() (float64, error) { b, err := wb.conn.ReadInputRegisters(kseRegActualPower, 1) if err != nil { return 0, err } return float64(binary.BigEndian.Uint16(b)), err } var _ api.ChargeRater = (*KSE)(nil) // ChargedEnergy implements the api.MeterEnergy interface func (wb *KSE) ChargedEnergy() (float64, error) { b, err := wb.conn.ReadInputRegisters(kseRegCurrentLoadedEnergy, 1) if err != nil { return 0, err } return float64(binary.BigEndian.Uint16(b)) / 100, err } var _ api.MeterEnergy = (*KSE)(nil) // TotalEnergy implements the api.MeterEnergy interface func (wb *KSE) TotalEnergy() (float64, error) { b, err := wb.conn.ReadInputRegisters(kseRegEnergy, 2) if err != nil { return 0, err } return float64(binary.BigEndian.Uint32(b)) / 1e3, nil } var _ api.PhaseVoltages = (*KSE)(nil) // Voltages implements the api.PhaseVoltages interface func (wb *KSE) Voltages() (float64, float64, float64, error) { b, err := wb.conn.ReadInputRegisters(kseRegVoltages, 3) if err != nil { return 0, 0, 0, err } var res [3]float64 for i := range res { res[i] = float64(binary.BigEndian.Uint16(b[2*i:])) } return res[0], res[1], res[2], nil } var _ api.PhaseCurrents = (*KSE)(nil) // Currents implements the api.PhaseCurrents interface func (wb *KSE) Currents() (float64, float64, float64, error) { b, err := wb.conn.ReadInputRegisters(kseRegCurrents, 3) if err != nil { return 0, 0, 0, err } var res [3]float64 for i := range res { res[i] = float64(binary.BigEndian.Uint16(b[2*i:])) / 1e3 } return res[0], res[1], res[2], nil } // phases1p3p implements the api.PhaseSwitcher interface func (wb *KSE) phases1p3p(phases int) error { var b uint16 = 0 // 3p if phases == 1 { b = 1 // 1p } _, err := wb.conn.WriteSingleRegister(kseRegRelayMode, b) return err } // getPhases implements the api.PhaseGetter interface func (wb *KSE) getPhases() (int, error) { b, err := wb.conn.ReadHoldingRegisters(kseRegRelayMode, 1) if err != nil { return 0, err } if binary.BigEndian.Uint16(b) == 0 { return 3, nil } return 1, nil } // Identify implements the api.Identifier interface func (wb *KSE) identify() (string, error) { b, err := wb.conn.ReadHoldingRegisters(kseRegNFCTransactionID, 4) if err != nil { return "", err } return bytesAsString(b), nil } var _ api.Diagnosis = (*KSE)(nil) // Diagnose implements the api.Diagnosis interface func (wb *KSE) Diagnose() { if b, err := wb.conn.ReadInputRegisters(kseRegFirmwareVersion, 1); err == nil { fmt.Printf("\tFirmware:\t%x\n", b) } if b, err := wb.conn.ReadInputRegisters(kseRegChargeMode, 1); err == nil { fmt.Printf("\tCharge Mode:\t%d\n", binary.BigEndian.Uint16(b)) } if b, err := wb.conn.ReadInputRegisters(kseRegVehicleState, 1); err == nil { fmt.Printf("\tState:\t%d\n", binary.BigEndian.Uint16(b)) } if wb.has1p3p { if b, err := wb.conn.ReadHoldingRegisters(kseRegRelayMode, 1); err == nil { fmt.Printf("\tPhases:\t%d\n", binary.BigEndian.Uint16(b)) } } if wb.hasRfid { if b, err := wb.conn.ReadHoldingRegisters(kseRegNFCTransactionID, 4); err == nil { fmt.Printf("\tNFC ID:\t%s\n", b) } } }