třída SDCard – ovladač SD / MMC karty#

Třída SDCard ovládá slot pro SD / MMC kartu na kamerách OpenMV, které jej mají. Ovladač implementuje rozhraní vfs.AbstractBlockDev, takže jej lze předat přímo funkci vfs.mount()

import machine
import vfs

sd = machine.SDCard()
vfs.mount(sd, "/sd")

Poznámka

Firmware OpenMV automaticky připojí SD kartu při startu, takže většina skriptů nikdy nevytváří objekt SDCard přímo – jednoduše čtou a zapisují přes automaticky připojenou cestu. Vytvořte jej ručně pouze tehdy, když potřebujete jiný než výchozí přípojný bod nebo přímý blokový přístup přes readblocks() / writeblocks() / ioctl().

Na OpenMV Cam M7 / H7 / H7 Plus / Pure Thermal / N6 je slot řízen integrovaným řadičem SDMMC v čipu STM32 v 4bitovém SD režimu. Na OpenMV Cam RT1062 je slot řízen řadičem USDHC čipu i.MX RT, rovněž v 4bitovém SD režimu. Na žádné aktuální desce OpenMV nejsou potřeba žádné argumenty pro multiplexování pinů – ovladač zná zapojení desky.

Není dostupné na OpenMV Cam AE3 (port alif).

Konstruktory#

class machine.SDCard(id: int = 1) → SDCard#

Vrátí singleton SDCard pro SD slot identifikovaný pomocí id. id je akceptováno kvůli kompatibilitě napříč porty, ale porty podporované OpenMV vystavují pouze jeden slot; předejte 1 nebo jej vynechte.

Na STM32 konstruktor nepřijímá vůbec žádné argumenty; na mimxrt je argument id akceptován, ale platná je pouze hodnota 1.

Metody#

present() → bool#

Vrátí True, pokud je ve slotu aktuálně detekována karta, jinak False.

Na deskách, které zapojují signál detekce karty, metoda odráží tento signál v reálném čase, takže ji lze po vytvoření objektu SDCard periodicky dotazovat a reagovat na vložení / vyjmutí karty za chodu. Na deskách bez signálu detekce karty je hodnota uzamčena v okamžiku vytvoření – hlásí výsledek počáteční sondy CMD0, kterou ovladač provedl při vytvoření objektu, a karta vložená za chodu poté nebude viditelná, dokud nebude objekt znovu vytvořen (nebo na mimxrt zavolána metoda init()).

info() → tuple[int, int, int]#

Vrátí trojici (3-tuple) popisující aktuálně vloženou kartu:

  • [0] num_blocks – celková kapacita v 512bajtových blocích. Vynásobte 512 pro získání kapacity v bajtech.

  • [1] block_size – pro SD karty vždy 512. Zahrnuto, aby volající mohli přenositelně provést num_blocks * block_size.

  • [2] card_type – typ karty hlášený SD sběrnicí během inicializačního handshaku CMD8 / OCR. Typické hodnoty jsou 0 (SDSC – standardní kapacita), 0x40 (SDHC / SDXC – vysoká / rozšířená kapacita) a 0x80 (MMC).

Užitečné pro ověření, že byla karta rozpoznána, nebo pro zobrazení údajů o volném místě vzhledem k celkové kapacitě.

power(state: bool, /) → None#

Zapne nebo vypne napájecí větev slotu karty. Firmware STM32 metodu vystavuje, ale žádná aktuální OpenMV Cam nereguluje napájení SD karty, takže volání je fakticky bez efektu. Ponecháno kvůli kompatibilitě s kódem původně napsaným pro referenční desky STM32 z hlavního proudu MicroPython. Pouze port STM32.

read(block_num: int, /) → bytes#

Přečte jeden 512bajtový blok z karty a vrátí jej jako nově alokovaný objekt bytes.

