Hotspot Wi-Fi (Soft AP)

Android menyediakan dukungan untuk hotspot Wi-Fi (Soft AP) termasuk tethering melalui hotspot Wi-Fi dan hotspot Wi-Fi khusus lokal.

Fitur AP software memungkinkan konfigurasi berikut:

  • SSID dan BSSID
  • Jenis keamanan (termasuk WPA3)
  • SSID tersembunyi
  • Band dan saluran operasi (termasuk ACS)
  • Jumlah maksimum klien yang diizinkan
  • Nilai waktu tunggu penonaktifan otomatis
  • Daftar yang diizinkan dan daftar yang diblokir untuk mengizinkan kontrol pengguna atas perangkat terkait
  • Tingkat pengacakan MAC untuk BSSID AP
  • 802.11ax dan 802.11be

Kemampuan perangkat menentukan ketersediaan kontrol ini. Android 11 memperkenalkan API untuk mendapatkan kemampuan ini. Produsen perangkat juga dapat menentukan kemampuan perangkat dasar menggunakan overlay.

Perhatikan bahwa beberapa API adalah API sistem dan dibatasi melalui izin sehingga hanya aplikasi Setelan sistem yang dapat mengaksesnya.

Mengembangkan aplikasi dengan API hotspot

Penerapan default hotspot Wi-Fi yang di-tether disediakan oleh aplikasi Setelan AOSP, tetapi tidak menggunakan semua API untuk konfigurasi AP Soft.

Untuk mendukung tethering melalui hotspot atau hotspot khusus lokal, aplikasi harus menjalankan fungsi berikut:

  1. Daftarkan callback untuk mendapatkan kemampuan perangkat menggunakan WifiManager#registerSoftApCallback untuk hotspot tethering atau WifiManager#registerLocalOnlyHotspotSoftApCallback untuk hotspot khusus lokal.

    Callback SoftApCallback menyediakan metode berikut:

    • SoftApCallback#onCapabilityChanged: Memberikan informasi tentang kemampuan perangkat, termasuk jumlah maksimum klien yang didukung, dan apakah SAE atau ACS didukung.
    • SoftApCallback#onInfoChanged: Memberikan informasi tentang Soft AP yang sedang berjalan (hanya valid setelah dimulai), termasuk informasi band dan frekuensi.
    • SoftApCallback#onConnectedClientsChanged: Menyediakan daftar klien yang terhubung. Untuk setiap klien, Anda dapat memperoleh alamat MAC. Untuk mendapatkan informasi IP, gunakan callback TetheringEventCallback#onClientsChanged.
    • SoftApCallback#onStateChanged: Memberikan update tentang status Soft AP saat diaktifkan dan dinonaktifkan.
    • SoftApCallback#onBlockedClientConnecting: Memberikan informasi klien yang diblokir dengan salah satu alasan pemblokiran berikut: perangkat mencapai jumlah maksimum klien yang dapat didukungnya atau klien tidak secara eksplisit diizinkan untuk terhubung.
    • SoftApCallback#onClientsDisconnected: Menyediakan daftar klien yang terputus. Untuk setiap klien, Anda dapat mendapatkan alasan pemutusan koneksi.

Untuk hotspot yang di-tether:

  1. Konfigurasi konfigurasi AP lunak untuk tethering dengan memanggil metode WifiManager#setSoftApConfiguration dan memberikan instance SoftApConfiguration. Buat SoftApConfiguration menggunakan class SoftApConfiguration.Builder.
  2. Mulai penambatan dengan memanggil metode penambatan di TetheringManager#startTethering.

Untuk hotspot khusus lokal:

  1. Mulai hotspot khusus lokal dengan konfigurasi AP software tertentu dengan memanggil metode WifiManager#startLocalOnlyHotspot.

Menerapkan daftar yang diizinkan dan diblokir

Persyaratan umum operator adalah menyediakan kontrol kepada pengguna atas perangkat yang diizinkan untuk terhubung ke Soft AP. Ada beberapa mekanisme untuk melakukannya:

  • Batasi jumlah maksimum perangkat yang dapat dikaitkan ke AP soft menggunakan SoftApConfiguration.Builder#setMaxNumberOfClients. Pastikan untuk menentukan angka yang lebih rendah dari jumlah maksimum klien yang didukung oleh perangkat. Anda dapat memperoleh jumlah maksimum dari SoftApCapability#getMaxSupportedClients.
  • Menyediakan kontrol dinamis menggunakan daftar yang diizinkan dan diblokir:

    • Konfigurasi default Soft AP memungkinkan semua perangkat untuk terhubung ke Soft AP, kecuali perangkat yang alamat MAC-nya ditambahkan ke SoftApConfiguration.Builder#setBlockedClientList.
    • Jika Soft AP dikonfigurasi dengan SoftApConfiguration.Builder#setClientControlByUserEnabled(true), daftar yang diizinkan akan digunakan.

      • Semua perangkat yang alamat MAC-nya ada di SoftApConfiguration.Builder#setBlockedClientList akan diblokir agar tidak dapat berasosiasi.
      • Semua perangkat yang alamat MAC-nya ada di SoftApConfiguration.Builder#setAllowedClientList diizinkan asosiasi.
      • Semua perangkat lain (yaitu, perangkat yang alamat MAC-nya tidak ada dalam daftar yang diizinkan atau daftar yang diblokir) diblokir dari asosiasi, tetapi SoftApCallback#onBlockedClientConnecting dipanggil, sehingga aplikasi pengontrol (yaitu, aplikasi Setelan) dapat mengambil tindakan, misalnya, meminta konfirmasi pengguna, lalu menambahkan perangkat ke daftar yang diizinkan atau ke daftar yang diblokir, bergantung pada perilaku pengguna.

    Perhatikan bahwa perangkat hanya dapat menggunakan fungsi daftar yang diizinkan jika didukung di perangkat. Anda dapat memverifikasi dukungan perangkat menggunakan SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).

