Move this to docx

# Goals:
1.  Define use cases
2.  Define modes
3.  Define behaviors
4.  Define IMU motion sensitivities and hysterisis
4.  Generate requirements
5.  Code
6.  Test
7.  Maintain user interface, especially three button interface, so we don't piss off customers who learn one way to have the rug pulled out from under them because another customer made a persausive argument to make a change.
    A.  Also reduces the number of demo videos we would have to make.
    B.  Also reduces support calls.  (We want to scale, cannot clone Kenny, and even if we could)
8.  Limit changes to three button interface to absolute minimum.

## Possible 3-button UI changes
1.  Keep left to right 3 button motion for pairing/enabling bluetooth.
2.  Implement right to left 3 button motion to disable bluetooth (without losing pairing keys)
3.  Add mode change to the middle button hold-to-config.
    A. Make the mode change the first option for quick change.
    B. Display rainbow or TBD in 1/4 ring increments for different modes
        i.    1/4 - Treestand Hunting (Default)
        ii.   1/2 - Still Hunting   ; May be too complicated, doesn't cover future bright ideas.
        iii.  3/4 - 3D / Field      ; May be too complicated, doesn't cover future bright ideas.
        iv.  Full - Target          ; May be too complicated, doesn't cover future bright ideas.

Recommend only revert to default without app. See Goal 7.  The three button interface is already to complex for most people, who will use application anyway.

## Possible Cyber Shot UI changes
1.  Allow users to setup their own scenerios.
    A. Scenerios can be named and saved for loading up settings the user previously liked.
2.  We can provide templates (e.g., Vegas, Still Hunting) as starting points that can be modified and renamed.
3.  Configurable options include:
    A.  How to turn on
    B.  If, how, and when to disable illumination.  (e.g., 1 shot, N shots, timer, motion, combination thereof)
    C.  If, how, and when to enable bluetooth.  (e.g., 1 shot, N shots, timer, motion, combination thereof)
    D.  If, how, and when to transfer shots.  (E.g., automatically after 1 shot, automatically after N shots, only when requested)
    E.  How to enter lowest power mode (button, timeout, lack of motion, etc.)


# Illumination (On/off) settings
## Auto illumination setting
   1.  Button
   2.  IMU based setting AI_IMU_MOV0
## Auto deillumination setting
   1.  Button based
   2.  IMU based setting ADI_IMU_STILL0
   3.  IMU based shot detected ADI_IMU_SD0
   4.  Timer based setting ADI_TIMER0

# Bluetooth settings
## Bluetooth pairing
   1.  LCR roll
## Auto Bluetooth enable
   1.  Auto bluetooth was previously enabled and illumination just enabled
   2.  IMU based shot detected AI_IMU_BT0
## Auto Bluetooth shot transfer
## Manual Bluetooth shot transfer
## Auto Bluetooth disable
## Manual bluetooth disable
   1.  RCL roll


## Use cases

Goals:  Preserve battery life without annoying the archer.  Archer may actively be using bluetooth at times and may want to connect/autoconnect (assumes previously paired).  Archer may want to have the radio disabled to preserve battery life in other situations.

### Stand Hunting
Auto illumination on and auto illumination off presents technical challanges while stand hunting.

  Typically Pick Bow from bow hanger, less frequently hunter is holding bow.  Many hunters will want auto
illumination, while others may want push button.
 For auto illumination, if the hunter is holding the bow for long periods, the scope may stay illuminated for long
 periods without any benefit, draining battery, due to motion sensitivity setting to tigger illumuination off.
.
 However, requiring a button push to illuminate while stand hunting may be annoying to some, and if possible we should endeavor to use
 motion hysterisys or some other motion based solution.

 Illumination Time          The archer may draw back for extended periods waiting for the best, most ethical kill shot.  If possible
 detecting bow draw and staying illuminated until release would be goood, to avoid time based trigger to turn
 Illumination off.
 Shots          Typicallly 1
   Enable:  Cyber Shot app only, Disable:  TBD.
 3D / Field     Enable:  Cyber Shot app only, Disable:  TBD.
 Target         Enable:  Cyber Shot app only, Disable:  TBD.

- Archer is elevated and stationary, often in saddle or tree stand.  Bow is often on a bow hanger.  Wind may rock bow.  Archer may hold bow for extended times, and may hold the bow drawn for extended times.  Archer may take follow up shot if opportunity or exigencies require.

