Flipper Zero Unleashed Firmware
Go to file
g3gg0.de c186d2b0cc
added ISO15693 (NfcV) reading, saving, emulating and revealing from privacy mode (unlock) (#2316)
* added support for ISO15693 (NfcV) emulation, added support for reading SLIX tags
* SLIX: fixed crash situation when an invalid password was requested
* ISO15693: show emulate menu when opening file
* rename NfcV emulate scene to match other NfcV names
* optimize allocation size for signals
* ISO15693: further optimizations of allocation and free code
* ISO15693: reduce latency on state machine reset
* respond with block security status when option flag is set
* increased maximum memory size to match standard
  added security status handling/load/save
  added SELECT/QUIET handling
  more fine grained allocation routines and checks
  fix memset sizes
* added "Listen NfcV Reader" to sniff traffic from reader to card
* added correct description to delete menu
* also added DSFID/AFI handling and locking
* increase sniff log size
* scale NfcV frequency a bit, add echo mode, fix signal level at the end
* use symbolic modulated/unmodulated GPIO levels
* honor AFI field, decrease verbosity and removed debug code
* refactor defines for less namespace pollution by using NFCV_ prefixes
* correct an oversight that original cards return an generic error when addressing outside block range
* use inverse modulation, increasing readable range significantly
* rework and better document nfc chip initialization
* nfcv code review fixes
* Disable accidentally left on signal debug gpio output
* Improve NFCV Read/Info GUIs. Authored by @xMasterX, committed by @nvx
* Fix crash that occurs when you exit from NFCV emulation and start it again. Authored by @xMasterX, committed by @nvx
* Remove delay from emulation loop. This improves compatibility when the reader is Android.
* Lib: digital signal debug output pin info

Co-authored-by: Tiernan Messmer <tiernan.messmer@gmail.com>
Co-authored-by: MX <10697207+xMasterX@users.noreply.github.com>
Co-authored-by: gornekich <n.gorbadey@gmail.com>
Co-authored-by: あく <alleteam@gmail.com>
2023-06-08 14:30:53 +09:00
.github [DEVOPS-18]: Add map file parser, mariadb inserter (#2732) 2023-06-05 19:25:43 +09:00
.vscode Debug: revert cortex debug to lxml and drop DWT (#2651) 2023-05-09 03:31:44 +04:00
applications added ISO15693 (NfcV) reading, saving, emulating and revealing from privacy mode (unlock) (#2316) 2023-06-08 14:30:53 +09:00
applications_user [FL-2627] Flipper applications: SDK, build and debug system (#1387) 2022-09-15 02:21:03 +09:00
assets [FL-2872] Remove unused resources (#2740) 2023-06-06 22:11:23 +04:00
documentation [FL-3330] fbt: added hooks for build & dist environments; added FW_ORIGIN_* macro for apps & SDK (#2705) 2023-05-30 01:40:56 +09:00
firmware added ISO15693 (NfcV) reading, saving, emulating and revealing from privacy mode (unlock) (#2316) 2023-06-08 14:30:53 +09:00
furi Furi: smaller critical enter and critical exit macro (#2716) 2023-06-06 23:00:43 +04:00
lib added ISO15693 (NfcV) reading, saving, emulating and revealing from privacy mode (unlock) (#2316) 2023-06-08 14:30:53 +09:00
scripts [FL-3346] fbt: added Flipper selection when multiple are connected over USB (#2723) 2023-06-08 13:47:27 +09:00
site_scons [FL-3346] fbt: added Flipper selection when multiple are connected over USB (#2723) 2023-06-08 13:47:27 +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 [FL-3330] fbt: added hooks for build & dist environments; added FW_ORIGIN_* macro for apps & SDK (#2705) 2023-05-30 01:40:56 +09:00
.gitmodules [FL-3285] Removed STM32CubeWB module (#2608) 2023-05-09 06:30:33 +09:00
.pvsconfig [FL-3055] Getter for application data path (#2181) 2023-03-02 03:57:27 +10:00
.pvsoptions [FL-3285] Removed STM32CubeWB module (#2608) 2023-05-09 06:30:33 +09:00
CODE_OF_CONDUCT.md Code of Conduct (#739) 2021-10-02 20:32:18 +03:00
CODING_STYLE.md Change camelCase to PascalCase in code style (#2329) 2023-01-29 12:53:35 +07:00
CONTRIBUTING.md Fixing various typos in readme files #2208 2022-12-28 23:30:20 +09:00
fbt [FL-3285] Removed STM32CubeWB module (#2608) 2023-05-09 06:30:33 +09:00
fbt_options.py [FL-3330] fbt: added hooks for build & dist environments; added FW_ORIGIN_* macro for apps & SDK (#2705) 2023-05-30 01:40:56 +09:00
fbt.cmd [FL-3285] Removed STM32CubeWB module (#2608) 2023-05-09 06:30:33 +09:00
firmware.scons [FL-3330] fbt: added hooks for build & dist environments; added FW_ORIGIN_* macro for apps & SDK (#2705) 2023-05-30 01:40:56 +09:00
LICENSE Add LICENSE (#644) 2021-08-13 21:19:42 +03:00
ReadMe.md [FL-3302] ble: attempt to handle hardfaulted c2 (#2653) 2023-05-09 13:06:44 +09:00
SConstruct [FL-3346] fbt: added Flipper selection when multiple are connected over USB (#2723) 2023-06-08 13:47:27 +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.

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 (coming soon). 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.

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
  • assets - assets used by applications and services
  • furi - Furi Core: OS-level primitives and helpers
  • 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, see ReadMe.md files inside those directories for further details.

Links