From 8412b23d2a4a9ae707ca3add0bc980519af37ee9 Mon Sep 17 00:00:00 2001
From: Ivan Podogov <ginkage@yandex.ru>
Date: Mon, 26 Jun 2023 19:45:08 +0100
Subject: [PATCH] Create DESCRIPTION.md

---
 DESCRIPTION.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 DESCRIPTION.md

diff --git a/DESCRIPTION.md b/DESCRIPTION.md
new file mode 100644
index 00000000000..03d54b06a47
--- /dev/null
+++ b/DESCRIPTION.md
@@ -0,0 +1,47 @@
+# Flipper Air Mouse
+
+## Brief
+
+> "You can turn anything into an air mouse if you're brave enough"
+
+ — Piper, a.k.a. Pez
+
+## What?
+
+The app allows you to turn your Flipper into a USB or Bluetooth air mouse (you do need an extra module, see the Hardware section below)...
+
+Using it is really simple:
+ * Connect the Flipper via a USB cable and pick `USB`, or pick `Bluetooth` and pair it with your PC;
+ * Hold the Flipper in your hand with the buttons pointing towards the screen;
+ * Wave your Flipper like you don't care to move the cursor;
+ * Up button for Left mouse click;
+ * Down button for Right mouse click;
+ * Center button for Middle mouse click;
+ * Left and Right buttons for scrolling;
+ * Use calibration menu option if you notice significant drift (place your Flipper onto a level surface, make sure it doesn't move, run this option, wait 2 seconds, done).
+
+## Hardware
+
+The custom module is using Bosch BMI160 accelerometer/gyroscope chip connected via I2C.
+
+Take a look into the `schematic` folder for Gerber, BOM and CPL files, so you can order directly from JLCPCB.
+
+Original idea:
+
+![What I thought it would look like](https://github.com/ginkage/FlippAirMouse/blob/main/schematic/schematic.png)
+
+Expectation:
+
+![What EDA though it would look like](https://github.com/ginkage/FlippAirMouse/blob/main/schematic/render.png)
+
+Reality:
+
+![What it looks like](https://github.com/ginkage/FlippAirMouse/blob/main/schematic/flipper.jpg)
+
+## Software
+
+The code is based on the original Bosch driver and an orientation tracking implementation from the Google Cardboard project
+
+## License
+
+TL;DR: Use the code however you want, give credit where it's due, no warranty of any kind is provided.