模擬 Android Automotive OS (AAOS) 中的網路

本頁說明如何以可擴充且維護成本低的方式,在 Android Automotive 硬體裝置上模擬不同的網路狀況。這個環境無關的網路模擬工具使用可在 Android Automotive 硬體裝置上執行的常用 Linux 工具。

以下各節將說明如何在 Android Automotive 硬體裝置上設定及執行網路模擬作業。

核心需求

如要在測試裝置 (DUT) 上啟用網路模擬功能,請務必在核心設定檔中設定 Linux ifbnetem 模組,如下所示:

# Network simulation config fragment start
CONFIG_NET_SCH_NETEM=y
CONFIG_IFB=y
CONFIG_NET_ACT_MIRRED=y
# Network simulation config fragment end

設定模擬作業

所有網路模擬或節流模擬作業都必須在測試裝置 (DUT) 上進行。這項模擬作業會使用 Linux tcNetEm 公用程式,根據控制政策和規則控管網路介面控制器 (NIC) 上的網路流量。

如要設定模擬作業,請執行下列操作:

  1. 將 DUT 和主機伺服器連上網際網路。
  2. 複製 NetworkSimulation.sh 指令碼部分提供的程式碼,並在主機伺服器上下載,即可建立 NetworkSimulation.sh 指令碼。
  3. 將主機伺服器連線至 DUT。執行 adb devices -l,確認 DUT 是否顯示在已連結裝置的清單中。

如需設定架構的圖解說明,請參閱下圖:

nw-sim

圖 1. 設定架構。

NetworkSimulation.sh 指令碼

NetworkSimulation.sh 指令碼檔案包含執行網路模擬的 adb 指令。將下列內容複製到名為 NetworkSimulation.sh 的檔案中:

  #!/bin/bash

  latency=$1
  bandwidth=$2
  packetloss=$3

  # root device and set it to permissive mode
  adb root
  adb shell setenforce 0

  #Clear the current tc control
  adb shell tc qdisc del dev ifb0 root
  adb shell ip link set dev ifb0 down
  adb shell tc qdisc del dev wlan0 ingress
  adb shell tc qdisc del dev wlan0 root

  # Create a virtual device for ingress
  adb shell ip link set dev wlan0 up
  adb shell ip link set dev ifb0 up
  adb shell tc qdisc del dev wlan0 clsact
  adb shell tc qdisc add dev wlan0 handle ffff: ingress
  adb shell tc filter add dev wlan0 parent ffff: protocol all u32 match u32 0 0 action mirred egress redirect dev ifb0

  # Throttle upload bandwidth / latency / packet loss
  adb shell tc qdisc add dev wlan0 root handle 1: htb default 11
  adb shell tc class add dev wlan0 parent 1: classid 1:1 htb rate "$bandwidth"
  adb shell tc class add dev wlan0 parent 1:1 classid 1:11 htb rate "$bandwidth"
  adb shell tc qdisc add dev wlan0 parent 1:11 handle 10: netem delay "$latency" loss "$packetloss"

  # Throttle download bandwidth
  adb shell tc qdisc add dev ifb0 root handle 1: htb default 10
  adb shell tc class add dev ifb0 parent 1: classid 1:1 htb rate "$bandwidth"
  adb shell tc class add dev ifb0 parent 1:1 classid 1:10 htb rate "$bandwidth"

執行模擬

如要執行網路模擬,NetworkSimulation.sh 指令碼檔案中的 adb 指令會使用指令列引數來設定值。

如要指定要模擬的延遲時間、頻寬和封包遺失,請使用下列指令列引數執行 NetworkSimulation.sh 指令碼:

  • 延遲時間,以毫秒為單位。
  • 頻寬,以 kbit 或 mbit 為單位。
  • 封包遺失率 (百分比)。

舉例來說,如要設定 300 毫秒的延遲時間、100kbit 的頻寬和 50% 的封包損失,請執行以下命令:

bash NetworkSimulation.sh 300ms 100kbit 50%

如要設定 100 毫秒的延遲時間、1 位元頻寬和 0% 的封包遺失率,請執行以下指令:

bash NetworkSimulation.sh 100ms 1mbit 0%

驗證模擬作業

執行 NetworkSimulation.sh 指令碼後,請使用 Linux pingcurl 指令,確認網路模擬功能已正確設定,且運作正常。請使用 ping 指令驗證延遲時間,並使用 curl 指令驗證頻寬。

舉例來說,以下是 ping 的預期輸出內容,適用於使用 bash NetworkSimulation.sh 100ms 500kbit 10% 執行的模擬作業:

BUILD:/ # ping -c 20 www.google.com
PING www.google.com (172.217.5.100) 56(84) bytes of data.
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=1 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=2 ttl=119 time=105 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=3 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=5 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=6 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=7 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=9 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=10 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=11 ttl=119 time=185 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=12 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=13 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=14 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=15 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=16 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=17 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=18 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=19 ttl=119 time=103 ms
64 bytes from sfo03s07-in-f4.1e100.net (172.217.5.100): icmp_seq=20 ttl=119 time=103 ms

--- www.google.com ping statistics ---
20 packets transmitted, 18 received, 10% packet loss, time 19040ms
rtt min/avg/max/mdev = 103.394/108.307/185.756/18.791 ms

這個範例顯示 ping 回報的封包遺失率為 10%,平均延遲時間則接近 108 毫秒,這與模擬中指定的 100 毫秒值相符。回報的延遲時間與指定值略有差異,這是正常現象。

以同一個範例來說,以下是執行 curl 指令的預期輸出內容。

BUILD:/sdcard/DCIM # curl https://images-assets.nasa.gov/image/PIA15416/PIA15416~orig.jpg -o foo.jpg
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 6598k  100 6598k    0     0  49220      0  0:02:17  0:02:17 --:--:-- 47574

這個範例顯示 curl 回報的平均下載速度為 49220 Bps,這與模擬中指定的 500kbit 一致。回報的頻寬與指定值略有差異,這是正常現象。