LuxLibre

LuxLibre › Documentation › Firmware › User interface

User interface (button map)

Click = press shorter than CLICK_MS (400 ms). Clicks belong to one gesture while the pause between them is shorter than CLICK_MS. Hold = press longer than CLICK_MS. The layout is chosen with the parameter UI_STYLE.

Lines marked for boards with certain hardware (side lights, a colour beam) do nothing on other boards. Colour beam means the light is on with the colour beam instead of the white one: its own lines come first, and every other gesture works as in on (hold changes the brightness, 3 clicks give the battery check). The level that holding the button reaches at the top (RAMP_CEIL, or the highest mode) gives the colour LEDs their full current.

Ramp layout (UI_STYLE = 0, default)

Light is Gesture Action
off 1 click on at the remembered level (MEMORY), otherwise MEM_LEVEL / mode 1
off hold on at the floor (moon), then brighter while held
off 2 clicks turbo (TURBO_LVL, steps down to TURBO_DOWN after TURBO_S)
off 1 click, then hold laser while held on laser boards (limits: LASER_S, LASER_TMAX, LASER_VMIN); otherwise turbo while held
off 3 clicks battery check: volts per cell as blinks (3.8 V = 3 blinks, pause, 8 blinks), repeats
off 4 clicks lockout on (3 blinks)
off 5 clicks side light on (boards with red and UV side LEDs): the colour used last, red at first (SIDE_RED, SIDE_UV)
off 5 clicks colour beam on (boards with a colour beam and no side lights): the colour and brightness used last
off 9 clicks factory reset: all parameters back to their defaults except the calibration (5 blinks)
on 1 click switch off
on hold ramp up while held (down if already at the ceiling)
on 1 click, then hold ramp down while held
on 2 clicks turbo on; again: back to the previous level
on 3 clicks battery check: volts per cell as blinks (3.8 V = 3 blinks, pause, 8 blinks), repeats
on 4 clicks switch between the white beam and the colour beam at the same brightness (boards with a colour beam)
colour beam 2 clicks next colour: the colours chosen in COLOR_SET (red, green, blue, …, the custom colour COL_R / COL_G / COL_B); the indicator shows the new colour for 1 s
lockout 4 clicks lockout off
lockout any click(s) short indicator flash, nothing else
lockout hold moon while held (if LOCK_MOON = 1)
blinky 1 click switch off
blinky 2 clicks next blinky mode: temperature read-out, beacon, SOS, strobe (as enabled by BLINKY)
side light 1 click switch off
side light 2 clicks switch the side light between red and UV (UV only if SIDE_UV > 0)

Modes layout (UI_STYLE = 1)

Light is Gesture Action
off 1 click on at the remembered level (MEMORY), otherwise MEM_LEVEL / mode 1
off hold on at the floor (moon); moon becomes the remembered level
off 2 clicks turbo (TURBO_LVL, steps down to TURBO_DOWN after TURBO_S)
off 1 click, then hold laser while held on laser boards (limits: LASER_S, LASER_TMAX, LASER_VMIN); otherwise turbo while held
off 3 clicks battery check: volts per cell as blinks (3.8 V = 3 blinks, pause, 8 blinks), repeats
off 4 clicks lockout on (3 blinks)
off 5 clicks side light on (boards with red and UV side LEDs): the colour used last, red at first (SIDE_RED, SIDE_UV)
off 5 clicks colour beam on (boards with a colour beam and no side lights): the colour and brightness used last
off 9 clicks factory reset: all parameters back to their defaults except the calibration (5 blinks)
on 1 click switch off
on hold next mode, repeating every MODE_MS while held (moon/turbo -> mode 1)
on 2 clicks turbo on; again: back to the previous level
on 3 clicks battery check: volts per cell as blinks (3.8 V = 3 blinks, pause, 8 blinks), repeats
on 4 clicks switch between the white beam and the colour beam at the same brightness (boards with a colour beam)
colour beam 2 clicks next colour: the colours chosen in COLOR_SET (red, green, blue, …, the custom colour COL_R / COL_G / COL_B); the indicator shows the new colour for 1 s
lockout 4 clicks lockout off
lockout any click(s) short indicator flash, nothing else
lockout hold moon while held (if LOCK_MOON = 1)
blinky 1 click switch off
blinky 2 clicks next blinky mode: temperature read-out, beacon, SOS, strobe (as enabled by BLINKY)
side light 1 click switch off
side light 2 clicks switch the side light between red and UV (UV only if SIDE_UV > 0)

Simple layout (UI_STYLE = 2)

Light is Gesture Action
off 1 click on at the remembered level (MEMORY), otherwise MEM_LEVEL / mode 1
off hold on at the floor (moon); moon becomes the remembered level
off 2 clicks on at SIMPLE_MAX
off 1 click, then hold laser while held on laser boards (limits: LASER_S, LASER_TMAX, LASER_VMIN); otherwise turbo while held
off 3 clicks battery check: volts per cell as blinks (3.8 V = 3 blinks, pause, 8 blinks), repeats
off 4 clicks lockout on (3 blinks)
off 5 clicks side light on (boards with red and UV side LEDs): the colour used last, red at first (SIDE_RED, SIDE_UV)
off 5 clicks colour beam on (boards with a colour beam and no side lights): the colour and brightness used last
off 9 clicks factory reset: all parameters back to their defaults except the calibration (5 blinks)
on 1 click switch off
on hold next mode, repeating every MODE_MS while held (moon/turbo -> mode 1)
on 3 clicks battery check: volts per cell as blinks (3.8 V = 3 blinks, pause, 8 blinks), repeats
on 4 clicks switch between the white beam and the colour beam at the same brightness (boards with a colour beam)
colour beam 2 clicks next colour: the colours chosen in COLOR_SET (red, green, blue, …, the custom colour COL_R / COL_G / COL_B); the indicator shows the new colour for 1 s
lockout 4 clicks lockout off
lockout any click(s) short indicator flash, nothing else
lockout hold moon while held (if LOCK_MOON = 1)
blinky 1 click switch off
side light 1 click switch off
side light 2 clicks switch the side light between red and UV (UV only if SIDE_UV > 0)

Always active

Brightness levels

Levels 1 … 150 are spaced geometrically: each level is 5.3 % brighter than the one below (on a board with LX_OUT_MIN_Q16 = 30). For the FlashKa Keychain (2200 mA full scale):

Level Output LED current
1 0.046 % 1.0 mA
10 0.072 % 1.6 mA
20 0.121 % 2.7 mA
30 0.203 % 4.5 mA
40 0.343 % 7.6 mA
50 0.574 % 12.6 mA
60 0.958 % 21.1 mA
70 1.611 % 35.4 mA
80 2.705 % 59.5 mA
90 4.529 % 99.6 mA
100 7.552 % 166.1 mA
110 12.694 % 279.3 mA
120 21.357 % 469.8 mA
130 35.647 % 784.2 mA
140 59.602 % 1311.2 mA
150 100.000 % 2200.0 mA