[Task] ZCL definition update

[Nerivec]

Not an issue, just a task, with some links for reference. I glanced over the ZCL definition, it seems it could use a little love. A lot of the information should be available here to standardize it all. Some errors have been deprecated/changed, manuf code list directly from zigbee alliance, that sort of things.

Also latest Zigbee Specification PDF and Zigbee Cluster Library PDF.

• [x] Manufacturer Codes
• [x] Statuses
• [ ] Missing generic clusters
• [x] Missing foundation commands

[Hedda]

Also latest Zigbee Specification PDF and Zigbee Cluster Library PDF.

More links here for reference -> https://github.com/zigpy/zha-device-handlers?tab=readme-ov-file#what-are-these-specifications

What are these specifications

Reference official Zigbee specification documentation from Connectivity Standards Alliance (a.k.a. "CSA-IOT", formerly "Zigbee Alliance"):

• Zigbee Cluster Library Specification
  • Zigbee Cluster Library Specification R8 (Revision 8)
  • Zigbee Cluster Library Specification R7 (Revision 7)
  • Zigbee Cluster Library Specification R6 (Revision 6)
• Zigbee Protocol Specification (also known as "Zigbee Pro" specifications)
  • Zigbee Protocol Specification 2023 (also known as "Zigbee PRO 2023" / Zigbee R23)
  • Zigbee Protocol Specification 2017 (also known as "Zigbee PRO 2017" / Zigbee R22)
  • Zigbee Protocol Specification 2015 (also known as "Zigbee PRO 2015" / Zigbee R21)
• Zigbee Device Specifications
  • Zigbee Base Device Behavior Specification (v1.0)
  • Zigbee Lighting & Occupancy Device Specification (v1.0)
• Zigbee Green Power (ZGP "GreenPower" Profile) specifications
  • Zigbee PRO Green Power feature specification Basic functionality set (v1.1.1)
  • Zigbee PRO Green Power feature specification 1.0a (Revision 26)
• Zigbee Smart Energy (ZSE / Zigbee SE "Smart Energy" Profile) specifications
  • Zigbee Smart Energy Standard 1.4
  • ZigBee Smart Energy Standard (v1.2a)

Additionally, see these third-party and manufacturer specific documents:

• Tuya - Zigbee Connection Standard (Tuya Smart Documentation)
  • Zigbee2MQTT guide on understanding the custom 'manuSpecificTuya' cluster that TuYa devices uses
• Samsung SmartThings -Device Handlers
  • Samsung SmartThings - Zigbee Primer
  • Samsung SmartThings - Building ZigBee Device Handlers

[burmistrzak]

@Nerivec I assume we're also adding the entire Green Power cluster definition? Because while investigating https://github.com/Koenkk/zigbee2mqtt/issues/22897#issuecomment-2153181816, I noticed its attributes are still missing.

Should I prepare a PR?

[Hedda]

@burmistrzak FYI, CSA has released Green Power Revision 1.1.2 specifications for Zigbee-based Energy-harvesting Technology:

https://csa-iot.org/newsroom/the-connectivity-standards-alliance-releases-green-power-1-1-2-for-zigbee-based-energy-harvesting-technology/

The latest revision of the Green Power standard, Revision 1.1.2 introduces additional features and scripts that are supposed to simplify testing and allow Green Power developers to use the same unified test harness for Green Power receiver products as used for the traditional Zigbee protocol.

Zigbee PRO Green Power feature specification Basic functionality set version 1.1.2 can now be downloaded from

https://csa-iot.org/developer-resource/specifications-download-request/

[burmistrzak]

FYI, CSA has released Green Power Revision 1.1.2 specifications for Zigbee-based Energy-harvesting Technology

Yep, saw that too! I'll have look, but probably start with v1.1.1, because that's what's currently in use.