No description
Find a file
Roland Kammerer a1ede0a2fc
BadUSB: add SYSRQ keys (#1460)
This allows sending of SysRq keys[1]. This then for example allows
sending the well known 'reisub' commands to safely reboot a otherwise
frozen Linux box. Or obviously any of the other magic keys.

The advantage compared to sending it to /proc/sysrq-trigger is that one
does not need a shell and depending on how broken the system is, one
might not even be able to get a new shell. The SysRq keys still work.

The cost is adding a new/"non-standard" keyword, IMO it is worth it.

Example:
DEFAULTDELAY 200
DELAY 1000
SYSRQ r
SYSRQ e
SYSRQ i
SYSRQ s
SYSRQ u
SYSRQ b

If one really wants to test it, I suggest h(elp) or w(ait).

[1] https://en.wikipedia.org/wiki/Magic_SysRq_key

Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
2022-10-09 02:56:56 +09:00
.github Disable PVS-Studio license check (#1840) 2022-10-07 16:56:19 +10:00
.vscode fbt: reproducible manifest builds & improvements (#1801) 2022-09-29 20:00:22 +09:00
applications BadUSB: add SYSRQ keys (#1460) 2022-10-09 02:56:56 +09:00
applications_user [FL-2627] Flipper applications: SDK, build and debug system (#1387) 2022-09-15 02:21:03 +09:00
assets Signal Generator app: UI update (#1829) 2022-10-07 22:58:36 +09:00
debug ELF-Loader: C++ plugin support, loader overhaul. (#1744) 2022-09-25 23:11:29 +09:00
documentation Documentation: AppManifests.md typo fix (#1836) 2022-10-07 10:23:21 +04:00
firmware Signal Generator app: UI update (#1829) 2022-10-07 22:58:36 +09:00
furi More correct elf loader (#1839) 2022-10-08 02:06:29 +09:00
lib Elf loader: do not load .ARM.* sections (#1850) 2022-10-09 00:51:51 +09:00
scripts [FL-2859,2838] fbt: improvements for FAPs (#1813) 2022-10-06 22:55:57 +09:00
site_scons [FL-2859,2838] fbt: improvements for FAPs (#1813) 2022-10-06 22:55:57 +09:00
.clang-format [FL-2627] Flipper applications: SDK, build and debug system (#1387) 2022-09-15 02:21:03 +09:00
.editorconfig Create .editorconfig (#889) 2021-12-15 14:33:52 +03:00
.gitattributes [FL-2554] Embedded arm-none-eabi toolchain (#1351) 2022-07-15 01:24:26 +09:00
.gitignore fbt: fixed include paths; added PVS-Studio configuration (#1615) 2022-08-23 02:06:17 +09:00
.gitmodules [FL-2627] Flipper applications: SDK, build and debug system (#1387) 2022-09-15 02:21:03 +09:00
.pvsconfig fbt: fixed include paths; added PVS-Studio configuration (#1615) 2022-08-23 02:06:17 +09:00
.pvsoptions Amap and PVS Studio reports in CI/CD (#1526) 2022-08-23 20:29:26 +09:00
Brewfile [FL-2052] New build system based on scons (#1269) 2022-06-26 21:00:03 +09:00
CODE_OF_CONDUCT.md Code of Conduct (#739) 2021-10-02 20:32:18 +03:00
CODING_STYLE.md [FL-2052] New build system based on scons (#1269) 2022-06-26 21:00:03 +09:00
CONTRIBUTING.md Naming and coding style convention, new linter tool. (#945) 2022-01-05 19:10:18 +03:00
fbt [FL-2649] Drop Docker in CI/CD (#1412) 2022-08-02 23:05:31 +09:00
fbt.cmd Fix git submodules update called anyways (#1450) 2022-07-26 02:09:04 +03:00
fbt_options.py faploader: more subsystem headers in API table (#1742) 2022-09-19 21:39:00 +09:00
firmware.scons [FL-2859,2838] fbt: improvements for FAPs (#1813) 2022-10-06 22:55:57 +09:00
LICENSE Add LICENSE (#644) 2021-08-13 21:19:42 +03:00
Makefile [FL-2052] New build system based on scons (#1269) 2022-06-26 21:00:03 +09:00
ReadMe.md Update ReadMe.md (#1766) 2022-09-24 19:36:11 +09:00
RoadMap.md Fixed README formatting & outdated information (#1123) 2022-04-15 21:26:23 +04:00
SConstruct [FL-2844] desktop: removing slideshow file when leaving slideshow view (#1762) 2022-09-21 23:42:59 +09: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.

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.

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