Enode Developers

Onboarding and setup

The first time your user sets up smart charging poses an excellent opportunity to educate your users about the mechanics and requirements for smart charging.

Download

By default, smart charging is DISABLED. In this state, the vehicle is charged continuously when it is plugged in unless other interventions are configured by the user via the vehicle, charger, or other apps.

To get smart charging up and running, we need two simple inputs.

  1. A smart charging policy including a user-defined deadline
  2. One or more user-defined charging locations

A valid smart charging policy is all that’s necessary to transition from the DISABLED state into a CONSIDERING state. Still, since a charging location is required to generate a smart charging plan (transitioning into PLAN:*), we consider this a core part of smart charging onboarding.

Outside of fetching these two inputs, a few key pieces of information could be worth presenting early in the user journey to ensure a good understanding and experience.

  • What it is and how it works
  • Protective charging
  • Interference by third parties

In this guide, we will walk you through the ins and outs of both required inputs and key pieces of information.

Copy linkWhat it is and how it works

Download

Copy linkProtective charging

Download

The protective charging is controlled by the Vehicle's SmartChargingPolicy minimumChargeLimit. Defaults to zero.

If the vehicle charge level is below minimumChargeLimit when plugged in, the vehicle will charge continuously until it reaches minimumChargeLimit regardless of energy prices. Once the vehicle reaches minimumChargeLimit, a smart charging plan will be considered. This is reflected by the hasChargeAboveThreshold consideration, which will be false until the threshold is surpassed.

Copy linkInterference by third parties

Download

If the user has enabled schedules or other smart charging functionality via their charger, vehicle, or other apps, these will cause problems for smart charging plans, possibly causing them to fail and end.

Copy linkAdding a charging location

Download

The vehicle needs to be plugged in at a known charging location for smart charging to be considered, reflected by the recentlyAtChargingLocation consideration. Post a name and location data (longitude, latitude) to the /charging-locations endpoint to add a charging location. Charging locations are also used for mapping price data to tariffs or Nordpool price areas.

You can learn more about the different charging location endpoints in our API reference.

Example

Sample

{
  "name": "Home",
  "longitude": 10.757933,
  "latitude": 59.911491
}

Copy linkSetting a deadline

Download

Enabling smart charging for a vehicle is as simple as calling the /vehicles/{vehicleId}/smart-charging-policy endpoint and with the required information. You can read more about this in the previous guide in this series and our docs.

Copy linkConfirmation

Download

At this point, the user is ready to go. The next time they plug in their vehicle at a charging location, smart charging will be considered.

Next article: Day-to-day use

Creating a stellar smart charging experience

Was this article helpful?