ADF-MICROSD-BREAKOUT-Fonctions - Historique des versions

Admin le 12 janvier 2014 à 20:51

2014-01-12T20:51:21Z

Admin : /* Autres fonctions utiles */

2013-03-03T21:09:26Z

Autres fonctions utiles

Admin : /* Enumérer / lire récursivement les fichiers */

2013-03-03T21:02:55Z

Enumérer / lire récursivement les fichiers

Admin : /* Enumérer / lire récursivement les fichiers */

2013-03-03T21:02:37Z

Enumérer / lire récursivement les fichiers

Admin : /* Lecture de fichiers */

2013-03-03T20:55:26Z

Lecture de fichiers

Admin : /* Lecture de fichiers */

2013-02-26T21:17:00Z

Lecture de fichiers

Admin : /* Lecture de fichiers */

2013-02-26T21:16:10Z

Lecture de fichiers

Admin : /* Enumérer / lire récursivement les fichiers */

2013-02-25T22:37:01Z

Enumérer / lire récursivement les fichiers

Admin : /* Lecture de fichiers */

2013-02-25T22:36:37Z

Lecture de fichiers

Admin le 25 février 2013 à 22:24

2013-02-25T22:24:10Z

@@ Ligne 51 : / Ligne 51 : @@
 Lorsque vous l'exécuterez, vous devriez voir ceci:
