Zigbee device's commands, clusters, and attributes capability dataset in the database?

[Hedda]

Pretense: Zigbee devices organize their features using the Zigbee Cluster Library (ZCL). Clusters are functional building blocks, attributes store the device state data inside servers, and commands are instructions sent between clients and servers to read, write, or alter that data.

Would it be useful to have full lists of Zigbee device's commands, clusters, and attributes capability datasets for each and every Zigbee device in the OHF Device Database?

For example, hsolgaard have collected n openly reusable dataset called zigbee-capabilities (released under CC0) that records the clusters, commands and attributes actually reported by particular Zigbee device models and firmware versions.

• https://hsolgaard.github.io/zigbee-capabilities/

  • https://github.com/hsolgaard/zigbee-capabilities

ZHA currently has a device testing database with very similar content and nearly 1,000 device diagnostics files but it has no ZDO capabilities:

• https://github.com/zigpy/zha/tree/dev/tests/data/devices

  • https://github.com/hsolgaard/zha-bindings-manager

For reference, seen those as talked about under zigpy discussions here:

• Could this Zigbee capability dataset be useful to zigpy contributors? zigpy/zigpy#1871

[Hedda]

FYI, Zigbee2MQTT's webpages for their supported devices has something somewhat similar that lists what endpoints each device exposes. Ex:

• https://www.zigbee2mqtt.io/supported-devices/
  • https://www.zigbee2mqtt.io/devices/TRVZB.html
    • https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/devices/TRVZB.md
  • https://www.zigbee2mqtt.io/devices/SWV-ZF2.html
    • https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/devices/SWV-ZF2.md
  • https://www.zigbee2mqtt.io/devices/S4SN-0U61X.html
    • https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/devices/S4SN-0U61X.md
  • https://www.zigbee2mqtt.io/devices/S4DM-0A101WWL.html
    • https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/devices/S4DM-0A101WWL.md

[Hedda]

@mkerstner a related idea could be to look into adopting the standard XML format used by CSA's ZAP (ZCL Advanced Platform) for this:

• https://github.com/project-chip/zap

The website could then parse Zigbee and Matter specification XML files to generate intermediate representations to render on the web.

This is the official Zigbee and Matter specifications XMLs from Connectivity Standards Alliance, and a few other projects use it similarly. See ex:

• https://github.com/zakaria1193/zap-gatsby

• https://github.com/espressif/esp-matter/blob/main/tools/data_model_gen/README.md