Optolink platform: datapoint 0x088E time/date read/write

[123trs]

datapoint 0x088E needs DateTimeBCD conversion. Please built in the next release.

[s10l]

I guess this applies also to holidy program?

eg.

• Ferien Abreisetag A1M1 (306) [FerienBeginnA1M1~0x2309 (Array)]
• Ferien Rückreisetag A1M1 (309) [FerienEndeA1M1~0x2311 (Array)]

[pmamak]

@123trs Here is a quick work-around that works for me:

text_sensor:
  - platform: optolink
    name: "Raw Date & Time"
    id: raw_datetime
    address: 0x088E
    bytes: 8
    type: RAW
    internal: true
  - platform: template
    name: "Date & Time"
    icon: "mdi:calendar-clock"
    lambda: |-
      auto raw = id(raw_datetime).state;
      if (raw.size() < 8) {
        return {"Invalid"};
      }
      
      auto bcd_to_dec = [](uint8_t val) -> int {
        return ((val >> 4) * 10) + (val & 0x0F);
      };

      int year   = bcd_to_dec(raw[0]) * 100 + bcd_to_dec(raw[1]);
      int month  = bcd_to_dec(raw[2]);
      int day    = bcd_to_dec(raw[3]);
      int hour   = bcd_to_dec(raw[5]);
      int minute = bcd_to_dec(raw[6]);
      int second = bcd_to_dec(raw[7]);

      char buffer[30];
      snprintf(buffer, sizeof(buffer), "%04d-%02d-%02d %02d:%02d:%02d",
               year, month, day, hour, minute, second);
      return {buffer};

Here's a snippet with a service definition if you want to set the date and time from HA:

api:
  services: 
    - service: set_datetime
      variables:
        datetime: string
      then:
        lambda: |-
            ESP_LOGI("service.set_datetime", "Received datetime %s", datetime.c_str());
            
            static bool dp_init = true;
            static IDatapoint *dp = new Datapoint<convRaw>("datetime", "optolink", 0x088E, true);
            if (dp_init) {
              dp->setLength(8);
              dp_init = false;
            }

            auto dec_to_bcd = [](int val) -> uint8_t {
                return ((val / 10) << 4) | (val % 10);  // BCD encoding (high nibble for tens, low nibble for ones)
            };

            if (datetime.length() != 19) {
               ESP_LOGI("service.set_datetime", "Invalid datetime string length");
               return;
            }

            struct std::tm time_struct = {};
            const char* format = "%Y-%m-%d %H:%M:%S";  // Format to match the input string
            if (strptime(datetime.c_str(), format, &time_struct)) {
                std::mktime(&time_struct);

                uint8_t bcd[8] = {
                    dec_to_bcd((time_struct.tm_year + 1900) / 100), // High byte of year
                    dec_to_bcd((time_struct.tm_year + 1900) % 100), // Low byte of year
                    dec_to_bcd(time_struct.tm_mon + 1),             // Month
                    dec_to_bcd(time_struct.tm_mday),                // Day
                    dec_to_bcd((time_struct.tm_wday + 6) % 7 + 1),  // Weekday (Monday = 1, ..., Sunday = 7)
                    dec_to_bcd(time_struct.tm_hour),                // Hour
                    dec_to_bcd(time_struct.tm_min),                 // Minute
                    dec_to_bcd(time_struct.tm_sec)                  // Second
                };
                
              ESP_LOGI("service.set_datetime", "Trying to setup datetime");
              optolink_optolink_id->write_datapoint(dp, DPValue(bcd, sizeof(bcd)));
            } else {
              ESP_LOGI("optolink.service.set_datetime", "Invalid datetime string format");
              return;
            }

[123trs]

thanks;-) but not fully worked for me:

log output all right:
[10:48:26][I][optolink.datapoint_component:036]: recieved data for datapoint Raw Date & Time: 2025051605124650

but in HA: Date & Time 3230-32-35 35:31:36

[pmamak]

@123trs It looks like there was a breaking change in this component, so here is a working version (at least for now)

