Skip to content

Latest commit

 

History

History
266 lines (229 loc) · 15.1 KB

README.md

File metadata and controls

266 lines (229 loc) · 15.1 KB

Flipper Zero Files 0.3.1

This is a carefully curated collection of various Flipper Zero resources combined into a single repository for my own research and learning as a Computer Engineer and now AI Graduate Student.

First, I install the DarkFlippers' Unleashed firmware. Next, all relevent apps in the new official Flipper Labs Flipper App Store are installed. Finally, all the additional files here from the cfwFiles are then added for all the extra "goodies".

If you have a Flipper Zero device, I suggest the following:

  • Rule #1: Don't do anything stupid or illegal on any devices that are not YOUR OWN.
  • Rule #2: Know your appropriate governing agency's laws/regulations on Wireless Spectrum alocation. Here in the US, we have the FCC part 15 which deals with 'unlicensed' spectrum in various bands, included in which are:
    • 315MHz | 433 MHz | 915 MHz
  • I am also a radio Amateur, so I am afforded FCC Part 97 as well. YMMV.

If none of this makes sense to you, then you probably should not own or be using a Flipper Zero device.

Flipper Zero GPIO Pinout

FlipperGPIO

Image Source

This repo is divided into different folders:

  • cfwFiles contains a collection of files from each of the sources listed below, but are cleaned up and organized for use with my personal Flipper Zero device. This folder has been trimmed to get rid of non-flipper device files (see below) for minimum SD space requirements. README.md files have been preserved for credit along with any other file that describes functionality or ownership/contributorship.

    • The files in this folder are meant to be drop-in add-ons for the existing Unleashed Firmware, so it contains all the applications and other related files for all the latest functionality.
  • myFiles contains my personal remote codes from devices that are no longer working. This is for my personal research. Please use responsibly. These files are also already added to the cfwFiles folder.

  • fapSource contains all the Flipper App source code file from the various repositories I listed here. Any of this code should compile into a .fap application. I tried to keep everything organized for future reference. This may be interesting to someone (like me) interested in Flipper Zero application development.

  • otherFiles are any other Flipper Zero related files that are not mine, like 3D print case files, protoboard files, and things that do not need to get saved to the Flipper's SD Card.

Files not included in this repo are:

  • Animations.
  • Music.
  • Firmware Packages.

These items are irrelevent to my work and are easily found elsewhere.

Files in this repo that I did not create myself are also linked to below.

Firmware I use:

Flipper Zero Firmware Resources:

Flipper Zero Device Repo File Sources:

Apps and Scripts:

Flipper Zero DevBoard Sources:

Other Flipper Resources:

  • FZEEFlasher: An online web based GUI for flashing Flipper Zero and Dev Boards.
  • Momentum FW web installer for the new Momentum Firmware.
  • Derek Jamison's YouTube Playlist for Flipper Zero Sub-GHz describes some more advanced Sub-GHz signal capturing and playback.
  • CyberSecurityUP's Awesome Flipper Zero 2 : A collection of useful Flipper Zero resources.
  • TI CC1101 Data Sheet : Used for the FZ SubGHz Transceiver module.
    • Note the frequency limitations of the CC1101 according to the datasheet:
      • 300 - 348 MHz | 387 - 464 MHz | 779 - 928 MHz.
    • The TI CC1101 supports the following modulation schemes:
      • (G)FSK | 2(G)FSK | 4(G)FSK | ASK | OOK.
  • ST STM32WB55RG Overview and Data Sheet for the STM32 32-bit ARM Cortex-M4 64MHz MCU used for the Flipper Zero.
  • ST ST25R3916 Overview and Data Sheet for the High performance NFC universal device and EMVCo reader used for the Flipper Zero.
  • HCS301 Data Sheet for SubGHz KeeLoQ® Code Hopping Encoder for Remote Keyless Entry (RKE) Systems.

Flipper App Development:

Under Development:

  • Flipper Zero .fap Factory : A cloud-based one-click tool to build Flipper Zero .fap applications from git repositories. (used to work, currently says "under construction")
  • bigbrodude6119's Flipper Zero Evil Portal: not currently working with latest firmware (Update: has been integrated into Marauder CFW with the Marauder Companion App.)

My FZ SD Card File Structure:

