Smartphone setup

Android

  1. Download Termux for Android device to a PC from https://f-droid.org/en/packages/com.termux/. Download the latest version, currently 0.118.0 (118).

  2. Copy the downloaded APK to the Android device and install the APK.

  3. Ensure the device is connected to the internet.

  4. Open/Run Termux on the Android device, then run (choose default answers to questions when prompted):

    pkg update
    pkg upgrade
    pkg install iperf3
    
  5. Connect the device the Pi via Ethernet or WiFi (SSID: PiNet, password UAS3Chal).

  6. Verify that an IP in the range 192.168.3.1xx was assigned.

  7. From the Termux terminal ping the Raspberry Pi server to ensure connectivity: ping 192.168.3.1.

  8. Test data transfer between the UE and Pi from the Termux terminal: run iperf3 --client 192.168.3.1 --bidir --extra-data "<UE name here>" --port <port> where <port> is between 5201 and 5211 and <UE name here> is an arbitrary name for this device, used when displaying the device’s name on the webserver.

iOS

  1. Ensure the device is connected to the internet.

  2. Install the iPerf3 Wifi Speed Test app from the Apple app store.

  3. Connect the device the Pi via WiFi (SSID: PiNet, password UAS3Chal).

  4. Verify that an IP in the range 192.168.3.1xx was assigned.

  5. Open the app. Select:

    1. A server address of 192.168.3.1;

    2. Set streams to 2.

    3. A test duration of 10s.

    4. The iOS client doesn’t support bidirectional mode; test first with a transmit mode of download, then test again with a transmit mode of upload.

  6. Press start.

Windows/OS X

  1. Download a Windows binary of iPerf3 or brew install iperf3.

  2. Connect the device the Pi via Ethernet or WiFi (SSID: PiNet, password UAS3Chal).

    1. Ethernet devices will be assigned an address in the 192.168.2.1xx range.

    2. Wi-Fi devices will be assigned an address in the 192.168.3.1xx range.

  3. From the terminal/command prompt, ping the Raspberry Pi server to ensure connectivity: ping 192.168.3.1.

  4. Test data transfer between the UE and Pi from the terminal/command prompt: run iperf3 --client 192.168.3.1 --bidir --extra-data "<UE name here>" --port <port> where <port> is between 5201 and 5211 and <UE name here> is an arbitrary name for this device, used when displaying the device’s name on the webserver.

Viewing results

Connect any device to the Pi, then open a web browser to 192.168.3.1 to view performance results.