Flipper Zero Unleashed Firmware
Go to file
RebornedBrain fb9728d570
[FL-3772] Felica poller (#3570)
* New types for felica poller
* New functions for felica data transmissions
* Felica memory map extended with new fields
* Init/deinit of mbedtls context added for felica encryption
* Functions for session key and mac calculations added
* Raw felica_poller implementation added
* Removed MAC type parameter from check_mac function
* Replaced all data fields needed for auth with context structure
* Clean up felica_poller.c
* Now RC block is filled with random numbers
* New parameter for counting well-read blocks
* Some cleanups
* Felica file save and load logic added
* Now we use card key from context for session key calculation
* Copying card key to card block from auth context when both authentications succeeded, otherwise decrement blocks count by 1
* New felica poller event added
* Moved some data structions to public namespace
* FelicaAuthenticationContext struct moved to felica.h
* Field type and name changed for better ones
* Helper functions for felica_auth added to the app
* New scene for felica card key input added
* Logic for felica key input added
* Auth context request processing added
* Added block index definitions and replaced all index numbers with them
* More macro defines
* Replace nesting with do while block
* New function for write operations mac calculation added
* Replace nesting with do while block
* Make functions static for now because they are used internally
* Wrote some comments
* Raw felica render implementation
* New felica scenes
* Adjusted felica dump rendering according design requirements
* New felica scene added
* Helper for switching scene during unlock added
* Added warning scene and transfer to it
* Moved unlock scene logic to separate files
* Magic number changed
* New felica render logic
* Felica scenes adjusted according to design requirements
* Felica poller cleanups
* Some asserts added and some fixed
* Replcaed asserts to checks in public api
* Fixed pvs warnings in felica_poller
* New event for felica_poller added for incomplete read actions
* Handling of new poller event added
* Update SConscript with felica files
* Update api_symbols.csv with felica functions
* Sync API versions

Co-authored-by: あく <alleteam@gmail.com>
2024-04-10 18:51:36 +09:00
.github github: additional pre-upload checks for doxygen workflow (#3526) 2024-03-25 15:51:09 +09:00
.vscode ufbt: fixes for generated vscode project (#3547) 2024-03-29 10:47:43 +09:00
applications [FL-3772] Felica poller (#3570) 2024-04-10 18:51:36 +09:00
applications_user [FL-2627] Flipper applications: SDK, build and debug system (#1387) 2022-09-15 02:21:03 +09:00
assets L1_Mods animation update : adding VGM visual (#3502) 2024-03-29 12:40:26 +09:00
documentation JS Documentation (#3535) 2024-04-09 18:06:37 +09:00
furi Furi: Add "out of memory" and "malloc(0)" crash messages (#3574) 2024-04-07 22:49:00 +09:00
lib [FL-3772] Felica poller (#3570) 2024-04-10 18:51:36 +09:00
scripts fbt: added -Wstrict-prototypes for main firmware (#3557) 2024-04-02 02:02:45 +09:00
site_scons fbt: added -Wstrict-prototypes for main firmware (#3557) 2024-04-02 02:02:45 +09:00
targets [FL-3772] Felica poller (#3570) 2024-04-10 18:51:36 +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-870] Auto-generated firmware documentation take two (#2944) 2024-03-06 15:25:21 +09:00
.pvsconfig Api Symbols: replace asserts with checks (#3507) 2024-03-19 23:43:52 +09:00
.pvsoptions [FL-3579, FL-3601, FL-3714] JavaScript runner (#3286) 2024-02-12 15:54:32 +07: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_options.py Update radio stack to v1.19.0 (#3545) 2024-04-09 16:01:55 +09:00
fbt.cmd Toolchain fixes (#3451) 2024-02-26 16:16:19 +04:00
firmware.scons ble: profile rework (#3272) 2024-02-16 14:20:45 +07:00
LICENSE Add LICENSE (#644) 2021-08-13 21:19:42 +03:00
ReadMe.md [FL-870] Auto-generated firmware documentation take two (#2944) 2024-03-06 15:25:21 +09:00
SConstruct fbt: fixed missing FBT_FAP_DEBUG_ELF_ROOT to dist env (#3563) 2024-04-02 20:30:42 +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
  • 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