class Flash – yerleşik flash bellek depolamasına erişim#

Flash sınıfı, RP2040’ın harici QSPI flash yongasına doğrudan, blok düzeyinde erişim sağlar. Sürücü vfs.AbstractBlockDev arayüzünü uygular, böylece özel dosya sistemi yapılandırmaları için vfs.mount() işlevine geçirilebilir.

Çoğu betik, verileri / konumunda otomatik bağlanan dosya sistemi aracılığıyla kalıcı hale getirir ve hiçbir zaman doğrudan Flash oluşturmaz. Aşağıdakilere ihtiyaç duyduğunuzda elle bir tane oluşturun:

  • Özel bir bölümde varsayılan olmayan bir dosya sistemi bağlamak (ör. vfs.VfsFat ile sarmalamak).

  • Dosya sistemine ait olmayan aygıt yazılımı (firmware) bölgelerini veya fabrika verisi bloklarını okumak ya da yazmak.

  • Dosya sistemi katmanını atlayan özel bir flash üzeri depolama biçimi uygulamak.

Kurucular#

class rp2.Flash → Flash#

RP2040’ın QSPI flash yongasıyla desteklenen tekil (singleton) Flash blok aygıtı nesnesini döndürür. Sunulan ilk blok, aygıt yazılımı (firmware) bölgesinin hemen ardından gelen bloktur; böylece çağıranlar yongada yalnızca dosya sistemine uygun alanı görür.

Yöntemler#

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

Flash bellekten buf arabelleğine bayt okur. Dosya sistemi katmanı tarafından kullanılan standart vfs.AbstractBlockDev blok aygıtı giriş noktası.

Basit biçim (readblocks(block_num, buf)): block_num blok indeksinden başlayarak tam blokları okur. len(buf), flash blok boyutunun bir katı olmalıdır.

Genişletilmiş biçim (readblocks(block_num, buf, offset)): block_num bloğu içindeki offset baytından başlayarak len(buf) bayt okur – ki bu mutlaka tam sayıda blok değildir. littlefs ve bayt adreslenebilir diğer dosya sistemleri tarafından kullanılır.

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

buf arabelleğinden flash belleğe bayt yazar. Dosya sistemi katmanı tarafından kullanılan standart vfs.AbstractBlockDev blok aygıtı giriş noktası.

Basit biçim (writeblocks(block_num, buf)): block_num blok indeksinden başlayarak tam blokları yazar. len(buf), flash blok boyutunun bir katı olmalıdır. Etkilenen her blok yazılmadan önce otomatik olarak silinir.

Genişletilmiş biçim (writeblocks(block_num, buf, offset)): block_num bloğu içindeki offset baytından başlayarak len(buf) bayt yazar – ki bu mutlaka tam sayıda blok değildir. Örtük silme yapılmaz – çağıranın, etkilenen blokların önceki bir ioctl(6, block_num) çağrısıyla silinmiş olmasını sağlaması gerekir.

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

Standart vfs.AbstractBlockDev denetim giriş noktası. Dosya sistemi katmanı tarafından bağlama/ayırma anında ve her eşitlemede çağrılır. Tanınan cmd değerleri:

  • 1 – başlat. Başarı durumunda 0 döndürür.

  • 2 – sonlandır. Başarı durumunda 0 döndürür.

  • 3 – bekleyen yazmaları eşitle. 0 döndürür.

  • 4 – dosya sistemine görünür flash blok sayısını döndürür.

  • 5 – blok boyutunu bayt cinsinden döndürür (genellikle flash sektör boyutu, 4096).

  • 6 – arg indeksindeki bloğu siler. Genişletilmiş writeblocks biçimini kullanmadan önce gereklidir.

  • 7 – aygıtın blok silme komutunu destekleyip desteklemediğini döndürür (RP2040’ta 1).

Doğrudan çağıranlar normalde bu yöntemi kullanmaz – Flash bağlandıktan sonra dosya sistemi sürücüsü standart kodları otomatik olarak yönlendirir.