diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/anduril-manual.md | 86 |
1 files changed, 64 insertions, 22 deletions
diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 9fe5490..31760d5 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -142,17 +142,13 @@ manufacturer's request. This typically includes: - `Ramp -> 3C`: Toggle smooth or stepped ramp shape. - `Ramp -> 5H`: Sunset timer. - - `Off -> 3H`: Access the strobe/mood modes. - `Off -> 7C/7H`: Change the aux LED pattern. - `Lockout -> 7C/7H`: Change the aux LED pattern. -If your light uses Extended Simple UI, *think twice about letting kids use it*, -because the strobe/mood modes were not intended to be used in simple mode, and -can reach full power with no thermal regulation. - -It is likely that strobe/mood modes will be removed from Extended Simple UI in -the future, for safety reasons, or maybe have already been removed. But that -doesn't help with older firmware, so be careful. +Old versions (before 2024-08) also allowed access to strobe/mood modes, which +can be dangerous, so if you have one of those, *think twice about letting kids +use it*. Those modes were never intended to be child-safe, and can reach full +power with no thermal regulation. ### Configuring Simple UI @@ -177,12 +173,17 @@ and they will carry over to Simple UI: - ramp style (smooth / stepped) - smooth ramp speed - ramp-after-moon style + - smooth steps - memory settings - auto-lock settings - aux LED settings - voltage calibration + - post-off voltage display + - aux led low and high ramp levels - thermal regulation settings - hardware-specific "misc menu" settings + - channel modes + - channel mode for number blinks Advanced UI @@ -191,6 +192,11 @@ Advanced UI Most of the information below this is for the Advanced UI. Anything not already noted above is blocked in the Simple UI. +To check which UI the user is in, Simple UI or Advanced UI, enter battery check +mode with `3C` from Off. In Simple UI, the battery voltage is displayed only +once, but in Advanced UI, the battery voltage is checked and displayed +repeatedly. + Ramping / Stepped Ramping Modes ------------------------------- @@ -256,6 +262,7 @@ While the light is on, a few actions are available: 4 = Quarter speed, ~10s. - `10C`: Activate manual memory and save the current brightness. + Also saves current channel mode, on multi-channel lights. - `10H`: Ramp extras config menu. - Item 1: Disable manual memory and go back to automatic memory. (doesn't matter what value the user enters at the prompt) @@ -421,14 +428,30 @@ In more detail, this is what each blinky / utility mode does: ### Battery check: -Blinks out the battery voltage per cell. Full is 4.2V, empty is -about 3.0V. The light blinks the whole-number digit first, pauses, -then blinks out the "tenths" digit. Then a longer pause, and it -repeats. -So for 4.2V, it would be "blink-blink-blink-blink .. blink-blink". +Blinks out the battery voltage per cell. Full is 4.20V, empty is +about 3.00V. The light blinks the whole-number digit first, pauses, +then blinks out the "tenths" digit, pauses, then blinks out the "hundredths" +digit, in 0.02V steps. So for 4.16V, it would be "4 blinks, 1 blink, +6 blinks". Then if it is in Advanced UI, it pauses for a bit longer and +repeats. In Simple UI, it turns off after one readout. A "zero" digit is represented by a very quick blink. +The battery check format has changed a few times: + + - For Anduril 2 from 2024-04 or later, the battery voltage resolution is + 0.02V steps (the last digit can be 0, 2, 4, 6, or 8). + + - For Anduril 2 from 2023-12 or later, the battery voltage resolution is + 0.025V steps (the last digit can be 0, 2, 5, or 7). + + - For Anduril 2 from 2023-12 or earlier, the battery voltage resolution is + 0.1V, so the light blinks the whole-number digit first, pauses, then blinks + out the "tenths" digit. Then a longer pause, and it repeats. + + - On old attiny85 lights with only 8 KiB of ROM, battery voltage resolution + is 0.1V, even on newer versions of Anduril. + On lights with more than one set of LEDs, pressing `3C` during batt check mode can select which set of LEDs (which channel mode) it uses to blink out numbers. @@ -453,11 +476,23 @@ The voltage config menu has these settings: `12C`: +0.25V `13C`: +0.30V - 2. Post-off voltage display timeout. (only on lights with RGB aux) + 2. Post-off voltage display timeout. (only on lights with RGB aux) This setting determines how many seconds the RGB aux LEDs display the voltage color after the torch goes to sleep. Click once per desired second, or zero times to turn this function - off. + off. The default is 4 seconds. + + 3. Aux low ramp level. Controls behavior of aux button LEDs while the main + LEDs are on. Below this ramp level, button LEDs will not be lit up while + the main LEDs are on. At or above this level, button LEDs light up at the + "low" brightness level. Setting it to 0 keeps the button LEDs off + completely while the main LEDs are on. + Also controls brightness of post-off voltage display. + + 4. Aux high ramp level. At or above this ramp level, button LEDs light up at + the "high" brightness level. Setting it to 0 disables button's high aux + mode while the main LEDs are on. + Also controls brightness of post-off voltage display. ### Temperature check: @@ -957,6 +992,8 @@ This setting only applies to modes with channel ramping (i.e. tint ramping), and only when that mode uses the default `3H` event handler. Custom channel modes may work differently. +On lights with channel modes, manual memory (`Ramp -> 10C`) saves the +current brightness *and* channel mode. UI Reference Table @@ -1013,6 +1050,7 @@ This is a table of all button mappings in Anduril, in one place: | | | | 2: ceiling | | | | 3: speed / steps | Ramp | Full | `10C` | Turn on manual memory and save current brightness +| | | | (and current channel mode) | Ramp | Full | `10H` | Ramp Extras config menu: | | | | 1: switch to automatic mem, not manual mem | | | | 2: set manual mem timeout @@ -1071,14 +1109,18 @@ This is a table of all button mappings in Anduril, in one place: | Batt check | Full | `3C` | Next channel mode (for number blinks only) | Batt check | Full | `7H` | Voltage config menu | | | | 1: voltage correction factor -| | | | ... -| | | | 5: -0.10V -| | | | 6: -0.05V -| | | | 7: no correction -| | | | 8: +0.05V -| | | | 9: +0.10V -| | | | ... +| | | | ... 5: -0.10V +| | | | ... 6: -0.05V +| | | | ... 7: no correction +| | | | ... 8: +0.05V +| | | | ... 9: +0.10V | | | | 2: post-off voltage display seconds +| | | | 3: aux low ramp level +| | | | ... 0: disabled +| | | | ... 1+: light up at this ramp level +| | | | 4: aux high ramp level +| | | | ... 0: disabled +| | | | ... 1+: brighter at this ramp level | Mode | UI | Button | Action | :--- | :-- | ------: | :----- |