~toykeeper/flashlight-firmware/anduril2

Anduril User Manual
-------------------

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/


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 
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.

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.


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.

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
---------

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 
safer, and any complex or advanced functions are blocked.

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.

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.

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

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.

  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:

  - Loosen tailcap
  - Hold button
  - Tighten tailcap
  - Keep holding button 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
  1 2 3 4
  1 2 3 4
  HOLD

Simple UI is enabled after each factory reset.

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.

Configurable options include:

  - floor level
  - ceiling level
  - number of steps (in stepped ramp)
  - turbo style

Other options are inherited from Advanced UI:

  - ramp style (smooth / stepped)
  - smooth ramp speed
  - ramp-after-moon style
  - memory settings
  - auto-lock settings
  - aux LED settings
  - voltage calibration
  - thermal regulation settings
  - hardware-specific "misc menu" settings


Advanced UI
-----------

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 
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 
steps.

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.
    (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.

  - 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)

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).

  - 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.

  - 4C: Go to lockout mode.

  - 5C: Go to momentary mode.
  - 5H: Start a sunset timer.  Details are below in the Sunset Timer section.

  - 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.
        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)
    - 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.
              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,
                 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.
              1: Enable smooth steps.

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)

  - 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 
    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 
last-ramped brightness level...

  - Always remember         (automatic)
  - Remember for N minutes  (hybrid)
  - Never remember          (manual)

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

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 
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 
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 
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 
to the desired brightness.


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.


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 
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 
at the floor level instead:

  - 3C: Unlock and go to "Off" mode

  - 4C: Go to ramp mode (memorized level).
    (uses manual mem level if there is one)

  - 4H: Go to ramp mode (floor 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 has two levels:

  - 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)

  - 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 
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.

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.


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 
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).

In all of these modes, some basic actions are available:

  - Click: Turn off.
  - 2 clicks: Next blinky mode.

Additionally, in battery check and temperature check modes:

  - 7H: Go to the voltage config menu or thermal config menu.

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".

    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.

    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:

         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.

  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.

    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.

    - 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:

    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.

      - 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:

    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.


Strobe / Mood Modes
-------------------

Anduril includes a few extra modes for a variety of purposes:

  - Candle mode
  - Bike flasher
  - Party strobe
  - 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, 
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)

Additionally, candle mode has one more action:

  - 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 
    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 
    otherwise works mostly the same.  Brightness is configurable.

  - Party strobe

    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 
    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 
    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 
    full power without warning.


Momentary Mode
--------------

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 
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 
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 Ramp Mode before entering momentary mode.

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 
or battery tube.


Tactical Mode
--------------

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 
strobe, but each of these is configurable.  The inputs are:

  - 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
    - 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 
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"
           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 
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 
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 
    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 
      clicking, so there is no need to hurry.

      The actions here are:
      - click: add 1
      - 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 
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 
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.

For smooth ramping mode, there are three menu options:

  1. Floor.  (default = 1/150)
  2. Ceiling.  (default = 120/150)
  3. Ramp speed.  (default = 1, fastest speed)

For the stepped ramping mode, there are three menu options:

  1. Floor.  (default = 20/150)
  2. Ceiling.  (default = 120/150)
  3. Number of steps.  (default = 7)

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)
  2. Ceiling.  (default = 120/150)
  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.

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, 
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 
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

  - 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.

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 
looked up in the "MODELS" file or by using the "make models" command.


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 
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 
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 
locked.

Aux LED modes typically include:

  - Off
  - Low
  - 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 
mode supported on this light.

  - 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 
click and then let go when the desired color is reached.

  - 7H: Next aux LED color.

On most lights, the colors follow this sequence:

  - Red
  - Yellow (Red+Green)
  - Green
  - Cyan (Green+Blue)
  - Blue
  - Purple (Blue+Red)
  - White (Red+Green+Blue)
  - Disco (fast random colors)
  - 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 
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 
mirrors the main LED -- off, low, or high.

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.  
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 
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 
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)
    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.  
    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 
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 
features like tint ramping and channel modes.

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

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 
white.

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 
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 
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 
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 
different numbers into that config menu:

  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.  
Custom channel modes may work differently.



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