`storage` – 存储管理¶

所述 storage 提供存储管理功能，例如安装和卸下其通常由操作系统托管的Python处理。CircuitPython 没有操作系统，因此该模块直接提供此功能。

在这些板上可用

8086 Commander
@sarfata shIRtty
ARAMCON Badge 2019
ARAMCON2 Badge
ATMegaZero ESP32-S2
Adafruit BLM Badge
Adafruit CLUE nRF52840 Express
Adafruit Circuit Playground Bluefruit
Adafruit Circuit Playground Express 4-H
Adafruit CircuitPlayground Express
Adafruit CircuitPlayground Express with Crickit libraries
Adafruit CircuitPlayground Express with displayio
Adafruit EdgeBadge
Adafruit Feather Bluefruit Sense
Adafruit Feather M0 Adalogger
Adafruit Feather M0 Basic
Adafruit Feather M0 Express
Adafruit Feather M0 Express with Crickit libraries
Adafruit Feather M0 RFM69
Adafruit Feather M0 RFM9x
Adafruit Feather M4 CAN
Adafruit Feather M4 Express
Adafruit Feather MIMXRT1011
Adafruit Feather RP2040
Adafruit Feather STM32F405 Express
Adafruit Feather nRF52840 Express
Adafruit FunHouse
Adafruit Gemma M0
Adafruit Gemma M0 PyCon 2018
Adafruit Grand Central M4 Express
Adafruit Hallowing M4 Express
Adafruit ItsyBitsy M0 Express
Adafruit ItsyBitsy M4 Express
Adafruit ItsyBitsy RP2040
Adafruit ItsyBitsy nRF52840 Express
Adafruit LED Glasses Driver nRF52840
Adafruit Macropad RP2040
Adafruit MagTag
Adafruit Matrix Portal M4
Adafruit Metro ESP32S2
Adafruit Metro M0 Express
Adafruit Metro M4 Airlift Lite
Adafruit Metro M4 Express
Adafruit Metro nRF52840 Express
Adafruit Monster M4SK
Adafruit NeoKey Trinkey M0
Adafruit NeoPixel Trinkey M0
Adafruit ProxLight Trinkey M0
Adafruit PyGamer
Adafruit PyPortal
Adafruit PyPortal Pynt
Adafruit PyPortal Titano
Adafruit PyRuler
Adafruit Pybadge
Adafruit QT Py M0
Adafruit QT Py M0 Haxpress
Adafruit QT Py RP2040
Adafruit QT2040 Trinkey
Adafruit Rotary Trinkey M0
Adafruit Slide Trinkey M0
Adafruit Trellis M4 Express
Adafruit Trinket M0
AloriumTech Evo M51
Arduino MKR Zero
Arduino MKR1300
Arduino Nano 33 BLE
Arduino Nano 33 IoT
Arduino Nano RP2040 Connect
Arduino Zero
Artisense Reference Design RD00
AtelierDuMaker nRF52840 Breakout
BDMICRO VINA-D21
BDMICRO VINA-D51
BLE-SS dev board Multi Sensor
BastBLE
BastWiFi
BlueMicro840
CP Sapling M0
CP Sapling M0 w/ SPI Flash
CP32-M4
Capable Robot Programmable USB Hub
Cedar Grove StringCar M0 Express
Challenger RP2040 WiFi
Circuit Playground Express Digi-Key PyCon 2019
CircuitBrains Basic
CircuitBrains Deluxe
CrumpS2
Cytron Maker Pi RP2040
DynOSSAT-EDU-EPS
DynOSSAT-EDU-OBC
DynaLoRa_USB
ESP 12k NodeMCU
Electronic Cats Bast Pro Mini M0
Electronic Cats CatWAN USBStick
Electronic Cats Hunter Cat NFC
Electronic Cats NFC Copy Cat
Electronut Labs Blip
Electronut Labs Papyr
EncoderPad RP2040
Escornabot Makech
Espruino Pico
Espruino Wifi
Feather ESP32S2 without PSRAM
Feather MIMXRT1011
Feather MIMXRT1062
FeatherS2
FeatherS2 Neo
FeatherS2 PreRelease
Fluff M0
Fomu
Franzininho WIFI w/Wroom
Franzininho WIFI w/Wrover
Gravitech Cucumber M
Gravitech Cucumber MS
Gravitech Cucumber R
Gravitech Cucumber RS
HMI-DevKit-1.1
Hacked Feather M0 Express with 8Mbyte SPI flash
HalloWing M0 Express
HiiBot BlueFi
IMXRT1010-EVK
IkigaiSense Vita nRF52840
J&J Studios datum-Distance
J&J Studios datum-IMU
J&J Studios datum-Light
J&J Studios datum-Weather
Kaluga 1
LILYGO TTGO T8 ESP32-S2 w/Display
LoC BeR M4 base board
MDBT50Q-DB-40
MDBT50Q-RX Dongle
MEOWBIT
MORPHEANS MorphESP-240
MakerDiary nRF52840 MDK
MakerDiary nRF52840 MDK USB Dongle
Makerdiary M60 Keyboard
Makerdiary Pitaya Go
Makerdiary nRF52840 M.2 Developer Kit
Melopero Shake RP2040
Meow Meow
Metro MIMXRT1011
Mini SAM M4
NUCLEO STM32F746
NUCLEO STM32F767
NUCLEO STM32H743
OPENMV-H7 R1
Oak Dev Tech BREAD2040
Oak Dev Tech PixelWing ESP32S2
Open Hardware Summit 2020 Badge
PCA10056 nRF52840-DK
PCA10059 nRF52840 Dongle
PCA10100 nRF52833 Dongle
PYB LR Nano V2
Particle Argon
Particle Boron
Particle Xenon
PewPew 10.2
PewPew 13
PewPew M4
PicoPlanet
Pimoroni Interstate 75
Pimoroni Keybow 2040
Pimoroni PGA2040
Pimoroni Pico LiPo (16MB)
Pimoroni Pico LiPo (4MB)
Pimoroni PicoSystem
Pimoroni Plasma 2040
Pimoroni Tiny 2040
PyCubedv04
PyCubedv04-MRAM
PyCubedv05
PyCubedv05-MRAM
PyKey60
PyboardV1_1
Raspberry Pi Pico
Robo HAT MM1 M4
S2Mini
SAM E54 Xplained Pro
SAM32v26
SPRESENSE
ST STM32F746G Discovery
STM32F411E_DISCO
STM32F412G_DISCO
STM32F4_DISCO
Saola 1 w/Wroom
Saola 1 w/Wrover
Seeeduino Wio Terminal
Seeeduino XIAO
Serpente
Silicognition LLC M4-Shim
Simmel
SparkFun LUMIDrive
SparkFun MicroMod RP2040 Processor
SparkFun MicroMod SAMD51 Processor
SparkFun MicroMod nRF52840 Processor
SparkFun Pro Micro RP2040
SparkFun Pro nRF52840 Mini
SparkFun Qwiic Micro
SparkFun RedBoard Turbo
SparkFun SAMD21 Dev Breakout
SparkFun SAMD21 Mini Breakout
SparkFun STM32 MicroMod Processor
SparkFun Thing Plus - RP2040
SparkFun Thing Plus - SAMD51
Sprite_v2b
StackRduino M0 PRO
TG-Boards' Datalore IP M4
TG-Watch
THUNDERPACK_v11
THUNDERPACK_v12
Targett Module Clip w/Wroom
Targett Module Clip w/Wrover
Teensy 4.0
Teensy 4.1
Teknikio Bluebird
The Open Book Feather
TinkeringTech ScoutMakes Azul
TinyS2
Trinket M0 Haxpress
UARTLogger II
WarmBit BluePixel nRF52840
Winterbloom Big Honking Button
Winterbloom Sol
XinaBox CC03
XinaBox CS11
iMX RT 1020 EVK
iMX RT 1060 EVK
keithp.com snekboard
micro:bit v2
microS2
nanoESP32-S2 w/Wrover
nanoESP32-S2 w/Wroom
ndGarage[n°] Bit6: FeatherSnow-v2
ndGarage[n°]Bit6:FeatherSnow
nice!nano
senseBox MCU
stm32f411ce-blackpill
stm32f411ce-blackpill-with-flash
uChip
uGame10

