CRAWDAD tools/analyze/pcap/wifidelity (v. 2008-04-30)

Citation Author(s):
Aaron
Schulman
University of Maryland
Dave
Levin
University of Maryland
Neil
Spring
University of Maryland
Submitted by:
CRAWDAD Team
Last updated:
Fri, 05/16/2008 - 08:00
DOI:
10.15783/C7C01F
Data Format:
License:
44 Views
Categories:
Keywords:
0
0 ratings - Please login to submit your rating.

Abstract 

Wifidelity toolkit - Trace statistics and timing.

The Wifidelity package consists of two tools to identify the completeness and accuracy of 802.11 packet traces. "tracestats" uses 802.11 sequence numbers to quantify completeness, and the "plotscore" script generates a T-Fi plot: an at-a-glance, heatmap visualization of completeness versus load. "tracetiming" uses AP Beacon intervals to quantify packet timestamp accuracy and "plottiming" produces a line plot of timestamp accuracy.

Lastmodified :

2008-05-16

Dataname :

tools/analyze/pcap/wifidelity

File :

Wifidelity-0.04.tar.gz

Releasedate :

2008-04-30

Change :

the initial version.

References :

schulman-fidelity
The WiFidelity web page

Website :

http://www.cs.umd.edu/projects/wifidelity/

Keyword :

802.11
802.11 frames
RFMON
packet trace
signal strength
tcpdump

License :

This software is released under the GNU GPL.

Build :

- Requirements:

plotscore, plottiming:
gnuplot >= 4.0

tracestats, tracetiming:
Perl with 64 bit support
Perl lib Net::Pcap

- Files:

tracestats - print trace statistics on beacon intervals
tracetiming - print trace timing information on beacon intervals

Wifidelity/Pcap.pm - Pcap interface
Wifidelity/Stats.pm - Statistics
Wifidelity/80211.pm - 802.11 constants
Wifidelity/Timing.pm - Timing

Output :

- plotscore, plottiming:
.eps file in the same folder as the input data file

Parameters :

The default package can only parse pcap traces. If you would like to add
a parser for another trace type follow the interface in Pcap.pm. In the future
this procedure will be simplified.

Usage :

tracestats:
see ./tracestats -h
tracetiming:
see ./tracetiming -h
plotscore:
./plotscore stats-file "title"
plottiming:
./plottiming timing-file "title" Min us:Max us

Example :

For sample T-Fi plots, please visit the tool homepage ( http://www.cs.umd.edu/projects/wifidelity )

Algorithm :

Packet traces from 802.11 wireless networks are incomplete
both fundamentally, because antennas do not pick up every transmission,
and practically, because the hardware and software of collection may be
under provisioned. One strategy toward improving the completeness of
a trace of wireless network traffic is to deploy several monitors; these are
likely to capture (and miss) different packets. Merging these traces into
a single, coherent view requires inferring access point (AP) and client
behavior; these inferences introduce errors.

The WiFidelity tool implements methods to evaluate the fidelity of merged
and independent wireless network traces. We show that wireless traces
contain sufficient information to measure their completeness and clock
accuracy. Specifically, packet sequence numbers indicate when packets
have been dropped, and AP beacon intervals help determine the accuracy
of packet timestamps. We also show that trace completeness and clock
accuracy can vary based on load. We apply these metrics to evaluate
fidelity in two ways: (1) to visualize the completeness of different 802.11
traces, which we show with several traces available on CRAWDAD and
(2) to estimate the uncertainty in the time measurements made by the
individual monitors.
Instructions: 
The files in this directory are a CRAWDAD toolset hosted by IEEE DataPort. 

About CRAWDAD: the Community Resource for Archiving Wireless Data At Dartmouth is a data resource for the research community interested in wireless networks and mobile computing. 

CRAWDAD was founded at Dartmouth College in 2004, led by Tristan Henderson, David Kotz, and Chris McDonald. CRAWDAD toolsets are hosted by IEEE DataPort as of November 2022. 

Note: Please use the tools in an ethical and responsible way with the aim of doing no harm to any person or entity for the benefit of society at large. Please respect the privacy of any human subjects whose wireless-network activity is captured by the tools and comply with all applicable laws, including without limitation such applicable laws pertaining to the protection of personal information, security of data, and data breaches. Please do not apply, adapt or develop algorithms for the extraction of the true identity of users and other information of a personal nature, which might constitute personally identifiable information or protected health information under any such applicable laws. Do not publish or otherwise disclose to any other person or entity any information that constitutes personally identifiable information or protected health information under any such applicable laws derived from the tools through manual or automated techniques. 

Please acknowledge the source of the tools in any publications or presentations reporting use of this tools. 
Citation: 
Aaron Schulman, Dave Levin, Neil Spring, CRAWDAD toolset tools/analyze/pcap/wifidelity (v. 2008‑04‑30), https://doi.org/10.15783/C7C01F, Apr 2008.

 

Dataset Files

LOGIN TO ACCESS DATASET FILES
Open Access dataset files are accessible to all logged in  users. Don't have a login?  Create a free IEEE account.  IEEE Membership is not required.

Documentation

These datasets are part of Community Resource for Archiving Wireless Data (CRAWDAD). CRAWDAD began in 2004 at Dartmouth College as a place to share wireless network data with the research community. Its purpose was to enable access to data from real networks and real mobile users at a time when collecting such data was challenging and expensive. The archive has continued to grow since its inception, and starting in summer 2022 is being housed on IEEE DataPort.

Questions about CRAWDAD? See our CRAWDAD FAQ. Interested in submitting your dataset to the CRAWDAD collection? Get started, by submitting an Open Access Dataset.