Hotspot Wi-Fi (Soft AP)

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

Fitur soft AP memungkinkan konfigurasi berikut:

  • SSID dan BSSID
  • Jenis keamanan (termasuk WPA3)
  • SSID Tersembunyi
  • Pita operasi dan saluran (termasuk ACS)
  • Jumlah maksimum klien yang diizinkan
  • Nilai waktu tunggu penonaktifan otomatis
  • Daftar yang diizinkan dan yang tidak diizinkan untuk memungkinkan kontrol pengguna atas perangkat terkait
  • Tingkat pengacakan MAC untuk AP BSSID
  • 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

Implementasi default hotspot Wi-Fi yang di-tethering disediakan oleh aplikasi Setelan AOSP, tetapi tidak menjalankan semua API untuk konfigurasi Soft AP.

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 yang di-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 bisa mendapatkan 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 berikut untuk pemblokiran tersebut: perangkat mencapai jumlah maksimum klien yang dapat didukungnya atau klien tidak secara eksplisit diizinkan untuk terhubung.

Untuk hotspot yang di-tethering:

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

Untuk hotspot khusus lokal:

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

Menerapkan daftar izin dan blokir

Persyaratan operator umum adalah memberi pengguna kontrol perangkat yang diizinkan untuk dikaitkan ke Soft AP. Ada beberapa mekanisme untuk melakukannya:

  • Batasi jumlah maksimum perangkat yang dapat dikaitkan ke soft AP menggunakan SoftApConfiguration.Builder#setMaxNumberOfClients. Pastikan untuk menentukan angka yang lebih rendah dari jumlah maksimum klien yang didukung oleh perangkat. Anda bisa mendapatkan jumlah maksimum dari SoftApCapability#getMaxSupportedClients.

  • Menyediakan kontrol dinamis menggunakan daftar izinkan dan blokir:

    • Konfigurasi default Soft AP memungkinkan semua perangkat dikaitkan ke soft AP, kecuali untuk 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 berada di SoftApConfiguration.Builder#setBlockedClientList akan diblokir dari asosiasi.
      • Semua perangkat yang alamat MAC-nya berada di SoftApConfiguration.Builder#setAllowedClientList diizinkan untuk dikaitkan.
      • Semua perangkat lain (yaitu, perangkat yang alamat MAC-nya tidak ada dalam daftar yang diizinkan atau diblokir) diblokir dari pengaitan, tetapi SoftApCallback#onBlockedClientConnecting akan dipanggil, sehingga aplikasi pengontrol (yaitu aplikasi Setelan) dapat mengambil tindakan, misalnya, meminta konfirmasi pengguna dan kemudian menambahkan perangkat ke daftar yang diizinkan atau ke daftar blokir, 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).

Penerapan

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

  • Aplikasi setelan: Aplikasi Setelan AOSP menyediakan dasar pengukuran untuk mengonfigurasi hotspot tethering dengan SSID dan kredensial keamanan. Kode ini dapat digunakan sebagaimana adanya atau dimodifikasi untuk memberikan kemampuan tambahan seperti yang dijelaskan dalam Mengembangkan aplikasi dengan API hotspot.

  • Framework: Kode framework AOSP mendukung semua fungsi yang dijelaskan dalam Mengembangkan aplikasi dengan API hotspot.

  • HAL/firmware untuk hotspot: HiDL IHostapd.hal versi 1.2 atau yang lebih tinggi, atau IHostapd.aidl AIDL.

Penyesuaian

Untuk menyesuaikan implementasi tersebut, produsen perangkat harus mengonfigurasi konfigurasi operator dan overlay berikut, yang didokumentasikan dalam 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 batasan minimum 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 memutuskan koneksi klien secara paksa. Diperlukan untuk mengaktifkan daftar izinkan dan blokir. Dikomunikasikan ke aplikasi yang mengontrol (aplikasi Setelan) melalui SoftApCapabilities#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).
  • (Tersedia mulai 13) config_wifiSoftapPassphraseAsciiEncodableCheck: Apakah frasa sandi soft AP harus dapat dienkode ASCII atau tidak.
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported: Apakah akan otomatis mengupgrade konfigurasi setelan band ke dual band 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 pembaruan 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 nilai ini ditetapkan ke true secara default, yang berarti nilai tersebut direset. Hal ini sangat penting jika perangkat baru tidak mendukung konfigurasi.
  • Kemampuan hardware:
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (Tersedia dari 13 model) config_wifiSoftapOweTransitionSupported
    • (Tersedia dari 13 model) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (Tersedia dari 13 model) 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.

  • Pengujian layanan:

    atest packages/modules/Wifi/service/tests/wifitests/

  • Pengelola menguji:

    atest packages/modules/Wifi/framework/tests/

Pengujian Compatibility Test Suite (CTS)

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

Untuk memicu uji 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