Point d'accès Wi-Fi (Soft AP)

Android est compatible avec les points d'accès Wi-Fi (Soft AP), y compris le partage de connexion via un point d'accès Wi-Fi et les points d'accès Wi-Fi locaux uniquement.

La fonctionnalité de point d'accès logiciel permet de configurer les éléments suivants:

  • SSID et BSSID
  • Type de sécurité (y compris WPA3)
  • SSID masqué
  • Bande de fonctionnement et canal (y compris ACS)
  • Nombre maximal de clients autorisés
  • Valeur du délai d'arrêt automatique
  • Ajouter des listes d'autorisation et de blocage pour permettre aux utilisateurs de contrôler les appareils associés
  • Niveau de randomisation MAC pour le BSSID du point d'accès
  • 802.11ax et 802.11be

La disponibilité de ces commandes dépend des capacités de l'appareil. Android 11 introduit des API pour obtenir ces fonctionnalités. Les fabricants d'appareils peuvent également spécifier les fonctionnalités de base des appareils à l'aide de superpositions.

Notez que certaines API sont des API système dont l'accès est limité via des autorisations afin que seule l'application Paramètres du système puisse y accéder.

Développer des applications avec les API des points d'accès

Une implémentation par défaut d'un point d'accès Wi-Fi partagé est fournie par l'application Paramètres AOSP, mais elle n'utilise pas toutes les API pour la configuration du point d'accès logiciel.

Pour permettre le partage de connexion via un point d'accès ou un point d'accès local uniquement, l'application doit effectuer les opérations suivantes:

  1. Enregistrez un rappel pour obtenir les fonctionnalités de l'appareil à l'aide de WifiManager#registerSoftApCallback pour un point d'accès partagé ou de WifiManager#registerLocalOnlyHotspotSoftApCallback pour un point d'accès local uniquement.

    Le rappel SoftApCallback fournit les méthodes suivantes:

    • SoftApCallback#onCapabilityChanged : fournit des informations sur les fonctionnalités de l'appareil, y compris le nombre maximal de clients compatibles et l'état SAE ou ACS.
    • SoftApCallback#onInfoChanged : fournit des informations sur le point d'accès souple en cours d'exécution (valide uniquement une fois démarré), y compris des informations sur la bande et la fréquence.
    • SoftApCallback#onConnectedClientsChanged : fournit la liste des clients connectés. Pour chaque client, vous pouvez obtenir l'adresse MAC. Pour obtenir les informations IP, utilisez le rappel TetheringEventCallback#onClientsChanged.
    • SoftApCallback#onStateChanged : fournit des mises à jour sur l'état du point d'accès logiciel lorsqu'il est activé et désactivé.
    • SoftApCallback#onBlockedClientConnecting : fournit les informations sur le client bloqué. L'une des raisons suivantes peut expliquer le blocage: l'appareil a atteint le nombre maximal de clients qu'il peut prendre en charge ou le client n'est pas explicitement autorisé à se connecter.

Pour un point d'accès partagé:

  1. Configurez la configuration du point d'accès logiciel pour le partage de connexion en appelant la méthode WifiManager#setSoftApConfiguration et en fournissant une instance SoftApConfiguration. Créez SoftApConfiguration à l'aide de la classe SoftApConfiguration.Builder.
  2. Démarrez le partage de connexion en appelant la méthode sur TetheringManager#startTethering.

Pour un point d'accès local uniquement:

  1. Démarrez le point d'accès local uniquement avec une configuration de point d'accès flexible spécifique en appelant la méthode WifiManager#startLocalOnlyHotspot.

Implémenter des listes d'autorisation et de blocage

Une exigence typique des opérateurs consiste à fournir à l'utilisateur les commandes des appareils autorisés à s'associer au point d'accès souple. Pour cela, il existe plusieurs mécanismes:

  • Limitez le nombre maximal d'appareils pouvant s'associer au point d'accès logiciel avec SoftApConfiguration.Builder#setMaxNumberOfClients. Veillez à spécifier un nombre inférieur au nombre maximal de clients pris en charge par l'appareil. Vous pouvez obtenir le nombre maximal à partir de SoftApCapability#getMaxSupportedClients.

  • Offrez un contrôle dynamique à l'aide de listes d'autorisation et de blocage:

    • La configuration par défaut d'un point d'accès partiel permet à tous les appareils de s'associer à ce point d'accès, à l'exception de ceux dont les adresses MAC sont ajoutées à SoftApConfiguration.Builder#setBlockedClientList.

    • Si le point d'accès souple est configuré avec SoftApConfiguration.Builder#setClientControlByUserEnabled(true), la liste d'autorisation est utilisée.

      • L'association est bloquée pour tous les appareils dont les adresses MAC se trouvent dans SoftApConfiguration.Builder#setBlockedClientList.
      • L'association est autorisée pour tous les appareils dont les adresses MAC se trouvent dans SoftApConfiguration.Builder#setAllowedClientList.
      • L'association est bloquée pour tous les autres appareils (c'est-à-dire les appareils dont les adresses MAC ne figurent pas dans la liste d'autorisation ou de blocage), mais SoftApCallback#onBlockedClientConnecting est appelé, ce qui permet à l'application de contrôle (c'est-à-dire l'application Paramètres) d'effectuer une action, par exemple demander confirmation à l'utilisateur, puis ajouter l'appareil à la liste d'autorisation ou à la liste de blocage en fonction du comportement de l'utilisateur.

    Notez que les appareils ne peuvent utiliser la fonctionnalité de liste d'autorisation que si elle est compatible avec eux. Vous pouvez vérifier la compatibilité de l'appareil à l'aide de SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).

