Add Values of Planing as Sensors

[diestrohs]

Hello, could you please add effectivePlanId, effectivePlanSoc, effectivePlanTime, planActive, planEnergy, planOverrun, planProjectedEnd and planProjectedStart as sensors?

These values are needed to display the charging schedule in the user interface.

[marq24]

would be cool to have a screenshot - so there is no need to guess where the values are currently displayed (PlanID is hopefully not meaningful for the user)

[diestrohs]

Hi,
here are the most important sensors for visualizing the charging plan:

• effectivePlanId → Indicates which charging plan will be active next. This is helpful if recurring charging plans are also supported. It
  eliminates the need to compare which plan is currently in effect.
• effectivePlanSoc → Shows the effective charging target when multiple charging plans are active and overlap.
• effectivePlanTime → Displays the charging duration.
• planActive → Indicates whether a charging plan is currently active.
• planEnergy → Relevant if the vehicle is unknown.
• planProjectedEnd → Shows when the charging process will be completed.
• planProjectedStart → Shows when the charging process will begin.

The image contains some of these values.

I could try to implement it myself and provide you with a diff. I am a computer scientist, but I haven’t implemented software in over 10 years and I’m not really proficient in Python. Let me know how I can support you.

[marq24]

I'll take care about these values in the next release:

• "planActive": false,
• "planProjectedStart": "0001-01-01T00:00:00Z",
• "planProjectedEnd": "0001-01-01T00:00:00Z",

and (even if these are duplicates of data present in the vehicles object)

• "effectivePlanSoc": 0,
• "effectivePlanTime": "0001-01-01T00:00:00Z",

[marq24]

jfyi - you have currently already some of the info via: VEHICLEPLANSSOC, VEHICLEPLANSTIME...

[marq24]

please update to 2025.2.2

[diestrohs]

Hi, planActive becomes true when the charging plan starts. The display of the charging plan turns orange, see image.

