1
0
mirror of https://github.com/UberGuidoZ/Flipper.git synced 2024-12-30 18:30:11 +00:00
Flipper/GPIO/ReadMe.md

13 KiB

Documenting adventures with the GPIO...

Official GPIO layout created by Aleksandr Kutuzov. Official documentation is here!

Connect an external CC1101 to your Flipper

Check out this excellent guide from quen0n on the hardware and configurations needed to increase your SubGHz range!

Sentry Safe plugin pinout

Plugin by H4ckd4ddy

(Flipper) 8/GND -> Black wire (Safe)
(Flipper) 15/C1 -> Green wire (Safe)

NRF24L01+ / Mousejack pinout - 8-pin

Plugin by mothball187 | Affected devices from Bastille research

More info from RogueMaster and Unleashed. (Both include the plugin in their firmware releases.)

2/A7 on FZ goes to MOSI/6 on NRF24
3/A6 on FZ goes to MISO/7 on NRF24
4/A4 on FZ goes to CSN/4 on NRF24
5/B3 on FZ goes to SCK/5 on NRF24
6/B2 on FZ goes to CE/3 on NRF24
8/GND on FZ goes to GND/1 on NRF24
9/3V3 on FZ goes to VCC/2 on NRF24
IRQ/8 is left disconnected on NRF24

NRF_Pins

If the nRF model is acting a bit flakey, try adding a capacitor to the vcc/gnd lines! I've not tried the Plus model so it may have a bigger need for a cap. Otherwise, I haven't had any major issues. Anything from a 3.3 uF to 10 uF should do. (Watch your positive/negative placement! Negative to ground.) I learned if you wanna get fancy, include a 0.1 uF cap in parallel. The 3.3 uF to 10 uF will respond to slow freq changes while the 0.1 uF will respond to the high freq switching spikes that the larger one cannot. That said, a single 10 uF will likely suffice for the Mousejack attack. ¯\_(ツ)_/¯

NRF_Capacitor Cap_parrallel

NRF24L01+ (B) - 10-pin

NRF24L01+_B

Thank you to Amec0e for the information on the newer NRF24L01 (B)!

NRF24: 1 (CE) to FZ 6 (B2)
NRF24: 2 (SCK) to FZ 5 (B3)
NRF24: 3 (CSN) to FZ 4 (A4)
NRF24: 4 (MOSI) to FZ 2 (A7)
NRF24: 6 (MISO) to FZ 3 (A6)
NRF24: 7 or 8 (GND) to FZ GND (8 or 11 or 18)
NRF24: 9 or 10 (VCC) to FZ 9 (3v3)

ESP32-WROOM

ESP32-WROOM

NOTE: Use old_hardware.bin if flashing Marauder onto the ESP32-WROOM (thanks wyldgoat!)
Easy Flasher (Windows / Linux / Mac) available here.

wyldgoat
bobo_dudu

ESP32 / ESP32-WROOM Pinout to Flipper Zero

(Thanks E_Surge and wyldgoat for guidance!)
NOTE: Make sure you're using at least an ESP32 v2 or above for full functionality! Good read.
Running an ESP32 single-core and want Marauder? You've gotta head over to V0lk3n's write-up!

ESP32: 3 (RX0) -> FZ: 13 or 15 (these are TX pins)
ESP32: 1 (TX0) -> FZ: 14 or 16 (these are RX pins)
ESP32: GND -> FZ: 8 or 11 or 18 (GND)
ESP32: 5V -> FZ: 1 (5V) OR ESP32: 3.3V -> FZ: 9 (3.3V)
NOTE: Make sure to enable 5v under GPIO on the Flipper

Switch between UART Pins 13/14 and 15/16 setting in FlipperZero
(GPIO -> USB-UART Bridge -> LEFT -> UART Pins)

ESP8266

ESP8266

If you have the ESP8266 and are looking to use a wifi deauth, check out speexvocon's easy web flasher!
If you're looking to give another deauther a try, check out HEX0DAYS repo over here.

