312 lines
9 KiB
Go
312 lines
9 KiB
Go
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/volkszaehler/mbmd/meters/rs485"
|
|
)
|
|
|
|
// Sungrow charger implementation
|
|
type Sungrow struct {
|
|
log *util.Logger
|
|
conn *modbus.Connection
|
|
curr uint16
|
|
enabled bool
|
|
}
|
|
|
|
const (
|
|
// input (read only)
|
|
sgRegPhase = 21224 // uint16 [1: Single-phase, 3: Three-phase]
|
|
sgRegWorkMode = 21262 // uint16 [0: Network, 2: Plug&Play, 6: EMS]
|
|
sgRegRemCtrlStatus = 21267 // uint16 [0: Disable, 1: Enable]
|
|
sgRegPhaseSwitchStatus = 21269 // uint16 [0: Three-phase, 1: Single-phase]
|
|
sgRegTotalEnergy = 21299 // uint32s 1Wh
|
|
sgRegActivePower = 21307 // uint32s 1W
|
|
sgRegChargedEnergy = 21309 // uint32s 1Wh
|
|
sgRegStartMode = 21313 // uint16 [1: Started by EMS, 2: Started by swiping card]
|
|
sgRegPowerRequest = 21314 // uint16 [0: Enable, 1: Close]
|
|
sgRegPowerFlag = 21315 // uint16 [0: Charging or power regulation is not allowed; 1: Charging or power regulation is allowed]
|
|
sgRegState = 21316 // uint16 [1: Idle, 2: Standby, 3: Charging, 4: Charging suspended (pile side), 5: Charging suspended (vehicle side), 6: Charging completed, 7: Reserved, 8: Unavailable, 9: Faulted]
|
|
|
|
// holding
|
|
sgRegSetOutI = 21202 // uint16 0.01A
|
|
sgRegPhaseSwitch = 21203 // uint16 [0: Three-phase, 1: Single-phase]
|
|
sgRegAvailability = 21210 // uint16 [0: Unavailable, 1: Available]
|
|
sgRegRemoteControl = 21211 // uint16 [0: Start, 1: Stop]
|
|
)
|
|
|
|
var (
|
|
sgRegVoltages = []uint16{21301, 21303, 21305} // uint16 0.1V
|
|
sgRegCurrents = []uint16{21302, 21304, 21306} // uint16 0.1A
|
|
)
|
|
|
|
func init() {
|
|
registry.AddCtx("sungrow", NewSungrowFromConfig)
|
|
}
|
|
|
|
// NewSungrowFromConfig creates a Sungrow charger from generic config
|
|
func NewSungrowFromConfig(ctx context.Context, other map[string]any) (api.Charger, error) {
|
|
cc := modbus.Settings{
|
|
ID: 248,
|
|
}
|
|
|
|
if err := util.DecodeOther(other, &cc); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return NewSungrow(ctx, cc.URI, cc.Device, cc.Comset, cc.Baudrate, cc.Protocol(), cc.ID)
|
|
}
|
|
|
|
// NewSungrow creates Sungrow charger
|
|
func NewSungrow(ctx context.Context, uri, device, comset string, baudrate int, proto modbus.Protocol, id uint8) (api.Charger, error) {
|
|
conn, err := modbus.NewConnection(ctx, uri, device, comset, baudrate, proto, id)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
log := util.NewLogger("sungrow")
|
|
conn.Logger(log.TRACE)
|
|
|
|
wb := &Sungrow{
|
|
log: log,
|
|
conn: conn,
|
|
curr: 60,
|
|
}
|
|
|
|
return wb, nil
|
|
}
|
|
|
|
// getPhaseValues returns 3 non-sequential register values
|
|
func (wb *Sungrow) getPhaseValues(regs []uint16, divider float64) (float64, float64, float64, error) {
|
|
var res [3]float64
|
|
for i, reg := range regs {
|
|
b, err := wb.conn.ReadInputRegisters(reg, 1)
|
|
if err != nil {
|
|
return 0, 0, 0, err
|
|
}
|
|
|
|
res[i] = rs485.RTUUint16ToFloat64(b) / divider
|
|
}
|
|
|
|
return res[0], res[1], res[2], nil
|
|
}
|
|
|
|
// Status implements the api.Charger interface
|
|
func (wb *Sungrow) Status() (api.ChargeStatus, error) {
|
|
b, err := wb.conn.ReadInputRegisters(sgRegState, 1)
|
|
if err != nil {
|
|
return api.StatusNone, err
|
|
}
|
|
|
|
switch s := binary.BigEndian.Uint16(b); s {
|
|
case 1: // Idle
|
|
return api.StatusA, nil
|
|
case 2: // Standby
|
|
return api.StatusB, nil
|
|
case 3: // Charging
|
|
wb.enabled = true
|
|
return api.StatusC, nil
|
|
case 4: // SuspendedEVSE
|
|
wb.enabled = false
|
|
return api.StatusB, nil
|
|
case 5: // SuspendedEV
|
|
wb.enabled = true
|
|
return api.StatusB, nil
|
|
case 6: // Completed
|
|
wb.enabled = false
|
|
return api.StatusB, nil
|
|
default:
|
|
return api.StatusNone, fmt.Errorf("invalid status: %d", s)
|
|
}
|
|
}
|
|
|
|
// Enabled implements the api.Charger interface
|
|
func (wb *Sungrow) Enabled() (bool, error) {
|
|
return wb.enabled, nil
|
|
}
|
|
|
|
// Enable implements the api.Charger interface
|
|
func (wb *Sungrow) Enable(enable bool) error {
|
|
var u uint16 = 1 // Stop
|
|
|
|
if enable {
|
|
u = 0 // Start
|
|
|
|
// Make sure the charger is available, otherwise sgRegRemoteControl is not usable
|
|
if _, err := wb.conn.WriteSingleRegister(sgRegAvailability, 1); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
if _, err := wb.conn.WriteSingleRegister(sgRegRemoteControl, u); err != nil {
|
|
return err
|
|
}
|
|
|
|
if enable {
|
|
if _, err := wb.conn.WriteSingleRegister(sgRegSetOutI, wb.curr); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
wb.enabled = enable
|
|
|
|
return nil
|
|
}
|
|
|
|
// MaxCurrent implements the api.Charger interface
|
|
func (wb *Sungrow) MaxCurrent(current int64) error {
|
|
return wb.MaxCurrentMillis(float64(current))
|
|
}
|
|
|
|
var _ api.ChargerEx = (*Sungrow)(nil)
|
|
|
|
// MaxCurrentMillis implements the api.ChargerEx interface
|
|
func (wb *Sungrow) MaxCurrentMillis(current float64) error {
|
|
if current < 6 {
|
|
return fmt.Errorf("invalid current %.1f", current)
|
|
}
|
|
|
|
curr := uint16(10 * current)
|
|
|
|
_, err := wb.conn.WriteSingleRegister(sgRegSetOutI, curr)
|
|
if err == nil {
|
|
wb.curr = curr
|
|
}
|
|
|
|
return err
|
|
}
|
|
|
|
var _ api.Meter = (*Sungrow)(nil)
|
|
|
|
// CurrentPower implements the api.Meter interface
|
|
func (wb *Sungrow) CurrentPower() (float64, error) {
|
|
b, err := wb.conn.ReadInputRegisters(sgRegActivePower, 2)
|
|
if err != nil {
|
|
return 0, err
|
|
}
|
|
|
|
return rs485.RTUUint32ToFloat64Swapped(b), nil
|
|
}
|
|
|
|
var _ api.PhaseCurrents = (*Sungrow)(nil)
|
|
|
|
// Currents implements the api.PhaseCurrents interface
|
|
func (wb *Sungrow) Currents() (float64, float64, float64, error) {
|
|
return wb.getPhaseValues(sgRegCurrents, 10)
|
|
}
|
|
|
|
var _ api.PhaseVoltages = (*Sungrow)(nil)
|
|
|
|
// Voltages implements the api.PhaseVoltages interface
|
|
func (wb *Sungrow) Voltages() (float64, float64, float64, error) {
|
|
return wb.getPhaseValues(sgRegVoltages, 10)
|
|
}
|
|
|
|
var _ api.MeterEnergy = (*Sungrow)(nil)
|
|
|
|
// TotalEnergy implements the api.MeterEnergy interface
|
|
func (wb *Sungrow) TotalEnergy() (float64, error) {
|
|
b, err := wb.conn.ReadInputRegisters(sgRegTotalEnergy, 2)
|
|
if err != nil {
|
|
return 0, err
|
|
}
|
|
|
|
return rs485.RTUUint32ToFloat64Swapped(b) / 1e3, nil
|
|
}
|
|
|
|
var _ api.PhaseSwitcher = (*Sungrow)(nil)
|
|
|
|
// Phases1p3p implements the api.PhaseSwitcher interface
|
|
func (wb *Sungrow) Phases1p3p(phases int) error {
|
|
var u uint16
|
|
|
|
if phases == 1 {
|
|
u = 1
|
|
}
|
|
|
|
return whenDisabled(wb, func() error {
|
|
// Switch phases
|
|
_, err := wb.conn.WriteSingleRegister(sgRegPhaseSwitch, u)
|
|
return err
|
|
})
|
|
}
|
|
|
|
var _ api.PhaseGetter = (*Sungrow)(nil)
|
|
|
|
// GetPhases implements the api.PhaseGetter interface
|
|
func (wb *Sungrow) GetPhases() (int, error) {
|
|
b, err := wb.conn.ReadInputRegisters(sgRegPhaseSwitchStatus, 1)
|
|
if err != nil {
|
|
return 0, err
|
|
}
|
|
|
|
if binary.BigEndian.Uint16(b) == 0 {
|
|
return 3, nil
|
|
}
|
|
|
|
return 1, nil
|
|
}
|
|
|
|
var _ api.Diagnosis = (*Sungrow)(nil)
|
|
|
|
// Diagnose implements the api.Diagnosis interface
|
|
func (wb *Sungrow) Diagnose() {
|
|
if b, err := wb.conn.ReadHoldingRegisters(sgRegSetOutI, 1); err == nil {
|
|
fmt.Printf("\tSetOutI:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadHoldingRegisters(sgRegPhaseSwitch, 1); err == nil {
|
|
fmt.Printf("\tPhaseSwitch:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadHoldingRegisters(sgRegAvailability, 1); err == nil {
|
|
fmt.Printf("\tAvailability:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadHoldingRegisters(sgRegRemoteControl, 1); err == nil {
|
|
fmt.Printf("\tRemoteControl:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegWorkMode, 1); err == nil {
|
|
fmt.Printf("\tWorkMode:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegPhase, 1); err == nil {
|
|
fmt.Printf("\tPhase:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegPhaseSwitchStatus, 1); err == nil {
|
|
fmt.Printf("\tPhasesState:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegStartMode, 1); err == nil {
|
|
fmt.Printf("\tStartMode:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegState, 1); err == nil {
|
|
fmt.Printf("\tState:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegRemCtrlStatus, 1); err == nil {
|
|
fmt.Printf("\tRemCtrlStatus:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegPowerRequest, 1); err == nil {
|
|
fmt.Printf("\tPowerRequest:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
if b, err := wb.conn.ReadInputRegisters(sgRegPowerFlag, 1); err == nil {
|
|
fmt.Printf("\tPowerFlag:\t%d\n", binary.BigEndian.Uint16(b))
|
|
}
|
|
}
|