Read and write schedule (enhancement)

[Eugen4]

Installation specifics

• Heating type: Vitotronic 200
• Protocol: P300
• Board: ESP8266 (Wemos D1 mini)

Symptom

What happens? I wasn't able to read and write schedule for water heating
What would you expect? Add function to the library for simplify read and write schelude info to Viessmann

Extra info

ESPHome provides such possibilities:
Schedule plans info: https://deploy-preview-2737--esphome.netlify.app/components/optolink.html#schedule-plans
Code reference: https://github.com/80morpheus/esphome_optolink/blob/optolink/esphome/components/optolink/helpers.cpp

Some usefull info from here openv/openv#282

 * ## Unit: CycleTime
 * Desc: 1 byte coding of the switching times.
 * The switching times are divided into 10 minute steps and coded
 * this saves space.
 * The upper 5 bits represent the hours, the lower 3 bits the number
 * share of 10 minutes
 *
 * MSB LSB
 *      +---+---+---+---+---+---+---+---+
 *      | h4  h3  h2  h1  h0 | m2-m0 * 10|
 *      +---+---+---+---+---+---+---+---+

[bertmelis]

Can be implemented. Could you remind me in a week or so? I'm enjoying some time off 🎄.

[bertmelis]

I don't use this feature myself so I'm not really familiar with the schedule.

A single schedule is encoded by a series of 8 bytes with each byte representing a time (rounded to 10 minutes). So for one day you can define 4 periods (time on + time off = 2 bytes). A whole week needs 7 * 8 bytes = 56 bytes, as referred to on the Home Assistant page.

I don't know if a single time entry can be read or written or the whole schedule (56 bytes) need to be requested.

So my main question: How would you use the schedule?

[Eugen4]

Hello Bert. I would use schedule to control Water Heating. I can be away for days/weeks. In such cases I prefer to disable (before leaving house) water heating via schedule reconfiguration. I think it is a good posibility to remotelly turn on water heating just before comming back home.
Also I could define several presents in NodeMCU to upload them by single click.

[bertmelis]

I understand that, but I don't know the datapoints myself. Are you writing 8 bytes in a single command or is it 56 bytes at once?

That said, I added already a preliminary version in the conv-schedule-branch.

No automatic conversion at the moment, only:

// "7:30 8:30 17:30 19:00" --> byte array
// uint8_t* output has to be 8 bytes long
std::size_t VitoWiFi::encodeSchedule(const char* schedule, std::size_t len, uint8_t* output);
std::size_t VitoWiFi::encodeSchedule(const char* schedule, uint8_t* output);
// byte array --> "7:30 8:30 17:30 19:00"
// len has to be 8 bytes, maxLen at least 48
std::size_t VitoWiFi::decodeSchedule(const uint8_t* data, std::size_t len, char* output, std::size_t maxLen);

[Eugen4]

According to the HA I guess length should be 56 bytes.
I couldn't find exact initial address to write these 56 bytes. I think I could try to read data and compare with current configuration until correct address is found.