Repository navigation
docs: regenerate the Gateway Discovery table for the F461 and MyHomeServer1 without WHO 16 (companion to OWNd#142) - #830
Closed
gdluck wants to merge 1 commit into
Conversation
…erver1 profiles without WHO 16 Companion to OpenWebNet-HA/OWNd#142, which drops WHO 16 from the F461 and MyHomeServer1 gateway profiles. MyHOME's startup discovery table is generated from those profiles, so the real-tree documentation check on the OWNd side (MyHOME conformance / MyHOME test suite) fails until this table follows. Generated with scripts/sync_documentation.py --update against the OWNd fix/profiles-f461-mhs1-no-who16 branch; no hand edits. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Author
|
Closing: this is premature. The repository already handles OWNd#142 at the pin bump ( |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by A
Before: the startup-discovery table in
docs/getting-started/hardware-compatibility.mdlists WHO 16 among the WHOs queried on the F461 and MyHomeServer1, and*#16*0*5##among the frames their firmware drops.After: the two rows follow the OWNd profiles of OpenWebNet-HA/OWNd#142, which drop WHO 16 from both gateways: queried WHOs
1, 2, 4, 18, and only*#4*0##listed as dropped.Companion to OpenWebNet-HA/OWNd#142. Nothing else changes.
What is the problem
scripts/sync_documentation.pygenerates the Gateway Startup Discovery Capabilities table from OWNd's gateway profiles. OpenWebNet-HA/OWNd#142 removes WHO 16 from the F461 and MyHomeServer1 profiles (both gateways refuse every WHO 16 frame; sound is WHO 22 only, own-firmware-oracle020011and028206, confirmed live on 2.0.11 and 3.87.13). With that OWNd checkout,tests/test_sync_documentation.py::test_check_all_documentation_real_treefails here with "Gateway Discovery table out of sync", which is what theMyHOME conformance / MyHOME test suitejob on OWNd#142 reports (5072 passed, 1 failed).Fixes nothing in the integration; documentation only.
What is the solution
docs/getting-started/hardware-compatibility.md:python scripts/sync_documentation.py --updatewhile the OWNd#142 branch (fix/profiles-f461-mhs1-no-who16, head2210296) was onPYTHONPATH. No hand edits; the row text is the generator's.State Diagram
N/A — docs change only.
Hardware Verification
N/A for this PR. The underlying evidence is on OpenWebNet-HA/OWNd#142 (live F461 2.0.11 and MyHomeServer1 3.87.13 captures of the WHO 16 refusals).
How is it tested
python scripts/sync_documentation.py --checkwith OWNd#142 onPYTHONPATH: all checks in sync after this change, "Gateway Discovery table out of sync" before it.masteronPYTHONPATHthe same check reports the table out of sync, as expected: this PR and OWNd#142 have to land together. Merging this first turns the OWNd#142 conformance job green; merging it after leaves this repository's check red until OWNd#142 is in a release that MyHOME pins.Where are the traces
N/A (no protocol change). OWNd#142 links the live captures.
What does the Firmware Oracle / Encyclopedia say
020011(F461) and028206(MyHomeServer1) have no WHO 16 verdict other than refusal; the generator already carries that in its notes column.Checklist
scripts/sync_documentation.py --checkpasses against OWNd#142; no Python changed, sopytest,ruffandverify_ha_standards.pyare unaffected.🤖 Generated with Claude Code