From c68cd4e182363bb05d24c7dee48723606250b38e Mon Sep 17 00:00:00 2001 From: dirtydancing Date: Tue, 12 Dec 2023 19:57:34 +0100 Subject: Document aux LED settings in Tactical Mode --- docs/anduril-manual.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 68c577c..9fe5490 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -639,6 +639,8 @@ This assumes the light has a ramp 150 levels long. Strobe modes start at the ramp size plus 1, so it may be different if a light has a different ramp size. +In Tactical Mode, the aux LED settings are inherited from Lockout Mode. + Configuration Menus ------------------- -- cgit v1.2.3 From ef24cb6cb42ad64f70fd90f2c8606223c4a2c3dc Mon Sep 17 00:00:00 2001 From: SiteRelEnby Date: Mon, 19 Feb 2024 01:32:10 -0600 Subject: Improve manual - add links for navigability, and an FAQ --- docs/anduril-manual.md | 96 +++++++++++++++++++++++++++----------------------- 1 file changed, 52 insertions(+), 44 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 68c577c..b40b454 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -30,6 +30,7 @@ more modes and features available for people who want more. For a full list of button mappings, scroll down to the [UI Reference Table](#ui-reference-table) at the end of this file. +If you have a specific question, it may be covered in the [FAQ](#faq). Button presses -------------- @@ -105,15 +106,15 @@ Functions available in Simple UI include: - `2H`: If light is on : ramp down If light is off: momentary high mode - `2C`: Double click to go to / from highest safe level - - `4C`: Lockout mode. + - `4C`: [Lockout mode](#lockout-mode). Some other modes and functions are available too. When the light is off, these are the options: - - `3C`: Battery check mode. (displays voltage once, then turns off) - - `4C`: Lockout mode. - - `10H`: Switch to Advanced UI. - - `15C` or more: Version check. + - `3C`: [Battery check mode](#battery-check). (displays voltage once, then turns off) + - `4C`: [Lockout mode](#lockout-mode). + - `10H`: Switch to [Advanced UI](#advanced-ui). + - `15C` or more: [Version check](#version-check-mode). In Lockout mode with Simple UI, there are a few functions: @@ -129,7 +130,7 @@ do one of these: In Simple UI: - - `10H`: Go to Advanced UI. + - `10H`: Go to [Advanced UI](#advanced-ui). In Advanced UI: @@ -140,11 +141,11 @@ do one of these: Some lights have additional features enabled in Simple UI, at the 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. + - `Ramp -> 3C`: Toggle smooth or stepped [ramp shape](#ramping--stepped-ramping-modes). + - `Ramp -> 5H`: [Sunset timer](#sunset-timer). + - `Off -> 3H`: Access the [strobe/mood modes](#strobe--mood-modes). + - `Off -> 7C/7H`: Change the [aux LED brightness](#aux-leds--button-leds). + - `Lockout -> 7C/7H`: Change the [aux LED pattern](#aux-leds--button-leds). 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 @@ -160,7 +161,7 @@ Simple UI can be configured in several ways, but not while Simple UI is active. So go to the Advanced UI, configure things, then go back to Simple UI. -In Advanced UI's "Off" mode: +In [Advanced UI](#advanced-ui)'s "Off" mode: - `10H`: Configure Simple UI. @@ -191,6 +192,8 @@ 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 return to Simple UI from advanced UI, enter 10C while the light is off. + Ramping / Stepped Ramping Modes ------------------------------- @@ -230,21 +233,20 @@ While the light is on, a few actions are available: at the ceiling, it goes down instead. - `2H`: Change brightness (down). - - `3C`: Switch to the other ramp style. (smooth / stepped) - (or activate the next channel mode, when more than one is enabled) + - `3C`: Switch to the other [ramp style](#ramping--stepped-ramping-modes). (smooth / stepped) + (or activate the next [channel mode](#channel-modes-aka-tint-ramping-or-multi-channel-controls), when more than one is enabled) (then use 6C instead, for smooth / stepped toggle) - `6C`: Switch to the other ramp style. (when `3C` is mapped to next channel) - `3H`: Momentary turbo (when current channel has no tint to ramp). - - `3H`: Tint ramping (only when current channel has adjustable tint). + - `3H`: [Tint ramping](#channel-modes-aka-tint-ramping-or-multi-channel-controls) (only when current channel has adjustable tint). - `4H`: Momentary turbo, when `3H` is mapped to tint. - - `4C`: Go to lockout mode. - - - `5C`: Go to momentary mode. - - `5H`: Start a sunset timer. Details are below in the Sunset Timer section. + - `4C`: Go to [lockout mode](#lockout-mode). - - `7H`: Ramp config menu. + - `5C`: Go to [momentary mode](#momentary-mode). + - `5H`: Start a [sunset timer](#sunset-timer). + - `7H`: [Ramp config menu](#ramp-config-menu). - Item 1: Floor level. - Item 2: Ceiling level. - Item 3: @@ -256,6 +258,7 @@ While the light is on, a few actions are available: 4 = Quarter speed, ~10s. - `10C`: Activate manual memory and save the current brightness. + - `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) @@ -337,16 +340,16 @@ Other Modes Anduril has several other modes too. To access these, press the button more than 2 times when the light is off: - - `3C`: Blinky / utility modes, starting with battery check. - - `3H`: Strobe modes, starting with the most recently used strobe. - - `4C`: Lockout mode. - - `5C`: Momentary mode. - - `6C`: Tactical mode. - - `7C` / `7H`: Aux LED configuration. - - `9H`: Misc Config menu. (only on some lights) - - `10H`: Simple UI configuration menu. - - `13H`: Factory reset (on some lights). - - `15C` or more: Version check. + - `3C`: [Blinky / utility modes](#blinky--utility-modes), starting with battery check. + - `3H`: [Strobe modes](#strobe--mood-modes), starting with the most recently used strobe. + - `4C`: [Lockout mode](#lockout-mode). + - `5C`: [Momentary mode](#momentary-mode). + - `6C`: [Tactical mode](#tactical-mode). + - `7C` / `7H`: [Aux LED configuration](#aux-leds--button-leds). + - `9H`: [Misc Config menu](#misc-config-menu). (only on some lights) + - `10H`: [Simple UI](#simple-ui) configuration menu. + - `13H`: [Factory reset](#factory-reset) (on some lights). + - `15C` or more: [Version check](#version-check-mode). Lockout Mode @@ -379,7 +382,7 @@ lockout mode has two levels: (or the manual mem level, if there is one) - `3H`: Next channel mode (if more than one is enabled). - + It is also possible to make the light lock itself automatically after being turned off. To enable this, go to lockout mode and use a `10H` action to activate the auto-lock config menu. Release the button after @@ -390,11 +393,9 @@ timeout to N minutes. A value of zero disables the auto-lock feature. So, to turn off auto-lock, don't click at all. -And on lights which have aux LEDs, there may be additional functions: - - - `7C` / `7H`: Change Lockout Mode's aux LED pattern. More details on - this below, in a separate section. +On lights which have aux LEDs, there may be additional functions: + - `7C` / `7H`: Change Lockout Mode's [aux LED pattern](#aux-leds--button-leds). Blinky / Utility Modes ---------------------- @@ -403,10 +404,10 @@ Click 3 times from Off to access Anduril's blinky / utility modes. This always starts at battery check and the user can proceed to other blinky modes if Advanced UI is enabled. The sequence is: - - Battery check. - - Temperature check (if light has a temperature sensor). - - Beacon mode. - - SOS mode (if enabled). + - [Battery check](#battery-check). + - [Temperature check](#temperature-check) (if light has a temperature sensor). + - [Beacon mode](#beacon-mode). + - [SOS mode](#sos-mode) (if enabled). In all of these modes, some basic actions are available: @@ -526,12 +527,12 @@ In all of these modes, a few actions are available: - `1H`: Increase brightness, or strobe faster. (except lightning) - `2H`: Decrease brightness, or strobe slower. (except lightning) - `4C`: Previous strobe / mood mode. - - `5C`: Go to momentary mode, for a momentary strobe. + - `5C`: Go to [momentary mode](#momentary-mode), for a momentary strobe. (this is useful for light painting) Additionally, candle mode has one more action: - - `5H`: Activate Sunset Timer, and/or add 5 minutes to the timer. + - `5H`: Activate [Sunset Timer](#sunset-timer), and/or add 5 minutes to the timer. In more detail, here is what each mode does: @@ -784,7 +785,7 @@ several formats: If the version doesn't include a model number, you may be able to find the model in the PRODUCTS file to see which firmware model it probably uses: - https://bazaar.launchpad.net/~toykeeper/flashlight-firmware/anduril2/view/head:/PRODUCTS + https://github.com/ToyKeeper/anduril/blob/trunk/MODELS Protection Features @@ -942,7 +943,7 @@ smooth or stepped brightness ramp. Additionally, when a channel mode has nothing to adjust with `3H`, the `3H` action also reverts to its single-channel behavior -- momentary turbo. -The Misc Config Menu (`Off -> 9H`) may also have a setting to choose a +The [Misc Config Menu](#misc-config-menu) (`Off -> 9H`) may also have a setting to choose a tint ramp style. There are a few styles available, by entering different numbers into that config menu: @@ -955,7 +956,14 @@ 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. - +FAQ +--- +* Q: Why do the aux LEDs come on whenever I switch the light off, regardless +of aux settings? +* A: This is the post-off voltage display feature. It can be configured or +disabled under [battery check](#battery-check) mode. +* Q: What can I do to contribute to Anduril development? +* A: See [Contributing](https://github.com/ToyKeeper/anduril#contributing). UI Reference Table ------------------ -- cgit v1.2.3 From d7c7ff8e921456b1f1a27ad16f6d3466157c91c4 Mon Sep 17 00:00:00 2001 From: SiteRelEnby Date: Mon, 6 Nov 2023 14:50:06 -0600 Subject: Add a feature to make RGB voltage configurable Adds two entries to the battery voltage settings menu, the first isathreshold for switching aux to high, and the second sets a minimum level for it to be displayed, also effectively allowing the feature to be entirely disabled if not wanted. --- docs/anduril-manual.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 68c577c..9ede671 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -453,12 +453,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. + 3. RGB voltage while on high threshold. On lights where the battery + voltage is displayed using RGB aux while the light is on, sets + the ramp level at which the aux will switch to high brightness. + If set to 151, this effectively forces the voltage to only ever + be displayed using low brightness, or if set to 0, to only ever + use high brightness. + + 4. RGB voltage while on minimum level. Below this level, voltage will + not be displayed using the RGB aux at all. Setting this to 151+ + effectively disables the entire feature. + ### Temperature check: Blinks out the current temperature in degrees C. This number should -- cgit v1.2.3 From b534471eb4c998e60ad250c2119dca9d38784e77 Mon Sep 17 00:00:00 2001 From: dirtydancing Date: Wed, 25 Sep 2024 22:22:54 +0200 Subject: Manual: Update options inherited by Simple UI --- docs/anduril-manual.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index cdf0dd1..ee65672 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -173,12 +173,16 @@ 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 - thermal regulation settings - hardware-specific "misc menu" settings + - channel modes + - channel mode for number blinks Advanced UI -- cgit v1.2.3 From 7f580a2f782a0d53926a73aae936f427777145eb Mon Sep 17 00:00:00 2001 From: dirtydancing Date: Fri, 27 Sep 2024 18:44:19 +0200 Subject: Manual: Add channel mode to manual memory --- docs/anduril-manual.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index cdf0dd1..03c9aca 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -951,6 +951,9 @@ 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. +Furthermore, on lights with channel modes, manual memory (`Ramp -> 10C`) +not only saves the current brightness, but also the current channel mode. + UI Reference Table @@ -1007,6 +1010,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 on multi-channel lights) | Ramp | Full | `10H` | Ramp Extras config menu: | | | | 1: switch to automatic mem, not manual mem | | | | 2: set manual mem timeout -- cgit v1.2.3 From 7143feb93b3606cbda80a88ff7026d98d510b07f Mon Sep 17 00:00:00 2001 From: dirtydancing Date: Wed, 4 Dec 2024 20:18:09 +0100 Subject: Manual: Add default for post-off voltage display --- docs/anduril-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index cdf0dd1..4b6d681 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -453,7 +453,7 @@ The voltage config menu has these settings: 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. ### Temperature check: -- cgit v1.2.3 From bad12d2b314a5b99e9045e4653263635bd1af906 Mon Sep 17 00:00:00 2001 From: dirtydancing Date: Thu, 19 Dec 2024 19:12:16 +0100 Subject: Manual: Document extra digit for battery check --- docs/anduril-manual.md | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index cdf0dd1..245c90f 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -417,14 +417,28 @@ 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. Then a longer pause, and it +repeats. So for 4.16V, it would be "blink-blink-blink-blink .. blink +.. blink-blink-blink-blink-blink-blink". 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 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. -- cgit v1.2.3 From e8f88bb607290b50871eec71460278d40c357576 Mon Sep 17 00:00:00 2001 From: dirtydancing Date: Wed, 22 Jan 2025 19:41:43 +0100 Subject: Manual: Add how to check which UI the user is in --- docs/anduril-manual.md | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index cdf0dd1..96705cd 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -187,6 +187,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, the user can do +a battery check with `3C` from Off: In Simple UI, the battery voltage will +be displayed once, whereas in Advanced UI, the battery voltage will be +displayed continuously. + Ramping / Stepped Ramping Modes ------------------------------- -- cgit v1.2.3 From 2b19de99a2c4acd8041a50593ff3a7586fe06a27 Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Fri, 4 Jul 2025 04:57:34 -0600 Subject: made new settings apply to all button LEDs on lights bigger than 8K ROM This replaces "USE_CONFIGURABLE_RGB_VOLTAGE_LEVELS" with "USE_AUX_THRESHOLD_CONFIG", which controls the brightness of button LEDs while the main LEDs are on, and during post-off voltage display. Same basic concept, but works on single-color LEDs too, and lets the user finally configure POVD thresholds. The code for this is a bit messy, but the aux LED code as a whole is pretty messy since it wasn't designed for the things it does now. The entire thing needs a refactor or rewrite someday. But not today. For now, this is just enough to make the pull request cover more use cases before merging into trunk. I've tested it on a variety of lights, but am not yet entirely comfortable with it. However, it worked on at least these: - 1-color button LED, no RGB - front RGB, 1-color button LED - front RGB, hardwired also to RGB button - RGB button, no other aux These may need extra changes, and may have extra config options which do nothing... - front RGB, no button LED - 1-color front aux, no button LED - no aux at all - attiny85 lights (some could theoretically support the new options, but none even try) --- docs/anduril-manual.md | 39 ++++++++++++++++++++++----------------- 1 file changed, 22 insertions(+), 17 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 4a1723b..2b7ea30 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -455,16 +455,17 @@ The voltage config menu has these settings: once per desired second, or zero times to turn this function off. - 3. RGB voltage while on high threshold. On lights where the battery - voltage is displayed using RGB aux while the light is on, sets - the ramp level at which the aux will switch to high brightness. - If set to 151, this effectively forces the voltage to only ever - be displayed using low brightness, or if set to 0, to only ever - use high brightness. - - 4. RGB voltage while on minimum level. Below this level, voltage will - not be displayed using the RGB aux at all. Setting this to 151+ - effectively disables the entire feature. + 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: @@ -1076,14 +1077,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 | :--- | :-- | ------: | :----- -- cgit v1.2.3 From f45ae304a618ac7edc40f9c55ee4fc84676ed597 Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Sun, 6 Jul 2025 22:43:31 -0600 Subject: reworded a bit for consistency with the rest of the manual --- docs/anduril-manual.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index f7c6b07..e8ba274 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -187,10 +187,10 @@ 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, the user can do -a battery check with `3C` from Off: In Simple UI, the battery voltage will -be displayed once, whereas in Advanced UI, the battery voltage will be -displayed continuously. +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 -- cgit v1.2.3 From ed6a955c16ad16f5b8bf9cf1d8ede0ca810ba9ce Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Sun, 6 Jul 2025 23:05:59 -0600 Subject: added info about simple vs advanced UI, and attiny85 battcheck resolution --- docs/anduril-manual.md | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index b193286..7eea6b6 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -424,25 +424,27 @@ In more detail, this is what each blinky / utility mode does: 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. Then a longer pause, and it -repeats. So for 4.16V, it would be "blink-blink-blink-blink .. blink -.. blink-blink-blink-blink-blink-blink". +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 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 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. + - 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 -- cgit v1.2.3 From 70f8b6593e7d1f13c30a48d8e5563dc972501e4d Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Sun, 6 Jul 2025 23:10:30 -0600 Subject: space --- docs/anduril-manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 14c7173..8a73781 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -474,7 +474,7 @@ The voltage config menu has these settings: 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. The default is 4 seconds. + 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 -- cgit v1.2.3 From 3cea209515d20822cae714e0c162391774059256 Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Sun, 6 Jul 2025 23:19:51 -0600 Subject: added more info about manual memory remembering channel mode --- docs/anduril-manual.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index f13368f..62295b4 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -257,6 +257,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) @@ -984,9 +985,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. -Furthermore, on lights with channel modes, manual memory (`Ramp -> 10C`) -not only saves the current brightness, but also the current channel mode. - +On lights with channel modes, manual memory (`Ramp -> 10C`) saves the +current brightness *and* channel mode. UI Reference Table @@ -1043,7 +1043,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 on multi-channel lights) +| | | | (and current channel mode) | Ramp | Full | `10H` | Ramp Extras config menu: | | | | 1: switch to automatic mem, not manual mem | | | | 2: set manual mem timeout -- cgit v1.2.3 From f096ddf73b0a0e6773b1a37141ccc31f87b61da9 Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Sun, 6 Jul 2025 23:23:04 -0600 Subject: there's another inherited setting now --- docs/anduril-manual.md | 1 + 1 file changed, 1 insertion(+) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index b8ccd63..b550d88 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -179,6 +179,7 @@ and they will carry over to Simple UI: - 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 -- cgit v1.2.3 From 8fc92fc18e2e04973316782a04cfae7fbf3b8df6 Mon Sep 17 00:00:00 2001 From: Selene ToyKeeper Date: Mon, 7 Jul 2025 04:00:41 -0600 Subject: spacing, misc cleanup, made anchors work, fixed bad link (for some reason, "a name" wasn't working when clicked, but "a id" does) --- docs/anduril-manual.md | 38 +++++++++++++++++++++++--------------- 1 file changed, 23 insertions(+), 15 deletions(-) (limited to 'docs') diff --git a/docs/anduril-manual.md b/docs/anduril-manual.md index 479289f..4e28803 100644 --- a/docs/anduril-manual.md +++ b/docs/anduril-manual.md @@ -32,6 +32,7 @@ For a full list of button mappings, scroll down to the If you have a specific question, it may be covered in the [FAQ](#faq). + Button presses -------------- @@ -218,15 +219,15 @@ Advanced UI's ramp. There are four ways to access ramping mode when the light is off: - `1C`: Turn on at the memorized brightness. - (see below for details about what "memorized" means) + (see below for details about what "memorized" means) - `1H`: Turn on at the floor level. Let go after the light turns on to - stay at the floor level, or keep holding to ramp up. + stay at the floor level, or keep holding to ramp up. - `2C`: Turn on at the ceiling level. - - `2H`: Turn on at full power, turn off when released. (momentary turbo) - (in Simple UI, this uses the ceiling level instead of turbo) + - `2H`: Turn on at full power, turn off when released. (momentary turbo) + (in Simple UI, this uses the ceiling level instead of turbo) While the light is on, a few actions are available: @@ -235,23 +236,27 @@ While the light is on, a few actions are available: (or if it has regulated down, "bump" back up to turbo) (turbo level / behavior is configurable) - `1H`: Change brightness (up). - If the button was released less than a second ago, or if it's already - at the ceiling, it goes down instead. + If the button was released less than a second ago, + or if it's already at the ceiling, it goes down instead. - `2H`: Change brightness (down). - - `3C`: Switch to the other [ramp style](#ramping--stepped-ramping-modes). (smooth / stepped) - (or activate the next [channel mode](#channel-modes-aka-tint-ramping-or-multi-channel-controls), when more than one is enabled) + - `3C`: Switch to the other [ramp style](#ramping--stepped-ramping-modes). + (smooth / stepped) + (or activate the next [channel mode](#channel-modes), + when more than one is enabled) (then use 6C instead, for smooth / stepped toggle) - `6C`: Switch to the other ramp style. (when `3C` is mapped to next channel) - `3H`: Momentary turbo (when current channel has no tint to ramp). - - `3H`: [Tint ramping](#channel-modes-aka-tint-ramping-or-multi-channel-controls) (only when current channel has adjustable tint). + - `3H`: [Tint ramping](#channel-modes) + (only when current channel has adjustable tint). - `4H`: Momentary turbo, when `3H` is mapped to tint. - `4C`: Go to [lockout mode](#lockout-mode). - `5C`: Go to [momentary mode](#momentary-mode). - `5H`: Start a [sunset timer](#sunset-timer). + - `7H`: [Ramp config menu](#ramp-config-menu). - Item 1: Floor level. - Item 2: Ceiling level. @@ -265,7 +270,7 @@ While the light is on, a few actions are available: - `10C`: Activate manual memory and save the current brightness. Also saves current channel mode, on multi-channel lights. - - `10H`: Ramp extras config menu. + - `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) - Item 2: Configure the manual memory timer. @@ -388,7 +393,8 @@ lockout mode has two levels: (or the manual mem level, if there is one) - `3H`: Next channel mode (if more than one is enabled). - + + It is also possible to make the light lock itself automatically after being turned off. To enable this, go to lockout mode and use a `10H` action to activate the auto-lock config menu. Release the button after @@ -403,6 +409,7 @@ On lights which have aux LEDs, there may be additional functions: - `7C` / `7H`: Change Lockout Mode's [aux LED pattern](#aux-leds--button-leds). + Blinky / Utility Modes ---------------------- @@ -821,7 +828,7 @@ several formats: If the version doesn't include a model number, you may be able to find the model in the PRODUCTS file to see which firmware model it probably uses: - https://github.com/ToyKeeper/anduril/blob/trunk/MODELS + https://toykeeper.net/torches/PRODUCTS Protection Features @@ -931,6 +938,7 @@ lights. The number of settings in the Misc Config Menu depends on the hardware model and the firmware version. + Channel Modes (a.k.a. Tint Ramping or Multi Channel controls) ------------------------------------------------------------- @@ -979,9 +987,9 @@ smooth or stepped brightness ramp. Additionally, when a channel mode has nothing to adjust with `3H`, the `3H` action also reverts to its single-channel behavior -- momentary turbo. -The [Misc Config Menu](#misc-config-menu) (`Off -> 9H`) may also have a setting to choose a -tint ramp style. There are a few styles available, by entering -different numbers into that config menu: +The [Misc Config Menu](#misc-config-menu) (`Off -> 9H`) may also have +a setting to choose a tint ramp style. There are a few styles +available, by entering different numbers into that config menu: 0: smooth ramp 1: middle tint only -- cgit v1.2.3