Skip to content

feat(catalog): enrich WHO 18 and WHO 3 from TS10 reference and firmware oracle - #15

Merged
GreenGrassBlueOcean merged 5 commits into
mainfrom
feat/who18-who3-energy-catalog
Oct 7, 2026
Merged

GreenGrassBlueOcean merged 5 commits into
mainfrom
feat/who18-who3-energy-catalog

Conversation

@GreenGrassBlueOcean

@GreenGrassBlueOcean GreenGrassBlueOcean commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Enriches the OpenWebNet catalog for WHO 22 (Sound / Multi-Room Audio), WHO 18 (Energy Management), and WHO 3 (Load Control & Shedding) using empirical verification results from own-firmware-oracle and BTicino's 10-inch Touch Screen (libqtdevices tag TS10_1_0_23) reference stack.

1. WHO 22 (Sound / Multi-Room Audio) Enhancements

  • Carried forward from TS10 sound investigation:
    • Source selection, amplifier volume control (0..31), source cycling, tuner presets.
    • Matrix amplifier local/global addressing (#4#0, #5#3#0#0).
    • Follow Me routing commands and spatial audio distribution.

2. WHO 18 (Energy Management) Enhancements

  • Stop&Go Automatic Reset Breakers (F16EB):
    • Added WHAT commands: breaker open (21), close (22), differential test positive (23), differential test negative (24), auto-reset activate (26), auto-reset deactivate (27), tracking activate (28), tracking deactivate (29).
    • Added dimensions: self-test interval in days (212), status bitmask (250), line state (251), failure/trip counter (258).
  • Historical Series & Graphs (TS10 vs Classic Dimensions):
    • Added TS10 WHAT graph requests: 8-bit daily graph (52#M#D), 8-bit daily average (53#M), 8-bit monthly graph (56#M), 16-bit cumulative daily graph (57#M#D), 16-bit daily average (58#M), 32-bit cumulative monthly graph (59#M), and cumulative monthly series (510#M).
    • Added classic dimensions: energy/unit totalizer (51), dated monthly totalizer (52#Y#M), current-month partial totalizer (53), current-day partial totalizer (54), daily hourly series (511#M#D), monthly-average hourly series (512#M), current-year daily series (513#M), previous-year daily series (514#M), totalizer query (516), power threshold setting (517#N), and automatic periodic reporting control (1200).
  • Actuator Management:
    • Added actuator enable command (*18*71*WHERE##), differential-current level query (73), actuator totalizer (72#N), timed/infinite force OFF (73#Time), end force OFF (74), and totalizer reset (75#Tot_N).

3. WHO 3 (Load Management / F421) Enhancements

  • Status: "Legacy (Bus Translation Verified)" (empirical SCS frame translation verified on MH202 010024).
  • Aligned canonical WHAT commands with OpenWebNet-Encyclopedia:
    • WHAT 0: Load disabled / shed.
    • WHAT 1: Load enabled (automatic / normal priority).
    • WHAT 2: Load forced (*3*2*#PRIORITY## emitting $04B7011300\r).
    • WHAT 3: Remove forcing.
  • Aligned central unit F421 multi-dimension measurements (WHERE=10):
    • Dimension 0: All measurements in sequence.
    • Dimension 1: Voltage (V).
    • Dimension 2: Current (mA/A).
    • Dimension 3: Instantaneous power (W).
    • Dimension 4: Accumulated energy.

4. Oracle Index Synchronization

  • Synchronized src/openwebnet_mcp/data/oracle_index.json with hash-pinned verdicts (verdicts_sha256: 7985aef1...) covering 244 unique inputs across 10 gateways.

5. Verification

  • pytest tests: 134 passed, 1 skipped.

@GreenGrassBlueOcean
GreenGrassBlueOcean merged commit 571820d into main Oct 7, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant