FEATHER-M0-ArduinoIDE-SPI-Flash - Historique des versions

Admin : /* Formatter la mémoire Flash */

2018-09-23T15:11:22Z

Formatter la mémoire Flash

Admin : /* Formatter la mémoire Flash */

2018-01-08T15:49:01Z

Formatter la mémoire Flash

Admin le 29 octobre 2017 à 16:25

2017-10-29T16:25:09Z

Admin : /* Accéder à la Flash SPI */

2017-10-29T16:24:46Z

Accéder à la Flash SPI

Admin : /* Accessing SPI Flash */

2017-10-29T14:31:09Z

Accessing SPI Flash

Admin : /* Full Usage Example */

2017-10-29T14:30:28Z

Full Usage Example

Admin : /* Lecture et affichage de fichiers */

2017-10-29T14:18:20Z

Lecture et affichage de fichiers

Admin : /* Lecture et affichage de fichiers */

2017-10-29T13:51:31Z

Lecture et affichage de fichiers

Admin : /* Reading and Printing Files */

2017-10-29T13:27:41Z

Reading and Printing Files

Admin : /* Exemple de Datalogging */

2017-10-29T13:27:09Z

Exemple de Datalogging

@@ Ligne 105 : / Ligne 105 : @@
 Pour executer le croquis de formattage, chargez le dans Arduino IDE et téléversez le sur la carte Feather M0. Ouvrez ensuite le moniteur série (à 115200 baud). Vous devriez voir un message demandant une confirmation avant de formatter la mémoire Flash.
-Si vous ne voyez pas ce message alors fermez le moniteur série, appuyez sur le bouton rest et réouvrez le moniteur série.
+Si vous ne voyez pas ce message alors fermez le moniteur série, appuyez sur le bouton reset et réouvrez le moniteur série.
 {{ADFImage|FEATHER-M0-ArduinoIDE-SPI-Flash-01.png}}

← Version précédente		Version du 8 janvier 2018 à 15:49
Ligne 112 :		Ligne 112 :

	Une fois confirmé, le croquis formattera la mémoire Flash SPI. La processus d'effacement et formatage prend environ une minute. Le croquis affiche un message une fois le formatage terminé. Voilà, vous disposez d'une mémoire FLASH prête à l'emploi et avec un tout nouveau système de fichier.		Une fois confirmé, le croquis formattera la mémoire Flash SPI. La processus d'effacement et formatage prend environ une minute. Le croquis affiche un message une fois le formatage terminé. Voilà, vous disposez d'une mémoire FLASH prête à l'emploi et avec un tout nouveau système de fichier.
		+
		+	=== Erreur de formattage ===
		+	Si vous n'arrivez pas à formater la mémoire Flash et recevez ce message d'erreur:
		+	<nowiki>Adafruit SPI Flash FatFs Format Example
		+	Flash chip JEDEC ID: 0x1401501
		+	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
		+	This sketch will ERASE ALL DATA on the flash chip and format it with a new filesystem!
		+	Type OK (all caps) and press enter to continue.
		+	!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
		+	Partitioning flash with 1 primary partition...
		+	Couldn't read sector before performing write!
		+	Error, f_fdisk failed with error code: 1</nowiki>
		+
		+	Alors il faut revenir à une version plus ancienne de la bibliothèque en attendant le correction de la bibliothèque.
		+
		+	Voir [https://forums.adafruit.com/viewtopic.php?f=57&t=128979&p=641983#p641983 ce lien sur les forums d'Adafruit].

	== Exemple de Datalogging ==		== Exemple de Datalogging ==

@@ Ligne 1 : / Ligne 1 : @@
 {{FEATHER-M0-EXPRESS-NAV}}
 == Introduction ==
 Une des fonctionnalités les plus captivante du M0 express est la petite puce mémoire flash additionnel (en SPI) placée sur la carte. Cette mémoire peut être utilisé pour fournir de nombreux services tels que le stockage de fichiers de données, du code Python et plus.

@@ Ligne 190 : / Ligne 190 : @@
 == Accéder à la Flash SPI ==
-Arduino doesn't have the ability to show up as a 'mass storage' disk drive. So instead we must use CircuitPython to do that part for us. Here's the full technique:
+Arduino n'est malheureusement pas capable d'exposer un périphérique de stockage (dit "''mass storage''" en anglais). Par conséquent, il faut utiliser CircuitPython qui, lui, est capable de faire cela pour nous. Voici la technique à utiliser.Here's the full technique:
+* Démarrer le bootloader de votre carte Express. Faites un glisser/déposer de la dernière version du fichier uf2 '''circuitpython'''.
+* Après un moment, vous devriez voir apparaître le lecteur '''CIRCUITPY''' contenant un fichier '''boot_out.txt'''. Voilà, le système de fichier est initialisé sur la Flash SPI.
-* Start the bootloader on the Express board. Drag over the latest '''circuitpython''' uf2 file
+* Ouvrez maintenant Arduino IDE et téléversez l'exemple '''fatfs_circuitpython''' disponible dans la bibliothèque SPI d'Adafruit. Ouvrez la console série pour démarrer le croquis. Voilà, le système de fichier CircuitPython sera correctement monté et le fichier '''data.txt''' créé et initialisé.
 {{ADFImage|FEATHER-M0-ArduinoIDE-SPI-Flash-02.png}}
+* Revenons sur notre ordinateur, redémarrez le bootloader de la carte Express --ET-- re-glissez/re-déposez '''circuitpython.uf2''' sur le lecteur '''BOOT''' rendu accessible par le bootloader. Voilà, CircuitPython est résintallé sur la carte Express.
-* Back on your computer, re-start the Express board bootloader, and re-drag '''circuitpython.uf2''' onto the '''BOOT''' drive to reinstall circuitpython
+* Au bout d'un moment, le lecteur '''CIRCUITPY''' redevient accessible. Celui-ci expose a nouveau le système de fichier MicroPython de la Flash SPI. Vous pouvez maintenant voir le fichier '''data.txt''', l'ouvrir et en consulté le contenu!
 {{ADFImage|FEATHER-M0-ArduinoIDE-SPI-Flash-03.png}}
-Once you have your Arduino sketch working well, for datalogging, you can simplify this procedure by dragging '''CURRENT.UF2''' off of the '''BOOT''' drive to make a backup of the current program before loading circuitpython on. Then once you've accessed the file you want, re-drag '''CURRENT.UF2''' back onto the '''BOOT''' drive to re-install the Arduino sketch!
+Une fois que votre croquis de datalogging Arduino fonctionne comme attendu, vous pouvez simplifier la procédure en copiant '''CURRENT.UF2''' depuis le lecteur '''BOOT''' pour faire une copie de sauvegarde de votre programme Arduino. Vous pourrez ensuite charger CircuitPython pour accéder au système de fichier de la Flash SPI et enfin recopier votre '''CURRENT.UF2''' sur le lecteur '''BOOT''' de la carte Express pour réactiver votre croquis Arduino!
 {{FEATHER-M0-EXPRESS-TRAILER}}

@@ Ligne 189 : / Ligne 189 : @@
 Rappelez vous que la bibliothèque SPI flash est conçue pour exposer les mêmes fonctions et mêmes interfaces que la [https://www.arduino.cc/en/reference/SD la bibliothèque SD d'Arduino]. Par conséquent, les code et exemples stockant des données sur une carte SD seront très facile à adapter pour fonctionner avec la bibliothèque SPI flash. Créez simplement un objet fatfs comme dans les exemples ci-dessus et utilisez la fonction open sur cet objet (en lieu et place de la fonction globale). Une fois que vous avez obtenu une référence sur un fichier, toutes les fonctions et utilisations sont identiques entre la bibliothèque SPI flash et la bibliothèque SD d'Arduino!
-== Accessing SPI Flash ==
+== Accéder à la Flash SPI ==
 Arduino doesn't have the ability to show up as a 'mass storage' disk drive. So instead we must use CircuitPython to do that part for us. Here's the full technique:

@@ Ligne 184 : / Ligne 184 : @@
 Il existe également des fonctions de lecture avancées que vous pouvez voir dans l'exemple '''fatfs_full_usage''' ou soit dans la [https://www.arduino.cc/en/reference/SD documentation de la classe SD d'Arduino] (la bibliothèque Flash SPI implémente les mêmes fonctions).
-== Full Usage Example ==
+== Exemple complet d'utilisation de la Flash ==
-For a more complete demonstration of reading and writing files look at the '''fatfs_full_usage''' example.  This examples uses every function in the library and demonstrates things like checking for the existence of a file, creating directories, deleting files, deleting directories, and more.
+Vous pouvez vous référer à l'exemple '''fatfs_full_usage''' pour une démonstration complète concernant la lecture et l'écriture de fichiers. Cet exemple utilise toutes les fonction de la bibliothèque et démontre des opérations tels que le test d'existence d'un fichier, la création de répertoire, effacement de fichier, effacement de fichier, etc.
-Remember the SPI flash library is built to have the same functions and interface as the <a href="https://www.arduino.cc/en/reference/SD">Arduino SD library</a> so if you have code or examples that store data on a SD card they should be easy to adapt to use the SPI flash library, just create a fatfs object like in the examples above and use its open function instead of the global SD object's open function.  Once you have a reference to a file all of the functions and usage should be the same between the SPI flash and SD libraries!
+Rappelez vous que la bibliothèque SPI flash est conçue pour exposer les mêmes fonctions et mêmes interfaces que la [https://www.arduino.cc/en/reference/SD la bibliothèque SD d'Arduino]. Par conséquent, les code et exemples stockant des données sur une carte SD seront très facile à adapter pour fonctionner avec la bibliothèque SPI flash. Créez simplement un objet fatfs comme dans les exemples ci-dessus et utilisez la fonction open sur cet objet (en lieu et place de la fonction globale). Une fois que vous avez obtenu une référence sur un fichier, toutes les fonctions et utilisations sont identiques entre la bibliothèque SPI flash et la bibliothèque SD d'Arduino!
 == Accessing SPI Flash ==

@@ Ligne 178 : / Ligne 178 : @@
 </syntaxhighlight>
-Just like when writing data with the datalogging example you create a '''File''' object by calling the '''open''' function on a fatfs object.  This time however you pass a file mode of '''FILE_READ''' which tells the filesystem you want to read data.
+Tout comme pour l'écriture de donnée dans l'exemple datalogging, il est nécessaire de créer un objet '''File''' en appelant la fonction '''open''' de l'objet fatfs. Cependant, cette fois, le mode utilisé est '''FILE_READ''', indiquant que l'on désire lire le système de fichier.
-After you open a file for reading you can easily check if data is available by calling the '''available''' function on the file, and then read a single character with the '''read''' function.  This makes it easy to loop through all of the data in a file by checking if it's available and reading a character at a time.  However there are more advanced read functions you can use too--see the '''fatfs_full_usage''' example or even the <a href="https://www.arduino.cc/en/reference/SD">Arduino SD library documentation</a> (the SPI flash library implements the same functions).
+Après avoir ouvert le fichier en lecture, la fonction '''available''' permet de facilement savoir si des données sont disponibles dans le fichier. Ensuite, la fonction '''read''' permet de lire un caractère depuis le fichier. La combinaison de ces deux fonctions permet de réaliser facilement une boucle de lecture qui vérifie la disponibilité de donnée puis la lecture et l'affichage de celle-ci (un caractère à la fois).
 == Full Usage Example ==

@@ Ligne 152 : / Ligne 152 : @@
 == Lecture et affichage de fichiers ==
-The '''fatfs_print_file''' example will open a file (by default the data.csv file created by running the '''fatfs_datalogging''' example above) and print all of its contents to the serial monitor.  Open the '''fatfs_print_file''' example and load it on your Feather M0 board, then open the serial monitor at 115200 baud.  You should see the sketch print out the contents of data.csv (if you don't have a file called data.csv on the flash look at running the datalogging example above first).
+L'exemple '''fatfs_print_file''' ouvrira un fichier (le fichier data.csv par défaut, le fichier créé par l'exemple '''fatfs_datalogging''' présenté ci-dessus) et affiche tout son contenu dans le moniteur série.  Ouvrez l'exemple '''fatfs_print_file''' et téléversez le sur votre carte Feather M0, puis ouvrez le moniteur série (à 115200 baud).
-To understand how to read data from a file look in the '''setup''' function of the sketch:
+Vous devriez voir le croquis afficher le contenu du fichier data.csv (si la mémoire flash ne contient pas de fichier data.csv alors vous pouvez ouvrir l'exemple datalogging ci-dessus pour le créer).
-<syntaxhighlight lang="python">
+Voyez le contenu de la fonction {{fname|setup()}} pour comprendre comment s'effectue la lecture du fichier:
-   // Open the file for reading and check that it was successfully opened.
-   // The FILE_READ mode will open the file for reading.
+<syntaxhighlight lang="c">
    File dataFile = fatfs.open(FILE_NAME, FILE_READ);
    if (dataFile) {
-     // File was opened, now print out data character by character until at the
+     // Le fichier a été ouvert.
-     // end of the file.
+    // Afficher le contenu caractère par caractère jusqu'à
-     Serial.println("Opened file, printing contents below:");
+     // la fin du fichier.
      while (dataFile.available()) {
-       // Use the read function to read the next character.
+       // Utilisé la fonction read() pour lire le prochain caractère.
-       // You can alternatively use other functions like readUntil, readString, etc.
+       // Il est également possible d'utiliser des fonctions telles
-       // See the fatfs_full_usage example for more details.
+      //     que readUntil, readString, etc.
        char c = dataFile.read();
        Serial.print(c);

@@ Ligne 151 : / Ligne 151 : @@
 Assurez-vous d'avoir correctement fermé le système de fichier pour être certain que les données soient enregistrées correctement dans le fichier!
-== Reading and Printing Files ==
+== Lecture et affichage de fichiers ==
 The '''fatfs_print_file''' example will open a file (by default the data.csv file created by running the '''fatfs_datalogging''' example above) and print all of its contents to the serial monitor.  Open the '''fatfs_print_file''' example and load it on your Feather M0 board, then open the serial monitor at 115200 baud.  You should see the sketch print out the contents of data.csv (if you don't have a file called data.csv on the flash look at running the datalogging example above first).

@@ Ligne 119 : / Ligne 119 : @@
 Voyez le contenu de la fonction {{fname|loop()}} pour comprendre comment écrire dans le fichier:
-<syntaxhighlight lang="python">
+<syntaxhighlight lang="c">
    // Ouvrir le fichier de datalogging en écriture.  Le mode FILE_WRITE ouvrira
    // le fichier en mode ajout (ajoutera les données en fin de fichier).
@@ Ligne 147 : / Ligne 147 : @@
 Comme vous le feriez avec la bibliothèque Arduino de la carte SD, vous pouvez créer un objet '''File''' en appelant la fonction '''open''' en indiquant le nom de fichier et le mode d'accès (le mode '''FILE_WRITE''', écrit de nouvelles données en fin de fichier). <font color="red">'''Notez cependant'''</font> qu'à la place d'appeler la fonction global {{fname|open}}, c'est la méthode {{fname|fatfs.open()}} de l'objet système_de_fichier nouvellement créé qu'il faut appeler (voyez les valeurs de configurations juste après #define).
-Once the file is opened it's simply a matter of calling '''print''' and '''println''' functions on the file object to write data inside of it.  This is just like writing data to the serial monitor and you can print out text, numeric, and other types of data.  Be sure to close the file when you're done writing to ensure the data is stored correctly!
+Une fois le fichier ouvert, il suffit simplement d'appeler les fonctions '''print''' et '''println''' sur l'objet fichier pour écrire des données en fin de fichier. C'est exactement comme envoyer des données vers le moniteur série pour y afficher du texte, des valeurs numériques et autres types de donnée.
 == Reading and Printing Files ==