/ext/ [FLIPPER SD (Unleashed CFW)]
│
├── apps/                           ## Put all your `.fap` files in one of these appropriate subfolders.
│   ├── Games/
│   ├── GPIO/
│   ├── Media/
│   ├── Main/
│   ├── Misc/
│   ├── NFC/
│   ├── Settings/
│   ├── Sub-GHz/
│   └── Tools/
│
├── apps_assets
│   ├── ble_spam
│   ├── crypto_dict
│   └── barcode_app
│
├── apps_data
│   ├── barcodes
│   ├── btremote_kodi
│   ├── flipper_xremote
│   └── subghz
│
├── apps_manifest
│   └── *.fim                       # each application *.fap has a manifest *.fim
│
├── badusb                          ## Put Rubber Ducky scripts here
│   └── demo_windows.txt            # Windows sample script
│
├── dolphin
│   ├── L1_Furippa1_128x64
│   │   ├── frame_x.bm              # Animation frame
│   │   └── meta.txt                # Set of rules for playing frames
│   └── manifest.txt                # Describes animation selection parameters
│
├── ibtnfuzzer
│   ├── example_uids_cyfral.txt
│   ├── example_uids_dallas.txt
│   └── example_uids_metakom.txt
│
├── iButton (1-Wire)
│   ├── Cyfral.ibtn                 # Cyfral key
│   ├── Dallas.ibtn                 # Dallas key
│   └── Metakom.ibtn                # Metakom key
│
├── infrared (IR)
│   ├── TV_bedroom.ir               # Samsung remote
│   ├── Apple_tv.ir                 # Apple tv remote
│   └── assets                      # Signal library folders
│       └── tv.ir
│
├── lfrfid (RFID)
│   ├── Em_marine.rfid              # EM4100 sample key 
│   ├── Hid_prox.rfid               # H10301 sample key EM4100
│   └── Indala.rfid                 # I40134 sample key
│
├── music_player                    ## List of tunes to play
│   ├── Arcede_Tones                # Sample tunes folder
│   └── Marble_Machine.fmf          # Sample tune
│
├── nfc
│   ├── Desfire.nfc                 # Desfire card
│   ├── Ntag_213.nfc                # Ntag_213 card
│   ├── Ntag_216.nfc                # Ntag_216 card
│   ├── Classik_1k.nfc              # Classik_1k card
│   ├── RocketBank.nfc              # Banking card
│   ├── UID.nfc                     # Card with only UID data
│   └── assets                      # NFC libraries
│       ├── aid.nfc
│       ├── country_code.nfc
│       ├── currency_code.nfc
│       └── mf_classic_dict.nfc
│
├── picopass                        ## App included w/ new CFW Firmware
│   ├── assets
│   │  └── iclass_elite_dict.txt
│   ├── iclass_decryptionkey.bin
│   └── iclass_key.bin
│
├── subghz                          ## This folder is for all SubGHz saved captures
│   ├── ****.sub                    # Captured packet
│   ├── ****_raw.sub                # Recorded raw signal
│   ├── Jamming_SubGHz              ## Sub-Folder containing scripts
│   │   ├── Jam_xxx.xx.sub          # ONLY use on your own devices!! (doesn't work good anyway, so don't get hopeful.)
│   │   └── Jam_xxx.xx.sub
│   ├── ****_raw.sub                # Recorded raw signal
│   └── assets
│       ├── dangerous_settings
│       ├── keeloq_mfcodes
│       ├── keeloq_mfcodes_user
│       ├── nice_flor_s
│       ├── last_subghz.settings
│       └── setting_user.example
│
├── subghz_remote
│   └── *.txt                       # remote file for `Sub-GHz Remote` app.
│
├── subplaylist
│   ├── Bruteforce_Gen
│   ├── CAME_12Bit_BF
│   └── Tesla
│
├── swd_scripts
│   └── *.swd
│
├── u2f
│   ├── assets
│   │   ├── cert.der                # Public certificate
│   │   └── cert_key.u2f            # Private key
│   ├── cnt.u2f # Key counter
│   └── key.u2f # Device key
│
├── unirf                           ## Place scripts for SubGHz UniRF here
│   ├── *.txt                       # example scripts for UniRF device.
│   └── **.txt
│
├── update                          ## Example Update Folders
│   ├── f7-update-0.101.2           # Example of Stable Release FW folder
│   └── f7-update-unlshd-073        # Example Of Unleashed FW Release Folder
│       ├── backup.tar              # Flipper configuration snapshot
│       ├── resources.tar 
│       ├── firmware.dfu
│       ├── radio.bin
│       ├── splash.bin
│       ├── updater.bin
│       └── update.fuf     
│
├── wav_player
│   └── example.wav                 # WAV files to play
│
├── Manifest                        # Resource files list
├── rwfiletest.bin                  # Created after running SD benchmark
└── favorites.txt                   # List of items displayed in Favorites

Status:

GitHub repo size

DISCLAIMER:

ONLY use this repo at your own risk on your own devices, and do not violate the law with any of these apps. You should only transmit on frequencies that you are authorized to do so. It is the final user's responsibility to obey all applicable local, state & federal laws. I assume no liability and are not responsible for any misuse or damage by you. In the US, refer to the FCC for radio spectrum info if you are unsure of that information. This repo is FOR EDUCATIONAL USE ONLY. If you get in trouble doing something stupid, especially jamming or causing interference, then YOU are the only one to blame. I have not been able to test everything in this repo yet, since this is a work in progress, so USE AT YOUR OWN RISK.