DarkFlippers/unleashed-firmware
1
1
Fork 0
mirror of https://github.com/DarkFlippers/unleashed-firmware.git synced 2024-11-24 03:07:21 +03:00
Code Issues Projects Releases Wiki Activity
f5d9d78bd1
unleashed-firmware/ReadMe.md
Eng1n33r f5d9d78bd1
fix readme
2022-07-01 14:59:42 +03:00

7.7 KiB
Raw Blame History

Flipper Zero Unleashed Firmware

fzCUSTOM

Welcome to Flipper Zero's Custom Firmware repo! Our goal is to make any features possible in this device without any limitations!

Please help us implement emulation for all dynamic (rolling codes) protocols and brute-force app!

This software is for experimental purposes only and is not meant for any illegal activity/purposes.
We do not condone illegal activity and strongly encourage keeping transmissions to legal/valid uses allowed by law.
Also this software is made without any support from Flipper Devices and in no way related to official devs.

Please use for experimental purposes only!



Our Discord Community:
Unofficial Discord Community


Update firmware

Get Latest Firmware from GitHub Releases



Update to the latest official firmware before proceeding



With offline update on flipper

Replace (CURRENT VERSION) with version that you downloaded from releases

  • Unpack flipper-z-f7-update-(CURRENT VERSION).tgz (or .zip) into any free folder on your PC or smartphone
  • You should find folder named f7-update-(CURRENT VERSION) that contains files like update.fuf, resources.tar and etc..
  • Remove microSD card from flipper and insert it into PC or smartphone (you can skip this step and upload all files using qFlipper)
  • Create new folder update on the root of the microSD card and move folder that you previously extracted from archive - f7-update-(CURRENT VERSION) into update on microSD card
  • So result should look like update/f7-update-(CURRENT VERSION)/ with all files in this folder on microSD card, remember iOS default Files app doesnt show all files properly (3 instead of 6), so you need to use another app for unpacking or use PC or Android
  • Verify that all files are present on your microSD card
  • After all you need to insert microSD card back into flipper, navigate into filebrowser, open this file update/f7-update-(CURRENT VERSION)/update.fuf
  • Update will start, wait for all stages, and when flipper started after update, you can upload any custom IR libs, and other stuff using qFlipper or directly into microSD card


With qFlipper

Replace (CURRENT VERSION) with version that you downloaded from releases

  • Connect your device and select Update from file then select flipper-z-f7-full-(CURRENT VERSION).dfu

  • And wait, if all flashed successfully - you can manually upload IR libs and other stuff to sd card

  • If you doing install for first time or migrating from official fw, unpack 2 folders from archive sd-card-(CURRENT VERSION).zip onto your microSD card



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

Replace (CURRENT VERSION) with version that you downloaded from releases

  1. Run dfu-util -D flipper-z-f7-full-(CURRENT VERSION).dfu -a 0

  2. If you doing install for first time or migrating from official fw, unpack 2 folders from archive sd-card-(CURRENT VERSION).zip to your microSD card



After install:

  • If you installed using .dfu - unpack 2 folders from archive sd-card-(CURRENT VERSION).zip to your microSD card




Support us so we can buy equipment and develop new features

  • ETH/BSC/ERC20-Tokens: 0xFebF1bBc8229418FF2408C07AF6Afa49152fEc6a
  • BTC: bc1q0np836jk9jwr4dd7p6qv66d04vamtqkxrecck9
  • DOGE: D6R6gYgBn5LwTNmPyvAQR6bZ9EtGgFCpvv
  • LTC: ltc1q3ex4ejkl0xpx3znwrmth4lyuadr5qgv8tmq8z9

Where I can find IR, SubGhz, ... DBs, and other stuff?

Awesome Flipper Zero - Github



How to Build by yourself:

Clone the Repository

You should clone with

$ git clone --recursive https://github.com/Eng1n33r/flipperzero-firmware.git

Build with Docker

Prerequisites

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

Compile everything for development

docker-compose exec dev ./fbt

Compile everything for release + get updater package to update from microSD card

docker-compose exec dev ./fbt --with-updater COMPACT=1 DEBUG=0 updater_package

Check dist/ for build outputs.

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

If compilation fails, make sure all submodules are all initialized. Either clone with --recursive or use git submodule update --init --recursive.

Build on 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

Install Python packages required by assets build scripts: pip3 install -r scripts/requirements.txt

Compile everything for development

./fbt

Compile everything for release + get updater package to update from microSD card

./fbt --with-updater COMPACT=1 DEBUG=0 updater_package

Check dist/ for build outputs.

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

Apps included

Links

Project structure

  • applications - Applications and services used in firmware
  • assets - Assets used by applications and services
  • core - Furi Core: os level primitives and helpers
  • debug - Debug tool: GDB-plugins, SVD-file and etc
  • docker - Docker image sources (used for firmware build automation)
  • documentation - Documentation generation system configs and input files
  • firmware - Firmware source code
  • lib - Our and 3rd party libraries, drivers and etc...
  • site_scons - Build helpers
  • scripts - Supplementary scripts and python libraries home

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