liz/flipperzero-firmware
liz/flipperzero-firmware
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
516a437305
flipperzero-firmware/ReadMe.md

6.2 KiB
Raw Blame History

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

With STLink

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 ↩ Back and keep holding ← Left until blue LED lights up
  • Release ← Left
  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 everything

docker-compose exec dev make -j$(nproc)

Flash everything

docker-compose exec dev make -j$(nproc) whole

Compile bootloader

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

Bootloader compilation results:

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

Compile firmware

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

Firmware compilation results:

  • firmware/.obj/f7/firmware.elf
  • firmware/.obj/f7/firmware.hex
  • firmware/.obj/f7/firmware.bin
  • firmware/.obj/f7/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/f7/bootloader.hex -Intel \
 firmware/.obj/f7/firmware.hex -Intel \
 -o firmware/.obj/f7/full.hex -Intel
  2. Convert HEX to DFU: 
    docker-compose exec dev hex2dfu \
 -i firmware/.obj/f7/full.hex \
 -o firmware/.obj/f7/full.dfu \
 -l "Flipper Zero F7"

Finally, you will have firmware/.obj/f7/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)
  • 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 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