storage.mount(filesystem: VfsFat, mount_path: str, *, readonly: bool = False) → None ¶

在给定的路径上挂载给定的文件系统对象。

这是类似于 UNIX mount命令的 CircuitPython 。

参数: readonly (bool) – 当文件系统应该对 CircuitPython 只读时为真。

storage.umount(mount: Union[str, VfsFat]) → None ¶

卸载给定的文件系统对象，或者如果mount是路径，则卸载安装在该位置的文件系统。

这是类似于 UNIX umount 命令的 CircuitPython 。

storage.remount(mount_path: str, readonly: bool = False, *, disable_concurrent_write_protection: bool = False) → None ¶

使用新参数重新安装给定路径。

参数

readonly (bool) – 当文件系统应该对 CircuitPython 只读时为真。
disable_concurrent_write_protection (bool) – 当为 True 时，确保底层文件系统数据由一台计算机写入的检查被禁用。禁用保护允许 CircuitPython 和主机写入同一个文件系统，但存在文件系统损坏的风险。

storage.getmount(mount_path: str) → VfsFat ¶: 检索与挂载路径关联的挂载对象

storage.erase_filesystem() → None ¶

擦除并重新创建 CIRCUITPY 文件系统。

在提供 USB 可见CIRCUITPY驱动器的板上（例如，SAMD21 和 SAMD51），然后调用microcontroller.reset() 重新启动 CircuitPython 并让主机重新安装 CIRCUITPY。

