No description
Find a file
あく 4d985ba8f8
Storage: remove LFS (#3577)
* Storage: drop internal storage

* Storage: rollback some unnecessary changes

* Storage: rollback some unnecessary changes part 2

* Storage: cleanup various defines and int handling. Ble: allow short connection interval if internal flash is not used.

* Storage: do not return storage if it is not ready

* Save PIN code to RTC, update settings

* Simplify the code, clean up includes

* Rearrange some code

* apps: storage_move_to_sd: conditionally enable with --extra-define=STORAGE_INT_ON_LFS

* Load Desktop settings automatically

* Redirect /any to /ext

* Abolish storage_move_to_sd app

* Remove as many mentions of ANY_PATH as possible

* Fix desktop settings wrongly not loading

* Improve desktop settings handling and strings

* Load BLE settings and keys automatically

* Improve BLE configuration procedure

* Do not load bluetooth keys twice if they were already loaded

* Load dolphin state automatically

* Fix merge artifact

* Load notification settings automatically

* Update desktop settings strings

* Load expansion settings automatically

* Do not use thread signals to reload desktop settings

* Load region data automatically, separate to its own hook

* Improve ble behaviour with no keys

* Fix Dolphin state not resetting correctly

* Add a status check

* Make Desktop save its own settings

* Check result when taking and releasing mutex

* Improve default thread signal handling in FuriEventLoop

* Make bt service in charge of saving settings, add settings api

* Fix a deadlock due to timer thread not receiving time

* Lock core2 when reinitialising bt

* Update clang-format

* Revert "Update clang-format"

This reverts commit d61295ac063c6ec879375ceeab54d6ff2c90a9a1.

* Format sources with clang-format

* Revert old stack size for desktop settings

* Allocate big struct dynamically

* Simplify PIN comparison

* Save pointer to storage in Desktop object

* Fix region provisioning for hardware regions

* Remove stale TODO + siimplify code

* Clean up region.c

* Use sizeof instead of macro define

* Limit PIN length to 10 for consistency

* Emit a warning upon usage of /any

* Add delay after finding flipper

* Remove unnecessary delay

* Remove all mentions of STORAGE_INT_ON_LFS

* Remove littlefs and internal storage

* Remove all possible LittleFS mentions

* Fix browser tab in Archive

* Ble: fix connection interval explanation

* Bump API Symbols

* BLE: Update comments interval connection comments

* Storage: clear FuriHalRtcFlagStorageFormatInternal if set

---------

Co-authored-by: Georgii Surkov <georgii.surkov@outlook.com>
Co-authored-by: hedger <hedger@nanode.su>
Co-authored-by: Georgii Surkov <37121527+gsurkov@users.noreply.github.com>
2024-08-04 10:54:02 +01:00
.github Increase github action timeouts (#3763) 2024-07-07 16:56:08 +01:00
.vscode toolchain: v39 (#3793) 2024-07-30 11:30:25 +09:00
applications Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
applications_user [FL-2627] Flipper applications: SDK, build and debug system (#1387) 2022-09-15 02:21:03 +09:00
assets [FL-3866] Intruder animation (#3779) 2024-07-10 13:02:07 +01:00
documentation Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
furi Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
lib Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
scripts Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
site_scons Added -Wundef to compiler options (#3815) 2024-08-01 01:38:20 +09:00
targets Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
.clang-format [FL-3867] Code formatting update (#3765) 2024-07-15 13:38:49 +09:00
.clangd cleanup of various warnings from clangd (#3682) 2024-06-03 14:43:23 +01:00
.editorconfig Remove unused entries from .editorconfig (#3811) 2024-07-28 00:57:39 +03:00
.gitattributes [FL-2554] Embedded arm-none-eabi toolchain (#1351) 2022-07-15 01:24:26 +09:00
.gitignore toolchain: v38; clangd as default language server (#3774) 2024-07-15 10:56:21 +09:00
.gitmodules Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
.pvsconfig [FL-3846] Event Loop Timers (#3721) 2024-07-02 13:09:50 +01:00
.pvsoptions Storage: remove LFS (#3577) 2024-08-04 10:54:02 +01:00
.sublime-project toolchain: v39 (#3793) 2024-07-30 11:30:25 +09:00
CODE_OF_CONDUCT.md Code of Conduct (#739) 2021-10-02 20:32:18 +03:00
CODING_STYLE.md fix: make dialog_file_browser_set_basic_options initialize all fields (#2756) 2023-06-27 18:46:04 +09:00
CONTRIBUTING.md Fixing various typos in readme files #2208 2022-12-28 23:30:20 +09:00
fbt Toolchain fixes (#3451) 2024-02-26 16:16:19 +04:00
fbt.cmd Toolchain fixes (#3451) 2024-02-26 16:16:19 +04:00
fbt_options.py copro: bumped to 1.20.0 (#3727) 2024-07-03 19:31:55 +01:00
firmware.scons fbt, vscode: tweaks for cdb generation for clangd (#3680) 2024-06-01 13:20:51 +01:00
LICENSE Add LICENSE (#644) 2021-08-13 21:19:42 +03:00
ReadMe.md ReadMe: update outdated bits and pieces (#3726) 2024-06-20 18:18:31 +01:00
SConstruct toolchain: v38; clangd as default language server (#3774) 2024-07-15 10:56:21 +09:00

A pixel art of a Dophin with text: Flipper Zero Official Repo

Flipper Zero Firmware

Contributing

Our main goal is to build a healthy and sustainable community around Flipper, so we're open to any new ideas and contributions. We also have some rules and taboos here, so please read this page and our Code of Conduct carefully.

I need help

The best place to search for answers is our User Documentation. If you can't find the answer there, check our Discord Server or our Forum. If you want to contribute to the firmware development, or modify it for your own needs, you can also check our Developer Documentation.

I want to report an issue

If you've found an issue and want to report it, please check our Issues page. Make sure the description contains information about the firmware version you're using, your platform, and a clear explanation of the steps to reproduce the issue.

I want to contribute code

Before opening a PR, please confirm that your changes must be contained in the firmware. Many ideas can easily be implemented as external applications and published in the Flipper Application Catalog. If you are unsure, reach out to us on the Discord Server or the Issues page, and we'll help you find the right place for your code.

Also, please read our Contribution Guide and our Coding Style, and make sure your code is compatible with our Project License.

Finally, open a Pull Request and make sure that CI/CD statuses are all green.

Development

Flipper Zero Firmware is written in C, with some bits and pieces written in C++ and armv7m assembly languages. An intermediate level of C knowledge is recommended for comfortable programming. C, C++, and armv7m assembly languages are supported for Flipper applications.

Firmware RoadMap

Firmware RoadMap Miro Board

Requirements

Supported development platforms:

  • Windows 10+ with PowerShell and Git (x86_64)
  • macOS 12+ with Command Line tools (x86_64, arm64)
  • Ubuntu 20.04+ with build-essential and Git (x86_64)

Supported in-circuit debuggers (optional but highly recommended):

Flipper Build System will take care of all the other dependencies.

Cloning source code

Make sure you have enough space and clone the source code:

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

Building

Build firmware using Flipper Build Tool:

./fbt

Flashing firmware using an in-circuit debugger

Connect your in-circuit debugger to your Flipper and flash firmware using Flipper Build Tool:

./fbt flash

Flashing firmware using USB

Make sure your Flipper is on, and your firmware is functioning. Connect your Flipper with a USB cable and flash firmware using Flipper Build Tool:

./fbt flash_usb

Documentation

Project structure

  • applications - Applications and services used in firmware
  • applications_users - Place for your additional applications and services
  • assets - Assets used by applications and services
  • documentation - Documentation generation system configs and input files
  • furi - Furi Core: OS-level primitives and helpers
  • lib - Our and 3rd party libraries, drivers, tools and etc...
  • site_scons - Build system configuration and modules
  • scripts - Supplementary scripts and various python libraries
  • targets - Firmware targets: platform specific code

Also, see ReadMe.md files inside those directories for further details.

Links