{
"result": {
"auth": {

},
"aux": [],
"availableVersion": "0.200.1",
"battery": [
  {
    "power": 1.6323,
    "energy": 3689.25412,
    "capacity": 10.24,
    "soc": 27.5,
    "controllable": true
  }
],
"batteryCapacity": 10.24,
"batteryDischargeControl": true,
"batteryEnergy": 3689.254,
"batteryGridChargeActive": false,
"batteryMode": "hold",
"batteryPower": 1.632,
"batterySoc": 27.5,
"bufferSoc": 20,
"bufferStartSoc": 0,
"currency": "EUR",
"eebus": true,
"ext": [],
"fatal": null,
"greenShareHome": 0.002,
"greenShareLoadpoints": 0,
"grid": {
  "power": 7794,
  "energy": 14213.532,
  "powers": [3819, 3806, 169],
  "currents": [16.79, 16.8, 1.43]
},
"gridConfigured": true,
"hems": {

},
"homePower": 695.532,
"influx": {
  "url": "",
  "database": "",
  "org": "",
  "user": "",
  "insecure": false
},
"interval": 10,
"loadpoints": [
  {
    "batteryBoost": false,
    "chargeCurrent": 16,
    "chargeCurrents": [15.49, 15.38, 0],
    "chargeDuration": 490,
    "chargePower": 7100.1,
    "chargeRemainingDuration": 3851,
    "chargeRemainingEnergy": 7594.646,
    "chargedEnergy": 960.909,
    "chargerFeatureHeating": false,
    "chargerFeatureIntegratedDevice": false,
    "chargerIcon": null,
    "chargerPhases1p3p": false,
    "chargerPhysicalPhases": null,
    "chargerStatusReason": "unknown",
    "charging": true,
    "connected": true,
    "connectedDuration": 0,
    "disableDelay": 180,
    "disableThreshold": 0,
    "effectiveLimitSoc": 80,
    "effectiveMaxCurrent": 16,
    "effectiveMinCurrent": 6,
    "effectivePlanId": 4,
    "effectivePlanSoc": 100,
    "effectivePlanTime": "2025-02-20T21:00:00+01:00",
    "effectivePriority": 0,
    "enableDelay": 60,
    "enableThreshold": 0,
    "enabled": true,
    "limitEnergy": 0,
    "limitSoc": 0,
    "maxCurrent": 16,
    "minCurrent": 6,
    "mode": "pv",
    "phaseAction": "inactive",
    "phaseRemaining": 0,
    "phasesActive": 2,
    "phasesConfigured": 3,
    "phasesEnabled": 3,
    "planActive": true,
    "planEnergy": 0,
    "planOverrun": 6705,
    "planProjectedEnd": "2025-02-20T22:51:45+01:00",
    "planProjectedStart": "2025-02-20T19:45:36+01:00",
    "planTime": null,
    "priority": 0,
    "pvAction": "inactive",
    "pvRemaining": 0,
    "sessionCo2PerKWh": null,
    "sessionEnergy": 960.909,
    "sessionPrice": 0.28,
    "sessionPricePerKWh": 0.292,
    "sessionSolarPercentage": 1.123,
    "smartCostActive": false,
    "smartCostNextStart": null,
    "title": "Garage",
    "vehicleClimaterActive": null,
    "vehicleDetectionActive": false,
    "vehicleLimitSoc": 100,
    "vehicleName": "db:7",
    "vehicleOdometer": 17786,
    "vehicleRange": 165,
    "vehicleSoc": 67.572,
    "vehicleWelcomeActive": false
  }
],
"messaging": true,
"modbusproxy": null,
"mqtt": {
  "broker": "",
  "topic": "evcc"
},
"network": {
  "schema": "http",
  "host": "evcc.local",
  "port": 7070
},
"prioritySoc": 20,
"pv": [
  {
    "power": 0,
    "energy": 15406.759
  },
  {
    "power": 0,
    "energy": 15396.41802
  }
],
"pvEnergy": 30803.177,
"pvPower": 0,
"residualPower": 0,
"siteTitle": "Domizil",
"smartCostType": "pricestatic",
"sponsor": {
  "name": "",
  "expiresAt": "0001-01-01T00:00:00Z"
},
"statistics": {
  "30d": {
    "avgCo2": 0,
    "avgPrice": 0.211380256218338,
    "chargedKWh": 137.568961963375,
    "solarPercentage": 37.9860890950172
  },
  "365d": {
    "avgCo2": 0,
    "avgPrice": 0.211380256218338,
    "chargedKWh": 137.568961963375,
    "solarPercentage": 37.9860890950172
  },
  "thisYear": {
    "avgCo2": 0,
    "avgPrice": 0.211380256218338,
    "chargedKWh": 137.568961963375,
    "solarPercentage": 37.9860890950172
  },
  "total": {
    "avgCo2": 0,
    "avgPrice": 0.211380256218338,
    "chargedKWh": 137.568961963375,
    "solarPercentage": 37.9860890950172
  }
},
"tariffFeedIn": 0.077,
"tariffGrid": 0.294,
"tariffPriceHome": 0.293,
"tariffPriceLoadpoints": 0.294,
"vehicles": {
  "db:7": {
    "title": "iV50",
    "icon": "car",
    "capacity": 55,
    "minSoc": 60,
    "limitSoc": 80,
    "repeatingPlans": [
      {
        "weekdays": [1, 2, 3, 5],
        "time": "11:30",
        "tz": "Europe/Berlin",
        "soc": 80,
        "active": true
      },
      {
        "weekdays": [4],
        "time": "10:30",
        "tz": "Europe/Berlin",
        "soc": 80,
        "active": true
      },
      {
        "weekdays": [4],
        "time": "21:00",
        "tz": "Europe/Berlin",
        "soc": 100,
        "active": true
      }
    ]
  }
},
"version": "0.133.0"

}
}

[marq24]

... when you have a guest vehicle, and enable a Plan (amount of Energy to load), then (at least for me) the planActive (via api/state) is still false (but effectivePlanTime is set - and that's what the 'alternative' Plan Active Sensor will show as ON/OFF)

[diestrohs]

Here is a quick explanation of the difference between the sensors:

"effectivePlanTime": "2025-02-20T20:00:00Z" → This is the planned target time.
"planProjectedEnd": "2025-02-20T23:18:24+01:00" → This indicates when the charging target will actually be reached. The charging target might not be met for various reasons, such as the vehicle being connected too late.
"planOverrun": 8304 → Indicates the exceeded target time in seconds (2h:18m).

Thanks for the implementation. I'll take a look at it and give you feedback.

[marq24]

thanks for all the input - planProjectedEnd & planProjectedStart have been already added...

[diestrohs]

Hi,
could you please also include 'planOverrun' in seconds, as described above?
While it can be calculated using the formula 'planProjectedEnd' - 'effectivePlanTime', this calculation wouldn't be necessary if 'planOverrun' were retrieved directly from EVCC via the integration.

Example from the provided api data:
The time difference between "planProjectedEnd": "2025-02-20T22:51:45+01:00" and "effectivePlanTime": "2025-02-20T21:00:00+01:00"
is: 22:51:45 - 21:00:00 = 1 hour, 51 minutes, 45 seconds
Converted to seconds: (1×3600) + (51×60) + 45 = 6705 seconds
So, 6705 seconds exactly corresponds to "planOverrun": 6705 in provided api data.

Thank you very much and best regards!