Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.36%. Comparing base (1560b8b) to head (7db1dfa).
⚠️ Report is 4059 commits behind head on dev.

@@            Coverage Diff             @@
##              dev    #7993      +/-   ##
==========================================
+ Coverage   69.17%   73.36%   +4.18%     
==========================================
  Files          52       53       +1     
  Lines       10755    11283     +528     
  Branches     1449     1532      +83     
==========================================
+ Hits         7440     8278     +838     
+ Misses       2922     2605     -317     
- Partials      393      400       +7     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Saw comments on the documentation: esphome/esphome.io#4528 (comment)
Any clue what the BOX, UCBAT, SWITCH and UC nodes are (I only detect BOX and UCBAT myself)?
Here it works fine, I have some additional components here.

• The duco box
• Controllers where only one supports CO2 readings
• Wireless controller
• One CO2 reader on the bedroom

My list is as follows:
[10:53:12][I][duco:200]: Discovered nodes:
[10:53:12][I][duco:203]: Node 1: type 17 (BOX)
[10:53:12][I][duco:203]: Node 2: type 8 (UCBAT)
[10:53:12][I][duco:203]: Node 3: type 12 (UCCO2)
[10:53:12][I][duco:203]: Node 4: type 12 (UCCO2)

Possibly related: I can see on the Duco display that it can measure indoor and outdoor temperatures. Can those sensors be read over UART as well?
This would be nice indeed, now I'm using another outside temp detector and indoor temp detectors.
We are now with 3 ppl using it, so if we are finding the way to do it, we can add it later and share it with a new PR.

This is a very interesting PR, nice progress too! I'm going to follow this as I have a DucoBox energy premium and the connectivity board which is very disappointing.

I'm sniffing the uart comms with a saleae clone to see if I can get some more data.

• type 10 is a temp/humidity sensor.
• type 13 is a valve. (I have a two zone box and a heat exchanger bypass. Likely these valves control these functions)
• Nodes 58, 67 and 68 are inside of the box.

14:28:34 | [I] | [duco:203] | Discovered nodes:
14:28:34 | [I] | [duco:205] | Node 1: type 17 (BOX)
14:28:34 | [I] | [duco:205] | Node 2: type 10 (UCRH)
14:28:34 | [I] | [duco:205] | Node 3: type 12 (UCCO2)
14:28:34 | [I] | [duco:205] | Node 58: type 10 (UCRH)
14:28:34 | [I] | [duco:205] | Node 67: type 13 (UNKNOWN)
14:28:34 | [I] | [duco:205] | Node 68: type 13 (UNKNOWN)

@w1ll14m I'm glad to hear that it's working well! Since you're also looking at it with a logic analyzer, can you see if you can figure out the protocol for the humidity sensor? I couldn't do that myself, since I don't have a humidity sensor in my own network.

If you're looking for a bit more information of the protocol, you can take a look at: https://github.com/kokx/duco-analysis/ . There I described how I reverse engineered the protocol itself using a Saleae. I am assuming that the humidity sensor works very similar to how the CO2-sensor works. Feel free to contact me if you have any troubles there, I'm happy to help you decipher it.

I would also be quite interested to see how the valve works, would be nice if this can be implemented as well.

@Tiellemans Unfortunately the temperature sensors aren't visible through the Connectivity Board, which means that I wasn't able to figure out that part of the protocol.

@kokx

I've reinstalled the duco board and installed the installer app, registered (not verified) and was able to read some info from the box and sensors. I was able to read pressure and humid from box and humid + temp from sensors. I dumped the data from logic analyzer and made a few screenshots. Haven't had the time yet to figure out the messages, I did read your duco-analysis repo, which is very nice!

What is a good place to have a discussion and share some files? Are you active on IRC, discord or something else? It's probably best to not clutter this PR too much :)

@w1ll14m You can reach me on Discord, you should be able to find me in the esphome discord with the same username.

With some help from @w1ll14m it was possible to also add support for the humidity sensor, temperature sensors that are in the Box and the Bypass value. The documentation and example config were updated accordingly.

Great update!
Saw the change and immediate added it to my ESPHome Duco controller.
With the temperatures available now, we are able to control the Duco box as cooler in nights.
When inside temp is higher than outside temp, the airflow can be set to 100% and during daytime when outside is hot, you set it on auto to let the box handle co2.

I've added the Delta T to the controller by calculating diffs (- means cool air flow inside, + means hotter air flow inside):
sensor:

• platform: duco
  co2:
  • address: 4
    name: "CO2 Bedroom"
  • address: 3
    name: "CO2 Livingroom"
    temperature:
  • address: 4
    name: "Temperature Bedroom"
  • address: 3
    name: "Temperature Livingroom"
  • address: 2
    name: "Temperature Bathroom"
    filter_remaining:
    name: "Filter Time Remaining"
    flow_level:
    name: "Flow Level"
    time_remaining:
    name: "Mode Time Remaining"
    bypass:
    name: "Bypass"
    temperature_oda:
    id: aoin
    name: "Temperature Outdoor Air"
    temperature_eha:
    id: aoout
    name: "Temperature Outdoor Exhaust"
    temperature_sup:
    id: aiin
    name: "Temperature Supply To Room"
    temperature_eta:
    id: aiout
    name: "Temperature Indoor Exhaust"
