unleashed-firmware/ReadMe.md

142 lines
7.2 KiB
Markdown
Raw Normal View History

2022-03-23 23:30:34 +03:00
# Flipper Zero Unleashed Firmware
2020-09-17 10:43:04 +03:00
2022-03-23 23:30:17 +03:00
<a href="https://ibb.co/wQ12PVc"><img src="https://i.ibb.co/wQ12PVc/fzCUSTOM.png" alt="fzCUSTOM" border="0"></a>
2020-08-01 22:54:58 +03:00
2022-05-27 22:59:18 +03:00
Welcome to Flipper Zero's Custom Firmware repo!
Our goal is to make any features possible in this device without any limitations!
2022-08-03 00:32:55 +03:00
Please help us implement emulation for all subghz dynamic (rolling code) protocols and static code brute-force app!
2022-06-02 02:15:39 +03:00
<br>
2022-05-27 22:59:18 +03:00
### This software is for experimental purposes only and is not meant for any illegal activity/purposes. <br> We do not condone illegal activity and strongly encourage keeping transmissions to legal/valid uses allowed by law. <br> Also this software is made without any support from Flipper Devices and in no way related to official devs.
2022-05-27 22:59:18 +03:00
<br>
Our Discord Community:
<br>
<a href="https://discord.gg/58D6E8BtTU"><img src="https://discordapp.com/api/guilds/937479784148115456/widget.png?style=banner4" alt="Unofficial Discord Community"></a>
2022-06-02 02:15:39 +03:00
<br>
<br>
<br>
2022-07-29 19:35:36 +03:00
# What's changed
* SubGHz regional TX restrictions removed
2022-07-29 19:22:17 +03:00
* SubGHz frequecy range can be extended in settings file (Warning: It can damage flipper's hardware)
2022-07-29 19:35:36 +03:00
* Many rolling code protocols now have the ability to save & send captured signals
2022-07-10 03:47:36 +03:00
* FAAC SLH (Spa) & BFT Mitto (secure with seed) manual creation
2022-07-29 19:22:17 +03:00
* Custom community plugins and games added
2022-07-29 19:35:36 +03:00
* Extra SubGHz frequencies + extra Mifare Classic keys
* Picopass/iClass plugin included in releases
2022-07-13 16:52:49 +03:00
* Recompiled IR TV Universal Remote for ALL buttons
2022-07-29 19:35:36 +03:00
* Other small fixes and changes throughout
2022-07-10 03:47:36 +03:00
2022-07-10 04:09:32 +03:00
See changelog in releases for latest updates!
2022-07-10 03:58:09 +03:00
2022-07-10 03:47:36 +03:00
### Current modified and new SubGhz protocols list:
2022-07-15 10:26:05 +03:00
- HCS101
- An-Motors
2022-07-10 03:47:36 +03:00
- CAME Atomo
2022-08-03 00:32:55 +03:00
- FAAC SLH (Spa) [if cloning existing remote - external seed calculation required]
- BFT Mitto [if cloning existing remote - external seed calculation required]
2022-07-29 19:52:37 +03:00
- Keeloq (+ proper manufacturer codes selection) [Not ALL systems supported yet!]
2022-07-10 03:47:36 +03:00
- Nice Flor S
2022-08-03 00:32:55 +03:00
- Security+ v1 & v2
2022-07-10 03:47:36 +03:00
- Star Line
2022-08-03 00:32:55 +03:00
### Community apps included:
- ESP8266 Deauther plugin [(By SequoiaSan)](https://github.com/SequoiaSan/FlipperZero-Wifi-ESP8266-Deauther-Module)
- WiFi Scanner plugin [(By SequoiaSan)](https://github.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module)
2022-07-29 19:22:17 +03:00
- UPC-A Barcode generator plugin [(By McAzzaMan)](https://github.com/McAzzaMan/flipperzero-firmware/tree/UPC-A_Barcode_Generator/applications/barcode_generator)
- GPIO: Sentry Safe plugin [(By H4ckd4ddy)](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin)
- ESP32: WiFi Marauder companion plugin [(By 0xchocolate)](https://github.com/0xchocolate/flipperzero-firmware-with-wifi-marauder-companion)
- NRF24: Sniffer & MouseJacker (with changes) [(By mothball187)](https://github.com/mothball187/flipperzero-nrf24/tree/main/mousejacker)
- HID Analyzer [(By Ownasaurus)](https://github.com/Ownasaurus/flipperzero-firmware/tree/hid-analyzer/applications/hid_analyzer)
- Clock/Stopwatch (with small fixes) [(By CompaqDisc, Stopwatch & Sound Alert By RogueMaster)](https://github.com/RogueMaster/flipperzero-firmware-wPlugins/blob/unleashed/applications/clock_app/clock_app.c)
- UniversalRF Remix (with changes)(only RAW subghz files) [(By ESurge)(Original UniversalRF By jimilinuxguy)](https://github.com/ESurge/flipperzero-firmware-unirfremix)
- Tetris (with fixes) [(By jeffplang)](https://github.com/jeffplang/flipperzero-firmware/tree/tetris_game/applications/tetris_game)
- Spectrum Analyzer (with changes) [(By jolcese)](https://github.com/jolcese/flipperzero-firmware/tree/spectrum/applications/spectrum_analyzer) - [Ultra Narrow mode & scan channels non-consecutively](https://github.com/theY4Kman/flipperzero-firmware/commits?author=theY4Kman)
- Arkanoid (with fixes) [(By gotnull)](https://github.com/gotnull/flipperzero-firmware-wPlugins)
- Tic Tac Toe (with fixes) [(By gotnull)](https://github.com/gotnull/flipperzero-firmware-wPlugins)
2022-06-02 02:15:39 +03:00
2022-07-29 19:22:17 +03:00
### Other changes
- BadUSB Keyboard layouts [(By v1nc)](https://github.com/v1nc/flipperzero-firmware)
2022-06-02 02:15:39 +03:00
2022-06-26 21:46:17 +03:00
## Support us so we can buy equipment and develop new features
* ETH/BSC/ERC20-Tokens: `0xFebF1bBc8229418FF2408C07AF6Afa49152fEc6a`
* BTC: `bc1q0np836jk9jwr4dd7p6qv66d04vamtqkxrecck9`
* DOGE: `D6R6gYgBn5LwTNmPyvAQR6bZ9EtGgFCpvv`
* LTC: `ltc1q3ex4ejkl0xpx3znwrmth4lyuadr5qgv8tmq8z9`
2022-07-29 19:22:17 +03:00
**Big thanks to all sponsors!**
2022-07-10 03:47:36 +03:00
# Instructions
## [- How to install firmware](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/HowToInstall.md)
2022-06-26 21:46:17 +03:00
2022-07-10 03:48:50 +03:00
## [- How to build firmware](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/HowToBuild.md)
2022-07-10 03:47:36 +03:00
2022-07-29 19:22:17 +03:00
## [- BadUSB: how to use different keyboard layouts](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/BadUSBLayouts.md)
### **Plugins**
2022-07-29 19:22:17 +03:00
2022-07-10 03:47:36 +03:00
## [- Configure UniversalRF Remix App](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/UniRFRemix.md)
2022-06-02 02:15:39 +03:00
## [- Barcode Generator](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/BarcodeGenerator.md)
2022-07-29 19:22:17 +03:00
### **Plugins that works with external hardware**
2022-07-29 19:22:17 +03:00
## [- How to use: [NRF24] plugins](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/NRF24.md)
2022-07-29 19:22:17 +03:00
## [- How to use: [WiFi] Scanner](https://github.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module#readme)
## [- How to use: [ESP8266] Deauther](https://github.com/SequoiaSan/FlipperZero-Wifi-ESP8266-Deauther-Module#readme)
## [- How to use: [ESP32] WiFi Marauder](https://github.com/UberGuidoZ/Flipper/tree/main/Wifi_DevBoard)
## [- Windows: How to Upload .bin to ESP32/ESP8266](https://github.com/SequoiaSan/Guide-How-To-Upload-bin-to-ESP8266-ESP32)
## [- How to use: [GPIO] SentrySafe plugin](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/SentrySafe.md)
### **SubGHz**
2022-07-29 19:22:17 +03:00
2022-08-03 00:32:55 +03:00
## [- Transmission is blocked? - How to extend SubGHz frequency range](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/DangerousSettings.md)
2022-07-29 19:22:17 +03:00
## [- How to add extra SubGHz frequencies](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/SubGHzSettings.md)
2022-06-02 02:15:39 +03:00
<br>
<br>
2022-06-26 21:46:54 +03:00
2022-07-29 19:22:17 +03:00
# Where I can find IR, SubGhz, ... files, DBs, and other stuff?
2022-07-10 03:47:36 +03:00
## [Awesome Flipper Zero - Github](https://github.com/djsime1/awesome-flipperzero)
## [UberGuidoZ Playground - Large collection of files - Github](https://github.com/UberGuidoZ/Flipper)
2022-06-04 03:18:43 +03:00
2022-07-10 03:47:36 +03:00
<br>
<br>
2022-06-04 03:18:43 +03:00
2020-08-15 09:59:22 +03:00
# Links
2022-05-27 22:59:18 +03:00
* Unofficial Discord: [discord.gg/58D6E8BtTU](https://discord.gg/58D6E8BtTU)
2022-07-25 14:01:56 +03:00
* Docs by atmanos / How to write your own app (outdated API): [https://flipper.atmanos.com/docs/overview/intro](https://flipper.atmanos.com/docs/overview/intro)
2022-05-27 22:59:18 +03:00
2022-06-02 02:15:39 +03:00
* Official Docs: [http://docs.flipperzero.one](http://docs.flipperzero.one)
2022-05-27 22:59:18 +03:00
* Official Forum: [forum.flipperzero.one](https://forum.flipperzero.one/)
2021-08-08 21:03:25 +03:00
# Project structure
- `applications` - Applications and services used in firmware
- `assets` - Assets used by applications and services
- `furi` - 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...
- `site_scons` - Build helpers
- `scripts` - Supplementary scripts and python libraries home
Also pay attention to `ReadMe.md` files inside of those directories.