Gravity for Flipper Zero

The Unseen Force

This Flipper Zero application (FAP) is a companion application to ESP32-Gravity.

ESP32-Gravity is a wireless exploration framework written for the ESP32. It supports a variety of wireless exploration, offensive and defensive features.

ESP32-Gravity can be used without a Flipper, but Flipper-Gravity can't be used without ESP32-Gravity. You can download it from the esp32-gravity GitHub repo.

Download Flipper-Gravity

1. From Source

Clone the RogueMaster repository using a command such as
- You may prefer to checkout - or even download - a release version of the code. You do you :)

gh repo clone RogueMaster/flipperzero-firmware-wPlugins

Change to the RogueMaster directory: cd flipperzero-firmware-wPlugins
Install the Flipper compilation toolchain: ./fbt
Configure your environment variables: . `./fbt -s env` (note the leading 'dot space')
Change to the applications_user directory: cd applications_user
Clone this repository using a command such as

gh repo clone chris-bc/Flipper-Gravity

Change back to the firmware root directory: cd ..

Unless you've already flashed the firmware being used you'll need to upgrade the firmware on your Flipper so that it uses the same version as the FAP.

To build and flash the complete firmware bundle make sure your Flipper Zero is on the home screen (no applications or menus open), connect it to your computer, and run

./fbt firmware_all flash_usb_full

However, if you want to install just the application, you have two main options:

./fbt launch_app APPSRC=esp32_gravity will build, install and start the application (Note that launch_app has been deprecated, new syntax is ./fbt fap_esp32_gravity launch APPSRC=esp32_gravity);
./fbt flash_usb fap_esp32_gravity will build the application and package it into a firmware update package;
Copy the update directory, which will be reported towards the end of the above command and will be similar to dist/f7-C/f7-update-RM420FAP, to the Flipper Zero's SD card;
Open Browser on the Flipper by pressing Down, then Left repeatedly until you reach a screen labelled Browser;
Navigate to the update directory you copied;
Push OK on update.fuf, then select Run in App;
Once the firmware update completes Gravity will be installed under Apps/GPIO/ESP32/[ESP32] Gravity

2. Binaries

Simply download this FAP (Flipper Application Package) and copy it to your preferred applications folder on your Flipper Zero's SD card.

Now you just need to flash and connect an ESP32 and you'll be ready to go!

Reduced Support for ESP32-C6

Good news for all the Flipper tinkerers who have a bucket of ESP32s but no ESP32-C6s - Espressif's development environment, even trying the bleeding edge from GitHub, doesn't yet have full Bluetooth support for the ESP32-C6.

Gravity now targets the regular ESP32. I'm using a Wroom during development, and hope to verify it working on ESP32-Cam cam at some point, but I think this makes ESP32 the only Espressif microcontroller with full-stack Bluetooth support. For now, at least.

For more information, including a thorough overview of all features, check out the readme doc over at esp-32-gravity

Version Compatibility

Since Gravity has been included with RogueMaster Firmware I thought I should make a couple of changes to make it easy for people other than me to know which esp32-Gravity is compatible with which Flipper-Gravity.

From here on out versions will be numbered (major).(minor).(release);
For example 1.2.1;
Different release versions (such as 1.2.1 and 1.2.9) will always be compatible with each other, although the addition or significant modification of some features may result in a small number of features not working;
Changes in minor version, such as 1.2.1 and 1.3.1, are unlikely to be compatible. A change in minor version represents a noteable change to the platform or a breaking change to the platform;
Changes in major verson, such as 1.4.9 to 2.0.0, represent substantial changes to the application and how it runs. Different major versions will not be compatible with each other.

Gravity In Action

TODO

Bug: Console scrolls to top mid-scroll when text is added to it
- Replicate: Start scan, Run help and try to read it
Add space to keyboard
add channel, mode, count STA+AP on console header
Paging in homing mode where all targets can't be displayed at the same time
- like airline departures - one screen for 3s, another screen for 3s.

Menu Structure

Beacon: target-ssids, APs, RickRoll, Random, Infinite
Probe: Any, target-ssids, APs
Sniff: On, Off
target-ssids: add, remove, list
scan: WiFi BT BLE SERVICES OFF
hop: on, off, sequential, random, default, set
view: sta, ap, bt, sta+ap+bt, sta+ap, services
select: sta, ap, bt
selected: sta, ap, bt, sta+ap+bt
clear: sta, ap, bt, services selected
purge: WiFi, BT, BLE, AP STA SERVICES
get/set: BLE_PURGE_STRAT _MIN_AGE _MAX_RSSI
deauth: off, frame STA, device STA, spoof STA, frame APs, device APs, spoof APs, frame broadcast, device broadcast, spoof broadcast
mana: on, off, clear
mana verbose: on, off
mana loud: on, off
DOS AP: on, off
DOS Clone: status, off, Open, WEP, WPA, Open+WEP, Open+WPA, WEP+WPA, Open+WEP+WPA
Homing: 802.11, Bluetooth, any (more options coming soon)
help: commands help info

Info: If possible, do not power your devices from 3V3 (pin 9) Flipper Zero. It does not support hot plugging.

Keyboard

UART_terminal uses its own special keyboard for work, which has all the symbols necessary for working in the console.

To accommodate more characters on a small display, some characters are called up by holding.

How to install

Copy the contents of the repository to the applications_user/uart_terminal folder Flipper Zero firmware and build app with the command ./fbt fap_uart_terminal.

Or use the tool uFBT for building applications for Flipper Zero.

Download ready fap

chris-bc/Flipper-Gravity