ESP8266 based Arduino wardriving warcycling

What is this?

A simple/cheap hardware + software setup to do warcycling trips and store as much information as we can on a SD card, using a small Arduino box. This project was forked from reynico's arduino-wardriving project and adapted to work with the Adafruit ESP8266 HUZZAH and FeatherWings.

Use this hardware to bike around your neighborhood to find where Wifi Hotspots are located, find the encryption of each hotspot, plot the data on popular map apps and upload the data to wigle.net.

What do we need?

• $19.95 HUZZAH ESP8266
• $8.95 Adalogger FeatherWing - RTC + SD Add-on For All Feather Boards
• $39.95 Adafruit Ultimate GPS FeatherWing
• $14.95 FeatherWing OLED
• $7.50 FeatherWing Doubler for hooking the circuit together
• $0.95 Feather Female Header Set
• $1.25 Feather Stacking Header Set
• $0.95 CR1220 Coin Battery for Holding GPS Ephermeris
• $9.95 Cylindrical Lithium Ion Battery
• $2.95 2mm Pitch Break-apart Male Headers
• $0.75 22k Ohm Resistor
• $0.75 100k Ohm Resistor
• $5.50 SPDT 1P2T Panel Mini Slide Switch (optional) for on-off switch
• $7.99 JST 2.0 PH cables and connector (optional) for on-off switch
• $9.38 two m3 20mm socket cap screws and nuts (optional) for attaching mount to a bike.
• Access to a 3D Printer for the mount

What does this do?

• Checks for a working SD Card
• Waits for GPS signal
• Collects all WiFi signals on 2.4Ghz on every (configurable) GPS sample
• Stores this information as a CSV file

What does this not do?

• This doesn't capture pcap files due power limitations
• This doesn't attack any network

What is different in this fork

• Used parts from one vendor: Adafruit.
• Used a boilerplate breadboard, eliminating need for custom circuit board.
• Took out previously-recorded check on Arduino logging code because checking to see if an AP was already recorded would become inefficient over time.
• Put the output CSV into Wigle CSV format.
• Added FIX input from GPS to verify GPS location is up to date.

Electric setup

The diagrams below show how to configure all the Feather Wings. Please read all instructions carefully.

Feather Wing Doubler

On the Featherwing Doubler pins a 22K resistor should be attached between the ADC pin and ground. A 100k resistor should be attached between the VBAT pin and the ADC pin. The RX pin should be mapped to the second NC from RX. Pin 4 should be mapped from the third NC pin from RX.

Adalogger Feather Wing

The Adalogger Feather Wing requires no special configuration, solder on Feather Stacking Headers to all pin locations.

OLED Display Feather Wing

All pins on the OLED Feather Wing should have the 2mm Pitch Break-apart Male Headers soldered on except for pin B because this pin is used to sample the FIX pin from the GPS.

GPS Feather Wing

The default TX and RX connections should be cut with a knife on the bottom of the GPS breakout Feather Wing. The TX pin should be mapped to the second NC from TX. The Fix Pin should be mapped from the third NC pin from TX. All pins on the GPS logger should have Feather Stacking Headers soldered onto them.

The ESP8266 and GPS module should be stacked on the top portion and the Data Logger and LCD screen should be stacked on the bottom portion.

Caution should be exercised when programming the ESP8266. Because the programming serial interface and the GPS module share the same pins, the GPS module shall be removed before programming takes place.

Mount

The mount source files are stored in the mount/ directory as .scad files. They can be converted to .stl files to be 3D printed by running make in the mount directory. The compiled stl files can be downloaded off thingiverse. If you want to build the stl files from scratch OpenSCAD is required for the build process. The directory contains four design files. The mounts were designed to have cantilevers so they can snap together without screws. The exception being the connection between the handle bar mounts.

Central Mount

Mount for the feather Wing circuit card and has attachments for the battery adaptor and handle bar mount.

Battery Mount

Mount to attach the battery to the Central Mount.

Handle Bar Mount Up

Mount to attach the Central Mount to the Handle Bar Mount Low.

Handle Bar Mount Low

Mount to attach to the Handle Bar Mount Up to clamp around bicylce handle bars.

Python Scripts

The content written to the .CSV on the SD card is large and contains redundant information. This project contains two python scripts for compressing and converting the data.

• reduce.py takes an input .CSV file and picks out the strongest signal of each non-unique entry and puts it in an output CSV file. Example usage python reduce.py -i input.csv -o output.csv.
• kml-convert.py takes an input .CSV file, picks out the strongest signal of each non-unique entry and writes it to an output .kml file of the same name, which can be opened with Google Earth or Gnome Maps. Example usage python kml-convery.py -i input.csv outputs input.kml.