8000 docs(cbio): record why a GS1 scan finds nothing while the phone screen is off by shroominic · Pull Request #212 · shroominic/OpenGlucose · GitHub
[go: up one dir, main page]

Skip to content

docs(cbio): record why a GS1 scan finds nothing while the phone screen is off - #212

Closed
shroominic wants to merge 2 commits into
feature/cbio-gs1from
docs/cbio-gs1-screen-off-scans
Closed

shroominic wants to merge 2 commits into
feature/cbio-gs1from
docs/cbio-gs1-screen-off-scans

Conversation

@shroominic
Copy link
Copy Markdown
Owner

Fixes #211. Docs-only: records a field condition found on real hardware today, with
the log evidence and the ordered A/B.

The finding

The GS1 sensor is not intermittently invisible. The receiver's scan policy is:
with the phone's display off, Android declines the scan, and the harness burns its
full 80 s budget before reporting aborted_no_target.

W BtScan.ScanManager: Cannot start unfiltered scan in screen-off.
  This scan will be resumed later for
  ScanClient(com.openglucose.app.debugid=1, mode[LOW_LATENCY, used=LOW_LATENCY])

The A/B (one phone, one app, one harness, one sensor)

display result
off aborted_no_target after 80-88 s, with 3 refused unfiltered passes
on scan-source=filtered then target-found in ~20 s; one full session completed

What it rules out

  • Not a duty cycle: the sensor streamed 719 notifications and 10969 raw records
    immediately after the failures, and its archive had grown 9981 → 10969.
  • Not our session leaving it quiet: the completed run released GATT and a probe
    3 minutes later re-acquired and re-authenticated the same sensor.
  • Not "no glucose on this firmware": the same window is the payload-word proof
    in cbio-gs1-glucose-live.md.

Contents

  • New docs/testing/cbio-gs1-discoverability.md: the finding, the A/B table,
    the production implications for onboarding, and how to reproduce it.
  • docs/testing/cbio-gs1-glucose-live.md: adds the 2026-09-18 run 5 row (raw
    1..10969, payload 39..97 non-zero in 10969/10969) and links the comparison
    artifact.
  • docs/testing/cbio-gs1-evidence.md: a pointer that an empty scan is not always
    an absent sensor.

No sensor write is involved in either direction of the experiment: info, auth,
one clock set per session and reads only, GATT released, no addresses or
credential material anywhere in this branch.

The evidence artifacts this documents are already in evidence/
(gs1-session-20260918T104803-...json, gs1-decode-comparison-20260918T104809.json),
and the index rows are updated there. The decode fix itself is PR #210.

@shroominic
shroominic force-pushed the docs/cbio-gs1-screen-off-scans branch from 5a40c65 to fde4ce2 Compare September 18, 2026 10:56
@shroominic
shroominic changed the base branch from fix/cbio-gs1-harness-discovery to feature/cbio-gs1 September 18, 2026 10:56
@shroominic
Copy link
Copy Markdown
Owner Author

Absorbed into #209 (head ec83adc) as b88ed02 (the write-up) and 269578f (the direct-evidence citation) — both applied on top of the consolidation tip with no conflicts.

Kept the version that matches shipped code, as asked: nothing in this doc set contradicts the branch. The docs/testing/cbio-gs1-evidence.md pointer and the new docs/testing/cbio-gs1-discoverability.md describe the same failure window the harness shows, and the cbio-gs1-glucose-live.md row it adds agrees with the payload-word fix carried at bb2619d/6355da4 (device session gs1-session-20260918T104803, payload non-zero 10969/10969, processed zero in every sample). The screen-off fix itself is now carried too, at ec83adc.

Closing as carried. Carrying PR: #209.

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

0