Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Wi-Fi STA/STA Konkurensi

Android 12 memperkenalkan konkurensi Wi-Fi STA/STA, yang memungkinkan perangkat terhubung ke dua jaringan Wi-Fi secara bersamaan. Fitur opsional ini mengaktifkan fungsi berikut.

  • Make-sebelum-break: Perangkat membuat koneksi ke jaringan Wi-Fi baru sebelum melanggar koneksi yang ada. Ini menghasilkan transisi yang lebih mulus saat beralih di antara jaringan Wi-Fi
  • -Satunya lokal dan koneksi internet bersamaan: Perangkat menghubungkan ke-lokal jaringan tanpa mengganggu koneksi internet-menyediakan utama perangkat.
  • Bersamaan terbatas dan koneksi internet: Perangkat menghubungkan ke jaringan yang dibatasi (hanya tersedia untuk aplikasi istimewa tertentu) tanpa mengganggu koneksi internet-menyediakan utama perangkat.

Halaman ini menjelaskan perilaku perangkat saat fitur ini diaktifkan dan detail implementasi untuk produsen dan vendor perangkat.

Penerapan

Perangkat harus mendukung hal berikut untuk menerapkan konkurensi Wi-Fi STA/STA:

  • Chip atau firmware Wi-Fi harus mendukung dua koneksi STA bersamaan. Firmware harus mendukung semua kombinasi saluran dan pita untuk kedua koneksi. Untuk menghindari masalah kinerja, sebaiknya gunakan chip Wi-Fi berkemampuan 2x2+2x2 DBS.

  • Perangkat harus mendukung API berikut di penjual HAL versi 1.5

    • IWifiChip.setMultiStaPrimaryConnection()
    • IWifiChip.setMultiStaUseCase()
  • Kombinasi antarmuka Wi-Fi HAL harus memiliki dua STA antarmuka bersamaan terkena menggunakan format specifaction seperti [{STA} <= 2, ...] . Untuk informasi lebih lanjut, lihat Wi-Fi multi-interface concurrency .

Jika prasyarat tersebut terpenuhi, terapkan konkurensi Wi-Fi STA/STA dengan melakukan hal berikut:

  1. Aktifkan satu atau lebih fungsi individual menggunakan lapisan sumber daya runtime (dinonaktifkan secara default).

    • Make-sebelum-break: config_wifiMultiStaNetworkSwitchingMakeBeforeBreakEnabled
    • Bersamaan lokal saja dan koneksi internet: config_wifiMultiStaLocalOnlyConcurrencyEnabled
    • Bersamaan dibatasi dan koneksi internet: config_wifiMultiStaRestrictedConcurrencyEnabled
  2. Validasi setiap implementasi seperti yang dijelaskan di bagian masing-masing di bawah ini.

Untuk dukungan yang lebih baik Wi-Fi STA / STA concurrency, kami merekomendasikan bahwa kerangka OEM-disesuaikan dan aplikasi menggunakan NetworkCallback#onCapabilitiesChanged() metode bukannya WifiManager#getConnectionInfo() , yang hanya mengembalikan WifiInfo untuk jaringan tunggal dan usang dalam Android 12 . untuk informasi lebih lanjut, lihat Jaringan Wi-Fi Permintaan API untuk konektivitas peer-to-peer .

Buat-sebelum-istirahat

Fungsi make-sebelum-break memungkinkan perangkat untuk connnect ke jaringan Wi-Fi baru sambil mempertahankan yang sudah ada koneksi jaringan Wi-Fi, hanya memutuskan hubungan dari jaringan lama ketika berhasil menghubungkan ke jaringan Wi-Fi yang baru dan memiliki akses internet.

Kasus penggunaan make-before-break mengatasi masalah berikut di Android 11 atau lebih rendah, di mana perangkat harus memutuskan sambungan dari jaringan Wi-Fi yang ada sebelum menyambung ke jaringan baru (break-before-make).

  • Saat menyambung ke jaringan baru, perangkat mungkin menemukan bahwa sandi Wi-Fi tersimpan salah atau jaringan baru tidak memiliki akses internet. Ini memaksa perangkat untuk beralih kembali ke jaringan lama, yang menyebabkan sejumlah besar waktu tanpa konektivitas Wi-Fi.

  • Jaringan lama terputus secara tiba-tiba, yang berarti semua soket ditutup. Aplikasi sering kali tidak bereaksi dengan baik terhadap hilangnya konektivitas secara tiba-tiba dan ini dapat menyebabkan pengguna mengalami beberapa detik tanpa konektivitas internet hingga koneksi baru sepenuhnya tersambung.

  • Jaringan default berubah dua kali, dari jaringan Wi-Fi lama ke seluler, lalu dari seluler ke jaringan Wi-Fi baru. Ini menyebabkan aplikasi bereaksi terhadap perubahan jaringan dua kali. Perangkat juga harus menghabiskan sedikit waktu menggunakan data seluler.

