Kartu SD#

Perkenalan #

Menggunakan kartu SD dengan VEX V5 memungkinkan Anda untuk menyimpan dan mengakses file pada kartu SD yang dapat dilepas yang dimasukkan ke dalam slot kartu SD Brain. Baik Anda menyimpan data sensor atau memuat gambar khusus, metode ini memberikan kendali penuh atas operasi file. Kartu SD yang dapat dilepas memungkinkan Anda untuk dengan mudah mentransfer data antara Brain dan komputer Anda.

V5 Brain membutuhkan kartu SD dengan kapasitas maksimal 32GB, yang diformat sebagai FAT32. Kartu SD dengan kapasitas lebih dari 32GB menggunakan format exFAT secara default, yang tidak kompatibel dengan V5 Brain. Pastikan kartu SD Anda telah diformat dengan benar ke FAT32 sebelum digunakan.

Semua file harus ditempatkan di folder root kartu SD agar dapat diakses.

Untuk contoh-contoh di bawah ini, Brain yang dibangun mencakup akses ke metode kartu SD dan akan digunakan di semua contoh selanjutnya di seluruh dokumentasi API ini ketika merujuk pada metode-metode tersebut.

Berikut adalah daftar semua metode:

Aksi – Melakukan operasi file dan menampilkan gambar dari kartu SD.

loadfile – Memuat file dari kartu SD ke dalam bytearray.
savefile – Menyimpan array byte ke kartu SD.
appendfile – Menambahkan array byte ke file yang sudah ada.
draw_image_from_file – Menampilkan Gambar Bitmap dari kartu SD.

Pengambil – Mengembalikan kartu SD dan informasi file.

is_inserted – Mengembalikan nilai Boolean yang menunjukkan apakah kartu SD dimasukkan ke dalam Brain.
filesize – Mengembalikan ukuran file dalam byte.
size – Mengembalikan ukuran file dalam byte.
exists – Mengembalikan nilai Boolean yang menunjukkan apakah sebuah file ditemukan di kartu SD.

Untuk informasi mengenai cara membangun Brain untuk mendapatkan akses ke metode sdcard , lihat Brain.

Tindakan #

loadfile #

loadfile memuat file dari kartu SD ke dalam bytearray.

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

Parameter	Keterangan
`filename`	Nama file yang akan dimuat sebagai string. Nama file harus menyertakan ekstensi file.
`buffer`	Opsional. Sebuah bytearray yang sudah ada untuk memuat konten file. Jika bytearray yang sudah ada lebih besar, isinya akan ditimpa. Jika bytearray yang sudah ada lebih kecil, metode ini mungkin tidak memuat semua data. Secara default, bytearray baru akan dikembalikan jika tidak ada buffer yang disediakan.

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

Perintah savefile menyimpan array byte ke kartu SD.

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

Parameter	Keterangan
`filename`	Nama file yang akan disimpan sebagai string. Nama file harus menyertakan ekstensi file. Jika file sudah ada, file tersebut akan ditimpa. Jika file belum ada, file baru akan dibuat.
`buffer`	Opsional. Sebuah bytearray untuk ditulis ke dalam file.

# 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 menambahkan array byte ke file yang sudah ada, menambahkan data baru ke akhir file tanpa mengubah isi file saat ini.

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

Parameter	Keterangan
`filename`	Nama file yang akan ditambahkan sebagai string. Nama file harus menyertakan ekstensi file.
`buffer`	Sebuah bytearray yang berisi data yang akan ditambahkan.

# 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 menampilkan Gambar Bitmap (BMP) yang tersimpan di kartu SD.

File .bmp dibatasi hingga 5120 piksel dan berukuran 6KB.

Catatan: V5 Brain hanya mendukung tampilan .bmp Pengkodean RLE 8-bit direkomendasikan untuk meminimalkan ukuran file.

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

Parameter	Keterangan
`filename`	Nama file gambar tersebut.
`x`	Koordinat x untuk sudut kiri atas gambar di layar.
`y`	Koordinat y untuk sudut kiri atas gambar di layar.

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

Pencari #

is_inserted #

is_inserted mengembalikan nilai Boolean yang menunjukkan apakah kartu SD saat ini terpasang di Brain.

True - Otak memiliki kartu SD yang terpasang.
False - Otak tidak memiliki kartu SD yang terpasang.

Usage:
brain.sdcard.is_inserted()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

# 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 mengembalikan ukuran file dalam byte.

Usage:
brain.sdcard.filesize(filename)

Parameter	Keterangan
`filename`	Nama file berupa string. Nama file harus menyertakan ekstensi file.

# 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 mengembalikan ukuran file dalam byte.

Usage:
brain.sdcard.size(filename)

Parameter	Keterangan
`filename`	Nama file berupa string. Nama file harus menyertakan ekstensi file.

# 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 mengembalikan nilai Boolean yang menunjukkan apakah file ditemukan di kartu SD.

True - File tersebut ada di kartu SD.
False - File tidak ada di kartu SD.

Usage:
brain.sdcard.exists(filename)

Parameter	Keterangan
`filename`	Nama file berupa string. Nama file harus menyertakan ekstensi file.

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