本帖最后由 huangxuejia-29212 于 2018-6-3 22:47 编辑
0 c& O9 u1 A. h7 \% w5 G$ y: f; x+ W9 Q# L1 i- i/ Z! I$ M$ F
SPIFFS文件系统,有什么特别呢?# }+ ^) @8 I- ? s
从名字就可知,这是一个用于SPI FLASH的file system。
, A5 K, _: H H/ l1 O现在好像在ESP8266上用的很多,感觉慢慢有的人气了。: N0 F1 |- p, z' F1 L& C
从特性上说,这个文件系统用很少的RAM资源。
& m- f( ^; I( ~* l0 |但是,我最后会吐槽吐槽这个特性的。+ `2 X- r8 j! |/ L* {) O
网络上资源不多,好在github上说明文档挺全。
( b: l/ i) I9 k9 Q4 i6 r# h github地址:http://github.com/pellepl/spiffs% V6 o6 N% J2 S6 k# }4 X
最新版本是0.3.7.
# w, U4 W4 t) R$ k" g1 M2 k# M5 U目录结构如下:" U7 H) E1 r9 n

( I9 T: w" [5 s! L( G添加到工程的文件如下:! j0 M! m6 f( r' P! G3 ^

, ~7 v$ j: @; J: |6 w4 B移植概述6 ]4 t' {' u, g& N, @6 o6 Y
下面我们说说移植的过程。6 P* L3 F& o2 i a
1. 配置
; M4 b8 f Z' k" {5 sspiffs-0.3.7\src\default下有一个默认的配置文件,spiffs_config.h。
9 `7 X& D9 ]* K& w6 q: Q为了方便,拷贝一个到spiffs-0.3.7\src。
' W' x& [" W. m o* [9 F( O在工程中,头文件搜索路径,只包含src路径,不要包含\src\default。8 r$ c- u; ~4 t" ~
spiffs_config.h头部包含的头文件修改如下。
5 i0 x H+ b# q. ~5 l9 J- c在这里也定义了变量名。 - //#include <stdio.h>! T/ _0 u3 f; R8 X
- #include <stdlib.h>8 T3 I. J+ c3 x! Z8 Y$ s
- #include <string.h>4 o! f+ H" r" s
- #include <stddef.h>" Z9 k' v; W1 ?& Z r" X
- #include "stm32f4xx.h"8 w* }' F2 z ]% r& j
7 W T9 O+ q1 F) d- typedef u32 u32_t;9 r7 Q" ]0 p; W* n: A% h3 ?. B! @
- typedef u16 u16_t;
- m5 n& s4 J+ k/ M7 _6 b( u: o0 Q7 ^ - typedef u8 u8_t;
( o* z9 }1 s" Y$ \' o6 u" p. \+ R+ N - , k9 }! ~$ I, Y0 t- `3 M
- typedef s32 s32_t;
5 h1 f6 W/ |, K3 C - typedef s16 s16_t;
3 g! K( K l) Q: x' N- @8 G - typedef s8 s8_t;
复制代码 , `# w) _& {" B/ g% _
修改几个宏定义 - #ifndef SPIFFS_USE_MAGIC
+ b$ t. E. @) y1 k- C - #define SPIFFS_USE_MAGIC (1)
5 D+ A8 F% g: Q0 r% m - #endif
6 r4 ]0 c3 D( e# T2 N9 i) A8 D- U( W - 2 Q2 O2 k) w, D* ]6 }
- #ifndef SPIFFS_USE_MAGIC_LENGTH
8 R8 N$ R& G/ s6 h - #define SPIFFS_USE_MAGIC_LENGTH (1)
5 l8 S2 l# Y! j' n2 {* c - #endif" ~0 F" \- `1 a1 g) U
- #endif
复制代码
1 f j& }# E3 M1 t: y在spiffs-0.3.7\src\spiffs_nucleus.h文件中定义的联合用了一个gcc特性,在MDK编译会报错。
% P. y! c& U' _在联合前增加一句代码#pragma anon_unions 即可。 -
& c' w$ T+ ?# B4 Q$ i0 P7 C - #pragma anon_unions
& t1 l- _) i. {: V1 [4 o - union {
- M* E/ p! U* T0 z8 j- V - // type read cache9 x: u( K8 G2 G: L+ _( z$ I% B7 U
- struct {% x1 w1 F/ i. ?* ^
- // read cache page index
! w2 C0 l& r; q" J! g - spiffs_page_ix pix;
& H! m2 Y1 ~2 j- P7 k% P - };
: p- |4 u+ Z: c1 O; O" x - #if SPIFFS_CACHE_WR
9 d( G7 q6 M" J) O - // type write cache2 u) Z, o: T: X/ N0 S* G6 k' O
- struct {
4 K$ r8 g7 w# \" y+ D9 e: b - // write cache: r. ?0 ^; g% D. T# ?. l. `
- spiffs_obj_id obj_id;+ N' q2 C9 D' G' H" u6 ^
- // offset in cache page
% @* C! ^6 F) K7 ~. ]1 ^ - u32_t offset;- ]! H& R" f+ m: n3 r
- // size of cache page4 ?5 }& |6 e, u; D, D/ [
- u16_t size; c; F2 y; K: e. g. ~
- };2 ]8 h; `% J% ]: h! Y/ s, K* W9 _
- #endif, f+ ^" B% T, a! w
- };
$ {' U/ m1 h* @, q+ ]6 Y, ~# q* w - } spiffs_cache_page;
复制代码 ( [5 D5 E- w& m( k {
2 应用) U. @& ~" a f9 z& F, u$ O
首先,
8 s+ R& C) e, z& e6 O要实现SPI FLASH操作函数,SPIFFS需要的函数格式如下 - s32_t core_spiflash_spiffs_read(u32_t addr, u32_t size, u8_t *dst);. _7 d: C2 Y2 q7 P* y6 K5 t
- static s32_t core_spiflash_spiffs_write(u32_t addr, u32_t size, u8_t *src);
9 }8 y; n. S \7 q, \ - static s32_t core_spiflash_spiffs_erase(u32_t addr, u32_t size);
复制代码 9 b. ]: A! r& x; U
第二,% o5 W' f- i$ m2 {# D' V
定义文件系统相关参数 - /*
$ |* o& {# \5 { h( K - 文件系统配置
' `; I, I: \) K: Q -
8 m3 f+ E6 D' f% y4 o - #define SPIFFS_SINGLETON (0) 这个宏配置为0,也就是支持多个spiffs
3 L6 c8 I0 z& d3 m1 {4 p( } - */
- i% z. X e P - spiffs_config cfg=+ O# L, E. _$ S! |$ z
- {
3 t, \4 ?9 k& W' t! a* i$ ^# o, r - /* 分配给SPIFFS的空间 要是逻辑扇区的整数倍*/
& v3 L6 b5 C( m - .phys_size = 1024*4*4*128,
( ^. u8 z+ o( r. H: Z; ?' V* G5 x - /* 起始地址 */. r- M( e; }. P \' y
- .phys_addr = 0,
) O$ m4 B& |/ T- D - /*8 U) S! y9 O. |+ z
- 物理扇区,也就是一次擦除的大小,要跟hal_erase_f函数擦除的一致/ b$ e, a U, i, u0 m: _' Z6 Z
- */# Y/ S" L. X+ n& v( ^
- .phys_erase_block = 1024*4,
& f5 Z0 I3 J$ Q/ w3 Q5 M* x - /* 逻辑扇区,必须是物理扇区的整数倍' h% t0 q! k' R
- 最好是: log_block_size/log_page_size = (32-512)
; c6 n/ t0 L" N% g0 N! @ - */# Z: Q# M$ {7 C8 k7 E
- .log_block_size = 1024*4*4,+ Q9 {6 h! |' N, C O# W9 Y
- /*逻辑页,通常是256*/
$ {7 I6 t* n) m( A" ? - .log_page_size = LOG_PAGE_SIZE,
/ Z4 Y% D# o. A2 D7 C% T - 4 K* g4 y0 s& d6 G
- .hal_read_f = core_spiflash_spiffs_read,
" J- s _3 @# ?( N& G$ v( z - .hal_write_f = core_spiflash_spiffs_write,8 a7 a/ f. A! |3 s& S
- .hal_erase_f = core_spiflash_spiffs_erase,
1 z; ` k5 r/ J3 n -
( D4 @) w" c4 \2 a - };
复制代码 ' J V9 y/ m, ~, ]. R7 E
第三,% f3 b6 o& J& p9 A
挂载文件系统,如果是第一次挂载会失败,需要卸载文件系统再格式化文件系统,最后重新挂载即可。 - /*文件系统结构体*/
% I# @* [! @/ U" ~/ X" a ~ - static spiffs fs;
2 c4 k( l8 Y/ p% ~0 H( u/ A
0 e8 M/ ~+ X+ J( g; U1 i- /*页定义*/: d6 W/ i& C2 p' ?# `+ r2 e
- #define LOG_PAGE_SIZE 256& Y- Q5 w7 O! I) @
& B- U1 U3 V( @5 K- static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2];
6 F0 F- d+ S4 S2 \ - static u8_t spiffs_fds[32*4];3 N. \. p: F T4 A! {8 K
- static u8_t spiffs_cache_buf[(LOG_PAGE_SIZE+32)*4];3 o0 g9 }+ d9 N$ C6 |5 Z, y, h
: ~7 m; R$ N' Y4 w. j* y- /**6 \8 B1 y) [( J! y
- *@brief:
: ^+ P3 D% n+ {4 q8 V - *@details: 格式化文件系统9 o. H' f3 I& h9 v% k9 E& ]0 [
- *@param[in]
% v ]: E4 W4 f! O: p$ W2 V' n2 R - *@param[out]
& O: z! W* g5 P1 c( j - *@retval:
0 o7 d% M9 @* I - */
+ t& z y% u. @! d7 \) Z - void sys_spiffs_format(void)( K+ K1 ]5 Y. T
- {
2 b1 a3 y3 P6 _$ }! ` - 3 ^1 F M; B0 ^# X
- wjq_log(LOG_INFO, ">---format spiffs coreflash\r\n");
# D/ G: o: k# h
0 D9 J K8 w* {' u- L5 k- /* 格式化之前要先unmount *// E& O z5 w5 r3 F) ^, H9 m
- SPIFFS_unmount(&fs);; d0 k! I$ b2 h
-
: G' ~3 w/ ]) x: j: G9 i - SPIFFS_format(&fs);# ?( s0 O0 q: ^! V
% |% ]' a$ \, m+ R- int res = SPIFFS_mount(&fs," e& i$ J: O% t
- &cfg,
~; Y+ w- q K: ~7 ` - spiffs_work_buf,
- v- L: g& S$ p8 L6 u+ Y, [- ` - spiffs_fds,( L4 k. x4 s( O. B, ?
- sizeof(spiffs_fds),, k1 i0 ?! u+ [6 {! d4 b7 E. K
- spiffs_cache_buf,
8 J, V% O* W9 Z/ s+ {# S! y$ g" C - sizeof(spiffs_cache_buf),
, C I; k( ~ Q+ L# P - 0);
/ h9 \" {. a9 t I: Y - wjq_log(LOG_INFO, "mount res: %i\r\n", res);
$ p9 G& P) T4 {9 Z/ E$ O - ! O" f4 P3 J4 C
- wjq_log(LOG_INFO, ">---format spiffs coreflash finish\r\n");$ I P2 l( l- p8 ^$ z# O, s0 C
- f1 ]4 f; C; M6 s9 n" o: N9 }
- }
, m" Z9 Z! h$ L+ N3 S# G - /**; G$ Z, d. I/ M+ D1 H# V& c0 N7 U" z
- *@brief: ' ]5 }& m- l( I, t
- *@details: 挂载spiffs文件系统( l7 p5 X5 b: G7 b
- *@param[in] * q: v8 g! D* H( O+ t5 U
- *@param[out] & Q! K9 W6 h! ^( l" l% {5 ?
- *@retval: ) C. x& _, \. a; P7 Q
- */
1 o( _1 H0 B" ^2 C- I5 h b z8 C - void sys_spiffs_mount_coreflash(void)
7 U3 }$ S p& b; A3 ` u; J! [ - { # J7 k: M9 R0 ?9 B& I
- int res = SPIFFS_mount(&fs,7 A5 O! |$ [+ [- I1 L
- &cfg,
+ w4 K- J5 v/ E/ _# | - spiffs_work_buf,/ Z2 U+ M0 x4 J7 A7 h3 z+ u
- spiffs_fds,
& j4 q" R" x2 x, P- P - sizeof(spiffs_fds),
- a+ u0 K( Q* Y2 b - spiffs_cache_buf,: H/ \8 \1 @$ T @
- sizeof(spiffs_cache_buf),$ i% ^: ~+ [# n1 R0 s, i# ]. @
- 0);; T: {+ X" U$ [6 C* n8 ]3 i
- wjq_log(LOG_INFO, "mount res: %i\r\n", res);& W3 I: E! P0 W
- ) G; M) i1 D; U8 d$ q; q1 _
- if(SPIFFS_ERR_NOT_A_FS == res )
- I0 N4 t7 b" ~% M( X7 S5 r - {0 P; t- ^1 p2 `
- sys_spiffs_format();
2 w# c- H, Y( d# l - }
. E8 U, W' w. s* `3 J0 ~# b - }
复制代码 3 L1 u6 V) n" b ?
然后,就可以进行基本读写测试啦。
& [! b# Z* O/ s) D 吐槽
1 e K0 Q* q( S8 t1: y# `6 Z0 B' J5 _% f
如果要好好用这个文件系统,需要多次测试找一个设置平衡点。
) y& k/ L. G% [- [4 i# J& X什么意思呢?也就是你这个文件系统如何配置。 V# l) L: }6 ^
也就是spiffs_config中的:逻辑块多大,页设置多大。不同的设置会严重影响性能。
7 X9 l: y g4 a) G) \# j% l因为这个文件系统为了省内存,没有任何索引。! F" f& r* w) B9 m
具体细节大家自己分析,我就说一个事实: 打开一个文件,很可能要轮询所有BLOCK的第一页。
, ?: G% H x4 v/ B# ]1 @当你BLOCK跟页设置小,数量就多,操作文件就会很慢很慢,,,,。( d$ S* j, y8 n' y: V
为什么这么慢?作者在WIKI上有说明。
2
+ S& ]6 v; w% L$ z目前还没有认真使用这个文件系统,但是总感觉它有点上不成下不就的感觉。/ O) F- A$ w9 L- H; W4 j) p, [
是的,嵌入式RAM紧张,但是嵌入式对速度也敏感啊!6 F! z N: m9 E
想起以前公司用的文件系统,速度不慢,RAM用得也不算多。
0 e& m S- }5 }, s( n) ?3 q. A+ P' ^9 J怎么做到呢?
+ \0 O$ C% c+ D3 ^$ v限制其他性能,例如,最多只能创建100个文件,文件系统最大只能到1M。9 H, O) |- M5 F) V% B5 M% {( Q
这样的限制对于单片机系统来说,其实是能用的。
0 j- y' z- Q) u7 E3 J: F$ z9 @. S$ q(带这个文件系统的产品估计出货也1000万台了吧)
$ B# O3 S4 V+ X# z; ^# N" }7 t 移植源码
( o+ k$ e" V: C) I z( X% W! D这个仓库是个人写的一些代码,主要是按照经验进行了一些程序设计,自认为比大部分教程的例程代码要好。
& M! n" s# s4 d6 z& {' e' J后续会慢慢添加各种外设驱动。大家拿来用即可。) C: P. s% Y4 ^' x" A" a* O% b
欢迎商用,后果自负 1 W: F% H* r1 [
5 r/ ~5 e4 a& u: f
|