Κάρτα SD#

Εισαγωγή #

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

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

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

This page uses brain as the example Brain name. Replace it with your own configured name as needed.

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

Ενέργειες — Εκτελέστε λειτουργίες αρχείων και εμφανίστε εικόνες από την κάρτα 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 IQ (2nd gen) Brain’s SD card.
appendfile — Appends data from a user-provided buffer to the end of an existing file on the IQ (2nd gen) 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 IQ (2nd gen) 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)