converted anduril-manual.txt to markdown format

1 files changed, 595 insertions, 510 deletions

diff --git a/docs/anduril-manual.txt b/docs/anduril-manual.txt
index 545af0f..79b39c0 100644
--- a/docs/anduril-manual.txt
+++ b/docs/anduril-manual.txt
@@ -1,30 +1,34 @@
 Anduril User Manual
 -------------------
 
-Anduril is an open-source firmware for flashlights, distributed under 
+Anduril is an open-source firmware for flashlights, distributed under
 the terms of the GPL v3.  The sources can be obtained here:
 
-  http://tiny.cc/TKAnduril
-  https://bazaar.launchpad.net/~toykeeper/flashlight-firmware/trunk/files/head:/ToyKeeper/spaghetti-monster/anduril/
+  - https://toykeeper.net/anduril
+
+The URL above redirects to the actual project site.  Even if the project
+hosting needs to migrate again, it should continue to work.  As of late 2023,
+this is where it redirects to:
+
+  - https://github.com/ToyKeeper/anduril
 
 
 Quick Start
 -----------
 
-After putting a battery in the light and tightening the parts together, 
-the light should quickly blink once to confirm it has power and is now 
+After putting a battery in the light and tightening the parts together,
+the light should quickly blink once to confirm it has power and is now
 operational.  After that, basic usage is simple:
 
-  - Click to turn the light on or off.
-  - Hold the button to change brightness.
-  - Release and hold again to change brightness the other way.
+  - **Click** to turn the light on or off.
+  - **Hold** the button to change brightness.
+  - **Release and hold again** quickly to change brightness the other way.
 
-That is all the user needs to know for basic use, but there are many 
+That is all the user needs to know for basic use, but there are many
 more modes and features available for people who want more.
 
-Before reading the rest of this manual, it is recommended that users 
-look at the Anduril UI diagram(s), which should be provided along with the 
-flashlight.
+For a full list of button mappings, scroll down to the
+[UI Reference Table](#ui-reference-table) at the end of this file.
 
 
 Button presses
@@ -32,91 +36,134 @@ Button presses
 
 Button presses are abbreviated using a simple notation:
 
-  - 1C: One click.  Press and then quickly release the button.
-  - 1H: Hold.  Press the button, but keep holding it.
-  - 2C: Two clicks.  Press and release quickly, twice.
-  - 2H: Click, hold.  Click two times, but hold the second press.
-  - 3C: Three clicks.  Press and release quickly, three times.
-  - 3H: Click, click, hold.  Click three times, but hold the final press.
+  - `1C`: One click.  Press and then quickly release the button.
+  - `1H`: Hold.  Press the button, but keep holding it.
+  - `2C`: Two clicks.  Press and release quickly, twice.
+  - `2H`: Click, hold.  Click two times, but hold the second press.
+  - `3C`: Three clicks.  Press and release quickly, three times.
+  - `3H`: Click, click, hold.  Click three times, but hold the final press.
+
+The same pattern is used with higher numbers too.  For example, `10C`
+means ten clicks...  and `10H` means ten clicks but hold the final press.
+
+The *number* is how many times to press the button.  The *letter* tells
+whether to release the final press (C) or keep holding it (H).
+
+
+Factory Reset
+-------------
+
+If you get lost, or if you want to auto-calibrate the temperature sensor, do a
+factory reset.  This is a good idea to do as soon as you turn on a new light
+for the first time, to ensure it has a sane configuration.
+
+The process for this is:
+
+  - **Loosen** tailcap
+  - **Hold** button
+  - **Tighten** tailcap
+  - **Keep holding** button for about 4s
+
+Or:
+
+  - `13H` in "Off" mode, and keep holding for about 4s
+
+The light should flicker while getting brighter, then briefly burst to
+full power.  Hold until it reaches full power to do a reset, or let go
+of the button early to abort.
+
+On some lights, like products where the tailcap method is impossible,
+use `13H` from Off to do a factory reset.  If this is difficult, try
+counting it like music to make it easier:
+```
+  1 2 3 4
+  2 2 3 4
+  3 2 3 4
+  HOLD
+```
 
-The same pattern is used with higher numbers too.  For example, 10C 
-means ten clicks...  and 10H means ten clicks but hold the final press.
+Simple UI is enabled after each factory reset.
 
 
 Simple UI
 ---------
 
-By default, the light uses a simple UI.  This is useful if you lend the 
-light to someone else, or if you just don't want to bother with any 
+By default, the light uses a simple UI.  This is useful if you lend the
+light to someone else, or if you just don't want to bother with any
 crazy disco modes.
 
-Simple UI has all the basic functions needed to work as a flashlight, 
-but the minimum and maximum brightness are limited by default to make it 
+Simple UI has all the basic functions needed to work as a flashlight,
+but the minimum and maximum brightness are limited by default to make it
 safer, and any complex or advanced functions are blocked.
 
+### Usage
+
 Functions available in Simple UI include:
 
-  - 1C: On / off
-  - 1H: Ramp up (or down, if button was released less than a second ago)
-  - 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.
+  - `1C`: On / off
+  - `1H`: Ramp up (or down, if button was released less than a second ago)
+  - `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.
 
-Some other modes and functions are available too.  When the light is 
+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.  (displays voltage once, then turns off)
+  - `4C`: Lockout mode.
+  - `10H`: Switch to Advanced UI.
+  - `15C` or more: Version check.
 
 In Lockout mode with Simple UI, there are a few functions:
 
-  - 1H: Momentary moon
-  - 2H: Momentary low
-  - 3C: Unlock and turn off
-  - 4C: Unlock and turn on
-  - 4H: Unlock and turn on at low level
-  - 5C: Unlock and turn on at high level
+  - `1H`: Momentary moon
+  - `2H`: Momentary low
+  - `3C`: Unlock and turn off
+  - `4C`: Unlock and turn on
+  - `4H`: Unlock and turn on at low level
+  - `5C`: Unlock and turn on at high level
 
-To change between Simple UI and Advanced UI, turn the light off and then 
+To change between Simple UI and Advanced UI, turn the light off and then
 do one of these:
 
   In Simple UI:
-    - 10H: Go to Advanced UI.
+
+  - `10H`: Go to Advanced UI.
 
   In Advanced UI:
-    - 10C: Go to Simple UI.
-    - 10H: Configure Simple UI.
 
-If you get lost, or if you want to auto-calibrate the temperature 
-sensor, do a factory reset.  The process for this is:
+  - `10C`: Go to Simple UI.
 
-  - Loosen tailcap
-  - Hold button
-  - Tighten tailcap
-  - Keep holding button for about 4s
+### Extended Simple UI
 
-The light should flicker while getting brighter, then briefly burst to 
-full power.  Hold until it reaches full power to do a reset, or let go 
-of the button early to abort.
+Some lights have additional features enabled in Simple UI, at the
+manufacturer's request.  This typically includes:
 
-On some lights, like products where the tailcap method is impossible, 
-use 13H from Off to do a factory reset.  If this is difficult, try 
-counting it like music to make it easier:
+  - `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.
 
-  1 2 3 4
-  1 2 3 4
-  1 2 3 4
-  HOLD
+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.
 
-Simple UI is enabled after each factory reset.
+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.
 
-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 
+### Configuring Simple UI
+
+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:
+
+  - `10H`: Configure Simple UI.
+
 Configurable options include:
 
   - floor level
@@ -124,7 +171,8 @@ Configurable options include:
   - number of steps (in stepped ramp)
   - turbo style
 
-Other options are inherited from Advanced UI:
+Other options are inherited from Advanced UI, so change these options normally
+and they will carry over to Simple UI:
 
   - ramp style (smooth / stepped)
   - smooth ramp speed
@@ -140,107 +188,107 @@ Other options are inherited from Advanced UI:
 Advanced UI
 -----------
 
-Most of the information below this is for the Advanced UI.  Anything not 
+Most of the information below this is for the Advanced UI.  Anything not
 already noted above is blocked in the Simple UI.
 
 
 Ramping / Stepped Ramping Modes
 -------------------------------
 
-Anduril's ramping mode uses a smooth ramp or a stepped ramp, depending 
+Anduril's ramping mode uses a smooth ramp or a stepped ramp, depending
 on which style the user prefers.
 
-Each ramp has its own settings -- floor (lowest level), ceiling (highest 
-level), and the stepped ramp can also have a configurable number of 
+Each ramp has its own settings -- floor (lowest level), ceiling (highest
+level), and the stepped ramp can also have a configurable number of
 steps.
 
-Additionally, Simple UI has its own ramp settings for floor, ceiling, 
-and number of steps.  The smooth/stepped style is inherited from the 
+Additionally, Simple UI has its own ramp settings for floor, ceiling,
+and number of steps.  The smooth/stepped style is inherited from the
 Advanced UI's ramp.
 
 There are four ways to access ramping mode when the light is off:
 
-  - 1C: Turn on at the memorized brightness.
+  - `1C`: Turn on at the memorized brightness.
     (see below for details about what "memorized" means)
 
-  - 1H: Turn on at the floor level.  Let go after the light turns on to 
+  - `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.
 
-  - 2C: Turn on at the ceiling level.
+  - `2C`: Turn on at the ceiling level.
 
-  - 2H: Turn on at full power, turn off when released.  (momentary 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:
 
-  - 1C: Turn off.
-  - 2C: Go to or from the turbo level.
-        (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.
-  - 2H: Change brightness (down).
+  - `1C`: Turn off.
+  - `2C`: Go to or from the turbo level.  
+          (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.
+  - `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)
-        (then use 6C instead, for smooth / stepped toggle)
-  - 6C: Switch to the other ramp style.  (when 3C is mapped to next channel)
+  - `3C`: Switch to the other ramp style.  (smooth / stepped)  
+          (or activate the next channel mode, 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).
-  - 4H: Momentary turbo, when 3H is mapped to tint.
+  - `3H`: Momentary turbo (when current channel has no tint to ramp).
+  - `3H`: Tint ramping (only when current channel has adjustable tint).
+  - `4H`: Momentary turbo, when `3H` is mapped to tint.
 
