From 61908a51e5a35decf24f8555d85b23115028c4be Mon Sep 17 00:00:00 2001
From: SiteRelEnby <125829806+SiteRelEnby@users.noreply.github.com>
Date: Sun, 2 Jun 2024 15:41:32 -0500
Subject: [PATCH] add emisar-d3aa and sofirn-lt1s-pro readmes

---
 hw/hank/emisar-d3aa/README.md | 16 ++++++++++++++++
 hw/sofirn/lt1s-pro/README.md  | 22 ++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 hw/hank/emisar-d3aa/README.md
 create mode 100644 hw/sofirn/lt1s-pro/README.md

diff --git a/hw/hank/emisar-d3aa/README.md b/hw/hank/emisar-d3aa/README.md
new file mode 100644
index 00000000..224fe712
--- /dev/null
+++ b/hw/hank/emisar-d3aa/README.md
@@ -0,0 +1,16 @@
+# Emisar D3AA
+
+14500/AA single channel light with HDR boost driver by [thefreeman](https://budgetlightforum.com/u/thefreeman). thefreeman has done an [excellent technical writeup on this driver](https://budgetlightforum.com/t/emisar-d3aa-driver-technical-information/223513).
+
+No built in charging.
+
+## Weak Battery Protection
+When the D3AA boots (each time power is connected) it will test the battery's performance and set a hard cap on output, to prevent damage to weak batteries, as the driver is capable of drawing more current than is safe for the battery from alkaline and Ni-MH batteries. This may also cause reduced turbo output if a very low li-ion battery is inserted and the weak battery protection is activated. This will not happen if a 14500 battery is inserted at a high charge level and then used until charge drops, unless the tailcap is untwisted and reconnected.
+
+## Channel Modes
+### Main LEDs
+AKA `CM_MAIN`. The three main LEDs, driven in series as a single channel.
+
+### RGB Aux Modes
+These channel modes (in order: red, orange/yellow, green, cyan, blue, purple, white) use aux instead of main emitters. This is useful for using red or white as a vision-preserving mode in extremely low light situations, otherwise the main use of these channels is to be selected for strobe or blinky modes.
+
diff --git a/hw/sofirn/lt1s-pro/README.md b/hw/sofirn/lt1s-pro/README.md
new file mode 100644
index 00000000..57b17a16
--- /dev/null
+++ b/hw/sofirn/lt1s-pro/README.md
@@ -0,0 +1,22 @@
+# Sofirn LT1S Pro
+
+21700 lantern with 3 individual LED channels (neutral white, warm white, and red).
+
+Built in USB-C charging and LED battery indicator. The LED battery indicator is not controlled by Anduril and will activate whenever the switch is pressed, and has four LEDs - all four lit corresponds to around 4.1-4.2V, and one lit corresponds to around 3.7V or less. When charging using the USB port, the LEDs will animate in a "charging" pattern.
+
+## Channel Modes
+### White
+AKA `CM_WHITE`. This is a ramping channel mode with a manually adjustable mix between the 2700k cool white LEDs and 5000k neutral white.
+
+### Auto-Tint (White)
+AKA `CM_AUTO2`. This is an auto-tint mode where the mix will shift from 2700k at low ramp to 5000k at maximum level.
+
+### Auto-Tint (White/Red)
+AKA `CM_AUTO3`. This is an auto-tint mode where the mix will shift from red at the bottom of the ramp, then to white, initially at 2700k before then increasing to 5000k at maximum level.
+
+### Red
+AKA `CM_RED`. Only uses the red LEDs.
+
+### White/Red
+AKA `CM_WHITE_RED`. This is a ramping channel mode with a manually adjustable mix between white and red. The mix of the two white channels in this mode is the same as the selected mix in the white (`CM_WHITE`) channel.
+