~gabe/flashlight-firmware/anduril2

« back to all changes in this revision

Viewing changes to ToyKeeper/bistro/biscotti/biscotti.txt

  • Committer: Selene Scriven
  • Date: 2016-11-29 22:51:09 UTC
  • mto: This revision was merged to the branch mainline in revision 176.
  • Revision ID: ubuntu@toykeeper.net-20161129225109-oab58sah3mb7mk1j
Copied biscotti.c to gchart/babka/babka.c

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
"Biscotti" firmware for Convoy brand lights
 
2
===========================================
 
3
 
 
4
This is designed for the Nanjg 105D drivers used in Convoy lights.
 
5
 
 
6
The interface is as follows:
 
7
 
 
8
  While off:
 
9
 
 
10
    - Fully click and release to turn the light on.  It will go to the 
 
11
      first mode or the last-used mode, depending on whether you enabled 
 
12
      mode memory.
 
13
 
 
14
  While on:
 
15
 
 
16
    - Short tap: Do a short (less than 0.5s) half-press to go forward to 
 
17
      the next mode.
 
18
 
 
19
    - Long tap: Do a long (longer than 0.5s) half-press to reset to the 
 
20
      first mode (if mode memory is turned off).
 
21
 
 
22
    - Or fully click and release to turn the light off.
 
23
 
 
24
    - Short tap a bunch of times (10+ taps, or until the light stops 
 
25
      turning on) to enter config mode.
 
26
 
 
27
  Blinky modes:
 
28
 
 
29
    - Some mode groups have blinky modes.  They are not hidden, but if 
 
30
      you leave mode memory off you can skip them with a long press.  
 
31
      Blinky modes include:
 
32
 
 
33
      - Tactical strobe (~10 Hz)
 
34
 
 
35
      - Biking flasher (2-level stutter beacon, 1 Hz)
 
36
 
 
37
      - Battery check / beacon mode
 
38
        Each blink represents about 25% battery charge, so 1 is a low 
 
39
        battery and 4 blinks is full.  5 blinks means it's over-charged.
 
40
 
 
41
      - SOS
 
42
 
 
43
  Configuration options:
 
44
 
 
45
    The config mode has several options.  It will blink out a number to 
 
46
    show which option is active, then "buzz" or "stutter" for a bit.  
 
47
    Click during the "buzz" to select that option.
 
48
 
 
49
    Options include:
 
50
 
 
51
      1. Mode group.  After clicking, the light should come on in a 
 
52
         special group-select mode.  In this mode, it slowly blinks out 
 
53
         numbers from 1 to N, where N is the number of mode groups, then 
 
54
         repeats.  Turn the light off after N blinks to select mode 
 
55
         group N.  BTW, do not leave the light in this mode for long 
 
56
         periods of time, because it will wear out the driver's memory 
 
57
         faster.
 
58
 
 
59
         The mode groups are: (output is approximate)
 
60
 
 
61
           1. 0.1%, 1, 10, 35, 100, strobe, biking, battcheck
 
62
           2. 0.1, 1, 10, 35, 100
 
63
           3. 100, 35, 10, 1, 0.1
 
64
           4. 1, 20, 100, strobe, biking, battcheck, SOS
 
65
           5. 1, 20, 100
 
66
           6. 100, 20, 1
 
67
           7. 0.1, 1, 10, 50, strobe, biking, battcheck, SOS
 
68
           8. 0.1, 1, 10, 50
 
69
           9. 50, 10, 1, 0.1
 
70
          10. 1, 10, 35, 100
 
71
          11. 100, 20, strobe
 
72
          12. 100% only
 
73
 
 
74
         Example: To select group 5 (low-med-high), let it blink until 
 
75
         it counts out five, then click the button.
 
76
 
 
77
      2. Mode memory.  Off or on.
 
78