No description
Find a file
Georgii Surkov 01434265f6
[FL-2399, FL-2261] Tickless sleep shenanigans (#1168)
* Disable USART in sleep
* Restore UART state on suspend/resume
* FuriHal: Enable stop mode and add insomnia to I2C and SPI
* Remove IDLE interrupt
* FuriHal: add FPU isr and disable all FPU interrupt, add core2 stop mode configuration on deep sleep
* FuriHal: tie stop mode debug with debug rtc flag
* FuriHal: adjust flash latency on clock switch, tie mcu debug with RTC debug flag
* FuriHal: move resource init to early stage
* Add EXTI pending check, enable debug traps with compile-time flag
* Wrap sleep debug functions in conditional compilation
* Remove erroneous changed
* Do not use CSS, remove it from everywhere
* Enable/disable USB on VBUS connect (prototype)
* FuriHal: add LPMS and DEEPSLEEP magic, workaround state inconsistency between cores
* FuriHal: honor c1 LMPS
* USB mode switch fix
* Applications: add flags and insomnia bypass system
* Correct spelling
* FuriHal: cleanup insomnia usage, reset sleep flags on wakeup, add shutdown api
* FuriHal: extra check on reinit request
* FuriHal: rename gpio_display_rst pin to gpio_display_rst_n
* FuriHal: add debug HAL
* FuriHal: add some magic to core2 reload procedure, fix issue with crash on ble keyboard exit
* FuriHal: cleanup ble glue, add BLE_GLUE_DEBUG flag
* FuriHal: ble reinit API, move os timer to LPTIM1 for deep sleep capability, shutdown that works
* FuriHal: take insomnia while shutdown
* Remove USB switch on/off on VBUS change
* Better tick skew handling
* Improve tick consistency under load
* Add USB_HP dummy IRQ handler
* Move interrupt check closer to sleep
* Clean up includes
* Re-enable Insomnia globally
* FuriHal: enable CSS
* FuriHal: remove questionable core2 clock shenanigans
* FuriHal: use core1 RCC registers in idle timer config
* FuriHal: return back CSS handlers, add lptim isr dispatching

Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
Co-authored-by: nminaylov <nm29719@gmail.com>
2022-04-29 16:29:51 +03:00
.github [FL-2269] Core2 OTA (#1144) 2022-04-27 18:53:48 +03:00
applications [FL-2399, FL-2261] Tickless sleep shenanigans (#1168) 2022-04-29 16:29:51 +03:00
assets Assets: update compile steps for docker-compose (#1181) 2022-04-28 21:48:22 +03:00
core [FL-2432], [FL-2487] Rework bt keys load and save (#1139) 2022-04-21 18:36:53 +03:00
debug [FL-2198], [FL-2161] NFC emulation refactoring (#968) 2022-02-02 22:59:28 +03:00
docker Naming and coding style convention, new linter tool. (#945) 2022-01-05 19:10:18 +03:00
documentation [FL-2279] IR doxygen, rename irda -> infrared (#1010) 2022-02-25 18:22:58 +03:00
firmware [FL-2399, FL-2261] Tickless sleep shenanigans (#1168) 2022-04-29 16:29:51 +03:00
lib [FL-2399, FL-2261] Tickless sleep shenanigans (#1168) 2022-04-29 16:29:51 +03:00
make [FL-2481] Renamed assets->resources; enforcing Manifest build if it does not exist (#1135) 2022-04-19 22:02:37 +03:00
scripts [FL-2494, FL-2497] PIN Lock refactoring, IR library fix (#1167) 2022-04-27 19:30:37 +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-2156] Switch to smaller radio stack. (#923) 2021-12-23 19:24:09 +03:00
.gitignore [FL-2430] Automatic Desktop Locking (#1101) 2022-04-14 15:20:41 +03:00
.gitmodules [FL-2263] Flasher service & RAM exec (#1006) 2022-04-13 23:50:25 +03:00
Brewfile Gui: refactor text input module and fix debug on MacOS 12.3 (#1045) 2022-03-22 11:03:26 +03:00
CODE_OF_CONDUCT.md Code of Conduct (#739) 2021-10-02 20:32:18 +03:00
CODING_STYLE.md [FL-2230] SubGhz: protocol API refactoring (#969) 2022-03-03 12:48:56 +03:00
CONTRIBUTING.md Naming and coding style convention, new linter tool. (#945) 2022-01-05 19:10:18 +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 [FL-2269] Core2 OTA (#1144) 2022-04-27 18:53:48 +03:00
ReadMe.md Fixed README formatting & outdated information (#1123) 2022-04-15 21:26:23 +04:00
RoadMap.md Fixed README formatting & outdated information (#1123) 2022-04-15 21:26:23 +04: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 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 order described.

Core1 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

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...
  • make - Make helpers
  • scripts - Supplementary scripts and python libraries home

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