説明なし

hedger 41de5f3c52 fbt: more fixes for windows environment #2011 3 年 前
.github ce294c3b1e Update toolchain to version 19. Update codeowners. Fix amap analyze. (#1986) 3 年 前
.vscode 2d6c2886ae fbt: compile_db fixes (#1981) 3 年 前
applications 73441af9c6 BadUSB and Archive fixes (#2005) 3 年 前
applications_user b9a766d909 [FL-2627] Flipper applications: SDK, build and debug system (#1387) 3 年 前
assets aa2ecbe80f infrared: add Kaseikyo IR protocol (#1965) 3 年 前
debug 04e50c9f89 fbt: fixes for ufbt pt3 (#1970) 3 年 前
documentation aec36e7041 Fixed typos (#1999) 3 年 前
firmware f9730bcafe fbt: lint fixes (#2008) 3 年 前
furi f9730bcafe fbt: lint fixes (#2008) 3 年 前
lib 73441af9c6 BadUSB and Archive fixes (#2005) 3 年 前
scripts 41de5f3c52 fbt: more fixes for windows environment #2011 3 年 前
site_scons a959fa32bc fbt: 'target' field for apps; lib debugging support (#1995) 3 年 前
.clang-format b9a766d909 [FL-2627] Flipper applications: SDK, build and debug system (#1387) 3 年 前
.editorconfig f6db5dd2a8 Create .editorconfig (#889) 4 年 前
.gitattributes fd498bdfcf [FL-2554] Embedded arm-none-eabi toolchain (#1351) 3 年 前
.gitignore 2d6c2886ae fbt: compile_db fixes (#1981) 3 年 前
.gitmodules 0adad32418 fbt fixes pt4 (#1899) 3 年 前
.pvsconfig 2d6c2886ae fbt: compile_db fixes (#1981) 3 年 前
.pvsoptions a7a9c38036 Amap and PVS Studio reports in CI/CD (#1526) 3 年 前
Brewfile f3b1475ede [FL-2052] New build system based on scons (#1269) 3 年 前
CODE_OF_CONDUCT.md 1208a5077f Code of Conduct (#739) 4 年 前
CODING_STYLE.md f3b1475ede [FL-2052] New build system based on scons (#1269) 3 年 前
CONTRIBUTING.md 389ff92cc1 Naming and coding style convention, new linter tool. (#945) 4 年 前
LICENSE dd6be78f44 Add LICENSE (#644) 4 年 前
Makefile f3b1475ede [FL-2052] New build system based on scons (#1269) 3 年 前
ReadMe.md 6d2b0a3b6c Update ReadMe.md (#1766) 3 年 前
RoadMap.md 000ebb8f96 Fixed README formatting & outdated information (#1123) 3 年 前
SConstruct f9730bcafe fbt: lint fixes (#2008) 3 年 前
fbt 0adad32418 fbt fixes pt4 (#1899) 3 年 前
fbt.cmd 0adad32418 fbt fixes pt4 (#1899) 3 年 前
fbt_options.py 820afd2aec NFC Unit tests part 1.1 (#1927) 3 年 前
firmware.scons f9730bcafe fbt: lint fixes (#2008) 3 年 前

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

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.

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, etc.
  • scripts - Supplementary scripts and python libraries home

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