Initial commit

Initial commit.

requirements/tbd.md

@@ -0,0 +1,94 @@
+# 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.