diff --git a/FAQ.md b/FAQ.md index b77e00c0..ef3dd005 100644 --- a/FAQ.md +++ b/FAQ.md @@ -21,14 +21,14 @@ - *It is written with information from the latest dev firmware, you may have to wait for a firmware (pre)release before some of the questions/answers become relevant.* - *This FAQ is still being worked on, and contributions are welcome.* -### Community +### Other Communities -- *If your question isn't answered here, you can search on this differents places :* +- *If your question isn't answered here, consider searching for it in other communities:* -- [Discord](https://flipperzero.one/discord) (check the pinned messages before asking there, the unique language here is in English) -- [Telegram](https://t.me/flipperzero) (Telegram used by russian Community) -- [Forum](https://forum.flipper.net/) (Multi language) -- [reddit](https://www.reddit.com/r/flipperzero/) (Multi language) +- [Discord](https://flipperzero.one/discord) (Check the pinned messages to see if you question was already answered, primarily English) +- [Telegram](https://t.me/flipperzero) (Russian) +- [Flipper Forum](https://forum.flipper.net/) (Multi-language) +- [Reddit](https://old.reddit.com/r/flipperzero/) (Multi-language) ## Meta [🔝](#top) @@ -50,18 +50,19 @@ ### This is really cool! Is there a way I can donate to you? > I really appreciate the kind words, however I'm not accepting personal monetary donations. -> If you're really insistent, I'll accept a Discord Nitro gift ([`@DJ#9822`](https://discord.gg/9rduBhctJ6)) or Steam Game ([`/id/djsime1`](https://steamcommunity.com/id/djsime1/))! +> If you're really insistent, I'll accept a Discord Nitro gift ([`@djsime1`](https://discord.gg/9rduBhctJ6)) or Steam Game ([`/id/djsime1`](https://steamcommunity.com/id/djsime1/))! > Besides that, why not support a local charity/organization instead? My personal recommendation is the [Electronic Frontier Foundation](https://supporters.eff.org/donate). ## General [🔝](#top) -### Where to buy a Flipper zero ? - -> - [https://shop.flipperzero.one/](https://shop.flipperzero.one/) -> - [https://lab401.com/](https://lab401.com/) -> - [https://flipp.dev/joom-catalog](https://flipp.dev/joom-catalog) +### Where can I buy a Flipper zero ? +> Below are official (re)sellers for the Flipper Zero. Any retailer not on this list may be selling the device deceptively! +> - [**Official Store** *https://shop.flipperzero.one/*](https://shop.flipperzero.one/) +> - [**Lab401** *https://lab401.com/*](https://lab401.com/) +> - [**Joom** *https://flipp.dev/joom-catalog*](https://flipp.dev/joom-catalog) +> To find out which of these retailers sell the Flipper Zero in your country, use this site: [https://flipperzero.one/how-to-buy](https://flipperzero.one/how-to-buy) ### What MicroSD Card should I use? > - It should be a reputable brand (Like SanDisk, Sony, etc.) because often cheaper cards don't fully support the communication protocol Flipper uses. @@ -79,12 +80,7 @@ > - For plugging the SD Card into your PC, drop files in their corresponding folders (The folder names are similar to the file extensions). ### How do I install applications and plugins? - -> Recently, in the 0.87.0, a catalog app has been released. You can download from it a lot of applications through the mobile application, or through this links on your computer : -- [https://lab.flipper.net/apps](https://lab.flipper.net/apps) -- [https://flipc.org/](https://flipc.org/) - -> Assuming the application has been packaged as a `.fap` file, installing it is as easy as placing it inside the `apps` directory on your Flipper's SD card. You can launch the app from the `Applications` app. If the app hasn't been compiled into a `.fap`, either *kindly* ask the author or compile it yourself. +> As of Firmware v0.87.0, applications can be easily side-loaded on the MicroSD card. These can be installed via the [Flipper mobile app](https://docs.flipper.net/mobile-app), or the online catalog at [https://lab.flipper.net/apps](https://lab.flipper.net/apps). ### How do I install custom firmwares? > First, ask yourself if you really need to. Sure, it might be fun to break out of Sub-GHz transmission restrictions, but how often are you actually going to do that? Is it really worth breaking the law? @@ -97,7 +93,8 @@ > For more information, read the [official documentation](https://docs.flipperzero.one/basics/firmware-update). ### Where and when are developer Q&A sessions held? -> Question and Answer session are held every week on Saturday, at 01:00 and 13:00 (GMT) +> **Maintainer note: Unsure if these are still held.** +> Question and Answer session are held every week on Saturday at 01:00 and 13:00 (GMT) on the [Flipper Discord](https://flipperzero.one/discord). > > | Time zone | Side A | Side B | > | :------------: | :-----: | :-----: | @@ -109,11 +106,12 @@ > | China Standard | 09:00 | 21:00 | > | India Standard | 06:30 | 18:30 | -### Are there archives of past Q&A sessions? + ### How do I write/compile my own applications/plugins/firmware/assets? +> **Maintainer note: this needs to be updated.**
(The following is a summary of the official FBT docs.)
Since the introduction of Flipper Build Tool (FBT), this has become very easy! You should have a basic understanding of working on a command line before proceeding. The only prerequisite install is Git. You should also have an IDE installed, VSCode is recommended since the firmware repo has config files for it. @@ -126,19 +124,20 @@ ### Can I make my own Flipper instead of buying one? > Probably not. While the firmware and schematics are mostly public, actually sourcing the components is extremely difficult. Multiple core pieces, such as the screen, were specifically produced to be used in Flipper manufacturing. -### How do I get a black-shell Flipper? -> This is no longer possible*, they were Kickstarter-backer exclusives. +### How do I get a black/clear-shell Flipper? +> This is no longer possible*, black-shells were Kickstarter-backer exclusives and clear-shells were a limited production run. > (*No longer possible unless you're willing to shill out hundreds of dollars for one on eBay.) ### How do I invert the screen/change backlight color/change case cover, etc. > These are all hardware mods, generally inaccessible to the average user. Look up/ask around on how to do them if you're really interested, [r/flipperzero](https://old.reddit.com/r/flipperzero/) is a good place to start. ### Will there be future hardware revisions? -> Technically speaking, there's going to be a **very minor** hardware revision in the near future. Functionally speaking, it will be identical to every other Flipper Zero already sold. The revision only replaces a few internal components and doesn't offer any new features compared to existing devices, so don't bother waiting to buy it. -> Besides that, there are concepts for a [Flipper One](https://flipperzero.one/one), but without a timeline for release. +> Regarding the Flipper Zero, no. There was a minor hardware revision in 2023 to address component shortages, but this changed nothing functionally. +> There are plans for a new device called the Flipper Nano, which is solely focused on being a hub for GPIO devices. It will not feature any internal radios (Sub-GHz, NFC, RFID, IR, etc.) like the Flipper Zero does, but will have double the GPIO pins. Check out [this video by Talking Sasquach](https://youtu.be/WB86ZOI6DAw) for more information. +> Long ago, there were concepts for a 'Flipper One,' which was rumored to be something akin to a Pi Zero with an SDR running Kali, however there's been no information nor confirmation of its development for quite some time. ### What is Dummy Mode? -> Currently, it only allows the Snake game to be opened when active. In the future, it will hide every app except games, in case your device is ever inspected or seized. +> Dummy mode is a basic toggle to make the Flipper appear like a hand-held toy/game device by remapping the buttons to launch specific apps from the desktop instead of opening the app list. ### My device is frozen, how do I reboot/fix it? > - To reboot the device: hold the BACK and LEFT buttons, then release simultaneously. If that didn't work, *disconnect the USB cable* and hold BACK for 30 seconds. This will preform a normal reboot. @@ -218,16 +217,6 @@ Once you have the CLI open, type log and press enter to start watching logs. Press Ctrl-C or Cmd-C to exit log mode.
-### How can I tell if I'm running the Iceman edition firmware? -
- From the idle screen, press right to open your Flipper's passport. - Check for the Iceman logo on the left, like in this screenshot: -
- (Click to reveal screenshot) - Iceman firmware screenshot -
-
- ## Sub-GHz [🔝](#top) @@ -269,7 +258,7 @@ ### Can I attach a more powerful antenna? > Yes and no. You can't just attach any antenna directly via the GPIO pins, however you could use a separate processor on a protoboard and control it from Flipper, assuming you write your own code to do that. -> For example, you could write your own code on a NRF24 and accompanying Flipper app to control it over GPIO. +> For example, you could write your own code on a NRF24 and accompanying Flipper app to control it over GPIO. @@ -298,6 +287,7 @@ ### How do I identify which type of card/tag I have? > To determine the protocol (NFC, RFID, or iClass/PicoPass) you'll need to attempt reading in each corresponding app. If nothing works, check the tag/card for any markings or indications. As a last resort, take a picture of the card/fob and the reader and ask in the [Flipper Discord server](https://flipperzero.one/discord). +> If you have access to the card reader, you can use the [RFID Detector app](https://lab.flipper.net/apps/nfc_rfid_detector) to determine whether it's looking for a high-frequency (NFC/iClass/PicoPass) or low-frequency (RFID) card. ### How do I identify which type of NFC tag I have? > Run the "Read card" action in the NFC app. Only NFC-A type tags are supported (Mifare/NTAG/Some EMV). @@ -318,7 +308,7 @@ ### What does it mean when no sectors could be read on a Mifare Classic? > The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. > If no sectors were read, then Flipper's dictionary attack has failed to find any valid keys. -> If you know the keys, you can manually input them under the "Extra Actions" menu of the NFC app. Otherwise, try attacking the reader with mfkey32v2 as described a few questions down. +> If you know the keys, you can manually input them under the "Extra Actions" menu of the NFC app. Otherwise, try attacking the reader with mfkey32 as described a few questions down. ### What does it mean when some but not all sectors could be read on a Mifare Classic? > The data on Mifare Classic cards is split up into sectors, and each sector is protected by two keys. @@ -326,8 +316,8 @@ > Even if not all sectors were read, you should inspect the dump with the mobile app to see if the missing data is necessary or not. In a few rare cases, semi-read cards can be emulated in place of the original without issue. > If you still need the rest of the keys, read the next question. -### How to I get Mifare Classic keys from a reader with [mfkey32v2](https://github.com/equipter/mfkey32v2)? -> (WIP, Note to self: https://regex101.com/r/iXmE2N/2) +### How to I get Mifare Classic keys from a reader? (mfkey32 attack) +> Read this documentation article: [https://docs.flipper.net/nfc/mfkey32](https://docs.flipper.net/nfc/mfkey32) ### Why isn't Mifare Classic emulation working? > Flipper emulates Mifare Classics according to official specification docs (at 13.56 mhz), however certain card readers operate at slightly different frequencies (such as 13.50 mhz). Since Flipper is unable to detect the frequency (like a real card does), it also can't correct for these minor errors. @@ -369,6 +359,8 @@ > - Common RFID Standards and protocols: https://www.asiarfid.com/common-rfid-standards-and-protocols.html > - RFID Standards: ISO, IEC, EPCglobal: https://www.electronics-notes.com/articles/connectivity/rfid-radio-frequency-identification/standards-iec-iso-epcglobal.php + + ## Infrared [🔝](#top) ### How do I add more devices to the "Universal Remotes" menu? @@ -398,7 +390,13 @@ ## WiFi board [🔝](#top) -> *(WIP)* -https://update.flipperzero.one/builds/blackmagic-firmware/ -https://github.com/SkeletonMan03/FZEasyMarauderFlash +### What can I do with the Wi-Fi dev board? +> Since the WiFi dev board is an entirely separate computer from the Flipper, certain tasks can be offloaded from the Flipper and run on the integrated ESP32 chip instead. There are two primary use cases for the dev board so far: +> - [Blackmagic firmware (for debugging firmware/apps on the Flipper)](https://docs.flipper.net/development/hardware/wifi-developer-board) +> - [Marauder firmware (for performing basic Wi-Fi attacks, please don't use this maliciously)](https://github.com/justcallmekoko/ESP32Marauder/wiki/flipper-zero) + +### How do I flash firmware to the dev board? +> - Flashing Blackmagic: [Use ufbt](https://docs.flipper.net/development/hardware/wifi-developer-board/update). +> - Flashing Marauder: [Choose one of these options](https://github.com/justcallmekoko/ESP32Marauder/wiki/update-firmware#using-spacehuhn-web-updater). +> - Flashing anything else: Use the [ESP Flasher app](https://lab.flipper.net/apps/esp_flasher) or [ESPWebTool](https://esp.huhn.me/). diff --git a/Firmwares.md b/Firmwares.md index c429dbbb..c4e0cdbf 100644 --- a/Firmwares.md +++ b/Firmwares.md @@ -106,7 +106,7 @@
  • Allows Sub-GHz extended frequency range (i.e. restaurant pagers) through Xtreme Settings App.
  • Allows changing Flipper's name via Xtreme Settings App
  • Has Sub-GHz protocols and most of the other changes taken from Unleashed FW (see changes).
  • -
  • Adds extra custom assets (Mifare classic dict, 18+ animations (installed separately), example files, etc).
  • +
  • Adds extra custom assets (Mifare classic dict, more animations (installed separately), example files, etc).
  • Includes an enhanced/improved "Dolphin Level" system similar to RogueMaster.
  • Includes extra apps and plugins from the general community through SD Application loader (FAP files).
  • Also includes a number of other small tweaks, changes, and stability fixes.