Kartu SD#

Perkenalan #

API kartu SD untuk VEX IQ (generasi ke-2) 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.

VEX IQ (generasi ke-2) 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 VEX IQ (generasi ke-2) 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.

Halaman ini menggunakan brain sebagai contoh nama Brain. Ganti dengan nama yang Anda konfigurasi sendiri sesuai kebutuhan.

Berikut adalah daftar semua metode:

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

loadfile — Memuat isi file dari kartu SD ke dalam buffer memori yang disediakan pengguna.
savefile — Menyimpan data dari buffer yang disediakan pengguna ke file di kartu SD IQ (generasi ke-2) Brain.
appendfile — Menambahkan data dari buffer yang disediakan pengguna ke akhir file yang ada di kartu SD IQ (generasi ke-2) Brain.
draw_image_from_file — Menampilkan Gambar Bitmap dari kartu SD.

Getter — Mengembalikan informasi kartu SD dan file.

is_inserted — Mengembalikan apakah kartu SD dimasukkan ke dalam Brain.
filesize — Mengembalikan ukuran sebuah file.
size — Mengembalikan ukuran sebuah file.
exists — Mengembalikan apakah sebuah file ditemukan di kartu SD.

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 dalam 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: IQ (generasi ke-2) Brain hanya mendukung tampilan .bmp Pengkodean RLE 8-bit disarankan 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 sebagai desimal (float).

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 sebagai desimal (float).

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