ESP8266 Pinout to Flipper Zero

(Thanks PixelHerstel for additional guidance!)

ESP8266: 1 (TX0) -> FZ: 14 or 16 (these are RX pins)
ESP8266: 3 (RX0) -> FZ: 13 or 15 (these are TX pins)
ESP8266: 5 -> FZ: 7
ESP8266: 6 -> FZ: 6
ESP8266: 7 -> FZ: 5
ESP8266: 8 -> FZ: 4
ESP8266: VIN -> FZ: 1
ESP8266: GND -> FZ: 8 or 11 (GND)
FZ: 16 -> FZ: 18 (yes, FZ to FZ)
ESP8266: 5V -> FZ: 1 (5V)
NOTE: Make sure to enable 5V under GPIO on the Flipper
OR ESP32: 3.3V -> FZ: 9 (3.3V) though this can have issues...

Switch between UART Pins 13/14 and 15/16 setting in FlipperZero
(GPIO -> USB-UART Bridge -> LEFT -> UART Pins)

A visual pinout can be seen in this PDF, too.

ESP32-S2 WROVER

ESP32-S2WROVER

ESP32-S2 WROVER Pinout (thanks max_fpv_austria!)

ESP32: 44 (RX0) -> FZ: 13 or 15 (these are TX pins)
ESP32: 43 (TX0) -> FZ: 14 or 16 (these are RX pins)
ESP32: GND -> FZ: 8 or 11 or 18 (GND)
ESP32: 3.3V -> FZ: 9 (3.3V)

Switch between UART Pins 13/14 and 15/16 setting in FlipperZero
(GPIO -> USB-UART Bridge -> LEFT -> UART Pins)

Picture includes wiring pinout for the SD card mod too!

ESP32-CAM (Camera) - FAP FILE HERE!

ESP32-CAM

ESP32-CAM Pinout to Flipper Zero

CAM32: 1 (RX0) -> FZ: 13 or 15 (these are TX pins)
CAM32: 2 (TX0) -> FZ: 14 or 16 (these are RX pins)
CAM32: 3 (GND) -> FZ: 8 or 11 or 18 (GND)
CAM32: 4 (3.3V) -> FZ: 9 (3.3V) OR ESP32: 5V -> FZ: 1 (5V)

LoRa ESP32 Wifi (Wifi + Bluetooth + LoRa 433 MHz)

WIFI_LoRa_ESP32 to F0

LoRa ESP32 Wifi Pinout to Flipper Zero

LoRa32: 1 (RX0) -> FZ: 13 or 15 (these are TX pins)
LoRa32: 2 (TX0) -> FZ: 14 or 16 (these are RX pins)
LoRa32: 3 (GND) -> FZ: 8 or 11 or 18 (GND)
LoRa32: 4 (3.3V) -> FZ: 9 (3.3V)

Switch between UART Pins 13/14 and 15/16 setting in FlipperZero
GPIO -> USB-UART Bridge -> LEFT -> UART Pins

Raspberry Pi Zero UART

Rpi_Zero_GPIO

Raspberry Pi Zero : Prerequisite

Mount your SD Card to your computer and add the following line at the end of /boot/config.txt file.

enable_uart=1

Additionally you can look at the baudrate in the /boot/cmdline.txt file, which should be 115200 by default.

Raspberry Pi Zero : Pinout to Flipper Zero

PiZero: 4 (5V) -> FZ: 1 (5V)
PiZero: 6 (GND) -> FZ: 11 (GND)
PiZero: 8 (UART0_TXD) -> FZ: 14 (RX)
PiZero: 10 (UART0_RXD) -> FZ: 13 (TX)

HC-SR04 Ultrasonic Distance Sensor

Plugin by Sanqui: https://github.com/Sanqui/flipperzero-firmware/blob/hc_sr04/applications/hc_sr04/hc_sr04.c

