Cárta SD#

Réamhrá #

Trí chárta SD le VEX EXP a úsáid, is féidir leat comhaid a stóráil agus rochtain a fháil orthu ar chárta SD inbhainte atá curtha isteach i sliotán cárta SD an Brain. Cibé an bhfuil tú ag sábháil sonraí braiteora nó ag luchtú íomhánna saincheaptha, cuireann na modhanna seo smacht iomlán ar fáil ar oibríochtaí comhad. Ligeann an cárta SD inbhainte duit sonraí a aistriú go héasca idir do Brain agus ríomhaire.

Éilíonn an EXP Brain cárta SD nach mó ná 32GB, agus é formáidithe mar FAT32. Úsáideann cártaí SD atá níos mó ná 32GB formáidiú exFAT de réir réamhshocraithe, rud nach bhfuil comhoiriúnach leis an EXP Brain. Cinntigh go bhfuil do chárta SD formáidithe i gceart go FAT32 roimh úsáid.

Ní mór gach comhad a chur i bhfillteán fréimhe an chárta SD le go mbeidh rochtain orthu.

Maidir leis na samplaí thíos, áirítear leis an Inchinn thógtha rochtain ar na modhanna cárta SD agus úsáidfear é i ngach sampla ina dhiaidh sin ar fud an doiciméid API seo agus tagairt á déanamh do na modhanna sin.

Seo thíos liosta de na modhanna uile:

Gníomhartha — Déan oibríochtaí comhaid agus taispeáin íomhánna ón gcárta SD.

loadfile — Luchtaíonn sé ábhar comhaid ón gcárta SD isteach i maolán cuimhne arna sholáthar ag an úsáideoir.
savefile — Sábhálann sé sonraí ó mhaolán arna sholáthar ag an úsáideoir chuig comhad ar chárta SD an EXP Brain.
appendfile — Cuireann sé seo sonraí ó mhaolán arna sholáthar ag an úsáideoir le deireadh comhaid atá ann cheana féin ar chárta SD an EXP Brain.
draw_image_from_file — Taispeánann sé Íomhá Giotánmhapa ón gcárta SD.

Getters — Faisnéis faoi chárta SD agus comhaid a thabhairt ar ais.

is_inserted — Tugann sé seo ar ais an bhfuil cárta SD curtha isteach sa Brain.
filesize — Tugann sé seo méid comhaid ar ais.
size — Tugann sé seo méid comhaid ar ais.
exists — Tugann sé seo le fios an bhfuil comhad le fáil ar an gcárta SD.

Gníomhartha #

loadfile #

loadfile lódálann sé comhad ón gcárta SD isteach i bytearray.

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

Paraiméadair	Cur síos
`filename`	Ainm an chomhaid atá le luchtú mar theaghrán. Caithfidh síneadh an chomhaid a bheith san áireamh in ainm an chomhaid.
`buffer`	Roghnach. Eagar byte atá ann cheana féin chun ábhar an chomhaid a luchtú isteach ann. Má tá an t-eagar byte atá ann cheana féin níos mó, déanfar a ábhar a athscríobh. Má tá an t-eagar byte atá ann cheana féin níos lú, b’fhéidir nach luchtóidh an modh na sonraí go léir. De réir réamhshocraithe, cuirfear eagar byte nua ar ais mura gcuirtear maolán ar fáil.

# 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 bytearray isteach sa chárta SD.

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

Paraiméadair	Cur síos
`filename`	Ainm an chomhaid atá le sábháil mar theaghrán. Caithfidh síneadh an chomhaid a bheith san áireamh in ainm an chomhaid. Má tá an comhad ann cheana féin, déanfar é a athscríobh. Mura bhfuil an comhad ann, cruthófar comhad nua.
`buffer`	Roghnach. Eagarán le scríobh isteach sa chomhad.

# 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 Cuireann bytearray le comhad atá ann cheana féin, ag cur sonraí nua le deireadh an chomhaid gan an t-ábhar reatha a athrú.

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

Paraiméadair	Cur síos
`filename`	Ainm an chomhaid atá le cur leis mar theaghrán. Caithfidh síneadh an chomhaid a bheith san áireamh in ainm an chomhaid.
`buffer`	Bytearray ina bhfuil na sonraí le cur leis.

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

Taispeánann draw_image_from_file Íomhá Giotánmhapa (BMP) atá stóráilte ar an gcárta SD.

Tá teorainn 5120 picteilín agus 6KB ar chomhaid .bmp.

Nóta: Ní thacaíonn an EXP Brain ach le taispeáint .bmp chomhad. Moltar ionchódú RLE 8-giotán chun méid an chomhaid a íoslaghdú.

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

Paraiméadair	Cur síos
`filename`	Ainm comhaid na híomhá.
`x`	An comhordanáid x don chúinne uachtarach ar chlé den íomhá ar an scáileán.
`y`	An comhordanáid y don chúinne uachtarach ar chlé den íomhá ar an scáileán.

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

Faighteoirí #

is_inserted #

Tugann is_inserted luach Booleach ar ais a léiríonn an bhfuil cárta SD curtha isteach sa Brain faoi láthair.

True — Tá cárta SD curtha isteach san inchinn.
False — Níl cárta SD curtha isteach san inchinn.

Usage:
brain.sdcard.is_inserted()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# 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 tugann méid comhaid i mbéiteanna ar ais mar dheachúil (snámhphointe).

Usage:
brain.sdcard.filesize(filename)

Paraiméadair	Cur síos
`filename`	Ainm an chomhaid mar theaghrán. Caithfidh síneadh an chomhaid a bheith san áireamh in ainm an chomhaid.

# 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 seolann méid comhaid i mbéiteanna mar dheachúil (snámhphointe).

Usage:
brain.sdcard.size(filename)

Paraiméadair	Cur síos
`filename`	Ainm an chomhaid mar theaghrán. Caithfidh síneadh an chomhaid a bheith san áireamh in ainm an chomhaid.

# 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 luach Booleach ar ais a léiríonn an bhfuil comhad le fáil ar an gcárta SD.

True — Tá an comhad ar an gcárta SD.
False — Níl an comhad ar an gcárta SD.

Usage:
brain.sdcard.exists(filename)

Paraiméadair	Cur síos
`filename`	Ainm an chomhaid mar theaghrán. Caithfidh síneadh an chomhaid a bheith san áireamh in ainm an chomhaid.

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