evcc-io/vehicle/renault.go
Markus Thierolf 7c4f16e204
Some checks failed
Release / call-build-workflow (push) Has been cancelled
Release / Publish Docker :release (push) Has been cancelled
Release / Publish Github & APT release (push) Has been cancelled
Renault: use fixed api keys if keyStore is not accessible (#3406)
2022-05-19 09:12:01 +02:00

496 lines
12 KiB
Go

package vehicle
import (
"errors"
"fmt"
"io"
"net/http"
"net/url"
"strings"
"time"
"github.com/evcc-io/evcc/api"
"github.com/evcc-io/evcc/provider"
"github.com/evcc-io/evcc/util"
"github.com/evcc-io/evcc/util/request"
"golang.org/x/exp/slices"
)
// Credits to
// https://github.com/hacf-fr/renault-api
// https://github.com/edent/Renault-Zoe-API/issues/18
// https://github.com/epenet/Renault-Zoe-API/blob/newapimockup/Test/MyRenault.py
// https://github.com/jamesremuscat/pyze
// https://muscatoxblog.blogspot.com/2019/07/delving-into-renaults-new-api.html
const (
keyStore = "https://renault-wrd-prod-1-euw1-myrapp-one.s3-eu-west-1.amazonaws.com/configuration/android/config_%s.json"
)
type configResponse struct {
Servers configServers
}
type configServers struct {
GigyaProd configServer `json:"gigyaProd"`
WiredProd configServer `json:"wiredProd"`
}
type configServer struct {
Target string `json:"target"`
APIKey string `json:"apikey"`
}
type gigyaResponse struct {
ErrorCode int `json:"errorCode"` // /accounts.login
ErrorMessage string `json:"errorMessage"` // /accounts.login
SessionInfo gigyaSessionInfo `json:"sessionInfo"` // /accounts.login
IDToken string `json:"id_token"` // /accounts.getJWT
Data gigyaData `json:"data"` // /accounts.getAccountInfo
}
type gigyaSessionInfo struct {
CookieValue string `json:"cookieValue"`
}
type gigyaData struct {
PersonID string `json:"personId"`
}
type kamereonResponse struct {
Accounts []kamereonAccount `json:"accounts"` // /commerce/v1/persons/%s
AccessToken string `json:"accessToken"` // /commerce/v1/accounts/%s/kamereon/token
VehicleLinks []kamereonVehicle `json:"vehicleLinks"` // /commerce/v1/accounts/%s/vehicles
Data kamereonData `json:"data"` // /commerce/v1/accounts/%s/kamereon/kca/car-adapter/vX/cars/%s/...
}
type kamereonAccount struct {
AccountID string `json:"accountId"`
}
type kamereonVehicle struct {
Brand string `json:"brand"`
VIN string `json:"vin"`
Status string `json:"status"`
}
type kamereonData struct {
Attributes attributes `json:"attributes"`
}
type attributes struct {
// battery-status
Timestamp string `json:"timestamp"`
ChargingStatus float32 `json:"chargingStatus"`
InstantaneousPower int `json:"instantaneousPower"`
RangeHvacOff int `json:"rangeHvacOff"`
BatteryAutonomy int `json:"batteryAutonomy"`
BatteryLevel int `json:"batteryLevel"`
BatteryTemperature int `json:"batteryTemperature"`
PlugStatus int `json:"plugStatus"`
LastUpdateTime string `json:"lastUpdateTime"`
ChargePower int `json:"chargePower"`
RemainingTime *int `json:"chargingRemainingTime"`
// hvac-status
ExternalTemperature float64 `json:"externalTemperature"`
HvacStatus string `json:"hvacStatus"`
// cockpit
TotalMileage float64 `json:"totalMileage"`
}
// Renault is an api.Vehicle implementation for Renault cars
type Renault struct {
*embed
*request.Helper
user, password, vin string
gigya, kamereon configServer
gigyaJwtToken string
accountID string
batteryG func() (kamereonResponse, error)
cockpitG func() (kamereonResponse, error)
hvacG func() (kamereonResponse, error)
}
func init() {
registry.Add("dacia", NewRenaultFromConfig)
registry.Add("renault", NewRenaultFromConfig)
}
// NewRenaultFromConfig creates a new vehicle
func NewRenaultFromConfig(other map[string]interface{}) (api.Vehicle, error) {
cc := struct {
embed `mapstructure:",squash"`
User, Password, Region, VIN string
Cache time.Duration
}{
Region: "de_DE",
Cache: interval,
}
if err := util.DecodeOther(other, &cc); err != nil {
return nil, err
}
log := util.NewLogger("renault").Redact(cc.User, cc.Password, cc.VIN)
v := &Renault{
embed: &cc.embed,
Helper: request.NewHelper(log),
user: cc.User,
password: cc.Password,
}
err := v.apiKeys(cc.Region)
if err == nil {
err = v.authFlow()
}
if err == nil {
v.vin, err = ensureVehicle(cc.VIN, func() ([]string, error) {
return v.kamereonVehicles(v.accountID)
})
}
v.batteryG = provider.Cached(v.batteryAPI, cc.Cache)
v.cockpitG = provider.Cached(v.cockpitAPI, cc.Cache)
v.hvacG = provider.Cached(v.hvacAPI, cc.Cache)
return v, err
}
func (v *Renault) apiKeys(region string) error {
uri := fmt.Sprintf(keyStore, region)
var cr configResponse
err := v.GetJSON(uri, &cr)
if err != nil {
// Use of old fixed keys if keyStore is not accessible
v.gigya = configServer{"https://accounts.eu1.gigya.com", "3_7PLksOyBRkHv126x5WhHb-5pqC1qFR8pQjxSeLB6nhAnPERTUlwnYoznHSxwX668"}
v.kamereon = configServer{"https://api-wired-prod-1-euw1.wrd-aws.com", "VAX7XYKGfa92yMvXculCkEFyfZbuM7Ss"}
return nil
} else {
v.gigya = cr.Servers.GigyaProd
v.kamereon = cr.Servers.WiredProd
return err
}
}
func (v *Renault) authFlow() error {
sessionCookie, err := v.sessionCookie(v.user, v.password)
if err == nil {
v.gigyaJwtToken, err = v.jwtToken(sessionCookie)
if err == nil {
if v.accountID != "" {
// personID, accountID and VIN have already been read, skip remainder of flow
return nil
}
var personID string
personID, err = v.personID(sessionCookie)
if personID == "" {
return errors.New("missing personID")
}
if err == nil {
v.accountID, err = v.kamereonPerson(personID)
if v.accountID == "" {
return errors.New("missing accountID")
}
}
}
}
return err
}
func (v *Renault) request(uri string, params url.Values, body io.Reader, headers ...map[string]string) (*http.Request, error) {
method := http.MethodGet
if body != nil {
method = http.MethodPost
}
req, err := request.New(method, uri, body, headers...)
if err == nil {
req.URL.RawQuery = params.Encode()
}
return req, err
}
func (v *Renault) sessionCookie(user, password string) (string, error) {
uri := fmt.Sprintf("%s/accounts.login", v.gigya.Target)
data := url.Values{
"loginID": []string{user},
"password": []string{password},
"apiKey": []string{v.gigya.APIKey},
}
req, err := v.request(uri, data, nil)
var res gigyaResponse
if err == nil {
err = v.DoJSON(req, &res)
if err == nil && res.ErrorCode > 0 {
err = errors.New(res.ErrorMessage)
}
}
return res.SessionInfo.CookieValue, err
}
func (v *Renault) personID(sessionCookie string) (string, error) {
uri := fmt.Sprintf("%s/accounts.getAccountInfo", v.gigya.Target)
data := url.Values{
"apiKey": []string{v.gigya.APIKey},
"login_token": []string{sessionCookie},
}
req, err := v.request(uri, data, nil)
var res gigyaResponse
if err == nil {
err = v.DoJSON(req, &res)
}
return res.Data.PersonID, err
}
func (v *Renault) jwtToken(sessionCookie string) (string, error) {
uri := fmt.Sprintf("%s/accounts.getJWT", v.gigya.Target)
data := url.Values{
"apiKey": []string{v.gigya.APIKey},
"login_token": []string{sessionCookie},
"fields": []string{"data.personId,data.gigyaDataCenter"},
"expiration": []string{"900"},
}
req, err := v.request(uri, data, nil)
var res gigyaResponse
if err == nil {
err = v.DoJSON(req, &res)
}
return res.IDToken, err
}
func (v *Renault) kamereonRequest(uri string, body io.Reader) (kamereonResponse, error) {
params := url.Values{"country": []string{"DE"}}
headers := map[string]string{
"x-gigya-id_token": v.gigyaJwtToken,
"apikey": v.kamereon.APIKey,
}
var res kamereonResponse
req, err := v.request(uri, params, body, headers)
if err == nil {
err = v.DoJSON(req, &res)
}
return res, err
}
func (v *Renault) kamereonPerson(personID string) (string, error) {
uri := fmt.Sprintf("%s/commerce/v1/persons/%s", v.kamereon.Target, personID)
res, err := v.kamereonRequest(uri, nil)
if len(res.Accounts) == 0 {
return "", err
}
return res.Accounts[0].AccountID, err
}
func (v *Renault) kamereonVehicles(accountID string) ([]string, error) {
uri := fmt.Sprintf("%s/commerce/v1/accounts/%s/vehicles", v.kamereon.Target, accountID)
res, err := v.kamereonRequest(uri, nil)
var vehicles []string
if err == nil {
for _, v := range res.VehicleLinks {
if strings.ToUpper(v.Status) == "ACTIVE" {
vehicles = append(vehicles, v.VIN)
}
}
}
return vehicles, err
}
// batteryAPI provides battery-status api response
func (v *Renault) batteryAPI() (kamereonResponse, error) {
uri := fmt.Sprintf("%s/commerce/v1/accounts/%s/kamereon/kca/car-adapter/v2/cars/%s/battery-status", v.kamereon.Target, v.accountID, v.vin)
res, err := v.kamereonRequest(uri, nil)
// repeat auth if error
if err != nil {
if err = v.authFlow(); err == nil {
res, err = v.kamereonRequest(uri, nil)
}
}
return res, err
}
// hvacAPI provides hvac-status api response
func (v *Renault) hvacAPI() (kamereonResponse, error) {
uri := fmt.Sprintf("%s/commerce/v1/accounts/%s/kamereon/kca/car-adapter/v1/cars/%s/hvac-status", v.kamereon.Target, v.accountID, v.vin)
res, err := v.kamereonRequest(uri, nil)
// repeat auth if error
if err != nil {
if err = v.authFlow(); err == nil {
res, err = v.kamereonRequest(uri, nil)
}
}
return res, err
}
// cockpitAPI provides cockpit api response
func (v *Renault) cockpitAPI() (kamereonResponse, error) {
uri := fmt.Sprintf("%s/commerce/v1/accounts/%s/kamereon/kca/car-adapter/v2/cars/%s/cockpit", v.kamereon.Target, v.accountID, v.vin)
res, err := v.kamereonRequest(uri, nil)
// repeat auth if error
if err != nil {
if err = v.authFlow(); err == nil {
res, err = v.kamereonRequest(uri, nil)
}
}
return res, err
}
// SoC implements the api.Vehicle interface
func (v *Renault) SoC() (float64, error) {
res, err := v.batteryG()
if err == nil {
return float64(res.Data.Attributes.BatteryLevel), nil
}
return 0, err
}
var _ api.ChargeState = (*Renault)(nil)
// Status implements the api.ChargeState interface
func (v *Renault) Status() (api.ChargeStatus, error) {
status := api.StatusA // disconnected
res, err := v.batteryG()
if err == nil {
if res.Data.Attributes.PlugStatus > 0 {
status = api.StatusB
}
if res.Data.Attributes.ChargingStatus >= 1.0 {
status = api.StatusC
}
}
return status, err
}
var _ api.VehicleRange = (*Renault)(nil)
// Range implements the api.VehicleRange interface
func (v *Renault) Range() (int64, error) {
res, err := v.batteryG()
if err == nil {
return int64(res.Data.Attributes.BatteryAutonomy), nil
}
return 0, err
}
var _ api.VehicleOdometer = (*Renault)(nil)
// Odometer implements the api.VehicleOdometer interface
func (v *Renault) Odometer() (float64, error) {
res, err := v.cockpitG()
if err == nil {
return res.Data.Attributes.TotalMileage, nil
}
return 0, err
}
var _ api.VehicleFinishTimer = (*Renault)(nil)
// FinishTime implements the api.VehicleFinishTimer interface
func (v *Renault) 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 = (*Renault)(nil)
// Climater implements the api.VehicleClimater interface
func (v *Renault) Climater() (active bool, outsideTemp float64, targetTemp float64, err error) {
res, err := v.hvacG()
// Zoe Ph2
if err, ok := err.(request.StatusError); ok && err.HasStatus(http.StatusForbidden) {
return false, 0, 0, api.ErrNotAvailable
}
if err == nil {
state := strings.ToLower(res.Data.Attributes.HvacStatus)
if state == "" {
return false, 0, 0, api.ErrNotAvailable
}
active := !slices.Contains([]string{"off", "false", "invalid", "error"}, state)
return active, res.Data.Attributes.ExternalTemperature, 20, nil
}
return false, 0, 0, err
}
var _ api.AlarmClock = (*Renault)(nil)
// WakeUp implements the api.AlarmClock interface
func (v *Renault) WakeUp() error {
uri := fmt.Sprintf("%s/commerce/v1/accounts/%s/kamereon/kcm/v1/vehicles/%s/charge/pause-resume", v.kamereon.Target, v.accountID, v.vin)
data := map[string]interface{}{
"data": map[string]interface{}{
"type": "ChargePauseResume",
"attributes": map[string]interface{}{
"action": "resume",
},
},
}
_, err := v.kamereonRequest(uri, request.MarshalJSON(data))
// repeat auth if error
if err != nil {
if err = v.authFlow(); err == nil {
_, err = v.kamereonRequest(uri, request.MarshalJSON(data))
}
}
return err
}