30 894
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − {{traduction}}+ − − Ligne 13 :
Ligne 11 : − + Ligne 22 :
Ligne 20 : − + Ligne 33 :
Ligne 31 : − + − {{traduction}} − − + − We regularly release [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware Bluefruit LE firmware images] with bug fixes and new features. Each AT command in this learning guide lists the minimum firmware version required to use that command, but for a higher level overview of the changes from one firmware version to the next, consult the [https://learn.adafruit.com/introducing-adafruit-ble-bluetooth-low-energy-friend/history firmware history page].+ − == Does my Bluefruit LE device support ANCS? ==+ − ANCS is on the roadmap for us (most likely in the 0.7.x release family), but we don't currently support it since there are some unusual edge cases when implementing it as a service. − + + − If your device is stuck in DFU mode for some reason and the firmware was corrupted, you have several options.+ + − First, try a factory reset by holding down the DFU button for about 10 seconds until the CONN LED starts flashing, then release the DFU button to perform a factory reset. + − If this doesn't work, you may need to reflash your firmware starting from DFU mode, which can be done in one of the following ways:+ − Bluefruit LE Connect (Android) − + − + − + − + − + − + − + − + − + + − Unfortunately, the iOS app doesn't yet support custom firmware updates from DFU mode yet, but we will get this into the next release.+ − Nordic nRF Toolbox − You can also use Nordic's nRF Toolbox application to update the firmware using the OTA bootloader.+ + − On '''Android''':+ − + − + − + − + − + − + − + − + − + − On '''iOS''':+ − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − on '''Adafruit_nRF51822_Flasher''':+ − As a last resort, if you have access to a Raspberry Pi, a Segger J-Link or a STLink/V2, you can also try manually reflashing the entire device, as described in the FAQ above, with further details on the [[Bluefruit-LE-Shield-Software-resources|Software Resources]] page.+ − + − Reflashing Bluefruit LE modules over SWD (ex. switching to the sniffer firmware and back) is '''at your own risk and can lead to a bricked device, and we can't offer any support for this operation!''' You're on your own here, and there are unfortunately 1,000,000 things that can go wrong, which is why we offer two separate Bluefruit LE Friend boards -- the sniffer and the normal Bluefruit LE Friend board with the non-sniffer firmware, which provides a bootloader with fail safe features that prevents you from ever bricking boards via OTA updates.+ + + − + − Transitioning between the two board types (sniffer and Bluefruit LE module) is unfortunately not a risk-free operation, and requires external hardware, software and know-how to get right, which is why it isn't covered by our support team.+ − That said ... if you're determined to go down that lonely road, and you have a [https://www.adafruit.com/search?q=J-Link Segger J-Link] (which is what we use internally for production and development), or have already erased your Bluefruit LE device, you should have a look at [https://github.com/adafruit/Adafruit_Adalink AdaLink], which is the tool we use internally to flash the four files required to restore a Bluefruit LE module. (Note: recent version of AdaLink also support the cheaper [https://www.adafruit.com/products/2548 STLink/V2], though the J-Link is generally more robust if you are going to purchase a debugger for long term use.)+ − The mandatory Intel Hex files are available in the [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware Bluefruit LE Firmware repo]. You will need to flash: + − * An appropriate bootloader image − * An appropriate SoftDevice image − * The Bluefruit LE firmware image − * The matching signature file containing a CRC check so that the bootloader accepts the firmware image above (located in the same folder as the firmware image) − The appropriate files are generally listed in the [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware/blob/master/releases.xml version control .xml file] in the firmware repository.+ + + + + − If you are trying to flash the sniffer firmware (at your own risk!), you only need to flash a single .hex file, which you can find [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware/tree/master/sniffer/1.0.1 here]. The sniffer doesn't require a SoftDevice image, and doesn't use the fail-safe bootloader -- which is why changing is a one way and risky operation if you don't have a supported SWD debugger.+ + + − + − The latest versions of the Bluefruit LE Connect applications for iOS and Android allow you to optionally update your Bluefruit LE modules with pre-release or BETA firmware. + − This functionality is primarilly provided as a debug and testing mechanism for support issues in the forum, and should only be used when trying to identify and resolve specific issues with your modules!+ − + − + − + − + − + − + − + − + − + − + − + − + − + − In Android 6.0 there were [http://developer.android.com/about/versions/marshmallow/android-6.0-changes.html#behavior-hardware-id some important security changes] that affect Bluetooth Low Energy devices. If location services are unavailable (meaning the GPS is turned off) you won't be able to see Bluetooth Low Energy devices advertising either. See [https://code.google.com/p/android/issues/detail?id=190372&q=GPS&colspec=ID%20Type%20Status%20Owner%20Summary%20Stars this issue] for details.+ − Be sure to enable location services on your Android 6.0 device when using Bluefruit LE Connect or other Bluetooth Low Energy applications with your Bluefruit LE modules.+ − + − This depends on a variety of factors, and is determined by the capabilities of the central device (the mobile phone, etc.) as much as the peripheral.+ − Taking the HW limits on the nR51822 into account (max 6 packets per connection interval, and a minimum connection interval of 7.5ms) you end up with the following theoretical limits on various mobile operating systems:+ − + − + − + − + − + − + − There are also some limits imposed by the Bluefruit LE firmware, but we are actively working to significantly improve the throughput in the upcoming 0.7.0 release, which will be available Q2 2016. The above figures are useful as a theoretical maximum to decide if BLE is appropriate for you project or not.+ − '''UPDATE:''' For more specific details on the limitations of various '''Android''' versions and phones, see [https://devzone.nordicsemi.com/blogs/1046/what-to-keep-in-mind-when-developing-your-ble-andr/ this helpful post from Nordic Semiconductors].+ − == Can my Bluefruit board detect other Bluefruit boards or Central devices? ==+ − No. All of our Bluefruit LE modules currently operate in peripheral mode, which means they can only advertise their own existence via the advertising payload. The central device (usually your phone or laptop) is responsible for listening for these advertising packets, starting the connection process, and inititating any transactions between the devices. There is no way for a Bluefruit module to detect other Bluefruit modules or central devices in range, they can only send their own advertising data out and wait for a connection request to come in. − + − The short answer is: you can't.+ − RF devices normally measure signal strength using RSSI, which stands for Received Signal Strength Indicator, which is measured in dBm. The closer the devices are the strong the RSSI value generally is (-90dBm is much weaker than -60dBm, for example), but there is no reliable relationship between RSSI values in dBm and distance in the real world. If there is a wall between devices, RSSI will fall. If there is a lot of interference on the same 2.4GHz band, RSSI will fall. Depending on the device, if you simply change the antenna orientation, RSSI will fall. You can read the RSSI value between two connected devices with the {{fname|AT+BLEGETRSSI}} command, but there are no meaningful and repeatable conclusions that can be drawn from this value about distance other than perhaps 'farther' or 'closer' in a very loose sense of the terms.+ − + − This depends on a number of factors beyond the module itself such as antenna orientation, the antenna design on the phone, transmit power on the sending node, competing traffic in the same 2.4GHz bandwidth, obstacles between end points, etc.+ − It could be as low as a couple meters up to about 10 meters line of sight, but generally Bluetooth Low Energy is designed for very short range and will work best in the 5-6 meter or less range for reliable communication, assuming normal Bluefruit firmware settings.+ − == How many GATT services and characteristics can I create? ==+ − For firmware 0.7.0 and higher, the following limitations are present: − * Maximum number of services: 10 − * Maximum number of characteristics: 30 − * Maximum buffer size for each characteristic: 32 bytes − * Maximum number of CCCDs: 16 − == Is it possible to modify or disable the built in GATT services and characteristics (DIS, DFU, etc.)? ==+ − No, unfortunately you can't. We rely on the [https://www.bluetooth.com/specifications/gatt/viewer?attributeXmlFile=org.bluetooth.service.device_information.xml Device Information Service] (DIS) contents to know which firmware and bootloader version you are running, and wouldn't be able to provide firmware updates without being able to trust this information, which i why it's both mandatory and read only. − Similarly, the DFU service is mandatory to maintain over the air updates and disabling it would create more problems that it's presence would cause.+ + − == How can I use BlueZ and gatttool with Bluefruit modules? ==+ − BlueZ has a bit of a learning curve associated with it, but you can find some notes below on one option to send and receive data using the BLE UART Service built into all of our Bluefruit LE modules and boards. − These commands may change with different versions of BlueZ. Version 5.21 was used below.+ + + + + + + + + + + + + + + + − + − + − + Ligne 209 :
Ligne 218 : − + Ligne 216 :
Ligne 225 : − + Ligne 239 :
Ligne 248 : − + − + − + − + − + − + − + − + − + − + − + + Ligne 266 :
Ligne 276 : − + − + − + + − + + − + − + + − + + + + + + − == Can I use the IRQ pin to wake my MCU up from sleep when BLE UART data is available? ==+ − No, on SPI-based boards the IRQ pin is used to indicate that an SDEP response is available to an SDEP command. For example, when you sent the `AT+BLEUARTRX` command as an SDEP message, the Bluefruit firmware running on the nRF51822 will parse the message, prepare an SDEP response, and trigger the IRQ pin to tell the MCU that the response is ready. This is completely independant from the BLE UART service, which doesn't have interrupt capability at present.
→Comment puis-je utiliser BlueZ et gatttool avec les modules Bluefruit ?
{{Bluefruit-LE-Shield-NAV}}
{{Bluefruit-LE-Shield-NAV}}
== Mon Bluefruit LE peut-il dialoguer avec un périphérique 'Classic Bluetooth' ? ==
== Puis-je dialoguer avec un périphérique 'Classic Bluetooth' avec un Bluefruit LE? ==
Non. Bluetooth Low Energy et Bluetooth 'Classic' sont deux parties d'une même noyau de spécification Bluetooth (''Bluetooth Core Specification'') -- définie et maintenue par le Bluetooth SIG -- mais sont des protocoles complètements différents fonctionnant avec des contraintes et des exigences différentes. Les deux protocoles ne peuvent pas dialoguer directement.
Non. Bluetooth Low Energy et Bluetooth 'Classic' sont deux parties d'une même noyau de spécification Bluetooth (''Bluetooth Core Specification'') -- définie et maintenue par le Bluetooth SIG -- mais sont des protocoles complètements différents fonctionnant avec des contraintes et des exigences différentes. Les deux protocoles ne peuvent pas dialoguer directement.
Les produits à base de '''nRF51'''8322 (comme celui utilisé dans ce guide) ne sont '''PAS''' capable de fonctionner en mode Centrale parce qu'il n'est pas supporté par le firmware qu'il utilise. Il n'est pas possible de faire une mise-à-jour en toute sécurité sans utiliser un matériel spécial.
Les produits à base de '''nRF51'''8322 (comme celui utilisé dans ce guide) ne sont '''PAS''' capable de fonctionner en mode Centrale parce qu'il n'est pas supporté par le firmware qu'il utilise. Il n'est pas possible de faire une mise-à-jour en toute sécurité sans utiliser un matériel spécial.
== Pourquoi aucun de mes changements ne persiste lorsque lorsque j'utilise un croquis d'exemple ? ==
== Pourquoi mes changements ne persiste t'il pas lorsque j'utilise un croquis d'exemple ? ==
La plupart des croquis effectuent une réinitialisation d'usine (FACTORY RESET) pour être certain que le module Bluefruit LE soit dans un état connu avant d'exécuter le croquis de démo.
La plupart des croquis effectuent une réinitialisation d'usine (FACTORY RESET) pour être certain que le module Bluefruit LE soit dans un état connu avant d'exécuter le croquis de démo.
Si vous ne voyez pas le flag/drapeau 'FACTORYRESET_ENABLE' dans le fichier .ino c'est que vous avez probablement une ancienne version de la bibliothèque. Vous pourriez avoir besoin de faire une mise-à-jour de la bibliothèque via le gestionnaire de bibliothèque Arduino.
Si vous ne voyez pas le flag/drapeau 'FACTORYRESET_ENABLE' dans le fichier .ino c'est que vous avez probablement une ancienne version de la bibliothèque. Vous pourriez avoir besoin de faire une mise-à-jour de la bibliothèque via le gestionnaire de bibliothèque Arduino.
== Ai-je besoin de CTS et RTS sur mon module UART Bluefruit LE ? ==
== Ai-je besoin de CTS et RTS avec mon module UART Bluefruit LE ? ==
Utiliser CTS et RTS n'est strictement nécessaire lorsque l'on utilise une connexion série matérielle (''HW serial'') mais elle devrait être utilisé lors d'une connexion série logicielle (''SW serial'') pour réguler le flux de donnée et éviter de perdre des octets. Il est également recommandé d'utiliser CTS et RTS si vous avez beaucoup de données à transférer.
Utiliser CTS et RTS n'est strictement nécessaire lorsque l'on utilise une connexion série matérielle (''HW serial'') mais elle devrait être utilisé lors d'une connexion série logicielle (''SW serial'') pour réguler le flux de donnée et éviter de perdre des octets. Il est également recommandé d'utiliser CTS et RTS si vous avez beaucoup de données à transférer.
Activer ces deux broches devrait résoudre les problèmes de fiabilité que vous pourriez rencontrer avec les grandes commandes, ou les transmissions de nombreuses commandes d'affilé.
Activer ces deux broches devrait résoudre les problèmes de fiabilité que vous pourriez rencontrer avec les grandes commandes, ou les transmissions de nombreuses commandes d'affilé.
== How can I update to the latest Bluefruit LE Firmware? ==
== 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 [https://play.google.com/store/apps/details?id=com.adafruit.bluefruit.le.connect Bluefruit LE Connect pour Android] ou [https://itunes.apple.com/app/adafruit-bluefruit-le-connect/id830125974?mt=8 Bluefruit LE Connect pour iOS].
La façon la plus facile de maintenir vos modules Bluefruit LE à jour est d'utiliser l'app [https://play.google.com/store/apps/details?id=com.adafruit.bluefruit.le.connect Bluefruit LE Connect pour Android] ou [https://itunes.apple.com/app/adafruit-bluefruit-le-connect/id830125974?mt=8 Bluefruit LE Connect pour iOS].
Ces deux apps inclus une fonctionnalité de mise-à-jour du firmware qui vous permet de facilement télécharger le dernier Firmware et de lancer une mise-à-jour via la connexion Bluetooth. En cas de problème, vous pouvez également utiliser l'app pour revenir à une version précédente du firmware Bluefruit LE.
Ces deux apps inclus une fonctionnalité de mise-à-jour du firmware qui vous permet de facilement télécharger le dernier Firmware et de lancer une mise-à-jour via la connexion Bluetooth. En cas de problème, vous pouvez également utiliser l'app pour revenir à une version précédente du firmware Bluefruit LE.
== Which firmware version supports 'xxx'? ==
== Quelle version du firmware supporte 'xxx'? ==
Adafruit publie régulièrement [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware des images Firmware pour Bluefruit LE] corrigeant des bugs et ajoutant de nouvelles fonctionnalités. Chaque commande AT reprise dans le guide affiche la version du Firmware nécessaire pour utiliser la commande.
Pour une vue plus globale des changements du Firmware (d'une version à l'autre), vous pouvez consulter la [https://learn.adafruit.com/introducing-adafruit-ble-bluetooth-low-energy-friend/history page ''firmware history''] maintenu par Adafruit.
== My Bluefruit LE device is stuck in DFU mode ... what can I do?
== Est-ce que mon périphérique Bluefruit LE supporte ANCS? ==
[https://developer.apple.com/library/content/documentation/CoreBluetooth/Reference/AppleNotificationCenterServiceSpecification/Introduction/Introduction.html ANCS] (''Apple Notification Center Service'') fait partie des projets d'Adafruit (probablement durant la famille des releases 0.7.x). ANCS n'est actuellement pas supporté par Adafruit étant donné qu'il y a quelques effets de bord particuliers lorsqu'il est implémenté comme un service.
== Mon Bluefruit LE est planté en mode DFU ... que puis-je faire ? ==
Si votre périphérique est planté en mode DFU (pour une raison quelconque) avec un firmware est corrompu alors il vous reste plusieurs options.
Premièrement, essayer de faire une réinitialisation d'usie (''factory reset'') en maintenant le bouton DFU enfoncé pendant environ 10 secondes (jusqu'à ce que la LED '''CONN''' commence a flasher) puis relâchez le bouton DFU pour effectuer la réinitialisation d'usine.
Si cela ne fonctionne pas alors vous pourriez avoir besoin de reflasher votre firmware en mode DFU. Cela peut être réalisé d'une des façons suivantes:
* Place the module in DFU mode (constant LED blinky)
=== Bluefruit LE Connect (Android) ===
* Open Bluefruit LE Connect
* Placez le module en mode DFU (LED clignotant constamment)
* Connect to the 'DfuTarg' device
* Ouvrez Bluefruit LE Connect
* Once connected, you will see a screen with some basic device information. Click the '...' in the top-right corner and select '''Firmware Updates'''
* Connectez vous sur le périphérique en mode DFU (''DfuTarg'')
* Click the '''Use Custom Firmware''' button
* Une fois connecté, vous verrez un écran avec des informations de base. Cliquer sur '...' dans le coin en haut à droite et sélectionnez '''Firmware Updates'''
* Select the appropriate .hex and .init files (copied from the [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware Bluefruit LE Firmware repo]) ... for the BLEFRIEND32 firmware version 0.6.7, this would be:
* Cliquez sur le bouton '''Use Custom Firmware''' (''Utiliser un Firmware personnalisé'')
** Hex File: blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex
* Selectionner les fichiers .hex et .init approrpriés (copiés depuis le [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware dépôt des firmware Bluefruit LE]) ... pour le firmware BLEFRIEND32 version 0.6.7, cela devrait être:
** Init File: blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat
** Fichier Hex: blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex
* Click '''Start Update'''
** Fichier Init: blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat
* Cliquer sur '''Start Update'''
L'app iOS ne supporte pas encore la mise-à-jour de firmware personnalié depuis le mode DFU mais Adafruit fait le nécessaire pour rendre la fonctionnalité disponible.
=== La boîte à outil Nordic nRF ===
Vous pouvez également utiliser l'application "Nordic's nRF Toolbox" pour faire une mise-à-jour du firmware en utilisant le bootloader OTA (''Over The Air'').
Sur '''Android''':
* Open nRF Toolbox (using the latest version)
* Ouvez nRF Toolbox (utiliser la dernière version de l'outil)
* Click the '''DFU''' icon
* Cliquer sur l'icone '''DFU'''
* Click the '''Select File''' button
* Cliquer sur le bouton '''Select File''' pour sélectionner un fichier
* Select '''Application''' from the radio button list, then click '''OK'''
* Selectionner '''Application''' depuis dans la liste des option PUIS cliquez sur '''OK'''
* Find the appropriate .hex file (ex. 'blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex')
* Localiser le fichier .hex approprié (ex: 'blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex')
* When asked about the '''Init packet''', indicate '''Yes''', and select the appropriate *_init.dat file (for example: 'blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat').
* Lorsque l'App vous demande s'il faut un '''Init packet''' (''paquet d'initialisation''), répondez Oui en pressant sur '''Yes'''.<br />Sélectionner le fichier *_init.dat approprié (par exemple: 'blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat').
* Click the '''Select Device''' button at the bottom of the main screen and find the '''DfuTarg''' device, clicking on it
* Cliquer sur le bouton '''Select Device''' pour sélectionner un périphérique (voir en bas du l'écran principale) et sélectionner le périphérique en mode DFU ('''DfuTarg''') en cliquant dessus
* Click the '''Upload''' button, which should now be enabled on the home screen
* Cliquez sur le bouton '''Upload''' (''téléverser'') qui devrait maintenant être disponible sur l'écran principal.
* This will begin the DFU update process which should cause the firmware to be updated or restored on your Bluefruit LE module
* Cela devrait débuter le processus de mise-à-jour DFU, ce qui devrait faire une mise-à-jour du Firmware et restaurer l'état du module Bluefruit LE
Sur '''iOS''':
* Create a .zip file containing the .hex file and init.dat file that you will use for the firmware update. For example:
* Créer un fichier .zip contenant ke fichier .hex et le fichier init.dat que vous allez utiliser pour faire la mise-à-jour du firmware. Par exemple:
** Rename 'blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex' to '''application.hex'''
** Renommer 'blefriend32_s110_xxac_0_6_7_150917_blefriend32.hex' en '''application.hex'''
** Rename 'blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat' to '''application.dat'''
** Renommer 'blefriend32_s110_xxac_0_6_7_150917_blefriend32_init.dat' en '''application.dat'''
* Upload the '''.zip file''' containing the application.hex and application.dat files to your iPhone using uTunes, as described here
* Téléverser le '''fichier .zip ''' contenant les fichiers {{fname|application.hex}} et {{fname|application.dat}} sur votre iPhone en utilisant, comme décrit ci-dessous:
* Open the nRF Toolbox app (using the latest version)
* Ouvrer l'app nRF Toolbox (utilisez la dernière version)
* Click the '''DFU''' icon
* Cliquer sur l'icone '''DFU'''
* Click the '''Select File''' text label
* Cliquer sur le libellé texte '''Select File''' (''sélectionner fichier'')
* Switch to '''User Files''' to see the .zip file you uploaded above
* Basculer vers '''User Files''' (''fichier utilisateur'') pour voir le fichier .zip que vous avez téléchargé ci-dessus
* Select the .zip file (ex. blefriend32_065.zip)
* Sélectionner le fichier .zip (ex: blefriend32_065.zip)
* On the main screen select '''Select File Type'''
* Sur l'écran principal, sélectionner '''Select File Type''' (''sélectionner le type de fichier'')
* Select '''application'''
* Sélectionner '''application'''
* On the main screen select '''SELECT DEVICE'''
* Dans l'écran principal, cliquer sur '''SELECT DEVICE''' (''sélectionner périphérique'')
* Select '''DfuTarg'''
* Sélectionner le périphérique en mode DFU ('''DfuTarg''')
* Click the '''Upload''' button which should now be enabled
* Cliquer sur le bouton '''Upload''' (''téléverser'') qui devrait maintenant être disponible.
* This will begin the DFU process and your Bluefruit LE module will reset when the update is complete
* Cela débutera le processus de mise-à-jour DFU et votre module Bluefruit LE sera réinitialisé une fois l'opération terminée
* If you get the normal 2 or 3 pulse blinky pattern, the update worked!
* Si vous voyez une schéma normal de 2 ou 3 clignotement alors la mise-à-jour à fonctionné!
Avec '''Adafruit_nRF51822_Flasher''':
En dernier ressort, si vous avez accès à un Raspberry-Pi, un Segger J-Link ou un STLink/V2, vous pouvez manuellement reflasher le périphérique entier, comme décrit ci-dessus dans la foire aux questions, avec plus de détails sur la page [[Bluefruit-LE-Shield-Software-resources|ressources logicielles]].
== How do I reflash my Bluefruit LE module over SWD? ==
== 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!'''. Vous êtes seule pour réaliser cette opération et il y a malheureusement 1,000,000 de choses qui peuvent mal tourner. C'est pour cela qu'Adafruit propose deux cartes différentes:
* Le Bluefruit LE Friend en version sniffer
* Et le Bluefruit LE Friend en version normale (avec le firmware ''non-sniffer'') qui fournit un bootloader avec un fonctionnalité de récupération qui empêche la corruption de la carte lors d'une mise-à-jour OTA défaillante.
=== AdaLink (SWD/JTAG Debugger Wrapper) ===
=== 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.
Cela étant... si vous êtes déterminé à poursuivre seul sur cette voie et que vous disposez d'un [https://www.adafruit.com/search?q=J-Link Segger J-Link] (ce qu'Adafruit utilise en interne pour le développement et la production), ou si vous avez déjà effacé vitre périphérique Bluefruit LE, vous pouvez jeter un oeil sur [https://github.com/adafruit/Adafruit_Adalink AdaLink] (qui est l'outil utilisé par Adafruit pour flasher les 4 fichiers nécessaires pour restaurer un module Bluefruit LE module).
(Note: Les versions plus récentes d'AdaLink supporte également [https://www.adafruit.com/products/2548 STLink/V2] par l'intermédiaire de J-Link (J-Link est généralement plus robuste si vous achetez un débogger pour un usage à long terme.)
Le fichiers Hex Intel requis sont disponibles sur [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware le dépôt des firmwares Bluefruit LE]. Vous aurez également besoin de flasher:
* Une image bootloader adéquate
* Une image SoftDevice adéquate
* Une image du Firmware Bluefruit LE
* Le fichier de signature correspondant contenant un CRC de vérification pour que le bootloader accepte l'image firmware ci-dessus (ce fichier est localisé dans le même répertoire que l'image du Firmware)
Les fichiers adéquats sont généralement listés dans [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware/blob/master/releases.xml le fichier .xmf de contrôle de version] (dans le dépôt du firmware).
Si vous essayez de flasher le firmware sniffer (à vos propres risques!), vous aurez besoin de flasher un seul fichier .hex, que vous pourrez trouver [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware/tree/master/sniffer/1.0.1 ici]. Le sniffer ne nécessite pas d'image SoftDevice et n'utilise pas le bootloader fail-safe -- c'est la raison pour laquelle cette modification est à sens unique et une opération risquée si vous ne disposez pas d'un débogger SWD supporté.
=== Adafruit_nF51822_Flasher ===
=== Adafruit_nF51822_Flasher ===
We also have an internal python tool available that sits one level higher than AdaLink (referenced above), and makes it easier to flash specific versions of the official firmware to a Bluefruit LE module. For details, see the [https://github.com/adafruit/Adafruit_nRF51822_Flasher Adafruit_nRF51822_Flasher] repo.
We also have an internal python tool available that sits one level higher than AdaLink (referenced above), and makes it easier to flash specific versions of the official firmware to a Bluefruit LE module. For details, see the [https://github.com/adafruit/Adafruit_nRF51822_Flasher Adafruit_nRF51822_Flasher] repo.
== Can I access BETA firmware releases? ==
== Comment puis-je accéder aux firmwares BETA ? ==
Les dernières versions de l'application Bluefruit LE Connect pour iOs et Android vous permet de faire une mise-à-jour de votre module Bluefruit LE avec de nouveaux firmwares en pre-release ou firmware BETA.
Cette fonctionnalité est fournie pour les opérations de débogages et mécanismes de test pour le support de problèmes particuliers sur le forum. Vous devriez uniquement utiliser ces firmwares pour identifier et résoudes des problèmes particuliers sur votre module!
=== Activer les Releases BETA pour iOS ===
=== Activer les Releases BETA pour iOS ===
* Make sure you have at least '''version 1.7.1''' of Bluefruit LE Connect
* Assurez vous d'avoir une version récente de BlueFruit LE connect (au moins la '''version 1.7.1''')
* Go to the Settings page
* Allez dans la page "Settings" (''paramètres'')
* Scroll to the bottom of the Settings page until you find '''Bluefruit LE'''
* Faites défiler l'écran des paramètres jusqu'à ce que vous trouviez le libellé '''Bluefruit LE'''
* Click on the Bluefruit LE icon and enable the '''Show beta releases''' switch
* Cliquez sur l'icone Bluefruit LE et activez le l'option '''Show beta releases''' (''affiché les releases beta'')
* You should be able to see any BETA releases available in the firmware repo now when you use Bluefruit LE Connect
* Maintenant, lorsque vous utilisez BlueFruit LE connect, vous devriez être capable de voir toutes les releases Beta disponibles dans le dépôt des firmwares.
=== Enabling BETA Releases on Android ===
=== Activer les Releases BETA pour Android ===
* Make sure you have the latest version of Bluefruit LE Connect
* Assurez-vous d'avoir la dernière version de Bluefruit LE Connect
* Open the Bluefruit LE Connect application
* Ouvrir l'application Bluefruit LE Connect
* Click the "..." icon in the top-right corner of the app's home screen
* Cliquer sur l'icone "..." dans le coin en haut à droite de l'écran principal de l'application.
* Select '''Settings'''
* Selectionner '''Settings''' (''Paramètres'')
* Scroll down to the '''Software Updates''' section and enable '''Show beta releases'''
* Faites défiler l'écran jusqu'à la section '''Software Updates''' (''mise-à-jour logiciel'') et activer l'option '''Show beta releases''' (''afficher les releases Beta''')
* You should be able to see any BETA releases available in the firmware repo now when you use Bluefruit LE Connect
* Maintenant, vous devriez être capable de voir toutes les releases BETA disponible dans le dépôt github.
== Why can't I see my Bluefruit LE device after upgrading to Android 6.0? ==
== Pourquoi ne puis-je pas/plus voir mon périphérique Bluefruit LE après un upgrade à Android 6.0? ==
Il y a eu [http://developer.android.com/about/versions/marshmallow/android-6.0-changes.html#behavior-hardware-id quelques changement de sécurité important] dans Android 6.0 et cela affecte les périphériques Bluetooth Low Energy. Si les services de localisations ne sont pas disponibles (signifiant que le GPS est désactivé) vous ne serez pas capable de détecter les paquets d'annonce des périphériques Bluetooth Low Energy. Voyez [https://code.google.com/p/android/issues/detail?id=190372&q=GPS&colspec=ID%20Type%20Status%20Owner%20Summary%20Stars les détails ici].
Assurez-vous d'avoir activé le service de localisation sur votre Android 6.0 lorsque vous utilisez Bluefruit LE Connect ou autres applications Bluetooth Low Energy avec le module Bluefruit LE d'Adafruit.
== What is the theoretical speed limit for BLE? ==
== Quel est la vitesse théorique limite du BLE? ==
Cela dépends de plusieurs facteurs, et déterminé plus les capacités du périphérique centrale (votre smartphone, etc) que par le périphérique.
En prenant en compte la limitation matérielle du nR51822 (6 paquets max par intervalle de connexion et un in intervalle de connexion minimum de 7.5ms), nous atteignons les limites théoriques suivantes sur différents systèmes d'exploitation mobile :
* '''iPhone 5/6 + IOS 8.0/8.1'''<br />6 packets * 20 bytes * 1/0.030 s = 4 kB/s = 32 kbps
* '''iPhone 5/6 + IOS 8.0/8.1'''<br />6 paquets * 20 octets * 1/0.030 s = 4 kB/s = 32 kbps
* '''iPhone 5/6 + IOS 8.2/8.3'''<br />3 packets * 20 bytes * 1/0.030 s = 2 kB/s = 16 kbps
* '''iPhone 5/6 + IOS 8.2/8.3'''<br />3 paquets * 20 octets * 1/0.030 s = 2 kB/s = 16 kbps
* '''iPhone 5/6 + IOS 8.x with nRF8001'''<br />1 packet * 20 bytes * 1/0.030 s = 0.67 kB/s = 5.3 kbps
* '''iPhone 5/6 + IOS 8.x with nRF8001'''<br />1 paquets * 20 octets * 1/0.030 s = 0.67 kB/s = 5.3 kbps
* '''Nexus 4'''<br />4 packets * 20 bytes * 1/0.0075 s = 10.6 kB/s = 84 kbps
* '''Nexus 4'''<br />4 paquets * 20 octets * 1/0.0075 s = 10.6 kB/s = 84 kbps
* '''Nordic Master Emulator Firmware (MEFW) with nRF51822 0.9.0'''<br />1 packet * 20 bytes * 1/0.0075 = 2.67 kB/s = 21.33 kbps
* '''Nordic Master Emulator Firmware (MEFW) with nRF51822 0.9.0'''<br />1 paquets * 20 octets * 1/0.0075 = 2.67 kB/s = 21.33 kbps
* ''' Nordic Master Emulator Firmware (MEFW) with nRF51822 0.11.0'''<br />6 packets * 20 bytes * 1/0.0075 = 16 kB/s = 128 kbps
* ''' Nordic Master Emulator Firmware (MEFW) with nRF51822 0.11.0'''<br />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).
Les chiffres ci-dessus sont des maximums théoriques utiles pour décider si BlueFruit Le est un matériel approprié pour votre projet.
'''Mise-à-jour:''' Voyez [https://devzone.nordicsemi.com/blogs/1046/what-to-keep-in-mind-when-developing-your-ble-andr/ ce billet très utile de Nordic Semiconductors] pour des détails spécifiques concernant les limitations concernant les différentes versions d' '''Android''' et téléphones.
== How can I determine the distance between my Bluefruit module and my phone in m/ft? ==
== Est ce que ma carte Bluefruit peut détecter d'autres cartes Bluefruit ou périphériques centrals ? ==
Non. Tous les modules Bluefruit LE d'Adafruit fonctionne actuellement en mode périphérique. Cela signifie que les cartes peuvent uniquement annoncer leur propre existence (via les payload d'avertissement). Le périphérique centrale (habituellement un smartphone ou laptop) a pour tâche d'écouter ces paquets d'annonce, puis démarrer un processus de connexion et initier les transactions entre les périphériques.
Le module BlueFruit LE n'as pas le moyen de détecter d'autres modules Bluefruit (ou périphériques centrales). Ils peuvent uniquement envoyer leurs propres paquets d'annonce et attendre après requête de connexion.
== How far away from my phone can I have my Bluefruit LE module? ==
== Comment puis-je déterminer la distance (en m) entre entre mon module Bluefruit et mon téléphone ? ==
La réponse courte est: cela n'est pas possible.
Les périphériques RF mesure normalement la puissance du signal en utilisant RSSI qui signifie "Received Signal Strength Indicator" (''indicateur de puissance du signal de réception). Cette puissance de signal se mesure en dBm (Décibel par milliwatt).
Plus près est le périphérique et plus fort sera la valeur de RSSI (par exemple: -90dBm est plus faible que -60dBm). Dans le monde réel, il n'y a cependant pas de relation fiable entre les valeurs de RSSI en dBm et la distance entre mes périphériques. Par exemple, le RSSI chutera, s'il y a un mur entre les périphériques. Le RSSI chutera également s'il y a beaucoup d'interférence sur la même bande 2.4GHz. Le RSSI peut également chuter en fonction du périphérique ou de l'orientation de l'antenne.
Vous pouvez lire la valeur de RSSI entre deux périphériques connectés en utilisant la commande {{fname|AT+BLEGETRSSI}}. La valeur de RSSI ne permet pas de tirer de résultat ou conclusion valable concernant la distance. Elle permet juste de donner une idée d'éloignement général (éloigné ou proche) en fonction de la force du signal.
== A quelle distance de mon téléphone puis-je capter mon module Bluefruit LE ? ==
Cela dépend de plusieurs facteurs au-delà du module comme l'orientation de l'antenne, la conception de l'antenne du SmartPhone, la puissance de transmission sur le noeud d'envoi, le trafic des différents appareils sur la bande de 2.4GHz, les obstacles entre l'émetteur et le récepteur, etc.
Cette distance peut être aussi réduite que quelques mètres jusqu'à une dizaine de mètres en terrain découvert. Bluetooth Low Energy est conçu pour des communications courtes distances et fonctionnera dans les meilleures conditions entre 5-6 mètres ou moins (pour un communication fiable et un paramétrage normal du Bluefruit LE).
== Combien de services GATT et caractéristiques puis-je créer ? ==
Les limitations suivantes sont applicable au firmware 0.7.0 ou supérieur :
* Nombre maximum de services: 10
* Nombre maximum de caractéristiques: 30
* Taille maximum de la mémoire tampon pour chaque caractéristique: 32 octets
* Nombre maximum de CCCDs: 16
== Est-il possible de modifier ou désactiver les services GATT et caractéristiques (DIS, DFU, etc.)? ==
Non, ce n'est malheureusement pas possible. Adafruit s'appuie sur la spécification du "[https://www.bluetooth.com/specifications/gatt/viewer?attributeXmlFile=org.bluetooth.service.device_information.xml Device Information Service]" (DIS) pour déterminer la versions du firmware et la version du bootloader fonctionnant sur le module BlueFruit LE. Bluefruit LE Connect ne pourra pas offrir de mise-à-jour Firmware sans disposer d'information fiable (comme celles offertes par DIS), raison pour laquelle ces deux information sont obligatoire et en lecture seule.
De même, le service DFU est également nécessaire pour maintenir la fonctionnalité de mise-à-jour OTA (over-the-air). Désactiver ce service créerait plus de problèmes que sa présence n'en provoque.
== Comment puis-je utiliser BlueZ et gatttool avec les modules Bluefruit ? ==
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.
Ces commandes pourraient changer avec une version différente de BlueZ. La version 5.21 était utilisée ci-dessous.
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
# Initialise the USB dongle
# Initialiser la clé USB
$ sudo hciconfig hci0 up
$ sudo hciconfig hci0 up
# Scan for the UART BLE device
# Scan des périphériques BLE UART
$ sudo hcitool lescan
$ sudo hcitool lescan
D6:4E:06:4F:72:86 UART
D6:4E:06:4F:72:86 UART
# Start gatttool, pointing to the UART device found above
# Démarrer gatttool, pointant sur le périphérique UART trouvé ci-dessus
$ sudo gatttool -b D6:4E:06:4F:72:86 -I -t random --sec-level=high
$ sudo gatttool -b D6:4E:06:4F:72:86 -I -t random --sec-level=high
Connection successful
Connection successful
# Scan for primary GATT Services
# Scan des services GATT principaux
[D6:4E:06:4F:72:86][LE]> primary
[D6:4E:06:4F:72:86][LE]> primary
attr handle: 0x0001, end grp handle: 0x0007 uuid: 00001800-0000-1000-8000-00805f9b34fb
attr handle: 0x0001, end grp handle: 0x0007 uuid: 00001800-0000-1000-8000-00805f9b34fb
attr handle: 0x000f, end grp handle: 0xffff uuid: 0000180a-0000-1000-8000-00805f9b34fb
attr handle: 0x000f, end grp handle: 0xffff uuid: 0000180a-0000-1000-8000-00805f9b34fb
# Get the handles for the entries in the UART service (handle 0x0009)
# Obtenir les handles pour les entrées dans le service UART (handle 0x0009)
[D6:4E:06:4F:72:86][LE]> char-desc
[D6:4E:06:4F:72:86][LE]> char-desc
handle: 0x0001, uuid: 00002800-0000-1000-8000-00805f9b34fb
handle: 0x0001, uuid: 00002800-0000-1000-8000-00805f9b34fb
# 6e400003 (handle 0x000d) = RX characteristic
# 6e400003 (handle 0x000d) = RX characteristic
# Optional (but maybe helpful) ... scan for CCCD entries
# Optionel (mais peut être utile) ... scan des entrées CCCD
[D6:4E:06:4F:72:86][LE]> char-read-uuid 2902
[D6:4E:06:4F:72:86][LE]> char-read-uuid 2902
handle: 0x000e value: 00 00
handle: 0x000e value: 00 00
# Enable notifications on the RX characteristic (CCCD handle = 0x000e)
# Activer les notifications pour la caractéristique RX (CCCD handle = 0x000e)
# 0100 = get notifications
# 0100 = get notifications / obtenir des notifications
# 0200 = get indications
# 0200 = get indications / obtenir des indications
# 0300 = get notifications + indications
# 0300 = get notifications + indications / Obtenir des notification et indications
# 0000 = disable notifications + indications
# 0000 = désactiver les notifications + indications
[D6:4E:06:4F:72:86][LE]> char-write-req 0x000e 0100
[D6:4E:06:4F:72:86][LE]> char-write-req 0x000e 0100
Characteristic value was written successfully
Characteristic value was written successfully
# Just to make sure it was updated
# S'assurer que la caractéristique à été mise-à-jour
[D6:4E:06:4F:72:86][LE]> char-read-hnd 0x000e
[D6:4E:06:4F:72:86][LE]> char-read-hnd 0x000e
Characteristic value/descriptor: 01 00
Characteristic value/descriptor: 01 00
# Writing "test" in the Serial Monitor of the Arduino sketch should
# Ecrire "test" dans le moniteur série du croquis Arduino. Cela
# cause this output not that notifications are enabled:
# devrait cette sortie.
Notification handle = 0x000d value: 74 65 73 74
Notification handle = 0x000d value: 74 65 73 74
# Write something to the TX characteristic (handle = 0x000b)
# Ecrire quelque chose sur la caractéristique TX (handle = 0x000b)
# This should cause E F G H to appear in the Serial Monitor
# Cela devrait faire apparaître les caractères E F G H dans le
# moniteur série d'Arduino
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000b 45
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000b 45
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000b 46
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000b 46
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000b 48
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000b 48
# To send multiple bytes
# Envoyer plusieurs octets
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000B 707172737475
[D6:4E:06:4F:72:86][LE]> char-write-cmd 0x000B 707172737475
# If you are running the callbackEcho sketch and notifications
# Si vous exécutez le croquis callbackEcho et que les notifications
# are enabled you should get this response after the above cmd:
# sont activée alors vous devriez voir cette réponse après avoir
# exécuté la commande ci-dessus:
Notification handle = 0x000d value: 70 71 72 73 74 75
Notification handle = 0x000d value: 70 71 72 73 74 75
--------------
--------------
# If you just want to enable constant listening, enter the following command from the CLI:
# Si vous désirez seulement une écoute permanente, saisissez la
# commande suivante dans le CLI:
$ sudo gatttool -b D6:4E:06:4F:72:86 -t random --char-write-req -a 0x000e -n 0100 --listen
$ sudo gatttool -b D6:4E:06:4F:72:86 -t random --char-write-req -a 0x000e -n 0100 --listen
# This should give us the following output as data is written on the Uno,
# Cela devrait produire les sorties suivantes lorsque des données sont
# though we can't send anything back:
# saisie dans Arduino IDE. Nous ne pouvons cependant pas renvoyer
# de données:
Characteristic value was written successfully
Characteristic value was written successfully
Notification handle = 0x000d value: 74 65 73 74
Notification handle = 0x000d value: 74 65 73 74
Notification handle = 0x000d value: 6d 6f 72 65 20 74 65 73 74 </bash>
Notification handle = 0x000d value: 6d 6f 72 65 20 74 65 73 74 </syntaxhighlight>
== Puis-je utiliser la broche IRQ pour sortir mon MCU du mode veille lorsque l'UART BLE à des données disponibles ? ==
Non, sur les cartes à base de SPI, la broche IRQ est utilisé pour indiquer qu'une réponse SDEP est disponible pour une commande SDEP.
Par exemple, lorsque vous envoyez une commande "AT+BLEUARTRX" comm message SDEP, le firmware Bluefruit fonctionnant sur le nRF51822 fera une analyse du message, préparera une réponse SDEP et déclenchera la broche d'interruption (pour indiquer au MCU que la réponse est prête).
Le broche IRQ est complètement indépendante du service BLE UART qui ne dispose pas de capacité d'intérruption (pour le moment).
{{Bluefruit-LE-Shield-TRAILER}}
{{Bluefruit-LE-Shield-TRAILER}}