-  - 4C: Go to lockout mode.
+  - `4C`: Go to lockout mode.
 
-  - 5C: Go to momentary mode.
-  - 5H: Start a sunset timer.  Details are below in the Sunset Timer section.
+  - `5C`: Go to momentary mode.
+  - `5H`: Start a sunset timer.  Details are below in the Sunset Timer section.
 
-  - 7H: Ramp config menu.
+  - `7H`: Ramp config menu.
     - Item 1: Floor level.
     - Item 2: Ceiling level.
-    - Item 3:
-      Stepped ramp: Number of steps.  Can be 1 to 150.
-      Smooth ramp: Ramp speed.
-        1 = Full speed, ~2.5s from end to end.
-        2 = Half speed, ~5s from end to end.
-        3 = Third speed, ~7.5s.
+    - Item 3:  
+      Stepped ramp: Number of steps.  Can be 1 to 150.  
+      Smooth ramp: Ramp speed.  
+        1 = Full speed, ~2.5s from end to end.  
+        2 = Half speed, ~5s from end to end.  
+        3 = Third speed, ~7.5s.  
         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.
+  - `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)
-    - Item 2: Configure the manual memory timer.
-              Sets the timer to N minutes, where N is the number of 
+    - Item 2: Configure the manual memory timer.  
+              Sets the timer to N minutes, where N is the number of
               clicks.  A value of 0 (no clicks) turns the timer off.
-    - Item 3: Configure whether to ramp up after "Off -> 1H".
-              0: Ramp up after moon.
+    - Item 3: Configure whether to ramp up after `Off -> 1H`.  
+              0: Ramp up after moon.  
               1: Don't ramp up, just stay at the floor level.
-    - Item 4: Configure Advanced UI's turbo style:
-              0: No turbo, only ceiling.
-              1: Anduril 1 style.  Ramp -> 2C goes to full power.
-              2: Anduril 2 style.  Ramp -> 2C goes to ceiling,
+    - Item 4: Configure Advanced UI's turbo style:  
+              0: No turbo, only ceiling.  
+              1: Anduril 1 style.  `Ramp -> 2C` goes to full power.  
+              2: Anduril 2 style.  `Ramp -> 2C` goes to ceiling,
                  or goes to full power if user ramped up to ceiling first.
               This value also affects momentary turbo in Ramp and Off modes.
-    - Item 5: Configure "smooth steps".
-              0: Disable smooth steps.
+    - Item 5: Configure "smooth steps".  
+              0: Disable smooth steps.  
               1: Enable smooth steps.
 
-Memory determines which brightness level the light goes to with 1 click 
+Memory determines which brightness level the light goes to with 1 click
 from off.  There are three types of brightness memory to choose from:
 
   - Automatic:  Always uses the last-ramped brightness.
     (does not memorize levels accessed by a shortcut,
-    like turbo, 2C for ceiling, or 1H-from-off for floor)
+    like turbo, `2C` for ceiling, or `1H-from-off` for floor)
 
   - Manual:  Always uses the user's saved brightness.
 
-  - Hybrid:  Uses the automatic memory brightness if the light was only 
-    off for a short time, or resets to the manual memory level if it was 
+  - Hybrid:  Uses the automatic memory brightness if the light was only
+    off for a short time, or resets to the manual memory level if it was
     off for a longer time.
     The timer for this is configurable from 0 to ~140 minutes.
 
-Another way to think of it is:  There are three styles of memory for the 
+Another way to think of it is:  There are three styles of memory for the
 last-ramped brightness level...
 
   - Always remember         (automatic)
@@ -249,109 +297,109 @@ last-ramped brightness level...
 
 To choose a memory style, set the configuration accordingly:
 
-  mem type	manual mem	manual mem timer
-  --------	----------	----------------
-  automatic	off		any
-  manual	on		zero
-  hybrid	on		non-zero
+| mem type    | manual mem  | manual mem timer
+| --------    | ----------  | ----------------
+| automatic   | off         | any
+| manual      | on          | zero
+| hybrid      | on          | non-zero
 
-If "smooth steps" is enabled, the stepped ramp uses a smooth animation 
-between steps, and turning the light on/off has the edges smoothed off 
-too.  With "smooth steps" turned off, these brightness changes are 
+If "smooth steps" is enabled, the stepped ramp uses a smooth animation
+between steps, and turning the light on/off has the edges smoothed off
+too.  With "smooth steps" turned off, these brightness changes are
 immediate.
 
 
 Sunset Timer
 ------------
 
-In the ramp mode or candle mode, it's possible to make the light turn 
+In the ramp mode or candle mode, it's possible to make the light turn
 itself off after a while.
 
-To activate the timer, go to the brightness you want and then use a 5H 
-action.  Keep holding the button, and the light should blink once per 
+To activate the timer, go to the brightness you want and then use a `5H`
+action.  Keep holding the button, and the light should blink once per
 second.  Each blink adds 5 minutes to the timer.
 
-In ramp mode, it slowly dims until it's at the lowest level, then shuts 
-off.  In candle mode, it stays at the same brightness until the final 
+In ramp mode, it slowly dims until it's at the lowest level, then shuts
+off.  In candle mode, it stays at the same brightness until the final
 minute, at which point it dims and dies out.
 
-The user can change the brightness while the timer is active.  If this 
-happens during the final few minutes, it also "bumps" the timer up to a 
-minimum of 3 minutes.  So if it's getting really dim and you need a 
-little more time, you could do a 5H to add 5 minutes, or simply ramp up 
+The user can change the brightness while the timer is active.  If this
+happens during the final few minutes, it also "bumps" the timer up to a
+minimum of 3 minutes.  So if it's getting really dim and you need a
+little more time, you could do a `5H` to add 5 minutes, or simply ramp up
 to the desired brightness.
 
 
 Other Modes
 -----------
 
-Anduril has several other modes too.  To access these, press the button 
+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, 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.
 
 
 Lockout Mode
 ------------
 
-Click 4 times from Off to enter Lockout mode.  Or 4 times from Ramp.  
-This makes the light safe to carry in a pocket or a bag or anywhere else 
+Click 4 times from Off to enter Lockout mode.  Or 4 times from Ramp.
+This makes the light safe to carry in a pocket or a bag or anywhere else
 the button might be pressed by accident.
 
-To exit lockout mode, click 4 times.  The light should blink briefly and 
-then turn on at the memorized level.  Or hold the final press to turn on 
+To exit lockout mode, click 4 times.  The light should blink briefly and
+then turn on at the memorized level.  Or hold the final press to turn on
 at the floor level instead:
 
-  - 3C: Unlock and go to "Off" mode
+  - `3C`: Unlock and go to "Off" mode
 
-  - 4C: Go to ramp mode (memorized level).
-    (uses manual mem level if there is one)
+  - `4C`: Go to ramp mode (memorized level).  
+          (uses manual mem level if there is one)
 
-  - 4H: Go to ramp mode (floor level).
+  - `4H`: Go to ramp mode (floor level).
 
-  - 5C: Go to ramp mode (ceiling level).
+  - `5C`: Go to ramp mode (ceiling level).
 
-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 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 has two levels:
 
-  - 1H: Light up at the lowest floor level.
+  - `1H`: Light up at the lowest floor level.
 
-  - 2H: Light up at the highest floor level.
-        (or the manual mem level, if there is one)
+  - `2H`: Light up at the highest floor level.
+          (or the manual mem level, if there is one)
 
-  - 3H: Next channel mode (if more than one is enabled).
+  - `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 
-the first blink.  Then at the prompt, click N times to set the auto-lock 
+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
+the first blink.  Then at the prompt, click N times to set the auto-lock
 timeout to N minutes.
 
