Skip to content

Latest commit

 

History

History
58 lines (43 loc) · 1.95 KB

README.md

File metadata and controls

58 lines (43 loc) · 1.95 KB

ESP32-C5 WiFi Sniffer

This project was forked from https://github.com/Evil-Project-Team/ESP32-C5-J4CK3D and modified.

A lightweight WiFi packet sniffer developed for the ESP32-C5 using the ESP-IDF framework.

Getting Started

Prerequisites

  • ESP-IDF (Espressif IoT Development Framework) (Developed and tested on v5.5.2)
  • Git

Build and Flash

  1. Clone the repository:

    git clone https://github.com/baseapp/esp32_c5_scanner
    cd esp32_c5_scanner
  2. Configure, build and flash:

    idf.py set-target esp32c5
    idf.py build
    idf.py -p [PORT] flash
  3. Monitor the device output:

    idf.py -p [PORT] monitor

Usage

  1. Power on your ESP32-C5 device via the UART port. Note your system's COM port (e.g., COM3 on Windows or /dev/ttyUSB0 on Linux/macOS).
  2. Build and flash using the above commands.
  3. Run monitor command to see the serial output.

Configuration

The sniffer settings are currently hard-coded values. You can modify these parameters in the source code main/main.c:

wifi_sniffer_config_t sniffer_config = {
      .channel = 36,                            // 0 = Channel hopping; 1-14 (2.4GHz) or 32+ (5GHz)
      .hardware_filter_mask = WIFI_SNIFFER_FILTER_MASK_ALL,
      .filter_by_frame_type = true,             // Enable to target specific traffic
      .target_frame_type = WIFI_FRAME_TYPE_DATA,
      .dest_mac_filter = {                      // Filter by specific Access Point MAC
        0xC4, 0x27, 0x28, 0xFC, 0x1F, 0x07      // Set it to 0 to ignore.
      }, 
};
  • Channel: Set to a specific frequency or 0 to enable scanning across all supported bands.
  • MAC Filtering: To keep the output clean, update the dest_mac_filter with your router's MAC address to filter out other devices. (One way is to check your phone’s WiFi settings when connected to that AP).