anduril manual: added info about manual memory, 2-level lockout, and aux LED colors

2 files changed, 33 insertions, 4 deletions

diff --git a/spaghetti-monster/anduril/anduril-manual.txt b/spaghetti-monster/anduril/anduril-manual.txt
index 3684b50..3f17f41 100644
--- a/spaghetti-monster/anduril/anduril-manual.txt
+++ b/spaghetti-monster/anduril/anduril-manual.txt
@@ -56,6 +56,13 @@ While the light is on, a few basic actions are available:
   - Click, hold: Change brightness (down).
   - 3 clicks: Switch to the other ramp.
   - 4 clicks: Go to ramp config mode.
+  - 5 clicks: Activate manual memory and save the current brightness.
+  - 5 clicks, but hold the last click: Go back to automatic memory.
+
+The "automatic" vs "manual" memory modes change the level the light goes 
+to with 1 click from off.  In automatic mode, it uses the last 
+brightness the user ramped to.  In manual mode, it uses the brightness 
+the user explicitly saved with 5 clicks.
 
 
 Other Modes
@@ -215,7 +222,10 @@ then return to the regular "off" mode.
 
 Lockout mode also doubles as a momentary moon mode, so the user can do 
 quick tasks without having to unlock the light.  The brightness in 
-lockout mode is determined by the floor setting of the current ramp.
+lockout mode has two levels:
+
+  - Hold: light up at the floor level of the current ramp.
+  - Click, Hold: light up at the floor level of the other ramp.
 
 
 Momentary Mode
@@ -364,6 +374,13 @@ click the button a few times:
 This should change the aux LEDs to the next mode supported on this 
 light.
 
+If the aux LEDs can change color, there are additional actions to change 
+the color.  It is the same as above, but hold the button on the last 
+click and then let go when the desired color is reached.
+
+  - Off mode: 7 clicks, but hold the last click.
+  - Lockout mode: 3 clicks, but hold the last click.
+
 For lights with a button LED, the button LED typically stays on while 
 the main emitters are on.  Its brightness level is set in a way which 
 mirrors the main LED -- off, low, or high.
diff --git a/spaghetti-monster/anduril/anduril.txt b/spaghetti-monster/anduril/anduril.txt
index 3e0328c..db73cdb 100644
--- a/spaghetti-monster/anduril/anduril.txt
+++ b/spaghetti-monster/anduril/anduril.txt
@@ -20,6 +20,8 @@ From off:
   * On hardware with an indicator LED...
     * 7 clicks: Change aux LED mode used in "off" mode.
                 (the modes are usually off/low/high/blinking)
+    * 7 clicks (but hold the last click):
+        Change aux LED color used in "off" mode.
 
 In steady / ramping mode:
   * 1 click: off
@@ -28,6 +30,8 @@ In steady / ramping mode:
   * 2 clicks: to/from turbo (actual turbo, not just highest ramp level)
   * 3 clicks: toggle smooth vs discrete ramping
   * 4 clicks: configure current ramp
+  * 5 clicks: activate manual memory and save current brightness
+  * 5 clicks (but hold the last click): go back to automatic memory
 
 Smooth ramp config mode:
   * Setting 1: low end
@@ -104,14 +108,18 @@ Discrete ramp config mode:
         At buzz, click N times to set thermal limit to roughly 30 C + N.
 
 Lockout mode:
-  * Hold: momentary moon
+  * Hold: momentary moon (current ramp floor)
+  * Click, Hold: momentary moon (other ramp floor)
   * 4 clicks: exit lockout (return to regular "off" mode)
   * On hardware with an indicator LED...
     * 3 clicks: Change aux LED brightness used in lockout mode.
                 (the modes are usually off/low/high/blinking)
+    * 3 clicks (but hold the last click):
+        Change aux LED color used in lockout mode.
 
 Momentary mode:
-  * Press button: Light on (at memorized level).
+  * Press button: Light on (at memorized mode/level).
+    (uses either a steady mode or a strobe-group mode)
   * Release button: Light off.
   * To exit, disconnect power.  (loosen/tighten the tailcap)
 
@@ -148,6 +156,10 @@ Indicator LED / aux LED support:
     - High
     - Blinking
 
+  If the aux LEDs can change color, the user can configure the color 
+  using exactly the same method...  except hold the last click until the 
+  desired color is reached.
+
 
 TODO:
   * save settings in eeprom
@@ -167,7 +179,7 @@ TODO:
   * move all config menus to four clicks
   * candle mode timer, with three clicks to add 30 minutes
   * diagram updates for 3-click special actions
+  * add a toggle for memory (manual vs automatic memory)
   - candle mode: smoother adjustments?
   - make sunset mode timer and brightness configurable?
   - make beacon mode actually sleep between pulses
-  - add a toggle for memory?