AtomGPS Wigler

Overview

AtomGPS Wigler is a wardriving tool originally created by @lozaning for use with the M5Stack Atom GPS kit.

This tool is specifically designed for Wi-Fi network scanning. LED status indicators are outlined below. Writes wigle.net compatible CSV files to thw SD card.

Feedback & Community

Detailed review and instructions for beginners | Thanks to kampf for the writeup:

• January 11, 2024: "Wigle Me This" by zZq.org

Flashing to AtomGPS

• Grab the codebase:

  git clone https://github.com/lukeswitz/AtomGPS_wigler.git
  cd AtomGPS_wigler/build
  

Method One: Esptool.py

1. Locate the device:

• Linux/macOS:

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

• Windows, check COM port in Device Manager.

2. Flash the firmware, partition and bootloader:

[!NOTE] Ensure you have the latest version of esptool.py installed from the link above, or a known warning about header fields will display when flashing.

• Navigate to the build folder (if not already there).
• Flash using the following command inside the build folder or by specifying file paths:

esptool.py -p [YOUR_PORT] -b 1500000 --before default_reset --after hard_reset --chip esp32 write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x1000 AtomGPS_wigler_v1_5.bootloader.bin 0x8000 AtomGPS_wigler_v1_5.partitions.bin 0x10000 AtomGPS_wigler_v1_5.bin

Method 2: Arduino IDE

1. Open the .ino file in Arduino IDE (or copy and paste it into a new sketch).

2. Add & Install ESP32 Boards:

• Open Arduino IDE.
• Go to File > Preferences.
• Add https://dl.espressif.com/dl/package_esp32_index.json to "Additional Boards Manager URLs."
• Click OK.
• Navigate to Tools > Board > Boards Manager.
• Search for "esp32" and search for "esp32 by Espressif Systems" and click Install

3. Add the M5Atom Library:

• Library Manager > search for "M5Atom". Click Install.

[!IMPORTANT] Update outdated Arduino boards and libraries. Version numbers will change with time.

4. Set Board: Tools > Board > esp32 > M5Atom

5. Ensure the default settings are as below:

6. Click Upload

Get out Wardriving!

After flashing, the device scans for Wi-Fi networks, using LEDs to display status. Plug it into any usb power source and go: LED Indicators:

[!NOTE]

• Press and hold the button during scanning to toggle the Green LED.

• RED blink if the SD card is missing/write error.

• PURPLE blink while waiting for a GPS fix.

• GREEN blink during scanning (toggle by press & hold of button).

• Network data is saved in Wigle.net-compatible CSV files on the SD card.

• Bonus: Contribute to the wigle.net database. Or join the community and compete to find the most Wi-Fi networks.

[!CAUTION] Wardriving may not be legal in all locations. Please check local laws and obtain proper consent where necessary.