Skip to content

Teapot174/ESP-HACK

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

81 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📡 ESP-HACK FW — Русский

ESP-HACK_LOGO

🚀 About ESP-HACK FW

ESP-HACK is a powerful universal firmware for the ESP32, built for RF research and pentesting of radio frequencies, Bluetooth, infrared devices and GPIO integrations.
The project targets enthusiasts and pentesters who want to explore protocols and devices in Sub-GHz ranges and other wireless technologies.

The firmware is stable within its declared functionality, but some features are marked as "in development". Use the device according to the laws in your region.


⚠️ Disclaimer

This firmware is designed exclusively for research purposes and hardware testing. By using the firmware, you must comply with the laws of your region. The firmware creator is not responsible for your actions. Jammers are ILLEGAL.


⚡ Features

WiFi

  • Deauther (works, but poorly)
  • Beacon Spam
  • EvilPortal
  • Wardriving

Bluetooth

  • BLE-Spam: IOS, Android, Windows
  • BadBLE

SubGHz

  • SubRead
  • SubSend (problems with IDE)
  • Analyzer
  • Jammer (ILLIGAL)

Infrared

  • IR-Send
  • IR-Read
  • TV, PJ, AC OFF

GPIO

  • iButton (without module) (in development)
  • NRF24: Jammer (ILLIGAL), Config
  • Serial (in development)

📡 Supported SubGHz modulations

  • Princeton
  • RcSwitch
  • Came
  • Holtec
  • Nice
  • StarLine
  • KeeLoq

🛠️ Building

🔧 PCB

ESP-HACK_PCB Thanks Dripside!

🔧 Required components

Component Link
ESP32-WROOM TAP
CC1101 TAP
Display SH1106 TAP
SD-Мodule TAP
Buttons TAP
IR-TX, IR-RX TAP

🔌 Connection scheme

Module Pin 1 Pin 2 Pin 3 Pin 4 Pin 5 Pin 6 Pin 7
📺 Display VCC → 3V3 GND → GND SCL → G22 SDA → G21 - - -
🔘 Buttons UP (K1) → G27 DOWN (K2) → G26 OK (K3) → G33 BACK (K4) → G32 - - -
📡 CC1101 1 → GND 2 → 3V3 3 → G34 4 → G5 5 → G18 6 → G23 7 → G19
💡 IR IR-T → G4 IR-R → G14 - - - - -
🔌 GPIO A → G35 B → G25 C → G17 D → G16 E → G13 F → G12 G → G4
💾 SD-Card 3v3 → 3v3 GND → GND MOSI → G15 CLK → G2 MISO → G0 CS → GND -

Errors (ERROR:)

During operation ESP-HACK may show the following errors:

Error code ❌ Problem 🛠️ Possible fix
0x000 SD-Card initialization failed 🛠️ Format the SD card as FAT32 or replace it.
0x001 CC1101 initialization failed 🛠️ Check wiring and module functionality (power, SPI, contacts).
0x002 NRF24 initialization failed 🛠️ Verify chosen pins/connections and reboot the device.

📸 Final result

ESP-HACK_Device


✉️ Contacts / Author

Author: Teapot174
Telegram: @ESPH4CK