Missing eBUS definitions for Protherm RAY Electric Boiler

[RK357]

Description

Hello,

I am requesting the integration of specific missing eBUS command definitions for a Protherm electric boiler, which is part of the Vaillant family. The primary goal is to enable read/write functionality for key control parameters necessary for Home Assistant integration.

• Device: Protherm RAY 21 KE/14 EU Electric Boiler
• eBUS Address: 08 (BAI)
• eBUS Adapter: ESP32-C6 (Chip ID: ccba97f8024c, Hostname: ebus-f8024c)
• Firmware/Software Version (D.095): -1- 375 (Software Version: PeBUS participant (BMU/AI))

1. Key Functionality Request: Write Commands (D.000 & D.005)

The highest priority is to define the following commands as read/write (w/r) in the CSV configuration. These commands are essential for advanced control logic:

The goal is to use these write commands (specifically D.000 for power limit and D.005 for temperature setpoint) to dynamically control the boiler's consumption in Home Assistant, optimizing for self-consumption based on solar PV production.

Code	Parameter Description	Priority
D.000	Partial power setting 21 KE (Power Limit)	CRITICAL
D.005	Desired boiler flow temperature (Setpoint)	CRITICAL
D.020	Max DHW temperature desired value	HIGH
D.022	Domestic Hot Water demand	HIGH

2. Confirmation of Existing Functionality & Testing

We would like to commend the excellent work on the existing configuration!

• Successfully Reading (D.040): The existing eBUSd configuration successfully reads and logs the actual flow temperature (D.040 - 'Flow temperature' / Actual value in °C). This data is correctly historicalized in Home Assistant and confirms that the basic communication for read commands is working perfectly.
• Testing D.155: We previously used the D.155 parameter (Current Power Output) for testing purposes, which provided us with valuable data:
  • Observed OFF Value (D.155): 0.0 kW
  • Observed ON Value (D.155): 4.0 kW

3. Documentation & Attachments

The current official CSV configuration is missing the requested definitions. I have compiled a full table of diagnostic data from the boiler's menu to assist with creating the correct CSV lines.

• Attached Data: I have attached the full diagnostic table (RAY 21kW MENU.xlsx and images) showing values when the boiler is OFF and actively ON.
• Documentation References (Czech/Slovak):
  • Installation and Maintenance Manual (ni-ray-ke-725012): https://www.protherm.cz/files/downloads/navody-k-instalaci/ni-ray-ke-725012.pdf
  • Operating Manual (pp-4-1-ray-ke-verze-7-09032023-2605646): https://www.protherm.cz/files/downloads/projekcni-podklady/pp-4-1-ray-ke-verze-7-09032023-2605646.pdf

4. General Request

I also request that all other available parameters (D.000 up to D.155) that can be read by the eBUS system be defined as read-only (r type). Please refer to the attached documents for further parameter details.

RAY 21kW MENU.xlsx

[RK357]

Title: [Vaillant BAI00] Severe CSV Error: ERR: invalid position during polling (ebusd 25.1.p20250414)

Description:

I have achieved a stable connection to my ESP32 adapter (192.168.1.194:9999) and the eBUSd 25.1.p20250414 Add-on is running successfully. [cite_start]The core issue is a significant incompatibility within the bundled CSV configuration files for the Vaillant BAI00 boiler, identified as scan 08: ;Vaillant;BAI00;0109;7503.

Despite stable bus communication, polling critical values results in numerous decoding errors, leading to invalid data in the Home Assistant MQTT entities (Unknown, -60.44 °C).

Successful Operational Configuration:
The following configuration parameters established a stable connection and successful device scanning:

scanconfig: true
mode: ens
network_device: 192.168.1.194:9999
latency: 200

I understand. I will compile all the troubleshooting details, logs, and findings into a comprehensive bug report (Issue Report) in English.

This report is now ready for you to copy and paste into the appropriate platform (e.g., GitHub repository for the eBUSd configuration files or the Home Assistant Add-on).

📄 eBUSd Issue Report (English)
Markdown

**Title:** [Vaillant BAI00] Severe CSV Error: `ERR: invalid position` during polling (ebusd 25.1.p20250414)

**Description:**