HC-SR04

HC-SR04: 1 (RX0) -> FZ: 13 or 15 (these are TX pins)
HC-SR04: 2 (TX0) -> FZ: 14 or 16 (these are RX pins)
HC-SR04: 3 (GND) -> FZ: 8 or 11 or 18 (GND)
HC-SR04: 4 (5V)  -> FZ: 1 (5V)

Switch between UART Pins 13/14 and 15/16 setting in:
Flipper -> GPIO -> USB-UART Bridge -> LEFT -> UART Pins

HC-SR04


NMEA 0183 GPS

https://github.com/ezod/flipperzero-gps

GPIO pins 9 (3.3V), 11 (GND), 13 (TX), and 14 (RX)

GPS NMEA 0183


i2c Tools (by NaejEL)

C0 -> SCL / C1 -> SDA / GND -> GND | 3v3 logic levels only!

https://github.com/NaejEL/flipperzero-i2ctools


HTU21D / SI7021 Temperature Sensor

HTU21D

GPIO pins 9 (3.3V), 11 (GND), 15 (sda), and 16 (scl)

https://github.com/Mywk/FlipperTemperatureSensor Temperature Sensor - HTU21D / SI7021


AM2320/AM2321 Temp. Sensor

GPIO pins 9 (3.3V), 11 (GND), 15 (sda), and 16 (scl)

https://github.com/xMasterX/AM2320_Flipper_Plugin Connection


DHT11/22 Temp. Sensor

VCC (none, +, VCC, red wire)	1 (5V) or 9 (3V3)
GND (-, GND, black wire)	8, 18 (GND)
DATA (OUT, S, yellow wire)	2-7, 10, 12-17 (to choose from)

https://github.com/quen0n/FipperZero-DHT-Monitor

UHF RFID YRM100 (FAP / App here)

YRM100: 1 (VCC) -> FZ: 1 (5V)
YRM100: 2 (RXD) -> FZ: 13 or 15 (these are TX pins)
YRM100: 3 (TXD) -> FZ: 14 or 16 (these are RX pins)
YRM100: 4 (EN)  -> FZ: 9 (3.3V)
YRM100: 5 (GND) -> FZ: 8 or 11 or 18 (GND)

Switch between UART Pins 13/14 and 15/16 setting in:
Flipper -> GPIO -> USB-UART Bridge -> LEFT -> UART Pins

Also make sure to enable 5V in Flipper -> GPIO

Pinout Schematic Front Back

Credit: RekordNadoev / Issue 515

ServoTester (Info/App)

VCC (none, +, VCC, red wire) -> Flipper 1 (5V)
GND (-, GND, black/brown wire) -> Flipper 8 OR 18 (GND)
DATA (OUT, S, yellow wire) -> Flipper 2

Make sure to enable 5V in Flipper -> GPIO

Servo

Credit: RekordNadoev / Issue 515

Custom PCB's

Here's some repo's with designs for custom PCB's you can order or build using a prototype board.

DrB0rk
AWOK
Speexvocon (ESP Expansion and Header Extender)
ushastoe
TheOtherLonestar
Oleksii Kutuzov


Donation Information

Nothing is ever expected for the hoarding of digital files, creations I have made, or the people I may have helped.

I've had so many asking for me to add this.
Flipper_Blush Flipper_Love

BTC: 3AWgaL3FxquakP15ZVDxr8q8xVTc5Q75dS
BCH: 17nWCvf2YPMZ3F3H1seX8T149Z9E3BMKXk
ETH: 0x0f0003fCB0bD9355Ad7B124c30b9F3D860D5E191
LTC: M8Ujk52U27bkm1ksiWUyteL8b3rRQVMke2
PayPal: uberguidoz@gmail.com

So, here it is. All donations of any size are humbly appreciated.
Flipper_Clap Flipper_OMG

Donations will be used for hardware (and maybe caffeine) to further testing!
UberGuidoZ