Supports Association express et notes techniques

Cette page décrit les informations utiles dont les partenaires ont besoin pour la planification de projets et l'intégration de systèmes avec l'Association express.

Matériel et processus de l'Association express

Cette section fournit des liens vers des informations générales sur le marketing et les processus.

Marketing, branding et messages

Consultez notre portail marketing pour les partenaires pour obtenir des conseils sur le branding et les messages. Les nouveaux partenaires doivent demander l'accès, tandis que les partenaires existants peuvent déjà accéder au contenu via leur compte de domaine partenaire.

Cycle de vie du projet d'Association express

Consultez la page Rôles et responsabilités de l'intégrateur de systèmes pour obtenir une description générale du cycle de vie du projet et des responsabilités des partenaires qui intègrent l'Association express dans un produit.

Processus de certification

Les appareils qui implémentent l'Association express doivent être certifiés avant qu'un produit puisse être commercialisé avec cette fonctionnalité. Les consignes de certification de l'Association express décrivent comment se préparer à la certification et effectuer des auto-tests avant la certification.

La FAQ sur la certification couvre diverses questions courantes, y compris une description générale des cas où une certification complète (ou une recertification) est requise.

Les appareils qui implémentent ou utilisent des extensions de l'Association express, telles que le switch audio, doivent également être certifiés. Le switch audio dispose de consignes de certification distinctes qui décrivent les étapes de son auto-test et sa préparation à la certification par un laboratoire tiers.

Les laboratoires tiers peuvent certifier l'Association express et le switch audio de manière séquentielle. Consultez la page Envoyer des appareils à des laboratoires tiers pour savoir quels laboratoires proposent quels services de certification.

Remarques d'ordre technique

Cette section décrit quelques remarques techniques sur l'implémentation pour aider les partenaires à développer et à intégrer.

Diffuser d'autres protocoles en même temps que l'Association express

Certains appareils peuvent vouloir prendre en charge des fonctionnalités supplémentaires en plus de l'Association express, telles que l'Assistant Google ou Eddystone, qui nécessitent un espace publicitaire supplémentaire. La rotation des données publicitaires est la meilleure option dans ces cas. Toutefois, les annonces de l'Association express doivent toujours être diffusées dans l'intervalle publicitaire , conformément au mode détectable et au mode non détectable.

La rotation des annonces est testée lors de la phase de test par un tiers du processus de certification. Veillez à vérifier tous les schémas de rotation avec l'application de validation de l'Association express avant la certification pour éviter d'éventuels retards, de nouveaux tests et des coûts supplémentaires.

Raccourcir l'intervalle de connexion BLE

Pour améliorer les performances de création de la connexion GATT, le fournisseur doit rendre l'intervalle de connexion aussi court que possible. La valeur optimale attendue est de 7,5 ms, qui est appliquée à la plupart des demandeurs.

État de la connexion BLE et du casque

Le fait qu'un casque d'Association express diffuse l'ID de modèle ou les données de compte dépend du mode visible BR/EDR du casque, et non de l'état connecté ou déconnecté. Consultez la spécification du service d'Association express à partir des liens ci-dessous :

• "Lorsque l'appareil fournisseur est détectable en mode BR/EDR (c'est-à-dire en mode association), il doit diffuser les données d'ID de modèle de l'Association express via BLE." - lien
• "Lorsqu'il n'est pas détectable (c'est-à-dire qu'il n'est pas en mode association), le fournisseur doit diffuser les données de compte de l'Association express" - lien

TxPower

Comme défini dans la spécification, le demandeur estime la distance par le RSSI en fonction du niveau de TxPower donné. La distance estimée est le facteur clé pour déterminer s'il faut afficher ou non la notification.

Le processus de détermination de TxPower est le suivant :

1. Mesurez la sortie réelle de l'appareil à l'aide d'un téléphone Android à 1 mètre, puis ajoutez 41 dBm à cette valeur.
2. Incluez cette valeur dans l'annonce BLE.
3. Incluez cette valeur avec les informations du téléphone de test dans le rapport d'auto-test.

Remarque : La valeur TxPower stockée dans la console d'appareil permet aux partenaires de mettre à jour la valeur TxPower dans les appareils expédiés. L'envoi d'une valeur TxPower à la console d'appareil n'est pas obligatoire, et toute valeur de la console d'appareil remplace tous les paramètres TxPower de l'appareil.

Mesurer et définir TxPower avec l'application de validation

L'application de validation fournit un test permettant d'ajuster manuellement TxPower au niveau approprié sur un appareil en cours de test. Les partenaires peuvent utiliser ce test pour déterminer le niveau de TxPower approprié sur leur appareil en cours de test avant le Test automatique ou la certification.

