aboutsummaryrefslogtreecommitdiff
path: root/docs/anduril-manual.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/anduril-manual.md')
-rw-r--r--docs/anduril-manual.md69
1 files changed, 55 insertions, 14 deletions
diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md
index ee65672..b8ccd63 100644
--- a/docs/anduril-manual.md
+++ b/docs/anduril-manual.md
@@ -191,6 +191,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 +261,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 +427,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 +475,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:
@@ -955,6 +989,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
@@ -1011,6 +1047,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
@@ -1069,14 +1106,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
| :--- | :-- | ------: | :-----