Biscotti 12-Group Programming: A Visual Guide

Interface Overview

Biscotti is a simple, no-ramp firmware used on many Convoy lights. It organises brightness levels into fixed mode groups — you pick the group that matches how you want to use the light.

Basic operation:

Action	Result
Click from Off	Turn on (first or last-used mode, depending on memory setting)
Click while On	Advance to next mode
Long press (> 0.5s) while On	Reset to first mode (mode memory off only)
Click while On at last mode	Turn off

Config mode is accessed while the light is on — short-tap rapidly 10+ times until the light stops responding normally. The light then blinks the current option number, followed by a brief "buzz" stutter. Click during the buzz to select that option.

Source: 12-group/biscotti-manual.md

Mode Groups

There are 12 mode groups. Brightness levels are shown as percentages of maximum output.

Group	Modes
1	0.1%, 1%, 10%, 35%, 100%, strobe, biking, battcheck
2	0.1%, 1%, 10%, 35%, 100%
3	100%, 35%, 10%, 1%, 0.1% (reversed)
4	1%, 20%, 100%, strobe, biking, battcheck, SOS
5	1%, 20%, 100%
6	100%, 20%, 1% (reversed)
7	0.1%, 1%, 10%, 50%, strobe, biking, battcheck, SOS
8	0.1%, 1%, 10%, 50%
9	50%, 10%, 1%, 0.1% (reversed)
10	1%, 10%, 35%, 100%
11	100%, 20%, strobe
12	100% only

Blinky modes included in some groups:

• Strobe — tactical police strobe (~8 Hz / ~16 Hz)
• Biking flasher — 2-level stutter beacon at 1 Hz
• Battcheck — blinks battery level (1 blink ≈ 25%; 4 = full, 5 = overcharged)
• SOS — morse SOS pattern

With mode memory off, a long press skips past blinky modes.

Source: 12-group/biscotti-manual.md

Config Mode Options

Enter config mode while On by short-tapping 10+ times rapidly. The light blinks the option number, then buzzes. Click during the buzz to select.

Option 1 — Mode Group Selection

After selecting option 1, the light enters group-select mode: it slowly blinks out numbers 1 through 12, then repeats. Turn the light off after the desired group number to lock it in.

Example: to select group 5, wait until the light blinks five times, then turn it off.

⚠️ Don't leave the light in group-select mode for extended periods — repeated writes wear out the driver's flash memory faster.

Option 2 — Mode Memory

Toggle mode memory on or off. When on, the light starts in the last-used mode. When off, it always starts in the first mode of the group.

Source: 12-group/biscotti-manual.md

Tips for Getting the Most Out of Biscotti

Pro Tip: Choosing the right mode group makes all the difference:

• EDC simplicity — Group 5 (1%, 20%, 100%) gives three clean levels with no blinky modes to accidentally cycle through.
• Versatility — Groups 1 or 7 include battcheck so you can check battery level without a separate sequence.
• Skip blinky modes — with mode memory off, a long press skips strobe/SOS modes at the end of a group.
• Count carefully — blink counting is the only group-select UI. Get in and out of group-select mode quickly to protect flash memory.

Source: 12-group/biscotti-manual.md — Biscotti firmware for Convoy brand lights