使用文件系统 内容 使用文件系统
5 O# m4 u/ O* h7 F$ d虚拟FS 块设备
X; f' \0 l, Q" L* K* z$ W. S内置块设备
* N, {# b' [) K- u `/ K2 b0 T! {自定义块设备
2 p9 x! v4 a6 I% x; M
文件系统 ' v) G5 ~# j7 U* v+ N$ h7 s/ s8 R/ H2 M
" L2 r( K+ N) W7 F7 | 5 w8 W1 a( f7 z; S. I5 k
4 [8 W# Q* v( i. l5 N. @本教程介绍 MicroPython 如何提供设备上的文件系统,允许将标准 Python 文件 I/O 方法与持久存储一起使用。 MicroPython 会自动创建默认配置并自动检测主文件系统,因此如果您想修改分区、文件系统类型或使用自定义块设备,本教程将非常有用。 文件系统通常由设备上的内部闪存支持,但也可以使用外部闪存、RAM 或自定义块设备。 在某些端口(例如 STM32)上,文件系统也可以通过 USB MSC 连接到主机 PC。pyboard.py 工具还为主机 PC 提供了一种访问所有端口上的文件系统的方法。 注意:这主要用于 STM32 和 ESP32 等裸机端口。在带有操作系统的端口(例如 Unix 端口)上,文件系统由主机操作系统提供。 虚拟FSMicroPython 实现了一个类 Unix 虚拟文件系统 (VFS) 层。所有挂载的文件系统都组合成一个单一的虚拟文件系统,从 root 开始 /。文件系统被挂载到这个结构的目录中,并且在启动时工作目录被更改为主文件系统被挂载的位置。 在 STM32/Pyboard 上,内部闪存安装在 /flash,可选的 SDCard安装在/sd。在 ESP8266/ESP32 上,主文件系统挂载在 /。 * c% _7 r9 z* |- u9 i
块设备块设备是实现 uos.AbstractBlockDev协议的类的实例 。 内置块设备端口提供内置块设备来访问它们的主闪存。 开机时,MicroPython 将尝试检测默认闪存上的文件系统并自动配置和挂载它。如果没有找到文件系统,MicroPython 将尝试创建一个跨越整个闪存的 FAT 文件系统。端口还可以提供一种机制来“恢复出厂设置”主闪存,通常是通过在开机时按下按钮的某种组合。 STM32 / Pyboard该pyb.Flash类,可以访问内部闪存。在一些具有较大外部闪存的板上(例如 Pyboard D),它将使用它来代替。该 startkwarg应始终指定,即 pyb.Flash(start=0)。 注意:为了向后兼容,当构造没有参数时(即 pyb.Flash()),它只实现简单的块接口并反映呈现给 USB MSC 的虚拟设备(即它在开始时包含一个虚拟分区表)。 - S# x% D. k9 R6 ~( g" y
ESP8266内部闪存作为块设备对象公开,该对象 flashbdev 在启动时在模块中创建 。默认情况下,此对象作为全局变量添加,因此通常可以简单地作为bdev. 这实现了扩展接口。 6 v( h& n0 ^: v8 Y
ESP32esp32.Partition类用于实现为板限定分区的块设备。与 ESP8266 一样,有一个全局变量 bdev指向默认分区。这实现了扩展接口。 * U+ Z' g+ e0 o5 M
4 \& u- }$ T$ `; ]自定义块设备以下类实现了一个简单的块设备,该设备使用以下命令将其数据存储在 RAM 中 bytearray: - class RAMBlockDev:, h! K2 `( |& i1 `1 u
- def __init__(self, block_size, num_blocks):6 @% K- N! m" B% n. m1 g
- self.block_size = block_size
- z' m, j& v/ X6 n9 v - self.data = bytearray(block_size * num_blocks)/ K7 T2 I0 W6 {$ E# r. s( ^; X
$ A" f- x' K: O' f6 l8 @- def readblocks(self, block_num, buf):
$ b7 ~- } _+ ^# W, a) f* v - for i in range(len(buf)):
6 M% P' ^3 G0 J( a* ]9 R - buf[i] = self.data[block_num * self.block_size + i]: \! X/ q, m! @/ N
- 7 I, x! ^) t2 a6 W2 ^
- def writeblocks(self, block_num, buf):" C, N8 V# @; q* q2 A+ _
- for i in range(len(buf)):. ~$ M2 \3 ~. T4 U
- self.data[block_num * self.block_size + i] = buf[i]
; o- ^4 b9 m: X( ~: J1 T' K
( N$ M1 l. d8 a1 k- ~7 l% r- def ioctl(self, op, arg):$ E6 o9 B% o+ `- K* c+ B4 G2 c
- if op == 4: # get number of blocks
+ F8 p2 R) W9 E: @/ a - return len(self.data) // self.block_size Y7 M4 ]. ^8 r& g/ ]
- if op == 5: # get block size
% V( u% ]1 b: g- o) j - return self.block_size
复制代码 K$ I: g$ n$ k5 x+ u, D, D. r
; Y4 i! ]" _# ^/ E# H; H i, X- B6 t- c% P. I2 y# ]- |
它可以按如下方式使用: - import os
. t5 {( J9 Z6 A8 q* n3 S- B9 A* r - : u8 B9 U3 {6 o" @* \" K; u. j3 ~
- bdev = RAMBlockDev(512, 50)7 t) ]7 u5 v' A1 q4 z" G7 J
- os.VfsFat.mkfs(bdev)
% w" M- n' v4 s, }$ Y, K0 x - os.mount(bdev, '/ramdisk')
复制代码 + b+ S& ~% S, `& A8 q
& N+ M7 T2 F7 `7 h2 a
( `+ o3 [+ t* f1 I3 ]( _6 w Y支持简单接口和扩展接口(即 uos.AbstractBlockDev.readblocks() 和 uos.AbstractBlockDev.writeblocks() 方法的签名和行为)的块设备的示例 是: - class RAMBlockDev:6 j. q* e# Q) J3 o5 Y5 H
- def __init__(self, block_size, num_blocks):
, W# ]* h1 i1 P0 \7 \& N$ C - self.block_size = block_size
( I; W% d) i+ e2 x1 s: W1 C9 p% ?. b - self.data = bytearray(block_size * num_blocks)' ^: Y: J! a# s, s
, P" I: v6 P6 R. `8 Q9 j4 v- def readblocks(self, block_num, buf, offset=0):: h4 w: @ B: u; H& k0 R
- addr = block_num * self.block_size + offset( D& |, i! t: `& z
- for i in range(len(buf)):+ B6 {) @% u8 B- k- f _
- buf[i] = self.data[addr + i]
# B. I# N1 P% O# u) X, j - & ^4 p! K; G2 K2 h: {6 z6 O7 a m0 W
- def writeblocks(self, block_num, buf, offset=None):
1 _6 b6 w. Q9 L0 a, M - if offset is None:
- \$ z1 S# O* Y( H - # do erase, then write
9 u1 a! u% Y5 Z7 y - for i in range(len(buf) // self.block_size):
" k+ H" Y8 ^( g& ` p* C3 k/ o - self.ioctl(6, block_num + i)2 H& |8 P* W! @( N. b% l/ z( V" V
- offset = 0
9 t6 U# Z: S9 M# M3 a& Z- v |/ w - addr = block_num * self.block_size + offset
C h0 S, z; a0 y - for i in range(len(buf)):
) ]" J8 {: N/ j: [# Y. N - self.data[addr + i] = buf[i]# B! T9 I0 D2 } Z
1 B8 h% A @2 ?& A6 k1 W! K- def ioctl(self, op, arg):) U# c6 z* K, Z* D3 P+ w0 b
- if op == 4: # block count
3 w9 h3 j. m; r) A* ^/ [ - return len(self.data) // self.block_size( w( D, d9 H- ^# U. Q4 t
- if op == 5: # block size& f9 u `7 i6 g2 C+ ^
- return self.block_size
7 F: s2 y; B1 s3 _2 j - if op == 6: # block erase# D7 l& i& Y3 v% d+ Q
- return 0
复制代码 8 I! O+ k) ?/ m" n4 k1 \
' Q$ F6 A* n$ ^4 ^
5 D& Y I- X0 K0 a& C! X2 ]由于它支持扩展接口,因此可以用于littlefs: - import os& d9 D' k4 M! z8 r. f
( X/ X/ b- ]0 z- bdev = RAMBlockDev(512, 50). v: G7 w- k; t0 w
- os.VfsLfs2.mkfs(bdev), `0 o3 a; K& ]3 S0 X1 A
- os.mount(bdev, '/ramdisk')
复制代码 ' O; B* m0 w% Q5 S; J
$ d6 k' v* V' B: B( P8 ]( l+ D& I
一旦挂载,文件系统(无论其类型如何)就可以像通常在 Python 代码中使用的那样使用,例如: - with open('/ramdisk/hello.txt', 'w') as f:. @9 F% x8 H' n
- f.write('Hello world')
( p5 m# X9 i3 q0 j0 Q - print(open('/ramdisk/hello.txt').read())
复制代码 5 r0 x, M* x' B: R4 c5 E# P# I
! a3 I& ^& B S: R" b$ D" K
( C; b! S; m* E* |1 z* F1 ^: w5 J& z+ n4 @6 Z- n
9 [( w# r! C5 @' ]9 f% Q; F) t文件系统MicroPython 端口可以提供 FAT、 和 的实现。 littlefs v1 and littlefs v2. 下表显示了固件中默认包含给定端口/板组合的文件系统,但可以在自定义固件构建中选择启用它们。
' P/ O1 t/ \- _6 w( RFATFAT 文件系统的主要优点是它可以通过支持的板(例如 STM32)上的 USB MSC 访问,而主机 PC 上不需要任何额外的驱动程序。 但是,FAT 不能容忍写入期间的电源故障,这可能会导致文件系统损坏。对于不需要 USB MSC 的应用,建议使用 littlefs 代替。 要使用 FAT 格式化整个闪存: - # ESP8266 and ESP32% N' c+ z( i% j4 L$ ~
- import os
4 L5 g5 u+ s4 ~; t* H- x - os.umount('/')# T" p, T) S9 @6 W
- os.VfsFat.mkfs(bdev)
1 ~6 c3 c' \1 `" Q* B" O/ v" u( p$ o - os.mount(bdev, '/')4 o, p( z. r& z" D
' ?2 k) O' z3 o7 m, f x* S- # STM32+ d% L8 ]6 ?3 g
- import os, pyb
: ?$ `( I1 m1 H- k - os.umount('/flash')* s* g Z. m$ x7 W6 z0 D
- os.VfsFat.mkfs(pyb.Flash(start=0)): \9 B0 i3 B( G/ V+ }
- os.mount(pyb.Flash(start=0), '/flash')& Q5 f2 w/ |$ x0 g1 [
- os.chdir('/flash')
复制代码 7 g8 A) J7 }" ^# n) q6 T$ \
6 G! c, F! ], G: @, Z/ C: Q
7 h; @# V6 q/ b7 @' i9 i
$ C; P4 J3 S2 Z7 _: N! {( dLittlefsLittlefs是专为基于闪存的设备设计的文件系统,对文件系统损坏具有更强的抵抗力。 笔记 有报告称 littlefs v1 和 v2 在某些情况下会失败,有关详细信息,请参阅littlefs issue 347 和 littlefs issue 295. 2 P! N: t- [& { C- i k! P
注意:它仍然可以使用 littlefs FUSE 驱动程序通过 USB MSC 访问。请注意,您必须使用该-b=4096 选项来覆盖块大小。 使用 littlefs v2 格式化整个闪存: - # ESP8266 and ESP32' t" e- }+ b# o
- import os, p4 d! \. q, V: n
- os.umount('/')7 N5 L6 ^# m* o4 P
- os.VfsLfs2.mkfs(bdev); v, ^% k$ ?! P
- os.mount(bdev, '/')
. y7 q0 e& N7 f9 M5 v6 M g - 7 U6 S2 X2 M% R6 \
- # STM32
% i. b( ~) t" k' C6 P - import os, pyb
- F9 ]# W- l4 L5 w0 j1 G - os.umount('/flash'). z. M6 X- p% E, s) X
- os.VfsLfs2.mkfs(pyb.Flash(start=0))4 ^$ v5 N& d- x' Z/ C, K
- os.mount(pyb.Flash(start=0), '/flash')5 [+ j* M) n% T+ h; e+ C
- os.chdir('/flash')
复制代码
" b, x, f! f* Q" A, W; F" B1 h& ~* K% X! ^9 [9 i: k* x2 _
4 m: Y/ y' f. C( T% `5 K
0 B2 M& D& K5 f: |2 G# A混合 (STM32)通过使用 start 和 len kwargs to pyb.Flash,您可以创建跨越闪存设备子集的块设备。 例如,将第一个 256kiB 配置为 FAT(并通过 USB MSC 可用),其余配置为 littlefs: - import os, pyb
% \! R" B' U6 o0 S5 V; ^4 k - os.umount('/flash')
2 Y- R& D6 r; @5 w5 g0 U9 ` - p1 = pyb.Flash(start=0, len=256*1024)7 C9 I9 {, h2 o* H5 j
- p2 = pyb.Flash(start=256*1024)
1 j6 N7 i# H- @' p. q - os.VfsFat.mkfs(p1)5 O* n6 V3 @7 X" Z$ y. R( v
- os.VfsLfs2.mkfs(p2)7 \; {% k6 N2 d8 H. f+ C# A
- os.mount(p1, '/flash')8 ?5 P5 z# x6 z. X. ~
- os.mount(p2, '/data'): w! I* y* p2 i
- os.chdir('/flash')
复制代码 % ?) g+ \3 P4 l6 |5 E
) K5 P1 M8 |& L
, r9 d4 A* `9 W" ?+ U4 h: N这可能有助于使您的 Python 文件、配置和其他很少修改的内容通过 USB MSC 可用,但允许频繁更改的应用程序数据驻留在 littlefs 上,从而具有更好的电源故障恢复能力等。 偏移处的分区 0 将自动挂载(并自动检测文件系统类型),但您可以添加: - import os, pyb) e3 P2 H8 j8 w$ r5 i9 U
- p2 = pyb.Flash(start=256*1024)
* b- w( L. @7 C: S o - os.mount(p2, '/data')
复制代码 5 y6 B, s9 G* ~1 z: Z1 Z$ U
( f% N! [6 H. J
( @" s8 h# P8 E, o" B来 boot.py挂载数据分区。 " |3 |% C7 ?' Z* a4 S7 p
混合动力(ESP32)在 ESP32 上,如果您构建自定义固件,您可以修改 partitions.csv以定义任意分区布局。 启动时,名为“vfs”的分区将被/默认挂载,但任何额外的分区都可以boot.py 使用: - import esp32, os8 G4 M( f9 y# e3 ~( U' C
- p = esp32.Partition.find(esp32.Partition.TYPE_DATA, label='foo')/ a% v& q$ Q* j' A& G0 ~8 L7 F
- os.mount(p, '/foo')
复制代码
9 p4 }+ L* h- X b( H6 A3 A" @. v1 P0 q: c: D& b0 }
5 y1 C L7 x5 V2 K: y( Z% @7 G
) ?' A) Z7 o v0 ~( ~) |% s# t" A O; R2 w% R6 h
' ^( C0 i% |3 Y: A( T. D# j
|