-  - 10H: Auto-lock config menu.  Click N times to set timeout to N minutes.
-         A value of zero disables the auto-lock feature.
-         So, to turn off auto-lock, don't click at all.
+  - `10H`: Auto-lock config menu.  Click N times to set 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 
+  - `7C` / `7H`: Change Lockout Mode's aux LED pattern.  More details on
     this below, in a separate section.
 
 
 Blinky / Utility Modes
 ----------------------
 
-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 
+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.
@@ -366,93 +414,93 @@ In all of these modes, some basic actions are available:
 
 Additionally, in battery check and temperature check modes:
 
-  - 7H: Go to the voltage config menu or thermal config menu.
+  - `7H`: Go to the voltage config menu or thermal config menu.
 
 In more detail, this is what each blinky / utility mode does:
 
-  Battery check:
+### 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.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".
 
-    A "zero" digit is represented by a very quick blink.
+A "zero" digit is represented by a very quick blink.
 
-    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.
+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.
 
-    The voltage config menu has these settings:
+The voltage config menu has these settings:
 
-      1. Voltage correction factor.  This adjusts the battery 
-         measurement sensor, allowing the user to add or subtract up to 
-         0.30V in 0.05V steps.  Click N times to enter a value:
+  1. Voltage correction factor.  This adjusts the battery
+     measurement sensor, allowing the user to add or subtract up to
+     0.30V in 0.05V steps.  Click N times to enter a value:
 
-         1C: -0.30V
-         2C: -0.25V
-         3C: -0.20V
-         4C: -0.15V
-         5C: -0.10V
-         6C: -0.05V
-         7C: default, 0V
-         8C: +0.05V
-         9C: +0.10V
-         10C: +0.15V
-         11C: +0.20V
-         12C: +0.25V
-         13C: +0.30V
+     `1C`: -0.30V  
+     `2C`: -0.25V  
+     `3C`: -0.20V  
+     `4C`: -0.15V  
+     `5C`: -0.10V  
+     `6C`: -0.05V  
+     `7C`: default, 0V  
+     `8C`: +0.05V  
+     `9C`: +0.10V  
+     `10C`: +0.15V  
+     `11C`: +0.20V  
+     `12C`: +0.25V  
+     `13C`: +0.30V
 
-      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.
+  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.
 
-  Temperature check:
+### Temperature check:
 
-    Blinks out the current temperature in degrees C.  This number should 
-    be pretty close to what a real thermometer says.  If not, it would 
-    be a good idea to enter the thermal config menu and calibrate the 
-    sensor.  Or let the light settle to room temperature, then use 
-    factory reset to auto-calibrate the sensor.
+Blinks out the current temperature in degrees C.  This number should
+be pretty close to what a real thermometer says.  If not, it would
+be a good idea to enter the thermal config menu and calibrate the
+sensor.  Or let the light settle to room temperature, then use
+factory reset to auto-calibrate the sensor.
 
-    The thermal config menu has two settings:
+The thermal config menu has two settings:
 
-    - Current temperature.  Click once per degree C to calibrate the 
-      sensor.  For example, if the ambient temperature is 21 C, then 
-      click 21 times.
+  - Current temperature.  Click once per degree C to calibrate the
+    sensor.  For example, if the ambient temperature is 21 C, then
+    click 21 times.
 