### Still Hunting
- Archer spot-and-stalk / ground hunting.  Archer and bow is mobile.  Archer may hold bow for extended times, and may hold the bow drawn for extended times.  Archer may take follow up shot if opportunity or exigencies require.  Phone with app most often stays with archer, needs to auto reconnect with cyber scope, if archer is using shot data with scoring.  Archer may select to only enable bluetooth after shot, waiting for game to bleed out.

### Target

#### NFAA Indoor round

Bows stay behind line during arrow retrieval, archers walk downrange to score and retrieve.  Phone with app most often stays with archer who may be using it to log scores.  The phone app needs to automatically reconnect with cyber scope if archer is using shot data with scoring.

Note:  Possible conflict.
       4.3  The method of breaking ties will be at the discretion of the tournament director.
       5.2  X-rings shall be counted and used as tie breakers and will be considered part of the official score.

Kenny says:  In the event of tie, and Xs are also tied, in practice the tournament director can do 1 arrow shoot off closest to center, or 20 arrow most "inside out" (arrow is inside the X without touching circle) Xs.


##### One Spot Indoor round
-One spot indoor round, NFAA Indoor (300): standard unit is 60 arrows.  end of 5 arrows, 4 ends per game, 3 games per round, max score of 300.  Possible some events may not use Xs as tiebreaker.

##### Five spot Indoor round
-Five spot indoor round, NFAA Indoor (300): standard unit is 60 arrows.  end of 5 arrows, 4 ends per game, 3 games per round, max score of 300.  Possible some events may not use Xs as tiebreaker.

#### Vegas Round

-Vegas round, NFAA Indoor (900):  standard unit of 30 arrows.  end of 3 arrows, 5 ends per game.  3 games per round, max score of 900.  Bullseye 10 points, X is a tie breaker.  3 targets/spots on sheet, archer can use any or all.

-NFAA Outdoor Target:  end of 5 arrows.  4 minutes per end.  Classic 600 + 900 Round shot across two days.

-NFAA Outdoor Field:  Field, Hunter, and Animal Rounds across three days.  Each round typically 28 targets, 4 arrows per target (112 arrows per round).  Walk-through course--archers carry bows to target to score and pull arrows, then to next station.  Some hang bow on rack at target while pulling arrows, but bow is carried the whole course.  Phone with app most often stays with archer, needs to auto reconnect with cyber scope, if archer is using shot data with scoring.

References:
  -https://nfaausa.com/files/nfaa-round-basics-160223233655.pdf

  -https://nfaausa.com/about/constitution/official-nfaa-rounds

### 3D
-ASA:  1 arrow per shooter per target, shot from designated stake.  Pro/Am:  two rounds of 20 targets (40 arrows total, one or two days).  Federation qualifiers:  minimum one round of 20 targets in one day.  No strict per-arrow time limit--pacing is group-based.

-IBO:  40 targets, walk-through course, 1 arrow per target, max score 440.  World Championship:  two 20-target courses over two days.  No per-shot time limit--group pacing applies.

-Regional Park Walk-Through:  (rules typically require bow left on hanger when retrieving arrows, with some exceptions)

### Indoor practice
- Arrows are shot.  Bow stays behind line during arrow retrieval, archers walk downrange to retrieve arrows.  Phone with app most often stays with archer, needs to auto reconnect with cyber scope, if archer is using shot data with or without scoring.

### Outdoor practice
- Field
  One or more arrows are shot at each target.  Bow is hung at the shooting zone, archers walk to target to retrieve arrows.  Phone with app most often stays with archer, needs to auto reconnect with cyber scope, if archer is using shot data with or without scoring.

- Target
  Arrows are shot.  Bow stays behind line during arrow retrieval, archers walk downrange to retrieve arrows.  Phone with app most often stays with archer, needs to auto reconnect with cyber scope, if archer is using shot data with or without scoring.

### 3D practice
- Arrows are shot.  Bow stays behind line during arrow retrieval, archers walk downrange to retrieve arrows.  Phone with app most often stays with archer, needs to auto reconnect with cyber scope, if archer is using shot data with or without scoring.

### Future
- Future competition rules may come out requiring future updates.   A way to avoid this is to allow the user to define his own scenerio as discussed in "Possible Cyber Shot UI changes"  above.

### Excluded
-USA Archery / World Archery:  No electronics of any kind on bow.  Cyber Scope not permitted.


