Carte SD#

Introduction #

L’utilisation d’une carte SD avec le VEX V5 vous permet de stocker et d’accéder aux fichiers sur une carte SD amovible insérée dans le logement prévu à cet effet sur le Brain. Que vous enregistriez des données de capteurs ou chargiez des images personnalisées, ces méthodes vous offrent un contrôle total sur les opérations sur les fichiers. La carte SD amovible facilite le transfert de données entre votre Brain et votre ordinateur.

Le V5 Brain nécessite une carte SD de 32 Go maximum, formatée en FAT32. Les cartes SD de plus de 32 Go utilisent par défaut le format exFAT, incompatible avec le V5 Brain. Assurez-vous que votre carte SD est correctement formatée en FAT32 avant utilisation.

Pour être accessibles, tous les fichiers doivent être placés à la racine de la carte SD.

Pour les exemples ci-dessous, le cerveau construit inclut l’accès aux méthodes de la carte SD et sera utilisé dans tous les exemples suivants de cette documentation API lorsqu’il sera fait référence à ces méthodes.

Vous trouverez ci-dessous la liste de toutes les méthodes :

Actions – Effectuer des opérations sur les fichiers et afficher les images de la carte SD.

loadfile – Charge un fichier depuis la carte SD dans un tableau d’octets.
savefile – Enregistre un tableau d’octets sur la carte SD.
appendfile – Ajoute un tableau d’octets à un fichier existant.
draw_image_from_file – Affiche une image bitmap à partir de la carte SD.

Getters – Renvoi des informations sur la carte SD et les fichiers.

is_inserted – Renvoie un booléen indiquant si une carte SD est insérée dans le Cerveau.
filesize – Renvoie la taille d’un fichier en octets.
size – Renvoie la taille d’un fichier en octets.
exists – Renvoie un booléen indiquant si un fichier est trouvé sur la carte SD.

Pour plus d’informations sur la construction d’un Cerveau pour accéder aux méthodes sdcard , voir Cerveau.

Actes #

loadfile #

loadfile charge un fichier depuis la carte SD dans un tableau d’octets.

Usage:
brain.sdcard.loadfile(filename, buffer)

Paramètres	Description
`filename`	Nom du fichier à charger (sous forme de chaîne de caractères). Le nom du fichier doit inclure son extension.
`buffer`	Facultatif. Un tableau d’octets existant dans lequel charger le contenu du fichier. Si le tableau d’octets existant est plus grand, son contenu sera écrasé. S’il est plus petit, la méthode risque de ne pas charger toutes les données. Par défaut, un nouveau tableau d’octets sera renvoyé si aucun tampon n’est fourni.

# Check for SD card and show a file's text
if brain.sdcard.is_inserted():
    # Save new text to a file
    brain.sdcard.savefile("Note.txt", bytearray("VEX"))
    # Load the file and print it
    data = brain.sdcard.loadfile("Note.txt")
    brain.screen.print(data.decode("utf-8"))
else:
    brain.screen.print("Insert SD card")

savefile #

savefile enregistre un tableau d’octets sur la carte SD.

Usage:
brain.sdcard.savefile(filename, buffer)

Paramètres	Description
`filename`	Nom du fichier à enregistrer (chaîne de caractères). Ce nom doit inclure l’extension. Si le fichier existe déjà, il sera écrasé. Sinon, un nouveau fichier sera créé.
`buffer`	Facultatif. Un tableau d’octets à écrire dans le fichier.

# Check for SD card and show a file's text
if brain.sdcard.is_inserted():
    # Save new text to a file
    brain.sdcard.savefile("Note.txt", bytearray("VEX"))
    # Load the file and print it
    data = brain.sdcard.loadfile("Note.txt")
    brain.screen.print(data.decode("utf-8"))
else:
    brain.screen.print("Insert SD card")

appendfile #

appendfile ajoute un tableau d’octets à un fichier existant, ajoutant de nouvelles données à la fin du fichier sans modifier le contenu actuel.

Usage:
brain.sdcard.appendfile(filename, buffer)

Paramètres	Description
`filename`	Nom du fichier à ajouter sous forme de chaîne de caractères. Le nom du fichier doit inclure son extension.
`buffer`	Un tableau d’octets contenant les données à ajouter.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray("code"))
    size = brain.sdcard.size("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)

draw_image_from_file #

draw_image_from_file affiche une image bitmap (BMP) stockée sur la carte SD.

.bmp files are limited to 5120 pixels and 6KB in size.

Remarque : Le V5 Brain ne prend en charge que l’affichage de .bmp L’encodage RLE 8 bits est recommandé pour minimiser la taille du fichier.

Usage
brain.screen.draw_image_from_file(filename, x, y)

Paramètres	Description
`filename`	Le nom du fichier image.
`x`	La coordonnée x du coin supérieur gauche de l’image à l’écran.
`y`	La coordonnée y du coin supérieur gauche de l’image à l’écran.

# Draw a bmp file on the Brain's screen at coordinate 0, 0
brain.screen.draw_image_from_file('test_image.bmp', 0, 0)

Getters #

is_inserted #

is_inserted renvoie une valeur booléenne indiquant si une carte SD est actuellement insérée dans le Brain.

True - Une carte SD est insérée dans le cerveau.
False - Le cerveau ne possède pas de carte SD insérée.

Usage:
brain.sdcard.is_inserted()

Paramètres	Description
	Cette méthode ne comporte aucun paramètre.

# Check for SD card and show a file's text
if brain.sdcard.is_inserted():
    # Save new text to a file
    brain.sdcard.savefile("Note.txt", bytearray("VEX"))
    # Load the file and print it
    data = brain.sdcard.loadfile("Note.txt")
    brain.screen.print(data.decode("utf-8"))
else:
    brain.screen.print("Insert SD card")

filesize #

filesize renvoie la taille d’un fichier en octets.

Usage:
brain.sdcard.filesize(filename)

Paramètres	Description
`filename`	Le nom du fichier sous forme de chaîne de caractères. Ce nom doit inclure l’extension du fichier.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray("code"))
    size = brain.sdcard.filesize("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)

size #

size renvoie la taille d’un fichier en octets.

Usage:
brain.sdcard.size(filename)

Paramètres	Description
`filename`	Le nom du fichier sous forme de chaîne de caractères. Ce nom doit inclure l’extension du fichier.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray("code"))
    size = brain.sdcard.size("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)

exists #

exists renvoie une valeur booléenne indiquant si un fichier est trouvé sur la carte SD.

True - Le fichier se trouve sur la carte SD.
False - Le fichier n’est pas sur la carte SD.

Usage:
brain.sdcard.exists(filename)

Paramètres	Description
`filename`	Le nom du fichier sous forme de chaîne de caractères. Ce nom doit inclure l’extension du fichier.

# Add more text and display file size
if brain.sdcard.exists("Note.txt"):
    brain.sdcard.appendfile("Note.txt", bytearray(" World"))
    size = brain.sdcard.size("Note.txt")
    brain.screen.print("Size: ")
    brain.screen.print(size)