Skip to content

Commit d27017d

Browse files
authored
Add explanation of resume_charging-limitations (#282)
The stop/resume commands have some limitations that aren't very intuitive if you haven't struggled directly with the API (and maybe not even then). Added some clarification to the readme to hopefully reduce questions/confusion and avoid issues like #278. Also correct some misnamed deprecated services.
1 parent 605b137 commit d27017d

File tree

1 file changed

+34
-9
lines changed

1 file changed

+34
-9
lines changed

README.md

Lines changed: 34 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -170,23 +170,48 @@ Starting and stopping charging can be done by several methods. If the charger
170170
is configured to not require authentication, connecting the charger to the
171171
EV will by default start charging.
172172

173-
To start the charging from HA, this can be done in several ways:
174-
175-
- Press the _"Resume charging"_ button, or
176-
- Toggle the _"Charging"_ switch, or
177-
- Send `zaptec.restart_charger` service call (deprecated)
178-
179-
Similarly, pausing the charging can be done by:
173+
To stop the charging from HA, this can be done in several ways:
180174

181175
- Pressing the _"Stop charging"_ button, or
182176
- Turn off the _"Charging"_ switch, or
183-
- Send `zaptec.stop_pause_charging` service call (deprecated)
177+
- Send `zaptec.stop_charging` service call (deprecated)
178+
179+
Similarly, starting the charging again can be done by:
180+
181+
- Press the _"Resume charging"_ button, or
182+
- Turn on the _"Charging"_ switch, or
183+
- Send `zaptec.resume_charging` service call (deprecated)
184184

185185
> [!TIP]
186186
> Zaptec will unlock the cable when charging is paused unless it is permanently
187187
> locked.
188188
189189

190+
### The limitations of the Resume command
191+
192+
It is important to understand that the _"Resume charging"_ command as it is
193+
implemented in the Zaptec API will only start charging if the charger was
194+
stopped by a _"Stop charging"_ command.
195+
196+
Some example cases where the _"Resume charging"_ command will **not** start
197+
charging:
198+
199+
* Charging current is set to `0 A` (
200+
[Setting charging current](#setting-charging-current)).
201+
* The car has reached its configured target battery level.
202+
* The charging was stopped using the app/api of the car.
203+
* The charging has stopped because the time is outside of the charging schedule
204+
configured in the app of the car.
205+
206+
> [!TIP]
207+
> As a general rule: To start charging, you need to reverse what stopped it in
208+
> the first place.
209+
210+
> [!NOTE]
211+
> The charging buttons will only be available/clickable when the command they
212+
> trigger is valid.
213+
214+
190215
## Prevent charging auto start
191216

192217
Zaptec will by default start charging as soon as everything is ready
@@ -215,7 +240,7 @@ the same time.
215240
> [!NOTE]
216241
> This entity is adjusting the available current for the entire installation.
217242
> If the installation has several chargers installed, changing this value will
218-
> affect all.
243+
> affect all of them.
219244
220245
> [!IMPORTANT]
221246
> Many EVs don't like getting too frequent changes to the available charge

0 commit comments

Comments
 (0)