Exemples du SDK Bluetooth¶
Les exemples Bluetooth du SiFli-SDK constituent des points de départ ciblés pour un profil, un rôle ou un scénario radio ; ils ne sont pas des firmwares prêts à intégrer dans un produit. Commencez par le projet qui couvre l'exigence technique la plus exigeante du produit. Faites d'abord fonctionner l'exemple sans modification sur la carte cible, puis ajoutez les exigences du produit une par une.
Cette page classe par tâche d'ingénierie les exemples de Bluetooth classique, de BLE et de diffusion LE Audio présentés dans la documentation SF32LB58x. Le chemin sf32lb58x indique où la documentation est classée ; il ne garantit pas que chaque exemple fonctionne sur toutes les cartes SF32LB58x ni sur d'autres familles SF32. L'URL latest évolue. Pour la version ou le commit du SDK envisagé, consultez la section Supported Platforms de la page du projet concerné et utilisez uniquement les noms de cartes et instructions de compilation qui y figurent. Si la prise en charge de la carte et de la révision du SDK n'est pas explicitement établie, indiquez qu'elle est non vérifiée ; ne la déduisez ni de l'URL, ni d'un autre exemple, ni d'une carte au nom similaire. Même si la page indique « all platforms », vérifiez l'exemple avec la révision exacte du SDK et la configuration de la carte avant tout travail produit. La page de chaque projet indique également les paramètres menuconfig, le matériel de test et les limites.
Commencer par la bonne voie Bluetooth¶
| Besoin du produit | Commencer par | À valider avant l'intégration au produit |
|---|---|---|
| Un service BLE personnalisé ou une liaison avec une application compagnon | Périphérique BLE | Annonces, connexion, interface et comportement du service, reconnexion et validation avec le téléphone |
| L'appareil doit agir à la fois comme périphérique pour le téléphone et comme central pour un capteur | Central et périphérique BLE | Rôles GAP simultanés et répartition des rôles client et serveur GATT |
| Transfert de données BLE fiable | Débit BLE ou Transfert de fichiers BLE | Le flux de charge utile requis, les réglages de connexion et le comportement de récupération |
| Mise à jour du firmware Bluetooth | Périphérique avec OTA ou Central et périphérique avec OTA Pingpong | Rôles de mise à jour, reprise après interruption de la mise à jour, partitions et stratégie de retour arrière |
| Liaison série ou accès réseau via le téléphone en Bluetooth classique | SPP ou PAN | Le profil série ou l'accès réseau fourni par le téléphone, la compatibilité avec l'appareil pair et le comportement de reconnexion |
| Transport HCI sur UART entre l'hôte et un contrôleur BT/BLE | HCI sur UART (BT/BLE) | La frontière hôte/contrôleur, le transport UART et la configuration du contrôleur et de la carte cibles |
| Audio ou appels en Bluetooth classique | Récepteur de musique, Émetteur de musique ou HFP | Routage audio, synchronisation d'horloge, gestion des tampons, interopérabilité avec le téléphone et budget énergétique |
| Diffusion LE Audio | Émetteur de diffusion BAP ou Récepteur de diffusion BAP | Rôle de diffusion, chaîne audio, récepteur ou émetteur de test et marge temporelle |
Mise en service d'un exemple pour établir des preuves¶
Avant de modifier le projet, consignez la version exacte du SDK, le nom de la carte, la configuration, l'appareil pair ou l'application, les paramètres radio et les journaux attendus. Suivez ensuite ces étapes :
- Compilez et flashez l'exemple sans modification avec le nom exact de la carte et les instructions indiqués pour la version correspondante du SDK. Si le lien entre la documentation et la révision du SDK, ou la prise en charge de la carte, n'est pas établi, considérez la compatibilité comme non vérifiée avant toute adaptation.
- Démontrez le comportement radio principal : découverte, connexion, transfert, diffusion ou réception, selon le cas.
- Répétez le test après une réinitialisation, une déconnexion, une reconnexion et un cycle complet d'arrêt et de remise sous tension.
- Ajoutez une seule exigence produit à la fois : service, parcours utilisateur, chemin audio ou politique de consommation.
- Retestez le système sous la charge combinée du produit, avec l'écran, les capteurs, le stockage, l'audio et, le cas échéant, les transitions basse consommation.
Un exemple fonctionnel ne démontre que le scénario qu'il couvre. Il ne prouve pas que la politique de sécurité, la portée radio, la latence, la consommation électrique ou l'interopérabilité du produit sont prêtes pour la mise en production.
Exemples BLE¶
Utilisez les exemples BLE pour les liaisons avec une application compagnon, les services GATT interopérables, les balises, le transfert de données et l'OTA basé sur BLE. Sélectionnez d'abord un exemple orienté rôle, puis ajoutez un exemple de profil uniquement lorsque le produit a besoin de ce service standardisé.
| Tâche d'ingénierie | Exemples officiels | Ce que ces projets permettent de valider |
|---|---|---|
| Rôles fondamentaux et accès aux services | Périphérique, Central et périphérique, Connexions multiples | Annonces, balayage, gestion des connexions et répartition correcte des rôles central/périphérique |
| Intégration téléphone | AMS, ANCS, ANCS sur deux cœurs | Intégration média ou notification Apple et le flux d'appairage requis côté téléphone |
| Profils GATT standards | BASC, CPPC, CSCPC, DISS, HRPC, CTS | Le rôle du service, la spécification des caractéristiques GATT et l'interopérabilité du profil standard avec l'appareil pair |
| Périphériques d'entrée et interphonie | HID, Interphonie BLE | Le modèle d'interaction avant d'ajouter l'UI produit ou le comportement vocal |
| Comportement d'appairage et de reconnexion | Appairage BLE | Conservation des clés d'appairage (bonding), gestion de l'identité et procédure de nouvel appairage du produit |
| Annonces et découverte | iBeacon, Annonces périodiques, Synchronisation des annonces périodiques | Le comportement de diffusion ou de synchronisation requis sans supposer une connexion GATT |
| Transfert de données et OTA | Transfert de fichiers, Débit, Périphérique avec OTA, Central et périphérique avec OTA Pingpong | Charge utile, paramètres de liaison, rôles de mise à jour, reprise après interruption du transfert et validation de bout en bout |
Les résultats d'un test de débit ne préjugent pas du débit de données du produit. Ils dépendent de la PHY sélectionnée, des réglages de connexion, du comportement de l'appareil pair, de l'environnement RF, de l'activité hôte et du modèle de charge utile. De même, un exemple ANCS ou AMS sert de base à l'intégration avec un téléphone ; il ne garantit pas le même comportement pour chaque version d'iOS ni selon les autorisations accordées par l'utilisateur.
Exemples de Bluetooth classique¶
Les projets Bluetooth classique conviennent aux produits qui nécessitent des profils BR/EDR, de l'audio, un transport série ou une connexion IP via un téléphone. Une démonstration réussie sur une carte de développement n'est qu'un point de départ ; validez l'interopérabilité avec les appareils pairs et les charges réelles du produit.
| Tâche d'ingénierie | Exemples officiels | À valider avec ces projets |
|---|---|---|
| Transport hôte/contrôleur ou profil série Bluetooth classique | HCI sur UART (BT/BLE), SPP | La frontière hôte/contrôleur et le transport UART pour HCI, ou le comportement du profil série SPP |
| Streaming audio et contrôle des médias | Connexions multiples A2DP, Partage audio A2DP, Pochette d'album AVRCP, Récepteur de musique, Récepteur de musique avec retransmission, Émetteur de musique | Topologie émetteur/récepteur visée, routage audio, chemin de contrôle média et budget de ressources |
| Appels et liaisons vocales | 3-SCO, HFP, Retransmission HFP | Topologie d'appel, latence audio, chemin micro/haut-parleur et comportement du téléphone |
| Réseau et OTA via le téléphone | PAN, PAN OTA | Partage de connexion du téléphone, trafic IP, reconnexion et chemin de transfert OTA |
Pour le modèle réseau PAN et sa configuration côté téléphone, consultez Bluetooth PAN. Pour le routage audio, la gestion des tampons et la validation en charge du système, consultez Vue d'ensemble de l'audio et Audio Server et mise en tampon.
Exemples de diffusion LE Audio¶
Le chemin de documentation sf32lb58x ne suffit pas à établir la compatibilité d'une carte ; consultez la section Supported Platforms pour la révision exacte du SDK et la carte cible. Dans l'exemple reliant Bluetooth classique et BAP, le titre du README désigne un émetteur, mais le chemin et la présentation décrivent un récepteur. L'implémentation dans la révision du SDK examinée traite A2DP en Bluetooth classique et démarre une source de diffusion BAP. Ce constat vaut uniquement pour le commit indiqué et ne s'applique pas automatiquement à toutes les versions servies sous latest. Avant de compiler, vérifiez le README, le code source et la configuration de la carte pour la version ou le commit exact du SDK utilisé. Ne déduisez ni le rôle ni la compatibilité de la carte de la description copiée du récepteur.
Les projets zbt proposent des exemples d'émetteur et de récepteur en diffusion LE Audio, fondés sur le Basic Audio Profile (BAP). Évaluez-les ensemble dans un même test système : la configuration de diffusion, la source audio, le récepteur, la synchronisation d'horloge et les conditions RF influent sur le résultat.
| Scénario d'utilisation | Exemple officiel | À valider en premier |
|---|---|---|
| Recevoir un flux audio diffusé | Récepteur de diffusion BAP | Comportement du récepteur, chemin audio de sortie et la configuration de diffusion de test |
| Émettre un flux audio diffusé | Émetteur de diffusion BAP | Chaîne audio source, configuration de diffusion et récepteur de référence dont le fonctionnement est vérifié |
| Faire le pont entre le Bluetooth classique et la diffusion LE Audio | Émetteur de diffusion BAP avec Bluetooth classique | Les deux chaînes de traitement audio, leur point de transfert et les marges temporelles et de ressources en fonctionnement simultané |
Validation produit au-delà de l'exemple¶
| Domaine de vérification | À préserver de l'exemple source | À revalider pour le produit |
|---|---|---|
| Comportement radio | La carte prise en charge et le rôle ou profil prévu de l'exemple | Antenne, boîtier, portée, coexistence RF, appareils correspondants et plan d'essais de conformité réglementaire |
| Politique de connexion | Le flux d'annonces, de scan ou de connexion de base | Latence produit, objectif de consommation électrique, stratégie de reconnexion et transitions d'état |
| Sécurité | La configuration d'appairage ou de bonding de l'exemple | Exigences d'authentification, stockage des clés, confidentialité, réinitialisation d'usine et récupération côté utilisateur |
| Données et audio | Le flux de paquet ou de diffusion démontré | Format des données et règles d'échange, récupération d'erreur, latence, mise en tampon, configuration du codec et marge mémoire |
| Éléments de validation | Paramètres de compilation, journaux et comportement attendu | Matrice reproductible téléphone/accessoire, courbe de consommation électrique, récupération après déconnexion et tests de non-régression |
Ressources associées¶
- Vue d'ensemble Bluetooth pour les choix de rôle, profil, sécurité, paramètres de connexion et coexistence au niveau produit.
- Processeur Bluetooth pour les limites hôte/contrôleur et la consommation énergétique.
- Bluetooth PAN pour le réseau IP via téléphone et l'OTA basée sur PAN.
- Exemples audio du SDK pour les exemples de capture locale, de codec et de lecture qui complètent le travail audio Bluetooth.
- Exemples pour le catalogue d'exemples SDK inter-domaines.
Dernière mise à jour: