Κάρτα SD#

Εισαγωγή #

Η κλάση sdcard προέρχεται από την βασική κλάση brain και παρέχει πρόσβαση σε αρχεία που είναι αποθηκευμένα σε μια αφαιρούμενη κάρτα SD που εισάγεται στον IQ (2ης γενιάς) Brain.

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

Access #

Brain.SDcard

Notes #

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

Example #

/* This constructor is required when using VS Code.
A Brain is generated automatically at the start of
VEXcode projects. */

// Create the Brain
brain Brain = brain();

// Add more text and display file size
if (Brain.SDcard.exists("Text.txt")) {
  // Get the size of the file
  int fileSize = Brain.SDcard.size("Text.txt");

  // Make a buffer to hold the file data
  uint8_t buffer[fileSize];

  // Load the file from the SD card into the buffer
  Brain.SDcard.loadfile("Text.txt", buffer, sizeof(buffer));

  // Display the file contents on the screen
  Brain.Screen.print("%s", buffer);
}

Συναρτήσεις Μελών #

Η κλάση sdcard περιλαμβάνει τις ακόλουθες συναρτήσεις-μέλη:

loadfile — Φορτώνει τα περιεχόμενα ενός αρχείου από την κάρτα SD σε μια προσωρινή μνήμη που παρέχεται από τον χρήστη.
savefile — Αποθηκεύει δεδομένα από ένα buffer που παρέχεται από τον χρήστη σε ένα αρχείο στην κάρτα SD του IQ (2ης γενιάς) Brain.
appendfile — Προσθέτει δεδομένα από ένα buffer που παρέχεται από τον χρήστη στο τέλος ενός υπάρχοντος αρχείου στην κάρτα SD του IQ (2ης γενιάς) Brain.
isInserted — Επιστρέφει εάν μια κάρτα SD έχει εισαχθεί στον εγκέφαλο.
size — Επιστρέφει το μέγεθος ενός αρχείου που είναι αποθηκευμένο στην κάρτα SD του IQ (2ης γενιάς) Brain.
exists — Επιστρέφει εάν ένα αρχείο με το καθορισμένο όνομα υπάρχει στην κάρτα SD του IQ (2ης γενιάς) Brain.

Τα αρχεία .bmp και .png που είναι αποθηκευμένα στην κάρτα SD μπορούν να εμφανιστούν στην οθόνη Brain του IQ (2ης γενιάς) χρησιμοποιώντας το drawImageFromFile, το οποίο είναι προσβάσιμο μέσω του Brain.Screen.

Πριν από την κλήση οποιασδήποτε συνάρτησης μέλους sdcard , πρέπει να δημιουργηθεί μια παρουσία brain , όπως φαίνεται παρακάτω:

// Create the Brain
brain Brain = brain();

loadfile #

Φορτώνει τα περιεχόμενα ενός αρχείου από την κάρτα SD σε μια προσωρινή μνήμη που παρέχεται από τον χρήστη.

Available Functions

int32_t loadfile(
  const char* name,
  uint8_t* buffer,
  int32_t len );

Parameters

Παράμετρος	Τύπος	Περιγραφή
`name`	`const char*`	Το όνομα του αρχείου που θα φορτωθεί από την κάρτα SD. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	`uint8_t*`	Ένας δείκτης σε ένα buffer όπου θα αποθηκευτούν τα δεδομένα του αρχείου.
`len`	`int32_t`	Ο μέγιστος αριθμός byte για ανάγνωση από το αρχείο, συνήθως ορίζεται στο μέγεθος του buffer.

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει τον αριθμό των byte που διαβάστηκαν με επιτυχία από το αρχείο:

Μια θετική τιμή υποδεικνύει πόσα byte φορτώθηκαν στο buffer.
0 υποδεικνύει ότι δεν αναγνώστηκαν δεδομένα.

Notes

Εάν το αρχείο είναι μεγαλύτερο από len, διαβάζονται μόνο τα πρώτα len bytes.
Το buffer πρέπει να είναι αρκετά μεγάλο για να χωρέσει τα ζητούμενα δεδομένα.
Αυτή η συνάρτηση διαβάζει ακατέργαστα byte και δεν προσθέτει έναν μηδενικό τερματιστή.

Examples

// Check for SD card and show a file's text
if (Brain.SDcard.isInserted()) {
  // Create a message to save to the SD card
  uint8_t message[] = "Hello from VEX!";

  // Save the message into "Text.txt"
  Brain.SDcard.savefile("Text.txt", message, sizeof(message));

  // Get the size of the file
  int fileSize = Brain.SDcard.size("Text.txt");

  // Make a buffer to hold the file data
  uint8_t buffer[fileSize];

  // Load the file from the SD card into the buffer
  Brain.SDcard.loadfile("Text.txt", buffer, sizeof(buffer));

  // Display the file contents on the screen
  Brain.Screen.print("%s", buffer);
} else {
  Brain.Screen.print("Insert SD card");
}

