Go to file
Astra 9f3b80e606
Add new card parsers (#1503)
* Add the "Two cities" parser
* Add plantain and plantain4k parsers
* Add new parsers to the supported list
* United card PoC
* Fix nfc device not sleeping
* Completely read the 4K troika variants
* Correct naming
* Update to reflect upstream changes
* Add support for MfUl info
* Fix parsers
* Card type detection fixes
* Remove debug info
* Fixes for the verification of cards
* nfc: fix verification for supported cards
* nfc: remove unused vars
* Improve card reading reliability and fix plantain
* plantain: change log level

Co-authored-by: gornekich <n.gorbadey@gmail.com>
2022-09-20 01:05:04 +09:00
.github Fbt: fixed gdb-py path for MacOS, docs: spelling fixes, codeowners (#1736) 2022-09-15 22:40:26 +09:00
.vscode Fbt: fixed gdb-py path for MacOS, docs: spelling fixes, codeowners (#1736) 2022-09-15 22:40:26 +09:00
applications Add new card parsers (#1503) 2022-09-20 01:05:04 +09:00
applications_user
assets SubGhz: Oregon v2.1 decoder (#1678) 2022-09-19 23:24:24 +09:00
debug
documentation faploader: more subsystem headers in API table (#1742) 2022-09-19 21:39:00 +09:00
firmware [FL-2815, FL-2821] Dummy mode (#1739) 2022-09-19 22:03:42 +09:00
furi [FL-2800] Fix Mifare Classic 4K reading of the last 8 sectors (#1712) 2022-09-19 21:30:18 +09:00
lib Add new card parsers (#1503) 2022-09-20 01:05:04 +09:00
scripts
site_scons faploader: more subsystem headers in API table (#1742) 2022-09-19 21:39:00 +09:00
.clang-format
.editorconfig
.gitattributes [FL-2554] Embedded arm-none-eabi toolchain (#1351) 2022-07-15 01:24:26 +09:00
.gitignore
.gitmodules
.pvsconfig fbt: fixed include paths; added PVS-Studio configuration (#1615) 2022-08-23 02:06:17 +09:00
.pvsoptions
Brewfile
CODE_OF_CONDUCT.md
CODING_STYLE.md
CONTRIBUTING.md
fbt
fbt_options.py faploader: more subsystem headers in API table (#1742) 2022-09-19 21:39:00 +09:00
fbt.cmd
firmware.scons faploader: more subsystem headers in API table (#1742) 2022-09-19 21:39:00 +09:00
LICENSE
Makefile
ReadMe.md
RoadMap.md
SConstruct

Flipper Zero Firmware

Discord

Show me the code

Welcome to Flipper Zero's Firmware repo! Our goal is to create nice and clean code with good documentation, to make it a pleasure for everyone to work with.

Clone the Repository

You should clone with

$ git clone --recursive https://github.com/flipperdevices/flipperzero-firmware.git

Read the Docs

Check out details on how to build firmware, write applications, un-brick your device and more in documentation folder.

Update firmware

Get Latest Firmware from Update Server

Flipper Zero's firmware consists of two components:

  • Core2 firmware set - proprietary components by ST: FUS + radio stack. FUS is flashed at factory and you should never update it.
  • Core1 Firmware - HAL + OS + Drivers + Applications.

They both must be flashed in the order described.

With offline update package

With Flipper attached over USB:

./fbt flash_usb

Just building the package:

./fbt updater_package

To update, copy the resulting directory to Flipper's SD card and navigate to update.fuf file in Archive app.

Core1 Firmware

Prerequisites:

One liner: ./fbt firmware_flash

With USB DFU

  1. Download latest Firmware

  2. Reboot Flipper to Bootloader

  • Press and hold ← Left + ↩ Back for reset
  • Release ↩ Back and keep holding ← Left until blue LED lights up
  • Release ← Left
  1. Run dfu-util -D full.dfu -a 0

Build on Linux/macOS

Check out documentation/fbt.md for details on building and flashing firmware.

macOS Prerequisites

Make sure you have brew and install all the dependencies:

brew bundle --verbose

Linux Prerequisites

The FBT tool handles everything, only git is required.

Optional dependencies

  • openocd (debugging/flashing over SWD)
  • heatshrink (compiling image assets)
  • clang-format (code formatting)
  • dfu-util (flashing over USB DFU)
  • protobuf (compiling proto sources)

For example, to install them on Debian, use:

apt update
apt install openocd clang-format-13 dfu-util protobuf-compiler

heatshrink has to be compiled from sources.

Compile everything

./fbt

Check dist/ for build outputs.

Use flipper-z-{target}-full-{suffix}.dfu to flash your device.

Flash everything

Connect your device via ST-Link and run:

./fbt firmware_flash

Links

Project structure

  • applications - Applications and services used in firmware
  • assets - Assets used by applications and services
  • furi - Furi Core: os level primitives and helpers
  • debug - Debug tool: GDB-plugins, SVD-file and etc
  • documentation - Documentation generation system configs and input files
  • firmware - Firmware source code
  • lib - Our and 3rd party libraries, drivers and etc...
  • scripts - Supplementary scripts and python libraries home

Also pay attention to ReadMe.md files inside of those directories.