ABOUT

Open-RMBT is an open source, multi-threaded bandwidth test used in RTR-Netztest (RTR-Nettest in English).

This repository contains the source code of the new version of the RTR-Netztest application for Android.
The source code of the new implementation is developed by Specure GmbH, based on the previous app developed by the Austrian Regulatory Authority for Broadcasting and Telecommunications (RTR GmbH) and alladin-IT GmbH.

The source code is published under Apache version 2.0 license.

HOW TO BUILD

1. Select module you want to build according to customer (other ones from this set you can unload, keep only one loaded)
   • app: RTR Austria
   • ont: Open Nettest Global
   • akep: AKEP Albania
   • akos: AKOS Slovenia
   • nkom: NKOM Norway
2. Change app id to preferred one in dependencies.gradle (optional)
3. Update signing config (optional)
   1. Replace signing/debug.keystore with your own one
   2. Update signing/debug.properties with credentials to your signing/debug.keystore key
   3. Replace signing/release.keystore with your own one
   4. Update signing/release.properties with credentials to your signing/release.keystore key
4. Additional setup
   1. For app customer selectedEnable Google Maps SDK in Google Cloud console and put your API key into googleMapsApiKey in flavor-config.gradle file
   2. For other than app customer to enable MapBox map register and generate key on mapbox.com and set your key as environmental variable ORG_GRADLE_PROJECT_MAPBOX_SDK_KEY and replace your public key under mapbox_public_key in res/values/keys.xml for particular selected module
   3. For other than app customer to enable Here map search register and generate key on here.com and set your key as environmental variable ORG_GRADLE_PROJECT_HERE_API_KEY
   4. For other than app customer generate google-services.json according to app id you set in step 2. and paste it to root of module you selected to build
5. Add/change endpoints information and example.com in file app/src/rtr/config.json

VARIABLES DESCRIPTION

CONTROL SERVER VARIABLES

• CONTROL_SERVER_HOST❗Controßl server host, example: "sdev.example.com"
• CONTROL_SERVER_CHECK_PRIVATE_IPV4_HOST❗Url to the host for IPv4 test, example "sdevv4.example.com"
• CONTROL_SERVER_CHECK_PRIVATE_IPV6_HOST❗Url to the host for IPv6 test, example "sdevv6.example.com"
• CONTROL_SERVER_CHECK_PUBLIC_IPV4_URL❗Link to check public IPv4 address, example "sdevv4.example.com/RMBTControlServer/ip"
• CONTROL_SERVER_CHECK_PUBLIC_IPV6_URL❗Link to check public IPv6 address, example "sdevv6.example.com/RMBTControlServer/ip"
• CAPTIVE_PORTAL_WALLED_GARDEN_URL❗Url for checking captive portal presence, example: "http://webtest.example.com/generate_204"
• CONTROL_SERVER_PORT Control server port, default: 443
• CONTROL_SERVER_USE_SSL Indicates SSL should be used for server connection or not, default: true
• QOS_SSL Indicates SSL should be used QoS tests, default: true

TEST SETTINGS

• NDT_ENABLED Indicates NDT Tests is enabled, default: false (NDT fuctionality not implemented)
• SKIP_QOS_TESTS Indicates QoS Tests can be skipped after basic measurement, default: false
• SKIP_QOS_TESTS_FOR_PERIOD Indicates QoS Tests can be skipped until specified time in minutes runs out after previously executed QoS tests, default: false
• SKIP_QOS_TESTS_PERIOD_MIN Indicates how much time in minutes QoS Tests should be skipped after previously executed QoS tests, default: 120
• LOOP_MODE_ENABLED Indicates Loop Mode is enabled, default false
• LOOP_MODE_WAITING_TIME_MIN Default delay between measurements in Loop Mode in minutes, default: 30
• LOOP_MODE_DISTANCE_METERS Default distance between measurements in Loop Mode in meters, default: 250
• LOOP_MODE_NUMBER_OF_TESTS Default number of tests per single Loop Mode test, default: 30
• LOOP_MODE_MAX_NUMBER_OF_TESTS Maximum number of Loop Mode measurements that can be entered by User, default: 100
• LOOP_MODE_MIN_NUMBER_OF_TESTS Minimum number of Loop Mode measurements that can be entered by User, default: 1
• LOOP_MODE_MAX_WAITING_TIME_MIN Maximum delay in minutes between measurements in Loop Mode can be entered by User, default 1440
• LOOP_MODE_MIN_WAITING_TIME_MIN Minimum delay in minutes between measurements in Loop Mode can be entered by User, default 15
• LOOP_MODE_MAX_DISTANCE_METERS Maximum distance in meters between measurements in Loop Mode can be entered by User, default 10000
• LOOP_MODE_MIN_DISTANCE_METERS Minimum distance in meters between measurements in Loop Mode can be entered by User, default 50
• CAPABILITIES_RMBT_HTTP client supports RMBT HTTP, default: true
• CAPABILITIES_QOS_SUPPORTS_INFO The third state (=INFO) is supported or not, default: false
• CAPABILITIES_CLASSIFICATION_COUNT Number of intervals(classes) to classify measured values, default: 4
• SIGNAL_MEASUREMENT_DURATION_MIN Maximum time in minutes to run signal measurement, default: 2880

GENERAL SETTINGS

• CAN_MANAGE_LOCATION_SETTINGS Settings menu that allows to open application settings (If location permissions are not provided to app) or System Location settings (if location settings disabled for device)

EXPERT SETTINGS

• EXPERT_MODE_ENABLED Indicates Expert Mode is enabled, default: false
• EXPERT_MODE_IPV4_ONLY Indicates that only ip4v protocol should be used, default: false
• USER_SERVER_SELECTION_ENABLED Indicates that user can select server, default: false

