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

lozaning / AtomGPS_wigler