Go to file
Oleg Kalachev f6db5dd2a8
Create .editorconfig (#889)
Co-authored-by: あく <alleteam@gmail.com>
2021-12-15 14:33:52 +03:00
.github Github: fix non zero return behavior in docker actions. Firmware: fix F6 build. (#886) 2021-12-09 07:58:07 +03:00
applications [FL-1818] System setting and debug options. RTC HAL refactoring. (#902) 2021-12-15 01:39:59 +03:00
assets Rpc: implement SystemFactoryReset (#890) 2021-12-10 14:51:36 +03:00
bootloader Bootloader size optimizations (#873) 2021-12-07 17:17:08 +03:00
core [FL-1818] System setting and debug options. RTC HAL refactoring. (#902) 2021-12-15 01:39:59 +03:00
debug [FL-1934] Core: wipe memory after free. SubGhz: key encryption tool. (#797) 2021-11-01 16:11:25 +03:00
docker Simpler build, less dependencies (#827) 2021-11-18 11:46:47 +03:00
documentation [FL-1906] Documentation: add Doxyfile, prepare sources for doxygen. (#741) 2021-10-03 13:36:05 +03:00
firmware [FL-1818] System setting and debug options. RTC HAL refactoring. (#902) 2021-12-15 01:39:59 +03:00
lib [FL-1818] System setting and debug options. RTC HAL refactoring. (#902) 2021-12-15 01:39:59 +03:00
make Fix pid and vid for dfu-util (#878) 2021-12-07 20:31:20 +03:00
scripts CI: Remove pycache from artifacts (#858) 2021-12-01 13:21:26 +03:00
.clang-format Clang formatter: add indent to wrapped functions names. (#548) 2021-07-01 03:45:20 +03:00
.editorconfig Create .editorconfig (#889) 2021-12-15 14:33:52 +03:00
.gitattributes [FL-1913, FL-1963] SubGhz: save raw signal, add came atomo decoder (#783) 2021-10-25 17:37:14 +03:00
.gitignore Simpler build, less dependencies (#827) 2021-11-18 11:46:47 +03:00
.gitmodules [FL-1792] RPC service (#698) 2021-10-12 14:48:34 +03:00
Brewfile [FL-1891] Release 0.42 bugfixes (#891) 2021-12-12 14:03:39 +03:00
CODE_OF_CONDUCT.md Code of Conduct (#739) 2021-10-02 20:32:18 +03:00
CONTRIBUTING.md [FL-1906] Documentation: add Doxyfile, prepare sources for doxygen. (#741) 2021-10-03 13:36:05 +03:00
docker-compose.yml DFU make rule, update Readme (#650) 2021-08-16 23:22:30 +03:00
LICENSE Add LICENSE (#644) 2021-08-13 21:19:42 +03:00
Makefile Simpler build, less dependencies (#827) 2021-11-18 11:46:47 +03:00
ReadMe.md Hackathone session: bugfixes and documentation update (#869) 2021-12-05 14:47:02 +03:00

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.

Update firmware

Get Latest Firmware from Update Server

Flipper Zero's firmware consists of three components:

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

All 3 of them must be flashed in order described.

Core1 Bootloader + Firmware

Prerequisites:

One liner: make flash

Core2 flashing procedures

Prerequisites:

  • Linux / macOS
  • Terminal
  • STM32_Programmer_CLI (v2.5.0) added to $PATH

One liner: make flash_radio

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 with Docker

Prerequisites

  1. Install Docker Engine and Docker Compose
  2. Prepare the container:
docker-compose up -d

Compile everything

docker-compose exec dev make

Check dist/ for build outputs.

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

Build on Linux/macOS

macOS Prerequisites

Make sure you have brew and install all the dependencies:

brew bundle --verbose

Linux Prerequisites

gcc-arm-none-eabi

toolchain="gcc-arm-none-eabi-10.3-2021.10"
toolchain_package="$toolchain-$(uname -m)-linux"

wget -P /opt "https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/$toolchain_package.tar.bz2"

tar xjf /opt/$toolchain_package.tar.bz2 -C /opt
rm /opt/$toolchain_package.tar.bz2

for file in /opt/$toolchain/bin/* ; do ln -s "${file}" "/usr/bin/$(basename ${file})" ; done

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

make

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:

make whole

Links

Folders structure

  • applications - application and services
    • accessor - Wiegand server
    • archive - Archive and file manager
    • bt - BLE service and application
    • cli - Console service
    • debug_tools - different tools that we use on factory and for debug
    • dialogs - service for showing GUI dialogs
    • dolphin - dolphin service and supplementary apps
    • gpio-tester - GPIO control application
    • gui - GUI service
    • ibutton - ibutton application, onewire keys and more
    • input - input service
    • irda - irda application, controls your IR devices
    • irda_monitor - irda debug tool
    • lfrfid - LF RFID application
    • lfrfid-debug - LF RFID debug tool
    • loader - application loader service
    • menu - main menu service
    • music-player - music player app (demo)
    • nfc - NFC application, HF rfid, EMV and etc
    • notification - notification service
    • power - power service
    • power-observer - power debug tool
    • scened-app-example - c++ application example
    • storage - storage service, internal + sdcard
    • storage_settings - storage settings app
    • subghz - subghz application, 433 fobs and etc
    • tests - unit tests and etc
  • assets - assets used by applications and services
    • compiled - compilation results
    • icons - source icons images
  • bootloader - bootloader for flipper
    • src - bootloader sources
    • targets - targets' hal and implementation
  • core - core libraries: home for furi
  • debug - debug helpers, plugins and tools
  • docker - docker image sources (used for automated firmware build)
  • documentation - documentation generation system configs and input files
  • firmware - firmware for flipper
    • targets - targets' hal and implementation
  • lib - different libraries and drivers that apps and firmware uses
    • ST25RFAL002 - ST253916 driver and NFC hal
    • STM32CubeWB - STM32WB hal
    • app-scened-template - scened template app library
    • app-template - template app library
    • callback-connector - callback connector library
    • common-api - common api declaration library
    • cyfral - cyfral library
    • drivers - drivers that we wrote
    • fatfs - external storage file system
    • fnv1a-hash - fnv1a hash library
    • irda - irda library
    • littlefs - internal storage file system
    • mlib - algorithms and containers
    • nfc_protocols - nfc protocols library
    • onewire - one wire library
    • qrcode - qr code generator library
    • subghz - subghz library
    • toolbox - toolbox of things that we are using but don't place in core
    • u8g2 - graphics library that we use to draw GUI
  • make - make helpers
  • scripts - supplementary scripts