Skip to content

Add reference for other enocean gateways #36275

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 5 commits into
base: current
Choose a base branch
from
Draft

Add reference for other enocean gateways #36275

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
7ba74e4
Add reference for other enocean gateways
lvlerber Dec 10, 2024
72e045f
Update enocean.markdown added unsupported gateways
lvlerber Dec 28, 2024
00eb3fa
Merge branch 'current' into patch-1
lvlerber Dec 28, 2024
c4d3e98
Merge branch 'home-assistant:current' into patch-1
lvlerber Feb 7, 2025
e7a48b8
Merge branch 'current' into patch-1
lvlerber Feb 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion source/_integrations/enocean.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,16 @@ related:

The [EnOcean](https://en.wikipedia.org/wiki/EnOcean) standard is supported by many different vendors. There are switches and sensors of many different kinds, and typically they employ energy harvesting to get power such that no batteries are necessary.

The EnOcean integration adds support for some of these devices. You will need a controller like the [USB300](https://www.enocean.com/product/usb-300/) in order for it to work.
The EnOcean integration adds support for some of these devices. You will need a controller like the [USB300](https://www.enocean.com/product/usb-300/) in order for it to work.

## Unsupported controllers/gateways

The following gateways are not supported by the integration:
- All gateways that are based on the ESP2 protocol. You can find an excellent guide to controllers and suitable integrations at this [gateway overview](https://github.com/grimmpp/home-assistant-eltako/blob/main/docs/gateways/readme.md).
Copy link
Member

Choose a reason for hiding this comment

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

We shouldn't be sending users to library documentation. If this is relevant for the user reading this page, we should include it here.

../Frenck

Copy link
Author

Choose a reason for hiding this comment

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

You're right. The relevant information is that a custom integration exists for the eltako gateways and that the gateways are explicitely listed. So I changed accordingly.

Copy link
Member

Choose a reason for hiding this comment

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

Let's remove that link in that case, as the main comment still remain :D

Comment on lines +33 to +34
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
The following gateways are not supported by the integration:
- All gateways that are based on the ESP2 protocol. You can find an excellent guide to controllers and suitable integrations at this [gateway overview](https://github.com/grimmpp/home-assistant-eltako/blob/main/docs/gateways/readme.md).
Gateways that are based on the ESP2 protocol are not supported by this integration, including the devices listed below. For Eltako gateways, there is a custom integration.

would this be an acceptable alternative?

Copy link
Author

Choose a reason for hiding this comment

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

It is acceptable; People looking for homeassistant and FTS14KS (for instance) will know they have to search a custom integration. It would have been nice to have a link, but I understand that this is not possible. Do I have to do something now, or will you take it from here?

Copy link
Contributor

Choose a reason for hiding this comment

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

Good to know. Thank you for your quick feedback! I will wait also for approval from the reviewers.

Copy link
Member

Choose a reason for hiding this comment

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

We shouldn't be discussing custom integration in our documentation.

- Eltako FAM14
- Eltako FGW14-USB
- Eltako FAM-USB
- Eltako FTK14TS

There is currently support for the following device types within Home Assistant:

Expand Down