AtomGPS Wigler

Overview

AtomGPS_wigler is a wardriving tool initially created by @lozaning using the M5Stack Atom GPS kit. It's designed for Wi-Fi network scanning with LED status indicators. Major code work by @lukeswitzer

Prerequisites

• M5Stack Atom GPS Kit (available at DigiKey and elsewhere)
• TF Card (4GB standard, tested up to 32GB)
• ESPtool or Arduino IDE

Installation

Clone the repository:

git clone https://github.com/lozaning/AtomGPS_wigler.git

Flashing Instructions

Method 1: Arduino IDE

• Dependencies: - esp32 boards and the M5Atom library. Installation Docs.
• Open the .ino file in the IDE
• Set Board: esp32 > M5Stack-Core-ESP32
• Select your device port from the dropdown and press Upload/Flash

Method 2: Esptool

• Identify your device's port:

  • On Linux/macOS:

  ls /dev/ttyUSB*
  # or 
  ls /dev/cu.*

  • On Windows, check COM port in Device Manager.

• Flash the firmware .bin version of your choice:

esptool.py --chip auto --port [PORT] erase_flash write_flash -z 0x1000 [FIRMWARE_FILE]

Replace [PORT] with your device's port and [FIRMWARE_FILE] with the firmware file. You may need to execute the erase_flash and write_flash steps separately.

Usage

After flashing, the device starts scanning for Wi-Fi networks, indicating the status through LEDs and saving found networks to a Wigle.net compatible CSV file. CSV files are written to the SD card with a UTC date stamp and a run number.

LED Indicators:

• The LED will light RED if the SD card is missing
• The LED will flash PURPLE while waiting for a GPS fix
• The LED will flash GREEN while scanning