Flipper Zero Unleashed Firmware
Go to file
2021-09-03 01:44:37 +03:00
.github CI: Fix git.mk & post a quick flash link on PR builds (#670) 2021-08-26 20:59:23 +03:00
applications [FL-1748] NFC, iButton edit fix (#680) 2021-09-02 12:28:40 +03:00
assets [FL-1720] BLE GUI refactoring (#678) 2021-09-02 02:22:40 +03:00
bootloader Fix SubGhz test views erratic behavior on mode switch. New bootloader image. (#669) 2021-08-24 02:52:59 +03:00
core [FL-1756, FL-1769, FL-1776, FL-1759] Gui: input events complementary V3, refactoring. SubGhz: read/emulate fixes. Cleanup. (#684) 2021-09-02 00:05:00 +03:00
debug Debug: update PyCortexMDebug to latest and refactor (#574) 2021-07-12 05:13:01 +03:00
docker Toolchain: Fix GDB (#686) 2021-09-03 01:44:37 +03:00
firmware [FL-1720] BLE GUI refactoring (#678) 2021-09-02 02:22:40 +03:00
lib [FL-1756, FL-1769, FL-1776, FL-1759] Gui: input events complementary V3, refactoring. SubGhz: read/emulate fixes. Cleanup. (#684) 2021-09-02 00:05:00 +03:00
make CI: Fix git.mk & post a quick flash link on PR builds (#670) 2021-08-26 20:59:23 +03:00
scripts [FL-1643] NFC emv assets (#661) 2021-08-20 22:56:43 +03:00
.clang-format Clang formatter: add indent to wrapped functions names. (#548) 2021-07-01 03:45:20 +03:00
.gitattributes Refactor F2/local before F3 merge (#220) 2020-11-06 11:31:59 +03:00
.gitignore [FL-1250, FL-1252, FL-1323, FL-1324] New IRDA Application (part 1) (#497) 2021-06-02 18:16:05 +03:00
.gitmodules Removed app floopper-bloopper and font FontGlyph (#549) 2021-07-01 14:33:43 +03:00
docker-compose.yml DFU make rule, update Readme (#650) 2021-08-16 23:22:30 +03:00
flipper-zero-cla.md Update flipper-zero-cla.md 2020-08-01 19:42:32 +03:00
LICENSE Add LICENSE (#644) 2021-08-13 21:19:42 +03:00
ReadMe.md Fix readme consistency issues (#652) 2021-08-17 13:38:47 +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 componenets by ST: FUS + radio stack.
  • 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.

Core2 flashing procedures

Prerequisites:

  • Linux / macOS
  • Terminal
  • STM32_Programmer_CLI added to $PATH

One liner: ./flash_core2_ble.sh

Core1 Bootloader + Firmware

Prerequisites:

One liner: ./flash_core1_main.sh

With USB DFU

  1. Download latest Firmware

  2. Reboot Flipper to Bootloader

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

Build from source

Prerequisites

  1. Install Docker Engine and Docker Compose
  2. Clone the repo:
    git clone https://github.com/flipperdevices/flipperzero-firmware
    cd flipperzero-firmware
    
  3. Prepare the container:
    docker compose up -d
    

Compile bootloader

docker compose exec dev make -j$(nproc) -C bootloader TARGET=f6

Bootloader compilation results:

  • bootloader/.obj/f6/bootloader.elf
  • bootloader/.obj/f6/bootloader.hex
  • bootloader/.obj/f6/bootloader.bin
  • bootloader/.obj/f6/bootloader.dfu - should be used to flash

Compile firmware

docker compose exec dev make -j$(nproc) -C firmware TARGET=f6

Firmware compilation results:

  • firmware/.obj/f6/firmware.elf
  • firmware/.obj/f6/firmware.hex
  • firmware/.obj/f6/firmware.bin
  • firmware/.obj/f6/firmware.dfu - should be used to flash

Concatenate bootloader and firmware

You might want to do this to distribute the firmware as a single file.

That's exactly how we generate our full builds.

  1. Concatenate HEX files:
    docker compose exec dev srec_cat \
     bootloader/.obj/f6/bootloader.hex -Intel \
     firmware/.obj/f6/firmware.hex -Intel \
     -o firmware/.obj/f6/full.hex -Intel
    
  2. Convert HEX to DFU:
    docker compose exec dev hex2dfu \
     -i firmware/.obj/f6/full.hex \
     -o firmware/.obj/f6/full.dfu \
     -l "Flipper Zero F6"
    

Finally, you will have firmware/.obj/f6/full.dfu file that can be distributed and flashed.

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 supplientary 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)
  • 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 delaration 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 - supplimentary scripts