Skip to content

Conversation

@isystemsautomation
Copy link
Contributor

@isystemsautomation isystemsautomation commented Oct 7, 2025

Brief description of the changes

This update significantly improves the documentation for the Homemaster OpenTherm Gateway:

Rewritten and reorganized README/index.md for clarity and structure
Added detailed YAML configuration examples for OpenTherm sensors, binary sensors, switches, and numbers
Included connection diagrams (24VDC, 230VAC, relay, 1-Wire, OpenTherm bus)
Added safety instructions based on hardware schematics
Unchecked "OTA Updates are provided via the update.http_request component" . It was mistakenly marked as supported. After using Take Control, users must update the configuration in the ESPHome Dashboard to match their specific boiler model and enable OpenTherm telemetry.

Type of changes

  • New device
  • Update existing device
  • Removing a device
  • General cleanup
  • Other

Checklist:

  • There are no passwords or secrets references in any examples.
    The only exceptions are !secret wifi_ssid and !secret wifi_password.
  • The wifi or ethernet block has no static / manual ip address specified.
  • The first configuration provided should be hardware definitions only.
    A more involved example can be provided in a separate configuration block.

Made for ESPHome Checklist

  • Project is powered by an ESP32 or supported variant such as C3, C6, S2, S3 etc.
  • Project is using ESPHome firmware
  • Project name cannot contain ESPHome except in the case of ending with for ESPHome
  • ESPHome configuration is open source and available for end users to modify/update
  • If the device uses Wi-Fi:
    • Configuration contains esp32_improv: (documentation)
    • Configuration contains improv_serial: if there is a USB port (documentation)
  • Users should be able to apply updates to your device:
    • Device can be "taken control" of by the user using the ESPHome Builder
      • Configuration includes dashboard_import: to facilitate this (documentation)
      • Configuration contains the ota.esphome component (documentation)
      • Serial flashing is not disabled
      • There are no references to secrets in the configuration
      • There are no passwords in the configuration
      • There are no static IP addresses in the configuration
      • The configuration must be valid, compile and run successfully without any user changes after taking control
      • Every entity/component (sensor, switch, etc.) must have an id defined
    • OTA Updates are provided via the update.http_request component (documentation)

@netlify
Copy link

netlify bot commented Oct 7, 2025

Deploy Preview for esphome-devices ready!

Name Link
🔨 Latest commit 965651e
🔍 Latest deploy log https://app.netlify.com/projects/esphome-devices/deploys/69010413752ab500080bfbba
😎 Deploy Preview https://deploy-preview-1263--esphome-devices.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 80 (🟢 up 1 from production)
Accessibility: 97 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added made-for-esphome-pending Pending approval for Made for ESPHome made-for-esphome labels Oct 7, 2025
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR has been labeled as Made for ESPHome and is pending review. Please complete the checklist added to the description above.

@esphome
Copy link

esphome bot commented Oct 7, 2025

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.

@esphome esphome bot marked this pull request as draft October 7, 2025 09:41
@isystemsautomation isystemsautomation marked this pull request as ready for review October 7, 2025 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

made-for-esphome made-for-esphome-pending Pending approval for Made for ESPHome

Projects

Status: Pending

Development

Successfully merging this pull request may close these issues.

1 participant