Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DM XMLs: Add function to dump cluster IDs for documentation #32761

Merged
merged 10 commits into from
Apr 2, 2024
Merged

DM XMLs: Add function to dump cluster IDs for documentation #32761

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
c36485a
Add function to dump cluster IDs for documentation
cecille Mar 27, 2024
047b27b
add json dump
cecille Mar 27, 2024
887c5c6
add Illuminance to word list
cecille Mar 28, 2024
bb4ac53
remove unused var
cecille Mar 28, 2024
d1ed316
Change titles on docs to show zap vs. spec
cecille Mar 28, 2024
b9a77b1
add the json for cluster_ids
cecille Mar 28, 2024
2240820
Restyled by whitespace
restyled-commits Mar 28, 2024
b06ec57
Restyled by prettier-json
restyled-commits Mar 28, 2024
0527c30
Restyled by prettier-markdown
restyled-commits Mar 28, 2024
fbf04a2
Omit generated md files from restyler
cecille Apr 2, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/.wordlist.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -668,6 +668,7 @@ ifdef
ifdefs
IGMP
ihex
Illuminance
IlluminanceMeasurement
IM
imager
Expand Down
3 changes: 2 additions & 1 deletion .restyled.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,8 @@ exclude:
- "integrations/docker/build-all.sh" # tries to quote loop variable
- "scripts/setup/pigweed.json" # TODO(#29547). This file is temporary copy from pigweed repo that has minor edits. No restyle help in diff.
- "docs/ERROR_CODES.md" # generated by scripts, not easy to align tables
- "docs/clusters.md" # generated by scripts, not easy to align tables
- "docs/zap_clusters.md" # generated by scripts, not easy to align tables
- "docs/spec_clusters.md" # generated by scripts, not easy to align tables
- "docs/testing/yaml_pseudocluster.md" # generated by scripts, restyler makes the tables render improperly
- "docs/testing/yaml_schema.md" # generated by scripts, restyler makes the tables render improperly

Expand Down
115 changes: 115 additions & 0 deletions data_model/clusters/cluster_ids.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
{
"3": "Identify",
"4": "Groups",
"6": "On/Off",
"8": "Level Control",
"28": "Pulse Width Modulation",
"29": "Descriptor",
"30": "Binding",
"31": "AccessControl",
"37": "Actions",
"40": "Basic Information",
"41": "OTA Software Update Provider",
"42": "OTA Software Update Requestor",
"43": "Localization Configuration",
"44": "Time Format Localization",
"45": "Unit Localization",
"46": "Power Source Configuration",
"47": "Power Source",
"48": "General Commissioning",
"49": "Network Commissioning",
"50": "Diagnostic Logs",
"51": "General Diagnostics",
"52": "Software Diagnostics",
"53": "Thread Network Diagnostics",
"54": "Wi",
"55": "Ethernet Network Diagnostics",
"56": "Time Synchronization",
"57": "Bridged Device Basic Information",
"59": "Switch",
"60": "Administrator Commissioning",
"62": "Operational Credentials",
"63": "GroupKeyManagement",
"64": "Fixed Label",
"65": "User Label",
"69": "Boolean State",
"70": "ICDManagement",
"72": "Oven Cavity Operational State",
"73": "Oven Mode",
"74": "Laundry Dryer Controls",
"80": "Mode Select",
"81": "Laundry Washer Mode",
"82": "Refrigerator And Temperature Controlled Cabinet Mode",
"83": "Laundry Washer Controls",
"84": "RVC Run Mode",
"85": "RVC Clean Mode",
"86": "Temperature Control",
"87": "Refrigerator Alarm",
"89": "Dishwasher Mode",
"91": "Air Quality",
"92": "Smoke CO Alarm",
"93": "Dishwasher Alarm",
"94": "Microwave Oven Mode",
"95": "Microwave Oven Control",
"96": "Operational State",
"97": "RVC Operational State",
"98": "Scenes Management",
"113": "HEPA Filter Monitoring",
"114": "Activated Carbon Filter Monitoring",
"128": "Boolean State Configuration",
"129": "Valve Configuration and Control",
"144": "Electrical Power Measurement",
"145": "Electrical Energy Measurement",
"148": "Water Heater Management",
"149": "Energy Price",
"150": "Demand Response and Load Control",
"151": "Messages",
"152": "Device Energy Management",
"153": "Energy EVSE",
"154": "Energy Calendar",
"155": "Energy Preference",
"156": "Power Topology",
"157": "Energy EVSE Mode",
"158": "Water Heater Mode",
"159": "Device Energy Management Mode",
"257": "Door Lock",
"258": "Window Covering",
"512": "Pump Configuration and Control",
"513": "Thermostat",
"514": "Fan Control",
"516": "Thermostat User Interface Configuration",
"768": "Color Control",
"769": "Ballast Configuration",
"1024": "Illuminance Measurement",
"1026": "Temperature Measurement",
"1027": "Pressure Measurement",
"1028": "Flow Measurement",
"1029": "Relative Humidity Measurement",
"1030": "Occupancy Sensing",
"1036": "Carbon Monoxide Concentration Measurement",
"1037": "Carbon Dioxide Concentration Measurement",
"1043": "Nitrogen Dioxide Concentration Measurement",
"1045": "Ozone Concentration Measurement",
"1066": "PM2",
"1067": "Formaldehyde Concentration Measurement",
"1068": "PM1 Concentration Measurement",
"1069": "PM10 Concentration Measurement",
"1070": "Total Volatile Organic Compounds Concentration Measurement",
"1071": "Radon Concentration Measurement",
"1104": "Network Identity Management",
"1105": "Wi",
"1283": "Wake on LAN",
"1284": "Channel",
"1285": "Target Navigator",
"1286": "Media Playback",
"1287": "Media Input",
"1288": "Low Power",
"1289": "Keypad Input",
"1290": "Content Launcher",
"1291": "Audio Output",
"1292": "Application Launcher",
"1293": "Application Basic",
"1294": "Account Login",
"1295": "Content Control",
"1296": "Content App Observer"
}
4 changes: 3 additions & 1 deletion docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,10 @@ testing/index
tools/index
BUG_REPORT
code_generation
clusters
zap_clusters
spec_clusters
ERROR_CODES

