Skip to content

ofabel/mp-flipper

Repository files navigation

License Version

MicroPython Flipper Zero

The application is now available on the official Flipper Lab. For more information on how to programm your Flipper with Python, check out the documentation on GitHub pages.

This branch contains the FAP version of the MicroPython support for the famous Flipper Zero gadget. The results of the preceding research phase is still available in the poc branch. The lib branch of this repository contains just the MicroPython library. The progress of further research on what can be achieved when moving functionality to the firmware can be found in the fork of the original firmware.

Usage

Just place your Python files somewhere on the SD card (e.g. by using the qFlipper app).

The application just starts with an open file browser:

Here you can select any Python file to compile and execute from the SD card:

Disclaimer

This FAP version requires about 80 kB from SRAM to start (needed for the Python runtime and compiler). Due to memory fragmentation it's possible, that the application crashes when you start it. If this happens, just try again (the crash doesn't harm your device).

Sadly, REPL support is only available in fhe firmware fork version.

Setup and Build

This section is only relevant, if you want to build the FAP on your own.

Requirements

Setup

git clone --recurse-submodules git@github.com:ofabel/mp-flipper.git

Build

Just open a terminal and run the Makefile targets:

make build

You can also build an launch the application on the attached Flipper Zero device in one command:

make launch