This repository is practically a copy of the KnightWhoSayNi/android-iperf/ repository for iperf3 (but not iperf2), to continue building iperf3 for Android. Note that this repository starts with iperf3 version 3.14, while the old repository stopped at version 3.10.1.
What is iPerf3 ?
iPerf3 is a tool for active measurements of the maximum achievable bandwidth on IP networks. It supports tuning of various parameters related to timing, buffers and protocols (TCP, UDP, SCTP with IPv4 and IPv6). For each test it reports the bandwidth, loss, and other parameters.
For more informatiion, see https://github.com/esnet/iperf, which also includes the iperf3 source code (note that this repository does not include any iperf3 source code).
Version | Release day | Source Code |
---|---|---|
3.13-mt-beta3 |
2023-05-17 | Source Code |
3.14 |
2023-07-07 | Source Code |
3.15 |
2023-09-27 | Source Code |
3.16-beta1 |
2023-11-15 | Source Code |
3.16 |
2023-12-01 | Source Code |
3.17.1 |
2024-05-13 | Source Code |
Compiled iperf3
binaries using SDK 9477386_latest
and NDK r22
for devices with Android 9.0+
(API level 28+
).
ABI | Binaries |
---|---|
arm64-v8a | here |
armeabi-v7a | here |
x86 | here |
x86_64 | here |
More about Application Binary Interface (ABI): https://developer.android.com/ndk/guides/abis
To get supported ABI by an Android device:
adb shell getprop ro.product.cpu.abilist
Docker
- Clone this repo
- Build image from Dockerfile
docker build -t android-ndk:latest .
- Run container and fetch binaries
docker run -d --name android-ndk-container android-ndk
mkdir -p binaries
docker cp -a android-ndk-container:/tmp/libs binaries
docker stop android-ndk-container
docker rm android-ndk-container
Upload a binary file (with compatible ABI) to an Android device
adb push <LOCAL_PATH_TO_BINARY_FILE>/<BINARY_NAME> /data/local/tmp/<BINARY_NAME>
adb shell chmod 777 /data/local/tmp/<BINARY_NAME>
Set a default iperf3
adb shell ln -s /data/local/tmp/<IPERF3_BINARY_NAME> iperf3
Execute iperf3
adb shell /data/local/tmp/iperf3 <IPERF_ARGUMENTS>
This project is licensed under the MIT License - see the LICENSE.md file for details