Librairie Arduino gestion des cartes SD

***

Mise à jour le 25/03/2015

Cette librairie gère aussi bien les cartes SD que les cartes SD HC et support aussi bien les cartes formatées en FAT16 qu’en FAT32. Elle utilise les noms de fichier courts comportant au maximum 8 caractères . La notion de répertoire et de sous répertoire  est également supportée.

  Fonction   Définition de la fonction
 SD.begin()  Initialise la librairie SD et la carte SD. Cela lance l’utilisation du bus SPI
(broches numériques 11,12 et 13 sur la plupart des cartes Arduino; 50, 51 et 52 sur la Mega)
 SD.exists(nom du fichier )

 Cette fonction teste la présence d’un fichier ou d’un répertoire sur la carte préalablement initialisée. Elle retourne un résultat:
true : si le fichier ou répertoire existe   —–> true = vrai
false : si le fichier ou le répertoire n’existe pas  ——-> false = faux

 SD.mkdir(« nom du répertoire »)  Cette fonction crée un répertoire sur la carte mémoire SD. Elle retourne un résultat vrai si la création s’est bien passée et faux dans le cas contraire . 
 SD.rmdir(« nom du répertoire »)  Cette fonction est le contraire de la précédente pour détruire le répertoire spécifié.
Elle retourne un résultat vrai si la destruction s’est bien passée et faux dans le cas contraire . ( a savoir : si le répertoire n’excite pas , la valeur de retour est indéterminée ) 
 SD.remove(nom du fichier )  Cette fonction efface un fichier de la carte mémoire SD. Elle retourne un résultat vrai si la suppression s’est bien passée et faux dans le cas contraire . ( a savoir : si le répertoire n’excite pas , la valeur de retour est indéterminée ) 
 SD.open(nom du fichier

ou

SD.open(nom du fichier, mode)

 Cette fonction ouvre un fichier sur la carte mémoire SD. Elle retourne un objet de type fichier correspondant au fichier qui vient d’être ouvert, si cette ouverture n’est pas possible , cet objet peut être testé comme une variable booléenne .

mode (optionnel), le mode d’ouverture du fichier, par défaut FILE_READ – byte. Les paramètres possibles sont :
FILE_READ: ouvre le fichier pour lecture, en démarrant au début du fichier.
FILE_WRITE: ouvre le fichier pour lecture et écriture, en démarrant au début du fichier.

 file.available()  Cette fonction vérifie si des octets sont disponibles en lecture dans le fichier. 
 file.close() Cette fonction ferme le fichier en s’assurant que les données qui y ont éventuellement été écrits sont bien sauvegardées sur la carte SD .Cette fonction ne retourne aucun résultat .
 file.flush() Cette fonction s’assure que les données écrites dans un fichier ont été physiquement enregistrées sur la carte mémoire SD. 
file.peek() Cette fonction lit un octet dans un fichier sans avancer au suivant. Ainsi, des appels successifs de la fonction peek() renverront la même valeur, jusqu’au prochain appel de la fonction read().
file.position() Cette fonction indique la position ou se trouve le pointeur au sein du fichier
file.print(data)

ou

file.print(data, BASE)

Cette fonction écrit des données dans un fichier, lequel doit être ouvert pour écriture. Cette fonction affiche les nombres comme une séquence de chiffres, chacun comme un caractère ASCII 
 file.println()

ou

file.println(data)

ou

 file.println(data, BASE)

 Cette fonction écrit des données suivies d’un saut de ligne ( retour chariot + nouvelle ligne) dans un fichier , lequel doit être ouvert pour écriture. Cette fonction affiche les nombres comme une séquence de chiffres, chacun comme un caractère ASCII (par exemple le nombre 123 est écrit sous la forme de 3 caractères ‘1’, ‘2’, ‘3’). 

file : une instance de l’objet File (renvoyée par la fonction SD.open())
data: les données à écrire dans le fichier – types possibles : char, byte, int, long, ou string
BASE : (optionnel): la base dans laquelle écrire les nombres : BIN pour binaire (base 2), DEC pour décimal (base 10), OCT pour octal (base 8), HEX pour hexadécimal (base 16). La base par défaut est la base décimale.

 file.seek(pos)  Cette fonction positionne le pointeur dans le fichier sur la valeur indiquée par position qui doit etre comprise entre 0 et la taille maximun du fichier
 file.size()  Cette fonction permet de connaître la taille d’un fichier (en nombre d’octets). 
 file.read()  Cette fonction lit un octet dans un fichier et avance le pointeur au suivant .Elle retourne le caractère lu ou -1 si aucun caractère n’est disponible
 file.write(données)

ou

file.write(tampon, longueur)

1 er forme : Cette fonction écrit des données dans un fichier .
2 éme forme : elle écrit le contenu du tampon dont la taille est spécifiée par le paramètre longueur

Retour au menu