← Back to branch summary

~gabe/flashlight-firmware/anduril2

« back to all changes in this revision

Viewing changes to ToyKeeper/bistro/bistro.txt

  • Committer: Selene Scriven
  • Date: 2017-09-12 23:34:36 UTC
  • mto: (188.1.3 trunk)
  • mto: This revision was merged to the branch mainline in revision 331.
  • Revision ID: bzr@toykeeper.net-20170912233436-d3w6nln0ts1subue
Added Flintrock's Bistro-HD 1.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
ToyKeeper/bistro/bistro.txt
 
1
"Bistro" firmware
 
2
=================
 
3
 
 
4
This is designed for an ATTiny25V-based driver with off-time capacitor 
 
5
and FET+7135 power channel configuration.
 
6
 
 
7
The interface is as follows:
 
8
  (see bistro-ui.png for a quick start)
 
9
 
 
10
  While off:
 
11
 
 
12
    - Fully click and release to turn the light on.  It will go to the 
 
13
      first mode or the last-used mode, depending on whether you enabled 
 
14
      mode memory.
 
15
 
 
16
  While on:
 
17
 
 
18
    - Short tap: Do a short (less than 0.5s) half-press to go forward to 
 
19
      the next mode.
 
20
 
 
21
    - Med tap: Do a medium (0.5s to 1.5s) half-press to go backward to 
 
22
      the previous mode, if medium-press is enabled.
 
23
 
 
24
    - Long tap: Do a long (longer than 1.5s) half-press to reset to the 
 
25
      first mode (if mode memory is turned off).
 
26
 
 
27
    - Or fully click and release to turn the light off.
 
28
 
 
29
    - Short tap a bunch of times (15+ taps, or until the light stops 
 
30
      turning on) to enter config mode.
 
31
 
 
32
  Hidden modes:
 
33
 
 
34
    - Go backward from moon to access the hidden modes.  They are, in 
 
35
      order:
 
36
 
 
37
      - Turbo (just like the regular turbo)
 
38
 
 
39
      - Tactical / police strobe (7 Hz / 14 Hz alternating)
 
40
 
 
41
      - Battery check / beacon mode
 
42
        It should blink out the voltage in whole numbers then a '.' then 
 
43
        tenths.  So, for 3.6V it would blink out "--- . ------".  
 
44
        Voltage range is from about 2.5V to 4.4V
 
45
 
 
46
      - Biking flasher (2-level stutter beacon, 1 Hz)
 
47
 
 
48
  Configuration options:
 
49
 
 
50
    The config mode has several options.  It will blink out a number to 
 
51
    show which option is active, then "buzz" or "stutter" for a bit.  
 
52
    Click during the "buzz" to select that option.  Some options may 
 
53
    enter a secondary config mode after the light turns back on.
 
54
 
 
55
    Options include:
 
56
 
 
57
      1. Muggle mode / simple mode.  Good while lending the light to 
 
58
         others.  It overrides other config settings temporarily:
 
59
         - low/med/high, in that order, with high at about half power.
 
60
         - no moon, no memory, no medium-presses, no hidden modes
 
61
         - the only config option is the option to exit muggle mode
 
62
 
 
63
      2. Mode memory.  Off or on.
 
64
 
 
65
      3. Moon.  Select to turn moon mode on or off.  This is in addition 
 
66
         to the other regular modes, so you get 2 to 9 levels when moon 
 
67
         is enabled.
 
68
 
 
69
      4. Mode order.  Low to high, or high to low.
 
70
 
 
71
      5. Mode group.  Choice of 1 to 6 regular modes from low to turbo, 
 
72
         or one of 3 special groups.  After clicking, the light should 
 
73
         come on in a special group-select mode.  In this mode, it 
 
74
         slowly blinks 9 times, pauses, then repeats.  Turn the light 
 
75
         off after N blinks to select mode group N.
 
76
         The mode groups are: (output is approximate)
 
77
 
 
78
         1. 1300 lm only
 
79
         2. 8, 1300 lm
 
80
         3. 8, 235, 1300
 
81
         4. 8, 104, 506, 1300
 
82
         5. 8, 75, 254, 642, 1300
 
83
         6. 8, 50, 167, 366, 757, 1300
 
84
         7. 140, 1300, strobe
 
85
            (police modes)
 
86
         8. bike flasher, battcheck, 8, 140, 1300
 
87
            (biking modes)
 
88
         9. 4, 36, 140, 500, 1300
 
89
            (like group 5 but lower)
 
90
 
 
91
         Example: To select group 3 (low-med-high), let it blink three 
 
92
         times then click the button.
 
93
 
 
94
         Note: 140 lm means 100% on the 7135 channel, while 1300 means 
 
95
         100% on the FET channel.  Both are no-PWM modes.
 
96
 
 
97
      6. Medium-press.  Off or on.  If on, a medium-press will allow 
 
98
         going backward through the mode sequence, and hidden blinky 
 
99
         modes will be accessible.
 
100
 
 
101
      7. Thermal calibration.  Set the temperature at which the light 
 
102
         will begin stepping down to cool itself off.  After clicking to 
 
103
         select this, the light should turn on in a special thermal 
 
104
         calibration mode.  It will start at a medium-low brightness, 
 
105
         wait a second or two, then step up to turbo.
 
106
 
 
107
         - To turn off thermal regulation, click within the first second 
 
108
           (while the output is relatively low).
 
109
 
 
110
         - To set a new maximum temperature, leave the light on until 
 
111
           you think it is too hot, then turn it off.  From this point 
 
112
           on, the light will use that new temperature as its maximum 
 
113
           allowed heat.
 
114
 
 
115
           Note that there may be a delay between when you feel the heat 
 
116
           and when the MCU feels the heat, so the value saved may be a 
 
117
           little bit lower than expected.
 
118
 
 
119
      8. Factory reset.  Change all settings back to default.