Sen descrición

あく 3a767c9c02 [FL-2794] Lib: update LFS to v2.5.0, lower update free page limit (#1706) %!s(int64=3) %!d(string=hai) anos
.github b7a6d18186 Fix CI/CD in tags #1703 %!s(int64=3) %!d(string=hai) anos
.vscode 1d50a5981e [FL-2059] Storage fixes for handling empty files (#1563) %!s(int64=3) %!d(string=hai) anos
applications 3a767c9c02 [FL-2794] Lib: update LFS to v2.5.0, lower update free page limit (#1706) %!s(int64=3) %!d(string=hai) anos
assets 1853359d78 [FL-2759], [FL-2766] NFC collect params for mfkey32 attack (#1643) %!s(int64=3) %!d(string=hai) anos
debug a1637e9216 fbt fixes & improvements (#1490) %!s(int64=3) %!d(string=hai) anos
documentation ffa3ff5e7c Remove obsolete info from docs (#1672) %!s(int64=3) %!d(string=hai) anos
firmware 1853359d78 [FL-2759], [FL-2766] NFC collect params for mfkey32 attack (#1643) %!s(int64=3) %!d(string=hai) anos
furi 99a7d06f71 Speedup SD card & enlarge your RAM. (#1649) %!s(int64=3) %!d(string=hai) anos
lib 3a767c9c02 [FL-2794] Lib: update LFS to v2.5.0, lower update free page limit (#1706) %!s(int64=3) %!d(string=hai) anos
scripts b7a6d18186 Fix CI/CD in tags #1703 %!s(int64=3) %!d(string=hai) anos
site_scons e1ffb4ac4d fbt: support for LOADER_AUTOSTART; post-build size stats (#1594) %!s(int64=3) %!d(string=hai) anos
.clang-format 4d6b170769 [FL-2520] FW build with -Wextra (#1185) %!s(int64=3) %!d(string=hai) anos
.editorconfig f6db5dd2a8 Create .editorconfig (#889) %!s(int64=4) %!d(string=hai) anos
.gitattributes fd498bdfcf [FL-2554] Embedded arm-none-eabi toolchain (#1351) %!s(int64=3) %!d(string=hai) anos
.gitignore 9829145d8c fbt: fixed include paths; added PVS-Studio configuration (#1615) %!s(int64=3) %!d(string=hai) anos
.gitmodules 1975868ed8 PicoPass / iClass (#1298) %!s(int64=3) %!d(string=hai) anos
.pvsconfig 9829145d8c fbt: fixed include paths; added PVS-Studio configuration (#1615) %!s(int64=3) %!d(string=hai) anos
.pvsoptions a7a9c38036 Amap and PVS Studio reports in CI/CD (#1526) %!s(int64=3) %!d(string=hai) anos
Brewfile f3b1475ede [FL-2052] New build system based on scons (#1269) %!s(int64=3) %!d(string=hai) anos
CODE_OF_CONDUCT.md 1208a5077f Code of Conduct (#739) %!s(int64=4) %!d(string=hai) anos
CODING_STYLE.md f3b1475ede [FL-2052] New build system based on scons (#1269) %!s(int64=3) %!d(string=hai) anos
CONTRIBUTING.md 389ff92cc1 Naming and coding style convention, new linter tool. (#945) %!s(int64=4) %!d(string=hai) anos
LICENSE dd6be78f44 Add LICENSE (#644) %!s(int64=4) %!d(string=hai) anos
Makefile f3b1475ede [FL-2052] New build system based on scons (#1269) %!s(int64=3) %!d(string=hai) anos
ReadMe.md ffa3ff5e7c Remove obsolete info from docs (#1672) %!s(int64=3) %!d(string=hai) anos
RoadMap.md 000ebb8f96 Fixed README formatting & outdated information (#1123) %!s(int64=3) %!d(string=hai) anos
SConstruct e4c6158d65 Update comment in SConstruct (#1684) %!s(int64=3) %!d(string=hai) anos
fbt 93a4b9c4a9 [FL-2649] Drop Docker in CI/CD (#1412) %!s(int64=3) %!d(string=hai) anos
fbt.cmd e03b102af2 Fix git submodules update called anyways (#1450) %!s(int64=3) %!d(string=hai) anos
fbt_options.py e1ffb4ac4d fbt: support for LOADER_AUTOSTART; post-build size stats (#1594) %!s(int64=3) %!d(string=hai) anos
firmware.scons 9bfb641d3e [FL-2529][FL-1628] New LF-RFID subsystem (#1601) %!s(int64=3) %!d(string=hai) anos

ReadMe.md

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

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.

With STLink

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
  3. 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.