text_sensor:
  - platform: optolink
    name: "Raw Date & Time"
    id: raw_datetime
    address: 0x088E
    bytes: 8
    type: RAW
    internal: true
  - platform: template
    name: "Date & Time"
    icon: "mdi:calendar-clock"
    lambda: |-
      auto raw = id(raw_datetime).state;
      if (raw.size() < 16) {
        return {"Invalid"};
      }
      
      // Extract and format into proper datetime string
      char buffer[30];
      snprintf(buffer, sizeof(buffer), "%.4s-%.2s-%.2s %.2s:%.2s:%.2s",
        raw.c_str(),         // YYYY
        raw.c_str() + 4,     // MM
        raw.c_str() + 6,     // DD
        raw.c_str() + 10,    // HH (skip weekday at +8 and +9)
        raw.c_str() + 12,    // MM
        raw.c_str() + 14);   // SS

      return {buffer};

[123trs]

top, everything works, thank you

[sVnsation]

@s10l @123trs @pmamak check out pull request #24

[Pukkahq]

I know this is a very basic question. but do you add the code below to HA (if so which bit) or ESPHome config for the device?

api:
  services: 
    - service: set_datetime
      variables:
        datetime: string
      then:
        lambda: |-
            ESP_LOGI("service.set_datetime", "Received datetime %s", datetime.c_str());
            
            static bool dp_init = true;
            static IDatapoint *dp = new Datapoint<convRaw>("datetime", "optolink", 0x088E, true);
            if (dp_init) {
              dp->setLength(8);
              dp_init = false;
            }

            auto dec_to_bcd = [](int val) -> uint8_t {
                return ((val / 10) << 4) | (val % 10);  // BCD encoding (high nibble for tens, low nibble for ones)
            };

            if (datetime.length() != 19) {
               ESP_LOGI("service.set_datetime", "Invalid datetime string length");
               return;
            }

            struct std::tm time_struct = {};
            const char* format = "%Y-%m-%d %H:%M:%S";  // Format to match the input string
            if (strptime(datetime.c_str(), format, &time_struct)) {
                std::mktime(&time_struct);

                uint8_t bcd[8] = {
                    dec_to_bcd((time_struct.tm_year + 1900) / 100), // High byte of year
                    dec_to_bcd((time_struct.tm_year + 1900) % 100), // Low byte of year
                    dec_to_bcd(time_struct.tm_mon + 1),             // Month
                    dec_to_bcd(time_struct.tm_mday),                // Day
                    dec_to_bcd((time_struct.tm_wday + 6) % 7 + 1),  // Weekday (Monday = 1, ..., Sunday = 7)
                    dec_to_bcd(time_struct.tm_hour),                // Hour
                    dec_to_bcd(time_struct.tm_min),                 // Minute
                    dec_to_bcd(time_struct.tm_sec)                  // Second
                };
                
              ESP_LOGI("service.set_datetime", "Trying to setup datetime");
              optolink_optolink_id->write_datapoint(dp, DPValue(bcd, sizeof(bcd)));
            } else {
              ESP_LOGI("optolink.service.set_datetime", "Invalid datetime string format");
              return;
            }

[Pukkahq]

To Answer my own question, I added the -api part to the ESPHome device .yaml file (near the top (ESPHome had already added the API key))

I then created an automation with the code

alias: Sync DateTime to Viessmann
description: Send system date and time to ESPHome Viessmann
triggers:
  - trigger: time_pattern
    hours: /6
actions:
  - data:
      datetime: "{{ now().strftime('%Y-%m-%d %H:%M:%S') }}"
    action: esphome.viessmann_set_datetime
mode: single

Also added update_interval to the main part

  - platform: optolink
    name: "Raw Date & Time"
    id: raw_datetime
    address: 0x088E
    bytes: 8
    type: RAW
    internal: true
    update_interval: 331s
  - platform: template
    name: "Date & Time"
    icon: "mdi:calendar-clock"
    update_interval: 332s
    lambda: |-
      auto raw = id(raw_datetime).state;
      if (raw.size() < 16) {
        return {"Invalid"};
      }
      
      // Extract and format into proper datetime string
      char buffer[30];
      snprintf(buffer, sizeof(buffer), "%.4s-%.2s-%.2s %.2s:%.2s:%.2s",
        raw.c_str(),         // YYYY
        raw.c_str() + 4,     // MM
        raw.c_str() + 6,     // DD
        raw.c_str() + 10,    // HH (skip weekday at +8 and +9)
        raw.c_str() + 12,    // MM
        raw.c_str() + 14);   // SS

      return {buffer};