Skip to content

Vistumbler VS1 Format

acalcutt edited this page Feb 27, 2016 · 10 revisions

VS1 File Format Example

# Vistumbler VS1 - Detailed Export Version 4.0
# Created By: Vistumbler v10.6.3 Beta 4
# ----------------------------------------------------------
#GpsID|Latitude|Longitude|NumOfSatalites|HorizontalDilutionOfPrecision|Altitude(m)|HeightOfGeoidAboveWGS84Ellipsoid(m)|Speed(km/h)|Speed(MPH)|TrackAngle(Deg)|Date(UTC y-m-d)|Time(UTC h:m:s.ms)
# ----------------------------------------------------------
1|N 4202.5420|W 7135.2375|04|15.0|331|-34.0|38.34|23.81|243.72|2009-07-03|18:53:28.250
2|N 4202.5342|W 7135.2582|04|14.9|333|-34.0|37.32|23.17|242.96|2009-07-03|18:53:29.252
3|N 4202.5317|W 7135.2646|04|14.8|333|-34.0|35.93|22.31|242.96|2009-07-03|18:53:30.263
4|N 4202.5293|W 7135.2707|04|14.8|332|-34.0|34.39|21.36|242.94|2009-07-03|18:53:31.274
5|N 4202.5271|W 7135.2764|03|46.7|331|-34.0|32.8|20.37|242.65|2009-07-03|18:53:32.275
6|N 4202.5254|W 7135.2814|04|14.7|331|-34.0|29.55|18.35|242.47|2009-07-03|18:53:33.281
7|N 4202.5203|W 7135.2856|06|1.3|329|-34.0|16.55|10.28|207.12|2009-07-03|18:53:35.608
8|N 4202.5177|W 7135.2861|06|1.3|329|-34.0|19.46|12.08|176.76|2009-07-03|18:53:36.621
9|N 4202.5140|W 7135.2846|05|1.4|325|-34.0|25.52|15.85|156.46|2009-07-03|18:53:37.850
10|N 4202.5097|W 7135.2818|05|1.8|322|-34.0|30.24|18.78|151.43|2009-07-03|18:53:38.856
# ----------------------------------------------------------
# SSID|BSSID|MANUFACTURER|Authentication|Encryption|Security Type|Radio Type|Channel|Basic Transfer Rates|Other Transfer Rates|High Signal|High RSSI|Network Type|Label|GID,SIGNAL,RSSI
# ----------------------------------------------------------
WIFISSID1|C0:C1:C0:A1:65:6B|Cisco-Linksys, LLC|WPA2-Personal|CCMP|3|802.11n|36|39|19.5,156,18,24,36,48,54|99|-34|Infrastructure|Unknown|1,99,-34\2,41,-75\3,33,-80
WIFISSID2|84:1B:5E:F8:38:F3|NETGEAR|WPA2-Personal|CCMP|3|802.11n|153|6,9,12,18,24,36,48,54||73|-56|Infrastructure|Unknown|9,73,-56

VS1 Information

  • The Vistumbler format uses the "#" symbol as a comment. Any line that starts with a "#" will be ignored by Vistumbler
  • Vistumbler uses "|" as its delimiter.
The Vistumbler file format consists of two seperate arrays.

The first is the GPS Array. The GPS Array holds GpsID, Latitude, Longitude, Number Of Satalites, Horizontal Dilution Of Precision, Altitude, Height Of Geoid Above WGS84 Ellipsoid, Speed(km/h), Speed(MPH), TrackAngle, Date, and Time

# -------------------------------------------------
# GpsID|Latitude|Longitude|NumOfSatalites|HorizontalDilutionOfPrecision|Altitude(m)|HeightOfGeoidAboveWGS84Ellipsoid(m)|Speed(km/h)|Speed(MPH)|TrackAngle(Deg)|Date(UTC y-m-d)|Time(UTC h:m:s.ms)
# -------------------------------------------------
1|N 4202.5420|W 7135.2375|04|15.0|331|-34.0|38.34|23.81|243.72|2009-07-03|18:53:28.250
In this example,
  • GPS ID = 1
  • Latitude = N 4202.5420
  • Longitude = W 7135.2375
  • Number of satalites = 04
  • Horizontal Dilution Of Precision = 15.0
  • Altitude(meters) = 331
  • Height Of Geoid Above WGS84 Ellipsoid(meters) = -34.0
  • Speed(km/h) = 38.34
  • Speed(MPH) = 23.81
  • TrackAngle(Degrees) = 243.72
  • Date(y-m-d) = 2009-07-03
  • Time(h: m:s.ms) = 18:53:28.250
The second is the Access Point Array.
# ---------------------------------------------------------------------------------------------------------------------------------------------------------
# SSID|BSSID|MANUFACTURER|Authentication|Encryption|Security Type|Radio Type|Channel|Basic Transfer Rates|Other Transfer Rates|High Signal|High RSSI|Network Type|Label|GID,SIGNAL,RSSI
# ---------------------------------------------------------------------------------------------------------------------------------------------------------
WIFISSID1|C0:C1:C0:A1:65:6B|Cisco-Linksys, LLC|WPA2-Personal|CCMP|3|802.11n|36|39|19.5,156,18,24,36,48,54|99|-34|Infrastructure|Unknown|1,99,-34\2,41,-75\3,33,-80

In this example,

  • SSID = WIFISSID1
  • BSSID = C0:C1:C0:A1:65:6B
  • Manufacturer = Cisco-Linksys, LLC
  • Authentication = WPA2-Personal
  • Encryption = CCMP
  • Security Type = 3
  • Radio Type = 802.11n
  • Channel = 36
  • Basic Transfer Rates = 39
  • Other Transfer Rates = 19.5,156,18,24,36,48,54
  • High Signal = 99
  • High RSSI = -34
  • Network Type = Infrastructure
  • Label = Unknown
  • GPS ID / SIGNAL / RSSI = 1,99,-34\2,41,-75\3,33,-80
Signal History

To get the signal history of a access point "GPS ID / SIGNAL / RSSI" is first split by its delimiter "\". This gives you individual GPS ID / SIGNAL / RSSI pairs. This field is split again by a "," to get the individual GPS ID / SIGNAL / RSSI values. so in this example you would get the following values

GPS ID / SIGNAL / RSSI pair GPS ID / SIGNAL / RSSI values
1,99,-34 GPS ID - (1) Signal - (99) - RSSI - (-34)
2,41,-75 GPS ID - (2) Signal - (41) - RSSI - (-75)
3,33,-80 GPS ID - (3) Signal - (33) - RSSI - (-80)

Security Type(s)

1 - Authentication -> Open, Encryption -> None

2 - Encrytion -> WEP

3 - Secure (Anthing Else)

Date and Time

Date and times are kept in the GPS Array. To get a date or time a GPS ID from the signal history is needed

Clone this wiki locally