flipperzero-firmware/README.md

74 lines
3.6 KiB
Markdown
Raw Normal View History

2020-08-15 06:59:22 +00:00
Welcome to the flipperzero-firmware wiki!
2020-08-01 19:54:58 +00:00
2020-08-15 06:59:22 +00:00
Flipper zero is open source multi-tool device for researching and pentesting radio protocols, access control systems, hardware, and more.
2020-08-01 19:47:07 +00:00
2020-08-15 06:59:22 +00:00
# Building
2020-08-01 19:47:07 +00:00
2020-08-17 09:02:31 +00:00
See [Building instructions](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Firmware#building)
2020-08-02 05:32:15 +00:00
2020-08-15 06:59:22 +00:00
# How to contribute
2020-08-02 05:25:17 +00:00
2020-08-15 06:59:22 +00:00
To contribute to code or to wiki make the following steps:
2020-08-02 05:25:17 +00:00
2020-08-15 06:59:22 +00:00
1. Read this wiki
2020-08-17 09:02:31 +00:00
2. Read [contribution guide](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Contributing)
2020-08-15 06:59:22 +00:00
3. Ensure you read and sign [Flipper CLA](https://cla-assistant.io/glitchcore/flipper-cla-host)
2020-08-17 09:02:31 +00:00
4. Read Flipper [Roadmap](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Flipper-roadmap)
2020-08-07 06:51:41 +00:00
2020-08-15 06:59:22 +00:00
# UI
2020-08-07 06:51:41 +00:00
2020-08-17 09:02:31 +00:00
Common UI feature (menu, screens, features) at [UI page](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/UI)
2020-08-07 06:51:41 +00:00
2020-08-15 06:59:22 +00:00
# Features
2020-08-07 06:51:41 +00:00
2020-08-17 09:02:31 +00:00
* [Basic Features](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Basic-features)
* [Sub-1 GHz radio](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Sub-1-GHz-radio) (Transceiver Based on CC1101 chip for 315/433/868 MHz)
* [125 kHz RFID](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/125-kHz-RFID)
* [Infrared](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Infrared)
* [iButton contact keys](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/iButton-contact-keys)
* [USB](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/USB)
* [Bluetooth](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Bluetooth)
* [GPIO/HW Modules](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/GPIO)
* [NFC](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/NFC)
* [U2F](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/U2F)
* [Tamagotchi](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Tamagotchi)
* [USB](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/USB)
* [Plugins](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Plugins)
2020-08-02 05:25:17 +00:00
2020-08-15 06:59:22 +00:00
# PlatformIO & Arduino
* Easy IDE deploying
* Cross platform HID device without drivers
* Ready to use library for LCD, Buttons, CC1101, GPIO, Infrared, 125khz, Bluetooth? NFC?
2020-08-02 05:25:17 +00:00
2020-08-15 06:59:22 +00:00
# Hardware
2020-08-02 05:25:17 +00:00
2020-08-17 09:02:31 +00:00
[Hardware specification](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Hardware-specification)
2020-08-15 06:59:22 +00:00
### Releases
All PCB releases named according to the following rules:
* `F` mean fw target. Different F-versions has different firmware.
* `B` mean body. Different B-versions has mechanical incompatibility. If B=0, PCB is not intended for installation in a case.
* `C` mean interConnections. If С=0, device contain single board and no interconnections. Otherwise, different C-versions is incompatible to each other.
* Number afer point mean sequential numbering of release.
List of releases:
2020-08-17 09:02:31 +00:00
* [Version 0 (F1B1C0)](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Hardware-version-F1B1C0.0)
* [Version 1 (F2B0C1)](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Hardware-version-F2B0C1.1)
2020-08-15 06:59:22 +00:00
### Hardware components
* LCD display [buydisplay.com](https://www.buydisplay.com/1-4-inch-graphic-128x64-lcd-module-serial-spi-st7565-black-on-white)
# Firmware
2020-08-17 09:02:31 +00:00
[Firmware description page](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Firmware)
2020-08-15 06:59:22 +00:00
# Links
* Project website: [flipperzero.one](https://flipperzero.one)
* Kickstarter page: [kickstarter.com](https://www.kickstarter.com/projects/flipper-devices/flipper-zero-tamagochi-for-hackers)
2020-08-17 09:02:31 +00:00
* Forum: [forum.flipperzero.one](https://forum.flipperzero.one/)