# 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.
