ulope
(Ulrich Petri)
October 9, 2022, 10:03pm
1
“Friends of Hue” are battery-less ZGP (Zigbee green power) wall switches that are very popular in Europe. They work with a hue bridge as well as deConz but not with ZHA.
There’s an open issue in zigpy for two and a half years.
opened 08:25AM - 30 Mar 20 UTC
Please consider adding support for ZGP (Zigbee Green Power) specification standa… rd subset in zigpy and for/in its radio libraries.
https://csa-iot.org/wp-content/uploads/2022/01/docs-14-0563-18-batt-Green-Power-Basic-specification-v1.1.1.pdf
https://zigbeealliance.org/wp-content/uploads/2019/11/docs-09-5499-26-batt-zigbee-green-power-specification.pdf
These type of Zigbee devices are something also referred to as Green Power Device (GPD) or Green Power Devices (GPDs).
http://software-dl.ti.com/simplelink/esd/simplelink_cc26x2_sdk/2.30.00.34/exports/docs/zstack/html/zigbee/gpd_application_overview.html
https://www.ti.com/lit/an/swra615a/swra615a.pdf
https://www.silabs.com/documents/public/user-guides/ug103-15-green-power-fundamentals.pdf
https://www.silabs.com/documents/public/user-guides/ug392-using-sl-green-power-with-ezp.pdf
The reason for the request is that you can already buy a few Zigbee Green Power enabled switches/remotes made for home automation, and according to the Zigbee Cluster Library Specification revision 7 (ZCL7), every Zigbee 3.0 device with routing capabilities (router or coordinator) must implement Green Power Basic Proxy (GPBP) v1.1.1 functionality for forwarding compatibility to be granted Zigbee 3.0 Certification in order to further support Zigbee Green Power capabilities.
Should be noted that a Zigbee coordinator can not normally connect directly to those Zigbee Green Power enabled switches/remotes as you need to bind them to a mains-powered device like a Zigbee lightbulb or a relay.
- https://zigbeealliance.org/solution/green-power/
The requirements to run a Zigbee Green Power is found in the document from Texas Instruments:
![image](https://user-images.githubusercontent.com/6320001/182648825-a122224f-e865-401d-8b6f-900778fa35ad.png)
Summery; ZGP (Zigbee Green Power), a.k.a. "Zigbee GreenPower", is a subset feature of Zigbee that allows for extreme low-power and energy-harvesting technology to be used directly with the Zigbee stack. Using Zigbee Green Power, certain home automation wireless devices (end devices) may be powered by either different self-powered energy harvesting solutions or switches and sensors that can operate for up to a decade on a single battery coin-cell battery. Energy harvesting technology enables the maintenance-free battery-less devices (end devices) such as switches and remotes operating in a Zigbee network.
See [zigbee-herdsman PR #92](https://github.com/Koenkk/zigbee-herdsman/pull/92) for proof-of-concept as ZGP is already supported in zigbee-herdsman / Zigbee2mqtt (Z2M) projects:
- https://github.com/Koenkk/zigbee-herdsman/pull/92
- https://github.com/Koenkk/zigbee2mqtt.io/blob/develop/docs/devices/GreenPower_On_Off_Switch.md
Most common examples of Zigbee Green Power devices for home automation are rocker wall switches. Certified ZGP products:
- https://zigbeealliance.org/zigbee_products/?product_type=certified_product&se=green+power
- https://zigbeealliance.org/news_and_articles/alliance-augments-its-green-power-program/
Most popular are devices based on Zigbee 3.0 pre-certified PTM215ZE/PTM215Z and PTM216Z modules from EnOcean:
- https://www.zigbee2mqtt.io/devices/PTM_215ZE.html
- https://www.zigbee2mqtt.io/devices/PTM_215Z.html
- https://www.zigbee2mqtt.io/devices/PTM_216Z.html
EnOcean PTM215ZE/PTM215Z and PTM216Z modules use energy converter for motion energy harvesting for battery-less operation that is sold to OEM/ODM radio modules which create products:
- [EnOcean self-powered Zigbee product series and modules for OEM](https://www.enocean.com/en/products/enocean_modules_24ghz/)
- [EnOcean Easyfit Single / Double Rocker Wall Switch for Zigbee - EWSSZ / EWSDZ](https://www.enocean.com/en/products/enocean_modules_24ghz/easyfit-single-double-rocker-wall-switch-for-zigbee-ewssz-ewsdz/)
- [EnOcean Easyfit Single / Double Rocker Wall Switch for Zigbee - EWSSZG / EWSDZG](https://www.enocean.com/en/products/enocean_modules_24ghz/easyfit-single-double-rocker-wall-switch-for-zigbee-ewsszg-ewsdzg/)
- [EnOcean PTM 215ZE / PTM 215Z (PTM215ZE/PTM215Z) module](https://www.enocean.com/en/products/enocean_modules_24ghz/ptm-215ze/)
- [EnOcean PTM 216Z (PTM216Z) module](https://www.enocean.com/en/products/enocean_modules_24ghz/ptm-216z/)
- [EnOcean PTM 536Z (PTM536Z) Transmitter module with enhanced security features](https://www.enocean.com/en/products/enocean_modules_24ghz/ptm-536z/)
- [EnOcean PTM 535ZB (PTM535ZB) Transmitter module with enhanced security features with both ZGP and BLE radio](https://www.enocean.com/en/products/enocean_modules_24ghz/ptm-535z/)
- [EnOcean PTM 535Z (PTM 535Z) Transmitter module with enhanced security features](https://www.enocean.com/en/products/enocean_modules_24ghz/ptm-535z/)
- [EnOceanECO 200 (ECO200) Energy converter for motion energy harvesting](https://www.enocean.com/en/products/enocean_modules_24ghz/eco-200/)
- [EnOcean 2 click Clickboard from MikroElektronika for TCM 515Z (TCM515Z)](https://www.enocean.com/en/products/enocean_modules_24ghz/enocean-2-click/)
- [EnOcean TCM 515Z (TCM515Z) Transceiver module for programmable system components](https://www.enocean.com/en/products/enocean_modules_24ghz/tcm-515z/)
Friends of Hue partnership switches from ABB (Sweden), Illumra (USA), Kichler (USA), MAKRIS by Imoon (Italy), Vimar (Italy), Busch-Jaeger (Germany), Senic (Germany), Niko (Belgium), Sunricher (Hong Kong), Koizumi (Japan), Legrand (France), and John Lewis (UK) which I believe all use either the older EnOcean PTM 215ZE module or the newer EnOcean PTM 216Z module.
- https://zigbeealliance.org/zigbee_products/ptm215z-foh/
- https://www.signify.com/global/our-company/news/press-releases/2018/20180830-new-switch-and-new-luminaire-partners-offer-more-choice-in-design-and-control-of-your-philips-hue-smart-lights
- https://community.smartthings.com/t/theyre-here-new-green-energy-battery-free-wall-switches-for-hue-bridge-illumra-busch-jaeger-etc/135280
- https://www.docs.lighting.philips.com/en_gb/oem/download/xitanium/SCP_PHIL_170248_PMT215Z_table_A03.pdf
- https://www.docs.lighting.philips.com/en_gb/oem/download/connected-lighting-solutions/switch-commissioning-weblink1.pdf
Phoscon (dresden electronic) posted these instructions for paring Friends of Hue switches with their deCONZ solution here:
- https://phoscon.de/en/support#pairing-friends-of-hue-switch
Examples Philips Hue compatible ZGP switches:
- [Philips Hue Click](https://runlesswire.com/click_philips_hue/) - Same as Philips Hue Tap wall-switch below?
- [Philips Hue Tap (Wall Switch version)](https://www.cnet.com/news/this-boring-switch-might-be-the-best-philips-hue-gadget-yet/#ftag%3DCAD590a51e)
- [Philips Hue Tap Switch (Remote Control version) Model 9290011152X](https://zigbee.blakadder.com/Philips_9290011152X.html)
- [Philips UID8450 single-rocker switch (UID8450/10) and UID8460 double-rocker switch (UID8460/10)](https://www.lighting.philips.com/api/assets/v1/file/content/4bbf1e4388e44f3aa8e0a9e00123308d/UID8450-UID8460_SpSh_20190125_Fin.pdf) ZigBee Green Power switch and scene selector
- [ABB smart light switch for “Friends of Hue”](https://new.abb.com/low-voltage/products/residential-product/friends-of-hue-smart-switch)
- [Illumra ZBT-S1AWH (single rocker, white) for “Friends of Hue”](http://illumra.com/products/wireless-light-switches/zigbee-switch)
- [Niko Friend of Hue Smart Switch](https://www.niko.eu/en/our-products/switches-and-sockets/friends-of-hue)
- [Senic GIRA Friends of Hue Outdoor Switch](https://www.senic.com/friends-of-hue-outdoor-switch)
- https://zigbee.blakadder.com/Senic_100119.html
- Sunricher Kinetic Switch 4 (SR-ZGP2801K4-FOH)
- Sunricher Battery Switch (SR-ZGP2801K4-FOH-E)
- [LED TRADING Dimmer Switch](https://www.amazon.de/-/en/Philips-Friends-flush-mounted-surface-mounted-version/dp/B08GKP7HPJ)
- [LED TRADING Zigbee Push Button Coupler](https://www.amazon.de/-/en/Philips-Friends-flush-mounted-surface-mounted-version/dp/B08K3C44J4)
- Legrand Batteryless Switches
- https://zigbeealliance.org/zigbee_products/batteryless-2-on-off-switch-green-power/
- https://zigbeealliance.org/zigbee_products/batteryless-2-toggles-switch-green-power/
- https://zigbeealliance.org/zigbee_products/batteryless-toggle-switch-green-power/
- https://zigbeealliance.org/zigbee_products/batteryless-shutter-switch-green-power-2/
- https://zigbeealliance.org/zigbee_products/batteryless-on-off-switch-green-power/
Technical and developer documentation:
- https://zigbeealliance.org/wp-content/uploads/2019/11/Green-Power-White-Paper.pdf
- https://www.silabs.com/community/wireless/zigbee-and-thread/knowledge-base.entry.html/2020/02/13/zigbee_green_power-fKk4
- https://www.silabs.com/documents/public/user-guides/ug103-15-green-power-fundamentals.pdf
- https://www.silabs.com/documents/public/user-guides/ug392-using-sl-green-power-with-ezp.pdf
- https://www.nxp.com/docs/en/user-guide/JN-UG-3095.pdf
- https://training.ti.com/zigbee-green-power-enable-battery-less-devices
- https://www.qorvo.com/resources/d/qorvo-zigbee-green-power-multi-sensor-comparison-to-battery-powered-zigbee-devices-white-paper
PS: Zigbee Green Power (ZGP) V2 is also included as a subset in the Zigbee 3.0 specification (Z3), but that is based on V1 Green Power energy-harvesting technology that was a subset of the Zigbee PRO standard.
If HA wants to become a truly mass appeal solution lacking support like this is not cool.
apg
October 18, 2022, 9:03pm
2
Hi
I’m new to ZHA and coming from deCONZ. I was very surprised that zha doesn’t support my Feller Friends of Hue Switch. Is there a way to support this with some beers/ coffees?
3 Likes
Hedda
(Hedda)
October 24, 2022, 8:51am
3
FYI, this is really asking the same as this other post about the ZGP (Zigbee Green Power) specification:
I switched from deConz to ZHA and found that many of my zigbee devices was not supported.
Searched the forums and found this:
Nothing has happened since!
As a workaround you should know that Zigbee Green Power is supported by Zigbee2MQTT and also deCONZ/Phoscon as well, however, it is not yet supported in Home Assistant’s own ZHA integration as no ZHA/zigpy developer has implemented support for ZGP in the zigpy library that it depends on as of yet.
As I understand it, allZigbee gateways/hubs that support ZGP has the requirements that ZGP devices connect indirectly through other Zigbee 3.0 router devices which in turn act as repeaters to pass along ZGP messages. That is, Zigbee routers do not really convert the ZGP messages, instead they just pass the messages along, meaning Zigbee gateway/hub application still need to explicitly support ZGP.
So in the end, Home Assistant need more volunteering Python developer(s) with interest in low-level Zigbee support to get that existing code pull request and open a new code pull request for the zigpy library (ZHA dependency) or create new code that is acceptable for merger:
https://github.com/zigpy/zigpy/pull/656
zigpy:dev
← jeedom:dev
opened 07:17PM - 01 Feb 21 UTC
You might have many Zigbee Green Power (ZGP) devices, but statistically there are not many different ZGP devices on the market that are actually different products, (as most actually contain the same type of ZGP module made by EnOcean), however those available a relatively popular because of the “Friend of Hue” series as well as a few Philips Hue branded products that use the ZGP technology:
https://community.home-assistant.io/t/zha-might-soon-get-support-for-zgp-zigbee-green-power-devices/277149
teekert
(Freek)
December 10, 2023, 4:25pm
4
Although I find the wording of OP a bit strong and reeking of misplaced entitlement… I do agree that having support for FOH battery-less type switches in ZHA would be absolutely great.
I’m not a developer though so I no value to bring accept for the monetary kind. So if I can donate towards this goal… or send some smart person a specific wall switch, I like to hear how to do that. Thanx!
1 Like
justbaj
(Dan)
January 29, 2024, 1:18pm
5
is this zigbee green power for ZHA really still missing?
does anybody know, why it takes so long?
is there a workaround with a EnOcean Dongle?
allard77
(Allard K)
January 29, 2024, 5:20pm
6
It’s taking so long because nobody volunteered to spend their time on this, and those who are paid to work on Home Assistant have done other things that they felt needed to be done.
I haven’t done it because a: I am not an experienced zigpy developer so I would need to spend a lot of time learning the code and details of the standard and b: I don’t have an interest in these devices, I have plenty of zigbee devices that work with ZHA.
1 Like
M92718
February 2, 2024, 9:04am
7