```

```{include} README.md
Expand Down
118 changes: 118 additions & 0 deletions docs/spec_clusters.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
# List of currently defined spec clusters
This file was **AUTOMATICALLY** generated by `python scripts/generate_spec_xml.py`. DO NOT EDIT BY HAND!

| ID (Decimal) | ID (hex) | Name |
|--------------|----------|----------------------------------------------------------|
|3 |0x0003 |Identify |
|4 |0x0004 |Groups |
|6 |0x0006 |On/Off |
|8 |0x0008 |Level Control |
|28 |0x001C |Pulse Width Modulation |
|29 |0x001D |Descriptor |
|30 |0x001E |Binding |
|31 |0x001F |AccessControl |
|37 |0x0025 |Actions |
|40 |0x0028 |Basic Information |
|41 |0x0029 |OTA Software Update Provider |
|42 |0x002A |OTA Software Update Requestor |
|43 |0x002B |Localization Configuration |
|44 |0x002C |Time Format Localization |
|45 |0x002D |Unit Localization |
|46 |0x002E |Power Source Configuration |
|47 |0x002F |Power Source |
|48 |0x0030 |General Commissioning |
|49 |0x0031 |Network Commissioning |
|50 |0x0032 |Diagnostic Logs |
|51 |0x0033 |General Diagnostics |
|52 |0x0034 |Software Diagnostics |
|53 |0x0035 |Thread Network Diagnostics |
|54 |0x0036 |Wi |
|55 |0x0037 |Ethernet Network Diagnostics |
|56 |0x0038 |Time Synchronization |
|57 |0x0039 |Bridged Device Basic Information |
|59 |0x003B |Switch |
|60 |0x003C |Administrator Commissioning |
|62 |0x003E |Operational Credentials |
|63 |0x003F |GroupKeyManagement |
|64 |0x0040 |Fixed Label |
|65 |0x0041 |User Label |
|69 |0x0045 |Boolean State |
|70 |0x0046 |ICDManagement |
|72 |0x0048 |Oven Cavity Operational State |
|73 |0x0049 |Oven Mode |
|74 |0x004A |Laundry Dryer Controls |
|80 |0x0050 |Mode Select |
|81 |0x0051 |Laundry Washer Mode |
|82 |0x0052 |Refrigerator And Temperature Controlled Cabinet Mode |
|83 |0x0053 |Laundry Washer Controls |
|84 |0x0054 |RVC Run Mode |
|85 |0x0055 |RVC Clean Mode |
|86 |0x0056 |Temperature Control |
|87 |0x0057 |Refrigerator Alarm |
|89 |0x0059 |Dishwasher Mode |
|91 |0x005B |Air Quality |
|92 |0x005C |Smoke CO Alarm |
|93 |0x005D |Dishwasher Alarm |
|94 |0x005E |Microwave Oven Mode |
|95 |0x005F |Microwave Oven Control |
|96 |0x0060 |Operational State |
|97 |0x0061 |RVC Operational State |
|98 |0x0062 |Scenes Management |
|113 |0x0071 |HEPA Filter Monitoring |
|114 |0x0072 |Activated Carbon Filter Monitoring |
|128 |0x0080 |Boolean State Configuration |
|129 |0x0081 |Valve Configuration and Control |
|144 |0x0090 |Electrical Power Measurement |
|145 |0x0091 |Electrical Energy Measurement |
|148 |0x0094 |Water Heater Management |
|149 |0x0095 |Energy Price |
|150 |0x0096 |Demand Response and Load Control |
|151 |0x0097 |Messages |
|152 |0x0098 |Device Energy Management |
|153 |0x0099 |Energy EVSE |
|154 |0x009A |Energy Calendar |
|155 |0x009B |Energy Preference |
|156 |0x009C |Power Topology |
|157 |0x009D |Energy EVSE Mode |
|158 |0x009E |Water Heater Mode |
|159 |0x009F |Device Energy Management Mode |
|257 |0x0101 |Door Lock |
|258 |0x0102 |Window Covering |
|512 |0x0200 |Pump Configuration and Control |
|513 |0x0201 |Thermostat |
|514 |0x0202 |Fan Control |
|516 |0x0204 |Thermostat User Interface Configuration |
|768 |0x0300 |Color Control |
|769 |0x0301 |Ballast Configuration |
|1024 |0x0400 |Illuminance Measurement |
|1026 |0x0402 |Temperature Measurement |
|1027 |0x0403 |Pressure Measurement |
|1028 |0x0404 |Flow Measurement |
|1029 |0x0405 |Relative Humidity Measurement |
|1030 |0x0406 |Occupancy Sensing |
|1036 |0x040C |Carbon Monoxide Concentration Measurement |
|1037 |0x040D |Carbon Dioxide Concentration Measurement |
|1043 |0x0413 |Nitrogen Dioxide Concentration Measurement |
|1045 |0x0415 |Ozone Concentration Measurement |
|1066 |0x042A |PM2 |
|1067 |0x042B |Formaldehyde Concentration Measurement |
|1068 |0x042C |PM1 Concentration Measurement |
|1069 |0x042D |PM10 Concentration Measurement |
|1070 |0x042E |Total Volatile Organic Compounds Concentration Measurement|
|1071 |0x042F |Radon Concentration Measurement |
|1104 |0x0450 |Network Identity Management |
|1105 |0x0451 |Wi |
|1283 |0x0503 |Wake on LAN |
|1284 |0x0504 |Channel |
|1285 |0x0505 |Target Navigator |
|1286 |0x0506 |Media Playback |
|1287 |0x0507 |Media Input |
|1288 |0x0508 |Low Power |
|1289 |0x0509 |Keypad Input |
|1290 |0x050A |Content Launcher |
|1291 |0x050B |Audio Output |
|1292 |0x050C |Application Launcher |
|1293 |0x050D |Application Basic |
|1294 |0x050E |Account Login |
|1295 |0x050F |Content Control |
|1296 |0x0510 |Content App Observer |
2 changes: 1 addition & 1 deletion docs/clusters.md → docs/zap_clusters.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Generally regenerate using one of:
- ./scripts/codegen.py --output-dir docs --generator summary-markdown src/controller/data_model/controller-clusters.matter
-->

## List of currently defined clusters
## List of currently defined ZAP clusters

| Code (dec) | Code (hex) | Name |
| ---------- | ---------- | ------------------------------------------------------- |
Expand Down
2 changes: 1 addition & 1 deletion scripts/py_matter_idl/matter_idl/generators/markdown/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ def __init__(self, storage: GeneratorStorage, idl: Idl, **kargs):
def internal_render_all(self):
self.internal_render_one_output(
template_path="clusters_markdown.jinja",
output_file_name="clusters.md",
output_file_name="zap_clusters.md",
vars={
'idl': self.idl,
}
Expand Down
2 changes: 1 addition & 1 deletion scripts/py_matter_idl/matter_idl/generators/markdown/clusters_markdown.jinja
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Generally regenerate using one of:
- ./scripts/codegen.py --output-dir docs --generator summary-markdown src/controller/data_model/controller-clusters.matter
-->

## List of currently defined clusters
## List of currently defined ZAP clusters

| Code (dec) | Code (hex) | Name |
| ---------- | ---------- | ------------------------------------------------------- |
Expand Down
Loading
Loading