CMWrun: Needed preparations to use an Android UE with the phone control function

Question

For some CMWrun test cases it is recomended to remote control the UE via the so called "phone control" function. Before you can add an Android based UE in the phone control device list of CMWrun, some preparations have to be made.

Answer

1.) UE Driver Installation on CMWrun PC
Ensure that the required drivers are installed on the PC, so that it can be controlled via USB and ADB

2.) Preparation for Phone Control Mode for Android based UEs
Enable the USB debugging mode at the DUT (can slightly differ depending on the DUT manufacturer). To enable Developer Options:

• Open the Settings screen, scroll down to the bottom, and tap "About phone".
• Scroll down to the bottom of the About screen and find the "Build number".
• Tap the Build number field seven times to enable Developer Options.
• Tap the Back button and you’ll see the Developer options menu just above the “About Phone” section in Settings.
• This menu is now enabled on your device—you won’t have to repeat this process again unless you perform a factory reset.

3.) Check ADB (Android Debugger Bridge) connection
You can check the USB connection to the DUT via the Windows shell of the PC where CMWrun is installed. Enter the command "adb devices". It shows a list of connected devices. The DUT must be listed. Google ADB is spart of the Android SDK Platform Tools that you can download here:
https://developer.android.com/studio/releases/platform-tools

4.) Allow R&S phone controll App to be installed on the UE
Allow the installation of apps from unknown sources. Depending on your DUT firmware, additional settings on the DUT can be required to allow the automation (for example disable confirmation popups). A Rohde & Schwarz app is automatically installed on the DUT whenever needed. Afterwards, it is automatically uninstalled. This app controls the DUT and displays information about control actions. You do not need to interact with the app.

5.) Setup the phone control settings in CMWrun
Add the Android Device in “Resources”-> Remote Shell Connector. You find further information also in the CMWrun Base Manual that is avialable in the R&S GLORIS customer web.