• platform: template
  name: "Delta T AirFlow Temperature Inside"
  id: Tai
  unit_of_measurement: °C
  update_interval: 10s
  lambda: |-
  return (id(aiin).state - (id(aiout).state));
• platform: template
  name: "Delta T AirFlow Temperature Outside"
  id: Tao
  unit_of_measurement: °C
  update_interval: 10s
  lambda: |-
  return (id(aoin).state - (id(aoout).state));

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days.
If you are the author of this PR, please leave a comment if you want to keep it open. Also, please rebase your PR onto the latest dev branch to ensure that it's up to date with the latest changes.
Thank you for your contribution!

To use the changes from this PR as an external component, add the following to your ESPHome configuration YAML file:

external_components:
  - source: github://pr#7993
    components: [duco]
    refresh: 1h

(Added by the PR bot)

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

I did a quick rebase, also adding this comment to prevent the PR being closed.

There hasn't been any activity on this pull request recently. This pull request has been automatically marked as stale because of that and will be closed if no further activity occurs within 7 days.
If you are the author of this PR, please leave a comment if you want to keep it open. Also, please rebase your PR onto the latest dev branch to ensure that it's up to date with the latest changes.
Thank you for your contribution!

Memory Impact Analysis

Components: duco
Platform: esp32-idf

Note: This analysis measures static RAM and Flash usage only (compile-time allocation).
Dynamic memory (heap) cannot be measured automatically.
⚠️ You must test this PR on a real device to measure free heap and ensure no runtime memory issues.

This analysis runs automatically when components change. Memory usage is measured from a representative test configuration.

Hi, I'm really looking forward to give it a shot. Can I safely use the pins that supply 5V on the Duco to power a nodeMCU with the duco component installed on? Is their somewhere some documentation that I can follow, including some pictures?

Yes, you can use the 5V pin to provide power to a NodeMCU. The documentation you can find here: https://github.com/kokx/esphome-docs/blob/duco-component/components/duco.rst

Thanks so much for your effort @kokx. I have a Ducobox Focus and was able to connect an ESP32 using your project to it and am getting CO2 and Humidity readings from my 3 valves! Really wanted to get an insight and hopefully do some controlling with it later as well but I'm new to Coding, ESP32s and Home Assistant so diving straight into this I'm in a bit over my head. Anyways, I have some new components that maybe can be helpful to identify for other users with the Ducobox Focus: Type 14 (valve with RH sensor), Type 16 (Valve with CO2 sensor, If I remember correctly these are ones that are rated up to 30 m3/h or so instead of the standard 50 m3/h. They go up to 80+ m3/h without a problem but were cheaper to buy...)
Type 7 not sure, It might be the DucoTronic electrically controlled ventilation grill I have above my window:

[19:14:24.249][I][duco:206]: Discovered nodes:
[19:14:24.249][I][duco:208]: Node 1: type 17 (BOX)
[19:14:24.249][I][duco:208]: Node 2: type 14 (UNKNOWN)
[19:14:26.482][I][duco:208]: Node 3: type 16 (UNKNOWN)
[19:14:26.482][I][duco:208]: Node 4: type 16 (UNKNOWN)
[19:14:26.482][I][duco:208]: Node 5: type 9 (UC)
[19:14:26.496][I][duco:208]: Node 6: type 7 (UNKNOWN)
[19:14:26.496][I][duco:208]: Node 7: type 8 (UCBAT)

Thanks so much for your effort @kokx. I have a Ducobox Focus and was able to connect an ESP32 using your project to it and am getting CO2 and Humidity readings from my 3 valves! Really wanted to get an insight and hopefully do some controlling with it later as well but I'm new to Coding, ESP32s and Home Assistant so diving straight into this I'm in a bit over my head. Anyways, I have some new components that maybe can be helpful to identify for other users with the Ducobox Focus: Type 14 (valve with RH sensor), Type 16 (Valve with CO2 sensor, If I remember correctly these are ones that are rated up to 30 m3/h or so instead of the standard 50 m3/h. They go up to 80+ m3/h without a problem but were cheaper to buy...) Type 7 not sure, It might be the DucoTronic electrically controlled ventilation grill I have above my window:

[19:14:24.249][I][duco:206]: Discovered nodes: [19:14:24.249][I][duco:208]: Node 1: type 17 (BOX) [19:14:24.249][I][duco:208]: Node 2: type 14 (UNKNOWN) [19:14:26.482][I][duco:208]: Node 3: type 16 (UNKNOWN) [19:14:26.482][I][duco:208]: Node 4: type 16 (UNKNOWN) [19:14:26.482][I][duco:208]: Node 5: type 9 (UC) [19:14:26.496][I][duco:208]: Node 6: type 7 (UNKNOWN) [19:14:26.496][I][duco:208]: Node 7: type 8 (UCBAT)