DEVELOPER SETTINGS

• DEVELOPER_MODE_IS_ENABLED Indicates Developer Mode is enabled, default: false
• DEVELOPER_MODE_IS_AVAILABLE Indicates that Developer mode can be activated, default: true
• IS_MAP_SERVER_OVERRIDE_ENABLED Map server overriding is enabled, default: false
• IS_CONTROL_SERVER_OVERRIDE_ENABLED Control server overriding is enabled, default: false
• DEVELOPER_ACTIVATE_CODE❗Code to activate Developer Mode (10 taps on version number in Settings), default: qwerty
• DEVELOPER_DEACTIVATE_CODE❗Code to deactivate Developer Mode (10 taps on version number), default: 1111
• ALL_DEACTIVATE_CODE❗Code to deactivate everything(?) (10 taps on version number), default: 0000
• DEV_SIMULATE_5G_NETWORK:Allows to simulate 5G network in the developer mode
• DEV_SIMULATE_5G_NETWORK_IS_AVAILABLE:This flag makes simulate 5G network visible in the developer mode or not

OTHER VALUES

• SOURCE_CODE_URL❗Link to Source Code, value: https://github.com/rtr-nettest
• WEBSITE_URL❗Link to the website, default: https://www.example.com
• EMAIL_ADDRESS❗Email address for support, default: RMBT Support <support@example.com>
• DATA_PRIVACY_AND_TERMS_URL❗Link to Privacy Policy & Terms And Condition, default: https://example.com/%s/tk/netztestterms, where 1{%s} is language code (currently en or de)
• TERMS_FOR_ACCEPTANCE_URL❗Terms and Condition for User acceptance, default: https://example.com/%s/tc_android.html, where 1{%s} is language code (currently en or de)

MAP SETTINGS

• MAP_SERVER_HOST Map server host url, default: sdev.example.com
• MAP_SERVER_PORT Map server port, default: 443
• MAP_SERVER_USE_SSL Indicates SSL should be used for map server connection or not, default: true
• MAP_SERVER_ROUTE Map server route, default: RMBTMapServer
• MAP_TILES_ENDPOINT Map server endpoint to obtain tiles, default: tiles/%s/%d/%d/%d.png where 1{%s} map type (heatmap or points or shapes), 2{%s} is zoom value, 3{%s} is x value, 4{%s} is y value
• MAP_MARKERS_ENDPOINT Map server endpoint to obtain markers, default: tiles/markers
• MAP_MARKER_SHOW_DETAILS_ROUTE Map server route to get marker details, default: en/Opentest?%s#noMMenu
• MAP_FILTERS_ENDPOINT Map filters endpoint to get map types & filters, default: tiles/info

CONTROL SERVER ROUTES

• CONTROL_SERVER_ROUTE Route to the control server, default: RMBTControlServer
• CONTROL_SERVER_SETTINGS_ENDPOINT Endpoint to get settings from the control server, default: settings
• CONTROL_SERVER_TEST_REQUEST_ENDPOINT Endpoint to get basic measurement set up to start measurement, default: testRequest (currently not in use. Control client uses same endpoint from old implementation)
• CONTROL_SERVER_SEND_RESULT_ENDPOINT Endpoint to send test results to the control server, default: result
• CONTROL_SERVER_SEND_QOS_RESULT_ENDPOINT Endpoint to send QoS test results to the control server, default: resultQoS
• CONTROL_SERVER_HISTORY_ENDPOINT Endpoint to get test history, default: history
• CONTROL_SERVER_GET_BASIC_RESULT_PATH Endpoint to get test results from the control server, default: testresult
• CONTROL_SERVER_GET_OPENDATA_RESULT_PATH Endpoint to get open test results from control server, default: opentests
• CONTROL_SERVER_TEST_RESULT_DETAILS_ENDPOINT Endpoint to get detailed test results, default: testresultdetail
• CONTROL_SERVER_GET_QOS_TEST_RESULT_ENDPOINT Endpoint to get QoS test results, default: qosTestResult?api=2
• CONTROL_SERVER_SIGNAL_REQUEST_ROUTE Endpoint to get settings for the continious signal measurement, default: signalRequest
• CONTROL_SERVER_SIGNAL_RESULT_ROUTE Endpoint to send chunk of results of continiouse signal measurement, default: signalResult
• CONTROL_SERVER_GET_SYNC_CODE_ROUTE Endpoint to get sync code for current device, default: sync
• CONTROL_SERVER_SYNC_DEVICES_ROUTE Endpoint to send other device sync code and make devices history synchonised, default sync (has different params in api)
• CONTROL_SERVER_GET_NEWS_ENDPOINT Endpoint to get news, default: news
• CONTROL_SERVER_NEW_HOST Host for the updated version of server
• CONTROL_SERVER_NEW_ROUTE Route for the updated version of server
• REQUEST_HEADER_VALUE Request header to differentiate between customers eg. nt for ont customer. Default is empty.
• RMBT_CLIENT_REQUESTS_PATH_PREFIX Middle part of the request route eg. for route "sdevv6.example.com/RMBTControlServer/ip" and value v2 it will generate "sdevv6.example.com/RMBTControlServer/v2/ip". Default is empty.
• ENABLED_JITTER_AND_PACKET_LOSS Defines if jitter and packet loss test should be executed during basic test - it needs to be supported by ControlServer. Default is false.
• CMS_URL Defines URL to CMS system to load web pages regarding terms and conditions, privacy policy, ... Used for other than RTR customer. eg. "https://cms-api.example.com"