boneIO ESPHome Community Packages

This repository contains a collection of ESPHome packages created by the boneIO community. These packages are designed to be easily imported into your ESPHome configurations using the packages section.

Usage

To use these packages in your ESPHome configuration, add them to the packages: section of your YAML configuration file:

packages:
  my_package:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: package_name.yaml
        vars: 

Replace package_name.yaml with the name of the specific package you want to use. Check inside package_name.yaml for the available variables.

For modbus devices we require following variables:

• modbus_controller_id - ID of the modbus controller
• name - Name of the device
• modbus_device_id - ID of the modbus device
• modbus_device_address - Address of the modbus device
• modbus_id - ID of the modbus bus
• update_interval - Update interval of the device

Compatibility

These packages are compatible with ESPHome version 2025.3 and newer.

Available Packages

• List of available packages will be updated as they are added to the repository

Modbus devices

Sofar Inverter KTL

Code snippet:

  sofar_inverter:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: sofar-inverter.yaml
        vars: 
          modbus_controller_id: 'sofar_modbus'
          device_name: 'Sofar'
          modbus_device_id: 'sofar_modbus'
          modbus_device_address: '0x01' #CHANGE THIS
          modbus_id: 'boneio_modbus'
          update_interval: '60s'

Liquid sensor measuring depth of liquid / RS485

Code snippet:

  liquid_sensor:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: liquid-sensor.yaml
        vars: 
          modbus_controller_id: 'liquid_modbus'
          device_name: 'Liquid sensor'
          modbus_device_id: 'liquid_modbus'
          modbus_device_address: '0x01' #CHANGE THIS
          modbus_id: 'boneio_modbus'
          update_interval: '60s'
          width: '10'
          length: '10'

SDM630 Energy Meter

Code snippet:

  sdm630:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: sdm630.yaml
        vars: 
          modbus_controller_id: 'sdm630_modbus'
          device_name: 'SDM630'
          modbus_device_id: 'sdm630_modbus'
          modbus_device_address: '0x01' #CHANGE THIS
          modbus_id: 'boneio_modbus'
          update_interval: '60s'

SDM120M Energy Meter

Code snippet:

  sdm120m:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: sdm120m.yaml
        vars: 
          modbus_controller_id: 'sdm120m_modbus'
          device_name: 'SDM120M'
          modbus_device_id: 'sdm120m_modbus'
          modbus_device_address: '0x01' #CHANGE THIS
          modbus_id: 'boneio_modbus'
          update_interval: '60s'

boneIO Edge Temp and Humidity sensor

Code snippet:

  boneio_edge_temp:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: boneio-edge-temp.yaml
        vars: 
          modbus_controller_id: 'boneio_edge_temp'
          device_name: 'boneIO Edge Temp'
          modbus_device_id: 'boneio_edge_temp'
          modbus_device_address: '0x01' #CHANGE THIS
          modbus_id: 'boneio_modbus'
          update_interval: '60s'

Thessla Green Airpack 4

Code snippet:

  thessla_green_airpack_4:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: thessla-green-airpack-4.yaml
        vars: 
          modbus_controller_id: 'thessla_green_airpack_4_modbus'
          device_name: 'Thessla Green Airpack 4'
          modbus_device_id: 'thessla_green_airpack_4_modbus'
          modbus_device_address: '0x01' #CHANGE THIS
          modbus_id: 'boneio_modbus'
          update_interval: '60s'

CAN bus devices

Zehnder ComfoAir Q (CAN bus)

Integration for Zehnder ComfoAir Q heat recovery units via the native CAN bus, using the external component belsander/esphome-zehnder-comfoair.

Requires an ESP32 with a CAN transceiver wired to GPIO5 (TX) and GPIO4 (RX) (hardcoded in the package — edit the file if you use different pins).

The package declares its own external_components entry, so nothing extra needs to be added to your base configuration.

Code snippet:

  zehnder_comfoair_q:
    url: https://github.com/boneIO-eu/esphome-packages/
    files:
      - path: zehnder-comfoair-q.yaml
        vars:
          device_name: 'Zehnder'
          comfoair_id: 'comfoair'
          fan_id: 'comfoair_fan'
          filter_time: '5s'
          filter_send_every: '1'
          filter_window_size: '3'

Contributing

Contributions are welcome! Feel free to submit pull requests with new packages or improvements to existing ones.

License

GPL License. See the LICENSE file for details.