Additional information when hooked up to the (old) installer tool using a usb cable:

Hi!

Great work on this, i'm using it succesfully on my Duco WTW DucoBox Energy for about half a year now.

My unit has an auto-bypass, which is nice but i'd like a bit more control over it.
The bypass sensor is nice, but on the unit i can change it from auto to manual on/off.
Is it possible to include the adaptive/auto/manual on/manual off as switches through the code?
I have been looking at the referenced API document, but can't find reference to that...

If there's anything i can do to help let me know,

Thank you!

Hi!

Great work on this, i'm using it succesfully on my Duco WTW DucoBox Energy for about half a year now.

My unit has an auto-bypass, which is nice but i'd like a bit more control over it. The bypass sensor is nice, but on the unit i can change it from auto to manual on/off. Is it possible to include the adaptive/auto/manual on/manual off as switches through the code? I have been looking at the referenced API document, but can't find reference to that...

If there's anything i can do to help let me know,

Thank you!

I don't want to hijack this pull but I understand where you are coming from, I have a Duco Energy Premium. I made a few changes and suggested these to the Author.

You can find it here, perhaps this may help you for now:
https://github.com/w1ll14m/esphome_duco/tree/duco-component

These changes are still quite experimental but seem to be working quite well for my Duco, though no guarantees for your system. I'm not responsible if you make it eat your cat or burn down your house ;)

My config:

duco:
  uart_id: duco_uart
  discovery: {}
  enable_advanced_features: true

text_sensor:
  - platform: duco
    serial:
      - name: "Serial Nr Box"
      - name: "Serial Nr Node 1"
        address: 1
      - name: "Serial Nr Node 2"
        address: 2
      - name: "Serial Nr Node 3"
        address: 3
    version:
      - name: "Version Box"
      - name: "Version Node 2"
        address: 2
      - name: "Version Node 3"
        address: 3
    error:
      - name: "Error Box"
      - name: "Error Node 2"
        address: 2
      - name: "Error Node 3"
        address: 3

select:
  - platform: duco
    mode:
      - name: "Mode Box"
      - name: "Mode node 2"
        address: 2
      - name: "Mode node 3"
        address: 3
    bypass:
      - name: "Bypass Control"
        address: 1
    adaptive_bypass:
      - name: "Adaptive Bypass Control"
    heater:
      - name: "Frost Protection Heater"
    passive_cooling:
      - name: "Passive Cooling"


sensor:
  - platform: duco
    temperature:
      - address: 1 #boxx
        name: "Box Temperature Sensor BOX1"
      - address: 2 #badkamer
        name: "Sensor Badkamer Temperature"
      - address: 3 #slaapkamer william
        name: "Sensor William Temperature"
      - address: 58
        name: "Box Temperature Sensor BOXINT58"

    humidity:
      - address: 1 #box
        name: "Box Humidity Sensor BOX1"
      - address: 2 #badkamer
        name: "Sensor Badkamer Humidity"
      - address: 58 #internal box sensor
        name: "Box Humidity Sensor BOXINT58"

    co2:
      - address: 3 #slaapkamer william
        name: "Sensor William CO2"

    filter_remaining:
      name: "Box Filter Time Remaining"
    flow_level:
      name: "Box Flow Level"
    time_remaining:
      name: "Box Mode Time Remaining"
    temperature_eha:
      id: aoout
      name: "Box Temperature Outdoor Exhaust"
    temperature_eta:
      id: aiout
      name: "Box Temperature Indoor Exhaust"
    temperature_sup:
      id: aiin
      name: "Box Temperature Indoor Supply"
    temperature_oda:
      id: aoin
      name: "Box Temperature Outdoor Air"
    bypass:
      name: "Box Bypass"
  - platform: template
    name: "Box Delta T AirFlow Temperature Inside"
    id: Tai
    unit_of_measurement: °C
    update_interval: 30s
    lambda: |-
      return (id(aiin).state - (id(aiout).state));
  - platform: template
    name: "Box Delta T AirFlow Temperature Outside"
    id: Tao
    unit_of_measurement: °C
    update_interval: 30s
    lambda: |-
      return (id(aoin).state - (id(aoout).state));

number:
  - platform: duco
    comfort_temperature:
      - name: "Zone1 Comfort Temperature 13"
        address: 0x13 #default address is 12?
      - name: "Zone2 Comfort Temperature 14"
        address: 0x14 #default address is 12?
    passive_cooling:
      - name: "Passive Cooling Setpoint"
    nightboost_max:
      - name: "Nightboost Max Ventilation Percentage"
    box_ventilation_min:
      - name: "Box Ventilation Min"
    box_ventilation_max:
      - name: "Box Ventilation Max"



uart:
  - id: duco_uart
    baud_rate: 57600
    tx_pin: GPIO3
    rx_pin: GPIO1
    rx_buffer_size: 256