-[[Fichier:ADF-MICROSD-BREAKOUT-Func00.jpg]]
+{{ADFImage|ADF-MICROSD-BREAKOUT-Func00.jpg}}
 Vous pouvez ensuite ouvrir le fichier à l'aide de votre système d'exploitation en insérant la carte dans le slot ad hoc de votre PC. Vous verrez une ligne pour chaque fois que le sketch aura été exécuté. C'est-à-dire que le sketch '''ajoute''' dans le fichier, et qu'il n'écrase pas le contenu.
-[[Fichier:ADF-MICROSD-BREAKOUT-Func01.jpg]]
+{{ADFImage|ADF-MICROSD-BREAKOUT-Func01.jpg}}
 Certains point sont à relever :
@@ Ligne 132 : / Ligne 132 : @@
 Ce sketch est utile pour découvrir les noms de fichiers tels qu'ils sont stockés sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)
-[[Fichier:ADF-MICROSD-BREAKOUT-Func02.jpg]]
+{{ADFImage|ADF-MICROSD-BREAKOUT-Func02.jpg}}
 == Autres fonctions utiles ==

@@ Ligne 135 : / Ligne 135 : @@
 == Autres fonctions utiles ==
-Quelques manipulations utiles sont possibles avec des fonctions '''SD''' nous allons en énumérer quelques-unes ici:
+Quelques manipulations utiles sont possibles avec des fonctions '''SD''', nous allons en énumérer quelques-unes ici:
-* Si vous voulez juste vérifier qu'un fichier existe, utilisez '''SD.exists("filename.txt")''' elle retournera vrai ou faux (1 ou 0)
+* Si vous voulez juste vérifier l'existence d'un fichier, utilisez '''SD.exists("filename.txt")''' elle retournera vrai ou faux (1 ou 0)
-* Vous pouvez supprimer un fichier en appelant '''SD.remove("unwanted.txt")''' - attention! Elle supprimera vraiment le fichier, et il n'y a pas de «poubelle» pour corriger une erreur.
+* Vous pouvez supprimer un fichier en appelant '''SD.remove("unwanted.txt")''' - attention! Elle supprimera vraiment le fichier, et il n'y a pas de "poubelle" pour corriger une erreur.
-* Vous pouvez créer un sous-répertoire en appelant '''SD.mkdir("/mynewdir")''' très pratique lorsque vous voulez rassembler des fichiers dans un emplacement commun. Rien ne se passe si il existe déjà, mais vous pouvez toujours appeler '''SD.exists()''' en premier comme ci-dessus.
+* Vous pouvez créer un sous-répertoire en appelant '''SD.mkdir("/mynewdir")''' très pratique lorsque vous voulez rassembler des fichiers dans un emplacement commun (un fichier par jour... et un répertoire par semaine). Rien ne se passe si il existe déjà, mais vous pouvez toujours appeler '''SD.exists()''' en premier tel que décrit ci-dessus.
-Quelques fonctions de '''fichier''' utiles pour les manipuler :
+Quelques fonctions utiles pour manipuler des fichiers :
-* Vous pouvez appeler '''seek()''' sur un fichier. Ceci déplacera le pointeur de lecture/écriture vers un nouvel emplacement. Par exemple '''seek(0)''' vous amène au début du fichier, ce qui peut être très pratique!
+* Vous pouvez appeler '''seek()''' sur un fichier. Ceci déplacera le pointeur de lecture/écriture vers le nouvel emplacement indiqué. Par exemple '''seek(0)''' vous amène au début du fichier, ce qui peut être très pratique!
-* De même, vous pouvez appeler la fonction '''position()''' elle vous renverra où vous en êtes dans le fichier (nombre d'octets parcourus).
+* De même, vous pouvez appeler la fonction '''position()''' elle renvoi l'emplacement actuel du pointeur de lecture/écriture dans le fichier (nombre d'octets parcourus).
-* Si vous voulez connaître la taille d'un fichier, appelez '''size()''' pour obtenir sa dimension en nombre d'octets dans le fichier.
+* Si vous voulez connaître la taille d'un fichier, appelez '''size()''' pour obtenir la taille du fichier en octets (bytes).
 * Les répertoires/dossiers sont des fichiers spéciaux, vous pouvez déterminer si un fichier est un répertoire en appelant '''isDirectory()'''
-* Lorsqu'un répertoire est reconnu, vous pouvez commencer à passer par tous les fichiers dans ce répertoire en appelant '''openNextFile()'''
+* Lorsqu'un répertoire est reconnu, vous pouvez commencer à énumerer tous les fichiers disponibles dans ce répertoire en appelant '''openNextFile()'''
-* S'il est nécessaire de connaître le nom d'un fichier, par exemple si vous avez appelé '''openNextFile()''' dans un répertoire. Dans ce cas, la fonction '''name()''' retourne un pointeur vers le tableau de caractères au format
+* S'il est nécessaire de connaître le nom d'un fichier (par exemple lorsque vous avez appelé '''openNextFile()''') dans un répertoire. Dans ce cas, la fonction '''name()''' retourne un pointeur vers le tableau de caractères contenant le nom de fichier au format 8.3. Vous pouvez envoyer directement le contenu du tableau directement sur la console avec '''Serial.print()'''.
 {{ADF-MICROSD-BREAKOUT-TRAILER}}

@@ Ligne 130 : / Ligne 130 : @@
 Vous pouvez constater que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont placés). Les chiffres à la suite des noms de fichier représentent la taille en octets des fichiers.
-Ce sketch est utile pour découvrir les noms de fichiers tels qu'il sont stockés sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)
+Ce sketch est utile pour découvrir les noms de fichiers tels qu'ils sont stockés sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)
 [[Fichier:ADF-MICROSD-BREAKOUT-Func02.jpg]]

@@ Ligne 124 : / Ligne 124 : @@
 == Enumérer / lire récursivement  les fichiers ==
-Le dernier exemple nous montre une utilisation plus avancée. Une demande courante est par exemple de vouloir énumérer tous les fichiers de la carte SD, ou de jouer un fichier musical ou autre. Dans la dernière version de la bibliothèque SD, vous pouvez parcourir un répertoire et appeler '''openNextFile()''' pour obtenir le fichier disponible suivant. Ils n’apparaîtront pas dans l'ordre alphabétique, mais dans l'ordre de leur création; ayez conscience de ce fait!
+Le dernier exemple nous montre une utilisation plus avancée. Un besoin courant est, par exemple, énumération tous les fichiers de la carte SD ou de jouer les fichiers musicaux les un après les autres. Dans la dernière version de la bibliothèque SD, vous pouvez parcourir un répertoire et appeler '''openNextFile()''' pour obtenir et ouvrir le fichier suivant disponible dans le répertoire. Ils n’apparaîtront pas dans l'ordre alphabétique, mais dans l'ordre de leur création; souvenez vous en car cela est important!
-Pour le voir, exécutez le sketch d'exemple '''SD→listfiles'''
+Pour voir l'exemple, chargez et exécutez le sketch d'exemple '''SD→listfiles'''
-Vous pouvez voir que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont). Les chiffres à la suite des noms de fichier sont la taille en octets des fichiers. Ce sketch est utile pour apprendre comment sont appelés les fichiers sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)
+Vous pouvez constater que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont placés). Les chiffres à la suite des noms de fichier représentent la taille en octets des fichiers.
 [[Fichier:ADF-MICROSD-BREAKOUT-Func02.jpg]]

@@ Ligne 69 : / Ligne 69 : @@
 == Lecture de fichiers ==
-Ensuite, nous allons vous montrer comment lire un fichier, c'est très similaire à l'écriture, pour cela, nous utiliserons '''SD.open()''' pour ouvrir le fichier mais cette fois on ne passe pas le paramètre '''FILE_WRITE''' cela nous gardera d'écrire accidentellement dans le fichier (ouverture en lecture seule). Vous pouvez alors appeler la fonction '''available()''' (elle vous indiquera s'il reste des données à lire) et un '''read()''' sur le fichier vous renverra l'octet suivant.
+Ensuite, nous allons vous montrer comment lire un fichier, c'est une opération très similaire à l'écriture. Pour la réaliser, nous utiliserons '''SD.open()''' pour ouvrir le fichier mais cette fois on ne passe pas le paramètre '''FILE_WRITE''' durant l'appel. Cela évitera d'écrire accidentellement dans le fichier (car il sera ouvert en lecture seule). Vous pouvez alors appeler la fonction '''available()''' (elle indique s'il reste des données à lire) et un '''read()''' sur le fichier (pour lire l'octet suivant).
   <nowiki>#include <SD.h>
@@ Ligne 79 : / Ligne 79 : @@
    Serial.begin(9600);
    Serial.print("Initializing SD card...");
-// Sur la platine Ethernet, CS est la broche 4. Elle est définie comme une sortie par défaut.
+  // Sur la platine Ethernet, CS est la broche 4. Elle est définie comme une sortie par défaut.
-// Notez que même si elle n'est pas utilisée comme broche CS, la broche SS
+  // Notez que même si elle n'est pas utilisée comme broche CS, la broche SS
-// (10 sur la plupart des cartes Arduino, 53 sur les Méga) doit être laissée comme une sortie
+  // (10 sur la plupart des cartes Arduino, 53 sur les Méga) doit être laissée comme une sortie
-// Ou les fonctions de la bibliothèque SD ne fonctionneront pas.
+  // sinon les fonctions de la bibliothèque SD ne fonctionneront pas.
-   pinMode(10, OUTPUT);
+  pinMode(10, OUTPUT);
    if (!SD.begin(10)) {
@@ Ligne 91 : / Ligne 91 : @@
    Serial.println("initialization done.");
-// ouvrir le fichier pour la lecture :
+  // ouvrir le fichier pour la lecture :
    myFile = SD.open("test.txt");
    if (myFile) {
      Serial.println("test.txt:");
-// lire le fichier jusqu'à la fin :
+    // lire le fichier jusqu'à la fin :
      while (myFile.available()) {
          Serial.write(myFile.read());
+     }
-// fermer le fichier :
+    // fermer le fichier :
      myFile.close();
    } else {
-        // si le fichier ne se ferme pas, afficher une erreur :
+    // si le fichier ne se ferme pas, afficher une erreur :
      Serial.println("error opening test.txt");
+   }
@@ Ligne 114 : / Ligne 114 : @@
-Certaines choses sont à noter:
+Certaines éléments sont à noter:
 * Vous pouvez avoir plusieurs fichiers ouverts en même temps, et lire à partir de chacun d'eux comme vous le souhaitez.
-* '''read()''' retourne un seul octet à la fois. Elle ne lit pas une ligne complète ou un nombre!
+* La fonction '''read()''' retourne un seul octet à la fois. Elle ne lit pas une ligne complète ou un nombre!
-* Vous devez '''close()''' le(s) fichier(s) lorsque vous avez terminé pour réduire la quantité de RAM utilisée
+* Vous devez fermer le(s) fichier(s) avec la fonction '''close()''' lorsque vous avez terminé pour réduire la quantité de RAM utilisée
 {{ambox-stop | text = La bibliothèque de la carte SD ne prend pas en charge les «noms de fichiers longs» tels que nous sommes habitués. Au lieu de cela, il utilise le format DOS 8.3 pour les noms de fichiers, donc n'utilisez que les noms de fichiers courts! Par exemple '''IMAGE.JPG''' est très bien, et '''datalog.txt''' est aussi très bien mais pas '''My GPS log file.text'''!
-Garder à l'esprit que les noms de fichiers courts ne sont pas sensibles à la case «case sensitive», de sorte '''datalog.txt''' est le même fichier que '''DataLog.Txt''' et idem pour le fichier '''DATALOG.TXT'''}}
+Garder à l'esprit que les noms de fichiers courts ne sont pas sensibles à la case (not case sensitive), de sorte '''datalog.txt''' est le même fichier que '''DataLog.Txt''' et idem pour le fichier '''DATALOG.TXT'''}}
 == Enumérer / lire récursivement  les fichiers ==

@@ Ligne 1 : / Ligne 1 : @@
 {{ADF-MICROSD-BREAKOUT-NAV}}
-== Lecture de fichiers ==
+== Ecriture de fichiers ==
 Le sketch suivant est une démonstration de base d'écriture dans un fichier.

@@ Ligne 2 : / Ligne 2 : @@
 == Lecture de fichiers ==
-Le sketch suivant est une démonstration de base d'écriture dans un fichier. C'est la façon habituelle pour enregistrer des données.
+Le sketch suivant est une démonstration de base d'écriture dans un fichier.
   <nowiki>#include <SD.h>
@@ Ligne 28 : / Ligne 30 : @@
    myFile = SD.open("test.txt", FILE_WRITE);
-   // Si le fichier s'est ouvert : nous pouvont y écrire
+   // Si le fichier s'est ouvert : nous pouvons y écrire
    if (myFile) {
      Serial.print("Writing to test.txt...");
@@ Ligne 47 : / Ligne 49 : @@
 </nowiki>
-Lorsque vous l'exécuterez, vous devriez voir ce qui suit:
+Lorsque vous l'exécuterez, vous devriez voir ceci:
 [[Fichier:ADF-MICROSD-BREAKOUT-Func00.jpg]]
-Vous pouvez ensuite ouvrir le fichier à l'aide de votre système d'exploitation en insérant la carte dans le slot ad hoc de votre PC. Vous verrez une ligne pour chaque fois que le sketch est exécuté. C'est-à-dire, qu'il '''ajoute''' dans le fichier, et qu'il n'écrase pas le contenu.
+Vous pouvez ensuite ouvrir le fichier à l'aide de votre système d'exploitation en insérant la carte dans le slot ad hoc de votre PC. Vous verrez une ligne pour chaque fois que le sketch aura été exécuté. C'est-à-dire que le sketch '''ajoute''' dans le fichier, et qu'il n'écrase pas le contenu.
 [[Fichier:ADF-MICROSD-BREAKOUT-Func01.jpg]]
-Certaines choses sont à noter :
+Certains point sont à relever :
 * Vous pouvez avoir plusieurs fichiers ouverts en même temps, et y écrire comme vous le souhaitez.
-* Vous pouvez utiliser '''print''' et '''println()''' comme des commandes en série, écrire des chaînes, des variables, etc
+* Vous pouvez utiliser '''print''' et '''println()''' comme des commandes du port série (Serial), pour écrire des chaînes de caractères (string), des variables, etc
 * Vous devez fermer '''close()''' le(s) fichier(s) lorsque vous avez terminé pour s'assurer que toutes les données sont écrites de façon permanente!(vider les buffer)
 * Vous pouvez ouvrir des fichiers dans un répertoire. Par exemple, si vous voulez ouvrir un fichier dans le répertoire comme '''/MesFichiers/exemple.txt''' vous pouvez appeler '''SD.open("/MesFichiers/exemple.txt")''' (indique le chemin complet).
-{{ambox | text = La bibliothèque de la carte SD ne prend pas en charge les «noms de fichiers longs» tels que nous sommes habitués. Au lieu de cela, il utilise le format DOS 8.3 pour les noms de fichiers, donc n'utilisez que les noms de fichiers courts! Par exemple '''IMAGE.JPG''' est très bien, et '''datalog.txt''' est aussi très bien mais pas '''My GPS log file.text'''!
+{{ambox | text = La bibliothèque de la carte SD ne prend pas en charge les "noms de fichiers longs" tels que nous sommes habitués à les utiliser. Au lieu de cela, la librairie utilise le format DOS 8.3 pour les noms de fichiers. Vous devez donc utilisez exclusivement des noms de fichier courts! Par exemple '''IMAGE.JPG''' est très bien, et '''datalog.txt''' est aussi très bien mais pas '''My GPS log file.text'''!
-Gardez à l'esprit que les noms de fichiers courts ne sont pas sensibles à la case «case sensitive», de sorte '''datalog.txt''' est le même fichier que '''DataLog.Txt''' et idem pour le fichier '''DATALOG.TXT''' }}
+Gardez à l'esprit que les noms de fichier courts ne sont pas sensibles à la case ("not case sensitive"), de sorte '''datalog.txt''' est le même fichier que '''DataLog.Txt''' et idem pour le fichier '''DATALOG.TXT''' }}
 == Lecture de fichiers ==

← Version précédente		Version du 25 février 2013 à 22:37
Ligne 128 :		Ligne 128 :
	Vous pouvez voir que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont). Les chiffres à la suite des noms de fichier sont la taille en octets des fichiers. Ce sketch est utile pour apprendre comment sont appelés les fichiers sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)		Vous pouvez voir que nous avons un sous-répertoire '''ANIM''' (des fichiers d'animation y sont). Les chiffres à la suite des noms de fichier sont la taille en octets des fichiers. Ce sketch est utile pour apprendre comment sont appelés les fichiers sur votre carte. Le sketch montre également comment manipuler le(s) répertoire(s)

−	~~[[IMAGE]] (http://www.ladyada.net/images/microsd/listrecuse.gif)~~
	[[Fichier:ADF-MICROSD-BREAKOUT-Func02.jpg]]		[[Fichier:ADF-MICROSD-BREAKOUT-Func02.jpg]]

@@ Ligne 4 : / Ligne 4 : @@
 Le sketch suivant est une démonstration de base d'écriture dans un fichier. C'est la façon habituelle pour enregistrer des données.
-[[CODE]]
+ <nowiki>#include <SD.h>
 File myFile;
@@ Ligne 47 : / Ligne 45 : @@
          // Il n'y a rien à faire ici, après setup()
+}
+</nowiki>
 Lorsque vous l'exécuterez, vous devriez voir ce qui suit:
@@ Ligne 54 : / Ligne 51 : @@
 [[IMAGE]]  (http://www.ladyada.net/images/microsd/writetest.gif)
 Vous pouvez ensuite ouvrir le fichier à l'aide de votre système d'exploitation en insérant la carte dans le slot ad hoc de votre PC. Vous verrez une ligne pour chaque fois que le sketch est exécuté. C'est-à-dire, qu'il '''ajoute''' dans le fichier, et qu'il n'écrase pas le contenu.
 [[IMAGE]]  (http://www.ladyada.net/images/Fmicrosd/writtentest.gif)
 Certaines choses sont à noter :
@@ Ligne 66 : / Ligne 65 : @@
 * Vous pouvez ouvrir des fichiers dans un répertoire. Par exemple, si vous voulez ouvrir un fichier dans le répertoire comme '''/MesFichiers/exemple.txt''' vous pouvez appeler '''SD.open("/MesFichiers/exemple.txt")''' (indique le chemin complet).
-[[ATTENTION]]
+{{ambox | text = La bibliothèque de la carte SD ne prend pas en charge les «noms de fichiers longs» tels que nous sommes habitués. Au lieu de cela, il utilise le format DOS 8.3 pour les noms de fichiers, donc n'utilisez que les noms de fichiers courts! Par exemple '''IMAGE.JPG''' est très bien, et '''datalog.txt''' est aussi très bien mais pas '''My GPS log file.text'''!
-[[FIN ATTENTION]]
+Gardez à l'esprit que les noms de fichiers courts ne sont pas sensibles à la case «case sensitive», de sorte '''datalog.txt''' est le même fichier que '''DataLog.Txt''' et idem pour le fichier '''DATALOG.TXT''' }}
 == Lecture de fichiers ==
 Ensuite, nous allons vous montrer comment lire un fichier, c'est très similaire à l'écriture, pour cela, nous utiliserons '''SD.open()''' pour ouvrir le fichier mais cette fois on ne passe pas le paramètre '''FILE_WRITE''' cela nous gardera d'écrire accidentellement dans le fichier (ouverture en lecture seule). Vous pouvez alors appeler la fonction '''available()''' (elle vous indiquera s'il reste des données à lire) et un '''read()''' sur le fichier vous renverra l'octet suivant.
-[[CODE]]
+ <nowiki>#include <SD.h>
 File myFile;
@@ Ligne 119 : / Ligne 112 : @@
+{
          // Il n'y a rien à faire après setup()
+}</nowiki>
 Certaines choses sont à noter:
@@ Ligne 128 : / Ligne 120 : @@
 * Vous devez '''close()''' le(s) fichier(s) lorsque vous avez terminé pour réduire la quantité de RAM utilisée
-[[ATTENTION]]
+{{ambox-stop | text = La bibliothèque de la carte SD ne prend pas en charge les «noms de fichiers longs» tels que nous sommes habitués. Au lieu de cela, il utilise le format DOS 8.3 pour les noms de fichiers, donc n'utilisez que les noms de fichiers courts! Par exemple '''IMAGE.JPG''' est très bien, et '''datalog.txt''' est aussi très bien mais pas '''My GPS log file.text'''!
-[[FIN ATTENTION]]
+Garder à l'esprit que les noms de fichiers courts ne sont pas sensibles à la case «case sensitive», de sorte '''datalog.txt''' est le même fichier que '''DataLog.Txt''' et idem pour le fichier '''DATALOG.TXT'''}}
 == Enumérer / lire récursivement  les fichiers ==
@@ Ligne 144 : / Ligne 132 : @@
 [[IMAGE]]  (http://www.ladyada.net/images/microsd/listrecuse.gif)
 == Autres fonctions utiles ==