Files
cyber.scope/requirements/tbd.md
kntran1 4e2a5258a5 Initial commit
Initial commit.
2026-03-23 14:40:39 -05:00

5.5 KiB

Move this to docx

Cyber Scope--Mode Use Cases (Draft)

Power States (Working Definitions)

The following states are tenatively defined. However, each scenerio may have different settings for a state. This is just preliminary, need to work out the logic.

|---------|-----------------------------------------------------------------------------------------------------|

State Description
Off Lowest sleep mode. Wake only on center button press.
Sleep Lowest MCU sleep mode, IMU wakes on acceleration threshold met.
Idle MCU low-power, IMU sampling. No illumination. Bluetooth active.
Active Full illumination per user config. IMU active.
--------- -----------------------------------------------------------------------------------------------------

|---------------|---------------------------------------------------------------|

Mode How to Enable/Disable
Stand Hunting Default. Selectable via 3-button interface or Cyber Shot app.
Still Hunting Enable: Cyber Shot app only, Disable: TBD.
3D / Field Enable: Cyber Shot app only, Disable: TBD.
Target Enable: Cyber Shot app only, Disable: TBD.
--------------- ---------------------------------------------------------------
  • Mode is sticky--survives power cycles until changed.
  • Return to Stand Hunting is always possible via 3-button interface (no app required).
  • Entry into Still, 3D, or Target requires Cyber Shot app to keep 3-button interface manageable.

Mode 1: Stand Hunting (Default Mode)

  • Bow on hanger for long periods, occasionally picked up.
  • On draw, archer may hold at full draw 5+ minutes waiting for shot opportunity.
  • Wake: IMU motion above threshold (deliberate pickup, not wind/vibration).
  • Stay Active: Sleep threshold lower than wake threshold--scope stays lit through extended stillness at full draw.
  • Active → Sleep: Return to stillness below sleep threshold for duration 10 seconds.
  • Off → Off: Center button full power-off; center button power-on shows battery on alignment ring.
  • Post-shot: Archer may review shot data on phone via Cyber Shot app. May happen minutes to hours later.

Mode 2: Still Hunting

  • Archer stalking with bow in hand all day. Constant motion.
  • IMU wake would drain battery--motion is continuous.
  • Wake: Center button only.
  • Active: Illumination stays on until manually turned off. No auto-off on shot detection--archer may need follow-up shot.
  • Off: Center button only. No timeout, no IMU-based sleep.
  • Post-shot: No change in state. Illumination remains on.
  • Shot data review: Archer may review shot data on phone via Cyber Shot app. May happen minutes to hours later.

Mode 3: 3D

  • Archer walks course, carries bow between stations.
  • At station, archer presses center button → Active (no battery display, immediate illumination).
  • Archer shoots. IMU detects shot → illumination off immediately.
  • Archer carries bow to target, retrieves arrows, walks to next station. Scope stays non-illuminated despite motion.
  • Wake: Center button only. IMU motion does NOT trigger illumination.
  • Post-shot: Illumination off immediately. Scope enters Off or Idle.
  • Timeout: 2 minutes, may add as fallback if archer forgets to shoot / walks off.
  • Shot data review: Archer may review shot data and enter score per shot in Cyber Shot app. Typically 1 shot per station.

Mode 4: Target

  • Bow on stand or hanger between ends/practice groups. May swing due to stabilizers.
  • Archer picks up bow and IMU wakes MCU → Active.
  • Shoots multiple arrows per end. Timer resets on each shot detected.
  • When done, archer hangs bow or sets on stand.
  • Wake: IMU motion above threshold (must distinguish deliberate pickup from stabilizer oscillation on hanger).
  • Stay Active: Timeout resets on each shot detected and on each pickup event.
  • Active → Sleep: Timeout expires with no shot/pickup.
  • Known issue: Target bows with stabilizers oscillate on hangers, preventing motion-based idle. Mitigation: archer presses center button or settles bow. Firmware does not attempt to distinguish oscillation from pickup.
  • Bluetooth: TBD--may use Standby for shot data transfer after end.
  • Shot data review: Archer may review shot data and enter score per shot in Cyber Shot app. Typically 5 shots per end. Shot data correlated with score for replay.

Open Questions

  1. Standby vs Idle distinction: depends on whether Bluetooth is needed post-shot (3D, Target). Deferred to per-mode state definitions.
  2. All timeout durations TBD.
  3. Stand Hunting asymmetric wake/sleep thresholds--values TBD.
  4. Battery display: shown on full power-on (Stand Hunting). Suppressed on center-button quick wake (3D). Target TBD.
  5. 3D center button behavior: first press → Active, second press → Off (full power-on with battery display on next press). Post-shot state TBD (Idle vs Off, depends on Bluetooth/shot data transfer needs).
  6. Per-mode state definitions (STAND_S0, STILL_S0, 3D_S0, TARGET_S0, etc.)--deferred until use cases complete.