***
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: |
| 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.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()) |
| 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 |