Alur make-before-break hanya digunakan untuk sakelar jaringan Wi-Fi otomatis yang dimulai oleh OS. Sakelar jaringan yang diprakarsai pengguna menggunakan aliran break-before-make lama, di mana jaringan sebelumnya sepenuhnya terputus sebelum jaringan baru terhubung. Dalam kasus tertentu, aliran break-before-make digunakan bahkan dalam sakelar otomatis yang dimulai oleh OS, misalnya, ketika beralih di antara dua jaringan yang keduanya dikonfigurasi untuk menggunakan alamat MAC pabrik.

Aplikasi dapat memeriksa apakah kasus penggunaan ini didukung pada perangkat menggunakan WifiManager#isMakeBeforeBreakWifiSwitchingSupported() API.

Memvalidasi make-before-break

Untuk memvalidasi penerapan Anda, picu sakelar jaringan Wi-Fi otomatis (dengan memastikan jaringan dengan kekuatan sinyal yang lebih kuat dari jaringan yang terhubung saat ini tersedia) dan verifikasi bahwa perangkat mempertahankan koneksi yang ada saat menghubungkan ke jaringan baru. Untuk melihat status kedua antarmuka Wi-Fi dan memverifikasi bahwa keduanya terhubung, gunakan perintah berikut.

adb shell wpa_cli -i wlan0 status ; echo ; adb shell wpa_cli -i wlan1 status

Jika jaringan baru tidak memiliki konektivitas, perangkat mencoba menyambung ke jaringan, sambil mempertahankan koneksi dengan jaringan yang ada, dan membatalkan upaya saat mendeteksi jaringan baru tidak memiliki internet. Perangkat kemudian melanjutkan menggunakan koneksi yang ada sebagai jaringan Wi-Fi utama.

Koneksi lokal dan internet secara bersamaan

Fungsi lokal saja dan koneksi internet bersamaan memungkinkan perangkat untuk terhubung ke lokal hanya conection, seperti koneksi ke perangkat IOT, bersamaan dengan jaringan internet yang menyediakan primer. Fungsi ini meningkatkan pengalaman pengguna ketika langsung menghubungkan ke perangkat IOT, seperti kamera, yang dimungkinkan melalui WifiNetworkSpecifier API ditambahkan dalam Android 10.

Di Android 11 dan yang lebih rendah, perangkat terputus dari jaringan Wi-Fi utama saat tersambung ke perangkat IoT, yang mengakibatkan hilangnya konektivitas internet (kecuali perangkat memiliki jenis transportasi lain yang tersedia, seperti data seluler).

Aplikasi dapat memeriksa apakah fungsi ini didukung pada perangkat menggunakan WifiManager#isStaConcurrencyForLocalOnlyConnectionsSupported() API.

Untuk informasi lebih lanjut tentang perubahan bersamaan lokal saja dan koneksi internet fungsi di Android 12, lihat Jaringan Wi-Fi Permintaan API untuk konektivitas peer-to-peer .

Memvalidasi koneksi lokal dan internet saja

Untuk memvalidasi fungsi ini, gunakan tes CTS dan ACTS berikut:

  • CTS: MultiStaConcurrencyWifiNetworkSpecifierTest
  • ACTS: WifiStaConcurrencyNetworkRequestTest

Pembatasan bersamaan dan koneksi internet

Bersamaan dengan dibatasi dan fungsi koneksi internet memungkinkan perangkat untuk conccurently terhubung ke jaringan Wi-Fi utama bagi pengguna dan dibatasi jaringan Wi-Fi yang hanya tersedia untuk memilih aplikasi.

Aplikasi dapat memeriksa apakah fungsi ini didukung pada perangkat menggunakan WifiManager#isStaConcurrencyForRestrictedConnectionsSupported() API.

