Modifications

== Debug Tools ==

== Debug Tools ==

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.

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) ===

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].

 

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):

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>

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:

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.

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.

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 de Bootloader et firmware Bluefruit.

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.)

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.)