1.  Description

1.1  Informations sur les fichiers supportés

• La librairie SD permet de lire et d'écrire les cartes mémoires SD, par exemple sur la carte d'extension (shield) Arduino Ethernet. Elle est basée sur la libriairie sdfatlib de William Greiman.
• La librairie supporte les systèmes de fichier FAT16 et FAT 32 sur les cartes mémoires SD standard et les cartes SDHC.
• La librairie supporte l'ouverture d'un seul fichier à la fois et n'utilise que les noms de fichiers courts au format "8.3" (c'est à dire des noms en 8 lettres maxi, un point et trois lettres, par exemple filename.txt).
• Les noms de fichiers utilisés avec les fonctions de la librairie SD peuvent inclure des chemins séparés par des slash /, par exemple "directory/filename.txt).
• Le répertoire de travail étant toujours la racine de la carte SD, un nom se réfère au même fichier, qu'il inclue ou non un / (par exemple, "/file.txt" est équivalent à "file.txt").

1.2  Informations matérielles

• La communication entre la carte Arduino et la carte mémoire SD utilise la communication SPI, laquelle utilise les broches 11, 12 et 13 de la plupart des cartes Arduino ou les broches 50, 51 et 52 sur la carte Arduino Mega (à noter que la carte d'extension Arduino Ethernet assure la connexion pour la carte Mega via le connecteur droit ICSP de la carte Arduino).
• En plus, une autre broche peut être utilisée pour sélectionner la carte SD. Cette broche peut être la broche matérielle SS (broche 10 sur la plupart des cartes Arduino et broche 53 sur la Mega) ou une autre broche spécifiée dans la fonction d'initialisation SD.begin().
• Noter que même si vous n'utilisez pas la broche matérielle SS, elle doit être laissée en sortie, sinon la librairie ne fonctionnera pas.

2.  Principe d'utilisation

3.  Shield utilisables avec cette librairie :

• le shield Arduino Ethernet
• le mSD shield de Watterott

4.  Exemples d'utilisation :

4.1  Sur le site Arduino anglais :

5.  Les fonctions de la librairie

5.1  Classe SD

La classe SD fournit les fonctions pour accéder à la carte SD et manipuler ses fichiers et répertoires. L'objet SD est directement disponible à l'inclusion de la librairie.

• begin()
• exists()
• mkdir()
• open()
• remove()
• rmdir()

5.2  Classe File

La classe File permet de lire et d'écrire dans les fichiers individuels sur la carte SD.

• le constructeur File
• available()
• close()
• flush()
• name()
• peek()
• position()
• print()
• println()
• seek()
• size()
• read()
• write()
• isDirectory()
• openNextFile()
• rewindDirectory()