Skip to content

Commit

Permalink
first aid; prettier format
Browse files Browse the repository at this point in the history
  • Loading branch information
naltatis committed Aug 23, 2023
1 parent 5855f6b commit ebdc852
Show file tree
Hide file tree
Showing 7 changed files with 36 additions and 38 deletions.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"label": "Tips & FAQ",
"position": 3
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@ import SponsorshipRequired from "/docs/_sponsorship_required.mdx";

### What do the different Charge Modes do?

| Mode | Description |
| :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Stop** | No charging occurs - if a session was in progress, it is stopped immediately. |
| **Fast** | Charging proceeds at the maximum rate possible. |
| **Min + Solar** | Charging proceeds at the _slowest_ rate possible. If enough excess solar is available to increase performance, this is made available to the Charger. |
| **Solar** | Charging proceeds _utilising only excess solar power_. If excess solar does not exceed the minimum charge rate, charging stops. [More Details](#i-have-solar-excess-but-the-vehicle-doesnt-charge-why) |
| Mode | Description |
| :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Stop** | No charging occurs - if a session was in progress, it is stopped immediately. |
| **Fast** | Charging proceeds at the maximum rate possible. |
| **Min + Solar** | Charging proceeds at the _slowest_ rate possible. If enough excess solar is available to increase performance, this is made available to the Charger. |
| **Solar** | Charging proceeds _utilising only excess solar power_. If excess solar does not exceed the minimum charge rate, charging stops. [More Details](#i-have-solar-excess-but-the-vehicle-doesnt-charge-why) |

### I have Solar excess, but the vehicle doesn't charge. Why?

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ Pointers on some pitfalls with Charge Points.

## [Miscellaneous](faq)

Miscellaneous things that don't fall into any other category.
Miscellaneous things that don't fall into any other category.
42 changes: 21 additions & 21 deletions i18n/en/docusaurus-plugin-content-docs/current/guides/meters.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Many Inverters are Sunspec-compatible (even if it sometimes needs to be enabled)
Sure! But please note that you won't be able to charge using Solar Excess energy only, as the calculations required for this are only possible when Grid Power is known.
When configured like this, evcc will charge the vehicle using the current power coming from Solar Generation.

A typical, medium-sized house's consumption can be specified to attempt to leave some energy for your house - you can do us this using the
A typical, medium-sized house's consumption can be specified to attempt to leave some energy for your house - you can do us this using the
[`residualPower`](/docs/reference/configuration/site#residualpower) config flag.

**Example**:
Expand Down Expand Up @@ -46,31 +46,31 @@ Here's an example using the `const` plugin:

```yaml
meters:
- name: dummymeter
type: custom
power:
source: const
value: 700 # 700W
- name: dummymeter
type: custom
power:
source: const
value: 700 # 700W
```

And another one using the `script` plugin:

```yaml
chargers:
- name: my_charger
type: custom
status: # charger status A..F
source: script
cmd: /bin/sh -c 'echo b'
enabled: # charger enabled state (true/false or 0/1)
source: script
cmd: /bin/sh -c 'echo false'
enable: # set charger enabled state (true/false or 0/1)
source: script
cmd: /bin/sh -c 'echo false'
maxcurrent: # set charger max current (A)
source: script
cmd: /bin/sh -c 'echo 10'
- name: my_charger
type: custom
status: # charger status A..F
source: script
cmd: /bin/sh -c 'echo b'
enabled: # charger enabled state (true/false or 0/1)
source: script
cmd: /bin/sh -c 'echo false'
enable: # set charger enabled state (true/false or 0/1)
source: script
cmd: /bin/sh -c 'echo false'
maxcurrent: # set charger max current (A)
source: script
cmd: /bin/sh -c 'echo 10'
```

### I have a Grid meter, but my Solar Inverter is very old and doesn't offer a usable data interface. Can I still use evcc sensibly?
Expand All @@ -79,4 +79,4 @@ Yes! If there's a Grid meter and a controllable charger, then you can use all of
Please note that you will be lacking a few visualizations and statistics, including the calculation of solar charging percentage.

Do consider that if you install a retrofitted meter of some kind (such as a Shelly EM) onto your inverter's output cable, you'll get all of the same functionality that you would
if you could talk directly to the inverter.
if you could talk directly to the inverter.
Original file line number Diff line number Diff line change
Expand Up @@ -45,12 +45,11 @@ When making a post, it would be super useful to give as much information as poss

</details>

- Alternatively, you can use `evcc dump --cfg >~/config.txt` to create an anonymized configuration file at `~/config.txt`.

- Alternatively, you can use `evcc dump --cfg >~/config.txt` to create an anonymized configuration file at `~/config.txt`.

**⛑️ First Aid**

We've added a useful helper utility to evcc to help with the above. By entering `evcc discuss` in your terminal, our helper wizard will help you create a new discussion topic in our "First Aid" section.
We've added a useful helper utility to evcc to help with the above. By entering `evcc discuss` in your terminal, our helper wizard will help you create a new discussion topic in our "Erste Hilfe" (first aid) section.
This discussion will automatically include any relevant error messages, and the anonymized configuration file - you only need to supply a meaningful title and a description of your problem.

This First Aid utility can only be use for the initial creation of a discussion thread. If you need to supply further information to a topic already in progress, you'll need to do this manually.
Expand Down Expand Up @@ -183,7 +182,7 @@ More details, including on how to use variable rate tariffs (such as those from
_Please note that these statistics are rough and shouldn't be treated as perfectly accurate._
When calculating savings, evcc uses the total amount of charged energy, and the energy sources used during charging (grid, house battery, solar).
When calculating savings, evcc uses the total amount of charged energy, and the energy sources used during charging (grid, house battery, solar).
**What is Solar Energy?**
Expand Down Expand Up @@ -212,4 +211,4 @@ If you get energy from more than one source at the same time (e.g 50% grid, 50%
This assumes that your home consumption and your active Charge Points use an energy mix of 50/50.
With this model, charging the car is treated exactly the same as using your washing machine.
Flexible pricing (Octopus Energy, Awattar, Tibber, etc) is taken into account when determining the effective energy price, however the savings amount is always calculated against the currently valid energy price.
Flexible pricing (Octopus Energy, Awattar, Tibber, etc) is taken into account when determining the effective energy price, however the savings amount is always calculated against the currently valid energy price.
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ This can sometimes take the form of a "Allow External Cards" toggle.
**Procedure**:
- Hold the RFID / NFC card / token up to your Charger until it reports that it has been recognised in some way
- Hold the RFID / NFC card / token up to your Charger until it reports that it has been recognised in some way
- Stop evcc (if it's already running)
- Issue the command `evcc charger` on the command line
- The output will contain the line `identifier:` and then a value - make a note of this value
Expand Down Expand Up @@ -156,11 +156,12 @@ The speed and reliability of this procedure depends heavily on the speed and rel

:::info
Detection via online services can fail for a number of reasons, including:

- the vehicle is temporarily unavailable (out of service)
- the vehicle manufacturer's server is temporarily unavailable
- new terms and conditions need to be agreed to (on the website / in the app / in the vehicle)
- there was a change to the online service by the manufacturer, rendering evcc unable to interpret data from it
:::
:::

## Manufacturer-Specific Special Stuff

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ Yes! Multiple Chargers can be added and controlled by evcc at the same time.

However, **_Load Management_ or prioritization across multiple Chargers is currently not supported**. This is currently in development for a later release.


## Single / Three-Phase Functionality

### Is the automatic Single / Three-Phase switching functionality on my Charger supported?
Expand All @@ -40,4 +39,3 @@ You may need to modify the "Loadpoint" parameter `Phases` to suit your installat
:::danger
For safety reasons, evcc will only disconnect phases from the Charge Point when there is no Vehicle connected.
:::

0 comments on commit ebdc852

Please sign in to comment.