การ์ด SD#

การแนะนำ#

การใช้การ์ด SD ร่วมกับ VEX V5 ช่วยให้คุณสามารถจัดเก็บและเข้าถึงไฟล์บนการ์ด SD แบบถอดได้ที่เสียบอยู่ในช่องเสียบการ์ด SD ของ Brain ไม่ว่าคุณจะบันทึกข้อมูลเซ็นเซอร์หรือโหลดภาพที่กำหนดเอง วิธีการเหล่านี้ช่วยให้คุณควบคุมการทำงานของไฟล์ได้อย่างเต็มที่ การ์ด SD แบบถอดได้ช่วยให้คุณถ่ายโอนข้อมูลระหว่าง Brain และคอมพิวเตอร์ได้อย่างง่ายดาย

V5 Brain ต้องการการ์ด SD ที่มีขนาดไม่เกิน 32GB และฟอร์แมตเป็น FAT32 การ์ด SD ที่มีขนาดใหญ่กว่า 32GB จะใช้การฟอร์แมตแบบ exFAT เป็นค่าเริ่มต้น ซึ่งไม่สามารถใช้งานร่วมกับ V5 Brain ได้ โปรดตรวจสอบให้แน่ใจว่าการ์ด SD ของคุณได้รับการฟอร์แมตเป็น FAT32 อย่างถูกต้องก่อนใช้งาน

ไฟล์ทั้งหมดต้องอยู่ในโฟลเดอร์หลักของ SD การ์ดจึงจะสามารถเข้าถึงได้

สำหรับตัวอย่างด้านล่าง สมองที่สร้างขึ้น รวมถึงการเข้าถึงวิธีการของการ์ด SD และจะถูกใช้ในตัวอย่างต่อๆ ไปทั้งหมดในเอกสาร API นี้เมื่ออ้างถึงวิธีการเหล่านั้น

ด้านล่างนี้คือรายการวิธีการทั้งหมด:

การดำเนินการ – ดำเนินการกับไฟล์และแสดงภาพจาก SD การ์ด

  • loadfile – โหลดไฟล์จากการ์ด SD ลงในอาร์เรย์ไบต์

  • savefile – บันทึกไบต์อาร์เรย์ลงในการ์ด SD

  • appendfile – เพิ่มอาร์เรย์ไบต์ลงในไฟล์ที่มีอยู่

  • draw_image_from_file – แสดงภาพบิตแมปจากการ์ด SD

Getters – ส่งคืนข้อมูลการ์ด SD และไฟล์

  • is_inserted – ส่งคืนค่าบูลีนที่ระบุว่ามีการเสียบการ์ด SD เข้าไปใน Brain หรือไม่

  • filesize – ส่งคืนขนาดของไฟล์เป็นไบต์

  • size – ส่งคืนขนาดของไฟล์เป็นไบต์

  • exists – ส่งคืนค่าบูลีนที่ระบุว่าพบไฟล์บนการ์ด SD หรือไม่

สำหรับข้อมูลเกี่ยวกับการสร้างสมองเพื่อเข้าถึงเมธอด sdcard โปรดดู Brain

การกระทำ#

loadfile#

loadfile โหลดไฟล์จาก SD การ์ดลงในไบต์อาร์เรย์

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

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ที่จะโหลดในรูปแบบสตริง โดยชื่อไฟล์ต้องมีนามสกุลไฟล์ด้วย

buffer

ตัวเลือกเสริม: อาร์เรย์ไบต์ที่มีอยู่แล้วสำหรับโหลดเนื้อหาของไฟล์ หากอาร์เรย์ไบต์ที่มีอยู่มีขนาดใหญ่กว่า เนื้อหาจะถูกเขียนทับ หากอาร์เรย์ไบต์ที่มีอยู่มีขนาดเล็กกว่า เมธอดอาจโหลดข้อมูลไม่ครบ โดยค่าเริ่มต้น จะส่งคืนอาร์เรย์ไบต์ใหม่หากไม่มีการระบุบัฟเฟอร์

 
# 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 บันทึกอาร์เรย์ไบต์ลงในการ์ด SD

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

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ที่จะบันทึกเป็นสตริง ชื่อไฟล์ต้องมีนามสกุลไฟล์ด้วย หากไฟล์นั้นมีอยู่แล้ว ระบบจะเขียนทับไฟล์เดิม หากไฟล์นั้นไม่มีอยู่ ระบบจะสร้างไฟล์ใหม่

buffer

ตัวเลือกเสริม: อาร์เรย์ไบต์ที่จะเขียนลงในไฟล์

 
# 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 เพิ่มอาร์เรย์ไบต์ลงในไฟล์ที่มีอยู่ โดยเพิ่มข้อมูลใหม่ต่อท้ายไฟล์โดยไม่เปลี่ยนแปลงเนื้อหาปัจจุบัน

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

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ที่จะเพิ่มเข้าไปเป็นสตริง โดยชื่อไฟล์ต้องมีนามสกุลไฟล์ด้วย

buffer

อาร์เรย์ไบต์ที่ประกอบด้วยข้อมูลที่จะเพิ่มเข้าไป

 
# 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 แสดงภาพบิตแมป (BMP) ที่จัดเก็บไว้ใน SD การ์ด

ไฟล์ .bmp มีข้อจำกัดด้านความละเอียดสูงสุดที่ 5120 พิกเซล และขนาดไม่เกิน 6KB

หมายเหตุ: หน่วยประมวลผล V5 รองรับการแสดง .bmp ไฟล์เท่านั้น แนะนำให้ใช้การเข้ารหัส RLE 8 บิต เพื่อลดขนาดไฟล์ให้เหลือน้อยที่สุด

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

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ของรูปภาพ

x

ค่าพิกัด x สำหรับมุมบนซ้ายของภาพบนหน้าจอ

y

พิกัด y สำหรับมุมบนซ้ายของภาพบนหน้าจอ

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

ผู้รับ#

is_inserted#

is_inserted ส่งคืนค่าบูลีนที่ระบุว่ามีการเสียบการ์ด SD เข้ากับ Brain อยู่หรือไม่

  • True - สมองมีการเสียบการ์ด SD อยู่

  • False - สมองไม่ได้เสียบการ์ด SD ไว้

Usage:
brain.sdcard.is_inserted()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

 
# 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 ส่งคืนขนาดไฟล์เป็นไบต์

Usage:
brain.sdcard.filesize(filename)

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ในรูปแบบสตริง โดยชื่อไฟล์ต้องมีนามสกุลไฟล์ด้วย

 
# 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 ส่งคืนขนาดของไฟล์ในหน่วยไบต์

Usage:
brain.sdcard.size(filename)

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ในรูปแบบสตริง โดยชื่อไฟล์ต้องมีนามสกุลไฟล์ด้วย

 
# 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 ส่งคืนค่าบูลีนที่ระบุว่าพบไฟล์ใน SD การ์ดหรือไม่

  • True - ไฟล์อยู่ในการ์ด SD

  • False - ไฟล์ไม่ได้อยู่ในการ์ด SD

Usage:
brain.sdcard.exists(filename)

พารามิเตอร์

คำอธิบาย

filename

ชื่อไฟล์ในรูปแบบสตริง โดยชื่อไฟล์ต้องมีนามสกุลไฟล์ด้วย

 
# 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)
On this page