This script lets you run iPerf from a Linux computer to a remote iPerf server while keeping track of your location using a GPS.
It will also collect Ping tests data as well as Wireless Wifi statistics if you are on Wifi.
Uses of this script include:
- Outdoor Wifi Survey
- Moving Vehicle 3G/LTE Connection
- Linux
- iPerf https://iperf.fr/
- gpsd http://www.catb.org/gpsd/
- Netcat https://en.wikipedia.org/wiki/Netcat
- Python https://www.python.org/
- A GPS connected to your computer
- Wireless 'iw' tools https://wireless.wiki.kernel.org/en/users/documentation/iw
As Root:
root@pi:~# apt-get install gpsd gpsd-clients iperf
root@pi:~# git clone https://github.com/mzac/iperf_gps.git
root@pi:~# cd iperf_gps
root@pi:~# cp config.ini.default config.ini
Using your favorite editor (ex. nano, vi) edit the file config.ini and change any settings if needed.
# Location of iPerf binary
iperf_bin="/usr/bin/iperf"
# Location of gpspipe binary
gpspipe_bin="/usr/bin/gpspipe"
root@pi:~# ./iperf_gps.sh
Usage:
./iperf_gps.sh -i [server_ip]
Required:
-i [server_ip] IP Address or Hostname of the iPerf Server
Optional:
-h This help
-m Run through tests manually (no sleep)
-p [port] iPerf port to connect to (default is 5001)
-s [seconds] Sleep interval between tests (default is 10 seconds)
-t [seconds] How long to run iPerf test (default is 5 seconds)
-u Run iPerf with UDP tests (default is TCP)
-w [base_filename] Text that will be included in the filename
root@pi:~# ./iperf_gps.sh -i 10.0.0.10
--------------------------------------------------------------------------------
NOTE: Verify if have Wifi...No Wifi interfaces found!
NOTE: Running ICMP ping to see if server is alive...Ok
NOTE: Running Netcat test to see if iPerf is up on server...Ok
NOTE: Writing CSV data to 10.0.0.10-2016-01-29T16:35:43+0000.csv
--------------------------------------------------------------------------------
Looking for current location...Ok
NOTE: Test sequence number: 1
GPS Date: 2016-01-29
GPS Time: 16:35:44
GPS Longitude: -73.0000000
GPS Latitude: 45.000000000
GPS Altitude: 0 Meters
GPS Speed: 0 km/h
GPS Track: 0 Degrees
NOTE: Check if server is still alive...Ok
NOTE: Running ICMP test...Ok
Ping min: 13.538 ms
Ping avg: 16.603 ms
Ping max: 19.316 ms
Ping mdev: 2.178 ms
NOTE: Running iPerf test for 5 seconds...Ok
iPerf Client Bytes: 3145728
iPerf Server Bytes: 3670016
iPerf Client BPS: 4786759
iPerf Server BPS 4351867
NOTE: Writing results to file [10.0.0.10-2016-01-29T16:35:43+0000.csv] ...Ok
NOTE: Sleeping for 10 seconds...
When you are finished with your tests, stop the script with CTRL-C
You will then be able to parse the CSV file created however you wish.
- Verify if iPerf server is capable of bidirectional test (need to add in timeout in initial setup test)
- Create CSV to KML script
- Add in ICMP checks
- Verify iPerf server is up and working before running tests
- Add Wifi tests (SSID, BSSID, Signal, etc)