mirror of
https://github.com/UberGuidoZ/Flipper.git
synced 2024-12-23 15:00:13 +00:00
61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# Flipper Air Mouse
|
|
|
|
## Brief
|
|
|
|
> "You can turn anything into an air mouse if you're brave enough"
|
|
|
|
— Piper, a.k.a. Pez
|
|
|
|
Naturally, the quote above applies to [Flipper](https://flipperzero.one/) as well.
|
|
|
|
## 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).
|
|
|
|
See early prototype [in action](https://www.youtube.com/watch?v=DdxAmmsYfMA).
|
|
|
|
## Hardware
|
|
|
|
The custom module is using Bosch BMI160 accelerometer/gyroscope chip connected via I2C.
|
|
|
|
Take a look into the [schematic](https://github.com/ginkage/FlippAirMouse/tree/main/schematic) folder for Gerber, BOM and CPL files, so you can order directly from JLCPCB.
|
|
|
|
Original idea:
|
|
|
|
|
|
|
|
Expectation:
|
|
|
|
|
|
|
|
Reality:
|
|
|
|
|
|
|
|
## Software
|
|
|
|
The code is based on the original Bosch [driver](https://github.com/BoschSensortec/BMI160_driver/) and an orientation tracking implementation from the Google [Cardboard](https://github.com/googlevr/cardboard/tree/master/sdk/sensors) project
|
|
|
|
If you're familiar with Flipper applications, start in the [firmware](https://github.com/flipperdevices/flipperzero-firmware) checkout folder and do the following:
|
|
```
|
|
cd applications/plugins
|
|
git clone https://github.com/ginkage/FlippAirMouse
|
|
cd ../..
|
|
./fbt fap_air_mouse
|
|
```
|
|
If you're not familiar with those, just grab a `fap` file from Releases.
|
|
|
|
## License
|
|
|
|
TL;DR: Use the code however you want, give credit where it's due, no warranty of any kind is provided.
|