Skip to content

uses the atom gps kit to wardrive and give status via the leds

Notifications You must be signed in to change notification settings

lozaning/AtomGPS_wigler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 

Repository files navigation

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

About

uses the atom gps kit to wardrive and give status via the leds

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages