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
- M5Stack Atom GPS Kit (available at DigiKey and elsewhere)
- TF Card (4GB standard, tested up to 32GB)
- ESPtool or Arduino IDE
Clone the repository:
git clone https://github.com/lozaning/AtomGPS_wigler.git- 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
-
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.
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