SD-kort#

Introduktion #

Genom att använda ett SD-kort med VEX V5 kan du lagra och komma åt filer på ett flyttbart SD-kort som sitter i Brains SD-kortplats. Oavsett om du sparar sensordata eller laddar anpassade bilder ger dessa metoder full kontroll över filhanteringen. Det flyttbara SD-kortet låter dig enkelt överföra data mellan din Brain och datorn.

V5 Brain kräver ett SD-kort som inte är större än 32 GB, formaterat som FAT32. SD-kort större än 32 GB använder exFAT-formatering som standard, vilket inte är kompatibelt med V5 Brain. Se till att ditt SD-kort är korrekt formaterat till FAT32 innan användning.

Alla filer måste placeras i SD-kortets rotmapp för att vara tillgängliga.

För exemplen nedan inkluderar constructed Brain åtkomst till SD-kortmetoderna och kommer att användas i alla efterföljande exempel i hela denna API-dokumentation när det hänvisas till dessa metoder.

Nedan följer en lista över alla metoder:

Åtgärder – Utför filåtgärder och visa bilder från SD-kortet.

loadfile – Laddar en fil från SD-kortet till en bytearray.
savefile – Sparar en bytearray på SD-kortet.
appendfile – Lägger till en bytearray i en befintlig fil.
draw_image_from_file – Visar en bitmappsbild från SD-kortet.

Getters – Returnerar SD-kort- och filinformation.

is_inserted – Returnerar ett booleskt värde som anger om ett SD-kort är isatt i Brain.
filesize – Returnerar filstorleken i byte.
size – Returnerar filens storlek i byte.
exists – Returnerar ett booleskt värde som anger om en fil finns på SD-kortet.

För information om hur man konstruerar en hjärna för att få tillgång till sdcard metoderna, se Hjärna.

Åtgärder #

loadfile #

loadfile laddar en fil från SD-kortet till en bytearray.

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

Parametrar	Beskrivning
`filename`	Namnet på filen som ska läsas in som en sträng. Filnamnet måste innehålla filändelsen.
`buffer`	Valfritt. En befintlig bytearray att läsa in filens innehåll i. Om den befintliga bytearrayen är större kommer dess innehåll att skrivas över. Om den befintliga bytearrayen är mindre kanske metoden inte laddar all data. Som standard returneras en ny bytearray om ingen buffert tillhandahålls.

# 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 sparar en bytearray på SD-kortet.

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

Parametrar	Beskrivning
`filename`	Namnet på filen som ska sparas som en sträng. Filnamnet måste innehålla filändelsen. Om filen redan finns kommer den att skrivas över. Om filen inte finns skapas en ny fil.
`buffer`	Valfritt. En bytearray att skriva in i filen.

# 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 lägger till en bytearray till en befintlig fil och lägger till ny data i slutet av filen utan att ändra det aktuella innehållet.

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

Parametrar	Beskrivning
`filename`	Namnet på filen som ska läggas till som en sträng. Filnamnet måste innehålla filändelsen.
`buffer`	En bytearray som innehåller de data som ska läggas till.

# 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 visar en bitmappsbild (BMP) som är lagrad på SD-kortet.

.bmp -filer är begränsade till 5120 pixlar och 6 KB i storlek.

Obs! V5 Brain stöder endast visning av .bmp filer. 8-bitars RLE-kodning rekommenderas för att minimera filstorleken.

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

Parametrar	Beskrivning
`filename`	Bildens filnamn.
`x`	X-koordinaten för bildens övre vänstra hörn på skärmen.
`y`	Y-koordinaten för bildens övre vänstra hörn på skärmen.

# 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 returnerar ett booleskt värde som anger om ett SD-kort för närvarande är isatt i Brain.

True - Hjärnan har ett SD-kort isatt.
False - Hjärnan har inget SD-kort isatt.

Usage:
brain.sdcard.is_inserted()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

# 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 returnerar filstorleken i byte.

Usage:
brain.sdcard.filesize(filename)

Parametrar	Beskrivning
`filename`	Filnamnet som en sträng. Filnamnet måste innehålla filändelsen.

# 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 returnerar filens storlek i byte.

Usage:
brain.sdcard.size(filename)

Parametrar	Beskrivning
`filename`	Filnamnet som en sträng. Filnamnet måste innehålla filändelsen.

# 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 returnerar ett booleskt värde som anger om en fil finns på SD-kortet.

True - Filen finns på SD-kortet.
False - Filen finns inte på SD-kortet.

Usage:
brain.sdcard.exists(filename)

Parametrar	Beskrivning
`filename`	Filnamnet som en sträng. Filnamnet måste innehålla filändelsen.

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