1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <meta http-equiv=
"Content-Type" content=
"text/html; charset=utf-8">
5 <meta http-equiv=
"Content-Style-Type" content=
"text/css">
6 <link rel=
"up" title=
"FatFs" href=
"../00index_j.html">
7 <link rel=
"alternate" hreflang=
"en" title=
"English" href=
"../en/appnote.html">
8 <link rel=
"stylesheet" href=
"../css_j.css" type=
"text/css" media=
"screen" title=
"ELM Default">
9 <title>FatFsモジュール アプリケーション ノート
</title>
13 <h1>FatFsモジュール アプリケーション ノート
</h1>
15 <li><a href=
"#port">ポーティングの際に配慮すべきこと
</a></li>
16 <li><a href=
"#limits">限界値
</a></li>
17 <li><a href=
"#memory">メモリ使用量
</a></li>
18 <li><a href=
"#reduce">モジュール サイズの縮小
</a></li>
19 <li><a href=
"#lfn">長いファイル名
</a></li>
20 <li><a href=
"#jap">日本語ファイル名の大文字変換
</a></li>
21 <li><a href=
"#unicode">Unicode入出力への対応
</a></li>
22 <li><a href=
"#reentrant">リエントランシー
</a></li>
23 <li><a href=
"#dup">多重ファイル アクセス
</a></li>
24 <li><a href=
"#fs1">効率的なファイル アクセス
</a></li>
25 <li><a href=
"#fs2">フラッシュ メモリの特性への配慮
</a></li>
26 <li><a href=
"#critical">クリチカル セクション
</a></li>
27 <li><a href=
"#fs3">APIの拡張的使用例
</a></li>
28 <li><a href=
"#license">FatFsのライセンスについて
</a></li>
32 <div class=
"para" id=
"port">
33 <h3>ポーティングの際に配慮すべきこと
</h3>
36 <p>FatFsモジュールは移植性に関して次の点を前提としています。
</p>
38 <li>処理系はANSI C準拠であること。
<br>
39 FatFsモジュールはANSI C(C89)準拠で記述されているので、普通のCコンパイラなら特に処理系依存になる点はありません。
</li>
40 <li>char/short/longのサイズは、それぞれ
8/
16/
32ビットで、intは
16または
32ビットであること。
<br>
41 これについても、まっとうな処理系なら問題ないはずです。FatFsモジュールで使用されるサイズを明示する整数型が integer.h 内で定義されていますが、既存の定義と衝突した場合はユーザによって解決されなければなりません。
</li>
45 <p>下に示す依存関係図は、FatFsモジュール利用の組み込みシステムにおける代表的な構成を示します。
</p>
46 <p><img src=
"../img/modules.png" width=
"580" height=
"280" alt=
"システム構成図"></p>
47 <p>(a) FatFs用に書かれたディスク モジュールがある場合は、そのまま追加するだけです。 (b) しかし、多くの既存のディスク モジュールはそのAPIをFatFsに合わせるため、グルー関数が必要になるでしょう。
</p>
48 <p><img src=
"../img/funcs.png" width=
"680" height=
"430" alt=
"functional diagram"></p>
51 <p>必要なのはFatFsモジュールの要求するディスク関数を用意することだけで、それ以外にすることはありません。既に動作しているディスク モジュールがあるなら、そのAPIをFatFsに合わせるかグルー関数を介してつなぐだけで済みますが、無い場合はほかから移植するか最初から書くかする必要があります。定義されている全ての関数が常に必要なわけではありません。例えば、リード オンリー構成では書き込み系関数は必要ありません。次の表に構成オプションと要求される関数の対応を示します。
</p>
53 <tr><th>必要な関数
</th><th>必要となる条件
</th><th>備考
</th></tr>
54 <tr><td>disk_status
<br>disk_initialize
<br>disk_read
</td><td>常時
</td><td rowspan=
"5">ffsample.zip (サンプル)
<br>その他web上に多数
</td></tr>
55 <tr><td>disk_write
<br>get_fattime
<br>disk_ioctl (CTRL_SYNC)
</td><td>_FS_READONLY ==
0</td></tr>
56 <tr><td>disk_ioctl (GET_SECTOR_COUNT)
<br>disk_ioctl (GET_BLOCK_SIZE)
</td><td>_USE_MKFS ==
1</td></tr>
57 <tr><td>disk_ioctl (GET_SECTOR_SIZE)
</td><td>_MAX_SS != _MIN_SS
</td></tr>
58 <tr><td>disk_ioctl (CTRL_TRIM)
</td><td>_USE_TRIM ==
1</td></tr>
59 <tr><td>ff_convert
<br>ff_wtoupper
</td><td>_USE_LFN
>=
1</td><td>option/unicode.c
</td></tr>
60 <tr><td>ff_cre_syncobj
<br>ff_rel_grant
<br>ff_req_grant
<br>ff_del_syncobj
</td><td>_FS_REENTRANT ==
1</td><td rowspan=
"2">option/syscall.c (サンプル)
</td></tr>
61 <tr><td>ff_mem_alloc
<br>ff_mem_free
</td><td>_USE_LFN ==
3</td></tr>
65 <div class=
"para" id=
"limits">
68 <li>FATタイプ: FAT12, FAT16, FAT32。
</li>
69 <li>同時オープン ファイル数: 無制限。(利用可能メモリによる)
</li>
70 <li>ボリューム数: 最大
10。
</li>
71 <li>ファイル サイズ: FAT規格に依存。(最大
4G-
1バイト)
</li>
72 <li>ボリューム サイズ: FAT規格に依存。(最大
2Tバイト(
512バイト/セクタ時))
</li>
73 <li>クラスタ サイズ: FAT規格に依存。(最大
64Kバイト(
512バイト/セクタ時))
</li>
74 <li>セクタ サイズ: FAT規格に依存。(
512~
4096バイト)
</li>
78 <div class=
"para" id=
"memory">
80 <p>次の表にいくつかのターゲットにおけるメモリ使用量の例を示します。テスト時の構成オプションはその下の通りです。数値の単位はバイトで、
<em>V
</em>はボリューム数、
<em>F
</em>は同時オープン ファイル数を示します。コンパイラの最適化オプションはコード サイズとしています。
</p>
82 <tr><th></th><th>ARM7
<small><br>32bit
</small></th><th>ARM7
<small><br>Thumb
</small></th><th>CM3
<small><br>Thumb-
2</small></th><th>AVR
</th><th>H8/
300H
</th><th>PIC24
</th><th>RL78
</th><th>V850ES
</th><th>SH-
2A
</th><th>RX600
</th><th>IA-
32</th></tr>
83 <tr class=
"cal"> <td>Compiler
</td><td>GCC
</td><td>GCC
</td><td>GCC
</td><td>GCC
</td><td>CH38
</td><td>C30
</td><td>CC78K0R
</td><td>CA850
</td><td>SHC
</td><td>RXC
</td><td>VC6
</td></tr>
84 <tr class=
"cal"> <td>_WORD_ACCESS
</td><td>0</td><td>0</td><td>0</td><td>1</td><td>0</td><td>0</td><td>0</td><td>1</td><td>0</td><td>1</td><td>1</td></tr>
85 <!-- ARM Thumb CM3 AVR H8 PIC24 RL78 V850ES SH-2A RX600 IA-32 -->
86 <tr class=
"lst3 ral"><td class=
"cal">text (Full, R/W)
</td><td>10675</td><td>7171</td><td>6617</td><td>13355</td><td>10940</td><td>11722</td><td>13262</td><td>8113</td><td>9048</td><td>6032</td><td>7952</td></tr>
87 <tr class=
"ral"> <td class=
"cal">text (Min, R/W)
</td> <td>6727</td><td>4631</td><td>4331</td> <td>8569</td> <td>7262</td> <td>7720</td> <td>9088</td><td>5287</td><td>5800</td><td>3948</td><td>5183</td></tr>
88 <tr class=
"ral"> <td class=
"cal">text (Full, R/O)
</td> <td>4731</td><td>3147</td><td>2889</td> <td>6235</td> <td>5170</td> <td>5497</td> <td>6482</td><td>3833</td><td>3972</td><td>2862</td><td>3719</td></tr>
89 <tr class=
"ral"> <td class=
"cal">text (Min, R/O)
</td> <td>3559</td><td>2485</td><td>2295</td> <td>4575</td> <td>4064</td> <td>4240</td> <td>5019</td><td>2993</td><td>3104</td><td>2214</td><td>2889</td></tr>
90 <tr class=
"ral"> <td class=
"cal">bss
</td><td>V*
4 +
2</td><td>V*
4 +
2</td><td>V*
4 +
2</td><td>V*
2 +
2</td><td>V*
4 +
2</td><td>V*
2 +
2</td><td>V*
2 +
2</td><td>V*
4 +
2</td><td>V*
4 +
2</td><td>V*
4 +
2</td><td>V*
4 +
2</td></tr>
91 <tr class=
"ral"> <td class=
"cal">Work area
<br>(_FS_TINY ==
0)
</td><td>V*
560<br>+ F*
550</td><td>V*
560<br>+ F*
550</td><td>V*
560<br>+ F*
550</td><td>V*
560<br>+ F*
544</td><td>V*
560<br>+ F*
550</td><td>V*
560<br>+ F*
544</td><td>V*
560<br>+ F*
544</td><td>V*
560<br>+ F*
544</td><td>V*
560<br>+ F*
550</td><td>V*
560<br>+ F*
550</td><td>V*
560<br>+ F*
550</td></tr>
92 <tr class=
"ral"> <td class=
"cal">Work area
<br>(_FS_TINY ==
1)
</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
32</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
32</td><td>V*
560<br>+ F*
32</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
36</td><td>V*
560<br>+ F*
36</td></tr>
96 _FS_READONLY
0 (R/W) or
1 (R/O)
97 _FS_MINIMIZE
0 (Full function) or
3 (Minimized function)
98 _USE_STRFUNC
0 (Disable string functions)
99 _USE_MKFS
0 (Disable f_mkfs function)
100 _USE_FORWARD
0 (Disable f_forward function)
101 _USE_FASTSEEK
0 (Disable fast seek feature)
102 _CODE_PAGE
932 (Japanese Shift_JIS)
103 _USE_LFN
0 (Disable LFN feature)
104 _MAX_SS
512 (Fixed sector size)
105 _FS_RPATH
0 (Disable relative path feature)
106 _FS_LABEL
0 (Disable volume label functions)
107 _VOLUMES V (Number of logical drives to be used)
108 _MULTI_PARTITION
0 (Single partition per drive)
109 _FS_REENTRANT
0 (Disable thread safe)
110 _FS_LOCK
0 (Disable file lock control)
114 <div class=
"para" id=
"reduce">
115 <h3>モジュール サイズの縮小
</h3>
116 <p>次の表は構成オプションの設定値によりどの機能が削除されるかを示します。
</p>
118 <tr><td rowspan=
"2">Function
</td><td colspan=
"4">_FS_MINIMIZE
</td><td colspan=
"2">_FS_READONLY
</td><td colspan=
"2">_USE_STRFUNC
</td><td colspan=
"3">_FS_RPATH
</td><td colspan=
"2">_FS_LABEL
</td><td colspan=
"2">_USE_MKFS
</td><td colspan=
"2">_USE_FORWARD
</td><td colspan=
"2">_MULTI_PARTITION
</td></tr>
119 <tr><td>0</td><td>1</td><td>2</td><td>3</td><td>0</td><td>1</td><td>0 </td><td>1/
2</td><td>0</td><td>1</td><td>2</td><td>0</td><td>1</td><td>0</td><td>1</td><td>0</td><td>1</td><td>0/
1</td><td>2</td></tr>
120 <tr class=
"lst3"><td>f_mount
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
121 <tr><td>f_open
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
122 <tr><td>f_close
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
123 <tr><td>f_read
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
124 <tr><td>f_write
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
125 <tr><td>f_sync
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
126 <tr><td>f_lseek
</td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
127 <tr><td>f_opendir
</td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
128 <tr><td>f_closedir
</td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
129 <tr><td>f_readdir
</td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
130 <tr><td>f_stat
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
131 <tr><td>f_getfree
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
132 <tr><td>f_truncate
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
133 <tr><td>f_unlink
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
134 <tr><td>f_mkdir
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
135 <tr><td>f_chmod
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
136 <tr><td>f_utime
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
137 <tr><td>f_rename
</td><td></td><td>x
</td><td>x
</td><td>x
</td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
138 <tr><td>f_chdir
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
139 <tr><td>f_chdrive
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
140 <tr><td>f_getcwd
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
141 <tr><td>f_getlabel
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
142 <tr><td>f_setlabel
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
143 <tr><td>f_forward
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td></tr>
144 <tr><td>f_mkfs
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td></tr>
145 <tr><td>f_fdisk
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td>x
</td><td></td></tr>
146 <tr><td>f_putc
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
147 <tr><td>f_puts
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
148 <tr><td>f_printf
</td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
149 <tr><td>f_gets
</td><td></td><td></td><td></td><td></td><td></td><td></td><td>x
</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr>
153 <div class=
"para" id=
"lfn">
155 <p>FatFsモジュールは、長いファイル名(LFN)をサポートします。ファイルに付けられた
2つの異なる名前(短いファル名と長いファイル名)は、
<tt>f_readdir()
</tt>を除くファイル操作関数において透過です。デフォルト構成では、LFN機能はOFFになっています。LFN機能を有効にするには、
<tt>_USE_LFN
</tt>を
1,
2または
3に設定し、
<tt>option/unicode.c
</tt>をプロジェクトに追加します。LFN機能は、加えてある程度のワーク エリア(LFN操作バッファ)を必要とします。バッファ長は使用できるメモリに応じて
<tt>_MAX_LFN
</tt>オプションで構成されることができます。LFNの長さは最大
255文字に達するので、LFN完全対応のためには
<tt>_MAX_LFN
</tt>は
255に設定されるべきです。与えられたファイル名に対してバッファ長が不足した場合、ファイル関数は
<tt>FR_INVALID_NAME
</tt>で失敗します。
</p>
156 <p>ファイル関数に再入を行う条件の下でLFN機能を使用する場合は、
<tt>_USE_LFN
</tt>は
2または
3に設定されなければなりません。この場合、ファイル関数はワーク エリアを動的に確保(スタックまたはヒープ)します。バッファ サイズは、
<tt>(_MAX_LFN +
1) *
2</tt>バイトになるので、スタック等のサイズはそれを考慮した十分なサイズでなければなりません。
</p>
157 <table class=
"lst2 rset">
158 <caption>LFN cfg on ARM7
</caption>
159 <tr><th>コードページ
</th><th>コードサイズ[bytes]
</th></tr>
160 <tr><td>SBCS
</td><td>+
3721</td></tr>
161 <tr><td>932(Shift_JIS)
</td><td>+
62609</td></tr>
162 <tr><td>936(GBK)
</td><td>+
177797</td></tr>
163 <tr><td>949(Korean)
</td><td>+
139857</td></tr>
164 <tr><td>950(Big5)
</td><td>+
111497</td></tr>
166 <p>LFN機能の上手な使い方は、それを使わないということです。実際、組み込み用途ではLFN機能がどうしても必要になるということはほとんど無いはずです。LFNを有効にすると、選択されたコード ページに応じてモジュール サイズが増大します。右の表に各コード ページにおけるLFNを有効にしたときのモジュール サイズの違いを示します。特に、CJK地域では数万の文字が使われていますが、不幸なことにそれは巨大なOEM-Unicode相互変換テーブルを要求し、モジュール サイズは劇的に増大します。その結果、それらのコード ページにおいてLFNを有効にしたFatFsモジュールは、多くの
8ビット マイコンにインプリメントすることができません。
</p>
167 <p>LFN機能のハードルはそれだけではありません。マイクロソフト社はFATファイル システムについていくつかの特許を保有しています。いずれもLFN機能の実装に関するもので、その利用に対して$
0.25/unitのライセンス料を要求しています。このため、商用製品でLFN機能を利用するときは、最終仕向地によってはライセンスが必要になります。最近のFAT32ドライバの多くはLFN機能を含んでいるため、それらの使用に当たってライセンスが必要になりますが、FatFsではLFN機能を構成オプションで任意にON/OFFできるため、無効にしてライセンス問題を回避することもできます。
</p>
170 <div class=
"para" id=
"jap">
171 <h3>日本語ファイル名の大文字変換
</h3>
172 <p>CP932(Shift_JIS)でかつ非LFN構成のときは、拡張文字の小文字(
2バイト英字・キリル文字・ギリシャ文字)に対して大文字変換を行わず、小文字のままSFNエントリに記録・検索されます(日本語MSDOS仕様)。このため、非LFN構成で全角小文字を含むファイルを作成すると、NT系Windowsでそのファイルを開けなくなります。LFN構成では大文字変換を行います(NT系Windows仕様)。
</p>
175 <div class=
"para" id=
"unicode">
176 <h3>Unicode入出力への対応
</h3>
177 <p>FatFs API上におけるファイル名等の文字列データの入出力は、デフォルトではANSI/OEMコードで行われますが、これをUnicode(UTF-
16)に切り替えることもできます(
<tt>_LFN_UNICODE
</tt>オプションで設定)。つまり、これはFatFsがLFN機能に完全対応していることを意味します。Unicodeのファイル名に関する詳細は、
<a href=
"filename.html">ファイル名
</a>を参照してください。
</p>
180 <div class=
"para" id=
"reentrant">
182 <p>互いに異なるボリュームに対するファイル操作はリエントラントで、常に同時平行に動作できます。同じボリュームに対してはデフォルトではリエントラントではありませんが、
<tt>_FS_REENTRANT
</tt>オプションでリエントラント(スレッド セーフ)にすることはできます。この場合、OS依存の同期オブジェクト操作関数
<tt>ff_cre_syncobj(), ff_del_syncobj(), ff_req_grant(), ff_rel_grant()
</tt>もまたプロジェクトに追加されなければなりません。サンプル コードと解説は
<tt>option/syncobj.c
</tt>にあります。
</p>
183 <p>この場合、あるタスクがボリュームを使用中に他のタスクからそのボリュームに対するファイル関数が呼び出されると、そのアクセスは先のタスクがファイル関数を抜けるまでブロックされます。もし、待ち時間が
<tt>_TIMEOUT
</tt>で指定された期間を越すと、その関数は
<tt>FR_TIMEOUT
</tt>でアボートします。いくつかのRTOSではタイムアウト機能はサポートされないかも知れません。
</p>
184 <p>ひとつの例外が
<tt>f_mount(), f_mkfs(), f_fdisk()
</tt>にあります。これらの関数は同じボリューム(または関連する物理ドライブ)に対してリエントラントではありません。これらの関数を使用するときは、アプリケーション レベルで排他制御しなければなりません。
</p>
185 <p>注: このセクションはFatFsモジュールそれ自体のリエントランシーについて説明しています。その下位のディスクI/Oモジュールのリエントランシーに関しては何の前提もありません。
</p>
188 <div class=
"para" id=
"dup">
190 <p>FatFsモジュールではデフォルトでは多重アクセス制御機能をサポートしていません。ファイルに対する多重アクセスは、そのアクセス モードによって制限されます。一つのファイルに対する多重オープンは、それらが全てリード モードのときに限って許可されます。書き込みモードを含む多重オープン、また開かれているファイルに対するリネームや削除を行ってはなりません。さもないと、そのボリュームのFAT構造が破壊される可能性があります。
</p>
191 <p><tt>_FS_LOCK
</tt>に
1以上の値(値は同時に管理できるファイル数)をセットすることで多重アクセス制御機能が有効になり、ファイル単位のアクセス制御を自動で行うこともできます。この場合、上記のルールを破ったオープン・リネーム・削除を試みると、その関数は
<tt>FR_LOCKED
</tt>で失敗します。また、
<tt>_FS_LOCK
</tt>を越える数のファイルやサブ ディレクトリを同時にオープンしようとすると、
<tt>FR_TOO_MANY_OPEN_FILES
</tt>で失敗します。
</p>
194 <div class=
"para" id=
"fs1">
195 <h3>効率的なファイル アクセス
</h3>
196 <p>小規模な組込システムでのファイルの読み書きにおける効率の良いアクセスのため、アプリケーション プログラマはFatFsモジュールの中でどのような処理が行われているか考慮すべきです。ストレージ上のデータは
<tt>f_read()
</tt>により次のシーケンスで転送されます。
</p>
197 <p>図
1. セクタ ミスアラインド リード (ショート)
<br>
198 <img src=
"../img/f1.png" width=
"490" height=
"110" alt=
"fig.1">
200 <p>図
2. セクタ ミスアラインド リード (ロング)
<br>
201 <img src=
"../img/f2.png" width=
"490" height=
"140" alt=
"fig.2">
203 <p>図
3. セクタ アラインド リード
<br>
204 <img src=
"../img/f3.png" width=
"490" height=
"119" alt=
"fig.3">
206 <p>ファイルI/Oバッファはセクタの一部のデータを読み書きするためのセクタ バッファを意味します。セクタ バッファは、それぞれのファイル オブジェクト内のプライベート セクタ バッファまたはファイル システム オブジェクト内の共有セクタ バッファのどちらかです。バッファ構成オプションの
<tt>_FS_TINY
</tt>は、データ転送にどちらを使うかを決定します。タイニー バッファ(
1)が選択されるとデータ メモリの消費はそれぞれのファイル オブジェクトで
<tt>_MAX_SS
</tt>バイト減少されます。この場合、FatFsモジュールはファイル データの転送とFAT/ディレクトリ アクセスにファイル システム オブジェクト内のセクタ バッファだけを使用します。タイニー バッファの欠点は、セクタ バッファにキャッシュされたFATデータがファイル データの転送により失われ、クラスタ境界の毎にリロードされなければならないことです。でも、悪くない性能と少ないメモリ消費の視点から多くのアプリケーションに適するでしょう。
</p>
207 <p>図
1はセクタの一部のデータがファイルI/Oバッファを経由で転送されることを示します。図
2に示される長いデータの転送では、転送データの中間の
1セクタまたはそれ以上のセクタにまたがる転送データがアプリケーション バッファに直接転送されています。図
3は転送データ全体がセクタ境界にアライメントされている場合を示しています。この場合、ファイルI/Oバッファは使用されません。直接転送においては最大の範囲のセクタが
<tt>disk_read()
</tt>で一度に読み込まれますが、クラスタ境界を越えるマルチ セクタ転送はそれが隣接であっても行われません。
</p>
208 <p>このように、セクタにアライメントしたファイルの読み書きへの配慮はバッファ経由のデータ転送を避け、読み書き性能は改善されるでしょう。その効果に加え、タイニー構成でキャッシュされたFATデータがファイル データの転送によりフラッシュされず、非タイニー構成と同じ性能を小さなメモリ フットプリントで達成できます。
</p>
211 <div class=
"para" id=
"fs2">
212 <h3>フラッシュ メモリの特性への配慮
</h3>
213 <p>HDDなどのディスク メディアとは異なり、SDCやCFCなどのフラッシュ メモリ メディアの性能を引き出すには、その特性を意識した制御が必要になります。
</p>
216 図
6. マルチ/シングル セクタ ライトの比較
<br>
217 <img src=
"../img/f6.png" width=
"630" height=
"148" alt=
"fig.6">
219 <p>フラッシュ メモリ メディアの書き込み速度はシングル セクタ書き込みの時に最も低いものになり、一回のトランザクションで転送されるセクタ数が大きくなるほど書き込み速度は向上します。この効果はバス速度が高速になるほど顕著で、
10倍以上の差が現れることも珍しくありません。
<a href=
"../img/rwtest2.png">テスト結果
</a>は、マルチ セクタ書き込み(W:
16K,
32 sectors)がシングル セクタ書き込み(W:
100,
1 sector)よりどの程度速いかを明確に示しています。大容量メディアほどシングル セクタ書き込みが遅くなる点もまた重要です。書き込みトランザクションの回数はまた、メディアの寿命にも影響してきます。このため、アプリケーションはなるべく大きなブロック(クラスタ サイズまたは
2の累乗セクタ境界にアライメントした)で読み書きを行う必要があります。もちろん、アプリケーションからメディアに至る全てのレイヤがマルチ セクタ転送に対応していないと意味がありません。残念ながら、既存のオープン ソースのドライバの多くはマルチ セクタ転送に未対応です。なお、FatFsモジュールおよびサンプル ドライバはマルチ セクタ転送に対応しています。
</p>
221 <p>通常のファイル消去では、記録されたデータに対して何らかの制御が行われるわけではなく、単にFAT上に未使用クラスタとして記録されているだけです。このため、ファイルが消去されたあともそれらは有効なメモリ ブロックとしてフラッシュ メモリ上に残ります。そこで、ファイルを消去するとき、占有していたデータ セクタを明示的に消去(つまり未使用ブロックにする)することにより、メディア内の空きブロックを増やすことができます。これにより、次にそのブロックに書き込むときの消去動作が無くなり、書き込み性能が向上する可能性があります。また、ウェアレベリングに使えるブロックが増え、メディアの耐久性も向上するかも知れません。この機能を有効にするには、構成オプションの
<tt>_USE_TRIM
</tt>に
1を設定します。これはフラッシュ メモリ メディアの内部動作に期待した制御なので、効果があるとは限りません。また、ファイル消去の時間が延びることも考慮に入れるべきです。
</p>
224 <div class=
"para" id=
"critical">
226 <p>ストレージ上のFAT構造を操作している途中で、停電、不正なメディアの取り外し、回復不能なデータ エラー等の障害が発生すると、処理が中途半端な状態で中断され、その結果としてFATボリュームの構造が破壊される可能性があります。次にFatFsモジュールにおけるクリチカル セクションと、その間の障害により起きうるエラーの状態を示します。
</p>
228 図
4. 長いクリチカル セクション
<br>
229 <img src=
"../img/f4.png" width=
"320" height=
"436" alt=
"fig.4">
232 図
5. 最小化したクリチカル セクション
<br>
233 <img src=
"../img/f5.png" width=
"320" height=
"436" alt=
"fig.5">
236 <p>赤で示したセクションを実行中に障害が発生した場合、クロス リンクが発生して操作対象のファイル ディレクトリが失われる可能性があります。黄色で示したセクションを実行中に障害が発生した場合、つぎのうちいずれかまたは複数の結果が生じる可能性があります。
</p>
238 <li>書き換え中のファイルのデータが破壊される。
</li>
239 <li>追記中のファイルがオープン前の状態に戻る。
</li>
240 <li>新規に作成されたファイルが消える。
</li>
241 <li>新規または上書きで作成されたファイルの長さがゼロになって残る。
</li>
242 <li>ロストチェーンの発生によりボリュームの利用効率が悪化する。
</li>
244 <p>いずれも書き込み中や操作の対象でないファイルには影響はありません。これらのクリチカル セクションは、ファイルを書き込みモードで開いている時間を最小限にするか、
<tt>f_sync()
</tt>を適宜使用することで図
5のようにリスクを最小化することができます。
</p>
247 <div class=
"para" id=
"fs3">
249 <p>FatFs APIの拡張的使用例です。有用なコードがあった場合は、随時追加していきます。。
</p>
251 <li><a href=
"../img/app1.c">追記モードでのオープン/新規作成
</a></li>
252 <li><a href=
"../img/app2.c">ディレクトリを空にする
</a></li>
253 <li><a href=
"../img/app3.c">ファイルに連続領域を割り当てる
</a></li>
254 <li><a href=
"../img/app4.c">ディスクI/Oモジュールの機能/互換性チェッカー
</a></li>
255 <li><a href=
"../img/mkfatimg.zip">FATイメージ作成ツール
</a></li>
259 <div class=
"para" id=
"license">
260 <h3>FatFsのライセンスについて
</h3>
261 <p>ソース ファイルのヘッダにライセンス条件が記述されているので、利用の際はそれに従うこと。英語を読めない方のために以下に日本語訳を示しておきます。
</p>
262 <pre>/*----------------------------------------------------------------------------/
263 / FatFs - FAT file system module R0.10b (C)ChaN,
2014
264 /-----------------------------------------------------------------------------/
265 / FatFsモジュールは、小規模な組み込みシステム向けの汎用FATファイルシステム
266 / モジュールです。これはフリー ソフトウェアとして、教育・研究・開発のために
267 / 以下のライセンス ポリシーの下で公開されています。
269 / Copyright (C)
2014, ChaN, all right reserved.
271 / * FatFsモジュールはフリー ソフトウェアであり、また
<em>無保証です
</em>。
272 / * 用途に制限はありません。
<em>あなたの責任の下において
</em>、個人的・非営利的な
273 / ものから商用製品の開発に及ぶ目的に使用・改変・再配布することができます。
274 / * ソース コードを再配布するときは、上記の著作権表示を保持しなければなりません。
276 /-----------------------------------------------------------------------------/
</pre>
277 <p>要するにFatFsはタダで自由に使えるということです。ソース コードを再配布するときは、このブロックをそのまま保持しておくこと。このようにFatFsはBSDライクなライセンスとしていますが、一つ大きな違いがあります。特に組み込み用途での利用価値を高めるため、バイナリ形式(ソース コードを含まない形式全て)での再配布については、条件は設けていません。その場合は、FatFsおよびそのライセンス文書についてはドキュメントに明記してもしなくてもかまいません。これは、一条項BSDライセンスと等価ということです。もちろんGNU GPLプロジェクトとも共存可能です。何らかの変更を加えて再配布する際は、矛盾しない他のライセンス(GNU GPLや修正BSDライセンスなど)に変更することも可能です。
</p>
280 <p class=
"foot"><a href=
"../00index_j.html">戻る
</a></p>