-    - Temperature limit.  This sets the maximum temperature the light 
-      can reach before it will start doing thermal regulation to keep 
-      itself from overheating.  Click once per degree C above 30.  For 
-      example, to set the limit to 50 C, click 20 times.  The default is 
-      45 C, and the highest value it will allow is 70 C.
+  - Temperature limit.  This sets the maximum temperature the light
+    can reach before it will start doing thermal regulation to keep
+    itself from overheating.  Click once per degree C above 30.  For
+    example, to set the limit to 50 C, click 20 times.  The default is
+    45 C, and the highest value it will allow is 70 C.
 
-  Beacon mode:
+### Beacon mode:
 
-    Blinks at a slow speed.  The light stays on for 100ms, and then 
-    stays off until the next blink.  The brightness and the number of 
-    seconds between pulses are configurable:
+Blinks at a slow speed.  The light stays on for 100ms, and then
+stays off until the next blink.  The brightness and the number of
+seconds between pulses are configurable:
 
-      - Brightness is the user's memorized ramp level, so set this in 
-        ramping mode before activating beacon mode.  Follows the same 
-        memory rules as ramping -- automatic, manual, or hybrid.
+  - Brightness is the user's memorized ramp level, so set this in
+    ramping mode before activating beacon mode.  Follows the same
+    memory rules as ramping -- automatic, manual, or hybrid.
 
-      - Speed is configured by holding the button.  The light should 
-        blink once per second while holding the button.  Release it 
-        after the desired amount of time has passed, to set a new beacon 
-        speed.
-        For example, to do a 10-second alpine beacon, hold the button 
-        for 10 seconds.
+  - Speed is configured by holding the button.  The light should
+    blink once per second while holding the button.  Release it
+    after the desired amount of time has passed, to set a new beacon
+    speed.  
+    For example, to do a 10-second alpine beacon, hold the button
+    for 10 seconds.
 
-  SOS mode:
+### SOS mode:
 
-    Blinks out a distress signal.  Three short, three long, three short.  
-    Repeats until light is turned off or until battery is low.
+Blinks out a distress signal.  Three short, three long, three short.
+Repeats until light is turned off or until battery is low.
 
-    The memorized ramp level determines the brightness of SOS Mode.
+The memorized ramp level determines the brightness of SOS Mode.
 
 
 Strobe / Mood Modes
@@ -466,147 +514,147 @@ Anduril includes a few extra modes for a variety of purposes:
   - Tactical strobe
   - Lightning storm mode
 
-Click 3 times from Off to access these, but hold the third click for a 
-moment.  Click, click, hold.  The last-used strobe mode is remembered, 
+Click 3 times from Off to access these, but hold the third click for a
+moment.  Click, click, hold.  The last-used strobe mode is remembered,
 so it will return to whichever one you used last.
 
 In all of these modes, a few actions are available:
 
