Mirrors/unleashed-firmware
2
0
Fork 0
mirror of https://github.com/DarkFlippers/unleashed-firmware synced 2024-11-23 13:03:13 +00:00
Code Issues Projects Releases Packages Wiki Activity

Merge branch 'master' into printf

Browse source
This commit is contained in:
aanper 2020-09-16 20:38:04 +03:00
commit ba835b941b
12 changed files with 172 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
.github/deploy_wiki.sh vendored
View file

@ -63,6 +63,12 @@ if [ ! -r "$tmp_dir/Home.md" ]; then
rsync -q -a "$GITHUB_WORKSPACE/README.md" "$tmp_dir/Home.md"
fi
debug "Rewriting images path to absolute"
(
cd "$tmp_dir" || exit 1
find . -type f -exec sed -Ei 's@([ (])([^( ]+)(\/wiki_static\/.+?\.(png|jpe?g|svg)[ \)])@\1https://github.com/Flipper-Zero/flipperzero-firmware-community/raw/master\3@' {} \;
)
debug "Committing and pushing changes"
(
cd "$tmp_dir" || exit 1

2
.github/workflows/publish_wiki.yml vendored
View file

@ -4,6 +4,8 @@ name: Publish the wiki
on:
push:
branches: [ master ]
paths:
- 'wiki/**'
jobs:

5
.gitignore vendored
View file

@ -1,4 +1,7 @@
.idea/
target_lo/build/
target_*/build/
bindings/
bindings/
# Visual Studio Code
.vscode/

113
wiki/applications/NFC.md
View file

@ -1,22 +1,115 @@
The NFC standard (ISO-14443) operates at 13.56MHz. We are going to use the ST25R3916 chip, the same chip as used in the HydraNFC project.
# NFC
Supported cards:
## Card detector
* ISO-14443 tag (mifare?) reading & writing & emulation
* Emulation — Mifare Classic & Ultralight
![](./../../wiki_static/NFC/nfc-card-detector.png)
Card type is often unknown. Card detector runs tests against the unknown card to determine it's type. These tests are not 100% accurate, but they help to start exploring. If the test finished successfully, it can recommend to run a suitable application for the card type.
### Card detector routine:
1. Check if card `ISO-14443` `A` or `B` or `FeliCa`
2. Check the 6 byte of `SAK` to determine if `ISO-14443-4` compliant
3. Match combination of UID, SAK, ATQA, ATS, ATR from database
4. Try to authenticate as Mifare, EMV, etc..
5. Return founded type and suggest suitable application or return error
## Reader detector
![](./../../wiki_static/NFC/nfc-wall-reader.png)
Wall readers usually looks the same, but may accept various types type of cards. With reader detector feature we can emulate dummy card on Flipper and sniff commands that reader send to card.
### Reader detector
1. Silently read WUPA (0x52) or REQA (0x26) without triggering SELECT on reader
2. Emulate dummy card
2.1 Answer on ATQA
2.2 Answer on SELECT
2.3 ...
3. Consistently emulate popular cards before valid authentication from reader found
## Reader mode
* Mifare classic reader _How to select dictionary?_
* Brute force
* Save dump
* Write dump to SD-card
* Mifare Ultralight reader
* Save dump
* Write dump?
* EMV reader
* Simple UID reader
## Write mode
## Write/Emulate mode
Saved dumps stored on SD-card and accessible from `Saved dumps` menu. All saved dumps can be emulated or written to card if possible. User can view dump info and choose the action:
* Emulate
* Write
* Edit? _(Editing big dumps can be can be difficult)_
# USB NFC Reader [Not implemented]
<img width="800" src="./../../wiki_static/NFC/usb-nfc-reader.png" />
There are many use cases that impossible to run directly on Flipper Zero. Most of these cases require powerful CPU for cryptographic attacks:
- Mifare classic attacks: `mfoc` (Nested), `mfcuk` (Dark Side)
- Mifare Plus attack: Hard Nested
We can use Flipper Zero as a regular USB NFC adapter along with `LibNFC` library, so all existing software will work out of the box without any modifications. This mode must be run from menu `NFC -> USB NFC adapter`. In this mode all commands from PC should be forwarded directly to NFC chip `ST25R3916` via USB serial interface.
# Schematic
![](./../../wiki_static/NFC/ST25R3916-schematic.png)
## Emulate mode
# Menu
![](./../../wiki_static/NFC/nfc-ui.png)
<!--- Menu structure -->
# NFC
# UI
## Detect card
### NFC
* Reader
* Emaulte
- Activating RF field and wait for card.
Run tests when card found.
- Found match
- Mifare Classic found.
Run Mifare reader?
- No found
- Cannot detect card type
## Reader detector
- Passive listen for WUPA/REQA-B
- Commands live stream
0x26
0x26
0x26
- Start active emulating
- .
- Mifare reader found
- .
- EMV reader found
## Read card
- Mifare Classic
- Mifare Ultralight
- EMV get PAN
- what more?
## Saved dumps
- mfc_a6b804bf
- home
- mfu_04bfac72
- emv_paywave_1007
## USB NFC Reader
- Activates instantly.
No more display updates
<!--- Menu structure end -->

36
wiki/hw/Hardware.md
View file

@ -0,0 +1,36 @@
# Hardware
## External GPIO Pinout
[](./../../wiki_static/hardware/gpio-pinout.jpeg)
| Pin | | | | | |
|-|-|-|-|-|-|
| PC0 | GPIO | LPUART RX | ADC1/2/3-1 | I²C SCL | |
| PC1 | GPIO | LPUART TX | ADC1/2/3-2 | I²C SDA | |
| PA4 | GPIO | DAC1-1 | ADC1/2-9 | SPI1 NSS | |
| PA5 | GPIO | DAC1-2 | ADC1/2-10 | SPI1 SCK | TIM2/8 OUT |
| PA6 | GPIO | | ADC1/2-11 | SPI1 MISO | TIM3/16 OUT |
| PA7 | GPIO | | ADC1/2-12 | SPI1 MOSI | TIM1/2/8/17 OUT |
| PB2 | GPIO | | | | RTC Alarm |
| PB12 | GPIO | | | | |
| PA9 | GPIO | USART1 TX | | | |
| PA10 | GPIO | USART1 RX | | | |
| PA13 | GPIO | SWDIO | | | |
| PA14 | GPIO | SWCLK | | | |
| PD2 | GPIO | UART5 RX | | | |
## Dev Kit F2B0C1.1
[](./../../wiki_static/hardware/dev-kit-f2b0c1.1.jpeg)
## [Hardware Specification](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Hardware-specification)
## Board releases
[F1B1C0.0](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Hardware-version-F1B1C0.0)
[F2B0C1.1](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Hardware-version-F2B0C1.1)

3
wiki_static/NFC/ST25R3916-schematic.png Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:cf3b36cb3db6c3552d241e7639f3a2b6858979f00ad8fda25bf7bfaa65bf317d
size 537771

3
wiki_static/NFC/nfc-card-detector.png Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:2af09e099308abf2d61ea0d3dc4326d30a2134c9b87b4aeb4678eadac96d17b5
size 46060

3
wiki_static/NFC/nfc-ui.png Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:35627515ecf8e96d5d28b5469fdf569b993981cda1240b921ca62f997e6ec099
size 338558

3
wiki_static/NFC/nfc-wall-reader.png Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:8764367c15252a9ff37514451af086a6c4d0adca7ec5b423643b730151388d53
size 88079

3
wiki_static/NFC/usb-nfc-reader.png Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:370ec74cbd8e37a5760ed03f19cf31bd135f021a88c4669a68f0705e7ecf0902
size 95362

3
wiki_static/hardware/dev-kit-f2b0c1.1.jpeg Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:9b8453a08fb9dc7510e887c749d28a8aadac7b96db91ec95efe0581f434650fb
size 369440

3
wiki_static/hardware/gpio-pinout.jpeg Normal file
View file

@ -0,0 +1,3 @@
version https://git-lfs.github.com/spec/v1
oid sha256:931cc6c1d5206745ee9dff78cb92b35fd8659cb33d19fcb0a5ac440e6bed6a13
size 134904