Implementasi

Untuk mendukung penambatan melalui hotspot atau untuk mendukung hotspot khusus lokal, produsen perangkat harus menyediakan aplikasi Setelan, framework, dan dukungan HAL/firmware:

Penyesuaian

Untuk menyesuaikan penerapan, produsen perangkat harus mengonfigurasi overlay dan konfigurasi operator berikut, yang didokumentasikan di packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml:

  • config_wifiFrameworkSoftApShutDownTimeoutMilliseconds: Interval waktu tunggu penonaktifan default. Hanya valid jika SoftApConfiguration#setAutoShutdownEnabled diaktifkan. Dapat diganti menggunakan SoftApConfiguration#setShutdownTimeoutMillis.
  • config_wifiHardwareSoftapMaxClientCount: Batasan hardware untuk jumlah maksimum klien yang didukung. Jumlah maksimum klien yang didukung perangkat adalah minimum dari batasan hardware dan operator (ditentukan oleh CarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT). Hasil akhir diberikan ke aplikasi dengan SoftApCapabilities#getMaxSupportedClients.
  • config_wifiSofapClientForceDisconnectSupported: Apakah perangkat memiliki kemampuan untuk memaksa pemutusan koneksi klien. Diperlukan untuk mengaktifkan daftar izinkan dan blokir. Dikirimkan ke aplikasi pengontrol (aplikasi Setelan) melalui SoftApCapabilities#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).
  • (Tersedia dari 13) config_wifiSoftapPassphraseAsciiEncodableCheck: Apakah frasa sandi AP software harus dapat dienkode ASCII atau tidak.
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported: Apakah akan mengupgrade konfigurasi setelan band secara otomatis ke band ganda selama pemulihan konfigurasi cloud saat perangkat baru didukung.
  • (Tersedia dari 13) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled: Apakah framework secara otomatis menambahkan band yang lebih rendah ke konfigurasi band untuk menghindari penanganan koeksistensi.
  • config_wifiSoftApDynamicCountryCodeUpdateSupported: Apakah update kode negara dinamis dalam mode AP didukung di perangkat atau tidak
  • Dukungan saluran: config_wifiSoftap2gChannelList, config_wifiSoftap5gChannelList, config_wifiSoftap6gChannelList, dan config_wifiSoftap60gChannelList.
  • Dukungan pemulihan yang menentukan apakah entri yang sesuai direset ke default saat memulihkan konfigurasi hotspot ke perangkat baru: config_wifiSoftapResetChannelConfig, config_wifiSoftapResetHiddenConfig, config_wifiSoftapResetUserControlConfig, config_wifiSoftapResetAutoShutdownTimerConfig, config_wifiSoftapResetMaxClientSettingConfig. Perhatikan bahwa setelan ini ditetapkan ke true secara default, yang berarti nilai akan direset. Hal ini sangat penting jika perangkat baru tidak mendukung konfigurasi.
  • Kemampuan hardware:
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (Tersedia mulai 13) config_wifiSoftapOweTransitionSupported
    • (Tersedia mulai 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (Tersedia mulai 13) config_wifiSoftapIeee80211beSupported
    • config_wifiSoftapMacAddressCustomizationSupported
    • config_wifiSoftapHeSuBeamformerSupported
    • config_wifiSoftapHeSuBeamformeeSupported
    • config_wifiSoftapHeMuBeamformerSupported
    • config_wifiSoftapHeTwtSupported
    • config_wifiSoftap24ghzSupported
    • config_wifiSoftap5ghzSupported
    • config_wifiSoftap6ghzSupported
    • config_wifiSoftap60ghzSupported
    • config_wifiSoftapAcsIncludeDfs

Validasi

Android menyediakan serangkaian pengujian unit dan pengujian Compatibility Test Suite (CTS) untuk memvalidasi fitur hotspot. Fitur hotspot juga dapat diuji menggunakan Vendor Test Suite (VTS).

Pengujian unit

Verifikasi paket hotspot menggunakan pengujian berikut.

  • Uji layanan:

    atest packages/modules/Wifi/service/tests/wifitests/
  • Pengujian pengelola:

    atest packages/modules/Wifi/framework/tests/

Pengujian Compatibility Test Suite (CTS)

Gunakan pengujian CTS untuk memvalidasi fitur hotspot. CTS mendeteksi saat fitur diaktifkan dan otomatis menyertakan pengujian terkait.

Untuk memicu pengujian CTS, jalankan:

atest android.net.wifi.cts.WifiManagerTest

Vendor Test Suite (VTS)

Jika antarmuka HIDL diimplementasikan, jalankan:

atest VtsHalWifiHostapdV1_2Target

Jika antarmuka AIDL diimplementasikan, jalankan:

atest VtsHalHostapdTargetTest