Κάρτα SD#

Εισαγωγή #

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

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

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

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

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

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

loadfile – Φορτώνει ένα αρχείο από την κάρτα SD σε ένα bytearray.
savefile – Αποθηκεύει ένα bytearray στην κάρτα SD.
appendfile – Προσθέτει ένα bytearray σε ένα υπάρχον αρχείο.
draw_image_from_file – Εμφανίζει μια εικόνα Bitmap από την κάρτα SD.

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

is_inserted – Επιστρέφει μια λογική τιμή που υποδεικνύει εάν μια κάρτα SD έχει εισαχθεί στον εγκέφαλο.
filesize – Επιστρέφει το μέγεθος ενός αρχείου σε byte.
size – Επιστρέφει το μέγεθος ενός αρχείου σε byte.
exists – Επιστρέφει μια λογική τιμή που υποδεικνύει εάν ένα αρχείο βρίσκεται στην κάρτα SD.

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

Ενέργειες #

loadfile #

loadfile φορτώνει ένα αρχείο από την κάρτα SD σε ένα 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 αποθηκεύει ένα bytearray στην κάρτα SD.

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 προσαρτά ένα bytearray σε ένα υπάρχον αρχείο, προσθέτοντας νέα δεδομένα στο τέλος του αρχείου χωρίς να τροποποιεί τα τρέχοντα περιεχόμενα.

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 εμφανίζει μια εικόνα Bitmap (BMP) που είναι αποθηκευμένη στην κάρτα SD.

Τα αρχεία .bmp περιορίζονται σε 5120 pixel και 6KB σε μέγεθος.

Σημείωση: Το V5 Brain υποστηρίζει μόνο την εμφάνιση αρχείων .bmp Συνιστάται η κωδικοποίηση RLE 8-bit για την ελαχιστοποίηση του μεγέθους του αρχείου.

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 επιστρέφει μια Boolean τιμή που υποδεικνύει εάν μια κάρτα SD έχει εισαχθεί αυτήν τη στιγμή στον εγκέφαλο.

True - Ο εγκέφαλος έχει τοποθετήσει μια κάρτα SD.
False - Ο εγκέφαλος δεν έχει τοποθετήσει κάρτα SD.

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 επιστρέφει το μέγεθος ενός αρχείου σε byte.

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 επιστρέφει το μέγεθος ενός αρχείου σε bytes.

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 επιστρέφει μια λογική τιμή που υποδεικνύει εάν ένα αρχείο βρίσκεται στην κάρτα SD.

True - Το αρχείο βρίσκεται στην κάρτα SD.
False - Το αρχείο δεν βρίσκεται στην κάρτα SD.

Usage:
brain.sdcard.exists(filename)

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

# 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)