savefile #

Αποθηκεύει δεδομένα από ένα buffer που παρέχεται από τον χρήστη σε ένα αρχείο στην κάρτα SD του IQ (2ης γενιάς) Brain.

Available Functions

int32_t savefile(
  const char* name,
  uint8_t* buffer,
  int32_t len );

Parameters

Παράμετρος	Τύπος	Περιγραφή
`name`	`const char*`	Το όνομα του αρχείου που θα αποθηκευτεί ως συμβολοσειρά. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	`uint8_t*`	Ένας δείκτης σε μια προσωρινή μνήμη (buffer) που περιέχει τα δεδομένα που θα εγγραφούν στο αρχείο.
`len`	`int32_t`	Ο αριθμός των byte που θα εγγραφούν από την buffer στο αρχείο.

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει τον αριθμό των byte που εγγράφηκαν με επιτυχία στο αρχείο:

Μια θετική τιμή υποδεικνύει πόσα byte αποθηκεύτηκαν.
0 υποδεικνύει ότι δεν έχουν εγγραφεί δεδομένα.

Notes

Εάν το αρχείο είναι μεγαλύτερο από len, διαβάζονται μόνο τα πρώτα len bytes.
Εάν υπάρχει ήδη ένα αρχείο με το ίδιο όνομα, θα αντικατασταθεί.
Αυτή η συνάρτηση δεν εκχωρεί μνήμη. Η προσωρινή μνήμη (buffer) πρέπει να δημιουργηθεί και να διαχειριστεί ο χρήστης.
Η συνάρτηση γράφει ακατέργαστα bytes και δεν προσθέτει έναν null τερματιστή.

Examples

// Check for SD card and show a file's text
if (Brain.SDcard.isInserted()) {
  // Create a message to save to the SD card
  uint8_t message[] = "Hello from VEX!";

  // Save the message into "Text.txt"
  Brain.SDcard.savefile("Text.txt", message, sizeof(message));

  // Get the size of the file
  int fileSize = Brain.SDcard.size("Text.txt");

  // Make a buffer to hold the file data
  uint8_t buffer[fileSize];

  // Load the file from the SD card into the buffer
  Brain.SDcard.loadfile("Text.txt", buffer, sizeof(buffer));

  // Display the file contents on the screen
  Brain.Screen.print("%s", buffer);
} else {
  Brain.Screen.print("Insert SD card");
}

appendfile #

Προσθέτει δεδομένα από ένα buffer που παρέχεται από τον χρήστη στο τέλος ενός υπάρχοντος αρχείου στην κάρτα SD του IQ (2ης γενιάς) Brain.

Available Functions

int32_t appendfile(
  const char* name,
  uint8_t* buffer,
  int32_t len );

Parameters

Παράμετρος	Τύπος	Περιγραφή
`name`	`const char*`	Το όνομα του αρχείου στο οποίο θα προστεθούν δεδομένα στην κάρτα SD. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.
`buffer`	`uint8_t*`	Ένας δείκτης σε μια προσωρινή μνήμη που περιέχει τα δεδομένα που θα προστεθούν στο αρχείο.
`len`	`int32_t`	Ο αριθμός των byte που θα προστεθούν από την buffer στο αρχείο.

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει τον αριθμό των byte που προστέθηκαν με επιτυχία στο αρχείο:

Μια θετική τιμή υποδεικνύει πόσα byte προστέθηκαν.
0 υποδεικνύει ότι δεν έχουν προστεθεί δεδομένα.

Notes

Εάν το αρχείο είναι μεγαλύτερο από len, διαβάζονται μόνο τα πρώτα len bytes.
Το αρχείο πρέπει να υπάρχει ήδη στην κάρτα SD. Αυτή η λειτουργία δεν δημιουργεί νέο αρχείο.
Αυτή η συνάρτηση δεν εκχωρεί μνήμη. Η προσωρινή μνήμη (buffer) πρέπει να δημιουργηθεί και να διαχειριστεί ο χρήστης.
Η συνάρτηση προσαρτά ακατέργαστα bytes και δεν προσαρτά έναν τερματιστή null.

Examples

// Create a message to save to a new file
uint8_t message[] = "Hello";

// Save only the characters, not the null terminator
Brain.SDcard.savefile("Message.txt", message, sizeof(message) - 1);

// Load the file
int fileSize = Brain.SDcard.size("Message.txt");
uint8_t buffer[fileSize + 1];
Brain.SDcard.loadfile("Message.txt", buffer, fileSize);

// Add null terminator so it can be printed safely
buffer[fileSize] = 0;
Brain.Screen.print("%s\n", buffer);