Implémentation

Pour accepter le partage de connexion via un point d'accès ou un point d'accès local uniquement, les fabricants d'appareils doivent fournir l'application Paramètres, le framework et la compatibilité du micrologiciel/HAL:

Personnalisation

Pour personnaliser l'implémentation, les fabricants d'appareils doivent configurer les superpositions et les configurations d'opérateur suivantes, décrites dans packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml:

  • config_wifiFrameworkSoftApShutDownTimeoutMilliseconds: intervalle du délai avant expiration d'arrêt par défaut. Valide uniquement si SoftApConfiguration#setAutoShutdownEnabled est activé. Vous pouvez le remplacer à l'aide de SoftApConfiguration#setShutdownTimeoutMillis.
  • config_wifiHardwareSoftapMaxClientCount: limite matérielle pour le nombre maximal de clients compatibles. Le nombre maximal de clients compatibles avec l'appareil correspond au minimum des contraintes liées au matériel et à l'opérateur (spécifié par CarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT). Le résultat final est fourni à l'application avec SoftApCapabilities#getMaxSupportedClients.
  • config_wifiSofapClientForceDisconnectSupported: indique si l'appareil peut forcer la déconnexion d'un client. Requis pour activer les listes d'autorisation et de blocage. Communiqué à l'application de contrôle (application Paramètres) via SoftApCapabilities#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT).
  • (Disponible à partir de 13) config_wifiSoftapPassphraseAsciiEncodableCheck : indique si la phrase secrète du point d'accès logiciel doit être encodable en ASCII.
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported: indique si oui ou non la configuration des paramètres de bande doit être automatiquement mise à niveau vers le mode double bande lors de la restauration de la configuration cloud lorsqu'un nouvel appareil est pris en charge.
  • (Disponible à partir de 13) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled : indique si le framework ajoute automatiquement des bandes inférieures à la configuration des bandes pour éviter la gestion de la coexistence.
  • config_wifiSoftApDynamicCountryCodeUpdateSupported: indique si la mise à jour dynamique du code pays en mode PA est prise en charge ou non par l'appareil.
  • Canal compatible: config_wifiSoftap2gChannelList, config_wifiSoftap5gChannelList, config_wifiSoftap6gChannelList et config_wifiSoftap60gChannelList.
  • Restauration de la prise en charge en spécifiant si les entrées correspondantes sont réinitialisées aux valeurs par défaut lors de la restauration de la configuration du point d'accès sur un nouvel appareil : config_wifiSoftapResetChannelConfig, config_wifiSoftapResetHiddenConfig, config_wifiSoftapResetUserControlConfig, config_wifiSoftapResetAutoShutdownTimerConfig, config_wifiSoftapResetMaxClientSettingConfig. Notez qu'ils sont définis sur true par défaut, ce qui signifie qu'ils sont réinitialisés. Cette étape est essentielle si le nouvel appareil n'est pas compatible avec la configuration.
  • Capacités matérielles :
    • config_wifi_softap_acs_supported
    • config_wifi_softap_sae_supported
    • (À partir de 13) config_wifiSoftapOweTransitionSupported
    • (À partir de 13) config_wifiSoftapOweSupported
    • config_wifi_softap_ieee80211ac_supported
    • config_wifiSoftapIeee80211axSupported
    • (À partir de 13) config_wifiSoftapIeee80211beSupported
    • config_wifiSoftapMacAddressCustomizationSupported
    • config_wifiSoftapHeSuBeamformerSupported
    • config_wifiSoftapHeSuBeamformeeSupported
    • config_wifiSoftapHeMuBeamformerSupported
    • config_wifiSoftapHeTwtSupported
    • config_wifiSoftap24ghzSupported
    • config_wifiSoftap5ghzSupported
    • config_wifiSoftap6ghzSupported
    • config_wifiSoftap60ghzSupported
    • config_wifiSoftapAcsIncludeDfs

Validation

Android fournit un ensemble de tests unitaires et de tests CTS (Compatibility Test Suite) pour valider la fonctionnalité de point d'accès. La fonctionnalité de point d'accès peut également être testée à l'aide de la suite de tests fournisseurs (VTS).

Tests unitaires

Vérifiez le package de point d'accès à l'aide des tests suivants.

  • Tests du service:

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

  • Tests du responsable:

    atest packages/modules/Wifi/framework/tests/

Tests de la suite de tests de compatibilité (CTS)

Utilisez les tests CTS pour valider la fonctionnalité de point d'accès. CTS détecte quand la fonctionnalité est activée et inclut automatiquement les tests associés.

Pour déclencher les tests CTS, exécutez la commande suivante:

atest android.net.wifi.cts.WifiManagerTest

Suite de test pour les fournisseurs (VTS)

Si l'interface HIDL est implémentée, exécutez la commande suivante:

atest VtsHalWifiHostapdV1_2Target

Si l'interface AIDL est implémentée, exécutez la commande suivante:

atest VtsHalHostapdTargetTest