30 894
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − {{traduction}}+ + − == Introduction ==+ − To help you get your Bluefruit LE module talking to other Central devices, we've put together a number of open source tools for most of the major platforms supporting Bluetooth Low Energy. − + − + + + − The full [https://github.com/adafruit/Bluefruit_LE_Connect_Android source code] for Bluefruit LE Connect for Android is also available on Github to help you get started with your own Android apps. You'll need a recent version of [https://developer.android.com/sdk/index.html Android Studio] to use this project.+ − + − The full swift source code for Bluefruit LE Connect for iOS is also available on Github. You'll need XCode and access to Apple's developper program to use this project:+ − + − + − + − + − This OS X desktop application is based on the same V2.x codebase as the iOS app, and gives you access to BLE UART, basic Pin I/O and OTA DFU firmware updates from the convenience of your laptop or mac.+ − This is a great choice for logging sensor data locally and exporting it as a CSV, JSON or XML file for parsing in another application, and uses the native hardware on your computer so no BLE dongle is required on any recent mac.+ − The full source is also [https://github.com/adafruit/Bluefruit_LE_Connect_v2 available on Github].+ − + − This experimental command line tool is unsupported and provided purely as a proof of concept, but can be used to allow firmware updates for Bluefruit devices from the command line.+ − This utility performs automatic firmware updates similar to the way that the GUI application does, by checking the firmware version on your Bluefruit device (via the Device Information Service), and comparing this against the firmware versions available online, downloading files in the background if appropriate.+ − Simply install the pre-compiled tool via the [https://github.com/adafruit/Bluefruit_LE_Connect_v2/releases/tag/OSXcommandline_0.3 DMG file] and place it somewhere in the system path, or run the file locally via './bluefruit' to see the help menu:+ Ligne 65 :
Ligne 67 : − + − It runs on OS X, Windows 7+ and select flavours of Linux (Ubuntu tested locally). Windows 7 support is particularly interesting since Windows 7 has no native support for Bluetooth Low Energy but the noble library talks directly to {{pl|566|supported Bluetooth 4.0 USB dongles}} to emulate BLE on the system (though at this stage it's still in early BETA and drops the connection and takes more care to work with).+ − This app allows you to collect sensor data or perform many of the same functionality offered by the mobile Bluefruit LE Connect apps, but on the desktop.+ − The app is still in BETA, but full [https://github.com/adafruit/adafruit-bluefruit-le-desktop source] is available in addition to the easy to use [https://github.com/adafruit/adafruit-bluefruit-le-desktop/releases pre-compiled binaries].+ − === Bluefruit LE Python Wrapper ===+ − As a proof of concept, we've played around a bit with getting Python working with the native Bluetooth APIs on OS X and the latest version of Bluez on certain Linux targets. − There are currently example sketches showing how to retreive BLE UART data as well as some basic details from the Device Information Service (DIS).+ − This isn't an actively support project and was more of an experiment, but if you have a recent Macbook or a Raspberry Pi and know Python, you might want to look at [https://github.com/adafruit/Adafruit_Python_BluefruitLE Adafruit_Python_BluefruitLE] in our github account.+ − + − If your sense of adventure gets the better of you, and your Bluefruit LE module goes off into the weeds, the following tools might be useful to get it back from unknown lands.+ − + + + + + − This command line tool is a python-based wrapper for programming ARM MCUs using either a [https://www.adafruit.com/search?q=J-Link Segger J-Link] or an [https://www.adafruit.com/product/2548 STLink/V2]. You can use it to reflash your Bluefruit LE module using the latest firmware from the [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware Bluefruit LE firmware repo].+ − Details on how to use the tool are available in the readme.md file on the main [https://github.com/adafruit/Adafruit_Adalink Adafruit_Adalink] repo on Github.+ − − Completely reprogramming a Bluefruit LE module with AdaLink would require four files, and would look something like this (using a JLink): Ligne 103 :
Ligne 106 : − You can also use the AdaLink tool to get some basic information about your module, such as which SoftDevice is currently programmed or the IC revision (16KB SRAM or 32KB SRAM) via the --info command:+ Ligne 115 :
Ligne 118 : − + + + − It relies on AdaLink or OpenOCD beneath the surface (see above), but you can use this command line tool to flash your nRF51822 with a specific SoftDevice, Bootloader and Bluefruit firmware combination.+ − It currently supports using either a Segger J-Link or STLink/V2 via AdaLink, or [https://github.com/adafruit/Adafruit_nRF51822_Flasher#rpi-gpio-requirements GPIO on a Raspberry Pi] if you don't have access to a traditional ARM SWD debugger. (A pre-built version of OpenOCD for the RPi is included in the repo since building it from scratch takes a long time on the original RPi.)+ − We don't provide active support for this tool since it's purely an internal project, but made it public just in case it might help an adventurous customer debrick a board on their own.+
Bluefruit-LE-Shield-Software-resources (voir la source)
Version du 3 août 2017 à 20:57
, 3 août 2017 à 20:57→Debug Tools
{{Bluefruit-LE-Shield-NAV}}
{{Bluefruit-LE-Shield-NAV}}
== Introduction ==
Cette page contient un certain nombre d'outils open source pour la plupart des plateformes supportant Bluetooth Low Energy.
Ces outils permettront de faciliter la communication entre le module Bluefruit LE et autres périphériques Centrales (SmartPhone, Ordinateur, etc).
== Bluefruit LE Client Apps and Libraries ==
== Bluefruit LE Client Apps and Libraries ==
Adafruit has put together the following mobile or desktop apps and libraries to make it as easy as possible to get your Bluefruit LE module talking to your mobile device or laptop, with full source available where possible:
Adafruit à préparé une série d'application desktop et mobile ainsi que des bibliothèques pour faciliter, au maximum, les communication entre votre module Bluefruit LE et votre SmartPhone et Laptop. Les codes sources ont étés publiés où lorsque cela à été possible:
=== Bluefruit LE Connect (Android/Java) ===
=== Bluefruit LE Connect (Android/Java) ===
Bluetooth Low Energy support was added to Android starting with Android 4.3 (though it was only really stable starting with 4.4), and we've already released [https://play.google.com/store/apps/details?id=com.adafruit.bluefruit.le.connect Bluefruit LE Connect to the Play Store].
Le support Bluetooth Low Energy a été ajouté depuis Android 4.3 (mais vraiment stable depuis Android 4.4).
Adafruit met donc à disposition [https://play.google.com/store/apps/details?id=com.adafruit.bluefruit.le.connect Bluefruit LE Connect sur Play Store].
Les [https://github.com/adafruit/Bluefruit_LE_Connect_Android codes source complet] de Bluefruit LE Connect pour Android est également disponible sur Github. Cela devrait vous aider à démarrer vos propres apps Android. Vous aurez besoin d'une version récente de [https://developer.android.com/sdk/index.html Android Studio] pour pouvoir ouvrir ce projet.
{{ADFImage|Bluefruit-LE-Shield-Software-resources-00.png|640px}}
{{ADFImage|Bluefruit-LE-Shield-Software-resources-00.png|640px}}
=== Bluefruit LE Connect (iOS/Swift) ===
=== Bluefruit LE Connect (iOS/Swift) ===
Apple was very early to adopt Bluetooth Low Energy, and we also have an iOS version of the [https://itunes.apple.com/app/adafruit-bluefruit-le-connect/id830125974?mt=8 Bluefruit LE Connect app]] available in Apple's app store.
Apple a adopté Bluetooth Low Energy très rapidement et Adafruit propose également une version iOS de [https://itunes.apple.com/app/adafruit-bluefruit-le-connect/id830125974?mt=8 Bluefruit LE Connect app]] (disponible sur l'Apple store).
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:
* Version 1.x source code: [https://github.com/adafruit/Bluefruit_LE_Connect https://github.com/adafruit/Bluefruit_LE_Connect]
* Code source de la Version 1.x: [https://github.com/adafruit/Bluefruit_LE_Connect https://github.com/adafruit/Bluefruit_LE_Connect]
* Version 2.x source code: [https://github.com/adafruit/Bluefruit_LE_Connect_v2 https://github.com/adafruit/Bluefruit_LE_Connect_v2]
* Code source de la Version 2.x: [https://github.com/adafruit/Bluefruit_LE_Connect_v2 https://github.com/adafruit/Bluefruit_LE_Connect_v2]
{{ambox|text=Version 2.x of the app is a complete rewrite that includes iOS, OS X GUI and OS X command-line tools in a single codebase. }}
{{ambox|text=Version 2.x de l'application à été complètement ré-écrite pour supporter iOS, interface graphique OS X GUI et ligne de commande OS X à partir d'un seul code. }}
{{ADFImage|Bluefruit-LE-Shield-Software-resources-10.png}}
{{ADFImage|Bluefruit-LE-Shield-Software-resources-10.png|640px}}
=== Bluefruit LE Connect for OS X (Swift) ===
=== Bluefruit LE Connect for OS X (Swift) ===
Les application bureau OS X sont basées sur le même code que la version 2.x de l'App pour iOS et offre un accès à BLE UART, manipulation des I/O et mise-à-jour OTA du firmware.
C'est un choix judicieux pour faire du logging des données de senseurs afin de les exporter en fichier CSV, JSON ou XML. Vous pourrez ainsi exploiter ces informations dans une autre application. Cette approche vous permet d'utiliser la matériel BLE disponible sur votre ordinateur, il n'est donc pas nécessaire d'ajouter un clé BLE si vous disposez d'un Mac récent.
Le code source complet est également [https://github.com/adafruit/Bluefruit_LE_Connect_v2 disponible sur Github].
{{ADFImage|Bluefruit-LE-Shield-Software-resources-20.jpg|640px}}
{{ADFImage|Bluefruit-LE-Shield-Software-resources-20.jpg|640px}}
=== Bluefruit LE Command Line Updater for OS X (Swift) ===
=== 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.
Cet utilitaire effectue une mise-à-jour automatique du Firmware (comme celle réalisée par la version graphique du logiciel). Elle vérifie la version du firmware installé sur le périphérique Bluefruit (bia le service "Device Information") et le compare avec les versions du firmware disponibles en ligne. Si nécessaure, les fichiers son téléchargés en tâche de fond.
Installez simplement l'outil précompilé via le [https://github.com/adafruit/Bluefruit_LE_Connect_v2/releases/tag/OSXcommandline_0.3 fichier DMG] et placez le quelque par dans les répertoires systèmes -ou- exécutez le locallement via './bluefruit' (pour voir le message d'aide en anglais):
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
=== ABLE (Cross Platform/Node+Electron) ===
=== ABLE (Cross Platform/Node+Electron) ===
[https://github.com/adafruit/adafruit-bluefruit-le-desktop/releases ABLE] (Adafruit Bluefruit LE Desktop) is a cross-platform desktop application based on Sandeep Misty's [https://github.com/sandeepmistry/noble noble library] and the [https://github.com/atom/electron Electron] project from Github (used by Atom).
[https://github.com/adafruit/adafruit-bluefruit-le-desktop/releases ABLE] (Adafruit Bluefruit LE Desktop) est une application de bureau cross-platform basé sur la [https://github.com/sandeepmistry/noble bibliothèque noble] de Sandeep Misty et le projet [https://github.com/atom/electron Electron] (utilisé par Atom).
Il fonctionne sur OS X, Windows 7+ et une sélectionne de systèmes Linux (Ubuntu testé locallement). Le support Windows 7 est particulièrement intéressant étant qu'il n'a pas de support natif de Bluetooth Low Energy mais la bibliothèque noble permet de dialoguer directement avec {{pl|566|des clés Bluetooth 4.0 USB}} (supportée) pour émuler BLE sur le système (toujours en BETA, prenez plus de précautions lorsque vous travaillez avec lui).
Cette application permet de collecter des données de senseur et permet de réaliser de nombreuses fonctionnalités similaires à celles de l'apps Bluefruit LE Connect mais dans un environnement de bureau.
L'application est toujours en BETA mais le [https://github.com/adafruit/adafruit-bluefruit-le-desktop code source complet] est disponible sur GitHub ainsi que des [https://github.com/adafruit/adafruit-bluefruit-le-desktop/releases binaires pré-compilés] (pour faciliter leur utilisation).
{{ADFImage|Bluefruit-LE-Shield-Software-resources-40.png|640px}}
{{ADFImage|Bluefruit-LE-Shield-Software-resources-40.png|640px}}
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).
Il y a un croquis d'exemple qui montre comment recevoir des données BLE UART ainsi que des informations complémentaires en provenance du service Bluetooth DIS ("''Device Information Service''").
Il ne s'agit pas d'un projet supporté activement mais plutôt d'un projet d'expérimentation. Si vous avez un Macbook récent ou un Raspberry Pi et quelques connaissances Python vous pourriez trouver les sources [https://github.com/adafruit/Adafruit_Python_BluefruitLE Adafruit_Python_BluefruitLE] (github d'Adafruit intéressante).
== Debug Tools ==
== Outil de débogage ==
Si vous êtes un grand aventurier et que, dans durant vos tribulations, votre module Bluefruit LE à totalement perdu le nord alors les outils suivants pourraient se montrer utiles pour revenir en terrain connue.
{{ambox-stop|text=hese debug tools are provided purely as a convenience for advanced users for device recovery purposes, and are not recommended unless you're OK with potentially bricking your board. Use them at your own risk.}}
{{ambox-stop|text=Ces outils de débogages sont uniquement fournit pour les utilisateurs avancés désirant restaurer l'état de leur périphérique. Il n'est pas recommander de les utiliser sauf si vous savez ce que vous faites car une utilisation incorrecte peut bloquer votre board.
L'utilisez de ces outils se fait à vos propres risques.}}
=== AdaLink (Python) ===
=== AdaLink (Python) ===
Outil en ligne de commande basé sur le wrapper Python. Il permet de programmer le MCU ARM en utilisant soit un [https://www.adafruit.com/search?q=J-Link Segger J-Link] ou un [https://www.adafruit.com/product/2548 STLink/V2]. Vous pouvez l'utiliser pour reflasher votre module Bluefruit LE en utilisant de dernier firmware disponible sur [https://github.com/adafruit/Adafruit_BluefruitLE_Firmware le dépôt des firmware Bluefruit LE].
Les détails concernant l'utilisation de cet outil sont disponible dans le fichier readme.md du dépôt Github [https://github.com/adafruit/Adafruit_Adalink Adafruit_Adalink].
Le reflashage complet du module Bluefruit LE avec AdaLink nécessitera 4 fichiers et ressemblera à quelque-chose comme ceci (en utilisant un JLink):
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
</syntaxhighlight>
</syntaxhighlight>
Vous pouvez également utiliser l'outil AdaLink pour obtenir des informations de diagnostic a propos de votre module. A l'aide de l'option {{fname|--info}}, vous pourrez, par exemple, obtenir des information sur le ''SoftDevice'' programmé dans le module ou la révision du circuit intégré (16KB SRAM ou 32KB SRAM).
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
=== Adafruit nRF51822 Flasher (Python) ===
=== Adafruit nRF51822 Flasher (Python) ===
Adafruit's nRF51822 Flasher is an internal Python tool we use in production to flash boards as they go through the test procedures and off the assembly line, or just testing against different firmware releases when debugging.
Adafruit nRF51822 Flasher est un outil python utilisé en interne par Adafruit. Il est utilisé en production pour flasher les cartes avec le Firmware Adafruit au moment où elles passent la procédure de test (avant de quitter la ligne d'assemblage).
Cet outil est également utilisé pour tester les différentes releases du firmware durant les phases de débogages.
Il s'appuie sur AdaLink ou OpenOCD (voir ci-dessous) mais vous pouvez utiliser cet outil en ligne de commande pour flashet votre nRF51822 avec un ''SoftDevice'' spécifique, combinaison alternatives de Bootloader et firmware Bluefruit.
Actuellement, il supporte soit un J-Link de Segger ou STLink/V2 par l'intermédiaire d'AdaLink, ou [https://github.com/adafruit/Adafruit_nRF51822_Flasher#rpi-gpio-requirements GPIO d'un Raspberry Pi] si vous n'avez pas accès à un débugger ARM SWD traditionnel. (une version d'OpenOCD précompilé pour 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.
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">