Remarque : N'oubliez pas de définir le niveau de TxPower sur l'appareil en cours de test et dans la console d'appareil une fois le test terminé.

Procédure de mesure de TxPower

Pour mesurer TxPower avec l'application de validation :

1. Ouvrez l'application de validation sur l'appareil en cours de test.
2. Ouvrez le menu à trois points en haut de l'application :

   

3. Placez l'appareil en cours de test à 1 mètre du téléphone et appuyez sur le bouton "DÉMARRER".

   

4. Sélectionnez l'appareil en cours de test dans la liste des appareils.

   

   1. Vous pouvez actualiser la liste des appareils en appuyant sur le bouton "ANNULER" et en sélectionnant à nouveau le bouton "DÉMARRER".
5. Ajustez la ligne rouge (représentant TxPower) jusqu'à ce qu'elle touche à peine le haut de la zone jaune.

   

   1. Utilisez le bouton "-1" pour déplacer la ligne rouge vers la zone jaune.
   2. Utilisez le bouton "+1" pour éloigner la ligne rouge de la zone jaune.
   3. Les interférences de signal peuvent rendre la ligne rouge instable. Si la ligne rouge se comporte de manière erratique, essayez de vous déplacer dans une zone où les interférences de signal sont moins importantes.
6. Enregistrez la valeur TxPower et mettez-la à jour à la fois dans l'appareil en cours de test et dans la console d'appareil.

   

Notifications liées à la batterie

Comme défini dans la spécification, le fournisseur peut inclure des informations sur la batterie dans l'annonce. Le demandeur décide d'afficher ou de masquer la notification de batterie en fonction du type : 0b0011 pour afficher la notification de batterie ou 0b0100 pour la masquer. Voici quelques consignes sur le moment où inclure les informations sur la batterie dans l'annonce et sur le type à utiliser :

1. Incluez les informations sur la batterie dans l'annonce avec la notification de batterie 0b0011 pendant au moins 8 secondes lorsque l'étui est ouvert et que les deux écouteurs sont insérés.
2. Incluez les informations sur la batterie dans l'annonce avec la notification de batterie 0b0100 pendant au moins 5 secondes lorsque l'étui est fermé et que les deux écouteurs sont insérés.
3. Pour afficher ou masquer les notifications de batterie de manière réactive, l'annonce doit refléter l'état réel dans les deux secondes.
4. Il existe deux façons de masquer la notification de batterie :
   1. Arrêtez d'inclure des informations sur la batterie dans l'annonce. Le demandeur masque la notification au bout d'un certain temps (actuellement défini sur 20 secondes).
   2. Incluez les informations sur la batterie dans l'annonce avec la notification de batterie 0b0100. Le demandeur masque immédiatement la notification dès qu'il reçoit l'annonce.
5. Il est facultatif d'inclure les informations sur la batterie dans l'annonce si un seul écouteur est inséré lorsque l'étui est ouvert ou fermé.
6. Il est facultatif d'inclure les informations sur la batterie dans l'annonce lorsque les écouteurs sont retirés de l'étui ou insérés dans l'étui.
7. Pour éviter le suivi, le fournisseur ne doit inclure que les données brutes de la batterie dans l'annonce lorsque cela est nécessaire (pas tout le temps).

L'implémentation doit être décrite dans le résultat de l'auto-test pour la certification.

Activer la journalisation de l'Association express

Assurez-vous d'avoir activé le journal snoop HCI Bluetooth sur l'appareil avant le débogage. De plus, pour éviter que les journaux clés de l'Association express ne soient expurgés pour des raisons de sécurité, rejoignez le groupe Google de test des partenaires de l'Association express ([e-mail]) avec vos comptes Google de test.

Pour capturer les messages de l'Association express dans vos journaux de débogage, exécutez la commande suivante :

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google recommande d'exécuter les commandes précédentes à chaque séquence de démarrage.

Remarque : Les journaux VERBOSE peuvent être supprimés dans les builds de production.

Extraire un journal de débogage

Exécutez $ adb bugreport pour générer un fichier ZIP contenant toutes les données. La génération du fichier ZIP peut prendre plusieurs minutes.

En fonction de la version d'Android, exécutez l'une des commandes suivantes pour obtenir btsnoop_hic.log :

• Pour Android 8.x et versions ultérieures : shell $ adb pull data/misc/bluetooth/logs logs
• Pour Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log

Remarque : Google recommande de laisser le téléphone à côté de l’appareil Bluetooth pendant quelques minutes avant de tenter de télécharger le fichier ZIP du rapport de bug.