docs(ac-filter-reset): record a board family with no local reset (ARTIK051_PRAC_20K) - #354
Open
creednmd wants to merge 1 commit into
Open
Conversation
The investigation is written around the FilterTime_<N> option token on /mode/vs/0, and its conclusion holds for the ARTIK051_KRAC_18K it was measured on. An ARTIK051_PRAC_20K has no such token: no FilterTime, no FilterAlarmTime, no FilterCleanAlarm anywhere in its options blob. It keeps the counter in /filter/airdustfilter/vs/0 as a percentage of a 500-hour interval instead. Neither route resets it. FilterCleanAlarm_Clear to /mode/vs/0 returns 4.00 with the options blob byte-identical; writing filterUsage as the string "0" returns 4.00; writing it as an integer returns 5.00. That last difference is the useful part — two payloads differing only in JSON type returning different codes rules out an unresolved href or an unrecognised field name, leaving read-only as the reading. Adds a scope line to the intro and a section documenting the board, its two resource dumps, the attempt table, and an observation-only workaround for percentage-counter boards. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.
Docs only — no code touched.
docs/investigations/ac-filter-reset.mdis written around theFilterTime_<N>option token on/mode/vs/0, and its "solved" conclusion holds for theARTIK051_KRAC_18Kit was measured on. On anARTIK051_PRAC_20K(three-head multi-split, v0.21.0, HA 2026.8.1) that token does not exist — noFilterTime, noFilterAlarmTime, noFilterCleanAlarmanywhere in the options blob. The counter lives in/filter/airdustfilter/vs/0as a percentage of a 500-hour interval instead, and nothing resets it locally.Three attempts, all against a live unit put in
fan_onlyfirst (writes to a powered-off head on this board are dropped silently, which would otherwise look identical to a rejection):/mode/vs/0{"x.com.samsung.da.options": ["FilterCleanAlarm_Clear"]}/filter/airdustfilter/vs/0{"x.com.samsung.da.filterUsage": "0"}/filter/airdustfilter/vs/0{"x.com.samsung.da.filterUsage": 0}(integer)filterUsagestayed at96throughout, verified by a live re-read after each write rather than by the integration's optimistic state.The last two rows are the informative pair: they differ only in JSON type and return different codes. An unresolved href or an unrecognised field name would fail identically, so the board is parsing the field, faulting on the wrong type, and still refusing the value when correctly typed. Read-only, not mis-addressed.
Also flags one trap in passing:
filterResetType: ["replaceable","washable"]describes the filter, not an available reset command, though it reads like a hint that one exists.The patch adds a scope line to the intro pointing at the new section, and appends the section itself with both resource dumps, the attempt table, the reasoning, and an observation-only workaround (
numeric_statebelow: 10on the usage sensor stamping aninput_datetime) for boards in this family.Happy to reword or trim if you would rather keep the file strictly about the KRAC generation — the goal is just that the next person with a percentage-counter board does not repeat the three writes.