-  - 1C: Turn off.
-  - 2C: Next strobe / mood mode.
-  - 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.
-        (this is useful for light painting)
+  - `1C`: Turn off.
+  - `2C`: Next strobe / mood mode.
+  - `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.
+          (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, and/or add 5 minutes to the timer.
 
 In more detail, here is what each mode does:
 
   - Candle mode
 
-    Brightness changes randomly in a pattern resembling a candle flame.  
-    If a timer is set, it will run until the timer expires, then get 
-    dimmer for one minute, then sputter and turn itself off.  Without a 
-    timer, candle mode runs until the user turns it off.  Brightness is 
+    Brightness changes randomly in a pattern resembling a candle flame.
+    If a timer is set, it will run until the timer expires, then get
+    dimmer for one minute, then sputter and turn itself off.  Without a
+    timer, candle mode runs until the user turns it off.  Brightness is
     configurable.
 
   - Bike flasher
 
-    Runs at a medium level, but stutters to a brighter level once per 
-    second.  Designed to be more visible than a normal ramping mode, but 
+    Runs at a medium level, but stutters to a brighter level once per
+    second.  Designed to be more visible than a normal ramping mode, but
     otherwise works mostly the same.  Brightness is configurable.
 
   - Party strobe
 
-    Motion-freezing strobe light.  Can be used to freeze spinning fans 
+    Motion-freezing strobe light.  Can be used to freeze spinning fans
     and falling water.  Speed is configurable.
 
   - Tactical strobe
 
-    Disorienting strobe light.  Can be used to irritate people.  Speed 
+    Disorienting strobe light.  Can be used to irritate people.  Speed
     is configurable, and the duty cycle is always 33%.
 
     Be careful about heat in this mode, if using it for a long time.
 
   - Police strobe (on some lights)
 
-    2-color police style strobe.  Only works on lights with 2 or more 
+    2-color police style strobe.  Only works on lights with 2 or more
     colors.
 
   - Lightning storm mode
 
-    Flashes at random brightness and random speed to simulate lightning 
-    strikes during a busy lightning storm.  Do not look directly at the 
-    flashlight when this mode is running, because it may suddenly go to 
+    Flashes at random brightness and random speed to simulate lightning
+    strikes during a busy lightning storm.  Do not look directly at the
+    flashlight when this mode is running, because it may suddenly go to
     full power without warning.
 
 
 Momentary Mode
 --------------
 
-Click 5 times from Off to enter Momentary mode.  Or 5 times from Ramp, 
+Click 5 times from Off to enter Momentary mode.  Or 5 times from Ramp,
 or 5 times from a strobe mode.
 
-This locks the flashlight into a single-mode interface where the LEDs 
-are only on when the button is held down.  It is intended for Morse 
-code, light painting, and other tasks where the light should be on only 
+This locks the flashlight into a single-mode interface where the LEDs
+are only on when the button is held down.  It is intended for Morse
+code, light painting, and other tasks where the light should be on only
 for a short time and probably in a pattern.
 
-Momentary mode does either a steady brightness level or a strobe, 
-depending on which was active before going to momentary mode.  To select 
-which one, go to the mode you want to use, adjust the brightness and 
+Momentary mode does either a steady brightness level or a strobe,
+depending on which was active before going to momentary mode.  To select
+which one, go to the mode you want to use, adjust the brightness and
 speed and other settings, then click 5 times to enter momentary mode.
 
-In steady mode, brightness is the memorized ramp level, so adjust that 
+In steady mode, brightness is the memorized ramp level, so adjust that
 in Ramp Mode before entering momentary mode.
 
-In momentary strobe mode, the settings are copied from the last-used 
+In momentary strobe mode, the settings are copied from the last-used
 strobe mode, such as party strobe, tactical strobe, or lightning.
 
-To exit this mode, physically disconnect power by unscrewing the tailcap 
+To exit this mode, physically disconnect power by unscrewing the tailcap
 or battery tube.
 
 
 Tactical Mode
 --------------
 
-Click 6 times from Off to enter Tactical Mode, or 6 times in Tactical 
+Click 6 times from Off to enter Tactical Mode, or 6 times in Tactical
 Mode to exit and go back to "Off".
 
-Tactical Mode provides instant momentary access to high, low, and 
+Tactical Mode provides instant momentary access to high, low, and
 strobe, but each of these is configurable.  The inputs are:
 
-  - 1H: High
-  - 2H: Low
-  - 3H: Strobe
+  - `1H`: High
+  - `2H`: Low
+  - `3H`: Strobe
 
 Each of these only lasts as long as you hold the button.
 
 Other commands in Tactical Mode are:
 
-  - 6C: exit (go back to Off Mode)
-  - 7H: Tactical Mode config menu
+  - `6C`: exit (go back to Off Mode)
+  - `7H`: Tactical Mode config menu
     - 1st blink: configure tactical slot 1
     - 2nd blink: configure tactical slot 2
     - 3rd blink: configure tactical slot 3
 
-To change what is in a tactical slot, press 7H, then release the button 
-after the 1st, 2nd, or 3rd blink.  Then enter a number.  Each click adds 
+To change what is in a tactical slot, press `7H`, then release the button
+after the 1st, 2nd, or 3rd blink.  Then enter a number.  Each click adds
 1, and each hold adds 10.  The number can be:
 
   - 1 to 150: set the brightness level
   - 0: last-used strobe mode
-  - 151+: go directly to a specific strobe mode
-    151 = party strobe
-    152 = tactical strobe
-    153+ = other strobes, in the same order they're in in the "Off -> 3H"
+  - 151+: go directly to a specific strobe mode  
+    151 = party strobe  
+    152 = tactical strobe  
+    153+ = other strobes, in the same order they're in in the `Off -> 3H`
            strobe group
 
-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 
+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.
 
 
 Configuration Menus
 -------------------
 
-Every config menu has the same interface.  It has one or more options 
-the user can configure, and it will go through them in order.  For each 
+Every config menu has the same interface.  It has one or more options
+the user can configure, and it will go through them in order.  For each
 menu item, the light follows the same pattern:
 
-  - Blink once, then go to a lower brightness.  The user can keep 
-    holding the button to skip this menu item, or release the button to 
+  - Blink once, then go to a lower brightness.  The user can keep
+    holding the button to skip this menu item, or release the button to
     dive in and enter a new value.
 
   - If the user released the button:
 
-    - Stutter or "buzz" quickly between two brightness levels for a few 
-      seconds.  This indicates that the user can click one or more times 
-      to enter a number.  It will keep buzzing until the user stops 
+    - Stutter or "buzz" quickly between two brightness levels for a few
+      seconds.  This indicates that the user can click one or more times
+      to enter a number.  It will keep buzzing until the user stops
       clicking, so there is no need to hurry.
 
       The actions here are:
@@ -614,19 +662,19 @@ menu item, the light follows the same pattern:
       - hold: add 10  (only in versions 2021-09 or later)
       - wait: exit
 
-After entering a number, or after skipping every menu item, it waits 
-until the button is released then exits the menu.  It should return to 
+After entering a number, or after skipping every menu item, it waits
+until the button is released then exits the menu.  It should return to
 whatever mode the light was in before entering the config menu.
 
 
 Ramp Config Menu
 ----------------
 
-While the light is on in a ramping mode, click 7 times (but hold the 
+While the light is on in a ramping mode, click 7 times (but hold the
 final click) to access the config menu for the current ramp.
 
-Or, to access the ramp config for Simple UI, make sure the Simple UI is 
-not active, then do a 10H action from Off.
+Or, to access the ramp config for Simple UI, make sure the Simple UI is
+not active, then do a `10H` action from Off.
 
 For smooth ramping mode, there are three menu options:
 
@@ -640,7 +688,7 @@ For the stepped ramping mode, there are three menu options:
   2. Ceiling.  (default = 120/150)
   3. Number of steps.  (default = 7)
 
-For the Simple UI mode, there are four menu options.  The first three 
+For the Simple UI mode, there are four menu options.  The first three
 are the same as stepped ramping mode.
 
   1. Floor.  (default = 20/150)
@@ -648,46 +696,46 @@ are the same as stepped ramping mode.
   3. Number of steps.  (default = 5)
   4. Turbo style.  (default = 0, no turbo)
 
-Default values are different for each model of flashlight.  The numbers 
-above are only examples.
+**Default values are different for each model of flashlight.  The numbers
+above are only examples.**
 
-To configure the floor level, click the button equal to the number of 
-ramp levels (out of 150) at which the floor should be.  To set the 
+To configure the floor level, click the button equal to the number of
+ramp levels (out of 150) at which the floor should be.  To set the
 lowest possible level, click once.
 
-To configure the ceiling level, each click goes one level lower.  So 1 
-click sets the highest possible level, 2 clicks is the 2nd-highest, 3 
-clicks is the 3rd-highest level, etc.  To set the default of 120/150, 
+To configure the ceiling level, each click goes one level lower.  So 1
+click sets the highest possible level, 2 clicks is the 2nd-highest, 3
+clicks is the 3rd-highest level, etc.  To set the default of 120/150,
 click 31 times.
 
-When configuring the number of steps, the value can be anything from 1 
-to 150.  A value of 1 is a special case.  It places the step halfway 
+When configuring the number of steps, the value can be anything from 1
+to 150.  A value of 1 is a special case.  It places the step halfway
 between the floor and ceiling levels.
 
 
 Version Check Mode
 ------------------
 
-This allows people to see which version of the firmware is installed on 
-their light.  The format for this is (usually) 12 digits -- a model 
-number and a date.  BBPP.YYYY-MM-DD
+This allows people to see which version of the firmware is installed on
+their light.  The format for this is (usually) 12 digits -- a model
+number and a date.  `BBPP.YYYY-MM-DD`
 
-  - BB: Brand ID
-  - PP: Product ID
-  - YYYY: Year
-  - MM: Month
-  - DD: Day
+  - `BB`: Brand ID
+  - `PP`: Product ID
+  - `YYYY`: Year
+  - `MM`: Month
+  - `DD`: Day
 
-Versions before 2023-05-30 used YYYYMMDDBBPP format.
-Anduril 1 used only YYYYMMDD format, or none at all.
+Versions before 2023-05-30 used `YYYYMMDDBBPP` format.
+Anduril 1 used only `YYYYMMDD` format, or none at all.
 
-The date is when the firmware was compiled.  If the vendor did not set 
-this value, it defaults to 1969-07-20, the date of first human contact 
-with the moon.  However, it might not be a date at all; some vendors may 
+The date is when the firmware was compiled.  If the vendor did not set
+this value, it defaults to 1969-07-20, the date of first human contact
+with the moon.  However, it might not be a date at all; some vendors may
 specify a completely different type of value here.
 
-The brand/product values are also known as the model number.  These are 
-hard-coded in the source code for each light's build target, and can be 
+The brand/product values are also known as the model number.  These are
+hard-coded in the source code for each light's build target, and can be
 looked up in the "MODELS" file or by using the "make models" command.
 
 
@@ -696,24 +744,24 @@ Protection Features
 
 Anduril includes low voltage protection (LVP) and thermal regulation.
 
-LVP makes the light step down to a lower level when the battery is low, 
-and if the light is already at the lowest level, it shuts itself off.  
-This activates at 2.8V.  LVP adjustments happen suddenly, in large 
+LVP makes the light step down to a lower level when the battery is low,
+and if the light is already at the lowest level, it shuts itself off.
+This activates at 2.8V.  LVP adjustments happen suddenly, in large
 steps.
 
-Thermal regulation attempts to keep the light from overheating, and 
-otherwise adjusts output to stay as close as possible to the 
-user-configured temperature limit.  Thermal adjustments happen 
+Thermal regulation attempts to keep the light from overheating, and
+otherwise adjusts output to stay as close as possible to the
+user-configured temperature limit.  Thermal adjustments happen
 gradually, in steps so small they are difficult for humans to perceive.
 
 
 Aux LEDs / Button LEDs
 ----------------------
 
-Some lights have aux LEDs or button LEDs.  These can be configured to do 
-different things while the main emitters are off.  There is one aux LED 
-mode for the regular "off" mode, and another aux LED mode for "lockout" 
-mode.  This allows the user to see at a glance whether the light is 
+Some lights have aux LEDs or button LEDs.  These can be configured to do
+different things while the main emitters are off.  There is one aux LED
+mode for the regular "off" mode, and another aux LED mode for "lockout"
+mode.  This allows the user to see at a glance whether the light is
 locked.
 
 Aux LED modes typically include:
@@ -723,17 +771,17 @@ Aux LED modes typically include:
   - High
   - Blinking
 
-To configure the aux LEDs, go to the mode you want to configure and then 
-click the button 7 times.  This should change the aux LEDs to the next 
+To configure the aux LEDs, go to the mode you want to configure and then
+click the button 7 times.  This should change the aux LEDs to the next
 mode supported on this light.
 
-  - 7C: Next aux LED mode.
+  - `7C`: Next aux LED mode.
 
-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 
+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.
 
-  - 7H: Next aux LED color.
+  - `7H`: Next aux LED color.
 
 On most lights, the colors follow this sequence:
 
@@ -748,113 +796,113 @@ On most lights, the colors follow this sequence:
   - Rainbow (cycles through all colors in order)
   - Voltage (uses color to display battery charge)
 
-In voltage mode, the colors follow the same sequence, in the same order 
-as a rainbow...  with red indicating a low battery and purple indicating 
+In voltage mode, the colors follow the same sequence, in the same order
+as a rainbow...  with red indicating a low battery and purple indicating
 a full battery.
 
-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 
+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.
 
-For lights with a RGB button LED, the button LED indicates battery 
+For lights with a RGB button LED, the button LED indicates battery
 charge during use in the same manner as the aux LED voltage mode.
 
-For lights with front-facing aux LEDs, the aux LEDs typically stay off 
-when the main emitters are on, and when the light is otherwise awake.  
+For lights with front-facing aux LEDs, the aux LEDs typically stay off
+when the main emitters are on, and when the light is otherwise awake.
 The aux LEDs on most lights only turn on when the light is asleep.
 
-When a light has a single-color aux LED and no RGB, it fast-blinks the 
+When a light has a single-color aux LED and no RGB, it fast-blinks the
 aux LED in "off" modes when voltage is low.
 
 
 Misc Config Menu
 ----------------
 
-Some models may have an extra config menu for settings which don't fit 
+Some models may have an extra config menu for settings which don't fit
 anywhere else.  This menu is located at "Off -> 9H" in the advanced UI.
 
 These settings are, in order:
 
   - Tint ramp style:  (on some lights)
 
-    0 : smooth ramp (blend channels in any proportion)
-    1 : middle tint only
-    2 : extreme tints only (only one channel active at a time)
+    0 : smooth ramp (blend channels in any proportion)  
+    1 : middle tint only  
+    2 : extreme tints only (only one channel active at a time)  
     3+: stepped ramp with 3+ steps
 
   - Jump Start level:  (on some lights)
 
-    Some lights are prone to starting up slowly at low levels, so they 
-    have an option to "jump start" the engine by pulsing a higher power 
-    level for a few milliseconds when changing from off to a low level.  
+    Some lights are prone to starting up slowly at low levels, so they
+    have an option to "jump start" the engine by pulsing a higher power
+    level for a few milliseconds when changing from off to a low level.
     This setting specifies how bright that pulse should be.
 
     The value can be from 1 to 150, but is usually between 20 and 50.
 
-These settings are hardware-specific and may not be present on all 
-lights.  The number of settings in the Misc Config Menu depends on the 
+These settings are hardware-specific and may not be present on all
+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)
 -------------------------------------------------------------
 
-Some lights have more than one set of LEDs which can be adjusted to 
-change the beam color, shape, or other properties.  These lights have 
+Some lights have more than one set of LEDs which can be adjusted to
+change the beam color, shape, or other properties.  These lights have
 features like tint ramping and channel modes.
 
-On these models, there are some global button mappings which work at all 
+On these models, there are some global button mappings which work at all
 times unless they're overridden by the mode the light is in:
 
-  - 3C: Next channel mode
-  - 3H: Adjust current channel mode (ramp tint, for example)
-  - 9H: Channel mode config menu
+  - `3C`: Next channel mode
+  - `3H`: Adjust current channel mode (ramp tint, for example)
+  - `9H`: Channel mode config menu
 
-Details depend on the exact type of light used.  For example, if a light 
-has LEDs in cool white, warm white, and red... that light might have a 
+Details depend on the exact type of light used.  For example, if a light
+has LEDs in cool white, warm white, and red... that light might have a
 few channel modes:
 
   - White blend (adjustable CCT / tint ramping)
   - Red only
   - Auto-tint
 
-On a light like this, the user could press 3C to rotate through these 
-different channel modes...  white, then red, then auto, then back to 
+On a light like this, the user could press 3C to rotate through these
+different channel modes...  white, then red, then auto, then back to
 white.
 
-Additionally, in the "white blend" mode, the user could press 3H to 
+Additionally, in the "white blend" mode, the user could press 3H to
 manually adjust the balance between warm white and cool white.
 
-Finally, if the user decides they don't want all of the modes, they can 
-turn some off.  Press 9H (while on) to start the channel mode config 
-menu.  To disable the auto-tint mode, for example, it is the 3rd mode...  
-so wait for the 3rd blink, then release the button.  Then at the prompt, 
-enter a value of 0 (wait for the prompt to time out without clicking 
-anything).  Afterward, the auto tint mode should no longer be in the 
-channel mode rotation.  To turn the mode back on later, do the same 
+Finally, if the user decides they don't want all of the modes, they can
+turn some off.  Press `9H` (while on) to start the channel mode config
+menu.  To disable the auto-tint mode, for example, it is the 3rd mode...
+so wait for the 3rd blink, then release the button.  Then at the prompt,
+enter a value of 0 (wait for the prompt to time out without clicking
+anything).  Afterward, the auto tint mode should no longer be in the
+channel mode rotation.  To turn the mode back on later, do the same
 thing, but enter a value of 1 (click 1 time at the prompt).
 
-A light can have many different channel modes, so don't be shy about 
-turning off any modes you don't use.  It makes all the others easier to 
+A light can have many different channel modes, so don't be shy about
+turning off any modes you don't use.  It makes all the others easier to
 reach.
 
-If you turn off channel modes until only 1 remains, the "Ramp -> 3C" 
-action reverts to its single-channel behavior -- switching between a 
-smooth or stepped brightness ramp.  Additionally, when a channel mode 
-has nothing to adjust with 3H, the 3H action also reverts to its 
+If you turn off channel modes until only 1 remains, the `Ramp -> 3C`
+action reverts to its single-channel behavior -- switching between a
+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 
-tint ramp style.  There are a few styles available, by entering 
+The 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
-  2: extreme tints only
+  0: smooth ramp  
+  1: middle tint only  
+  2: extreme tints only  
   3+: stepped ramp with 3+ steps
 
-This setting only applies to modes with channel ramping (i.e. tint 
-ramping), and only when that mode uses the default 3H event handler.  
+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.
 
 
@@ -864,131 +912,168 @@ UI Reference Table
 
 This is a table of all button mappings in Anduril, in one place:
 
-Mode		UI	Button	Action
-----		--	------	------
-Off		Any	1C	On (ramp mode, memorized level)
-Off		Any	1H	On (ramp mode, floor level)
-Off		Any	2C	On (ramp mode, ceiling level)
-Off		Simple	2H	On (momentary ceiling level)
-Off		Full	2H	On (momentary turbo)
-Off		Any	3C	Battcheck mode
-Off		Full	3H	Strobe mode (whichever was used last)
-Off		Any	4C	Lockout mode
-Off		Full	5C	Momentary mode
-Off		Full	6C	Tactical mode
-Off		Full	7C	Aux LEDs: Next pattern
-Off		Full	7H	Aux LEDs: Next color
-Off		Full	9H	Misc Config menu (varies per light):
-				?1: tint ramp style
-				?2: jump start level
-Off		Full	10C	Enable Simple UI
-Off		Simple	10H	Disable Simple UI
-Off		Full	10H	Simple UI ramp config menu:
-				1: floor
-				2: ceiling
-				3: steps
-				4: turbo style
-Off		Any	13H	Factory reset (on some lights)
-Off		Any	15+C	Version check
-
-Ramp		Any	1C	Off
-Ramp		Any	1H	Ramp (up, with reversing)
-Ramp		Any	2H	Ramp (down)
-Ramp		Any	2C	Go to/from ceiling or turbo (configurable)
-Ramp		Full	3C	Change ramp style (smooth / stepped)
-Ramp		Full	6C	(same as above, but on multi-channel lights)
-Ramp		Full	3H	Momentary turbo (when no tint ramping)
-Ramp		Full	4H	Momentary turbo (on multi channel lights)
-Ramp		Any	4C	Lockout mode
-Ramp		Full	5C	Momentary mode
-Ramp		Full	5H	Sunset timer on, and add 5 minutes
-Ramp		Full	7H	Ramp config menu: (for current ramp)
-				1: floor
-				2: ceiling
-				3: speed / steps
-Ramp		Full	10C	Turn on manual memory and save current brightness
-Ramp		Full	10H	Ramp Extras config menu:
-				1: switch to automatic mem, not manual mem
-				2: set manual mem timeout
-				3: ramp after moon or not
-				4: advanced UI turbo style
-				5: smooth steps
-
-Multi-channel lights only:
-Any		Any	3C	Next channel mode (i.e. next color mode)
-Any		Any	3H	Tint ramp (if this mode can)
-Any		Full	9H	Channel mode enable/disable menu:
-				N: click (or not) to enable (disable) mode N
-
-Lockout		Any	1C/1H	Momentary moon (lowest floor)
-Lockout		Any	2C/2H	Momentary moon (highest floor, or manual mem level)
-Lockout		Any	3C	Unlock (go to "Off" mode)
-Lockout		Any	3H	Next channel mode (if more than one enabled)
-Lockout		Any	4C	On (ramp mode, memorized level)
-Lockout		Any	4H	On (ramp mode, floor level)
-Lockout		Any	5C	On (ramp mode, ceiling level)
-Lockout		Full	7C	Aux LEDs: Next pattern
-Lockout		Full	7H	Aux LEDs: Next color
-Lockout		Full	10H	Auto-lock config menu:
-				1: set timeout in minutes (0 = no auto-lock)
-
-Strobe (any)	Full	1C	Off
-Strobe (any)	Full	2C	Next strobe mode
-Strobe (any)	Full	3C	Next channel mode (saved per strobe mode)
-Strobe (any)	Full	4C	Prev strobe mode
-Strobe (any)	Full	5C	Momentary mode (using current strobe)
-
-Party strobe	Full	1H/2H	Faster / slower
-Tactical strobe	Full	1H/2H	Faster / slower
-Police strobe	-	-	None (brightness is Ramp Mode's last-used level)
-Lightning	Full	1H	Interrupt current flash or start new one
-Candle		Full	1H/2H	Brighter / dimmer
-Candle		Full	5H	Sunset timer on, add 5 minutes
-Biking		Full	1H/2H	Brighter / dimmer
-
-Batt check	Any	1C	Off
-Batt check	Full	2C	Next blinky mode (Temp check, Beacon, SOS)
-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
-				   ...
-				2: post-off voltage display seconds
-
-Temp check	Full	1C	Off
-Temp check	Full	2C	Next blinky mode (Beacon, SOS, Batt check)
-Temp check	Full	7H	Thermal config menu
-				1: set current temperature
-				2: set temperature limit
-
-Beacon		Full	1C	Off
-Beacon		Full	1H	Configure beacon timing
-Beacon		Full	2C	Next blinky mode (SOS, Batt check, Temp check)
-
-SOS		Full	1C	Off
-SOS		Full	2C	Next blinky mode (Batt check, Temp check, Beacon)
-
-Momentary	Full	Any	On (until button is released)
-Momentary	Full	Disconnect power	Exit Momentary mode
-
-Tactical	Full	1H	High (tactical slot 1)
-Tactical	Full	2H	Low (tactical slot 2)
-Tactical	Full	3H	Strobe (tactical slot 3)
-Tactical	Full	6C	Exit (go back to Off Mode)
-Tactical	Full	7H	Tactical Mode config menu:
-				1: tactical slot 1
-				2: tactical slot 2
-				3: tactical slot 3
-
-Config menus	Full	Hold	Skip current item with no changes
-Config menus	Full	Release	Configure current item
-				(goes to Number Entry menu)
-
-Number entry	Full	Click	Add 1 to value for current item
-Number entry	Full	Hold	Add 10 to value for current item
+### "Off" Mode
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Off            | Any    | `1C`    | On (ramp mode, memorized level)
+| Off            | Any    | `1H`    | On (ramp mode, floor level)
+| Off            | Any    | `2C`    | On (ramp mode, ceiling level)
+| Off            | Simple | `2H`    | On (momentary ceiling level)
+| Off            | Full   | `2H`    | On (momentary turbo)
+| Off            | Any    | `3C`    | Battcheck mode
+| Off            | Full   | `3H`    | Strobe mode (whichever was used last)
+| Off            | Any    | `4C`    | Lockout mode
+| Off            | Full   | `5C`    | Momentary mode
+| Off            | Full   | `6C`    | Tactical mode
+| Off            | Full   | `7C`    | Aux LEDs: Next pattern
+| Off            | Full   | `7H`    | Aux LEDs: Next color
+| Off            | Full   | `9H`    | Misc Config menu (varies per light):
+|                |        |         | ?1: tint ramp style
+|                |        |         | ?2: jump start level
+| Off            | Full   | `10C`   | Enable Simple UI
+| Off            | Simple | `10H`   | Disable Simple UI
+| Off            | Full   | `10H`   | Simple UI ramp config menu:
+|                |        |         | 1: floor
+|                |        |         | 2: ceiling
+|                |        |         | 3: steps
+|                |        |         | 4: turbo style
+| Off            | Any    | `13H`   | Factory reset (on some lights)
+| Off            | Any    | `15+C`  | Version check
+
+### Ramp Mode
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Ramp           | Any    | `1C`    | Off
+| Ramp           | Any    | `1H`    | Ramp (up, with reversing)
+| Ramp           | Any    | `2H`    | Ramp (down)
+| Ramp           | Any    | `2C`    | Go to/from ceiling or turbo (configurable)
+| Ramp           | Full   | `3C`    | Change ramp style (smooth / stepped)
+| Ramp           | Full   | `6C`    | (same as above, but on multi-channel lights)
+| Ramp           | Full   | `3H`    | Momentary turbo (when no tint ramping)
+| Ramp           | Full   | `4H`    | Momentary turbo (on multi channel lights)
+| Ramp           | Any    | `4C`    | Lockout mode
+| Ramp           | Full   | `5C`    | Momentary mode
+| Ramp           | Full   | `5H`    | Sunset timer on, and add 5 minutes
+| Ramp           | Full   | `7H`    | Ramp config menu: (for current ramp)
+|                |        |         | 1: floor
+|                |        |         | 2: ceiling
+|                |        |         | 3: speed / steps
+| Ramp           | Full   | `10C`   | Turn on manual memory and save current brightness
+| Ramp           | Full   | `10H`   | Ramp Extras config menu:
+|                |        |         | 1: switch to automatic mem, not manual mem
+|                |        |         | 2: set manual mem timeout
+|                |        |         | 3: ramp after moon or not
+|                |        |         | 4: advanced UI turbo style
+|                |        |         | 5: smooth steps
+
+### Multi-channel Lights
+
+| Mode           | UI     | Button  | _**Multi-channel lights only!**_
+| :---           | :--    | ------: | :-----
+| Any            | Any    | `3C`    | Next channel mode (i.e. next color mode)
+| Any            | Any    | `3H`    | Tint ramp (if this mode can)
+| Any            | Full   | `9H`    | Channel mode enable/disable menu:
+|                |        |         | N: click (or not) to enable (disable) mode N
+
+### Lockout Mode
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Lockout        | Any    |`1C`/`1H`| Momentary moon (lowest floor)
+| Lockout        | Any    |`2C`/`2H`| Momentary moon (highest floor, or manual mem level)
+| Lockout        | Any    | `3C`    | Unlock (go to "Off" mode)
+| Lockout        | Any    | `3H`    | Next channel mode (if more than one enabled)
+| Lockout        | Any    | `4C`    | On (ramp mode, memorized level)
+| Lockout        | Any    | `4H`    | On (ramp mode, floor level)
+| Lockout        | Any    | `5C`    | On (ramp mode, ceiling level)
+| Lockout        | Full   | `7C`    | Aux LEDs: Next pattern
+| Lockout        | Full   | `7H`    | Aux LEDs: Next color
+| Lockout        | Full   | `10H`   | Auto-lock config menu:
+|                |        |         | 1: set timeout in minutes (0 = no auto-lock)
+
+### Strobe Group Modes
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Strobe (any)   | Full   | `1C`    | Off
+| Strobe (any)   | Full   | `2C`    | Next strobe mode
+| Strobe (any)   | Full   | `3C`    | Next channel mode (saved per strobe mode)
+| Strobe (any)   | Full   | `4C`    | Prev strobe mode
+| Strobe (any)   | Full   | `5C`    | Momentary mode (using current strobe)
+| Party strobe   | Full   |`1H`/`2H`| Faster / slower
+| Tactical strobe| Full   |`1H`/`2H`| Faster / slower
+| Police strobe  | -      | -       | None (brightness is Ramp Mode's last-used level)
+| Lightning      | Full   | `1H`    | Interrupt current flash or start new one
+| Candle         | Full   |`1H`/`2H`| Brighter / dimmer
+| Candle         | Full   | `5H`    | Sunset timer on, add 5 minutes
+| Biking         | Full   |`1H`/`2H`| Brighter / dimmer
+
+### Blinky Modes
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Batt check     | Any    | `1C`    | Off
+| Batt check     | Full   | `2C`    | Next blinky mode (Temp check, Beacon, SOS)
+| 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
+|                |        |         |    ...
+|                |        |         | 2: post-off voltage display seconds
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Temp check     | Full   | `1C`    | Off
+| Temp check     | Full   | `2C`    | Next blinky mode (Beacon, SOS, Batt check)
+| Temp check     | Full   | `7H`    | Thermal config menu
+|                |        |         | 1: set current temperature
+|                |        |         | 2: set temperature limit
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Beacon         | Full   | `1C`    | Off
+| Beacon         | Full   | `1H`    | Configure beacon timing
+| Beacon         | Full   | `2C`    | Next blinky mode (SOS, Batt check, Temp check)
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| SOS            | Full   | `1C`    | Off
+| SOS            | Full   | `2C`    | Next blinky mode (Batt check, Temp check, Beacon)
+
+### Momentary Mode
+
+| Mode           | UI     | Button               | Action
+| :---           | :--    | ------:              | :-----
+| Momentary      | Full   | Any                  | On (until button is released)
+| Momentary      | Full   | **Disconnect power** | Exit Momentary mode
+
+### Tactical Mode
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Tactical       | Full   | `1H`    | High (tactical slot 1)
+| Tactical       | Full   | `2H`    | Low (tactical slot 2)
+| Tactical       | Full   | `3H`    | Strobe (tactical slot 3)
+| Tactical       | Full   | `6C`    | Exit (go back to Off Mode)
+| Tactical       | Full   | `7H`    | Tactical Mode config menu:
+|                |        |         | 1: tactical slot 1
+|                |        |         | 2: tactical slot 2
+|                |        |         | 3: tactical slot 3
+
+### Config Menus
+
+| Mode           | UI     | Button  | Action
+| :---           | :--    | ------: | :-----
+| Config menus   | Full   | Hold    | Skip current item with no changes
+| Config menus   | Full   | Release | Configure current item
+|                |        |         | (goes to Number Entry menu)
+| Number entry   | Full   | Click   | Add 1 to value for current item
+| Number entry   | Full   | Hold    | Add 10 to value for current item