Skip to content

kelv1n9/eHack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

171 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Platform License

🚀 eHack

eHack

eHack is a versatile, all-in-one tool built on the Raspberry Pi Pico, designed for radio frequency analysis, penetration testing, and hardware research enthusiasts. The project integrates a wide array of tools for interacting with various wireless technologies, all housed in a compact form factor with a user-friendly OLED interface.


🛰️ Portable Module

The eHack Portable expands the reach of eHack beyond the main device.
It is a lightweight RF companion that links wirelessly and can be fully managed through the interface of the primary unit.
With it, you can launch experiments and carry out attacks remotely, bringing extra versatility to your toolkit.

More details about the portable module are available in its own repository: eHack Portable


🤝 Contributor Wanted!

For the eHack project, we are looking for a developer who can help with the software implementation for the PN532 NFC module. The goal is to add full tag reading, writing, and emulation capabilities.

Your contribution to this feature would be highly appreciated! If you have the experience and a desire to contribute, please feel free to reach out.

  Bands / Tech What you can do
Sub‑GHz (315 – 915 MHz) CC1101 • Live spectrum and activity scan
• Capture & replay OOK/ASK packets
RAW capture & replay
HF Monitor (live log + quick resend)
• Gate / Barrier toolkit (capture, replay, brute‑force CAME & NICE codes)
Tesla charge‑port opener
• Wide‑band noise jammer
2.4 GHz NRF24L01+ • Channel‑map spectrum viewer
• Jammers: All / Wi‑Fi / BT / BLE / USB / VIDEO / RC
BLE Spam ESP32 C3 • BLE Spam (iOS)
Infra‑Red IR LED + receiver • Capture & replay
• Built‑in brute‑force tables for TVs & projectors
RFID / NFC rdm6300 + PN532 • Read, emulate (125 kHz RFID)
• Basic NFC read/detect (Mifare Classic / Ultralight)
• Write mode placeholder (WIP)
FM Radio (eHack Portable) Si4713 • FM frequency control from main device (76–108 MHz)
• Remote input level indicator
Games • Falling Dots, Snake, Flappy Bird
Quality‑of‑Life • OLED UI with 3‑button navigation
• Vibration feedback
• Battery monitor
• Auto‑dimming
• Connection Telemetry page
• Settings saved to EEPROM

🎮 Controls

  • UP / DOWN — menu navigation, frequency/slot selection, parameter adjustment
  • OK (click) — confirm / start-stop action
  • OK (hold) — back / exit current screen
  • UP + DOWN (hold) — lock / unlock controls
  • Hold OK during boot — toggle startup mode eHack / eGames

🔌 Pinout & Wiring

Raspberry Pi Pico Pins Used

Module Pico pins Note
I2C bus (OLED + PN532) SDA=GP0, SCL=GP1 Shared I2C bus
NRF24L01+ (SPI) SCK=GP6, MOSI=GP7, MISO=GP4, CE=GP21, CSN=GP20 2.4 GHz module
CC1101 (SPI1) SCK=GP10, MOSI=GP11, MISO=GP12, CSN=GP13, GDO0=GP19 Sub‑GHz module
Buttons UP=GP5, OK=GP8, DOWN=GP9 Buttons to GND (INPUT_PULLUP in code)
IR TX=GP2, RX=GP3 IR LED + IR receiver
RFID 125 kHz COIL=GP14, RDM6300_RX=GP15, RFID_POWER=GP27 Power/enable controlled by GPIO
BLE trigger BLE_PIN=GP18 Control pin for external BLE/ESP32 module
Vibro VIBRO=GP16 Use transistor/driver stage
Battery monitor A3 Battery voltage divider measurement

On‑Device Menu

Main
├─ SubGHz
│   ├─ Air Scan
│   │   ├─ Spectrum
│   │   └─ Activity
│   ├─ Raw Scan
│   │   ├─ Capture
│   │   └─ Replay
│   ├─ Common
│   │   ├─ Capture
│   │   ├─ Replay
│   │   └─ Monitor
│   ├─ Barriers
│   │   ├─ Capture
│   │   ├─ Replay
│   │   └─ Brute (CAME / NICE)
│   ├─ Jammer
│   └─ Tesla
├─ 2.4 GHz
│   ├─ Spectrum
│   ├─ All Jam
│   ├─ Wi‑Fi Jam
│   ├─ BT Jam
│   ├─ BLE Jam
│   ├─ USB Jam
│   ├─ VIDEO Jam
│   ├─ RC Jam
│   └─ BLE Spam
├─ IR Tools
│   ├─ Capture
│   ├─ Replay
│   ├─ TV Brute
│   └─ Projector Brute
├─ FM Radio
├─ RFID
│   ├─ Read
│   ├─ Emulate
│   └─ Write
├─ Games
│   ├─ Falling Dots
│   ├─ Snake
│   └─ Flappy Bird
├─ Torch
├─ Connect
├─ Settings
└─ Telemetry

Disclaimer 🚨

Educational & Research Use Only
Use this hardware and software responsibly and only on frequencies and systems you are legally allowed to transmit on.
The author (Elvin Gadirov) accepts no liability for any damage, data loss, or legal consequences that may result from its use.
All actions are at your own risk. Always comply with local laws and regulations.

About

eHack is a pocket-sized, Raspberry Pi Pico-based RF pentest tool.

Resources

License

Stars

Watchers

Forks

Contributors