home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
4.54k stars 7.08k forks source link

Zigbee Energy Profile Devices #31669

Open monkeyatcomputer opened 4 months ago

monkeyatcomputer commented 4 months ago

Feedback

The article states that there aren't any devices with local API. I don't believe this to be correct.

I'm using a Rainforest Automation EAGLE-200 with Rainforest Eagle integration and it's reading instantaneous usage (W), and import/export counters (kWh) via the eagle's local API. Believe the current version is called an "EAGLE 3".

I'm in the state of Victoria, Australia where the state government mandated the use of smart meters including Zigbee radios (meant for in home energy displays, and demand response devices). Our electricticity distributor AusNet has a website where we can register the deivce and a few days later it just starts working.

URL

https://www.home-assistant.io/docs/energy/electricity-grid/

Version

2024.2.5

Additional information

No response

agoode commented 3 months ago

Yes, this integration uses a local API: https://www.home-assistant.io/integrations/rainforest_eagle/

Hedda commented 2 days ago

See pull request -> https://github.com/home-assistant/home-assistant.io/pull/33461

But note that the Rainforest Eagle integration does not support have native support for Zigbee Smart Energy Standard (devices that uses Zigbee Smart Energy Profile), as instead they have a propriatory gateway can translate and covert it to their own custom API, so the integration component itself inside Home Assistant does not natively support the Zigbee Smart Energy Standard.

Also see -> https://www.home-assistant.io/integrations/zha#limitations

So it is really like comparing the native ZHA integration with other integrations that communicate only with for third-party gateways/bridges/hubs using the manufacturers custom APIs, such as Philips Hue Bridge, IKEA Tradfri Gateway, and Samsung SmartThings Hub. There is no Zigbee commands in the integration component itself inside Home Assistant for any of those as they totally abstract away anything Zigbee specific so they devices themself could just as well be using any other IoT protcol and niether the developers or end-users would know the difference inside the integration.

Connect to devices that uses Zigbee Smart Energy Standard

Zigbee Smart Energy Standard is a wireless protocol designed by the CSA (Connectivity Standards Alliance, formerly the Zigbee Alliance) to specifically target industrial and commercial utilities to enable real-time monitoring of energy consumption and actively managing energy consumption at the end-user level. This wireless protocol is supported by some utility meters for monitoring electricity, gas, and water consumption in the US, EU, UK, and Australia.

It is also referred to “Zigbee SE” or "ZSE" profile in the specification, and note that it should not be confused with other Zigbee profiles, because Zigbee Smart Energy Profile is not part of the common "Zigbee 3.0" suite of profiles that are supported tHome Assistant's native Zigbee Home Automation integration, (as the Home Assistant's ZHA integration currently only have implemented support for other Zigbee profiles that are specifically made for home automation, lighting or occupancy, and not devices that just use the Zigbee Smart Energy" Profile).

Currently, the only solution we are aware of that can use devices that only support the "Zigbee Smart Energy" profile is Rainforest Automation's EAGLE gateway appliances that can be used via the Rainforest Eagle integration for Home Assistant, (those third-party gateways made for reading Australian electricity meters, though it abstracts and translates that protocol to present the data via their custom local API, and is as such not a native Zigbee Smart Energy" integration).