Candela Technologies Logo
Network Testing and Emulation Solutions

LANforge InterOp Setup for Android

Goal: Cable an android mobile phone to a LANforge and have the LANforge recognize the android phone as a resource.

This cookbook requires LANforge GUI version 5.4.6 and above.

Background

Our LANforge InterOp solution is used to support real clients for testing access points. InterOp gives the ease of handling real clients with complete automation and detailed, customizable test reporting.

We have support for various kinds of real clients:

-      Android clients.
-      iOS clients.
-      Windows Machines.
-      Linux Machines.
-      MacOS Machines.

Network Topology:

Before getting started:

Steps to create Mi account:

Steps to setup & connect your android phone to LANforge

  1. Open the Settings on the Android phone and click on About Phone.

  1. In About Phone, click on Build number 7 times to enable developer options.

  1. Ensure that location services are on for the entire phone. Now there will be a new option available in settings tab called “Developer Options”. Click on it and enable the following options:

·      Stay Awake.

·      USB-Debugging.

·      Disable ADB Authorization Timeout

  1. Connect the device to the LANforge as per the testbed topology. Plug the phone via the port (usb-c or microusb) at the bottom of the phone to one of the usb-A slots on the LANforge.On the phone, check the 'allow usb debugging' box and press OK.

  2. Open the LANforge GUI window. The Interop tab should appear now. Click on the tab to see your phone detected as a port.

  1. in the InterOp tab, double-click on the port to open the Modify ADB Device window. Enter your device user name. This window can also be used to configure the android device's settings. Fill out the boxes with the appropriate settings and click 'Apply' to apply the settings. Click 'OK' to apply settings AND close window.

  1. Close the Modify ADB Device window. Back in the InterOp tab there is a button called Batch-Modify. Click on Batch-Modify to see options to configure the Wi-Fi profiles of the client.

  1. In the Batch-Modify window, click on the Advanced Settings tab, check the use SCRCPY option and click on Launch GUI. This will open a screen mirror of the phone in the LANforge GUI which will allow remote control of the device.

  1. Now click on Install in the Batch-Modify window to install the InterOp app (apk).

  2. Close the Batch-Modify window. Click on the Port Mgr tab, double click on eth1, and check the DHCP-IPv4 checkbox or assign a static IP address from the DHCP pool of the AP, which is our Manager IP address.

  1. Click on the InterOp tab again, double-click on your phone in the interOp tab (or highlight the row(s) to modify and click on Batch-Modify), and fill out the fields of IP address, SSID, encryption mode of SSID to associate to, etc (circled below). Click Apply when fields are entered. Hover over any fields for more information on how to fill them out and best usage fit for you.

  2. After clicking Apply, the InterOp app will open in the mobile and the Network stats will be visible. The phone can also be detected in the Resource Mgr and Port Mgr tabs in the GUI now. 

  3. Below is an example of ports like wiphy0, wlan0, rmnet0, which are the ports of the mobile. At this point, clicking on the wlan0 port[station] and Display Scan should open a pop-up in which all the nearby SSIDs broadcasted and seen by the phone are displayed.

Debugging Missing Interop Device:

If the interop device does not appear as expected, try these debugging steps in order:

  1. After the cable is plugged into LANforge, there should have been an RSA checkbox 'allow usb debugging' that popped up. Make sure this box is checked and hit OK.

  2. Unplug the phone. Go to Dev Options → Debugging → Revoke USB Authorizations and turn off USB debugging. Then turn USB debugging back on → plug in the phone → accept the 'enable USB debugging' pop up.

  3. Try a new cable.

  4. Restart the ADB server: sudo adb kill-server; sudo adb start-server

  5. If the interop device stil does not appear, contact Candela support.

Upgrading Android App from LANforge VNC

  1. The app for android is stored in the /home/lanforge/ directory. It is stored as interop-X.X.X.apk where the X.X.X is a LANforge version that (should) match your GUI, though it may not be.

  2. The app needs to be downloaded from the website, which is automatically done if the GUI is upgraded. However, if the GUI is not upgraded and you want to just update the app, the app must be downloaded:

    • Open VNC session to your lanforge manager. Visit downloads page on a browser: CT Downloads.
    • Click on the correct version. Scrol down to interop-X.X.X.tar.gx where X.X.X is the LANforge version. Click on that tar file to download it.
    • Once the tar file is downloaded, extract targ.gz into /home/lanforge/. This should put a new interop-X.X.X.apk file into /home/lanforge/.
  3. At this point, interop-X.X.X.apk should be updated in /home/lanforge/ and ready to install on all phones. To check file stats, stat interop-X.X.X.apk in a terminal shell will tell you the last edit to file.

  4. Go to the Interop tab. Select all Android phones (Ctrl + Click, highlight all rows). Click on 'Batch-Modify', 'Uninstall'. Then, make sure that the interop.apk file inputted is the same new one as in /home/lanforge/, then 'Install'. This will ensure all phones have the latest app in the folder.


Candela  Technologies, 2417 Main Street, Suite 201, Ferndale, WA 98248, USA
www.candelatech.com | sales@candelatech.com | +1.360.380.1618
Facebook | LinkedIn | Blog