I have achieved a stable connection to my ESP32 adapter (`192.168.1.194:9999`) and the eBUSd 25.1.p20250414 Add-on is running successfully. [cite_start]The core issue is a significant incompatibility within the bundled CSV configuration files for the **Vaillant BAI00** boiler, identified as `scan 08: ;Vaillant;BAI00;0109;7503`.

Despite stable bus communication, polling critical values results in numerous decoding errors, leading to invalid data in the Home Assistant MQTT entities (`Unknown`, `-60.44 °C`).

**Successful Operational Configuration:**
The following configuration parameters established a stable connection and successful device scanning:
```yaml
scanconfig: true
mode: ens
network_device: 192.168.1.194:9999
latency: 200
(See attached eBUSd logs.txt  for the full startup sequence.)

Critical CSV Errors from Log (ERR: invalid position): The logs explicitly show that the CSV file's data position definitions are incorrect for this device ID, as multiple polling attempts fail:


[update error] unable to parse poll-read bai ExternalFlowTempDesired...: ERR: invalid position 




[update error] unable to parse poll-read bai HcPumpMode...: ERR: invalid position 


[update error] unable to parse poll-read bai SecondPumpMode...: ERR: invalid position 




[update error] unable to parse poll-read bai ValveMode...: ERR: invalid position 


(And multiple others, including ExtFlowTempDesiredMin, HwcTempMax, Status16, etc.) 



Incorrect/Faulty Decoded Values (Sensor Absence Issues): These errors are likely due to incorrect decoding of error codes when a sensor is not present:


OutdoorstempSensor temp: Displays -60.4 °C. Context: No external sensor or room controller is connected to the eBUS. This is believed to be an eBUS error code being incorrectly decoded as a temperature value.


StorageTemp temp: Displays -14.9 °C.


ReturnTemp temp and HwcTemp temp: Display 0.0 °C.

The repeated scan config 05: ERR: read timeout  is expected and confirms the absence of a device on controller address 05.

Values Read CORRECTLY (Confirming Functional Connection): The connection is verified by successfully reading these core parameters:


FlowTemp temp: 42.8 °C  (Menu Address D.040)


FlowTempDesired: 50.0 °C  (Menu Address D.005)


PumpPower: 15  (Menu Address D.015)

Attachments:


eBUSd logs.txt (Full log demonstrating ERR: invalid position) 


status.txt (Full list of incorrectly displayed entities) 

Request: Please review and update the CSV configuration files for the Vaillant BAI00 to fix the position definitions and correctly handle the decoding of error codes for absent sensors (like Outdoor Temperature).


[eBUSd logs.txt](https://github.com/user-attachments/files/23614650/eBUSd.logs.txt)

[eBUSd logs 01.txt](https://github.com/user-attachments/files/23614662/eBUSd.logs.01.txt)

[status.txt](https://github.com/user-attachments/files/23614675/status.txt)

[aavdberg]

Should this be the right information for the Skat KE 14:

# Protherm Skat 14 custom TSP definitions
# Boiler Application Interface (BAI) at bus address 08

service bai 08

# Power limit (maximum output in kW)
signal powerlimit write int range=0-14 unit="kW" desc="Power limit kW" id=d000

# Desired flow temperature (setpoint)
signal flowsetpoint write int range=10-80 unit="°C" desc="Desired flow temperature °C" id=d005

# Actual flow temperature (read-only)
signal flowtemp read int range=0-100 unit="°C" desc="Actual flow temperature °C" id=d040

# Current power output (read-only)
signal currentpower read int range=0-14 unit="kW" desc="Current power output kW" id=d155

And this for the RAY 21:

# Power limit (maximum output in kW)
signal powerlimit write int range=0-21 unit="kW" desc="Power limit kW" id=d000

# Desired flow temperature (setpoint)
signal flowsetpoint write int range=10-80 unit="°C" desc="Desired flow temperature °C" id=d005

# Actual flow temperature (read-only)
signal flowtemp read int range=0-100 unit="°C" desc="Actual flow temperature °C" id=d040

# Current power output (read-only)
signal currentpower read int range=0-21 unit="kW" desc="Current power output kW" id=d155

@john30 how to add this and is this correct?

[aavdberg]

And this for the registers D020 and D022

signal temp1 read int range=0-100 unit="°C" desc="Internal temperature sensor 1" id=d020
signal temp2 read int range=0-100 unit="°C" desc="Internal temperature sensor 2" id=d022