kenny/cyber.scope
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source 
Initial commit.
This commit is contained in:
kntran1
2026-03-23 14:40:39 -05:00
parent e84b2b4166
commit 4e2a5258a5
872 changed files with 165227 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
requirements/SamplePaperScoreSheets.docx Normal file
View File

Binary file not shown.

150
requirements/goals_and_use_cases.md Normal file
View File

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

94
requirements/tbd.md Normal file
View File

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