evcc-io/vehicle/renault/provider.go

package renault

import (
	"errors"
	"net/http"
	"slices"
	"strings"
	"time"

	"github.com/evcc-io/evcc/api"
	"github.com/evcc-io/evcc/util"
	"github.com/evcc-io/evcc/util/request"
	"github.com/evcc-io/evcc/vehicle/renault/kamereon"
)

// Provider is an api.Vehicle implementation for PSA cars
type Provider struct {
	batteryG func() (kamereon.Response, error)
	cockpitG func() (kamereon.Response, error)
	hvacG    func() (kamereon.Response, error)
	wakeup   func() (kamereon.Response, error)
	position func() (kamereon.Response, error)
	action   func(action string) (kamereon.Response, error)
}

// NewProvider creates a vehicle api provider
func NewProvider(api *kamereon.API, accountID, vin string, wakeupMode string, cache time.Duration) *Provider {
	impl := &Provider{
		batteryG: util.Cached(func() (kamereon.Response, error) {
			return api.Battery(accountID, vin)
		}, cache),
		cockpitG: util.Cached(func() (kamereon.Response, error) {
			return api.Cockpit(accountID, vin)
		}, cache),
		hvacG: util.Cached(func() (kamereon.Response, error) {
			return api.Hvac(accountID, vin)
		}, cache),
		wakeup: func() (kamereon.Response, error) {
			switch wakeupMode {
			case "alternative":
				return api.Action(accountID, kamereon.ActionStart, vin)
			case "MY24":
				return api.WakeUpMY24(accountID, vin)
			default:
				return api.WakeUp(accountID, vin)
			}
		},
		position: func() (kamereon.Response, error) {
			return api.Position(accountID, vin)
		},
		action: func(action string) (kamereon.Response, error) {
			return api.Action(accountID, action, vin)
		},
	}
	return impl
}

var _ api.Battery = (*Provider)(nil)

// Soc implements the api.Vehicle interface
func (v *Provider) Soc() (float64, error) {
	res, err := v.batteryG()
	if err != nil {
		return 0, err
	}

	if res.Data.Attributes.BatteryLevel == nil {
		return 0, api.ErrNotAvailable
	}

	return float64(*res.Data.Attributes.BatteryLevel), nil
}

var _ api.ChargeState = (*Provider)(nil)

// Status implements the api.ChargeState interface
func (v *Provider) Status() (api.ChargeStatus, error) {
	status := api.StatusA // disconnected

	res, err := v.batteryG()
	if err == nil {
		if res.Data.Attributes.PlugStatus == 1 {
			status = api.StatusB
		}
		if res.Data.Attributes.ChargingStatus >= 1.0 {
			status = api.StatusC
		}
	}

	return status, err
}

var _ api.VehicleRange = (*Provider)(nil)

// Range implements the api.VehicleRange interface
func (v *Provider) Range() (int64, error) {
	res, err := v.batteryG()

	if err == nil {
		return int64(res.Data.Attributes.BatteryAutonomy), nil
	}

	return 0, err
}

var _ api.VehicleOdometer = (*Provider)(nil)

// Odometer implements the api.VehicleOdometer interface
func (v *Provider) Odometer() (float64, error) {
	res, err := v.cockpitG()
	if err != nil {
		return 0, err
	}

	if res.Data.Attributes.TotalMileage != nil {
		return *res.Data.Attributes.TotalMileage, nil
	}

	return 0, api.ErrNotAvailable
}

var _ api.VehicleFinishTimer = (*Provider)(nil)

// FinishTime implements the api.VehicleFinishTimer interface
func (v *Provider) FinishTime() (time.Time, error) {
	res, err := v.batteryG()

	if err == nil {
		timestamp, err := time.Parse(time.RFC3339, res.Data.Attributes.Timestamp)

		if res.Data.Attributes.RemainingTime == nil {
			return time.Time{}, api.ErrNotAvailable
		}

		return timestamp.Add(time.Duration(*res.Data.Attributes.RemainingTime) * time.Minute), err
	}

	return time.Time{}, err
}

var _ api.VehicleClimater = (*Provider)(nil)

// Climater implements the api.VehicleClimater interface
func (v *Provider) Climater() (bool, error) {
	res, err := v.hvacG()

	// Zoe Ph2, Megane e-tech
	if se := new(request.StatusError); errors.As(err, &se) && se.HasStatus(http.StatusForbidden, http.StatusNotFound, http.StatusBadGateway) {
		return false, api.ErrNotAvailable
	}

	if err == nil {
		state := strings.ToLower(res.Data.Attributes.HvacStatus)
		if state == "" {
			return false, api.ErrNotAvailable
		}

		active := !slices.Contains([]string{"off", "false", "invalid", "error", "unavailable"}, state)
		return active, nil
	}

	return false, err
}

var _ api.Resurrector = (*Provider)(nil)

// WakeUp implements the api.Resurrector interface
func (v *Provider) WakeUp() error {
	_, err := v.wakeup()
	return err
}

var _ api.VehiclePosition = (*Provider)(nil)

// Position implements the api.VehiclePosition interface
func (v *Provider) Position() (float64, float64, error) {
	res, err := v.position()
	if err == nil {
		return res.Data.Attributes.Latitude, res.Data.Attributes.Longitude, nil
	}

	return 0, 0, err
}

var _ api.ChargeController = (*Provider)(nil)

// ChargeEnable implements the api.ChargeController interface
func (v *Provider) ChargeEnable(enable bool) error {
	action := map[bool]string{true: kamereon.ActionStart, false: kamereon.ActionStop}
	_, err := v.action(action[enable])
	return err
}