// Create more text to append to the same file
uint8_t moreText[] = " World!";

// Append only the characters, not the null terminator
Brain.SDcard.appendfile("Message.txt", moreText, sizeof(moreText) - 1);

// Load the updated file
fileSize = Brain.SDcard.size("Message.txt");
uint8_t buffer2[fileSize + 1];
Brain.SDcard.loadfile("Message.txt", buffer2, fileSize);

// Add null terminator
buffer2[fileSize] = 0;
Brain.Screen.newLine();
Brain.Screen.print("%s", buffer2);

isInserted #

Επιστρέφει εάν μια κάρτα SD έχει εισαχθεί αυτήν τη στιγμή στον εγκέφαλο IQ (2ης γενιάς).

Available Functions

bool isInserted();

Parameters

Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.

Return Values

Επιστρέφει μια λογική τιμή που υποδεικνύει εάν έχει εισαχθεί κάρτα SD:

true — Μια κάρτα SD εισάγεται στον εγκέφαλο IQ (2ης γενιάς).
false — Δεν έχει τοποθετηθεί κάρτα SD.

Notes

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

Examples

// Check for SD card and show a file's text
if (Brain.SDcard.isInserted()) {
  // Create a message to save to the SD card
  uint8_t message[] = "Hello from VEX!";

  // Save the message into "Text.txt"
  Brain.SDcard.savefile("Text.txt", message, sizeof(message));

  // Get the size of the file
  int fileSize = Brain.SDcard.size("Text.txt");

  // Make a buffer to hold the file data
  uint8_t buffer[fileSize];

  // Load the file from the SD card into the buffer
  Brain.SDcard.loadfile("Text.txt", buffer, sizeof(buffer));

  // Display the file contents on the screen
  Brain.Screen.print("%s", buffer);
} else {
  Brain.Screen.print("Insert SD card");
  }

size #

Επιστρέφει το μέγεθος ενός αρχείου που είναι αποθηκευμένο στην κάρτα SD του IQ (2ης γενιάς) Brain.

Available Functions

int32_t size(
  const char* name );

Parameters

Παράμετρος	Τύπος	Περιγραφή
`name`	`const char*`	Το όνομα του αρχείου στην κάρτα SD. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

Return Values

Επιστρέφει μια τιμή int32_t που αντιπροσωπεύει το μέγεθος του αρχείου σε bytes:

Μια θετική τιμή υποδεικνύει το μέγεθος του αρχείου σε byte.
0 υποδεικνύει ένα κενό αρχείο ή ότι το αρχείο δεν βρέθηκε.

Notes

Το επιστρεφόμενο μέγεθος μπορεί να χρησιμοποιηθεί για την κατανομή ενός buffer πριν από την κλήση του loadfile.

Examples

// Check for SD card and show a file's text
if (Brain.SDcard.isInserted()) {
  // Create a message to save to the SD card
  uint8_t message[] = "Hello from VEX!";

  // Save the message into "Text.txt"
  Brain.SDcard.savefile("Text.txt", message, sizeof(message));

  // Get the size of the file
  int fileSize = Brain.SDcard.size("Text.txt");

  // Make a buffer to hold the file data
  uint8_t buffer[fileSize];

  // Load the file from the SD card into the buffer
  Brain.SDcard.loadfile("Text.txt", buffer, sizeof(buffer));

  // Display the file contents on the screen
  Brain.Screen.print("%s", buffer);
} else {
  Brain.Screen.print("Insert SD card");
}

exists #

Επιστρέφει εάν υπάρχει ένα αρχείο με το καθορισμένο όνομα στην κάρτα SD του IQ (2ης γενιάς) Brain.

Available Functions

bool exists(
  const char* name );

Parameters

Παράμετρος	Τύπος	Περιγραφή
`name`	`const char*`	Το όνομα του αρχείου που θα ελεγχθεί στην κάρτα SD. Το όνομα του αρχείου πρέπει να περιλαμβάνει την επέκταση αρχείου.

Return Values

Επιστρέφει μια λογική τιμή που υποδεικνύει εάν το αρχείο υπάρχει:

true — Υπάρχει ένα αρχείο με το καθορισμένο όνομα στην κάρτα SD.
false — Δεν υπάρχει αρχείο με το καθορισμένο όνομα.

Examples

// Add more text and display file size
if (Brain.SDcard.exists("Text.txt")) {
  // Get the size of the file
  int fileSize = Brain.SDcard.size("Text.txt");

  // Make a buffer to hold the file data
  uint8_t buffer[fileSize];

  // Load the file from the SD card into the buffer
  Brain.SDcard.loadfile("Text.txt", buffer, sizeof(buffer));

  // Display the file contents on the screen
  Brain.Screen.print("%s", buffer);
}