Measurement Data¶
The test results are structured as an object. The actual results depend on the type of test being run. In the following, we will describe the results for the different tests.
General Fields¶
The results from our mobile SDK are aligned with the results you get from our Surfmeter Automator solution. They are only slightly different in a few minor aspects due to the different environments (mobile vs. desktop).
For a general overview of the data structure, see our reference.
Here are additional fields that are specific to the mobile SDK:
| Property | Type | Description |
|---|---|---|
client_reports |
Array | Array of objects containing client-reported data during the test. These are described in Client Reports. For video streaming, we use the P.1203 Client Report. Currently no other client reports are used. |
statistics_input |
Object | Object containing raw data used for calculating statistics (experimental, this may be changed in the future) |
geolocation_trace |
Array | Array of geolocation data points collected during the test. Currently only latitude and longitude are output on test startup and whenever a significant change in location occurs. |
connection_detail_trace |
Array | Array of connection details collected during the test. A connection detail is created on test starup and whenever a significant change in the network occurs. For details about what fields are available, see the section below. |
connection_detail_trace¶
The availability of mobile connection details depends on the device and the Android version, as well as the permissions given to the SDK. The following tables show the availability of the different connection details.
Basic Network Information¶
| Field | Required Permission | Minimum Android Version | Notes |
|---|---|---|---|
type |
ACCESS_NETWORK_STATE | All | Connection type (Wifi/Mobile/etc) |
is_internet_reachable |
ACCESS_NETWORK_STATE | All | |
is_connection_expensive |
ACCESS_NETWORK_STATE | All | |
ip_address |
None | All | |
subnet |
None | All | |
client_time |
None | All | |
client_time_skewed |
None | All |
WiFi Fields¶
| Field | Required Permission | Minimum Android Version | Notes |
|---|---|---|---|
ssid |
ACCESS_WIFI_STATE | All | |
bssid |
ACCESS_WIFI_STATE | All | |
signal_strength |
ACCESS_WIFI_STATE | All | Normalized 0-100 |
frequency |
ACCESS_WIFI_STATE | All | In MHz |
link_speed |
ACCESS_WIFI_STATE | All | In Mbps |
rssi |
ACCESS_WIFI_STATE | All | Raw signal strength |
dbm |
ACCESS_WIFI_STATE | All | Same as RSSI |
Mobile Network Basic Fields¶
| Field | Required Permission | Minimum Android Version | Notes |
|---|---|---|---|
mobile_network_type |
READ_PHONE_STATE | All | (2G/3G/4G/5G) |
is_roaming |
None | All | |
mno |
None | All | Mobile Network Operator |
mcc |
None | All | Mobile Country Code |
mnc |
None | All | Mobile Network Code |
GSM Fields:
| Field | Required Permission | Minimum Android Version | Notes |
|---|---|---|---|
cid |
ACCESS_FINE_LOCATION | All | Cell ID |
lac |
ACCESS_FINE_LOCATION | All | Location Area Code |
arfcn |
ACCESS_FINE_LOCATION | N (24) | |
bsic |
ACCESS_FINE_LOCATION | N (24) | |
signal_level |
ACCESS_FINE_LOCATION | All | |
asu_level |
ACCESS_FINE_LOCATION | All | |
dbm |
ACCESS_FINE_LOCATION | All | |
rssi |
ACCESS_FINE_LOCATION | R (30) |
LTE Fields:
| Field | Required Permission | Minimum Android Version | Notes |
|---|---|---|---|
cid |
ACCESS_FINE_LOCATION | All | Cell ID |
enodeb_id |
ACCESS_FINE_LOCATION | All | Derived from Cell ID |
pci |
ACCESS_FINE_LOCATION | All | Physical Cell ID |
tac |
ACCESS_FINE_LOCATION | All | Tracking Area Code |
arfcn |
ACCESS_FINE_LOCATION | N (24) | |
signal_level |
ACCESS_FINE_LOCATION | All | |
asu_level |
ACCESS_FINE_LOCATION | All | |
rsrp |
ACCESS_FINE_LOCATION | O (26) | Reference Signal Received Power |
rsrq |
ACCESS_FINE_LOCATION | O (26) | Reference Signal Received Quality |
rssnr |
ACCESS_FINE_LOCATION | Q (29) | Reference Signal SNR |
5G (NR) Fields:
| Field | Required Permission | Minimum Android Version | Notes |
|---|---|---|---|
nci |
ACCESS_FINE_LOCATION | Q (29) | NR Cell Identity |
pci |
ACCESS_FINE_LOCATION | Q (29) | Physical Cell ID |
tac |
ACCESS_FINE_LOCATION | Q (29) | Tracking Area Code |
nrarfcn |
ACCESS_FINE_LOCATION | Q (29) | NR Absolute RF Channel Number |
signal_level |
ACCESS_FINE_LOCATION | Q (29) | |
dbm |
ACCESS_FINE_LOCATION | Q (29) | |
asu_level |
ACCESS_FINE_LOCATION | Q (29) | |
ssrsrp |
ACCESS_FINE_LOCATION | Q (29) | SS Reference Signal Received Power |
ssrsrq |
ACCESS_FINE_LOCATION | Q (29) | SS Reference Signal Received Quality |
sssinr |
ACCESS_FINE_LOCATION | Q (29) | SS Signal to Noise and Interference Ratio |
Some additional fields for WCDMA, CDMA, and TDSCDMA are also available but are less commonly used in modern networks.
Diagnostics¶
Further, there is a diagnostics: object containing diagnostic information – but this is experimental and may be changed in the future.
It currently contains the following:
test_settings: Object with test-specific settingsclient_version: Version of the Quality SDK used (same as above)
ExoPlayerQualityTest¶
For the statistic values, see here.
VideoQualityTest¶
For the statistic values, see here.
WebQualityTest¶
For the statistic values, see here.