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 (it 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)
    "testToolTypewifiSurround": string      array of BSSID => sig strength and SSID -->   list of SSIDs found 
   "accessPointVisibleSSIDCount": integer  --> >  typical values are "wifiprobe", "NetTest", "boomerang" to distinguish between measurement tools  number of Wi-Fi cells with a normally visible SSID
   "testToolTypeVersionaccessPointHiddenCellCount": string  integer   -->   number of  Wi--> Fi  versioncells ofwith thea tool used (e.g. 1.0)"hidden" SSID
   "testDeviceIdHS2Presence": string  array                    --> >  ID (e.g. MAC address) list of deviceHS2.0 usedconsortium for preforming the testidentifers found
   "testDeviceLocationDescriptionchannelsInUse": string array                  --> >  describes the locationlist of theavailable channels test/ devicefrequencies
}

[

...

connectivity]

{
   "testTypeeapAuthnResult": array of stringEAP types and the auth times (float) -->   describes the exact test (e.g. wifiscan, netperformance, ...)
"testInstanceID": string -->   measurement ID (unique hash generated by the test device)
"testTimeStamp": string  -->   date & time when the test has been performed (YYYY-MM-DD hh:mm:ss)

}

[test-result]

{

   "executionTime": float number>   time needed for successful eduroam AuthN in sec; ; -1=no success
   "ipv4TimeToAddress": float number       -->   time needed to get valid IPv4 address in sec; -1=no connectivity; 
   "ipv6TimeToAddress": float number       -->   time needed to get valid IPv6 address in sec; -1=no connectivity; 
   "eduroamMinimalPortSetOpen": boolean           -->   is time neededminimal set of ports for theeduroam testSSID to be performedopen? (true/false)
   "wifiSurroundeduroamWronglyClosedPorts": string           array of strings (e.g. "TCP/443") --> list of ports which should be open but are closed 
   "encryptionLevel": array of strings     -->   list of SSIDsavailable foundencryption standards
   "eduroamPresencesignalQuality": string                 -->   Yes/Nolist with signal quality per channel 
   "eduroamAuthnResulttransparentWebProxy": stringboolean          -->   resulttransparent ofproxy eduroamused AuthN (Yes true/ Nofalse)ž
   "eduroamConnectivityNAT": float number boolean                    -->   time needed to get--> valid IP address; 0=no connectivity; NAT used (true/false)  
}

[performance]

{
   "downloadThroughput": float number,     -->   download  download speed in KBps (note: we use one decimal digit)
   "uploadThroughput": float number,       --> >    uploadupload speed in KBps (note: we use one decimal digit)
   "localPingipv4LocalPing": float number,          -->   IPv4 ping time in ms (note: we use one decimal digit) -->   ping1 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 (

...

PHP creation script)

{
    "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": {
       

[environment]

{

   "latitude": 38.25,
  
        "longitude": 21.73,
   "locationMethod
        "altitude": -213.45,
        "locationName": "Subterranean University",
        "eduroamDbInstid": "13",
        "eduroamDbLocationid": "2",
        "testDeviceLocationDescription": "'Through IP'",

}

[connectivity]

[performance]

{

  rector's office, hidden behind the 'A Starry Night' van Gogh painting on the rear wall",
        "locationMethod": "Differential Indoor GPS",
        "wifiSurround": {
            "02-56-23-12-77-a2": {
                "eduroam": -67,
                "drillTest": -67
            },
            "09-55-ae-b1-99-33": {
                "geological_symposium": -92
            }
        },
        "HS2Presence": [
            "00-1B-C5-04-60"
        ],
        "channelsInUse": [
            1,
            6,
            11,
            54
        ]
    },
    "connectivity": {
        "eapAuthnResult": {
            "TLS": -1,
            "TTLS": 1.086,
            "PEAP": 0.997
        },
        "ipv4TimeToAddress": 0.09,
        "ipv6TimeToAddress": -1,
        "eduroamMinimalPortSetOpen": false,
        "eduroamWronglyClosedPorts": [
            "TCP\/443"
        ],
        "encryptionLevel": [
            "WPA2\/AES"
        ],
        "transparentWebProxy": false,
        "NAT": true
    },
    "performance": {
        "downloadThroughput": 4375.0,  ,
        "uploadThroughput": 3912.5,  
        "localPingipv4LocalPing": 4.7,  
        "testToolipv6LocalPing": "wifiprobe" -1
    }
}