SD kortelė#

Įvadas#

Naudojant SD kortelę su „VEX V5“, galite saugoti ir pasiekti failus išimamoje SD kortelėje, įdėtoje į „Brain“ SD kortelės lizdą. Nesvarbu, ar išsaugote jutiklių duomenis, ar įkeliate pasirinktinius vaizdus, ​​šie metodai suteikia visišką failų operacijų kontrolę. Išimama SD kortelė leidžia lengvai perkelti duomenis tarp „Brain“ ir kompiuterio.

„V5 Brain“ reikalinga ne didesnė nei 32 GB talpos SD kortelė, suformatuota FAT32 formatu. Didesnės nei 32 GB SD kortelės pagal numatytuosius nustatymus naudoja „exFAT“ formatavimą, kuris nesuderinamas su „V5 Brain“. Prieš naudodami įsitikinkite, kad SD kortelė tinkamai suformatuota į FAT32.

Visi failai turi būti patalpinti SD kortelės šakniniame aplanke, kad būtų galima prie jų prisijungti.

Žemiau pateiktuose pavyzdžiuose constructed Brain apima prieigą prie SD kortelės metodų ir bus naudojamas visuose tolesniuose šios API dokumentacijos pavyzdžiuose, kai kalbama apie tuos metodus.

Žemiau pateikiamas visų metodų sąrašas:

Veiksmai – atlikti failų operacijas ir rodyti vaizdus iš SD kortelės.

  • loadfile – Įkelia failą iš SD kortelės į bytearray.

  • savefile – Įrašo baitų diską į SD kortelę.

  • appendfile – Prideda baitų masyvą prie esamo failo.

  • draw_image_from_file – Parodo bitmap vaizdą iš SD kortelės.

Getteriai – Grąžina SD kortelės ir failo informaciją.

  • is_inserted – Grąžina loginę reikšmę, nurodančią, ar į „Brain“ įrenginį įdėta SD kortelė.

  • filesize – Grąžina failo dydį baitais.

  • size – Grąžina failo dydį baitais.

  • exists – Grąžina loginę reikšmę, nurodančią, ar SD kortelėje rastas failas.

Informacijos apie „Brain“ sukonstravimą, kad būtų galima pasiekti sdcard metodus, žr. Brain.

Veiksmai#

loadfile#

loadfile įkelia failą iš SD kortelės į „bytearray“ diską.

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

Parametrai

Aprašymas

filename

Įkeliamo failo pavadinimas kaip eilutė. Failo pavadinime turi būti failo plėtinys.

buffer

Pasirinktinai. Esamas „bytearray“ masyvas, į kurį įkeliamas failo turinys. Jei esamas „bytearray“ masyvas yra didesnis, jo turinys bus perrašytas. Jei esamas „bytearray“ masyvas yra mažesnis, metodas gali neįkelti visų duomenų. Pagal numatytuosius nustatymus, jei nepateiktas buferis, bus grąžintas naujas „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")

savefile#

savefile išsaugo baitų failą SD kortelėje.

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

Parametrai

Aprašymas

filename

Failo, kurį reikia išsaugoti kaip eilutę, pavadinimas. Failo pavadinime turi būti failo plėtinys. Jei failas jau yra, jis bus perrašytas. Jei failo nėra, bus sukurtas naujas failas.

buffer

Pasirinktinai. Bytearray, skirtas įrašyti į failą.

# 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 prideda baitų masyvą (baitų masyvą) prie esamo failo, pridėdamas naujus duomenis failo pabaigoje nekeisdamas dabartinio turinio.

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

Parametrai

Aprašymas

filename

Failo, kurį reikia pridėti kaip eilutę, pavadinimas. Failo pavadinime turi būti failo plėtinys.

buffer

Baitų rinkinys, kuriame yra duomenys, kuriuos reikia pridėti.

# 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 rodo SD kortelėje saugomą bitmap vaizdą (BMP).

.bmp failų dydis ribojamas iki 5120 pikselių ir 6 KB.

Pastaba: „V5 Brain“ palaiko tik .bmp failų rodymą. Siekiant sumažinti failo dydį, rekomenduojama naudoti 8 bitų RLE kodavimą.

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

Parametrai

Aprašymas

filename

Vaizdo failo pavadinimas.

x

Viršutinio kairiojo vaizdo kampo ekrane x koordinatė.

y

Viršutinio kairiojo vaizdo kampo ekrane y koordinatė.

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

Getteriai#

is_inserted#

is_inserted grąžina loginę reikšmę, nurodančią, ar SD kortelė šiuo metu įdėta į „Brain“.

  • True – Smegenyse įdėta SD kortelė.

  • False – Smegenyse nėra įdėta SD kortelė.

Usage:
brain.sdcard.is_inserted()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

# 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 grąžina failo dydį baitais.

Usage:
brain.sdcard.filesize(filename)

Parametrai

Aprašymas

filename

Failo pavadinimas eilutėje. Failo pavadinime turi būti failo plėtinys.

# 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 grąžina failo dydį baitais.

Usage:
brain.sdcard.size(filename)

Parametrai

Aprašymas

filename

Failo pavadinimas eilutėje. Failo pavadinime turi būti failo plėtinys.

# 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 grąžina loginę reikšmę, nurodančią, ar SD kortelėje yra failas.

  • True – failas yra SD kortelėje.

  • False – Failo nėra SD kortelėje.

Usage:
brain.sdcard.exists(filename)

Parametrai

Aprašymas

filename

Failo pavadinimas eilutėje. Failo pavadinime turi būti failo plėtinys.

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