Κάρτα SD#

Εισαγωγή #

Η χρήση κάρτας SD με το VEX EXP σάς επιτρέπει να αποθηκεύετε και να έχετε πρόσβαση σε αρχεία σε μια αφαιρούμενη κάρτα SD που έχει εισαχθεί στην υποδοχή κάρτας SD του Brain. Είτε αποθηκεύετε δεδομένα αισθητήρα είτε φορτώνετε προσαρμοσμένες εικόνες, αυτές οι μέθοδοι παρέχουν πλήρη έλεγχο στις λειτουργίες των αρχείων. Η αφαιρούμενη κάρτα SD σάς επιτρέπει να μεταφέρετε εύκολα δεδομένα μεταξύ του Brain και του υπολογιστή σας.

Το EXP Brain απαιτεί κάρτα SD όχι μεγαλύτερη από 32GB, με μορφοποίηση FAT32. Οι κάρτες SD που είναι μεγαλύτερες από 32GB χρησιμοποιούν μορφοποίηση exFAT από προεπιλογή, η οποία δεν είναι συμβατή με το EXP Brain. Βεβαιωθείτε ότι η κάρτα SD σας έχει μορφοποιηθεί σωστά σε FAT32 πριν από τη χρήση.

Όλα τα αρχεία πρέπει να τοποθετούνται στον ριζικό φάκελο της κάρτας SD για να είναι προσβάσιμα.

Για τα παρακάτω παραδείγματα, το constructed Brain περιλαμβάνει πρόσβαση στις μεθόδους της κάρτας SD και θα χρησιμοποιηθεί σε όλα τα επόμενα παραδείγματα σε όλη την τεκμηρίωση αυτού του API κατά την αναφορά σε αυτές τις μεθόδους.

Παρακάτω είναι μια λίστα με όλες τις μεθόδους:

Ενέργειες — Εκτελέστε λειτουργίες αρχείων και εμφανίστε εικόνες από την κάρτα SD.

loadfile — Loads the contents of a file from the SD card into a user-provided memory buffer.
savefile — Saves data from a user-provided buffer to a file on the EXP Brain’s SD card.
appendfile — Appends data from a user-provided buffer to the end of an existing file on the EXP Brain’s SD card.
draw_image_from_file — Displays a Bitmap Image from the SD card.

Λήπτες — Επιστρέφουν πληροφορίες κάρτας SD και αρχείου.

is_inserted — Returns whether an SD card is inserted into the Brain.
filesize — Returns the size of a file.
size — Returns the size of a file.
exists — Returns whether a file is found on the SD card.

Ενέργειες #

loadfile #

loadfile loads a file from the SD card into a bytearray.

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

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου που θα φορτωθεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	Προαιρετικό. Ένα υπάρχον bytearray για τη φόρτωση του περιεχομένου του αρχείου. Εάν το υπάρχον bytearray είναι μεγαλύτερο, το περιεχόμενό του θα αντικατασταθεί. Εάν το υπάρχον bytearray είναι μικρότερο, η μέθοδος ενδέχεται να μην φορτώσει όλα τα δεδομένα. Από προεπιλογή, θα επιστραφεί ένα νέο bytearray εάν δεν παρέχεται buffer.

Παράμετροι

Περιγραφή

filename

Το όνομα του αρχείου που θα φορτωθεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

buffer

Προαιρετικό. Ένα υπάρχον bytearray για τη φόρτωση του περιεχομένου του αρχείου. Εάν το υπάρχον bytearray είναι μεγαλύτερο, το περιεχόμενό του θα αντικατασταθεί. Εάν το υπάρχον bytearray είναι μικρότερο, η μέθοδος ενδέχεται να μην φορτώσει όλα τα δεδομένα. Από προεπιλογή, θα επιστραφεί ένα νέο bytearray εάν δεν παρέχεται buffer.

# 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 saves a bytearray into the SD card.

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

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου που θα αποθηκευτεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου. Εάν το αρχείο υπάρχει ήδη, θα αντικατασταθεί. Εάν το αρχείο δεν υπάρχει, θα δημιουργηθεί ένα νέο αρχείο.
`buffer`	Προαιρετικό. Ένα bytearray για εγγραφή στο αρχείο.

Παράμετροι

Περιγραφή

filename

Το όνομα του αρχείου που θα αποθηκευτεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου. Εάν το αρχείο υπάρχει ήδη, θα αντικατασταθεί. Εάν το αρχείο δεν υπάρχει, θα δημιουργηθεί ένα νέο αρχείο.

buffer

Προαιρετικό. Ένα bytearray για εγγραφή στο αρχείο.

# 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 appends a bytearray to an existing file, adding new data to the end of the file without altering the current contents.

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

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου που θα προστεθεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	Ένα bytearray που περιέχει τα δεδομένα που θα προστεθούν.

# 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 displays a Bitmap Image (BMP) stored on the SD card.

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

Note: The EXP Brain only supports displaying .bmp files. 8-bit RLE encoding is recommended to minimize file size.

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

Παράμετροι	Περιγραφή
`filename`	Το όνομα αρχείου της εικόνας.
`x`	Η συντεταγμένη x για την επάνω αριστερή γωνία της εικόνας στην οθόνη.
`y`	Η συντεταγμένη y για την επάνω αριστερή γωνία της εικόνας στην οθόνη.

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

Αποκτητές #

is_inserted #

is_inserted returns a Boolean indicating whether an SD card is currently inserted into the Brain.

True — The Brain has an SD card inserted.
False — The Brain does not have an SD card inserted.

Usage:
brain.sdcard.is_inserted()

Παράμετροι	Περιγραφή
	Αυτή η μέθοδος δεν έχει παραμέτρους.

# 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 returns the size of a file in bytes as a decimal (float).

Usage:
brain.sdcard.filesize(filename)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

# 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 returns the size of a file in bytes as a decimal (float).

Usage:
brain.sdcard.size(filename)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

# 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 returns a Boolean indicating whether a file is found on the SD card.

True — The file is on the SD card.
False — The file is not on the SD card.

Usage:
brain.sdcard.exists(filename)

Παράμετροι	Περιγραφή
`filename`	Το όνομα του αρχείου ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

# Add more text and display file size if the file exists
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)