Toto je starší čtení jednoho bloku dodávané portem STM32. Nový kód by měl místo toho používat readblocks() – tato metoda funguje na každém portu OpenMV, umí přečíst libovolný počet souvislých bloků v jednom přenosu a vyhýbá se alokaci při každém volání tím, že zapisuje do bufferu dodaného volajícím. Pouze port STM32.

write(block_num: int, data: bytes, /) → None#

Zapíše jeden 512bajtový blok na kartu. data musí mít přesně 512 bajtů.

Toto je starší zápis jednoho bloku dodávaný portem STM32; nový kód by měl místo toho používat writeblocks(), který funguje na každém portu OpenMV a umí zapsat libovolný počet souvislých bloků na jedno volání. Pouze port STM32.

readblocks(block_num: int, buf: bytearray) → None#
readblocks(block_num: int, buf: bytearray, offset: int) → None

Přečte z karty surová data zarovnaná na bloky do buf. Standardní vstupní bod blokového zařízení vfs.AbstractBlockDev používaný vrstvou souborového systému.

Jednoduchá forma (readblocks(block_num, buf)): přečte celé bloky počínaje indexem bloku block_num. len(buf) musí být násobkem velikosti SD bloku (512 bajtů).

Rozšířená forma (readblocks(block_num, buf, offset)): přečte len(buf) bajtů – ne nutně celý počet bloků – počínaje bajtem offset v rámci bloku block_num. Používá se v littlefs a dalších bajtově adresovatelných souborových systémech.

writeblocks(block_num: int, buf: bytes | bytearray) → None#
writeblocks(block_num: int, buf: bytes | bytearray, offset: int) → None

Zapíše surová data zarovnaná na bloky z buf na kartu. Standardní vstupní bod blokového zařízení vfs.AbstractBlockDev používaný vrstvou souborového systému.

Jednoduchá forma (writeblocks(block_num, buf)): zapíše celé bloky počínaje indexem bloku block_num. len(buf) musí být násobkem velikosti SD bloku (512 bajtů). Každý dotčený blok je přepsán celý.

Rozšířená forma (writeblocks(block_num, buf, offset)): zapíše len(buf) bajtů – ne nutně celý počet bloků – počínaje bajtem offset v rámci bloku block_num. Používá se v littlefs a dalších bajtově adresovatelných souborových systémech.

ioctl(cmd: int, arg: int) → int | None#

Standardní řídicí vstupní bod vfs.AbstractBlockDev. Volán vrstvou souborového systému při připojení/odpojení a při každé synchronizaci. Rozpoznané hodnoty cmd jsou:

  • 1 – inicializace. Při úspěchu vrátí 0.

  • 2 – deinicializace. Při úspěchu vrátí 0.

  • 3 – synchronizace všech čekajících zápisů. Vrací 0 (ovladač SDMMC zapisuje synchronně, není co vyprázdnit).

  • 4 – vrátí počet bloků na zařízení.

  • 5 – vrátí velikost jednoho bloku (vždy 512).

  • 6 – vymaže blok (na SD bez efektu, ponecháno kvůli kontraktu vfs.AbstractBlockDev).

  • 7 – vrátí, zda zařízení podporuje mazání bloků (na SD 0).

Přímí volající tuto metodu obvykle nepoužívají – ovladač souborového systému automaticky odbavuje všechny standardní kódy, jakmile je SDCard připojena.

init(*args, **kwargs) → None#

Znovu inicializuje SD rozhraní od základu. Přijímá stejné argumenty jako konstruktor. Užitečné pro opětovnou detekci karty vložené za chodu na deskách bez signálu detekce karty, protože present() je jinak uzamčeno v okamžiku vytvoření. Pouze port mimxrt.

deinit() → None#

Deinicializuje SD rozhraní, uvolní řadič SDMMC/USDHC a IO piny, které si nárokoval. Objekt SDCard se stane nepoužitelným, dokud nebude znovu zavolána metoda init(). Použijte jej před opětovným naplněním karty z jiného rozhraní nebo pro odpojení napájení slotu v aplikaci napájené z baterie. Pouze port mimxrt.