Untuk mengaktifkan perangkat agar terhubung ke jaringan Wi-Fi terbatas sekunder, ikuti langkah-langkah berikut:

  1. Menambahkan saran jaringan Wi-Fi dengan setOemPaid atau setOemPrivate set ke true.

  2. Dalam ConnectivityManager , mengajukan NetworkRequest dengan kemampuan yang sesuai:

Saat perangkat mendeteksi hasil pemindaian dengan jaringan yang cocok dengan saran OEM berbayar atau pribadi OEM, perangkat akan secara otomatis menghubungkannya sebagai jaringan sekunder.

Memvalidasi koneksi terbatas dan internet bersamaan

Untuk memvalidasi fungsi ini, gunakan tes CTS dan ACTS berikut:

  • CTS: MultiStaConcurrencyRestrictedWifiNetworkSuggestionTest
  • ACTS: WifiStaConcurrencyNetworkRequestTest

Panduan chip Wi-Fi vendor

Untuk vendor chip Wi-Fi, gunakan panduan berikut untuk mendukung konkurensi Wi-Fi STA/STA.

Chip Wi-Fi harus mendukung koneksi STA ganda secara bersamaan. Ini berarti mendukung hal-hal berikut:

  • Setiap antarmuka STA memiliki MAC unik yang dapat diprogram oleh kerangka kerja.
  • Antarmuka STA sekunder dapat dibuat dan dihancurkan secara dinamis.
  • Setiap STA dapat dihubungkan ke SSID yang berbeda (baik dalam band yang sama atau band yang berbeda).
  • Setiap STA dapat dihubungkan ke SSID yang sama (baik dalam band yang sama atau band yang berbeda). Kedua STA tidak boleh terhubung ke BSSID yang sama.

Fitur-fitur penting harus beroperasi pada basis per-antarmuka dan mereka harus tersedia pada antarmuka utama. Berikut ini adalah daftar fitur penting tersebut:

  • Roaming harus didukung setidaknya antarmuka utama (set menggunakan IWifiChip.setMultiStaPrimaryConnection() ). Jika roaming didukung pada kedua antarmuka, keputusan pada satu koneksi tidak boleh berbenturan dengan koneksi konkuren kedua. Misalnya, satu antarmuka tidak boleh menjelajah ke BSSID dari koneksi lainnya.

  • APF (dan offloads lainnya seperti ARP dan NS) harus didukung setidaknya antarmuka utama (set menggunakan IWifiChip.setMultiStaPrimaryConnection() ).

  • Statistik lapisan tautan harus beroperasi pada basis per antarmuka.

Berikut ini adalah implementasi chip Wi-Fi yang direkomendasikan untuk skenario konkurensi yang berbeda:

  • Chip Wi-Fi harus memungkinkan kerangka kerja untuk memanggil IWifiChip.setMultiStaUseCase() dengan salah satu dari konstanta berikut untuk menentukan fungsi saat ini:

    • DUAL_STA_TRANSIENT_PREFER_PRIMARY : Menentukan fungsi Make-Sebelum-Break. Kualitas sambungan primer harus diprioritaskan daripada sambungan sekunder.
    • DUAL_STA_NON_TRANSIENT_UNBIASED : Menentukan bersamaan lokal saja dan koneksi internet atau bersamaan dibatasi dan fungsi koneksi internet. Kualitas kedua koneksi harus diprioritaskan secara seimbang.
  • Karena STA bersamaan ganda dapat menyebabkan mode PKS, SCC, dan DBS operasi, pelaksanaan penjual harus memilih konfigurasi radio terbaik saat kerangka panggilan IWifiChip.setMultiStaUseCase() untuk menunjukkan fungsi. Berikut ini adalah pedoman umum:

    • 2x2+2x2 DBS lebih disukai jika tersedia.
    • Hindari 1x1+1x1 DBS jika memungkinkan karena dampak yang berlebihan pada kualitas koneksi. Sebaliknya, lebih suka PKS.
    • Siklus tugas MCC harus dapat dikonfigurasi oleh driver atau firmware untuk berbagai fungsi. Kerangka kerja ini tidak mengatur siklus PKS secara langsung, tetapi query informasi ini menggunakan StaLinkLayerIfaceStats.timeSliceDutyCycleInPercent .
    • Jika menggunakan MCC, kami merekomendasikan siklus tugas berikut antara koneksi primer dan sekunder:

      • DUAL_STA_TRANSIENT_PREFER_PRIMARY : 70% primer, 30% sekunder.
      • DUAL_STA_NON_TRANSIENT_UNBIASED : 50% primer, 50% sekunder.