Adafruit BlueFruit LE Guide Utilisateur

Table des Matières

Liens rapides

Télécharger ce manuel

Guide utilisateur BlueFruit

Un guide complet et abordable pour utiliser et exploiter les modules Bluefruit LE

d'Adafruit.

(version 0.1)

Traduit par MicroControleur Hobby (shop.mchobby.be)

Compilé depuis la traduction maintenue sur https://wiki.mchobby.be/index.php?title=Bluefruit-LE-Shield

Les hyperliens sont disponibles sur la version en ligne du document.

Translated by MicroControleur Hobby (shop.mchobby.be)

Compiled from online translation available at https://wiki.mchobby.be/index.php?title=Bluefruit-LE-Shield

Hyperlinks are available on the online version of this document.

Table des Matières

Sommaire des Matières pour Adafruit BlueFruit LE

Page 1 Guide utilisateur BlueFruit Un guide complet et abordable pour utiliser et exploiter les modules Bluefruit LE d'Adafruit. (version 0.1) Traduit par MicroControleur Hobby (shop.mchobby.be) Compilé depuis la traduction maintenue sur https://wiki.mchobby.be/index.php?title=Bluefruit-LE-Shield Les hyperliens sont disponibles sur la version en ligne du document.
Page 2: Présentation
2 Bluefruit App: Démarrer rapidement avec le module BLE 3 Plus de fonctionnalités 4 Caractéristiques 5 Pourquoi utiliser un module Adafruit Bluefruit? Présentation Voudriez-vous ajouter une puissant interface Bluetooth Low Energy (et facile à mettre en oeuvre) sur votre robot, projet artistique ou autre projets électroniques? Maintenant que BLE est inclus dans la plupart des smartphones et tablette, disposer d'une connectivité...
Page 3: Bluefruit App: Démarrer Rapidement Avec Le Module Ble
Ce module multi-fonction peut faire bien plus encore! La plupart des utilisateurs apprécient l'utilisation du profile standard UART de Nordic. Dans ce profile, Bluefruit LE agit comme un tube transportant les données, qui transmet les données de façon 'transparente' dans les deux sens avec votre périphérique iOS ou Android. Vous pouvez utiliser l'App iOS ou l'App Android d'Adafruit pour commencer à...
Page 4: Plus De Fonctionnalités
Un des grands avantages de la famille des modules Adafruit Bluefruit LE est qu' Adafruit a entièrement écrit le firmware fonctionnant sur le module. Adafruit contrôle chaque ligne de code qui fonctionne sur ses modules... et donc, Adafruit et ses clients, ne sont pas à...
Page 5: A Propos De Mchobby Crédit De Traduction
A propos de MCHobby Crédit de traduction Sommaire 1 A propose de .: MC Hobby :. 2 License 3 Crédit de traduction 4 Limite de traduction 4.1 Anglicisme 4.2 Code source 5 Autorisations 6 Signaler une erreur A propose de .: MC Hobby :. MCHobby investi du temps et de l'argent dans la réalisation de traduction et/ou documentation.
Page 6: Signaler Une Erreur
Autorisations Le présent manuel a été traduit avec l'autorisation d'Adafruit (www.adafruit.com). Signaler une erreur Malgré tout le soin apporté à la réalisation de cette traduction, il n'est pas impossible qu'une erreur se soit malgré tout glissée dans ce document.
Page 7: Broches D'alimentation
2 Broches d'alimentation 3 Broches SPI 4 Autres broches Brochage Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Broches d'alimentation 5V: Ceci est l'alimentation du module. Alimentez la en entrée avec une source de 3.3 à 5V. La tension sera ensuite régulée à...
Page 8 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Broches SPI Le shield communique avec votre Arduino via le bus SPI. SCK: Il s'agit du signal d'horloge du bus SPI. Connecté par défaut sur la broche d'horloge sur bus SPI matériel de votre Arduino (via le connecteur ICSP 2x3).
Page 9 DFU (voyez cette page du tutoriel). bouton DFU: Presser ce bouton lorsque le shield est mis sous tension forcera le module Bluefruit LE à entrer dans un mode spécial de mise-à-jour du Firmware (appelé Device Firmware Update ou aussi DFU). Le mode DFU permet de faire une mise- à-jour via les airs (via Bluetooth) à...
Page 10 Attention à l'empilement Si vous désirez empiler un autre shield au dessus du shield Bluefruit LE, il sera nécessaire de vous procurer des "stacking headers" pour Arduino et les utiliser à la place des connecteurs fournit avec la carte! Avec un Stacking Header Besoin d'empiler? ce tutoriel se concentre sur l'utilisation d'un connecteur normal (pinHeader) pour Arduino.
Page 11: Branchez Les Connecteurs
Ces étapes concerne tous les Arduino et Arduino compatibles. Soyez attentif au fait que c'est le port SPI matériel (le 2x3 broches) qui sera utilisé pour communiquer avec le module Bluefruit LE. Si ce port n'est plus disponible, il sera nécessaire de faire des pontages depuis les pastilles SCK/MOSI/MISO vers des autres broches de votre microcontroleur (et d'utiliser du "SPI logiciel")!
Page 12 N'oubliez pas souder le connecteur 6 broches! (c'est notre bus SPI matérie) Vérifier toutes les soudures. C'est OK? pas de soudure cassée ou soudure froide (en forme de boule qui ne mouille pas la pastille du shield)? Alors nous pouvons passer à l'étape suivante...
Page 13: Raccordement Par Défaut
Brancher Raccordement par défaut Pour une mise en place rapide, Adafruit a déjà raccordé le Bluefruit LE sur les broches par défaut. Cela permet de suivre le tutoriel (qui exploite également les broches par défaut). Le Bluefruit LE SPI Friend (comme le shield BlueFruit LE pour Arduino) ne devrait pas être modifié et utilisera le brochage le...
Page 14 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Dans tous les codes d'exemple, Adafruit a ajouter une section en début de croquis/sketch reprenant les différentes manières de communiquer avec Bluefruit LE: port série matériel, port série logiciel, bus SPI matériel, bus SPI logiciel.
Page 15 La bibliothèque Il sera nécessaire de télécharger la bibliothèque Adafruit BLE pour nRF51 d'Adafruit (connue comme Adafruit_BluefruitLE_nRF51) pour pouvoir essayer les démos BLE d'Adafruit. Vous pourrez trouver le code ici sur github mais il est plus simple de cliquer sur le bouton de https://github.com/adafruit/Adafruit_BluefruitLE_nRF51...
Page 16: Configuration
3.5 Broches SPI 3.6 Broches SPI logiciel 4 Sélectionner le Bus Série 4.1 Carte de type UART (Bluefruit LE UART Friend & Flora BLE) 4.2 Carte de type SPI (Bluefruit LE SPI Friend) Attention Avant de téléverser les croquis/sketchs d'exemple sur votre Arduino, vous aurez...
Page 17 Feather M0 Bluefruit LE Si vous disposez d'un Feather M0 Bluefruit LE alors vous avez un microcontrôleur ATSAMD21 avec un bus SPI matériel, CS = 8, IRQ = 7, RST = 4 Bluefruit LE SPI Friend Si vous disposez d'un module Bluefruit seul alors vous avez un peu plus de flexibilité...
Page 18: Configurer Les Broches Utilisées
You'll want to check the Bluefruit Config to set up the pins you'll be using for UART or SPI Each example sketch has a secondary tab with configuration details. You'll want to edit and save the sketch to your own documents folder once set up. Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Paramètres généraux...
Page 19: Sélectionner Le Bus Série
Carte de type UART (Bluefruit LE UART Friend & Flora BLE) This is for Bluefruit LE UART Friend & Flora BLE boards. You can use either software serial or hardware serial. Hardware serial is higher quality, and less risky with respect to losing data. However, you may not have hardware serial available! Software serial does...
Page 20 GPIO pin. For software serial (Arduino Uno, Adafruit Metro) you should uncomment the software serial contructor below, and make sure the other three options (hardware serial & SPI) are commented out.
Page 21: Ouvrir Le Croquis
Ouvrir le croquis Pour ouvrir le croquis ATCommand, cliquez sur le menu Fichiers > Exemples > Adafruit_BluefruitLE_nRF51 dans Arduino IDE puis sélectionnez atcommand: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Cela ouvrira l'exemple dans l'environnement de développement, comme visible ci-dessous:...
Page 22: Exécuter Le Croquis
Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Configuration Vérifiez la page Configuration présenter plus tôt dans le tutoriel! Il est important de configurer le croquis pour utiliser soit l'UART Logiciel/Matériel, soit le bus SPI Logiciel/Matériel correspondant à votre plateforme. Par défaut, le croquis utilise le bus SPI matériel Si vous utilisez le port série/UART logiciel ou matériel:...
Page 23 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Pour envoyer une commande AT sur le module Bluefruit LE: saisissez la commande dans le zone de texte en haut du moniteur série puis cliquez sur le bouton "Envoyer" (Send) Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com La réponse à...
Page 24 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Vous pouvez saisir n'importe quelle commande AT sur cette invite de commande. Essayez AT+HELP pour obtenir la liste de toutes les commande et essayer une commande telle que AT+HWGETDIETEMP (obtenir la température interne du nRF51822) ou AT+HWRANDOM (générer un nombre aléatoire)
Page 25 Croquis BLEUart L'exemple BLEUart permet d'échanger des données texte (envoi et réception) entre un Arduino et un périphérique Bluetooth Low Energy connecté à l'autre bout (comme un téléphone mobile utilisant l'application Adafruit Bluefruit LE Connect pour Android ou iOS . Le transfert se fait https://play.google.com/store/apps/details?id=com.adafruit.bluefruit.le.connect...
Page 26 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Configuration Vérifiez la page Configuration présenter plus tôt dans le tutoriel! Il est important de configurer le croquis pour utiliser soit l'UART Logiciel/Matériel, soit le bus SPI Logiciel/Matériel correspondant à votre plateforme. Par défaut, le croquis utilise le bus SPI matériel Si vous utilisez le port série/UART logiciel ou matériel:...
Page 27 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Une fois que vous pouvez voir les requêtes envoyées au module BleFruit, utiliser l'App Adafruit sur votre smartphone pour vous connecter sur le module Bluefruit LE en mode UART (vous obtiendrez donc une zone texte sur votre téléphone.
Page 28 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Le texte de réponse ('Why hello, Arduino!') renvoyé depuis le Smartphone est visible dans le moniteur série Arduino (voir ci- dessous):...
Page 29 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 30: Le Croquis Hidkeyboard
"BLE HID peripherals". Ouvrir le croquis Pour ouvrir le croquis ATCommand, cliquez sur le menu Fichiers > Exemples > Adafruit_BluefruitLE_nRF51 dans Arduino IDE puis sélectionnez hidkeyboard: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Cela ouvrira l'exemple dans l'environnement de développement, comme visible ci-dessous:...
Page 31 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Configuration Vérifiez la page Configuration présenter plus tôt dans le tutoriel! Il est important de configurer le croquis pour utiliser soit l'UART Logiciel/Matériel, soit le bus SPI Logiciel/Matériel correspondant à votre plateforme. Par défaut, le croquis utilise le bus SPI matériel Si vous utilisez le port série/UART logiciel ou matériel:...
Page 32: Lier Le Clavier Hid
(bonding en anglais) permet d'établir une connexion permanente entre les deux périphérique. Cela signifie que dès que votre téléphone ou PC redétecte ce module Bluefruit LE module bien précis alors il est connecté automatiquement. La procédure exacte à utilisé pour faire l'appairage varie d'une plateforme à l'autre.
Page 33 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Dans le volet de configuration Bluetooth vous pouvez voir la liste des périphériques disponibles. Vous devriez y voir le module Bluefruit LE s’annonçant sous le nom Bluefruit Keyboard: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Sélectionner le périphérique permet de démarrer le processus d'appairage. Processus qui se termine par le placement du périphérique "Bluefruit Keyboard"...
Page 34 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Pour lier le "clavier" sur un périphérique iOS, rendez-vous dans l'application Configuration' ('Settings en anglais) de votre téléphone et cliquer sur le point de menu Bluetooth. Le clavier devrait apparaître sous la liste AUTRES PERIPHERIQUES (OTHER DEVICES en anglais):...
Page 35 Une fois le processus d'appairage terminé, le périphérique est déplacé dans la catégorie MES PERIPHERIQUES (MY DEVICES en anglais). Il sera alors possible de commencer à utiliser le modul e Bluefruit LE comme un clavier: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 36 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com OS X Pour appairer le clavier sur un périphérique OS X device, rendez vous dans la fenêtre des Préférence Bluetooth et cliquez sur le bouton Appairer (ou Pair) en face du périphérique Bluefruit Keyboard (tel qu'il est nommé dans le croquis d'exemple): Crédit: AdaFruit Industries www.adafruit.com...
Page 37 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com ... et cliquer ensuite sur le bouton Enlever (Remove en anglais) lorsque la fenêtre de confirmation apparaît: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 38: Contrôleur
1 Le croquis Controler 2 Ouvrir le croquis 3 Configuration 4 Exécuter le croquis 5 Utiliser Bluefruit LE Connect en mode contrôleur 6 Streamer les données des senseurs 7 Le pavé de commande 8 Sélection de couleur Le croquis Controler Le croquis d'exemple Controller vous permet de transformer votre périphérique iOS ou Android (supportant BLE) en un contrôleur...
Page 39 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Configuration Vérifiez la page Configuration présenter plus tôt dans le tutoriel! Il est important de configurer le croquis pour utiliser soit l'UART Logiciel/Matériel, soit le bus SPI Logiciel/Matériel correspondant à votre plateforme. Par défaut, le croquis utilise le bus SPI matériel Si vous utilisez le port série/UART logiciel ou matériel:...
Page 40: Utiliser Bluefruit Le Connect En Mode Contrôleur
Une fois le croquis en cours d'exécution sur votre Arduino, vous pouvez démarrer l'application "BlueFruit LE Connect". Si c'est la première fois que vous utilisez "Bluefruit LE Connect", prenez le temps de consulter le guide d'apprentissage "Bluefruit LE Connect"...
Page 41: Streamer Les Données Des Senseurs
Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Streamer les données des senseurs Vous pouvez selection les données Quaternion (orientation absolute), Accélérometre, Gyroscope, Magnétomètre ou localisation depuis votre SmartPhone et les envoyer directement vers votre Arduino. En activant le champ Accéléromètre, par exemple, vous pouvez voir les données (mises-à-jour) dans l'app:...
Page 42 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Les données sont traitées (parsing) dans le croquis d'exemple et affichés dans le moniteur série: Accel 0.20 -0.51 -0.76 Accel 0.22 -0.50 -0.83 Accel 0.25 -0.51 -0.83 Accel 0.21 -0.47 -0.76 Accel 0.27 -0.48 -0.82...
Page 43: Le Pavé De Commande
Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Note que même si le croquis n'affiche que 2 decimales, les valeurs envoyées par l'App sont des valeurs en virgule flottante codées sur 4 octets (4-byte floating point value). Le pavé de commande Vous pouvez également utiliser le module Control Pad pour capturer les bouton pressé (et relâché) :...
Page 44 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Ce module spécial affiche un "Game Pad" comme celui présenté ci-dessous: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 45: Sélection De Couleur
Les boutons pressés et relâchés apparaitrons dans le moniteur série (avec l'ID du bouton utilisé): Button 8 pressed Button 8 released Button 3 pressed Button 3 released Pressed signifie pressé. Released signifie relâché. Sélection de couleur Vous pouvez également envoyer des données d'une couleur sélectionnée RGB (Red=rouge, Green=vert, Blue=bleu) par l'intermédiaire du module Color Picker.
Page 46 Sélectionner une coleur retourne le code couleur sous sa codification Hexadécimale avec le format suivant: RGB #A42FFF Voyez cette vidéo d'exemple produit par Adafruit (Youtube, anglais) https://youtu.be/Kym6crZF1Pg Vous pouvez combiner ensemble les croquis d'exemples du "Color Picker" et du "controller" pour réaliser une animation couleur configurable déclenchée par les boutons de l'application mobile-- très pratique pour les projets wearables/fringuables! Vous pouvez...
Page 47: Le Croquis Heartratemonitor
AT. Ouvrir le Croquis Pour ouvrir le croquis ATCommand, cliquez sur le menu Fichiers > Exemples > Adafruit_BluefruitLE_nRF51 dans Arduino IDE puis sélectionnez heartratemonitor: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Cela ouvrira l'exemple dans l'environnement de développement, comme visible ci-dessous:...
Page 48 Cette démonstration nécessite de longs transfert de données pour envoyer des chaînes de caractères (string). Par conséquent, Adafruit recommande de définir et connecter les broches CTS et RTS, même si vous utilisez un UART matériel. Si vous utilisez un Flora (ou que vous ne désirez pas brancher CTS ou RTS), fixer la valeur des broches à -1 dans les instructions #define to -1.
Page 49 Assurez-vous que le débit (Baud rate) soit configuré sur 115200 bauds (en bas à droite). Une fois l'application démarrée, vous pouvez voir les différentes commandes de configurations envoyées vers le module BlueFruit LE pour ajouter le service Heart Beat Monitor. Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 50: Exemple Hrm De La Boite À Outil Nrf
Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Exemple HRM de la boite à outil nRF Si vous ouvrez une application (sur votre mobile ou Laptop) qui supporte le standard Heart Rate Monitor Service , vous serez alors capable de voir les mises-à-jour de la vitesse de battement du https://developer.bluetooth.org/TechnologyOverview/Pages/HRS.aspx...
Page 51 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Exemple HRM CoreBluetooth...
Page 52 L'image ci-dessous présente une capture de l'application CoreBluetooth sample disponible gratuitement pour Apple montrant comment fonctionne les https://developer.apple.com/library/mac/samplecode/HeartRateMonitor/Introduction/Intro.html services et caractéristiques Bluetooth Low Energy: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 53: Le Croquis Uribeacon
2 Ouvrir le croquis 3 Configuration 4 Exécuter le croquis Le croquis UriBeacon L'exemple UriBeacon montre comment utiliser les AT UriBeacon du module pour configurer le module Bluefruit LE comme annonceur UriBeacon en suivant les spécifications UriBeacon de Google. https://github.com/google/uribeacon Ouvrir le croquis Pour ouvrir le croquis ATCommand, cliquez sur le menu Fichiers >...
Page 54 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Vous pouvez éditer le contenu du beacon pour qu'il pointe l'URL vers http://www.adafruit.com ou juste téléverser le programme tel quel pour le tester. Configuration Vérifiez la page Configuration présenter plus tôt dans le tutoriel! Il est important de configurer le croquis pour utiliser soit l'UART Logiciel/Matériel, soit le bus SPI Logiciel/Matériel correspondant à...
Page 55 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com C'est le moment d'ouvrir un l'application "Physical Web" pour Android ou pour https://play.google.com/store/apps/details?id=physical_web.org.physicalweb et de voir le lien envoyé pour le liste web d'Adafruit: https://itunes.apple.com/us/app/physical-web/id927653608?mt=8 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com...
Page 56: Dépannage
Flora/Due/Leonardo/Micro! Que se passe t'il? Adafruit à ajouté une ligne spéciale dans la fonction setup() de sorte que votre Arduino s'arrête jusqu'à ce qu'il détecte la console Série. C'est très pratique pour le débogage mais empêche également le programme de fonctionner s'il n'est pas connecté sur un ordinateur.
Page 57 Assurez vous d'avoir changé la broche RESET sur #4 dans le fichier de configuration. Assurez-vous d'utiliser les bonnes broches correspondant au bus SPI matériel!
Page 58: Les Commandes At
3 Commandes en écriture '=xxx' 4 Commandes en mode exécution 5 Mode de lecture '?' A propos des commandes AT Le module Bluefruit LE utilise un ensemble de commandes type "AT" (Hayes) pour configurer le http://en.wikipedia.org/wiki/Hayes_command_set périphérique. L'avantage des commandes de type "AT" c'est qu'elles sont faciles à utiliser dans une communication machine-à-machine, tout en restant assez facile à...
Page 59: Commandes En Mode Exécution
Note: Une erreur est générée dans ce cas particulier car la valeur '3' n'est pas valide pour la commande AT+BLEPOWERLEVEL . Saisir les valeurs '-4', '0' ou '4' seront acceptées car elles font parties des valeurs acceptées pas cette commande. Commandes en mode exécution Le mode d'exécution provoque l'exécution d'une commande spécifique, si cela est possible, et sera utilisé...
Page 60: Commandes Standards
6 +++ Commandes standards Les commandes Hayes/AT standard suivantes sont disponible sur les modules Bluefruit LE: La commande AT agit comme un "ping". Elle est habituellement utilisé pour vérifier si le module est en mode "commande". Si le module est en mode commande, vous devriez recevoir une réponse 'OK'.
Page 61 Effectue une réinitialisation système 'Reset'. Codebase Revision: 0.3.0 Paramètres: None Sortie: None Active ou désactive l'écho des caractères entrée avec le parseur de commande AT. Codebase Revision: 0.3.0 Paramètres: '1' = activer l'écho, '0' = désactiver l'écho. Sortie: Aucune # Désactive l'écho renvoyé par le module ATE=0 # Active l'écho ATE=1...
Page 62: Commandes Générales
6 AT+NVMREAD 7 AT+MODESWITCHEN Commandes générales Cette section du document décrit les commandes d'usage "généralisé" disponible sur tous les modules Bluefruit LE: AT+FACTORYRESET Efface les données de configuration de la mémoire non-volatile et effectue une réinitialisation d'usine avant de réinitialiser le module Bluefruit.
Page 63 (ce n'est qu'une illustration) AT+HELP AT+FACTORYRESET,AT+DFU,ATZ,ATI,ATE,AT+DBGMEMRD,AT+DBGNVMRD,AT+HWLEDPOLARITY,AT+HWLED,AT+HWGETDIETEMP,AT+HWMODEPINPOLARITY,AT+HWMODEPIN,AT+HWGP AT+NVMWRITE Ecrit des données dans la mémoire utilisation non volatile de 256 octets (bytes). Aussi dite région NVM pour Non-Volatile memory. Codebase Version: 0.7.0 Paramètres: offset: L'offset numérique de la position de départ dans la NVM où sera écrit le premier octet/byte. datatype: Type de donnée, qui peut être une STRING (1), BYTEARRAY (2) ou INTEGER (3).
Page 64 10 AT+HWMODELED 11 AT+UARTFLOW Commandes matériel Les commandes suivantes vous permettent d'interagir avec la bas niveau matériel du module Bluefruit LE. Vous pourrez lire et modifier l'état des GPIO, effectuer une conversion Analogique-vers-digital (ADC), etc. AT+BAUDRATE Change le débit (baud rate en anglais) utilisé par l'UART matériel du nRF51822.
Page 65 Effectue une conversion ADC (analogique vers digital) pour une broche ADC spécifique Codebase Revision: 0.3.0 Paramètres: Le canal ADC (0..7) Sortie: Le résultat de la conversion ADC AT+HWADC=0 AT+HWGETDIETEMP Obtenir la température (en degrés Celcius) du composant BLE. Peut être utilisé pour faire du débogage (un courant plus élevé signifie généralement une consommation de courant plus important).
Page 66 Essayer de fixer l'état d'une broche qui n'a pas encore été configurée produira la réponse 'ERROR'. Certaines broches du BlueFruit LE sont réservée pour des fonctions spécifiques. Ces broches ne peuvent pas être utilisées comme GPIO. La commande génèrera une erreur si vous essayez d'utiliser ces numéros réservés.
Page 67 AT+HWRANDOM Génère un nombre aléatoire (32-bits) en utilisant le générateur de nombre aléatoire matériel du nRF51822 (basé sur le bruit blanc). Codebase Revision: 0.4.7 Paramètres: Aucun Sortie: un nombre aléatoire 32-bits encodé en hexadécimal (ex. '0x12345678') AT+HWRANDOM 0x769ED823 AT+HWMODELED Permet d'écraser la fonctionnalité par défaut de la LED "mode" (qui indique, par défaut, indique le mode de fonctionnement). Codebase Revision: 0.6.6 Paramètres: mode de fonctionnement de la LED, qui peut être une des valeurs suivantes: disable ou DISABLE ou 0 - Désactive complètement la Led MODE pour économiser de l'énergie.
Page 68 # Réinitialiser pour changer les données de publication AT+BLEBEACON stocke les données beacon dans ma mémoire de configuration du module Bluefruit LE (non volatile). Ces données sont persistance et donc disponible après une réinitialisation système ou cycle d'alimentation. Pour effacer ou enlever ces données beacon il sera nécessaire d'utiliser la commande de réinitialisation à...
Page 69 Android 4.3+: "Physical Web" sur Google Play Store iOS: "Physical Web" sur l'App Store d'Apple Codebase Revision: 0.4.7 Paramètres: l'URI à annoncer (ex. http://www.adafruit.com/blog) Sortie: Aucune si une URI valide à été saisi (longueur acceptable, etc.). AT+BLEURIBEACON=http://www.adafruit.com/blog # Reinitialise le module pour utiliser les données d'annonce Si l'URI fournie est trop longue alors vous obtiendrez le message suivant en sortie: AT+BLEURIBEACON=http://www.adafruit.com/this/uri/is/too/long...
Page 70 Adafruit ne fera pas de développement complémentaire pour la technologie UriBeacon. AT+EDDYSTONEENABLE (commande dépréciée) Cette commande activera le support Eddystone sur le module Bluefruit LE. Le support Eddystone doit être activé avant d'utiliser les autres commandes. Codebase Revision: 0.6.6 Paramètres: 1 ou 0 (1 = activé, 0 = désactiver)
Page 71 # Active l'annonce du service de configuration Eddystone pendant 5 minutes (300s) AT+EDDYSTONECONFIGEN=300 AT+EDDYSTONESERVICEEN Ajoute ou retire un service Eddystone dans la table GATT (gouverne l'organisation et l'échange de données entre les périphériques). Nécessite une réinitialisation pour être activé. Codebase Revision: 0.7.0 Paramètres: Utiliser les valeurs suivantes pour activer ou désactiver le service Eddystone: on , 1 - activer le service off , 0 - désactiver le service...
Page 72: Commandes Génériques Ble
5 AT+BLEGETPEERADDR 6 AT+BLEGETRSSI Commandes génériques BLE Les commandes générales suivantes sont disponibles dans tous les modules Bluefruit LE. AT+BLEPOWERLEVEL Obtenir ou fixer le niveau de puissance de transmission du module radio (réduire la puissance permet d'augmenter la durée de vie de votre accu/pile car le module consomme moins, cela diminue également la portée du module).
Page 73 Paramètres: Aucun Sortie: Le type d'adresse qui peut être l'une des valeurs suivantes: 0 = publique 1 = aléatoire AT+BLEGETADDRTYPE AT+BLEGETADDR Retourne l'adresse 48-bits du périphérique BLE. Codebase Revision: 0.3.0 Paramètres: Aucun Sortie: une adresse 48-bits au format suivant: 'AA:BB:CC:DD:EE:FF' AT+BLEGETADDR E4:C6:C7:31:95:11 AT+BLEGETPEERADDR...
Page 74 17 AT+BLEMIDITX 18 AT+BLEBATTEN 19 AT+BLEBATTVAL Services BLE Les commandes suivantes vous permettent d'interagir avec les différents services GATT présent sur les modules Bluefruit LE lorsque celui-ci fonctionne en mode commande. Le service GATT et ses caractéristiques (Adafruit, anglais) gouvernent https://learn.adafruit.com/introducing-the-adafruit-bluefruit-le-uart-friend/ble-gatt...
Page 75 NOTE SUR LES SEQUENCES D'ECHAPPEMENT: Si vous essayez d'envoyer les séquences d'échappement dans le code par l'intermédiaire d'une instruction telle que 'ble.print("...");' prenez note qu'il vous vaudra utiliser des double-back-slash pour le code d'échappement d'une commande AT. Par exemple: ble.println("AT+BLEUARTTX=Some Test\\r\\n");...
Page 76 Sortie: voyez AT+BLEUARTTX AT+BLEUARTRX Cette commande fait un dump de la mémoire tampon de réception du service UART https://learn.adafruit.com/introducing-adafruit-ble-bluetooth-low- sur l'écran (si le service UART à reçu des données pendant l'exécution en mode de commande). Les données energy-friend/uart-service seront retirée de la mémoire tampon une fois affichées en utilisant cette commande.
Page 77 Vous devez effectuer une réinitialisation système (ATZ) avant que les changements soient effectifs! Avant de pouvoir utiliser votre clavier "HID over GATT", vous aurez besoin de lier le module Bluefruit LE avec votre mobile (dans le panneau des préférences Bluetooth). # Activer le support clavier BLE puis réinitialisation AT+BLEKEYBOARDEN=1 # Désactive le support clavier puis réinitialisation...
Page 78 à 1 dans BLEHIDEN puis de faire une réinitialisation système avant que le périphérique HID soit énuméré et apparaisse sur votre périphérique centrale (votre smartphone). Codebase Revision: 0.6.6 Paramètres: 1 = activer ou 0 = désactivé Sortie: Aucune Il sera normalement nécessaire de lier/appairer le périphérique Bluefruit LE pour pouvoir...
Page 79 Si vous avez déjà appairé le module avec un périhérique et que vous ayez besoin d'effacer cet appairage alors vous pouvez exécuter la commande AT+FACTORYRESET qui effacera toutes les données du module Bluefruit LE (y compris celle d'appairage). # Activer le support "GATT over HID" du module Bluefruit LE AT+BLEHIDEN=1 # Réinitialiser le module pour activer la fonctionnalité...
Page 80 # Maintient le bouton "en arrière" de la souris pendant 200 milli-secondes (Dépendant de l'OS) AT+BLEHIDMOUSEBUTTON=B,hold,200 AT+BLEHIDCONTROLKEY Envoi une commande HID de contrôle Media vers le périphérique lié (modification du volume, luminosité de l'écran, sélection de la piste musicale, etc.). Codebase Revision: 0.6.6 Paramètre: Le code de la touche HID (de contrôle multimédia) à...
Page 81 AT+BLEHIDGAMEPADEN Active le support du service HID pour le joystick/gamepad. Le gamepad HID est désactivé par défaut (depuis la version 0.7.6 du firmware) parce qu'il cause des problème sur iOS et OS X et devrait uniquement être utilisé avec les périphériques Android et Windows.
Page 82 AT+BLEMIDIRX Lit la mémoire tampon et retourne le tableau de caractère MIDI entrant. Codebase Revision: 0.7.0 Paramètre: Aucun Sortie: l'événement midi retourné sous forme de tableau d'octet AT+BLEMIDIRX 90-3C-7F AT+BLEMIDITX Envoyer un événement MIDI vers l'hôte. Codebase Revision: 0.7.0 Paramètre: l'événement MIDI sous forme d'un tableau hexadécimal, qui peut être soit: Une série d'événement MIDI complet (jusqu'à...
Page 83 9 AT+GAPSTOPADV 10 AT+GAPSETADVDATA BLE GAP (Adafruit, Anglais) qui signifie Generic Access Profile gouverne l'annonce et les https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gap connexions avec les périphériques Bluetooth Low Energy. Les commandes suivantes peuvent être utilisées pour configurer les paramètres GAP sur le module BLE.
Page 84 Paramètre: Aucun Sortie: Aucun AT+GAPDISCONNECT AT+GAPDEVNAME Obtenir ou modifier le nom du module, celui qui est inclus dans le payload d'annonce du module Bluefruit LE Codebase Revision: 0.3.0 Paramètre: Aucun pour lire le nom actuel du périphérique Le nouveau nom du périphérique si vous voulez changer son nom Sortie: Le nom actuel du périphérique si la commande est exécutée en mode lecture.
Page 85 # Modifier uniquement l'intervalle d'annonce (advertising interval) AT+GAPINTERVALS=,,150, AT+GAPSTARTADV Force le module Bluefruit LE commencer l'émission des paquets d'annonce si ce n'est pas déjà le cas (et en partant du principe qu'il n'est pas déjà connecté sur un pérhiphérique externe). Codebase Revision: 0.3.0 Paramètre: Aucun...
Page 86 Arrête l'émission des paquets d'annonce depuis le module Bluefruit LE. Codebase Revision: 0.3.0 Paramètre: Aucun Sortie: Aucun AT+GAPSTOPADV AT+GAPSETADVDATA Surcharge les données du payload d'annonce avec le tableau d'octet spécifié en paramètre (remplace les données normalement utilisées dans le payload d'annonce normal). Le payload d'annonce du module suit les guidelines dans les Spécifications Core Bluetooth 4.0 or 4.1...
Page 87 Codebase Revision: 0.3.0 Paramètres: le tableau d'octets brute qui devrait être inséré dans la section de donnée du bloc d'annonce. Veuillez à rester à l'intérieur de l'espace définit dans les spécifications Bluetooth Core. Réponse: Aucune # S'annoncer comme Découvrable et BLE uniquement avec # les UUIDs 16 bits 0x180D et 0x180A AT+GAPSETADVDATA=02-01-06-05-02-0d-18-0a-18 Le résultat de cette commande est visible sur la capture d'écran ci-dessous.
Page 88: Limitations De Gatt
GATT est l'acronyme de "Generic ATTribute Profile" (profile d'attribut générique). https://learn.adafruit.com/introduction-to-bluetooth-low-energy/gatt GATT gouverne l'organisation et l'échange de données entre les périphériques connectés. Un périphérique (nommé "the peripheral" dans la nomenclature) agit comme un serveur GATT qui enregistre les données dans des enregistrements Attributs. Un second périphérique (nommé...
Page 89 Codebase Revision : 0.3.0 Paramètre : La commande accepte une série de paires "clé-valeur", paires séparés par des virgules. Ces paires sont utilisées pour définir les propriétés du service. Les paires clé-valeur suivantes peuvent être utilisés: UUID : Le UUID 16-bits pour ce service. La valeur 16-bits doit être mentionnée au format hexadécimal (0x1234). UUID128 : Le UUID 128-bits pour ce service.
Page 90 AT+GATTADDCHAR=UUID=0x0002,PROPERTIES=0x02,MIN_LEN=1,VALUE=100 La version 0.6.6 du firmware de Bluefruit LE est capable d'utiliser le drapeau "nouveau UUID128" pour ajouter un des UUIDs 128- bit personnalisés qui ne sont pas relatifs à un service UUID parent (qui est utilisé lorsque l'on passe un drapeau "UUID 16-bit ").
Page 91 Espace de nom/Namespace = Bluetooth SIG Assigned Number (0x01) Description = Aucune (0x0000) L'application "Master Control Panel" de Nordic affiche l'information suivante: Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com AT+GATTCHAR Fixer ou retrouver la valeur d'une caractéristique GATT personnalisée personnalisée (basé sur le numéro d'index index ID retourné...
Page 92 AT+GATTCHAR=1,32 # Vérifier la valeur écrite AT+GATTCHAR=1 0x20 AT+GATTLIST Liste tous les services et caractéristiques GATT personnalisés qui ont été définis sur le périphérique. Codebase Revision: 0.3.0 Paramètre: Aucun Réponse: Une liste de tous les services personnalisé et toutes les caractéristiques définie sur le périphérique. # Efface tous les services/caractéristiques personnalisés AT+GATTCLEAR # Ajouter le service "battery"...
Page 93: A Propos Du Débogage
5 AT+DBGSTACKDUMP A propos du débogage Cette section expose les commandes disponibles pour faire du débogage avec les modules Bluefruit LE: Utilisez ces commandes avec précaution car elles peuvent facilement conduire à des plantages matériels (HardFault error) sur le coeur ARM, ce qui bloquera le périphérique (il ne répondra plus).
Page 94 Retourne la taille actuelle de la pile. Aide à détecter le dépassement de pile ou détecter l'usage de la pile mémoire lorsque l'on optimise l'utilisation de la mémoire sur le système. Codebase Revision: 0.4.7 Paramètre: None Sortie: la taille actuelle de la pile mémoire (en octets) AT+DBGSTACKSIZE 1032 AT+DBGSTACKDUMP...
Page 95 0x20003BB0: CAFEF00D CAFEF00D CAFEF00D CAFEF00D 0x20003BC0: CAFEF00D CAFEF00D CAFEF00D CAFEF00D 0x20003BD0: CAFEF00D CAFEF00D CAFEF00D CAFEF00D 0x20003BE0: CAFEF00D CAFEF00D CAFEF00D CAFEF00D 0x20003BF0: CAFEF00D CAFEF00D 00000000 CAFEF00D 0x20003C00: 00000004 20001D04 CAFEF00D FFFFEF68 0x20003C10: CAFEF00D 00001098 CAFEF00D CAFEF00D 0x20003C20: CAFEF00D CAFEF00D 00001006 200018D8 0x20003C30: 00000001 200018D8 20001C50 00000004 0x20003C40: 20001BB0 000134A5 0000100D 20001D28 0x20003C50: 00000006 00000006 20001C38 20001D44...
Page 96: Historique Des Versions
Historique des versions Adafruit maintient un historique complet des modifications de son firmware. (Adafruit, anglais). Vous trouverez cette historique directement depuis le tutoriel d'Adafruit https://learn.adafruit.com/adafruit-bluefruit-le-shield/history...
Page 97: Service Gatt En Détail
' et 'Caractéristiques'. Pour exposer des données vers un autre périphérique, vous devez instancier low-energy/gatt#services-and-characteristics au moins un service sur votre périphérique. Les modules Adafruit Bluefruit LE Pro supporte quelques services 'standard' décris ci-après (d'autres pourraient être ajoutés dans le futur). UART Service The UART Service is the standard means of sending and receiving data between connected devices, and simulates a familiar two- line UART interface (one line to transmit data, another to receive it).
Page 98: Le Service Uart
Il est basé sur les spécifications propriétaire UART service de Nordic Semiconductors. Les données envoyées ou reçues par ce service peuvent être visualisées à l'aide des APPs nRFUART de Nordic Semiconductors pour Android et iOS. Ce service est disponible sur tous les modules Bluefruit LE et est automatiquement démarré durant la séquence de mise sous tension.
Page 99: Réinitialisation D'usine
5 Réinitialisation d'usine via la pastille de test FCTR Réinitialisation d'usine Il y a plusieurs méthodes utilisable pour effectuer une réinitialisation d'usine sur votre module Bluefruit LE. Cela permet de réinitialiser le module s'il est mal configuré ou s'il est nécessaire d'effacer des changements permanent (comme UriBeacon ou modification du payload d'avertissement, etc).
Page 100: Croquis D'exemple Factoryreset
Croquis d'exemple FactoryReset Il existe également un croquis/sketch d'exemple nommé FactoryReset (voir les exemples de la bibliothèque Adafruit Bluefruit LE disponible sous le point de menu 'Fichier > Exemples > Adafruit_BluefruitLE_nRF51 (Voyez la section logiciel dans ce tutoriel pour les instructions concernant l'installation de la bibliothèque): https://learn.adafruit.com/introducing-the-adafruit-bluefruit-spi-breakout/software...
Page 101: Réinitialisation D'usine Via La Pastille De Test Fctr
Réinitialisation d'usine via la pastille de test FCTR Sous la carte Bluefruit LE Friend ou le shield il y a une pastille de test ou broche qui expose la broche "Factory Reset" du module. Cette pastille/broche porte la mention FCR ou F.RST sur la sérigraphie. Placer cette broche au niveau bas avant la mise-sous- tension provoquera la réinitialisation d'usine au démarrage.
Page 102: Mise-À-Jour Firmware (Dfu)
Mise à jour DFU DFU est l'acronyme de Device Firmware Update (mise-à-jour du Firmware du périphérique). Adafruit travaille constamment sur le firmware du Bluefruit LE pour y ajouter de nouvelles fonctionnalités et maintenir le firmware à jour. Pour faciliter la mise-à-jour de ces modification, Adafruit à inclus un procédé de mise-à-jour "over the air" (via la connexion Bluetooth) pour tous les modules BlueFruit LE à...
Page 103: Présentation De Sdep
SDEP quelque soit le mécanisme de transport (USB HID, SPI, I2C, Donnée via une connexion sans fil, etc.). Tous les messages SDEP ont une entête de 4 octets et dans le cas des modules Bluefruit LE jusqu'à 16 octets de payload. Les grands messages sont coupé...
Page 104: Exemple De Transaction
La ligne IRQ est activée par le par le Bluefruit LE Shield (ou Friend) SPI dès que (et aussi longtemps que) un paquet SDEP complet est disponible dans la mémoire tampon (buffer) du nRF51822. Vous devriez lire le paquet lorsque l'IRQ (interruption) est activée, garder la ligne CS activée durant la transaction entière (comme détaillé...
Page 105: Indicateur Du Type De Message
Cette partie du tutoriel est très technique et ne concernera, a priori, que quelques utilisateurs avancés. Vous pouvez poursuivre votre lecture directement sur tutoriel d'Adafruit Si cette partie du tutoriel vous intéresse, vous pouvez poursuivre votre lecture sur https://learn.adafruit.com/adafruit-bluefruit-le- shield/sdep-spi-data-transport#sdep-data-transactions...
Page 106: Bluefruit Le Client Apps And Libraries
] (disponible sur l'Apple store). https://itunes.apple.com/app/adafruit-bluefruit-le-connect/id830125974?mt=8 Le code source swift complet de Bluefruit LE Connect pour iOS est également disponible sur Github. Vous aurez besoin de XCode et un accès au programme développeur d'Apple ("Apple developper program") pour utiliser ce project: Code source de la Version 1.x: https://github.com/adafruit/Bluefruit_LE_Connect...
Page 107 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Ligne de commande Bluefruit LE pour mise-à-jour via OS X (Swift) Cet outil en ligne de commande expérimental (non supporté, disponible à titre de "test de concept") peut être utilisé pour faire une mise-à-jour du Firmware des périphériques Bluefruit.
Page 108 Crédit: AdaFruit Industries www.adafruit.com http://www.adafruit.com Toujours en guise de "test de concept", Adafruit à produit du code pour utiliser Python avec les APIs Bluetooth natives sur sur OS X et la dernière versions de Bluez pour Linux (disponibles sur certaines distributions Linux).
Page 109 RPi est inclus dans le dépot - recompiler cet outils depuis les sources nécessite un temps considérable.) Adafruit n'offre pas de support actif pour cet outil (puis qu'il s'agit d'un outil à usage interne). Il est rendu public pour aider les utilisateurs aventureux qui désirent se débrouiller par eux-même.
Page 110: Foire Aux Questions
Mon module Bluefruit LE peut-il se connecter sur d'autres périphériques Bluefruit LE ? Non, le firmware Bluefruit LE d'Adafruit est uniquement un périphérique et ne fonctionne pas en mode Central (comme un SmartPhone ou support BLE d'un laptop). Si vous avez besoin du mode Central alors vous devriez vous pencher sur les nouveaux produits basés sur nRF52832 tel que...
Page 111: Bluefruit Le Connect (Android)
Comment puis-je faire une mise-à-jour pour utiliser la dernière version du firmware? La façon la plus facile de maintenir vos modules Bluefruit LE à jour est d'utiliser l'app Bluefruit LE Connect pour Android ou Bluefruit LE Connect pour iOS https://play.google.com/store/apps/details?id=com.adafruit.bluefruit.le.connect https://itunes.apple.com/app/adafruit-bluefruit-le-...
Page 112 Comment est ce que je reflash mon module Bluefruit LE via SWD? Reflasher le module Bluefruit LE via SWD (ex: passer à la version sniffer du firmware et inversement) est une opération réalisée à vos propre risque et peu bloquer votre périphérique, et Adafruit ne peut pas offrir de support pour une telle opération!.
Page 113: Activer Les Releases Beta Pour Android
AdaLink (wrapper de débogage SWD/JTAG) La transition entre les deux types de carte (sniffer et module Bluefruit LE) n'est malheureusement pas une opération sans risque et nécessite du matériel et logiciel complémentaires et du savoir faire. Cette technique avancé n'est pas prise en charge par l'équipe support d'Adafruit.
Page 114 Nordic Master Emulator Firmware (MEFW) with nRF51822 0.11.0 6 paquets * 20 octets * 1/0.0075 = 16 kB/s = 128 kbps Il y a également une limite imposée par le firmware du Bluefruit LE (Adafruit travaille activement pour améliorer le débit dans la release 0.7.0).
Page 115 BlueZ nécessite un peu d'étude pour pouvoir l'utiliser. Vous trouverez ci-dessous quelques notes sur une approche permettant d'envoyer et recevoir des données en utilisant le service BLE UART disponible sur tous les modules Bluefruit LE et toutes les cartes Bluefruit LE.
Page 116 handle: 0x000b, uuid: 6e400002-b5a3-f393-e0a9-e50e24dcca9e handle: 0x000c, uuid: 00002803-0000-1000-8000-00805f9b34fb handle: 0x000d, uuid: 6e400003-b5a3-f393-e0a9-e50e24dcca9e handle: 0x000e, uuid: 00002902-0000-1000-8000-00805f9b34fb handle: 0x000f, uuid: 00002800-0000-1000-8000-00805f9b34fb handle: 0x0010, uuid: 00002803-0000-1000-8000-00805f9b34fb handle: 0x0011, uuid: 00002a27-0000-1000-8000-00805f9b34fb # 6e400002 (handle 0x000b) = TX characteristic # 6e400003 (handle 0x000d) = RX characteristic # Optionel (mais peut être utile) ...
Page 117: Téléchargement
- Translated to French by shop.mchobby.be CC-BY-SA for the translation http://shop.mchobby.be https://learn.adafruit.com/users/ktownsend Copies must includes this credit, link to this page and the section "crédit de traduction" (translation credit). Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com http://www.adafruit.com...