2022-08-03 09:13:27 +00:00
# Documenting adventures with the GPIO...
2022-07-14 23:40:33 +00:00
2022-09-24 02:34:19 +00:00
Official [GPIO layout ](https://miro.com/app/board/uXjVO_LaYYI=/ ) created by [Aleksandr Kutuzov ](https://discord.com/channels/740930220399525928/765282833744265246/993107060172542012 ). Official documentation [is here ](https://docs.flipperzero.one/gpio-and-modules )!< br >
2022-07-09 05:58:38 +00:00
2023-07-15 01:34:02 +00:00
# Connect an external CC1101 to your Flipper
Check out [this excellent guide ](https://github.com/quen0n/flipperzero-ext-cc1101 ) from quen0n on the hardware and configurations needed to increase your SubGHz range!
2022-08-04 16:45:24 +00:00
# Sentry Safe plugin pinout
Plugin by [H4ckd4ddy ](https://github.com/H4ckd4ddy/flipperzero-sentry-safe-plugin )
2022-07-09 05:58:38 +00:00
(Flipper) 8/GND -> Black wire (Safe)< br >
(Flipper) 15/C1 -> Green wire (Safe)
2022-08-12 00:19:21 +00:00
# NRF24L01+ / Mousejack pinout - 8-pin
2022-07-09 05:58:38 +00:00
2022-08-13 03:22:29 +00:00
Plugin by [mothball187 ](https://github.com/mothball187/flipperzero-nrf24 ) | Affected devices from [Bastille research ](https://www.bastille.net/research/vulnerabilities/mousejack/affected-devices )
2022-08-04 16:45:24 +00:00
More info from [RogueMaster ](https://github.com/RogueMaster/flipperzero-firmware-wPlugins/tree/unleashed/applications/mousejacker ) and [Unleashed ](https://github.com/Eng1n33r/flipperzero-firmware/blob/dev/documentation/NRF24.md ). (Both include the plugin in their firmware releases.)
2022-07-11 23:04:34 +00:00
2022-08-12 00:19:21 +00:00
2/A7 on FZ goes to MOSI/6 on NRF24< br >
3/A6 on FZ goes to MISO/7 on NRF24< br >
4/A4 on FZ goes to CSN/4 on NRF24< br >
5/B3 on FZ goes to SCK/5 on NRF24< br >
6/B2 on FZ goes to CE/3 on NRF24< br >
8/GND on FZ goes to GND/1 on NRF24< br >
9/3V3 on FZ goes to VCC/2 on NRF24< br >
IRQ/8 is left disconnected on NRF24
2022-07-11 00:56:49 +00:00
2022-07-11 00:57:41 +00:00
2022-07-11 23:04:34 +00:00
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. ¯\\\_(ツ)_/¯
2022-07-09 05:58:38 +00:00
2022-07-11 00:57:41 +00:00
2022-07-11 22:54:27 +00:00
2022-07-14 23:42:52 +00:00
2022-08-12 00:19:21 +00:00
# NRF24L01+ (B) - 10-pin
Thank you to [Amec0e ](https://github.com/amec0e ) for the information on the newer NRF24L01 (B)!
NRF24: 1 (CE) to FZ 6 (B2)< br >
NRF24: 2 (SCK) to FZ 5 (B3)< br >
NRF24: 3 (CSN) to FZ 4 (A4)< br >
NRF24: 4 (MOSI) to FZ 2 (A7)< br >
NRF24: 6 (MISO) to FZ 3 (A6)< br >
NRF24: 7 or 8 (GND) to FZ GND (8 or 11 or 18)< br >
NRF24: 9 or 10 (VCC) to FZ 9 (3v3)
2022-08-02 04:24:34 +00:00
# ESP32-WROOM
2022-07-14 23:42:52 +00:00
2022-08-02 04:24:34 +00:00
2022-07-17 05:19:32 +00:00
2023-01-04 06:29:53 +00:00
NOTE: Use `old_hardware.bin` if flashing Marauder onto the ESP32-WROOM (thanks wyldgoat!)< br >
[Easy Flasher (Windows / Linux / Mac) available here ](https://github.com/UberGuidoZ/Flipper/tree/main/Wifi_DevBoard/FZ_Marauder_Flasher/ESP32-WROOM ).
2022-08-02 04:24:34 +00:00
2022-08-03 07:43:22 +00:00
< br >
2022-10-05 06:17:36 +00:00
## ESP32 / ESP32-WROOM Pinout to Flipper Zero
2022-09-15 07:05:54 +00:00
(Thanks [E_Surge ](https://github.com/ESurge ) and wyldgoat for guidance!)< br >
2022-10-12 05:25:02 +00:00
NOTE: Make sure you're using at least an ESP32 v2 or above for full functionality! [Good read ](https://blog.spacehuhn.com/esp32-deauther ).< br >
Running an ESP32 single-core and want Marauder? You've gotta head over to [V0lk3n's write-up ](https://github.com/V0lk3n/Flipper-ESP32-Solo-Marauder )!
2022-07-17 05:19:32 +00:00
ESP32: 3 (RX0) -> FZ: 13 or 15 (these are TX pins)< br >
ESP32: 1 (TX0) -> FZ: 14 or 16 (these are RX pins)< br >
ESP32: GND -> FZ: 8 or 11 or 18 (GND)< br >
2022-10-03 05:57:00 +00:00
ESP32: 5V -> FZ: 1 (5V) ** *OR*** ESP32: 3.3V -> FZ: 9 (3.3V)< br >
*NOTE: Make sure to enable 5v under GPIO on the Flipper*
2022-07-17 05:19:32 +00:00
Switch between UART Pins 13/14 and 15/16 setting in FlipperZero< br >
`(GPIO -> USB-UART Bridge -> LEFT -> UART Pins)`
2022-08-03 09:03:33 +00:00
2022-10-05 06:17:36 +00:00
# ESP8266
2022-10-09 04:24:58 +00:00
If you have the ESP8266 and are looking to use a wifi deauth, check out [speexvocon's ](https://github.com/Speexvocon/FlipperZeroESPexpansion ) easy [web flasher ](https://github.com/Speexvocon/FlipperZeroESPexpansion#programming-the-module )!< br >
If you're looking to give another deauther a try, [check out HEX0DAYS repo over here ](https://github.com/HEX0DAYS/FlipperZero-PWNDTOOLS ).
2022-10-05 06:17:36 +00:00
## ESP8266 Pinout to Flipper Zero
(Thanks PixelHerstel for additional guidance!)
ESP8266: 1 (TX0) -> FZ: 14 or 16 (these are RX pins)< br >
ESP8266: 3 (RX0) -> FZ: 13 or 15 (these are TX pins)< br >
ESP8266: 5 -> FZ: 7< br >
ESP8266: 6 -> FZ: 6< br >
ESP8266: 7 -> FZ: 5< br >
ESP8266: 8 -> FZ: 4< br >
ESP8266: VIN -> FZ: 1< br >
ESP8266: GND -> FZ: 8 or 11 (GND)< br >
FZ: 16 -> FZ: 18 (yes, FZ to FZ)< br >
ESP8266: 5V -> FZ: 1 (5V)< br >
*NOTE: Make sure to enable 5V under GPIO on the Flipper*< br >
***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< br >
`(GPIO -> USB-UART Bridge -> LEFT -> UART Pins)`
2022-10-03 06:39:31 +00:00
A visual pinout can be seen in [this PDF ](https://github.com/UberGuidoZ/Flipper/blob/main/GPIO/ESP8266_WIFI_Schematic.pdf ), too.
2022-11-10 23:41:18 +00:00
# ESP32-S2 WROVER
2022-11-10 23:39:41 +00:00
2022-11-10 23:41:18 +00:00
## ESP32-S2 WROVER Pinout (thanks max_fpv_austria!)
2022-11-10 23:39:41 +00:00
ESP32: 44 (RX0) -> FZ: 13 or 15 (these are TX pins)< br >
ESP32: 43 (TX0) -> FZ: 14 or 16 (these are RX pins)< br >
ESP32: GND -> FZ: 8 or 11 or 18 (GND)< br >
ESP32: 3.3V -> FZ: 9 (3.3V)< br >
Switch between UART Pins 13/14 and 15/16 setting in FlipperZero< br >
`(GPIO -> USB-UART Bridge -> LEFT -> UART Pins)`
Picture includes wiring pinout for the SD card mod too!
2023-02-13 05:03:40 +00:00
# ESP32-CAM (Camera) - [FAP FILE HERE](https://github.com/Z4urce/flipperzero-camera/)!
2022-08-03 09:12:35 +00:00
## ESP32-CAM Pinout to Flipper Zero
CAM32: 1 (RX0) -> FZ: 13 or 15 (these are TX pins)< br >
CAM32: 2 (TX0) -> FZ: 14 or 16 (these are RX pins)< br >
CAM32: 3 (GND) -> FZ: 8 or 11 or 18 (GND)< br >
CAM32: 4 (3.3V) -> FZ: 9 (3.3V) ** *OR*** ESP32: 5V -> FZ: 1 (5V)
2022-08-03 09:03:33 +00:00
# LoRa ESP32 Wifi (Wifi + Bluetooth + LoRa 433 MHz)
2022-10-21 04:54:21 +00:00
## LoRa ESP32 Wifi Pinout to Flipper Zero
2022-08-03 09:03:33 +00:00
LoRa32: 1 (RX0) -> FZ: 13 or 15 (these are TX pins)< br >
LoRa32: 2 (TX0) -> FZ: 14 or 16 (these are RX pins)< br >
LoRa32: 3 (GND) -> FZ: 8 or 11 or 18 (GND)< br >
LoRa32: 4 (3.3V) -> FZ: 9 (3.3V)
Switch between UART Pins 13/14 and 15/16 setting in FlipperZero< br >
`GPIO -> USB-UART Bridge -> LEFT -> UART Pins`
2022-08-04 06:38:44 +00:00
2022-08-07 12:00:00 +00:00
# Raspberry Pi Zero UART
## Raspberry Pi Zero : Prerequisite
2022-08-07 22:48:53 +00:00
Mount your SD Card to your computer and add the following line at the end of `/boot/config.txt` file.
2022-08-07 12:00:00 +00:00
2022-08-07 22:48:53 +00:00
`enable_uart=1`
2022-08-07 12:00:00 +00:00
2022-08-07 22:48:53 +00:00
Additionally you can look at the baudrate in the `/boot/cmdline.txt` file, which should be `115200` by default.
2022-08-07 12:00:00 +00:00
## 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)
```
2022-08-04 06:38:44 +00:00
## HC-SR04 Ultrasonic Distance Sensor
2022-08-06 11:56:24 +00:00
Plugin by Sanqui: https://github.com/Sanqui/flipperzero-firmware/blob/hc_sr04/applications/hc_sr04/hc_sr04.c
2022-08-04 06:38:44 +00:00
```
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
```
2022-12-17 22:27:49 +00:00
2022-08-09 06:08:49 +00:00
-----
2022-11-07 00:53:00 +00:00
## NMEA 0183 GPS
https://github.com/ezod/flipperzero-gps
2022-11-07 00:55:58 +00:00
```
GPIO pins 9 (3.3V), 11 (GND), 13 (TX), and 14 (RX)
```
2022-11-07 00:53:00 +00:00
-----
## i2c Tools (by NaejEL)
2022-11-07 00:54:51 +00:00
```
C0 -> SCL / C1 -> SDA / GND -> GND | 3v3 logic levels only!
```
2022-11-07 00:53:00 +00:00
https://github.com/NaejEL/flipperzero-i2ctools
-----
## HTU21D / SI7021 Temperature Sensor
2022-12-17 22:21:18 +00:00
2022-11-07 00:54:51 +00:00
```
GPIO pins 9 (3.3V), 11 (GND), 15 (sda), and 16 (scl)
```
2022-11-07 00:53:00 +00:00
https://github.com/Mywk/FlipperTemperatureSensor
-----
## AM2320/AM2321 Temp. Sensor
2022-11-07 00:54:51 +00:00
```
GPIO pins 9 (3.3V), 11 (GND), 15 (sda), and 16 (scl)
```
2022-11-07 00:53:00 +00:00
https://github.com/xMasterX/AM2320_Flipper_Plugin
-----
## 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
2022-12-22 20:21:58 +00:00
-----
2024-01-22 02:59:59 +00:00
## UHF RFID YRM100 ([FAP / App here](https://github.com/frux-c/uhf_rfid))
```
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
```
Credit: [RekordNadoev ](https://github.com/RekordNadoev ) / [Issue 515 ](https://github.com/UberGuidoZ/Flipper/issues/515 )
-----
## ServoTester ([Info/App](https://mhasbini.com/blog/servo-tester-flipper-zero.html))
```
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
```
Credit: [RekordNadoev ](https://github.com/RekordNadoev ) / [Issue 515 ](https://github.com/UberGuidoZ/Flipper/issues/515 )
-----
2022-12-22 20:21:58 +00:00
# Custom PCB's
## Here's some repo's with designs for custom PCB's you can order or build using a prototype board.
2023-02-15 05:08:10 +00:00
[DrB0rk ](https://github.com/DrB0rk/Flipper-Zero-Boards )< br >
[AWOK ](https://github.com/AWOK559/Flipper_Zero_Boards )< br >
2023-02-15 05:11:42 +00:00
[Speexvocon ](https://github.com/Speexvocon/ ) ([ESP Expansion](https://github.com/Speexvocon/FlipperZeroESPexpansion) and [Header Extender ](https://github.com/Speexvocon/FlipperZeroHeaderExtender ))< br >
2023-02-15 05:08:10 +00:00
[ushastoe ](https://github.com/krolchonok/flipper-board )< br >
[TheOtherLonestar ](https://github.com/TheOtherLonestar/RS-232-UART-Flipper )< br >
[Oleksii Kutuzov ](https://github.com/oleksiikutuzov/flipperzero-flasher-board )
2022-11-07 00:53:00 +00:00
-----
2022-12-02 03:23:44 +00:00
## Donation Information
Nothing is ever expected for the hoarding of digital files, creations I have made, or the people I may have helped.
## Ordering from Lab401? [USE THIS LINK FOR 5% OFF!](https://lab401.com/r?id=vsmgoc) (Or code `UberGuidoZ` at checkout.)
2022-08-09 04:54:31 +00:00
I've had so many asking for me to add this.< br >
 
**BTC**: `3AWgaL3FxquakP15ZVDxr8q8xVTc5Q75dS` < br >
2022-08-09 06:08:49 +00:00
**BCH**: `17nWCvf2YPMZ3F3H1seX8T149Z9E3BMKXk` < br >
**ETH**: `0x0f0003fCB0bD9355Ad7B124c30b9F3D860D5E191` < br >
2023-01-12 08:52:44 +00:00
**LTC**: `M8Ujk52U27bkm1ksiWUyteL8b3rRQVMke2` < br >
2023-01-12 08:32:55 +00:00
**PayPal**: `uberguidoz@gmail.com`
2022-08-09 04:54:31 +00:00
So, here it is. All donations of *any* size are humbly appreciated.< br >
 
2022-08-09 06:08:49 +00:00
Donations will be used for hardware (and maybe caffeine) to further testing!< br >
2023-02-13 05:03:40 +00:00