这个函数可以在被CIRCUITPY 损坏时从 REPL 调用。

警告

所有数据 CIRCUITPY都将丢失，并且 CircuitPython 将在某些板上重新启动。

storage.disable_usb_drive() → None ¶: 禁用CIRCUITPY 作为 USB 大容量存储设备呈现。默认情况下，设备已启用且CIRCUITPY可见。可以在boot.py，USB 连接之前调用。

storage.enable_usb_drive() → None ¶

启用CIRCUITPY作为 USB 大容量存储设备呈现。默认情况下，设备已启用且 CIRCUITPY可见，因此您通常不需要调用此函数。可以在boot.py，USB 连接之前调用。

如果您一次启用太多设备，您将耗尽 USB 端点。可用端点的数量因微控制器而异。CircuitPython 将在运行 boot.py 后进入安全模式，以通知您是否没有足够的端点可用。

class storage.VfsFat(block_device: str)¶

在给定的块设备周围创建一个新的 VfsFat 文件系统。

参数: block_device – 文件系统所在的块设备

label :str¶: 文件系统标签，最多 11 个不区分大小写的字节。请注意，只有当设备可被微控制器写入时，才能设置此属性。

mkfs(self) → None ¶: 格式化块设备，删除可能存在的所有数据

open(self, path: str, mode: str) → None ¶: 类似内置 open()

ilistdir(self, path: str) → Iterator[Union[Tuple[AnyStr, int, int, int], Tuple[AnyStr, int, int]]]¶: 返回一个迭代器，其值描述其中的文件和文件夹 path

mkdir(self, path: str) → None ¶: 类似 os.mkdir

rmdir(self, path: str) → None ¶: 类似 os.rmdir

stat(self, path: str) → Tuple[int, int, int, int, int, int, int, int, int, int]¶: 类似os.stat

statvfs(self, path: int) → Tuple[int, int, int, int, int, int, int, int, int, int]¶: 类似os.statvfs

mount(self, readonly: bool, mkfs: VfsFat) → None ¶: 不要直接调用这个，调用storage.mount.

umount(self) → None ¶: 不要直接调用这个，调用storage.umount.

storage – 存储管理¶

`storage` – 存储管理¶