You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 21 Next »

Specification

[reportOrigin]
{
   "testDeviceType": string                -->   typical values are "wifiprobe", "NetTest", "boomerang" to distinguish between measurement tools  
"testDeviceVersion": string   -->   version of the tool used (e.g. 1.0)
"testDeviceId": string   -->   ID (e.g. MAC address) of device used for preforming the test
"testInstanceUniqueId": string --> a unique identifier for this result set
"testStartTimestamp": string -->   UTC date & time when the test has been started (YYYY-MM-DD hh:mm:ss)
"testFinishedTimestamp": string --> UTC date & time when the test has been completed (YYYY-MM-DD hh:mm:ss)
}

[environment]

{

   "latitude": float number,               -->   latitude in degrees,decimal fractional minutes (note: we do not use this information  anymore, yet it cannot be empty)
   "longitude": float number,   -->   longitude in degrees,decimal fractional minutes (note: we do not use this information  anymore, yet it cannot be empty)
"altitude": float number,   -->   altitude in meters (can be empty) 
"locationName": string, --> tested location name (can be empty)
"eduroamDbInstid": string, --> SP id used in eduroam DB, provided by the NRO (can be empty)
"eduroamDbLocationid": string, --> Location Id used in eduroam DB, provided by the NRO (can be empty)
"testDeviceLocationDescription": string -->   describes the location of the test device
  "locationMethod": string,   -->   typical values are 'Through IP' or 'Geolocation' (note: we do not use this information  anymore, yet it cannot be empty)
 "wifiSurround": array --> list of SSIDs found
"accessPointVisibleSSIDCount": integer --> number of Wi-Fi cells with a normally visible SSID
"accessPointHiddenSSIDCount": integer --> number of Wi-Fi cells with a "hidden" SSID
"HS2Presence": string --> list of HS2.0 consortium identifers found
"channelsAvailable": string --> list of available channels / frequencies
}
[connectivity]
{
"eduroamAuthnTime": float number --> time needed for successful eduroam AuthN; ; -1=no success
 "ipv4TimeToAddress": float number --> time needed to get valid IPv4 address; -1=no connectivity;
"ipv6TimeToAddress": float number --> time needed to get valid IPv6 address; -1=no connectivity;
"MinimalPortSetOpen": boolean --> is minimal set of ports for eduroam SSID open? (true/false)
"ClosedPorts": string --> list of ports which should be open but are closed
"EAPTypesTest": boolean --> all EAP types supported (true/false)
"UnsupprotedEAPTypes": string --> list of unsupported EAP types
"eduroamEncription": string --> list of available encription standards
"eduroamChannelsAvailable": string --> list of available channels / frequencies for SSID eduroam
"signalQuality": string --> list with signal quality per channel
"TransparentWebProxy": boolean --> transparent proxy used (true/false)ž
"NAT": boolean --> NAT used (true/false)  
}
[performance]
{
"downloadThroughput": float number,   --> download speed in KBps (note: we use one decimal digit)
   "uploadThroughput": float number,   --> upload speed in KBps (note: we use one decimal digit)
   "ipv4LocalPing": float number,   --> IPv4 ping time in ms (note: we use one decimal digit) -1 if there was no IPv4 connectivity
   "ipv6LocalPing": float number,   --> IPv6 ping time in ms (note: we use one decimal digit) -1 if there was no IPv6 connectivity

}

JSON message example (syntax to be verified)

[reportOrigin]
{
   "testDeviceType": "Frankenprobe",
   "testDeviceVersion": 1.0,
   "testDeviceId": "00-11-22-33-44-55",
   "testInstanceUniqueId": "13df2a-671bbfa5697-13245-67713af",
   "testStartTimestamp": "2017-09-13 15:00:00",
   "testFinishedTimestamp": "2017-09-13 15:02:19",
}
[environment]
{
   "latitude": 38.25,
   "longitude": 21.73,
"altitude": -213.45,
"locationName": "Subterranean University, Main Building",
"eduroamDbInstid": 13,
"eduroamDbLocationid": 2,
 "testDeviceLocationDescription": "rector's office, hidden behind the 'A Starry Night' van Gogh painting on the rear wall",
   "locationMethod": "Differential Indoor GPS",
"wifiSurround": [ "eduroam", "drillTest", "geological_symposium" ] ,
"accessPointVisibleSSIDCount": 7,
"accessPointHiddenSSIDCount": 1,
"HS2Presence": 00-1B-C5-04-60,
"channelsAvailable": 1,3,6,7,
}
[connectivity]
{
   "eduroamAuthnTime": 0,600,
   "ipv4TimeToAddress": 0.672,
   "ipv6TimeToAddress": -1,
"MinimalPortSetOpen": false,
"ClosedPorts": 443,
"EAPTypesTest": true,
"UnsupprotedEAPTypes":,
"eduroamEncription": WPA2/AES,
"eduroamChannelsAvailable": 1,6,
"signalQuality": 1:95, 6:50,
"TransparentWebProxy": false,
"NAT": false,
}
[performance]
{
   "downloadThroughput": 4375.0,
"uploadThroughput": 3912.5,
"ipv4LocalPing": 4.7,
"ipv6LocalPing": -1,
}
  • No labels