DuckyFence by Devaansh

# 🛡️ DuckyFence – BadUSB Detection Devboard

 

DuckyFence is a custom RP2040-based USB security board designed to **detect and block malicious USB devices**, such as **BadUSB HID injection attacks** (e.g., Rubber Ducky, DigiSpark payloads).

 

Built for **Hack Club's Silicon program**, DuckyFence features onboard USB detection, LED indicators, and full open-source schematics.

 

---

 

## ⚙️ Features

 

- 🔌 **RP2040 Microcontroller**

- 🧠 USB Host interface for detecting HID injection

- 🔐 USB-C port for PC connection (power + data)

- 🔌 USB-A port for plugging in suspicious USB devices

- 🔴 LED status indicator

- 🔘 BOOT + RESET tactile buttons

- ⚡ Onboard AMS1117-3.3 regulator

- 📦 Designed in **EasyEDA Pro** and manufactured via JLCPCB

 

---

 

## 🧰 Use Cases

 

- Test USB flash drives and HID devices for unexpected behavior

- Block or alert on HID keystroke injection

- Build open-source USB firewalls

- Use in education, homelabs, or hacker toolkits

 

---

 

## 🚀 Getting Started

 

1. **Flash the Firmware**

   - Hold `BOOTSEL`, connect USB-C to PC

   - Drop `duckyfence.uf2` into `RPI-RP2` drive

2. **Connect suspicious USB to USB-A port**

3. **Watch for LED activity** (or serial logs)

 

---

 

## 🛠️ Build It Yourself

 

- Use EasyEDA Pro to open `DuckyFence.json`

- Order PCB via JLCPCB with included BOM

- Flash the `.uf2` firmware or develop your own using:

  - [Pico SDK (C/C++)](https://github.com/raspberrypi/pico-sdk)

  - [TinyUSB](https://github.com/hathach/tinyusb)

  - [CircuitPython](https://circuitpython.org/board/raspberry_pi_pico/)

  - [MicroPython](https://micropython.org/download/rp2-pico/)

 

---

 

## 📜 License

 

This project is open source under the **MIT License**.  

Contributions, forks, and custom builds are encouraged!

 

---

 

## 🧑‍💻 Author

 

Built by Devaansh Pathak,  

for the **Hack Club Silicon Program**

 

> You build it, we back it.