Hedda
(Hedda)
March 9, 2022, 1:25pm
11
Unfortunately, there is no timeframe since no zigpy developer(s) is currently working on code for ZGP.
puddly posted comment https://github.com/zigpy/zigpy/issues/656#issuecomment-947951634 (in PR https://github.com/zigpy/zigpy/pull/656 ) that the current patch code from that pull request can not be accepted today as it is until it has been slightly re-written as the code patch for it will need to be cleaned up to be more readable by someone (e.i. a volunteering Python developer) before it can be acceptable for re-review before it can be merged, so new developer volunteer(s) are wanted to fix/change the previously submitted code patch!
puddly also mentioned in that same comment that zigpy developers have since that original patch was originally submitted done a ton of other underlying background work in refactoring the zigpy library code which could indirectly make a new patch for ZGP be easier to implementation (and even more unrelated changes have been merged into zigpy for the better since puddly’s comment), such as code restructuring and refactoring, cleanups, and other improvements or changes to the zigpy library and its radio libraries, many smaller and a few major, that in all should in theory now make it possible to write cleaner code patches today if someone like to step up and pick up this project again.
By the way, one of the major other indirectly related changes is that zigpy has otherwise been updated to be compliant with the Zigbee Cluster Library Specification revision 7 (ZCL7) and Zigbee Cluster Library Specification revision 8 (ZCL8) which among other things does state that 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 (i.e. ZGP routing capability) to be granted Zigbee 3.0 Certification in order to further support Zigbee Green Power capabilities.
PS: Remember ZHA/zigpy are currently just a hobby projects developed by volunteers without pay, as such new features will probably only be priotized if volteering developers have a personal interest in it.
PPS: I believe one thing that could maybe could help speed this along would be to donate ZGP devices to lead developers puddly and Adminiuga as might increase their interest if they owned ZGP devices.
4 Likes
haaino
(Haaino)
November 18, 2022, 9:44pm
13
I’m curious. Any updates on this topic?
Hedda
(Hedda)
November 20, 2022, 9:01am
14
The last I heard/read was that developer(s) volunteers were still wanted/needed to clean up the code patch from the pull request previously submitted by zoic21 to the zigpy library and re-submit new a PR.
Please read my previous comment above → https://community.home-assistant.io/t/zha-might-soon-get-support-for-zgp-zigbee-green-power-devices/277149/11
@majkrzak apparently commented in that discussion a few days ago offering to volunteer but seems he noted that do not exactly know what to fix/change in order to make it acceptable for a new review:
zigpy:dev
← jeedom:dev
opened 07:17PM - 01 Feb 21 UTC
There is further general development discussion about it in the feature request for for it in zigpy repo:
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.
miksen
(Michael Thomsen)
January 9, 2023, 11:50am
15
I recently purchased the new SkyConnect coordinator, partly as a way of supporting Nabu Casa, and partly to get onto what I believed would be the best supported Zigbee coordinator for H.A.
After receiving it I learned that it uses a chipset that still only has experimental support in Z2M. So I converted my H.A. setup to use ZHA. That generally works great – and actually seems more stable and responsive then Z2M – but I’m no longer able to use my six green-power based control buttons (all based on EnOcean PTM 215Z)
If SkyConnect and ZHA are meant to power the premier H.A. experience, then this issue with no green power support really needs to get resolved.
Hedda
(Hedda)
January 9, 2023, 11:58am
16
Suggest that you also post that comment to this inofficial SkyConnect forum thread as I do not think there is any official feedback communication channel for Nabu Casa support of the SkyConnect(?):
1 Like
Hedda
(Hedda)
January 9, 2023, 12:30pm
17
FYI, this pull request for ZHA documentation would at least mention this limitation in an introduction:
https://github.com/home-assistant/home-assistant.io/pull/24494
home-assistant:current
← Hedda:patch-79
opened 02:00PM - 10 Oct 22 UTC
## Proposed change
<!--
Describe the big picture of your changes here to … communicate to the
maintainers why we should accept this pull request. If it fixes a bug
or resolves a feature request, be sure to link to that issue in the
additional information section.
-->
Add a short ZHA integration introduction with Zigbee diction and essential limitations as a summary meant for new end users.
I think this will help explain the most essential questions that many potential ZHA users (and also users new to Zigbee) commonly have and ask before they buy an adapter and install the ZHA integration or are first asked directly after they have installed ZHA.
The purpose of this short introduction is to help new users quickly get up to speed on the hardware requirements for ZHA as well as mention the minimum essential Zigbee terminology that is really needed to get easily up and running with the ZHA integration.
## Type of change
<!--
What types of changes does your PR introduce to our documentation/website?
Put an `x` in the boxes that apply. You can also fill these out after
creating the PR.
-->
- [ ] Spelling, grammar or other readability improvements (`current` branch).
- [x] Adjusted missing or incorrect information in the current documentation (`current` branch).
- [ ] Added documentation for a new integration I'm adding to Home Assistant (`next` branch).
- [ ] I've opened up a PR to add logo's and icons in [Brands repository](https://github.com/home-assistant/brands).
- [ ] Added documentation for a new feature I'm adding to Home Assistant (`next` branch).
- [ ] Removed stale or deprecated documentation.
## Additional information
<!--
Details are important, and help maintainers processing your PR.
Please be sure to fill out additional details, if applicable.
-->
- Link to parent pull request in the codebase:
- Link to parent pull request in the Brands repository:
- This PR fixes or closes issue: fixes #
## Checklist
<!--
Put an `x` in the boxes that apply. You can also fill these out after
creating the PR. If you're unsure about any of them, don't hesitate to ask.
We're here to help! This is simply a reminder of what we are going to look
for before merging your code.
-->
- [x] This PR uses the correct branch, based on one of the following:
- I made a change to the existing documentation and used the `current` branch.
- I made a change that is related to an upcoming version of Home Assistant and used the `next` branch.
- [x] The documentation follows the Home Assistant documentation [standards].
[standards]: https://developers.home-assistant.io/docs/documenting/standards
## Introduction
ZHA integration follows the official Zigbee specification standards and uses one Zigbee Coordinator to set up and control a Zigbee network. Once ZHA has been installed and the Zigbee Coordinator is configured you will be able to directly join/pair Zigbee Router Device and Zigbee End Device products to that Zigbee network, regardless of the manufacturer and brand of that Zigbee-based product. Please see the respective sections below for compatible Zigbee radio modules hardware (physical radio adapter) and information on supported Zigbee devices.
Before installing the integration you will need to buy and connect a Zigbee Coordinator adapter to the computer running the Home Assistant installation. The general recommendation is to buy a newer model of Zigbee Coordinator adapter hardware and to flash the latest firmware to it, the reason that is it will usually offer better interoperability with all functions of most Zigbee 3.0 compliant devices on the market.
Supported devices are Zigbee Router Devices, which are normally mains-powered that act as Zigbee signal repeaters within the Zigbee network mesh to extend its range and improve coverage, and Zigbee End Devices, which will not act as Zigbee signal repeaters and are usually but not always battery-operated sensors.
### Limitations
Note that ZHA only supports connecting one dedicated Zigbee Coordinator adapter with a single Zigbee network and that the Zigbee Coordinator adapter cannot already be connected or used by any other application. Any devices that are or have previously been connected to another Zigbee implementation will also need to first be reset to their factory default settings before they can be paired/joined to ZHA, please see each device manufacturer’s documentation.
ZHA does not yet support devices that can only use the (“Zigbee Green Power”) profile which is used in a few batteryless self-powered or energy harvesting devices, (such as for example; Philips Hue Click, Philips Hue Tap, and some “Friends of Hue” partnership switches). The reason for this is that ZGP profile support has not yet been implemented in the zigpy library.
ZHA does not support devices that can only use the ZSE (“Zigbee Smart Energy”) profile because “Zigbee SE” is not part of the Zigbee 3.0 specification standard and thus not implemented in the Zigbee stack of commonly available Zigbee Coordinator adapters.
Hedda
(Hedda)
June 1, 2023, 12:44pm
18
Based on pull requests for the zigpy project it looks like nworbneb started working on ZGP support:
zigpy:dev
← nworbneb:dev
opened 10:04AM - 22 May 23 UTC
This will allow enumerations of greenpower clusters in ZHA quirks.
Ref: https… ://zigbeealliance.org/wp-content/uploads/2019/11/docs-09-5499-26-batt-zigbee-green-power-specification.pdf (page 73)
zigpy:dev
← nworbneb:zgp
opened 10:20AM - 29 May 23 UTC
## Proposed change
<!--
Explain your proposed change below.
-->
This is … purely a documentation excercise, to enhance readability of quirks, with no functional impact.
## Additional information
<!--
Please include any additional information that is important to this PR.
For example, if this PR is a potentially breaking change, mention that here.
If this PR requires other PRs to be merged in HA Core or other projects, mention that.
Lastly, if this PR fixes a specific issue, please include "Fixes #xxxx".
-->
Requires merged zigpy pull to add Zigbee Green Power enumerations (https://github.com/zigpy/zigpy/pull/1213)
## Checklist
<!--
Put an 'x' in all boxes that apply.
Note: You do not need to tick all boxes before creating a PR.
-->
- [x] The changes are tested and work correctly
- [x] `pre-commit` checks pass / the code has been formatted using Black
- [ ] Tests have been added to verify that the new code works
6 Likes
Utty88
(Utty88)
July 6, 2023, 9:00am
19
As those PRs are merged and zigpy got merged to HA in the 2023.7 release.
Is it finally possible to connect a ZGP device to ZHA?
2 Likes
Hedda
(Hedda)
July 7, 2023, 8:44am
20
Not sure, I do not yet own any ZGP (Zigbee Green Power) devices so I can not actually test it myself.
Maybe all you who do own ZGP devices now test pairing/joining it to Home Assistent 2023.7 and report their results to to zigpy developers as “device support request” issues to zha-device-handlers repo?
It does look like initial ZGP support has very recently been added to zigpy (the Zigbee stack library that the ZHA integration depends on), which is only bumped in Home Assistant 2023.7 release (and later).
So at least now there a chance that ZHA and zha-device-handlers (zha-quirks) developers could add handler/converter code to support a ZHA Device Handler (ZHA quirk) for individual ZGP devices, (though the ZHA integration code might still need some new additions too).
I would suggest try to post feedback and details to that new or existing device support request and then wait to see if ZHA/zigpy developers are interested in looking at it, perhaps together with developers there you can resolve the missing pieces for specific devices (but be aware that since ZGP is not exactly standard Zigbee devices so could very well be that they will need to have that specific device you want working themself for them to develop needed support for it).
Suggest that you all go ahead post new “device support request” issues to the zha-device-handlers repository on GitHub with details on your setup, debug logs and troubleshooting steps (as mentioned, you need to be using Home Assistant 2023.8.1 release or later) → Issues · zigpy/zha-device-handlers · GitHub
Again, for some basic information on why is ZHA Device Handlers (ZHA quirks) are needed read → https://www.home-assistant.io/integrations/zha#how-to-add-support-for-new-and-unsupported-devices (as well as the related information here → https://www.home-assistant.io/integrations/zha#knowing-which-devices-are-supported )
Also again note that the same question has more or less already been asked to zigpy developers in the issue here → [REQUEST] ZGP (Zigbee Green Power) specification support · Issue #341 · zigpy/zigpy · GitHub (developers discussion only)
In addition, requirement for end-users will be to have a relatively modern Zigbee Coordinator adapter with a not-too-old firmware on it so be sure to report the exact radio adapter and Zigbee Coordinator firmware version tested with, as all Zigbee Green Power will not work with older radios or old Zigbee Coordinator firmware.
opened 08:25AM - 30 Mar 20 UTC
Please add support for Zigbee Green Power specification (ZGP clusters/device sta… ndard subset) in zigpy and its radio libraries.
If the zigpy library should be fully compliant with Zigbee 3.0 it would at least have to support ZGP v2, and if would allow using zigpy as a Zigbee Router (ZR) device then it would need to at a minimum include ZGPB/GPB (Zigbee Green Proxy Basic) support.
**Update!** Non-developers, please see Home Assistant's community feature request for general or off-topic discussions that are not directly constructive for the development -> https://community.home-assistant.io/t/zha-integration-to-get-full-support-for-zgp-zigbee-green-power-devices/277149
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.
Zigbee Green Power is compatible with any Zigbee 3.0 device, but not all Zigbee 3.0 products are certified as Green Power Combo. Zigbee Green Power V2 is included as a subset in the Zigbee 3.0 specification (ZB3), while Zigbee Green Power V1 Green Power was a subset of an earlier Zigbee PRO standard.
**Basic terms:**
* ZGPD/GPD - Zigbee Green Power Device - a common Green Power device, which send specific Green Power packets (GPDF - Green Power Data Frames)
* ZGPS/GPS - Zigbee Green Power Sink - a Green Power device, which translates and transfers Green Power cluster commands to the relevant endoint
* ZGPB/GPB - Zigbee Green Proxy Basic - a Green Power device, which receives Green Power packets (GPDFs) and transmits Green Power Cluster commands; all Zigbee 3.0 routing devices must implement this
* GPCB - Green Power Combo Basic - Zigbee Green Power Combo Basic device includes two roles: Green Power Proxy and Green Power Sink.
"_During commissioning ZGPD reports his device ID. ZGPS should check if there are appropriate local endpoints, which can communicate with such ZGPD device ID. This process is called ZGPS functionality matching. Matching table declares for each supported ZGPD device ID there are requirements to local endpoint in order to ZGPS functionality matching to succeed._"
https://csa-iot.org/all-solutions/green-power/
https://csa-iot.org/all-solutions/green-power/green-power-faq/
https://zigbeealliance.org/wp-content/uploads/2019/11/Green-Power-White-Paper.pdf
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
ZGP (Zigbee Green Power) technology for battery-less self-powered or energy-harvesting devices. ZGP specification is a part of the official Zigbee 3.0 standard specifications and is supported by modern Zigbee Coordinator adapters (at least Texas Instruments and Silicon Labs). ZGP based 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
https://developer.nordicsemi.com/nRF_Connect_SDK/doc/zboss/3.8.0.1/group__zgp__api.html
https://infocenter.nordicsemi.com/pdf/15-02016-010-GP_Errata_for_GP_Basic_PICS_DSR_Nordic.pdf
https://www.nxp.com/docs/en/user-guide/JN-UG-3095.pdf
And devices:
https://www.assets.signify.com/is/content/Signify/Assets/philips-lighting/global/20201014-uid8480-zigbee-green-power-switch.pdf
https://www.lighting.philips.com/api/assets/v1/file/PhilipsLighting/content/0c34886812f2480d87b7ac5401062bec/UID8470_SpSh_20200415_Fin.pdf
https://www.qorvo.com/resources/d/qorvo-zigbee-green-power-multi-sensor-comparison-to-battery-powered-zigbee-devices-white-paper
The reason for the request is that you can already buy many Zigbee Green Power (ZGP) enabled switches/remotes made for home automation, and they are in fact very popular since Philips Hue has several ZGP devices in several pf their product series/lineups.
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://www.fierceelectronics.com/iot-wireless/zigbee-r-3-0-power-green
https://www.owon-smart.com/news/what-is-zigbee-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)
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] (based on EnOcean PTM 215ZE)(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] (based on EnOcean PTM 215ZE)(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 elektronik) 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 (Niko 91004)](https://www.niko.eu/en/our-products/switches-and-sockets/friends-of-hue) (based on EnOcean PTM 215Z)
- NodOn - Philips Hue Battery-less switch (CWS-4-1-01_HUE)
- https://nodon.fr/en/nodon/philips-hue-battery-less-switch/
- Vimar - Friends of Hue RF Switch (Vimar 03906)
- Feller 4120.2.S.FMI.61
- https://online-katalog.feller.ch/kat_details.php?fnr=4120.2.S.FMI.61
- Senic GIRA Friends of Hue Switch
- https://www.senic.com/products/friends-of-hue-smart-switch
- [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) ( LED-Trading 9125)
- 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/
- Trio2sys PLANA - COMPATIBLE ENOCEAN ZIGBEE GREEN POWER COMPLETE SWITCH 2 KEYS
- https://www.trio2sys.fr/index.php/en/products/transmitters/17
- Busch-Jaeger - Friends of Hue light switch
- https://www.busch-jaeger.de/produkt/friends-of-hue
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: If an end-user of Home Assistant wants to use ZGP (Zigbee Green Power) then they can not use the [ZHA integration](https://www.home-assistant.io/integrations/zha), and instead they as a workaround need to look at third-party Zigbee gateway/bridge/hub solutions that support ZGP, such as example Zigbee2MQTT, deCONZ/Phoscon, or commercial Zigbee gateways/bridges/hubs such as the Philips Hue Hub.
1 Like
Hedda
(Hedda)
July 7, 2023, 8:57am
21
Also, note that new ZGP devices could also need both a custom ZHA Device Handlers (a.k.a quirks) and modifications to the ZHA integration in the Home Assistant core, so it will be important that you all try open device requests as new issues if your ZGP device is pairing/joining but then not fully working correctly and not showing all entities expected or there is nothing showing in event data. Again, follow the ZHA docs section about ”How to add support for new and unsupported devices ” → https://www.home-assistant.io/integrations/zha#how-to-add-support-for-new-and-unsupported-devices
1 Like
molt
July 7, 2023, 11:41am
22
I’ve asked the question to the zigby developers and also created a request for a new device [Device Support Request] SR-ZG2833PAC-FOH (Zigbee Push-Button Coupler) · Issue #2426 · zigpy/zha-device-handlers · GitHub
Tomorrow I will update to 2023.7 and can report if the foh switch is working or not.
1 Like
Hedda
(Hedda)
July 8, 2023, 8:31am
23
@molt Good, noted however that the formatting of your initial post there looks in need of fixing though (see logs)
1 Like
molt
July 8, 2023, 5:05pm
24
I updated to 2023.07.1 but I am still not able to pair my zgp foh-switch.
@Hedda I´ve tried to make it clearer, is it better now?
1 Like
Can you pleas shortly describe how you tried to add the FOH switch?
I am asking as the adding process from zigbee2mqtt is different from the process in the Hue App.
Maybe the right button combination and time to press them makes also the difference for ZHA?
Hedda
(Hedda)
July 9, 2023, 7:32am
26
I believe that some ZGP devices may also not pair directly to the Zigbee Coordinator butmust instead be paired/joined indirectly via a other Zigbee device like for examplea compatible lightbulb or other ZGP proxy compatible devices? Or?
Hedda
(Hedda)
July 9, 2023, 8:09am
27
@molt Formatting look right now but looked up the model you mentioned there and that device does not make sence for this thread since that Sunricher SR-ZG2833PAC-FOH does not look like a ZGP (Zigbee Green Power) device?, instead that sound like it should be just a normal Zigbee device that requires mains power if you see ZGPD is the logs then that is just because it can act as a ZGP proxy, not that it is a ZGP device itself (and all mains-powered Zigbee 3.0 devices are also Zigbee Green Power Proxy devices but that is not the same as being a ZGP device).
https://www.sunricher.com/zigbee-push-button-coupler-foh-version-sr-zg2833pac-foh.html
1 Like
molt
July 9, 2023, 8:23am
28
Ah, okay. You’re right, then this device should work with a custom quirk and is not dependent on zgp-supported?
Can be but the Friends of Hue Switches can be paired directy. It tried to pair a switch with with the steps described for Z2M as no other docu is available for ZHA:
https://www.zigbee2mqtt.io/devices/PTM_215Z.html
Press top left (A0)
Press and hold top right (B0) for about 10 seconds
press top right (B0) and bottom left (A1) at the same time
press top left (A0) Note: Please make sure the module is positioned the right way up.
Unfortunately i was not able to add the switch via ZHA.
1 Like
Hedda
(Hedda)
July 9, 2023, 2:28pm
30
molt
July 10, 2023, 5:39am
31
@smartmatic I’ve tried to add the switch the same way I added it to phoscon/deconz. Works without any problems but I’m not able to add it the same way with zha.
https://phoscon.de/en/support#pairing-friends-of-hue-switch
With this button mapping, described here.
opened 09:53AM - 10 Jan 21 UTC
closed 06:11AM - 14 Jan 21 UTC
Device Request
## Device
- Product name: [ZigBee Unterputz Modul für Friends of Hue](https:/… /www.led-trading.de/ZigBee-Unterputz-Modul-fuer-Friends-of-Hue)
- Manufacturer: Sunricher
- Model identifier: SR-ZG2833PAC-FOH
- Device type: Switch
## Screenshots
I tried to pair this device in Phoscon (deCONZ tells me inside the 'Permit join' dialog to open the network for switches with the webapp). Phoscon shows me a device:
![grafik](https://user-images.githubusercontent.com/16901177/104119664-4ae5a900-5331-11eb-9f00-1a78b798a685.png)
But I cant add all keys, I just can add one and thats not working reliable. In deCONZ I dont see this device (because its an simulated ZGP device, am I right?). I opened the Debug view inside the deCONZ GUI and get events like:
![grafik](https://user-images.githubusercontent.com/16901177/104119640-fe01d280-5330-11eb-9f82-29324a69c54e.png)
But when I press the key on my device, an event is not listed each time, more like each 5 times. Tell me if I can give your more information somehow.
I waited for a device like this so long and would be really happy about deCONZ supporting it. Thanks in advance.
**Update:**
I just recognized, that the console logs each fourth tap on the key (as you can see at the frameCounter). In Phoscon I cant bind any of the keys to control a light unfortunately.
Button 1 = K3
Button 2 = K4
Button 3 = K1
Button 4 = K2