Question: Is the .env file format for custom measurements documented somewhere?

[SirNoName2705]

Hi there 👋

I've been experimenting with the measurement script and the .env file that comes with it So far, most variables and comments seem self-explanatory, but I couldn’t find any formal documentation for this file – neither in the README nor the repo wiki/discussions.

I'd like to ask a few questions to clarify behavior for certain variables:

---

1. RESUME=true

Expected behavior:
I assumed this would resume a session that was interrupted earlier (e.g. due to a crash or KeyboardInterrupt), maybe by loading intermediate results?

Actual behavior:
When I set RESUME=true, the script still went through most steps again. It's unclear what gets reused or skipped, and no prior session seemed to be resumed. Am I misunderstanding what this flag does?

---

2. POWERMETER_ENTITY_ID and VOLTAGEMETER_ENTITY_ID

I’m using Tasmota as power meter:

POWER_METER=tasmota

Question:
Do these entity ID variables (used for Home Assistant integration) have any effect when using tasmota as power meter?
Or are they only relevant when POWER_METER=hass?

POWERMETER_ENTITY_ID=sensor.my_power
VOLTAGEMETER_ENTITY_ID=sensor.my_voltage

---

✍️ Final Thoughts

I’ve successfully completed a few measurements and really appreciate how well this project works overall.
It would be super helpful to have a dedicated .env documentation section (maybe in the wiki or a table in the README), explaining which variables are required or optional for which meter/controller types.

Thanks a lot for any clarification!

[bramstroker]

@SirNoName2705 there is no dedicated section yet in documentation to further explain env variables.
We can add a new page somewhere here: https://docs.powercalc.nl/contributing/measure/.
For example https://docs.powercalc.nl/contributing/measure/configuration.
I don't have time atm to do it, but if you want you could make a start.
Documentation sources are in github. https://github.com/bramstroker/homeassistant-powercalc/tree/master/docs.

1. RESUME=true

Measure tool should ask to resume when script crashed or keyboard interrupted exactly as you expected.
But I just checked and there was a bug causing it to not work at all.
Broke in a refactor some time ago. Will be fixed with #3288

It will ask question like this:
[?] CSV File /Users/bram/code/powercalc/utils/measure/export/xx/color_temp.csv already exists. Do you want to resume measurements? (Y/n): y

It will continue where it left.

2. POWERMETER_ENTITY_ID and VOLTAGEMETER_ENTITY_ID

These are hass only options. entity_id is also only HA concept.