diff options
Diffstat (limited to 'thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja')
51 files changed, 4458 insertions, 0 deletions
diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/appnote.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/appnote.html new file mode 100644 index 0000000..06cd95e --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/appnote.html @@ -0,0 +1,283 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/appnote.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFsモジュール アプリケーション ノート</title> +</head> + +<body> +<h1>FatFsモジュール アプリケーション ノート</h1> +<ol class="toc"> +<li><a href="#port">ポーティングの際に配慮すべきこと</a></li> +<li><a href="#limits">限界値</a></li> +<li><a href="#memory">メモリ使用量</a></li> +<li><a href="#reduce">モジュール サイズの縮小</a></li> +<li><a href="#lfn">長いファイル名</a></li> +<li><a href="#exfat">exFATファイルシステム</a></li> +<li><a href="#unicode">Unicode入出力への対応</a></li> +<li><a href="#reentrant">リエントランシー</a></li> +<li><a href="#dup">多重ファイル アクセス</a></li> +<li><a href="#fs1">効率的なファイル アクセス</a></li> +<li><a href="#fs2">フラッシュ メモリの特性への配慮</a></li> +<li><a href="#critical">クリチカル セクション</a></li> +<li><a href="#fs3">APIの拡張的使用例</a></li> +<li><a href="#license">FatFsのライセンスについて</a></li> +</ol> + +<div class="para doc" id="port"> +<h3>ポーティングの際に配慮すべきこと</h3> + +<h4>ポーティングの際の前提条件</h4> +<p>FatFsモジュールはポータビリティに関して次の点を前提としています。</p> +<ul> +<li>処理系はANSI C準拠であること。<br> +FatFsモジュールはANSI C(C89)準拠で記述されているので、普通のCコンパイラなら特に処理系依存になる点はありません。</li> +<li>char/short/longのサイズは、それぞれ8/16/32ビットで、intは16または32ビットであること。<br> +これについても、まっとうな処理系なら問題ないはずです。FatFsモジュールで使用されるサイズを明示する整数型が integer.h 内で定義されていますが、既存の定義と衝突した場合はユーザによって解決されなければなりません。</li> +</ul> + +<h4>システム構成</h4> +<p>下に示す依存関係図は、FatFsモジュール利用の組み込みシステムにおける代表的な構成を示します。</p> +<p><img src="../res/modules.png" width="580" height="280" alt="システム構成図"></p> +<p>(a) FatFs用に書かれたディスク モジュールがある場合は、そのまま追加するだけです。 (b) しかし、多くの既存のディスク モジュールはそのAPIをFatFsに合わせるため、グルー関数が必要になるでしょう。</p> +<p><img src="../res/funcs.png" width="750" height="420" alt="functional diagram"></p> + +<h4>ユーザの作成する関数</h4> +<p>ポーティング作業は、要求されるデバイス制御関数を用意することが全てで、それ以外にすることは何もありません。既に動作しているデバイス制御モジュールがあるなら、そのインターフェースをFatFsに合わせるかグルー関数を介してつなぐだけで済みますが、無い場合はほかから移植するか最初から書くかする必要があります。定義されている全ての関数が常に必要なわけではありません。例えば、リード オンリ構成では書き込み系関数は必要ありません。次の表に構成オプションと要求される関数の対応を示します。</p> +<table class="lst2"> +<tr><th>必要な関数</th><th>必要となる条件</th><th>備考</th></tr> +<tr><td>disk_status<br>disk_initialize<br>disk_read</td><td>常時</td><td rowspan="5">ffsample.zip (サンプル)<br>その他web上に多数</td></tr> +<tr><td>disk_write<br>get_fattime<br>disk_ioctl (CTRL_SYNC)</td><td>_FS_READONLY == 0</td></tr> +<tr><td>disk_ioctl (GET_SECTOR_COUNT)<br>disk_ioctl (GET_BLOCK_SIZE)</td><td>_USE_MKFS == 1</td></tr> +<tr><td>disk_ioctl (GET_SECTOR_SIZE)</td><td>_MAX_SS != _MIN_SS</td></tr> +<tr><td>disk_ioctl (CTRL_TRIM)</td><td>_USE_TRIM == 1</td></tr> +<tr><td>ff_convert<br>ff_wtoupper</td><td>_USE_LFN != 0</td><td>option/unicode.cをプロジェクトに<br>加えればよい</td></tr> +<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> +<tr><td>ff_mem_alloc<br>ff_mem_free</td><td>_USE_LFN == 3</td></tr> +</table> +</div> + +<div class="para doc" id="limits"> +<h3>限界値</h3> +<ul> +<li>ファイルシステム: FAT12, FAT16, FAT32(r0.0) および exFAT(r1.0)。</li> +<li>同時オープン ファイル数: 無制限。(利用可能メモリによる)</li> +<li>同時マウント ボリューム数: 最大 10。</li> +<li>ファイル サイズ: 最大 4GiB - 1 (FATボリューム) および、事実上無制限(exFATボリューム)。</li> +<li>ボリューム サイズ: 最大 2TiB (512B/セクタ時)。</li> +<li>クラスタ サイズ: 最大 128セクタ (FATボリューム) および、最大 16MiB (exFATボリューム)。</li> +<li>セクタ サイズ: 512B, 1KiB, 2KiB, 4KiB。</li> +</ul> +</div> + +<div class="para doc" id="memory"> +<h3>メモリ使用量</h3> +<p>次の表にいくつかのターゲットにおけるメモリ使用量の例を示します。テスト時の構成オプションはその下の通りです。数値の単位はバイトで、<em>V</em>はボリューム数、<em>F</em>は同時オープン ファイル数を示します。コンパイラの最適化オプションはコード サイズとしています。</p> +<table class="lst2"> +<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> +<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>MSC</td></tr> +<!-- ARM Thumb CM3 AVR H8 PIC24 RL78 V850ES SH-2A RX600 IA-32 --> +<tr class="ral"><td class="cal">text (Full, R/W)</td><td>10.4k</td><td>6.8k</td><td>6.3k</td><td>12.4k</td> <td>9.8k</td><td>11.1k</td><td>12.8k</td><td>8.6k</td><td>8.9k</td><td>6.4k</td><td>8.5k</td></tr> +<tr class="ral"><td class="cal">text (Min, R/W)</td> <td>6.8k</td><td>4.6k</td><td>4.3k</td> <td>8.2k</td> <td>6.7k</td> <td>7.6k</td> <td>9.1k</td><td>6.0k</td><td>5.9k</td><td>4.5k</td><td>5.9k</td></tr> +<tr class="ral"><td class="cal">text (Full, R/O)</td> <td>4.8k</td><td>3.1k</td><td>2.8k</td> <td>5.6k</td> <td>4.6k</td> <td>5.3k</td> <td>6.3k</td><td>4.0k</td><td>3.9k</td><td>3.0k</td><td>3.9k</td></tr> +<tr class="ral"><td class="cal">text (Min, R/O)</td> <td>3.6k</td><td>2.4k</td><td>2.3k</td> <td>4.4k</td> <td>3.5k</td> <td>4.0k</td> <td>4.9k</td><td>3.3k</td><td>3.0k</td><td>2.4k</td><td>3.1k</td></tr> +<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> +<tr class="ral"><td class="cal">Work area<br><small>(_FS_TINY == 0)</small></td><td>V*564<br>+ F*552</td><td>V*564<br>+ F*552</td><td>V*564<br>+ F*552</td><td>V*560<br>+ F*546</td><td>V*560<br>+ F*546</td><td>V*560<br>+ F*546</td><td>V*560<br>+ F*546</td><td>V*564<br>+ F*552</td><td>V*564<br>+ F*552</td><td>V*564<br>+ F*552</td><td>V*564<br>+ F*552</td></tr> +<tr class="ral"><td class="cal">Work area<br><small>(_FS_TINY == 1)</small></td><td>V*564<br>+ F*40</td><td>V*564<br>+ F*40</td><td>V*564<br>+ F*40</td><td>V*560<br>+ F*34</td><td>V*560<br>+ F*34</td><td>V*560<br>+ F*34</td><td>V*560<br>+ F*34</td><td>V*564<br>+ F*40</td><td>V*564<br>+ F*40</td><td>V*564<br>+ F*40</td><td>V*564<br>+ F*40</td></tr> +</table> +<pre> +FatFs R0.12b options: +_FS_READONLY 0 (R/W) or 1 (R/O) +_FS_MINIMIZE 0 (Full, with all basic functions) or 3 (Min, with fully minimized) +_FS_TINY 0 (Default) or 1 (Tiny file object) +And any other options are left not changed from default setting. +</pre> +</div> + +<div class="para doc" id="reduce"> +<h3>モジュール サイズの縮小</h3> +<p>次の表は<a href="config.html">構成オプション</a>の設定値によりどの機能が削除されるかを示します。API関数の行にxが無ければその関数は使用可能です。</p> +<table class="lst2"> +<tr><td rowspan="2">Function</td><td colspan="4">_FS_<br>MINIMIZE</td><td colspan="2">_FS_<br>READONLY</td><td colspan="2">_USE_<br>STRFUNC</td><td colspan="3">_FS_<br>RPATH</td><td colspan="2">_USE_<br>FIND</td><td colspan="2">_USE_<br>CHMOD</td><td colspan="2">_USE_<br>EXPAND</td><td colspan="2">_USE_<br>LABEL</td><td colspan="2">_USE_<br>MKFS</td><td colspan="2">_USE_<br>FORWARD</td><td colspan="2">_MULTI_<br>PARTITION</td></tr> +<tr> <td>0</td><td>1</td><td>2</td><td>3</td><td>0</td><td>1</td><td>0</td><td>1</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</td><td>1</td><td>0</td><td>1</td><td>0</td><td>1</td><td>0</td><td>1</td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<tr><td>f_findfirst</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>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> +<tr><td>f_findnext</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>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> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<tr><td>f_chmod</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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<tr><td>f_utime</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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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> </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> +<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> </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> +<tr><td>f_expand</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>x</td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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> </td><td> </td><td> </td><td> </td><td> </td><td> </td><td>x</td><td> </td><td> </td><td> </td></tr> +<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> </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> +<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> </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> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +<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><td> </td><td> </td><td> </td><td> </td><td> </td><td> </td></tr> +</table> +</div> + +<div class="para doc" id="lfn"> +<h3>長いファイル名</h3> +<p>FatFsモジュールは、長いファイル名(LFN)をサポートします。ファイルに付けられた2つの異なる名前(短いファル名と長いファイル名)は、<tt>f_readdir</tt>関数を除くファイル操作関数において透過です。デフォルト構成では、LFN機能はOFFになっています。LFN機能を有効にするには、<tt><a href="config.html#use_lfn">_USE_LFN</a></tt>を1,2または3に設定し、<tt>option/unicode.c</tt>をプロジェクトに追加します。LFN機能は、加えてある程度のワーク エリア(LFN操作バッファ)を必要とします。バッファ長は使用できるメモリに応じて<tt><a href="config.html#max_lfn">_MAX_LFN</a></tt>で構成されることができます。LFNの長さは最大255文字に達するので、LFN完全対応のためには<tt>_MAX_LFN</tt>は255に設定されるべきです。与えられたファイル名に対してバッファ長が不足した場合、ファイル関数は<tt>FR_INVALID_NAME</tt>で失敗します。</p> +<p>ファイル関数に再入を行う条件の下でLFN機能を使用する場合は、<tt>_USE_LFN</tt>は2または3に設定されなければなりません。この場合、ファイル関数はワーク エリアを動的に確保(スタックまたはヒープ)します。ワーク エリアのサイズは、<tt>(_MAX_LFN + 1) * 2</tt>バイト(exFAT利用時はさらに+608バイト)になるので、スタック等のサイズはそれを考慮した十分な余裕がなければなりません。</p> +<table class="lst2 rset"> +<caption>LFN構成 at CM3</caption> +<tr><th><tt>_CODE_PAGE</tt></th><th>追加コード</th></tr> +<tr><td>SBCS</td><td>+2.8K</td></tr> +<tr><td>932(Shift_JIS)</td><td>+62.6k</td></tr> +<tr><td>936(GBK)</td><td>+177k</td></tr> +<tr><td>949(Korean)</td><td>+139k</td></tr> +<tr><td>950(Big5)</td><td>+111k</td></tr> +</table> +<p>LFN機能の上手な使い方は、それを使わないということです。実際、組み込み用途ではLFN機能がどうしても必要になるということはほとんど無いはずです。LFNを有効にすると、選択されたコード ページに応じてモジュール サイズが増大します。右の表に各コード ページにおけるLFNを有効にしたときのモジュール サイズの違いを示します。特に、CJK地域では数万の文字が使われていますが、不幸なことにそれは巨大なOEM－Unicode相互変換テーブルを要求し、モジュール サイズは劇的に増大します。その結果、それらのコード ページにおいてLFNを有効にしたFatFsモジュールは、多くの8ビット マイコンにインプリメントすることができません。</p> +<p>LFN機能のハードルはそれだけではありません。マイクロソフト社はFATファイルシステムについていくつかの特許を保有しています。いずれもLFN機能の実装に関するもので、その利用に対して$0.25/unitのライセンス料を要求しています。このため、商用製品でLFN機能を利用する場合は、製品の最終仕向地によってはライセンスが必要になります。最近のFAT32ドライバの多くはLFN機能を含んでいるため、それらの使用に当たってライセンスが必要になりますが、FatFsは構成オプションでLFN機能を任意にON/OFFできるため、無効にしてライセンス問題を回避することもできます。</p> +</div> + +<div class="para doc" id="unicode"> +<h3>Unicode入出力への対応</h3> +<p>FatFs API上におけるファイル名等の文字列データの入出力は、デフォルトではANSI/OEMコードで行われますが、これをUnicode(UTF-16)に切り替えることもできます(<tt><a href="config.html#lfn_unicode">_LFN_UNICODE</a></tt>で設定)。つまり、これはFatFsがLFN機能に完全対応していることを意味します。Unicodeのファイル名に関する詳細は、<a href="filename.html#uni">パス名のフォーマット</a>を参照してください。</p> +</div> + +<div class="para doc" id="exfat"> +<h3>exFATファイルシステム</h3> +<p>exFAT(Microsoft's Extended File Allocation Table)ファイルシステムは、既に組み込みシステムや情報家電で広く使われているFATファイルシステムを置き換える目的で開発されました。exFATは、64GiB以上のSDメモリ カードで標準ファイルシステムに採用されるなど、FATに並びリムーバブル メディアの標準ファイルシステムの一つとなりつつあります。</p> +<p>exFATボリュームでは、FATボリュームで制約となっていた4GiB以上のサイズのファイルを扱え、ファイルシステムのオーバーヘッド(特にファイル アロケーション ディレイ)も大幅に低減され、書き込みスループットがFATより向上しています。しかし、現リビジョンのFatFsでは、実装上の理由から不連続ファイルへのサイズ拡大を伴う書き込み時のとき、スループットがFATより低下します。<tt>f_expand</tt>関数による連続領域の割り当て機能は、この問題の回避に有効かもしれません。</p> +<p>exFATはマイクロソフト社が開発したものなので、マイクロソフト社はexFATについていくつかの特許を保有しています。FatFsのexFAT機能は、それの US. Pat. App. Pub. No. 2009/0164440 A1 に基づいた実装です。このため、商用製品でexFAT機能を利用する場合、製品の最終仕向地によってはライセンスが必要になります。最近のFATドライバの多くはexFAT機能を含んでいるため、それらの使用に当たってライセンスが必要になりますが、FatFsは構成オプションでexFAT機能を任意にON/OFFできるため、無効にしてライセンス問題を回避することもできます。</p> +<p><em>exFATを有効にすると、FatFsモジュールのC89互換は失われます(64ビット整数型が必要なため)。</em></p> +</div> + +<div class="para doc" id="reentrant"> +<h3>リエントランシー</h3> +<p>互いに異なるボリュームに対するファイル操作は、<tt>_USE_LFN == 1</tt>を除いて構成にかかわらずリエントラントで、常に同時平行に動作できます。</p> +<p>同じボリュームに対してはデフォルトではリエントラントではありませんが、<tt><a href="config.html#fs_reentrant">_FS_REENTRANT</a></tt>でリエントラント(スレッド セーフ)にすることはできます。この場合、OS依存の同期オブジェクト操作関数<tt>ff_cre_syncobj, ff_del_syncobj, ff_req_grant, ff_rel_grant</tt>関数もまたプロジェクトに追加されなければなりません。サンプル コードと解説は<tt>option/syncobj.c</tt>にあります。</p> +<p>この場合、あるタスクがボリュームを使用中に他のタスクからそのボリュームに対するファイル関数が呼び出されると、そのアクセスは先のタスクがファイル関数を抜けるまでサスペンドされます。待ち時間が<tt>_TIMEOUT</tt>で指定された期間を越えた場合、その関数は<tt>FR_TIMEOUT</tt>でアボートします。いくつかのRTOSではタイムアウト機能はサポートされないかも知れません。</p> +<p>ひとつの例外が<tt>f_mount, f_mkfs, f_fdisk</tt>関数にあります。これらのボリューム制御関数は同じボリューム(または関連する物理ドライブ)に対してリエントラントではありません。これらの関数を使用するときは、アプリケーション レベルで排他制御しなければなりません。</p> +<p>注: このセクションはFatFsモジュールそれ自体のリエントランシーについて説明しています。<tt>_FS_REENTRANT</tt>は、各ファイルシステム オブジェクトの排他制御を行うのみで、下位のディスク関数への再入を防止するものではありません。たとえば、シングル ボリューム構成では<tt>disk_status</tt>関数のみ再入される可能性があり、マルチ ボリューム構成ではどのディスク関数も再入される可能性があります。このように、複数のタスクから同時にFatFs APIを使う条件では、ディスクI/Oモジュールはスレッド セーフである必要があります。</p> +</div> + +<div class="para doc" id="dup"> +<h3>多重ファイル アクセス</h3> +<p>FatFsモジュールではデフォルトでは多重アクセス制御機能をサポートしていません。ファイルに対する多重アクセスは、そのアクセス モードによって制限されます。一つのファイルに対する多重オープンは、それらが全てリード モードのときに限って許可されます。書き込みモードを含む多重オープン、また開かれているファイルに対するリネームや削除を行ってはなりません。さもないと、そのボリュームのFAT構造が破壊される可能性があります。</p> +<p><tt><a href="config.html#fs_lock">_FS_LOCK</a></tt>に1以上の値(値は同時に管理できるファイル数)をセットすることで多重アクセス制御機能が有効になり、ファイル単位のアクセス制御を自動で行うこともできます。この場合、上記のルールを破ったオープン・リネーム・削除を試みると、その関数は<tt>FR_LOCKED</tt>で失敗します。また、<tt>_FS_LOCK</tt>を越える数のファイルやサブ ディレクトリを同時にオープンしようとすると、<tt>FR_TOO_MANY_OPEN_FILES</tt>で失敗します。</p> +</div> + +<div class="para doc" id="fs1"> +<h3>効率的なファイル アクセス</h3> +<p>小規模な組込システムでのファイルの読み書きにおける効率の良いアクセスのため、アプリケーション プログラマはFatFsモジュールの中でどのような処理が行われているか考慮すべきです。ストレージ上のデータは<tt>f_read</tt>関数により次のシーケンスで転送されます。</p> +<p>図1. セクタ ミスアラインド リード (ショート)<br> +<img src="../res/f1.png" width="490" height="110" alt="fig.1"> +</p> +<p>図2. セクタ ミスアラインド リード (ロング)<br> +<img src="../res/f2.png" width="490" height="140" alt="fig.2"> +</p> +<p>図3. セクタ アラインド リード<br> +<img src="../res/f3.png" width="490" height="119" alt="fig.3"> +</p> +<p>ファイルI/Oバッファはセクタの一部のデータを読み書きするためのセクタ バッファを意味します。セクタ バッファは、それぞれのファイル オブジェクト内のプライベート セクタ バッファまたはファイルシステム オブジェクト内の共有セクタ バッファのどちらかです。バッファ構成オプションの<tt><a href="config.html#fs_tiny">_FS_TINY</a></tt>は、データ転送にどちらを使うかを決定します。タイニー バッファ(1)が選択されるとデータ メモリの消費はそれぞれのファイル オブジェクトで<tt>_MAX_SS</tt>バイト減少されます。この場合、FatFsモジュールはファイル データの転送とFAT/ディレクトリ アクセスにファイルシステム オブジェクト内のセクタ バッファだけを使用します。タイニー バッファの欠点は、セクタ バッファにキャッシュされたFATデータがファイル データの転送により失われ、クラスタ境界の毎にリロードされなければならないことです。でも、悪くない性能と少ないメモリ消費の視点から多くのアプリケーションに適するでしょう。</p> +<p>図1はセクタの一部のデータがファイルI/Oバッファを経由で転送されることを示します。図2に示される長いデータの転送では、転送データの中間の1セクタまたはそれ以上のセクタにまたがる転送データがアプリケーション バッファに直接転送されています。図3は転送データ全体がセクタ境界にアライメントされている場合を示しています。この場合、ファイルI/Oバッファは使用されません。直接転送においては最大の範囲のセクタが<tt>disk_read</tt>関数で一度に読み込まれますが、クラスタ境界を越えるマルチ セクタ転送はそれが隣接であっても行われません。</p> +<p>このように、セクタにアライメントしたファイルの読み書きへの配慮はバッファ経由のデータ転送を避け、読み書き性能は改善されるでしょう。その効果に加え、タイニー構成でキャッシュされたFATデータがファイル データの転送によりフラッシュされず、非タイニー構成と同じ性能を小さなメモリ フットプリントで達成できます。</p> +</div> + +<div class="para doc" id="fs2"> +<h3>フラッシュ メモリの特性への配慮</h3> +<p>HDDなどのディスク メディアとは異なり、SDCやCFCなどのフラッシュ メモリ メディアの性能を引き出すには、その特性を意識した制御が必要になります。</p> +<h4>マルチ セクタ書き込み</h4> +<div class="rset"> +図6. マルチ/シングル セクタ ライトの比較<br> +<img src="../res/f6.png" width="630" height="148" alt="fig.6"> +</div> +<p>フラッシュ メモリ メディアの書き込み速度はシングル セクタ書き込みの時に最も低いものになり、一回のトランザクションで転送されるセクタ数が大きくなるほど書き込み速度は向上します(図6)。この効果はバス速度が高速になるほど大きく、10倍以上の差が現れることも珍しくありません。<a href="../res/rwtest2.png">テスト結果</a>は、マルチ セクタ書き込み(W:16K, 32 sectors)がシングル セクタ書き込み(W:100, 1 sector)よりどの程度速いかを明確に示しています。大容量メディアほどシングル セクタ書き込みが遅くなる点もまた重要です。書き込みトランザクションの回数はまた、メディアの寿命にも影響してきます。つまり、同じ量のデータを書き込む場合、図6上のシングル セクタ書き込みは、図6下のマルチ セクタ書き込みに比べて16倍早くフラッシュ メモリ メディアを消耗させてしまうということです。</p> +<p>このように、アプリケーションはなるべく大きなブロック(クラスタ サイズまたは2の累乗セクタ境界にアライメントした)で読み書きを行う必要があります。もちろん、アプリケーションからメディアに至る全てのレイヤがマルチ セクタ転送に対応していないと意味がありません。残念ながら、既存のオープン ソースのドライバの多くはマルチ セクタ転送に未対応です。なお、FatFsモジュールおよびサンプル ドライバはマルチ セクタ転送に対応しています。</p> +<h4>明示的なメモリ消去</h4> +<p>通常のファイル消去では、記録されたデータに対して何らかの処理が行われるわけではなく、単にFAT上にその領域を未使用と記録しているだけです。このため、ファイルが消去されたあともそれらは有効なデータ ブロックとしてフラッシュ メモリ上に残ります。そこで、ファイルを消去するとき、占有していたデータ セクタを明示的に消去(つまり未使用ブロックにする)することにより、メディア内の空きブロックを増やすことができます。これにより、次にそのブロックに書き込むときの消去動作が無くなり、書き込み性能が向上する可能性があります。また、ウェアレベリングに使えるブロックが増え、メディアの耐久性も向上するかも知れません。この機能を有効にするには、<tt><a href="config.html#use_trim">_USE_TRIM</a></tt>に1を設定します。これはフラッシュ メモリ ドライブの内部動作に期待した制御なので、効果があるとは限りません。また、ファイル消去の時間が延びることも考慮に入れるべきです。</p> +</div> + +<div class="para doc" id="critical"> +<h3>クリチカル セクション</h3> +<p>ストレージ上のFAT構造を操作している途中で、停電、不正なメディアの取り外し、回復不能なデータ エラー等の障害が発生すると、処理が中途半端な状態で中断され、その結果としてFATボリュームの構造が破壊される可能性があります。次にFatFsモジュールにおけるクリチカル セクションと、その間の障害により起きうるエラーの状態を示します。</p> +<div class="lset"> +図4. 長いクリチカル セクション<br> +<img src="../res/f4.png" width="320" height="436" alt="fig.4"> +</div> +<div class="lset"> +図5. 最小化したクリチカル セクション<br> +<img src="../res/f5.png" width="320" height="436" alt="fig.5"> +</div> +<br class="clr"> +<p>赤で示したセクションを実行中に中断が発生した場合、クロス リンクが発生して操作中のファイルやディレクトリが失われる可能性があります。黄色で示したセクションを実行中に中断が発生した場合、次のうちいずれかまたは複数の結果が生じる可能性があります。</p> +<ul> +<li>ファイルの一部を書き換え中: 書き換えが中途半端な状態となり、結果データが破壊される。</li> +<li>追記モードでデータ記録中: ファイルが記録開始の前の状態に戻る。</li> +<li>新規作成したファイルに記録中: そのファイルが消える。</li> +<li>新規または上書きで作成したファイルに記録中: ファイルの長さがゼロになって残る。</li> +<li>これらの障害の結果、ロスト クラスタが発生してボリュームの利用効率が悪化する。</li> +</ul> +<p>いずれの場合も操作の対象でないファイルには影響はありません。これらのクリチカル セクションは、ファイルを書き込みモードで開いている時間を最小限にするか、<tt>f_sync</tt>関数を適宜使用することで図5のようにリスクを最小化することができます。</p> +</div> + +<div class="para doc" id="fs3"> +<h3>APIの拡張的使用例</h3> +<p>FatFs APIの拡張的使用例です。有用なコードがあった場合は、随時追加していきます。。</p> +<ol> +<li><a href="../res/app1.c">追記モードでのオープン/新規作成</a>(R0.12以前)</li> +<li><a href="../res/app2.c">ディレクトリを空にする</a></li> +<li><a href="../res/app3.c">ファイルに連続領域を割り当てる</a>(R0.11a以前)</li> +<li><a href="../res/app4.c">ディスクI/Oモジュールの機能/互換性チェッカー</a></li> +<li><a href="../res/mkfatimg.zip">FATイメージ作成ツール</a></li> +</ol> +</div> + +<div class="para doc" id="license"> +<h3>FatFsのライセンスについて</h3> +<p>FatFsは、作者(ChaN)の個人プロジェクトとして開発されています。現在までのリビジョンにおいてコントリビューターはいないため、作者以外の書いたソース コードは含まれません。ソース ファイルにライセンス条件が記述されているので、利用の際はそれに従うこと。原文は英語ですが、参考までに以下に日本語訳を示しておきます。</p> +<pre> +/*----------------------------------------------------------------------------/ +/ FatFs - Generic FAT file system module R0.12a / +/-----------------------------------------------------------------------------/ +/ +/ Copyright (C) 2016, ChaN, all right reserved. +/ +/ FatFsモジュールはオープンソースソフトウェアです。FatFsの再配布および使用は、 +/ ソースコードかバイナリ形式か、また変更の有無にかかわらず、次の条件が満たされ +/ る場合に限り許可されます。 +/ +/ 1. ソースコードで再配布するときは、その中に上記の著作権表示、この条件、および +/ 次の免責事項を保持すること。 +/ +/ このソフトウェアは、著作権者らおよびコントリビューターらによって<em>現状のまま</em> +/ 提供されており、<em>いかなる保証もありません</em>。 +/ 著作権者もコントリビューターも、このソフトウェアの使用により発生するいかなる +/ 損害についても、<em>責任を負いません</em>。 +/----------------------------------------------------------------------------*/ +</pre> +<p>このようにFatFsはBSDライクなライセンスとしていますが、一つ大きな違いがあります。FatFsは主に組み込み向けとして開発されたため、バイナリ形式(ソース コードを含まない形式全て)での再配布については、商用での使いやすさを考慮して配布時の条件を設けていません。つまり、バイナリ配布の場合は、FatFsおよびそのライセンス文書についてドキュメントに明記してもしなくてもかまいません。これは、一条項BSDライセンスと等価ということです。もちろん、GNU GPLなどほとんど全てのオープン ソース ライセンスの下のプロジェクトにおいて共存可能です。FatFsからフォークを作成し公開する場合は、矛盾しない他のオープン ソース ライセンス(GNU GPLや修正BSDライセンスなど)に変更することも可能です。</p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chdir.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chdir.html new file mode 100644 index 0000000..1d42e48 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chdir.html @@ -0,0 +1,81 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/chdir.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_chdir</title> +</head> + +<body> + +<div class="para func"> +<h2>f_chdir</h2> +<p>カレント ディレクトリを変更します。</p> +<pre> +FRESULT f_chdir ( + const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] ディレクトリ名へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>移動対象のディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列を指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>各ボリュームのカレント ディレクトリを変更します。カレント ディレクトリは、そのボリュームのマウント動作が行われたとき、ルート ディレクトリに初期設定されます。カレント ディレクトリは、ファイル システム オブジェクトに保持されるため、そのボリュームを使用する全てのタスクに対して影響を与えます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_RPATH == 1</tt>のときに使用可能となります。</p> +</div> + + +<div class="para exa"> +<h4>使用例</h4> +<pre> + <span class="c">/* カレント ドライブのカレント ディレクトリを変更 (ルート下のdir1へ) */</span> + f_chdir("/dir1"); + + <span class="c">/* ドライブ2のカレント ディレクトリを変更 (親ディレクトリへ) */</span> + f_chdir("2:.."); +</pre> +</div> + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="chdrive.html">f_chdrive</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chdrive.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chdrive.html new file mode 100644 index 0000000..fd93188 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chdrive.html @@ -0,0 +1,61 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/chdrive.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_chdrive</title> +</head> + +<body> + +<div class="para func"> +<h2>f_chdrive</h2> +<p>カレント ドライブを変更します。</p> +<pre> +FRESULT f_chdrive ( + const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] 対象ドライブを指定します */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>カレント ドライブに設定する<a href="filename.html">論理ドライブ番号</a>を指定するパス名を指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>カレント ドライブを変更します。システム起動時の初期値はドライブ0です。この設定はFatFsモジュールの静的変数に記録されるため、全てのタスクに対して影響を与えます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_RPATH == 1</tt>で、且つ<tt>_VOLUMES > 1</tt>のときに使用可能となります。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="chdir.html">f_chdir</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">Return</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chmod.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chmod.html new file mode 100644 index 0000000..226725e --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/chmod.html @@ -0,0 +1,83 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/chmod.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_chmod</title> +</head> + +<body> + +<div class="para func"> +<h2>f_chmod</h2> +<p>ファイルまたはサブ ディレクトリの属性を変更します。</p> +<pre> +FRESULT f_chmod ( + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] オブジェクト名へのポインタ */</span> + BYTE <span class="arg">attr</span>, <span class="c">/* [IN] 設定値 */</span> + BYTE <span class="arg">mask</span> <span class="c">/* [IN] 変更マスク */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>属性変更対象のオブジェクトの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列を指定します。</dd> +<dt>attr</dt> +<dd>設定する属性。指定可能な属性は次の通りで、これらの組み合わせで指定します。指定されなかった属性は解除されます。<br> +<table class="lst"> +<tr><th>値</th><th>意味</th></tr> +<tr><td>AM_RDO</td><td>リード オンリー</td></tr> +<tr><td>AM_ARC</td><td>アーカイブ</td></tr> +<tr><td>AM_SYS</td><td>システム</td></tr> +<tr><td>AM_HID</td><td>ヒドゥン</td></tr> +</table> +</dd> +<dt>mask</dt> +<dd>変更する属性のマスク。指定した属性が設定または解除され、指定されなかった属性は状態が保持されます。<tt class="arg">attr</tt>と同じ値を使います。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#lo">FR_LOCKED</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のとき使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + <span class="c">/* リードオンリーをセット、アーカイブをクリア、その他は変更しない */</span> + f_chmod("file.txt", AM_RDO, AM_RDO | AM_ARC); +</pre> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/close.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/close.html new file mode 100644 index 0000000..e9e2168 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/close.html @@ -0,0 +1,65 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/close.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_close</title> +</head> + +<body> + +<div class="para func"> +<h2>f_close</h2> +<p>ファイルを閉じます。</p> +<pre> +FRESULT f_close ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクトへのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>閉じようとするファイルのファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ファイルを閉じます。何らかの書き込みの行われたファイルの場合、キャッシュされた状態(リード/ライト バッファ上のデータ、変更されたFATやディレクトリ項目)はディスクに書き戻されます。関数が正常終了すると、そのファイル オブジェクトは無効になり、そのメモリも解放できます。</p> +<p>ファイル オブジェクトが読み出し専用モードで、<tt>_FS_LOCK</tt>オプションが選択されていない場合は、ファイルを閉じずにファイル オブジェクトを破棄することもできます。しかし、これは将来の互換性の点で推奨はされません。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>全ての構成で使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="write.html">f_write</a>, <a href="sync.html">f_sync</a>, <a href="sfile.html">FIL</a>, <a href="sfatfs.html">FATFS</a></tt> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/closedir.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/closedir.html new file mode 100644 index 0000000..8b2a476 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/closedir.html @@ -0,0 +1,64 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/close.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_closedir</title> +</head> + +<body> + +<div class="para func"> +<h2>f_closedir</h2> +<p>ディレクトリを閉じます。</p> +<pre> +FRESULT f_closedir ( + DIR* <span class="arg">dp</span> <span class="c">/* [IN] ディレクトリ オブジェクトへのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>dp</dt> +<dd>閉じようとするディレクトリのディレクトリ オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ディレクトリを閉じます。関数が正常終了すると、そのディレクトリ オブジェクトは無効になり、そのメモリも解放できます。</p> +<p><tt>_FS_LOCK</tt>オプションが選択されていない場合は、この処理を行わずにディレクトリ オブジェクトを破棄することもできます。しかし、これは将来の互換性の点で推奨はされません。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_MINIMIZE <= 1</tt>のとき使用可能になります。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<tt><a href="opendir.html">f_opendir</a>, <a href="readdir.html">f_readdir</a>, <a href="sdir.html">DIR</a></tt> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/config.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/config.html new file mode 100644 index 0000000..a698d66 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/config.html @@ -0,0 +1,209 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/config.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<style type="text/css" media="screen" title="ELM Default"> +div.doc h3 {margin-top: 4em } +div.doc h4 {margin-top: 2em } +</style> +<title>FatFs - 構成オプション</title> +</head> + +<body> +<h1>構成オプション</h1> +<p>FatFsには多くの構成オプションがあり、それぞれのプロジェクトの要求に応じて柔軟に機能を構成することができます。構成オプションは、<tt>ffconf.h</tt>に記述されます。</p> + +<div class="para doc" id="func"> +<h3>基本機能の設定</h3> + +<h4 id="fs_readonly">_FS_READONLY</h4> +<p>0:リード/ライト or 1:リード オンリ。リード オンリ構成では、<tt>f_write</tt>、<tt>f_sync</tt>、<tt>f_unlink</tt>、<tt>f_mkdir</tt>、<tt>f_chmod</tt>、<tt>f_rename</tt>、<tt>f_truncate</tt>、<tt>f_getfree</tt>の基本API関数およびオプションの書き込み系API関数が削除されます。</p> + +<h4 id="fs_minimize">_FS_MINIMIZE</h4> +<p>基本API関数を段階的に削除します。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>0</td><td>全ての基本API関数が利用可能。</td></tr> +<tr><td>1</td><td><tt>f_stat</tt>、<tt>f_getfree</tt>、<tt>f_unlink</tt>、<tt>f_mkdir</tt>、<tt>f_chmod</tt>、<tt>f_utime</tt>、<tt>f_truncate</tt>、<tt>f_rename</tt>関数が削除される。</td></tr> +<tr><td>2</td><td>1に加え、<tt>f_opendir</tt>、<tt>f_readdir</tt>、<tt>f_closedir</tt>関数が削除される。</td></tr> +<tr><td>3</td><td>2に加え、<tt>f_lseek</tt>関数が削除される。</td></tr> +</table> + +<h4 id="use_strfunc">_USE_STRFUNC</h4> +<p>文字列入出力API関数<tt>f_gets</tt>, <tt>f_putc</tt>, <tt>f_puts</tt> and <tt>f_printf</tt>の構成。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>0</td><td>文字列入出力API関数を使用しない。</td></tr> +<tr><td>1</td><td>文字列入出力API関数を使用する。データのLF-CRLF変換はしない。</td></tr> +<tr><td>2</td><td>文字列入出力API関数を使用する。データのLF-CRLF変換をする。</td></tr> +</table> + +<h4 id="use_find">_USE_FIND</h4> +<p>フィルタ付きディレクトリ読み出し機能の構成(0:無効 または 1:有効)。有効にすると、<tt>f_findfirst</tt>、<tt>f_findnext</tt>関数が利用可能になります。<tt>_FS_MINIMIZE</tt>は、1以下でなければなりません。</p> + +<h4 id="use_mkfs">_USE_MKFS</h4> +<p>ボリューム作成機能の構成(0:無効 または 1:有効)。有効にすると<tt>f_mkfs</tt>関数が利用可能になります。</p> + +<h4 id="use_fastseek">_USE_FASTSEEK</h4> +<p>高速シーク機能の構成(0:無効 または 1:有効)。有効にすると、<tt>f_lseek</tt>、<tt>f_read</tt>、<tt>f_write</tt>関数において高速化モードが利用可能になります。詳しくは、<a href="lseek.html">こちら</a>を参照してください。</p> + +<h4 id="use_expand">_USE_EXPAND</h4> +<p>連続領域割り当て機能の構成(0:無効 または 1:有効)。有効にすると<tt>f_expand</tt>関数が利用可能になります。<tt>_FS_READONLY</tt>は0でなければなりません。</p> + +<h4 id="use_chmod">_USE_CHMOD</h4> +<p>メタデータ操作機能の構成(0:無効 または 1:有効)。有効にすると、<tt>f_chmod</tt>、<tt>f_utime</tt>関数が利用可能になります。<tt>_FS_READONLY</tt>は0でなければなりません。</p> + +<h4 id="use_label">_USE_LABEL</h4> +<p>ボリューム ラベル操作機能の構成(0:無効 または 1:有効)。有効にすると、<tt>f_getlabel</tt>、<tt>f_setlabel</tt>関数(<tt>_FS_READONLY == 0</tt>のとき)が利用可能になります。</p> + +<h4 id="use_forward">_USE_FORWARD</h4> +<p>ストリーミング読み出し機能(<tt>f_forward</tt>関数)の構成(0:無効 または 1:有効)。</p> + +</div> + + +<div class="para doc" id="name"> +<h3>名前空間とロケールの設定</h3> + +<h4 id="code_page">_CODE_PAGE</h4> +<p>パス名等の文字列データのコード ページを指定します。不適切な設定は、ファイル オープン エラーの原因になる可能性があります。拡張文字が全く使われない場合は、どれを選んでも同じです。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>1</td><td>ASCII (非LFN構成でのみ有効)</td></tr> +<tr><td>437</td><td>U.S.</td></tr> +<tr><td>720</td><td>Arabic</td></tr> +<tr><td>737</td><td>Greek</td></tr> +<tr><td>771</td><td>KBL</td></tr> +<tr><td>775</td><td>Baltic</td></tr> +<tr><td>850</td><td>Latin 1</td></tr> +<tr><td>852</td><td>Latin 2</td></tr> +<tr><td>855</td><td>Cyrillic</td></tr> +<tr><td>857</td><td>Turkish</td></tr> +<tr><td>860</td><td>Portuguese</td></tr> +<tr><td>861</td><td>Icelandic</td></tr> +<tr><td>862</td><td>Hebrew</td></tr> +<tr><td>863</td><td>Canadian French</td></tr> +<tr><td>864</td><td>Arabic</td></tr> +<tr><td>865</td><td>Nordic</td></tr> +<tr><td>866</td><td>Russian</td></tr> +<tr><td>869</td><td>Greek 2</td></tr> +<tr><td>932</td><td>日本語 (DBCS)</td></tr> +<tr><td>936</td><td>簡体字中国語 (DBCS)</td></tr> +<tr><td>949</td><td>韓国語 (DBCS)</td></tr> +<tr><td>950</td><td>繁体字中国語 (DBCS)</td></tr> +</table> + +<h4 id="use_lfn">_USE_LFN</h4> +<p>LFN(長いファイル名)対応を設定します。LFN機能を有効にするときは、Unicode操作関数<tt>option/unicode.c</tt>をプロジェクトに加える必要があります。また、LFN操作のワーク エリアとして<tt>(_MAX_LFN + 1) * 2</tt>バイト(exFAT構成時はさらに608バイト)を使用します。このため、バッファをスタックに確保するときは、スタック オーバ フローに注意する必要があります。ヒープに確保するときは、メモリ操作関数(<tt>ff_memalloc</tt>と<tt>ff_memfree</tt>(<tt>option/syscall.c</tt>にサンプルあり))をプロジェクトに加える必要があります。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>0</td><td>LFN機能を使わない。8.3形式の名前のみ使用可能。</td></tr> +<tr><td>1</td><td>LFN機能を使う。ワーク エリアは静的に確保。常にスレッド セーフではない。</td></tr> +<tr><td>2</td><td>LFN機能を使う。ワーク エリアはスタックに確保。</td></tr> +<tr><td>3</td><td>LFN機能を使う。ワーク エリアはヒープに確保。</td></tr> +</table> + +<h4 id="max_lfn">_MAX_LFN</h4> +<p>LFN操作バッファのサイズを文字単位で指定(12～255)します。LFN機能が無効のときは意味を持ちません。</p> + +<h4 id="lfn_unicode">_LFN_UNICODE</h4> +<p>ファイルAPI上におけるUnicode対応機能を設定します。非LFN構成のときは、0でなければなりません。LFN構成のときに1を選択すると、ファイルAPI上の文字列データ<tt>TCHAR</tt>型の定義が切り替わり、パス名等にUnicodeを使用するようになります。この機能は、文字列入出力関数にも影響します。詳しくは、<a href="filename.html#uni">こちら</a>を参照してください。</p> + +<h4 id="strf_encode">_STRF_ENCODE</h4> +<p>Unicode API構成のとき、文字列入出力関数、<tt>f_gets</tt>、<tt>f_putc</tt>、<tt>f_puts</tt>、<tt>f_printf</tt>、におけるファイル上のエンコーディングを指定します。非Unicode API構成のときは意味を持ちません。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>0</td><td>ANSI/OEM</td></tr> +<tr><td>1</td><td>UTF-16LE</td></tr> +<tr><td>2</td><td>UTF-16BE</td></tr> +<tr><td>3</td><td>UTF-8</td></tr> +</table> + +<h4 id="fs_rpath">_FS_RPATH</h4> +<p>相対パス機能を設定します。この機能は、ディレクトリ読み出し関数の出力にも影響します。詳しくは、<a href="filename.html#nam">こちら</a>を参照してください。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>0</td><td>相対パス機能を使わない。パス名は常にルート ディレクトリから辿る。</td></tr> +<tr><td>1</td><td>相対パス機能を使う。<tt>f_chdir</tt>、<tt>f_chdrive</tt>関数が利用可能になる。</td></tr> +<tr><td>2</td><td>1に加え、<tt>f_getcwd</tt>関数が利用可能になる。</td></tr> +</table> + +</div> + + +<div class="para doc" id="volume"> +<h3>ボリューム/物理ドライブの設定</h3> + +<h4 id="volumes">_VOLUMES</h4> +<p>利用するボリューム(論理ドライブ)の数を1～9の範囲で設定します。</p> + +<h4 id="str_volume_id">_STR_VOLUME_ID</h4> +<p>文字列ボリュームIDの設定(0:無効 または 1:有効)。パス名中のボリュームIDに数字に加え任意の文字列も使用できるようにするオプションです。ボリュームID文字列は<tt>_VOLUME_STRS</tt>で定義します。</p> + +<h4 id="volume_strs">_VOLUME_STRS</h4> +<p>ボリュームID文字列を定義します。<tt>_VOLUMES</tt>で設定された個数の文字列を<tt>"RAM","SD","CF",...</tt> のように挙列します。使用可能な文字はA～Zおよび0～9で、先頭の項目が論理ドライブ0に対応します。</p> + +<h4 id="multi_partition">_MULTI_PARTITION</h4> +<p>マルチ区画機能の設定(0:無効 または 1:有効)。無効のときは、個々の論理ドライブは同じ番号の物理ドライブに1:1で対応し、それぞれの物理ドライブ中の最初の区画に結びつけられます。マルチ区画機能を有効にすると、論理ドライブはそれぞれ任意の物理ドライブの任意の区画に結びつけることができます。マッピングは、ユーザ定義の変換テーブル<tt>VolToPart[]</tt>によって行います。また、<tt>f_fdisk</tt>関数が利用可能になります。詳しくは、<a href="filename.html#vol">こちら</a>を参照してください。</p> + +<h4 id="max_ss">_MIN_SS、_MAX_SS</h4> +<p>使用する物理ドライブのセクタ サイズ(データの読み書きの最小単位)を設定します。有効な値は、512、1024、2048、4096です。<tt>_MIN_SS</tt>は最小サイズ、<tt>_MAX_SS</tt>は最大サイズを設定します。メモリ カードやハードディスクでは、常に両方に512を設定しますが、オンボード メモリや一部の光学メディアでは大きな値を設定する必要があるかも知れません。<tt>_MAX_SS > _MIN_SS</tt>に設定したときは可変セクタ サイズ構成となり、<tt>disk_ioctl</tt>関数には<tt>GET_SECTOR_SIZE</tt>コマンドを実装する必要があります。</p> + +<h4 id="use_trim">_USE_TRIM</h4> +<p>ATA-TRIM機能の使用の設定(0:無効 または 1:有効)。この機能を有効にしたときは、<tt>disk_ioctl</tt>関数に<tt>CTRL_TRIM</tt>コマンドを実装するべきです。</p> + +<h4 id="fs_nofsinfo">_FS_NOFSINFO</h4> +<p>FAT32ボリュームのFSINFOの使用の設定(0～3)。FAT32ボリュームで必ず正確な空き容量を取得する必要があるとき、設定値のビット0をセットすると<tt>f_getfree</tt>関数はFSINFOの情報を使わずに全FATスキャンを行って空き容量を得ます。ビット1は最終割り当てクラスタ番号の利用の制御です。</p> +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>bit0=0</td><td>FSINFOの空きクラスタ情報が有効なときはそれを利用する。</td></tr> +<tr><td>bit0=1</td><td>FSINFOの空きクラスタ情報を利用しない。</td></tr> +<tr><td>bit1=0</td><td>FSINFOの最終割り当てクラスタ番号が有効なときはそれを利用する。</td></tr> +<tr><td>bit1=1</td><td>FSINFOの最終割り当てクラスタ番号を利用しない。</td></tr> +</table> + +</div> + + +<div class="para doc" id="system"> +<h3>システムの設定</h3> + +<h4 id="fs_tiny">_FS_TINY</h4> +<p>ファイル データ転送バッファの構成(0:ノーマル または 1:タイニ)。タイニ構成では、ファイル オブジェクト<tt>FIL</tt>内のプライベート セクタ バッファが削除され、<tt>_MAX_SS</tt>バイト小さくなります。ファイル データの転送には、代わりにファイル システム オブジェクト<tt>FATFS</tt>内のボリューム共有セクタ バッファが使われます。</p> + +<h4 id="fs_exfat">_FS_EXFAT</h4> +<p>exFATのサポート(0:使用しない または 1:使用する)。exFATを使用するには、LFN機能を有効にしなければなりません。また、exFATの完全サポートのためには、<tt>_LFN_UNICODE = 1</tt>と<tt>_MAX_LFN = 255</tt>の設定が推奨されます。exFAT機能では64ビット整数を使用するため、これを有効にするとC89(ANSI C)互換が失われます。</p> + +<h4 id="fs_nortc">_FS_NORTC</h4> +<p>RTC機能の使用の設定(0:使用する または 1:使用しない)。システムがRTC(カレンダ時計)をサポートしない場合は、1をセットします。この場合、FatFsが変更を加えたオブジェクトのタイムスタンプはデフォルトの日時を持ちます。RTCが使用可能なときは、0を設定し、<tt>get_fattime</tt>関数をプロジェクトに加えます。リード オンリ構成ではこのオプションは意味を持ちません。</p> + +<h4 id="nortc_time">_NORTC_MON、_NORTC_MDAY、_NORTC_YEAR</h4> +<p>デフォルト日時の設定。<tt>_FS_NORTC</tt>が1のとき、固定して与えられる日付を指定します。<tt>_FS_NORTC</tt>が0のとき、およびリード オンリ構成ではこれらのオプションは意味を持ちません。</p> + +<h4 id="fs_lock">_FS_LOCK</h4> +<p>ファイル ロック機能の設定。このオプションは、開かれたオブジェクトに対する不正な操作の制御機能を設定します。リード オンリ構成では0に設定しなければなりません。なお、ファイル ロック機能はリエントランシーとは関係ありません。</p> + +<table class="lst1"> +<tr><th>値</th><th>解説</th></tr> +<tr><td>0</td><td>ファイル ロック機能を使わない。ボリュームの破損を防ぐため、アプリケーションは不正なファイル操作を避けなければならない。</td></tr> +<tr><td>>0</td><td>ファイル ロック機能を使う。数値は同時にオープンできるファイルやサブ ディレクトリの数を設定します。</td></tr> +</table> + +<h4 id="fs_reentrant">_FS_REENTRANT</h4> +<p>リエントランシーの設定(0:無効 または 1:有効)。このオプションは、FatFsモジュール自体のリエントランシー(スレッド セーフ)の設定をします。異なるボリュームに対するファイル アクセスはこのオプションに関係なく常にリエントラントで、<tt>f_mount</tt>、<tt>f_mkfs</tt>、<tt>f_fdisk</tt>などのボリューム操作関数はこのオプションに関係なく常にリエントラントではありません。同じボリュームに対するファイル アクセス(つまり、ファイル システム オブジェクトの排他使用)のみがこのオプションの制御下にあります。このオプションを有効にしたときは、同期関数である<tt>ff_req_grant</tt>、<tt>ff_rel_grant</tt>、<tt>ff_del_syncobj</tt>、<tt>ff_cre_syncobj</tt>をプロジェクトに追加する必要があります。サンプルが<tt>option/syscall.c</tt>にあります。</p> + +<h4 id="fs_timeout">_FS_TIMEOUT</h4> +<p>タイムアウト時間の設定。待ち合わせ時間が長いときに<tt>FR_TIMEOUT</tt>でファイル関数をアボートする時間を設定します。<tt>_FS_REENTRANT</tt>が0のときは意味を持ちません。</p> + +<h4 id="sync_t">_SYNC_t</h4> +<p>O/S定義の同期オブジェクトの型を設定します。例: <tt>HANDLE</tt>、<tt>ID</tt>、<tt>OS_EVENT*</tt>、<tt>SemaphoreHandle_t</tt>など。また、O/S機能のヘッダ ファイルを<tt>ff.c</tt>のスコープ内にインクルードする必要があります。<tt>_FS_REENTRANT</tt>が0のときは意味を持ちません。</p> + +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dinit.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dinit.html new file mode 100644 index 0000000..7d61578 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dinit.html @@ -0,0 +1,46 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/dinit.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - disk_initialize</title> +</head> + +<body> + +<div class="para func"> +<h2>disk_initialize</h2> +<p>ストレージ デバイスを初期化します。</p> +<pre> +DSTATUS disk_initialize ( + BYTE <span class="arg">pdrv</span> <span class="c">/* [IN] 物理ドライブ番号 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>pdrv</dt> +<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>この関数は戻り値としてディスク ステータスを返します。ディスク ステータスの詳細に関しては<a href="dstat.html"><tt>disk_status</tt></a>関数を参照してください。</p> +</div> + +<div class="para desc"> +<h4>解説</h4> +<p>ストレージ デバイスを初期化し、データの読み書きなど全ての動作が可能な状態にします。関数が成功すると、戻り値の<tt>STA_NOINIT</tt>フラグがクリアされます。</p> +<p>この関数はFatFsの管理下にあり、自動マウント動作により必要に応じて呼び出されます。<em>アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。再初期化が必要なときは、<tt>f_mount</tt>関数を使用してください。</em></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dioctl.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dioctl.html new file mode 100644 index 0000000..1537d7b --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dioctl.html @@ -0,0 +1,98 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/dioctl.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - disk_ioctl</title> +</head> + +<body> + +<div class="para func"> +<h2>disk_ioctl</h2> +<p>一般的なデータ読み書き以外のストレージ デバイス自体に対する様々な制御を行います。</p> +<pre> +DRESULT disk_ioctl ( + BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span> + BYTE <span class="arg">cmd</span>, <span class="c">/* [IN] 制御コマンド */</span> + void* <span class="arg">buff</span> <span class="c">/* [I/O] データ受け渡しバッファ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>pdrv</dt> +<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。</dd> +<dt>cmd</dt> +<dd>制御コマンド コードが指定されます。</dd> +<dt>buff</dt> +<dd>制御コマンドに依存したパラメータを授受するバッファを指すポインタが指定されます。パラメータの授受のないコマンドの場合は、値に意味はありません。</dd> +</dl> +</div> + +<div class="para ret"> +<h4>戻り値</h4> +<dl class="ret"> +<dt>RES_OK (0)</dt> +<dd>正常終了。</dd> +<dt>RES_ERROR</dt> +<dd>何らかのエラーが発生した。</dd> +<dt>RES_PARERR</dt> +<dd>コマンドが不正。</dd> +<dt>RES_NOTRDY</dt> +<dd>ドライブが動作可能状態ではない、または初期化されていない。</dd> +</dl> +</div> + +<div class="para desc"> +<h4>解説</h4> +<p>ストレージ デバイスの種類によりサポートされるコマンドは異なりますが、FatFsモジュール自体は、次の汎用コマンドのみ使用し、特定のデバイスに依存した制御は行いません。</p> +<table class="lst"> +<caption>標準ioctlコマンド</caption> +<tr><th>コマンド</th><th>解説</th></tr> +<tr><td>CTRL_SYNC</td><td>デバイスのデータ書き込み処理を完了させます。ドライバがライト バック キャッシュなどを持っている場合は、書き込まれていないデータを即時書き込みます。メディア上への書き込みがそれぞれ<tt>disk_write</tt>関数の中で完了する場合は、このコマンドに対してすることはありません。</td></tr> +<tr><td>GET_SECTOR_COUNT</td><td>総セクタ数の取得。<tt class="arg">buff</tt>の指す<tt>DWORD</tt>型変数にドライブ上の総セクタ数を返します。<tt>f_mkfs, f_fdisk</tt>関数内から呼び出され、作成するボリュームのサイズを決定するために使用されます。</td></tr> +<tr><td>GET_SECTOR_SIZE</td><td>セクタ サイズの取得。セクタ サイズ可変(<tt>_MAX_SS > _MIN_SS</tt>)のとき、<tt>disk_initailize</tt>関数の成功に続き呼び出されるので、<tt class="arg">buff</tt>の指す<tt>WORD</tt>型変数に現在のセクタ サイズを返します。有効値は512、1024、2048または4096です。セクタ サイズ固定(<tt>_MAX_SS == _MIN_SS</tt>)のときはこのコマンドは使われることはなく、デバイスは常にそのセクタ サイズで動作しなければなりません。</td></tr> +<tr><td>GET_BLOCK_SIZE</td><td>消去ブロック サイズの取得。<tt class="arg">buff</tt>の指す<tt>DWORD</tt>型変数にフラッシュ メモリの消去ブロック サイズ(セクタ単位)を返します。1から32768の範囲で2の累乗の値でなければなりません。ブロック サイズ不明またはフラッシュ メモリ以外のデバイスでは1を返します。<tt>f_mkfs</tt>関数内でのみ使用され、作成されるボリュームのデータ領域はこの境界にアライメントされます。</td></tr> +<tr><td>CTRL_TRIM</td><td>不必要セクタの通知。<tt class="arg">buff</tt>の指す<tt>DWORD</tt>型配列には不必要になった領域 {開始セクタ,終了セクタ} を指定して呼び出されます。TRIM機能が有効(<tt>_USE_TRIM == 1</tt>)で、クラスタが解放されるとき、およびフォーマット時に呼び出されます。これは、ATAコマンド セットのTrimコマンドと等価で、この機能をサポートしないデバイスは何もする必要はありません。また、戻り値はチェックされず、結果によってFatFsの動作が影響を受けることはありません。</td></tr> +</table> + +<p>FatFs自体はデバイス依存コマンドやユーザ定義コマンドは一切使用しませんが、アプリケーションから何らかのデバイス制御が行えると便利なことがあります。アプリケーション上で標準以外の制御が必要なときは、必要に応じてユーザ定義コマンドを追加して利用するとよいでしょう。次にコマンドの例を示します。</p> +<table class="lst"> +<caption>ユーザ定義ioctlコマンドの例</caption> +<tr><th>コマンド</th><th>解説</th></tr> +<tr><td>CTRL_FORMAT</td><td>メディアの物理フォーマットを行います。<tt class="arg">buff</tt>はNULLでないとき、進行表示のためのコールバック関数のアドレスを示します。</td></tr> +<tr><td>CTRL_POWER_IDLE</td><td>デバイスをアイドル状態にします。通常の読み書き要求でアクティブ状態に戻るなら、<tt>STA_NOINIT</tt>フラグをセットする必要はありません。</td></tr> +<tr><td>CTRL_POWER_OFF</td><td>デバイスをシャットダウン状態にします。<tt>STA_NOINIT</tt>はセットされます。デバイスは<tt>disk_initialize</tt>関数でアクティブ状態に戻ります。</td></tr> +<tr><td>CTRL_LOCK</td><td>ユーザによるメディアの取り出しを禁止します。</td></tr> +<tr><td>CTRL_UNLOCK</td><td>ユーザによるメディアの取り出しを許可します。</td></tr> +<tr><td>CTRL_EJECT</td><td>メディアを排出します。完了後、<tt>STA_NOINIT</tt>と<tt>STA_NODISK</tt>フラグはセットされます。</td></tr> +<tr><td>MMC_GET_TYPE</td><td>カード タイプを示すフラグ(b0:MMCv3, b1:SDv1, b2:SDv2+, b3:LBA)を<tt class="arg">buff</tt>の示す<tt>BYTE</tt>変数に読み出します。(MMC/SDカード専用)</td></tr> +<tr><td>MMC_GET_CSD</td><td>CSDレジスタの内容を<tt class="arg">buff</tt>の示す16バイトのバッファに読み出します。(MMC/SDカード専用)</td></tr> +<tr><td>MMC_GET_CID</td><td>CIDレジスタの内容を<tt class="arg">buff</tt>の示す16バイトのバッファに読み出します。(MMC/SDカード専用)</td></tr> +<tr><td>MMC_GET_OCR</td><td>OCRレジスタの内容を<tt class="arg">buff</tt>の示す4バイトのバッファに読み出します。(MMC/SDカード専用)</td></tr> +<tr><td>MMC_GET_SDSTAT</td><td>SD STATUSレジスタの内容を<tt class="arg">buff</tt>の示す64バイトのバッファに読み出します。(SDカード専用)</td></tr> +<tr><td>ATA_GET_REV</td><td>リビジョン コードを<tt class="arg">buff</tt>の示す16バイトのバッファに読み出します。(ATA/CFカード専用)</td></tr> +<tr><td>ATA_GET_MODEL</td><td>モデル コードを<tt class="arg">buff</tt>の示す40バイトのバッファに読み出します。(ATA/CFカード専用)</td></tr> +<tr><td>ATA_GET_SN</td><td>シリアル番号を<tt class="arg">buff</tt>の示す20バイトのバッファに読み出します。(ATA/CFカード専用)</td></tr> +<tr><td>ISDIO_READ</td><td><tt class="arg">buff</tt>の示すコマンド構造体に従いiSDIOレジスタからデータを読み出します。(FlashAir専用)</td></tr> +<tr><td>ISDIO_WRITE</td><td><tt class="arg">buff</tt>の示すコマンド構造体に従いiSDIOレジスタにデータを書き込みます。(FlashAir専用)</td></tr> +<tr><td>ISDIO_MRITE</td><td><tt class="arg">buff</tt>の示すコマンド構造体に従いiSDIOレジスタの一部のビットを書き換えます。(FlashAir専用)</td></tr> +</table> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>リード オンリー構成で、かつセクタ サイズ固定構成のときは、この関数は必要とされません。</p> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dread.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dread.html new file mode 100644 index 0000000..ab2b4bc --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dread.html @@ -0,0 +1,72 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/dread.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - disk_read</title> +</head> + +<body> + +<div class="para func"> +<h2>disk_read</h2> +<p>ストレージ デバイスからデータを読み出します。</p> +<pre> +DRESULT disk_read ( + BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span> + BYTE* <span class="arg">buff</span>, <span class="c">/* [OUT] 読み出しバッファへのポインタ */</span> + DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 読み出し開始セクタ番号 */</span> + UINT <span class="arg">count</span> <span class="c">/* [IN] 読み出すセクタ数 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>pdrv</dt> +<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。シングル ドライブ システムでは、常に0が指定されます。</dd> +<dt>buff</dt> +<dd>ストレージ デバイスから読み出したデータを格納する<em>バイト配列</em>が指定されます。</dd> +<dt>sector</dt> +<dd>読み出しを開始するセクタ番号。32ビットLBAで指定されます。</dd> +<dt>count</dt> +<dd>読み出すセクタ数(1以上の値)が指定されます。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<dl class="ret"> +<dt>RES_OK (0)</dt> +<dd>正常終了。</dd> +<dt>RES_ERROR</dt> +<dd>回復不能なエラーにより、読み出し操作を完了できなかった。</dd> +<dt>RES_PARERR</dt> +<dd>パラメータが不正。</dd> +<dt>RES_NOTRDY</dt> +<dd>ストレージ デバイスが動作可能な状態ではない (初期化されていない)。</dd> +</dl> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ストレージ デバイスに対するデータの読み書きは、セクタ単位で行われます。FatFsでは512～4096バイトのセクタ サイズをサポートします。固定セクタ サイズ構成(<tt>_MIN_SS == MAX_SS</tt>)のときは、暗黙的にそのセクタ サイズで動作しなければなりません。可変セクタ サイズ構成(<tt>_MIN_SS < MAX_SS</tt>)のときは、<tt>disk_initialize</tt>関数に続いて<tt>disk_ioctl</tt>関数でセクタ サイズを問い合わせてくるので、それに対して正しい値を返す必要があります。</p> +<p><tt class="arg">buff</tt>は<tt>BYTE</tt>型なので、指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。非アライメント アドレスへの転送は、<a href="appnote.html#fs1">直接転送</a>において発生することがあります。もしも、ハードウェア上の制約でそのような転送が不可能なときは、この関数内で二段転送するなどして解決するか、または別の方法で対応しなければなりません。次にいくつかの対応方法を示します(いずれか一つでOK)。</p> +<ul> +<li>この関数内で解決する - 推奨</li> +<li>全ての<tt>f_read()</tt>において、セクタ全体を含む転送を避ける - 直接転送が発生しない</li> +<li><tt>f_read(fp, data, btr, &br)</tt>において、<tt>(((UINT)data & 3) == (f_tell(fp) & 3))</tt>を満足させる - 直接転送での<tt class="arg">buff</tt>のワード アライメントが保証される</li> +</ul> +<p>一般的に、複数セクタの転送要求は、ストレージ デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ読み出しに分解された場合、スループットが低下することがあります。</p> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dstat.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dstat.html new file mode 100644 index 0000000..0035e3f --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dstat.html @@ -0,0 +1,48 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/dstat.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - disk_status</title> +</head> + +<body> + +<div class="para func"> +<h2>disk_status</h2> +<p>ストレージ デバイスの状態を取得します。</p> +<pre> +DSTATUS disk_status ( + BYTE <span class="arg">pdrv</span> <span class="c">/* [IN] 物理ドライブ番号 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>pdrv</dt> +<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。物理ドライブが1台のときは、常に0になります。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>現在のストレージ デバイスの状態を次のフラグの組み合わせ値で返します。</p> +<dl class="ret"> +<dt>STA_NOINIT</dt> +<dd>デバイスが初期化されていないことを示すフラグ。システム リセットやメディアの取り外し等でセットされ、<tt>disk_initialize</tt>関数の正常終了でクリア、失敗でセットされます。メディア交換は非同期に発生するイベントなので、過去にメディア交換があった場合もこのフラグに反映させる必要があります。FatFsモジュールは、このフラグを参照してマウント動作が必要かどうかを判断します。</dd> +<dt>STA_NODISK</dt> +<dd>メディアが存在しないことを示すフラグ。メディアが取り外されている間はセットされ、セットされている間はクリアされます。固定ディスクでは常にクリアします。なお、このフラグはFatFsモジュールでは参照されません。</dd> +<dt>STA_PROTECT</dt> +<dd>メディアがライト プロテクトされていることを示すフラグ。ライト プロテクト機能をサポートしないときは、常にクリアします。リード オンリ構成では参照されません。</dd> +</dl> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dwrite.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dwrite.html new file mode 100644 index 0000000..936d7ec --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/dwrite.html @@ -0,0 +1,76 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/dwrite.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - disk_write</title> +</head> + +<body> + +<div class="para func"> +<h2>disk_write</h2> +<p>ストレージ デバイスにデータを書き込みます。</p> +<pre> +DRESULT disk_write ( + BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span> + const BYTE* <span class="arg">buff</span>, <span class="c">/* [IN] 書き込むデータへのポインタ */</span> + DWORD <span class="arg">sector</span>, <span class="c">/* [IN] 書き込み開始セクタ番号 */</span> + UINT <span class="arg">count</span> <span class="c">/* [IN] 書き込むセクタ数 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>pdrv</dt> +<dd>対象のデバイスを識別する物理ドライブ番号(0-9)が指定されます。</dd> +<dt>buff</dt> +<dd>ストレージ デバイスに書き込むセクタ データが格納された<em>バイト配列</em>が指定されます。データのバイト数は、セクタ サイズ*<tt class="arg">count</tt>となります。</dd> +<dt>sector</dt> +<dd>書き込みを開始するセクタ番号。32ビットLBAで指定されます。</dd> +<dt>count</dt> +<dd>書き込むセクタ数(1以上の値)が指定されます。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<dl class="ret"> +<dt>RES_OK (0)</dt> +<dd>正常終了。</dd> +<dt>RES_ERROR</dt> +<dd>回復不能なエラーにより、書き込み操作を完了できなかった。</dd> +<dt>RES_WRPRT</dt> +<dd>メディアが書き込み禁止状態。</dd> +<dt>RES_PARERR</dt> +<dd>パラメータが不正。</dd> +<dt>RES_NOTRDY</dt> +<dd>ストレージ デバイスが動作可能な状態ではない (初期化されていない)。</dd> +</dl> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p><tt class="arg">buff</tt>に指定されるアドレスは<em>常にワード アライメントされているとは限りません</em>。これについては、<a href="dread.html"><tt>disk_read</tt></a>関数の解説を参照してください。</p> +<p>一般的に、複数セクタの転送要求は、デバイスに対して可能な限りマルチ セクタ転送しなければなりません。複数のシングル セクタ書き込みに分解された場合、スループットが著しく低下することがあります。</p> +<p>FatFsはディスク制御レイヤが遅延書き込み機能を持つことも想定しています。この関数から戻るとき、デバイスが書き込みを実行中だったり単にライトバック キャッシュに書き込まれただけなど、必ずしもメディアへの書き込みが完了している必要はありません。ただし、<tt class="arg">buff</tt>のデータは、この関数から戻ると無効となります。書き込み完了の要求は、<a href="dioctl.html"><tt>disk_ioctl</tt></a>関数の<tt>CTRL_SYNC</tt>コマンドによって行われます。このような遅延書き込み機能が実装された場合、書き込みスループットを向上させることができます。</p> +<p><em>アプリケーションからはこの関数を呼び出してはなりません。さもないと、FATボリュームが破壊される可能性があります。</em></p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>リード オンリー構成(<tt>_FS_READONLY == 1</tt>)ではこの関数は必要とされません。</p> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/eof.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/eof.html new file mode 100644 index 0000000..dee0376 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/eof.html @@ -0,0 +1,62 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/eof.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_eof</title> +</head> + +<body> + +<div class="para func"> +<h2>f_eof</h2> +<p>リード/ライト ポインタがファイル終端に達しているかどうか調べます。.</p> +<pre> +int f_eof ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>リード/ライト ポインタがファイル終端にあり読み出すデータがない場合は、0以外の値を返します。それ以外のときは0を返します。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>この関数は、現リビジョンではマクロとして実装されています。ファイル オブジェクトの正当性チェックや排他制御は行いません。</p> +<pre> +<span class="k">#define</span> f_eof(fp) ((int)((fp)->fptr == (fp)->fsize)) +</pre> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>常に使用可能。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/error.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/error.html new file mode 100644 index 0000000..5e5510e --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/error.html @@ -0,0 +1,62 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/error.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_error</title> +</head> + +<body> + +<div class="para func"> +<h2>f_error</h2> +<p>エラー発生の有無を調べます。</p> +<pre> +int f_error ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>そのファイルにおいてハード エラーによって処理が中断されている場合は、0以外の値を返します。それ以外の時は0を返します。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>この関数は、現リビジョンではマクロとして実装されています。ファイル オブジェクトの正当性チェックや排他制御は行いません。</p> +<pre> +<span class="k">#define</span> f_error(fp) ((fp)->err) +</pre> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>常に使用可能。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/expand.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/expand.html new file mode 100644 index 0000000..a338121 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/expand.html @@ -0,0 +1,116 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="ja" title="English" href="../en/expand.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_expand</title> +</head> + +<body> + +<div class="para func"> +<h2>f_expand</h2> +<p>ファイルに連続したデータ領域を割り当てます。</p> + +<pre> +FRESULT f_expand ( + FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体へのポインタ */</span> + FSIZE_t <span class="arg">fsz</span>, <span class="c">/* [IN] 割り当てサイズ */</span> + BYTE <span class="arg">opt</span> <span class="c">/* [IN] 動作オプション */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>Parameters</h4> +<dl class="par"> +<dt>fp</dt> +<dd>対象となるファイル オブジェクト構造体へのポインタを指定します。</dd> +<dt>fsz</dt> +<dd>ファイルに割り当てるバイト単位のサイズ。データ型<tt>FSIZE_t</tt>は、<tt>DWORD</tt>(32-bit)または<tt>QWORD</tt>(64-bit)のエリアスで、exFATサポートの有無により切り替わります。</dd> +<dt>opt</dt> +<dd>実際に割り当てを行うかどうか指定するフラグ。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>Return Values</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#dn">FR_DENIED</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p><tt class="arg">opt</tt>に1を指定すると、ファイルに連続したデータ領域を割り当てます。<tt>f_lseek</tt>によるサイズ拡張とは異なり、対象ファイルのサイズは0(つまりデータ領域未割り当て)でなければなりません。また、リード/ライト ポインタは、ファイル先頭に留まります。この関数により割り当てられたファイルの内容は未定義なので、それに対して何の前提も持つべきではありません。この関数は、次の理由により<tt>FR_DENIED</tt>で失敗することがあります。</p> +<ul> +<li>ボリューム上に連続した空き領域が見つからなかった。</li> +<li>ファイルのサイズが0ではなかった。</li> +<li>ファイルが非書き込みモードで開かれている。</li> +<li>指定されたファイル サイズが無効。(FATボリューム上で >=4GiB)</li> +</ul> +<p><tt class="arg">opt</tt>に0を指定したときは、連続したデータ領域を探すのみで、その時点ではファイルへの割り当てを行わず、代わりにそれを検索開始ポイントとしてファイル システム オブジェクトにセットします。これにより、そのボリューム上で別の操作(FAT変更を伴う)が行われない限り、書き込まれるファイルは少なくともそのサイズまでは連続性が保証され、遅延無く書き込めることになります。</p> +<p>時間的制約のあるファイル読み書き操作において、連続データ領域を割り当てられたファイルは有利となります。これは、分割されたファイルによりもたらされる無用なランダム アクセスが減ることにより、ファイル システムやストレージ デバイスの処理のオーバーヘッドが削減されるからです。特にexFATボリューム上の連続ファイルでは一切のFATアクセスが発生せず、効率的なシーケンシャル アクセスが行えます。</p> +<p>連続ファイルに対して低レベルI/Oを使用したさらに効率的な直接アクセスも容易に行えますが、これは将来の互換性の点で推奨はされません。</p> +</div> + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_USE_EXPAND == 1</tt>で、かつ<tt>_FS_READONLY == 0</tt>のとき使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + <span class="c">/* 連続ファイルの作成 */</span> + + <span class="c">/* 新しいファイルの作成 */</span> + res = f_open(fp = malloc(sizeof (FIL)), "file.dat", FA_WRITE|FA_CREATE_ALWAYS); + if (res) { <span class="c">/* ファイルが開かれたかチェック */</span> + free(fp); + ... + } + + <span class="c">/* 100 MiB の連続領域を割り当てる */</span> + res = f_expand(fp, 104857600, 1); + if (res) { <span class="c">/* 割り当てられたかチェック */</span> + ... + free(fp); + ... + } + <span class="c">/* 連続ファイル作成成功 fp でアクセス可能 */</span> + +</pre> +<pre> + <span class="c">/* ファイル システムを介さず直接アクセスする例 */</span> + + <span class="c">/* ファイル データの物理的位置を取得 */</span> + drv = fp->obj.fs->drv; + sect = fp->obj.fs->database + fp->obj.fs->csize * (fp->obj.sclust - 2); + + <span class="c">/* ファイル先頭から2048セクタを書き込み */</span> + res = disk_write(drv, buffer, sect, 2048); + +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/fattime.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/fattime.html new file mode 100644 index 0000000..0b8f5ff --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/fattime.html @@ -0,0 +1,57 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/fattime.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - get_fattime</title> +</head> + +<body> + +<div class="para func"> +<h2>get_fattime</h2> +<p>現在時刻を取得します。</p> +<pre> +DWORD get_fattime (void); +</pre> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>現在のローカル タイムを<tt>DWORD</tt>値にパックして返します。ビット フィールドは次に示すようになります。</p> +<dl> +<dt>bit31:25</dt> +<dd>1980年を起点とした年を 0..127 でセット。</dd> +<dt>bit24:21</dt> +<dd>月を 1..12 の値でセット。</dd> +<dt>bit20:16</dt> +<dd>日を 1..31 の値でセット。</dd> +<dt>bit15:11</dt> +<dd>時を 0..23 の値でセット。</dd> +<dt>bit10:5</dt> +<dd>分を 0..59 の値でセット。</dd> +<dt>bit4:0</dt> +<dd>秒/2を 0..29 の値でセット</dd> +</dl> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>RTCをサポートしないシステムでも、ダミーとして何らかの日付として有効な値を返すべきです。0などを返した場合、そのファイルのタイムスタンプは無効になります。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>リード オンリー構成(<tt>_FS_READONLY == 1</tt>)または、非RTCサポート構成(<tt>_RTC_NOUSE == 1</tt>)ではこの関数は必要とされません。</p> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/fdisk.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/fdisk.html new file mode 100644 index 0000000..ecf97cc --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/fdisk.html @@ -0,0 +1,92 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/fdisk.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_fdisk</title> +</head> + +<body> + +<div class="para func"> +<h2>f_fdisk</h2> +<p>物理ドライブを分割します。</p> +<pre> +FRESULT f_fdisk ( + BYTE <span class="arg">pdrv</span>, <span class="c">/* [IN] 物理ドライブ番号 */</span> + const DWORD* <span class="arg">szt</span>, <span class="c">/* [IN] 区画サイズ テーブル */</span> + void* <span class="arg">work</span> <span class="c">/* [-] ワークエリア */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>pdrv</dt> +<dd>分割する<em>物理ドライブ</em>を指定します。これは論理ドライブ番号ではなく、ディスク関数に渡される物理ドライブ番号です。</dd> +<dt>szt</dt> +<dd>区画サイズ テーブルの先頭項目へのポインタを指定します。</dd> +<dt>work</dt> +<dd>ワークエリアへのポインタを指定します。サイズは<tt>_MAX_SS</tt>バイト必要です。</dd> +</dl> +</div> + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#ip">FR_INVALID_PARAMETER</a> +</p> +</div> + +<div class="para desc"> +<h4>説明</h4> +<p>この関数は、指定された物理ドライブのMBRに区画テーブルを作成します。区画分けは一般的なFDISK形式で行うため、最大4つの基本区画を作成することができます。拡張区画には対応していません。区画サイズ テーブルにはドライブをどのように分割するか指定します。この配列は4つの項目から成り、先頭の項目が1番目の区画のサイズを示します。項目の値が100以下の場合、その区画のドライブの総容量に対する割合をパーセント単位で指定します。100を超える値の場合はセクタ数の直接指定になります。ドライブ上への区画の配置順は、項目順になります。</p> +</div> + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READOLNY == 0</tt> で <tt>_USE_MKFS == 1</tt> で <tt>_MULTI_PARTITION == 1</tt> のとき使用可能です。</p> +</div> + +<div class="para use"> +<h4>使用例</h4> +<pre> + <span class="c">/* ユーザ定義のボリューム管理テーブル (_MULTI_PARTITION == 1 のとき必要) */</span> + + PARTITION VolToPart[] = { + {0, 1}, <span class="c">/* 論理ドライブ 0 ==> 物理ドライブ 0, 第1区画 */</span> + {0, 2}, <span class="c">/* 論理ドライブ 1 ==> 物理ドライブ 0, 第2区画 */</span> + {1, 0} <span class="c">/* 論理ドライブ 2 ==> 物理ドライブ 1, 自動検出 */</span> + }; +</pre> +<pre> + <span class="c">/* 新しい物理ドライブ(0)の初期化 */</span> + + FATFS fs; + DWORD plist[] = {50, 50, 0, 0}; <span class="c">/* 第1区画,第2区画それぞれに50%ずつ割り当て */</span> + BYTE work[_MAX_SS]; + + f_fdisk(0, plist, work); <span class="c">/* 物理ドライブ 0 の分割 */</span> + + f_mkfs("0:", FMT_ANY, work, sizeof work); <span class="c">/* 論理ドライブ 0: のフォーマット */</span> + f_mkfs("1:", FMT_ANY, work, sizeof work); <span class="c">/* 論理ドライブ 1: のフォーマット */</span> + +</pre> +</div> + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="filename.html#vol">ボリューム管理</a>, <a href="mkfs.html">f_mkfs</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/filename.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/filename.html new file mode 100644 index 0000000..70d30e1 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/filename.html @@ -0,0 +1,83 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/filename.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - パス名のフォーマット</title> +</head> + +<body> +<h1>パス名のフォーマット</h1> +<div class="para doc" id="nam"> +<h3>ファイル ディレクトリ名</h3> +<p>FatFsモジュールでは、パス名によるファイル、ディレクトリ、ドライブの指定方法はDOS/Windows APIとほぼ同じです。パス名のフォーマットは次の通りです。</p> +<pre>"[論理ドライブ番号:][/]ディレクトリ名/ファイル名"</pre> +<p>FatFsモジュールは長いファイル名(LFN)および8.3形式ファイル名(SFN)に対応しています。LFNは、(<tt><a href="config.html#use_lfn">_USE_LFN</a> > 0</tt>)のとき使用可能になります。ディレクトリ セパレータにはDOS/Windows APIと同じく<tt>'/'</tt>と<tt>'\'</tt>を使用します。連続したセパレータは無視され1個として扱われます。唯一の違いは、論理ドライブの指定だけです。論理ドライブ番号は、<tt>'0'</tt>～<tt>'9'</tt>の一文字の数字とコロンで指定し、省略した場合は<em>デフォルト ドライブ</em>(0またはカレント ドライブ)が選択されます。</p> +<p>ヌル文字や制御文字(<tt>'\0'</tt>～<tt>'\x1F'</tt>)は、パス名の終端として認識されます。パス名に先行あるいは中に含まれるスペースは、LFN構成では名前の一部として有効ですが、非LFN構成ではスペースはパス名の終端として認識されます。</p> +<p>標準構成(<tt><a href="config.html#fs_rpath">_FS_RPATH</a> == 0</tt>)のときは、全てのオブジェクトがルート ディレクトリから辿る絶対パスで指定されます。OS指向なカレント ディレクトリという概念は無く、またドット ディレクトリ(<tt>"."</tt>や<tt>".."</tt>)は使用できません。パス名先頭のセパレータは無視されます。デフォルト ドライブ番号は常に0になります。</p> +<p>相対パスを有効(<tt>_FS_RPATH >= 1</tt>)にしたときは、先行するセパレータの有無によって検索開始ディレクトリが変わり、セパレータがある場合はルート ディレクトリから、無い場合は<a href="chdir.html"><tt>f_chdir</tt></a>関数で設定されるカレント ディレクトリからになります。またパス名にドット ディレクトリが使用できます。デフォルト ドライブ番号は<a href="chdrive.html"><tt>f_chdrive</tt></a>関数で設定された値となります。</p> +<table class="lst2"> +<tr><td>パス名の例</td><td>_FS_RPATH == 0</td><td>_FS_RPATH >= 1</td></tr> +<tr class="lst3"><td>file.txt</td><td>ドライブ0のルート ディレクトリ下のファイル</td><td>カレント ドライブのカレント ディレクトリ下のファイル</td></tr> +<tr><td>/file.txt</td><td>ドライブ0のルート ディレクトリ下のファイル</td><td>カレント ドライブのルート ディレクトリ下のファイル</td></tr> +<tr><td></td><td>ドライブ0のルート ディレクトリ</td><td>カレント ドライブのカレント ディレクトリ</td></tr> +<tr><td>2:</td><td>ドライブ2のルート ディレクトリ</td><td>ドライブ2のカレント ディレクトリ</td></tr> +<tr><td>2:file1.txt</td><td>ドライブ2のルート ディレクトリ下のファイル</td><td>ドライブ2のカレント ディレクトリ下のファイル</td></tr> +<tr><td>2:/</td><td>ドライブ2のルート ディレクトリ</td><td>ドライブ2のルート ディレクトリ</td></tr> +<tr><td>../file.txt</td><td>無効</td><td>親ディレクトリ下のファイル</td></tr> +<tr><td>.</td><td>無効</td><td>このディレクトリ</td></tr> +<tr><td>..</td><td>無効</td><td>カレント ディレクトリの親ディレクトリ</td></tr> +<tr><td>dir1/..</td><td>無効</td><td>カレント ディレクトリ</td></tr> +<tr><td>/..</td><td>無効</td><td>ルート ディレクトリ(その上は辿れない)</td></tr> +</table> +<p>また、<tt><a href="config.html#str_volume_id">_STR_VOLUME_ID</a></tt>オプションを有効にすることでドライブ番号の識別には数字のほか、<tt>"sd:file1.txt"</tt>や<tt>"ram:swapfile.dat"</tt>のように、任意の文字列(もちろんDOS/Windowsライクなドライブ文字も)を使用することも可能になります。</p> +<p><em>【注意】現リビジョン(R0.12)では、exFATボリューム上においてダブル ドット<tt>".."</tt>はシングル ドット<tt>"."</tt>として機能し、親ディレクトリを辿ることはできません。</em></p> +</div> + +<div class="para doc" id="case"> +<h3>使用可能な文字と大文字小文字の識別</h3> +<p>FATファイル システムでファイル名に使用可能な文字は、<tt>0～9 A～Z ! # $ % & ' ( ) - @ ^ _ ` { } ~</tt>および拡張文字(<tt>\x80</tt>～<tt>\xFF</tt>)となっています。LFN拡張ではこれらに加え、<tt>+ , ; = [ ]</tt>およびスペースが使用可能になり、スペースとピリオドはファイル名の末尾を除く任意の位置に挿入できます。</p> +<p>FATファイル システムでは、パス名についてケース インセンシティブです。たとえば、<tt>file.txt, File.Txt, FILE.TXT</tt>の3つの名前は同じ物として扱われます。これは、ASCII文字だけでなく拡張文字についても適用されます。ファイルが作成される際、SFNエントリには全て大文字に変換された名前が記録されます。LFN対応システムでは、LFNエントリには大文字変換されない名前が記録されます。</p> +<p>古い日本語MS-DOSでは拡張文字(いわゆる全角文字)についてはケース センシティブでした。FatFsモジュールではこれにしたがい、非LFN構成で文字コードにDBCSが選択されたときに限り、拡張文字に対して大文字変換を行わずにSFNエントリに記録および検索されます(日本語MSDOS仕様)。LFN構成では拡張文字についても大文字変換を行います(WindowsNT仕様)。このため、非LFN構成で全角小文字を含む名前でファイルを作成すると、Windowsでそのファイルを開けなくなるなどの互換性問題を起こすので、それらのシステムで相互利用するボリューム上ではDBCS拡張文字の使用は避けるべきです。</p> +</div> + +<div class="para doc" id="uni"> +<h3>Unicode API</h3> +<p>ファイル関数の入出力のうちファイル名やパス名を指定する引数の型は、<tt>TCHAR</tt>で定義されていますが、これは通常は<tt>char</tt>のエリアスになっています。そして、<tt><a href="config.html#code_page">_CODE_PAGE</a></tt>で指定されるANSI/OEMコード(SBCSまたはDBCS)の文字列として扱われます。ファイル名入出力をUnicodeとする構成(<tt><a href="config.html#lfn_unicode">_LFN_UNICODE</a> == 1</tt>)にしたときは、<tt>TCHAR</tt>はワイド文字(<tt>WCHAR, unsigned short</tt>)に切り替わり、パス名の入出力にUnicodeを使用するようになります。これによりLFN規格に完全対応となり、ファイル名としてANSI/OEMコードにない文字(たとえば ✝☪✡☸☭など)も使用できます。この設定は文字列入出力関数においては、データ型とファイル上のエンコーディングに影響を与えます。リテラル文字列を定義するとき、次に示すように<tt>_T(s)</tt>および<tt>_TEXT(s)</tt>マクロを使ってANSI/OEMとUnicodeを自動切り替えすることができます。</p> +<pre> + f_open(fp, "filename.txt", FA_READ); <span class="c">/* ANSI/OEM専用コード */</span> + f_open(fp, L"filename.txt", FA_READ); <span class="c">/* Unicode専用コード */</span> + f_open(fp, _T("filename.txt"), FA_READ); <span class="c">/* 両用コード(自動切り替え) */</span> +</pre> +</div> + +<div class="para doc" id="vol"> +<h3>ボリューム管理</h3> +<p>デフォルトの構成では、それぞれの論理ドライブは同じ番号の物理ドライブに1:1で結びつけられていて、自動検出機能によりその物理ドライブ上の一つのFATボリュームがマウントされます。FATボリュームの検出は、セクタ0(SFD)、第一区画～第四区画(FDISK)の順に行われます。</p> +<p><tt><a href="config.html#multi_partition">_MULTI_PARTITION</a></tt>に1を指定すると、それぞれの論理ドライブに対して個別に物理ドライブ番号と区画を指定できるようになります。この構成では、論理ドライブと区画の対応を解決するためのテーブルを次に示すように定義する必要があります。</p> +<pre> +例:論理ドライブ0～2を物理ドライブ0(非リムーバブル)の3つの基本区画に割り当て、 + 論理ドライブ3を物理ドライブ1(リムーバブル)に割り当てる場合。 + +PARTITION VolToPart[] = { + {0, 1}, <span class="c">/* "0:" ==> 物理ドライブ 0, 第1区画 */</span> + {0, 2}, <span class="c">/* "1:" ==> 物理ドライブ 0, 第2区画 */</span> + {0, 3}, <span class="c">/* "2:" ==> 物理ドライブ 0, 第3区画 */</span> + {1, 0} <span class="c">/* "3:" ==> 物理ドライブ 1, 自動検出 */</span> +}; +</pre> +<div><img src="../res/f7.png" width="828" height="288" alt="論理ドライブと物理ドライブの関係"></div> +<p>複数区画指定を使用する場合、次の点に注意しなければなりません。 +<ul> +<li>複数のマウントされた区画を持つ物理ドライブは、非リムーバブルでなければならず、システム動作中のメディア交換は禁止。</li> +<li>基本区画のみマウント可能で、拡張区画内の区画には対応しない。</li> +<li>Windowsは、リムーバブル ドライブでは複数区画をサポートせず、先頭区画のみ認識する。</li> +</ul> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/findfirst.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/findfirst.html new file mode 100644 index 0000000..1d92880 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/findfirst.html @@ -0,0 +1,110 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/findfirst.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_findfirst</title> +</head> + +<body> + +<div class="para func"> +<h2>f_findfirst</h2> +<p>ディレクトリ内のオブジェクトの検索を開始します。</p> +<pre> +FRESULT f_findfirst ( + DIR* <span class="arg">dp</span>, <span class="c">/* [OUT] ディレクトリ オブジェクト構造体へのポインタ */</span> + FILINFO* <span class="arg">fno</span>, <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span> + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] ディレクトリ名へのポインタ */</span> + const TCHAR* <span class="arg">pattern</span> <span class="c">/* [IN] マッチ パターン文字列へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>dp</dt> +<dd>空のディレクトリ オブジェクト構造体へのポインタを指定します。</dd> +<dt>fno</dt> +<dd>最初にマッチしたディレクトリ項目を格納するファイル情報構造体へのポインタを指定します。</dd> +<dt>path</dt> +<dd>オープンするディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +<dt>pattern</dt> +<dd>検索する名前を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。この文字列は、続く<tt>f_findnext</tt>関数でも参照されるため、一連の処理が終了するまで有効でなければなりません。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a>, +<a href="rc.html#tf">FR_TOO_MANY_OPEN_FILES</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p><tt class="arg">path</tt>で指定されるディレクトリを開き、そのディレクトリ内の項目の検索を開始します。正常終了すると、ディレクトリ オブジェクト構造体が作成され、最初に検索名文字列に名前がマッチした項目の情報が<tt class="arg">fno</tt>の指定するファイル情報構造体にストアされます。名前のマッチする項目が見つからなかった場合は、<tt>fno->fname[]</tt>にヌル文字列が返されます。ファイル情報構造体の使い方については、<a href="readdir.html"><tt>f_readdir</tt></a>関数を参照してください。</p> +<p>マッチ パターン文字列は、ワイルドカード文字(<tt>?</tt>と<tt>*</tt>)を含むことができます。<tt>?</tt>は任意の1文字に、<tt>*</tt>は0文字以上の任意の文字列にマッチします。LFN構成では、<tt>_USE_FIND = 1</tt>のとき<tt>fname[]</tt>のみテストし、<tt>_USE_FIND = 2</tt>のときは<tt>altname[]</tt>もテストします。現リビジョンではパターン マッチングにおいて次の点で標準システムとは異なる動作となります。</p> +<ul> +<li><tt>"*.*"</tt>は拡張子なしの名前にマッチしない。(標準システムでは全ての名前にマッチ)</li> +<li>ピリオドで終わるパターンは、どの名前にもマッチしない。(標準システムでは拡張子無しの名前にマッチ)</li> +<li><a href="filename.html#case">DBCS拡張文字</a>については、LFN構成でも非Unicode API構成ではケース センシティブとなる。</li> +</ul> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>この関数は、<a href="opendir.html"><tt>f_opendir</tt></a>関数および<a href="readdir.html"><tt>f_readdir</tt></a>関数のラッパー関数です。<tt>_USE_FIND >= 1</tt>で、かつ<tt>_FS_MINIMIZE <= 1</tt>のとき使用可能になります。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> +<span class="c">/* ディレクトリ内のオブジェクトの検索と表示 */</span> + +void find_image (void) +{ + FRESULT fr; <span class="c">/* API戻り値 */</span> + DIR dj; <span class="c">/* ディレクトリ オブジェクト */</span> + FILINFO fno; <span class="c">/* ファイル情報 */</span> + + fr = f_findfirst(&dj, &fno, "", "dsc*.jpg"); <span class="c">/* "dsc"で始まるJPEGファイルを検索 */</span> + + while (fr == FR_OK && fno.fname[0]) { <span class="c">/* 見つかる間繰り返し */</span> + printf("%s\n", fno.fname); <span class="c">/* 見つけた項目の名前を表示 */</span> + fr = f_findnext(&dj, &fno); <span class="c">/* 次を検索 */</span> + } + f_closedir(&dj); +} +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="findnext.html">f_findnext</a>, <a href="closedir.html">f_closedir</a>, <a href="sdir.html">DIR</a>, <a href="sfileinfo.html">FILINFO</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/findnext.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/findnext.html new file mode 100644 index 0000000..c1bf3f7 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/findnext.html @@ -0,0 +1,68 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/findnext.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_findnext</title> +</head> + +<body> + +<div class="para func"> +<h2>f_findnext</h2> +<p>次にマッチするオブジェクトを検索します。</p> +<pre> +FRESULT f_findnext ( + DIR* <span class="arg">dp</span>, <span class="c">/* [IN] ディレクトリ構造体へのポインタ */</span> + FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>dp</dt> +<dd><tt>f_findfirst</tt>関数で作成された有効なディレクトリ構造体へのポインタを指定します。</dd> +<dt>fno</dt> +<dd>マッチしたディレクトリ項目を格納するファイル情報構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>次に名前のマッチするディレクトリ項目を検索し、見つかった項目をファイル情報構造体にストアします。名前のマッチする項目が見つからずディレクトリの最後まで達した場合は、<tt>fno->fname[]</tt>にヌル文字列が返されます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>この関数は、<a href="readdir.html"><tt>f_readdir</tt></a>関数のラッパー関数です。<tt>_USE_FIND >= 1</tt>で、かつ<tt>_FS_MINIMIZE <= 1</tt>のとき使用可能になります。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="findfirst.html">f_findfirst</a>, <a href="closedir.html">f_closedir</a>, <a href="sdir.html">DIR</a>, <a href="sfileinfo.html">FILINFO</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/forward.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/forward.html new file mode 100644 index 0000000..99456b2 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/forward.html @@ -0,0 +1,139 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/forward.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_forward</title> +</head> + +<body> + +<div class="para func"> +<h2>f_forward</h2> +<p>ファイルからデータを読み出し、送信ストリームに直接転送します。</p> +<pre> +FRESULT f_forward ( + FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体 */</span> + UINT (*<span class="arg">func</span>)(const BYTE*,UINT), <span class="c">/* [IN] データ転送関数 */</span> + UINT <span class="arg">btf</span>, <span class="c">/* [IN] 転送するバイト数 */</span> + UINT* <span class="arg">bf</span> <span class="c">/* [OUT] 転送されたバイト数 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +<dt>func</dt> +<dd>データを渡すユーザ定義関数へのポインタを指定します。この関数の仕様はサンプルを参照してください。</dd> +<dt>btf</dt> +<dd>転送するバイト数(0～UINTの最大値)を指定します。</dd> +<dt>bf</dt> +<dd>実際に転送されたバイト数を格納する変数を指すポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ファイルのデータをバッファに読み出さずに送信ストリームに直接転送します。アプリケーション側でデータ バッファを必要としないので、メモリの限られた環境で有効です。リード/ライト ポインタは転送されたバイト数だけ進みます。指定されたバイト数の転送中にファイルの終端に達した場合や送信ストリームがビジーになった場合、<tt class="arg">*bf</tt>は<tt class="arg">btf</tt>よりも小さくなります。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_USE_FORWARD == 1</tt>のときに使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例（オーディオ再生）</h4> +<pre> +<span class="c">/*-----------------------------------------------------------------------*/</span> +<span class="c">/* f_forward関数から呼ばれるデータ送信関数の例 */</span> +<span class="c">/*-----------------------------------------------------------------------*/</span> + +UINT out_stream ( <span class="c">/* 戻り値: 転送されたバイト数またはストリームの状態 */</span> + const BYTE *p, <span class="c">/* 転送するデータを指すポインタ */</span> + UINT btf <span class="c">/* >0: 転送を行う(バイト数). 0: ストリームの状態を調べる */</span> +) +{ + UINT cnt = 0; + + + if (btf == 0) { <span class="c">/* センス要求 */</span> + <span class="c">/* ストリームの状態を返す (0: ビジー, 1: レディ) */</span> + <span class="c">/* 一旦、レディを返したら、続く転送要求で少なくとも1バイトは */</span> + <span class="c">/* 転送されないと f_forward関数は FR_INT_ERR となる。 */</span> + if (FIFO_READY) cnt = 1; + } + else { <span class="c">/* 転送要求 */</span> + do { <span class="c">/* 全てのバイトを転送するか、ストリームがビジーになるまで繰り返す */</span> + FIFO_PORT = *p++; + cnt++; + } while (cnt < btf && FIFO_READY); + } + + return cnt; +} + + +<span class="c">/*-----------------------------------------------------------------------*/</span> +<span class="c">/* f_forward関数の使用例 */</span> +<span class="c">/*-----------------------------------------------------------------------*/</span> + +FRESULT play_file ( + char *fn <span class="c">/* 再生するオーディオ ファイル名を指すポインタ */</span> +) +{ + FRESULT rc; + FIL fil; + UINT dmy; + + <span class="c">/* ファイルを読み出しモードで開く */</span> + rc = f_open(&fil, fn, FA_READ); + if (rc) return rc; + + <span class="c">/* 全てのデータが転送されるかエラーが発生するまで続ける */</span> + while (rc == FR_OK && !f_eof(&fil)) { + + <span class="c">/* ほかの処理... */</span> + + <span class="c">/* 定期的または要求に応じてデータをストリームに送出する */</span> + rc = f_forward(&fil, out_stream, 1000, &dmy); + } + + <span class="c">/* ファイルを閉じて戻る */</span> + f_close(&fil); + return rc; +} +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="gets.html">fgets</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getcwd.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getcwd.html new file mode 100644 index 0000000..08bd22a --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getcwd.html @@ -0,0 +1,71 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/getcwd.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_getcwd</title> +</head> + +<body> + +<div class="para func"> +<h2>f_getcwd</h2> +<p>カレント ディレクトリを得ます。</p> +<pre> +FRESULT f_getcwd ( + TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] バッファ */</span> + UINT <span class="arg">len</span> <span class="c">/* [IN] バッファ サイズ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>buff</dt> +<dd>カレント ディレクトリのパス名文字列を格納するバッファ</dd> +<dt>len</dt> +<dd><tt>TCHAR</tt>単位のバッファ サイズ</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>カレント ドライブのカレント ディレクトリのフル パス文字列を取得します。<tt>_VOLUMES</tt>が2以上のときは、論理ドライブ番号の付加されたパス名となります。</p> +<p><em>現リビジョン(R0.12)では、exFATボリューム上ではカレント ディレクトリを得ることが出来ません。常にルート ディレクトリを返します。</em></p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_RPATH == 2</tt>のとき使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="chdrive.html">f_chdrive</a>, <a href="chdir.html">f_chdir</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getfree.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getfree.html new file mode 100644 index 0000000..c821517 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getfree.html @@ -0,0 +1,95 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/getfree.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_getfree</title> +</head> + +<body> + +<div class="para func"> +<h2>f_getfree</h2> +<p>ボリューム上の空き領域のサイズを取得します。</p> +<pre> +FRESULT f_getfree ( + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 対象ドライブを指定します */</span> + DWORD* <span class="arg">nclst</span>, <span class="c">/* [OUT] 空きクラスタ数を格納する変数へのポインタ */</span> + FATFS** <span class="arg">fatfs</span> <span class="c">/* [OUT] ファイル システム オブジェクトを指すポインタへのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>調べる対象の論理ドライブを示す<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ヌル文字列はカレント ドライブを意味します。</dd> +<dt>nclst</dt> +<dd>空きクラスタ数を格納する<tt>DWORD</tt>型変数へのポインタを指定します。</dd> +<dt>fatfs</dt> +<dd>対象ドライブのファイル システム オブジェクトを指すポインタが返されます。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>論理ドライブ上の空き領域のサイズをクラスタ単位で取得します。返されたファイル システム オブジェクトの<tt>csize</tt>メンバがクラスタあたりのセクタ数を示しているので、これを元にセクタ単位の空きサイズが計算できます。FAT32ボリュームにおいては、FSINFOの情報が実際の空きクラスタ数と同期していない場合、不正確な値を返す可能性があります。この問題を避けるため、<tt><a href="config.html#fs_nofsinfo">_FS_NOFSINFO</a></tt>オプションでマウント後の初回は必ずフルFATスキャンをするように構成することもできます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のとき使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + FATFS *fs; + DWORD fre_clust, fre_sect, tot_sect; + + + <span class="c">/* ドライブ1のボリューム情報と空きクラスタ数を得る */</span> + res = f_getfree("1:", &fre_clust, &fs); + if (res) die(res); + + <span class="c">/* 全セクタ数と空きセクタ数を計算 */</span> + tot_sect = (fs->n_fatent - 2) * fs->csize; + fre_sect = fre_clust * fs->csize; + + <span class="c">/* ボリュームのサイズと空きサイズを表示 (512バイト/セクタと仮定) */</span> + printf("%10lu KiB total drive space.\n%10lu KiB available.\n", + tot_sect / 2, fre_sect / 2); +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<tt><a href="sfatfs.html">FATFS</a></tt> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getlabel.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getlabel.html new file mode 100644 index 0000000..160dcf0 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/getlabel.html @@ -0,0 +1,82 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/getlabel.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_getlabel</title> +</head> + +<body> + +<div class="para func"> +<h2>f_getlabel</h2> +<p>ボリューム ラベルを取得します。</p> +<pre> +FRESULT f_getlabel ( + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 対象ドライブ */</span> + TCHAR* <span class="arg">label</span>, <span class="c">/* [OUT] ボリューム名を格納するバッファ */</span> + DWORD* <span class="arg">vsn</span> <span class="c">/* [OUT] ボリューム シリアル番号を格納する変数 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>対象となる論理ドライブの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ヌル文字列の場合は、デフォルト ドライブを指定したことになります。</dd> +<dt>label</dt> +<dd>ボリューム名を格納する配列へのポインタを指定します。<tt>_LFN_UNICODE == 0</tt>では少なくとも24要素、<tt>_LFN_UNICODE == 1</tt>では少なくとも12要素のサイズが必要です。ボリューム名がない場合はヌル文字列が返されます。この情報が不要なときはヌル ポインタを指定してください。</dd> +<dt>vsn</dt> +<dd>ボリューム シリアル番号を格納する<tt>DWORD</tt>型変数へのポインタを指定します。この情報が不要なときはヌル ポインタを指定してください。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_USE_LABEL == 1</tt>のときに使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + char str[24]; + + <span class="c">/* デフォルト ドライブのボリューム名を得る */</span> + f_getlabel("", str, 0); + + <span class="c">/* ドライブ2のボリューム名を得る */</span> + f_getlabel("2:", str, 0); +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<tt><a href="setlabel.html">f_setlabel</a></tt> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/gets.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/gets.html new file mode 100644 index 0000000..e57f7e8 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/gets.html @@ -0,0 +1,65 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/gets.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_gets</title> +</head> + +<body> + +<div class="para func"> +<h2>f_gets</h2> +<p>ファイルから文字列を読み出します。</p> +<pre> +TCHAR* f_gets ( + TCHAR* <span class="arg">buff</span>, <span class="c">/* [OUT] バッファ */</span> + int <span class="arg">len</span>, <span class="c">/* [IN] バッファのサイズ */</span> + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>buff</dt> +<dd>文字列を読み出すバッファを指すポインタを指定します。</dd> +<dt>len</dt> +<dd>バッファのサイズを要素数で指定します。</dd> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>関数が成功すると<tt class="arg">buff</tt>が返されます。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>読み出し動作は、最初の<tt>'\n'</tt>を読み込むか、ファイル終端に達するか、<tt class="arg">len</tt> - 1文字を読み出すまで続きます。読み込まれた文字列の終端には<tt>'\0'</tt>が付加されます。既にファイル終端で1文字も読み込まれなかったとき、または何らかのエラーが発生したときは関数は失敗しヌル ポインタを返します。ファイル終端かエラーかは<tt>f_eof/f_error</tt>関数で調べられます。</p> +<p>Unicode API構成(<tt>_LFN_UNICODE == 1</tt>)が選択されているときは、<tt class="arg">buff</tt>はUTF-16文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で読み出します。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>この関数は<a href="read.html"><tt>f_read</tt></a>関数のラッパー関数です。<tt>_USE_STRFUNC</tt>が1または2のとき使用可能です。2のときは、ファイルに含まれる<tt>'\r'</tt>が取り除かれてバッファに読み込まれます。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="putc.html">f_putc</a>, <a href="puts.html">f_puts</a>, <a href="printf.html">f_printf</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/lseek.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/lseek.html new file mode 100644 index 0000000..59f801c --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/lseek.html @@ -0,0 +1,130 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/lseek.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_lseek</title> +</head> + +<body> + +<div class="para func"> +<h2>f_lseek</h2> +<p>ファイルのリード/ライト ポインタを移動します。また、高速シーク機能使用時にはCLMT(後述)の作成にも使用します。</p> +<pre> +FRESULT f_lseek ( + FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体へのポインタ */</span> + FSIZE_t <span class="arg">ofs</span> <span class="c">/* [IN] 移動先オフセット */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>対象となるファイル オブジェクト構造体へのポインタを指定します。</dd> +<dt>ofs</dt> +<dd>移動先のオフセット(リード/ライト ポインタ)値。ファイル先頭からのオフセットをバイト単位で指定します。データ型<tt>FSIZE_t</tt>は、<tt>DWORD</tt>(32-bit)または<tt>QWORD</tt>(64-bit)のエリアスで、exFATサポートの有無により切り替わります。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ファイルのリード/ライト ポインタ(次に読み出し・書き込みされるバイトのオフセット)を移動します。オフセットの原点はファイル先頭です。書き込みモードでファイル サイズより大きな値を指定すると、そこまでファイル サイズが拡張され、拡張された部分のデータは未定義となります。データを遅延無く高速に書き込みたいときは、予めこの関数で必要なサイズまでファイル サイズを拡張しておくと良いでしょう。ファイルに連続したデータ領域を割り当てる必要があるときは、<tt>f_expand</tt>関数を使用してください。<tt>f_lseek</tt>関数が正常終了したあとは、リード/ライト ポインタが正しく移動したかチェックするべきです。リード/ライト ポインタが指定より小さいときは、次の原因が考えられます。</p> +<ul> +<li>非書き込みモードまたは高速シーク モードのため、ファイル サイズでクリップされた。</li> +<li>ファイル拡張中にディスクが満杯になった。</li> +</ul> +<p>高速シーク モードは、ファイルのクラスタ配置情報(CLMT)をメモリ上に保持しておくことにより、FATにアクセスすることなく後方シークやロング シークを高速に行う機能で、シーク動作のほか<tt>f_read/f_wtite</tt>関数の動作にも適用されます。ファイルが高速シーク モードの間は<tt>f_wtite/f_lseek</tt>関数によるファイル サイズの拡張はできません。</p> +<p>高速シーク モードは、ファイル オブジェクトのメンバ<tt>cltbl</tt>(<tt>f_open</tt>関数でNULLになる)にNULL以外を設定したとき有効になるので、まずCLMTを作成しておく必要があります。これを作成するには、まずCLMT格納バッファ(<tt>DWORD</tt>型配列)を準備し、<tt>cltbl</tt>にそのポインタをセットします。そして、配列の先頭要素にその配列のサイズ(要素数)を入れ、<tt>f_lseek</tt>関数を<tt class="arg">ofs</tt>に<tt>CREATE_LINKMAP</tt>を指定して呼び出します。関数が成功するとCLMTが作成され、以降の<tt>f_read/f_write/f_lseek</tt>関数ではFATへのアクセスは発生しません。CLMTの先頭要素には実際に使用した(または必要となる)要素数が返されます。使用される要素数は、(ファイルの分割数 + 1) * 2 です。たとえば、ファイルが5つのフラグメントに分断されているときは、12要素が使用されます。<tt>FR_NOT_ENOUGH_CORE</tt>で失敗したときは、配列サイズが不足です。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_MINIMIZE < 3</tt>のとき使用可能です。高速シーク モードを利用するときは、<tt><a href="config.html#use_fastseek">_USE_FASTSEEK</a> == 1</tt>である必要があります。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + <span class="c">/* ファイルを開く */</span> + fp = malloc(sizeof (FIL)); + res = f_open(fp, "file.dat", FA_READ|FA_WRITE); + if (res) ... + + <span class="c">/* ファイル オフセット5000へ移動 */</span> + res = f_lseek(fp, 5000); + + <span class="c">/* ファイル終端へ移動(ファイル追記の準備) */</span> + res = f_lseek(fp, f_size(fp)); + + <span class="c">/* 3000バイト進める */</span> + res = f_lseek(fp, f_tell(fp) + 3000); + + <span class="c">/* 2000バイト戻す (ラップアラウンドに注意) */</span> + res = f_lseek(fp, f_tell(fp) - 2000); +</pre> +<pre> +<span class="c">/* クラスタ先行割り当て (ストリーミング ライト時のバッファ オーバーラン防止) */</span> + + res = f_open(fp, "record.wav", FA_CREATE_NEW | FA_WRITE); <span class="c">/* ファイル作成 */</span> + + res = f_lseek(fp, MAX_SIZE); <span class="c">/* 十分なクラスタの先行割り当て */</span> + if (res || f_tell(fp) != PRE_SIZE) ... <span class="c">/* 正しくファイルが拡張されたかチェック */</span> + + res = f_lseek(fp, DATA_START); <span class="c">/* データ ストリームの記録(アロケーションディレイ無し) */</span> + ... + + res = f_truncate(fp); <span class="c">/* 不要領域の切り捨て */</span> + res = f_lseek(fp, 0); <span class="c">/* ヘッダの記録 */</span> + ... + + res = f_close(fp); +</pre> +<pre> +<span class="c">/* 高速シーク機能を使う */</span> + + DWORD clmt[SZ_TBL]; <span class="c">/* リンク マップ テーブル格納バッファ */</span> + + res = f_open(fp, fname, FA_READ | FA_WRITE); <span class="c">/* ファイルを開く */</span> + + res = f_lseek(fp, ofs1); <span class="c">/* 通常シーク (オープン時、cltblはNULLに初期化される) */</span> + + fp->cltbl = clmt; <span class="c">/* 高速シーク機能の有効化 */</span> + clmt[0] = SZ_TBL; <span class="c">/* 先頭要素に配列要素数をセット */</span> + res = f_lseek(fp, CREATE_LINKMAP); <span class="c">/* CLMTの作成 */</span> + ... + + res = f_lseek(fp, ofs2); <span class="c">/* 以降、f_read/f_write/f_lseekでFATアクセスは発生しない */</span> +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="truncate.html">f_truncate</a>, <a href="expand.html">f_expand</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mkdir.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mkdir.html new file mode 100644 index 0000000..eb301f5 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mkdir.html @@ -0,0 +1,80 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/mkdir.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_mkdir</title> +</head> + +<body> + +<div class="para func"> +<h2>f_mkdir</h2> +<p>サブ ディレクトリを作成します。</p> +<pre> +FRESULT f_mkdir ( + const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] 作成するディレクトリ名へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>作成するディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#ex">FR_EXIST</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>空のサブ ディレクトリを作成します。ディレクトリを削除するときは<a href="unlink.html"><tt>f_unlink</tt></a>関数を使用してください。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のとき使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + res = f_mkdir("sub1"); + if (res) die(res); + res = f_mkdir("sub1/sub2"); + if (res) die(res); + res = f_mkdir("sub1/sub2/sub3"); + if (res) die(res); +</pre> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mkfs.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mkfs.html new file mode 100644 index 0000000..7aacdd8 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mkfs.html @@ -0,0 +1,114 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/mkfs.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_mkfs</title> +</head> + +<body> + +<div class="para func"> +<h2>f_mkfs</h2> +<p>論理ドライブ上にFAT/exFATボリュームを作成(フォーマット)します。</p> +<pre> +FRESULT f_mkfs ( + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 論理ドライブ番号 */</span> + BYTE <span class="arg">opt</span>, <span class="c">/* [IN] フォーマット オプション */</span> + DWORD <span class="arg">au</span>, <span class="c">/* [IN] クラスタ サイズ */</span> + void* <span class="arg">work</span>, <span class="c">/* [-] ワーク エリア */</span> + UINT <span class="arg">len</span> <span class="c">/* [IN] ワーク エリアのサイズ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>フォーマット対象の論理ドライブを示す<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。ドライブ番号を含まない場合は、デフォルト ドライブを意味します。論理ドライブには<tt>f_mount</tt>関数でワークエリアが与えられている必要はありません。</dd> +<dt>opt</dt> +<dd>フォーマット オプション。<tt>FM_FAT, FM_FAT32, FM_EXFAT</tt>の各フラグの組み合わせ(<tt>FM_ANY</tt>は、これらのOR値)で作成するFATボリュームのタイプを指定します。複数のタイプが指定された場合、その中のいずれかが自動選択されます。exFATが無効のときは、<tt>FM_EXFAT</tt>は無視されます。<tt>FM_SFD</tt>フラグを指定すると、SFD形式(後述)でボリュームを配置します。</dd> +<dt>au</dt> +<dd>クラスタ サイズをバイト単位で指定します。有効値は、セクタ サイズのN倍となります。Nは2の累乗で、FAT/FAT32ボリュームでは1～128、exFATボリュームでは1～32768です。0を指定した場合は、ボリュームのサイズと選択されたFATタイプに応じたデフォルトのクラスタ サイズが選択されます。</dd> +<dt>work</dt> +<dd>ワークエリアへのポインタを指定します。</dd> +<dt>len</dt> +<dd>ワークエリアのサイズをバイト単位で指定します。ワークエリアのサイズは少なくとも関連するドライブのセクタサイズは必要です。また、十分に大きなサイズを与えることにより、書き込みトランザクションの回数が減ってフォーマット時間を短縮できます。</dd> +</dl> +</div> + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ma">FR_MKFS_ABORTED</a>, +<a href="rc.html#ip">FR_INVALID_PARAMETER</a> +</p> +</div> + +<div class="para desc"> +<h4>説明</h4> +<p>exFAT以外のボリュームのFATタイプ(FAT12/FAT16/FAT32)は、そのボリューム上の<em>クラスタ数によってのみ決定</em>される決まり[FAT仕様書より]になっていて、それ以外の要因はありません。したがって、どのFATタイプになるかはボリューム サイズとクラスタ サイズに依存します。そのボリュームのサイズにおいて、指定されたFATタイプとクラスタ サイズの組み合わせが成立し得ないときは、関数は<tt>FR_MKFS_ABORTED</tt>で失敗します。</p> +<p>クラスタとは、データ格納領域の管理の単位のことで、これを単位にファイルにデータ領域が割り当てられます。たとえば、クラスタ サイズが32768のときは、100バイトのファイルも32768バイトのスペースを消費することになります。このように、クラスタ サイズを大きくするほどボリュームの利用効率が悪くなりますが、その一方で読み書きの性能は上がります。クラスタ サイズによる利用効率と性能はトレード オフの関係にあります。GBクラスのストレージでは、極端に多くのファイルを扱わない限り32768バイト以上に(デフォルト指定ではそのようになる)しておくとよいでしょう。</p> +<p>パーテーション形式には、FDISK形式とSFD形式の二通りあります。FDISK形式は、ハードディスク、マルチメディアカード、SDカード、CFカード、USBメモリなどで標準的に使用されます。FDISK形式では一台の物理ドライブ上に一つまたは複数の区画を作成することができ、区画管理情報はMBR(物理ドライブの先頭セクタ)に記録されます。SFD形式は単に何の分割も行わない形式で、ボリュームは物理ドライブの先頭セクタから開始します。SFD形式は、フロッピー ディスク、マイクロドライブ、光学ディスク、およびその他スーパー フロッピー メディアで標準的に使用されています。システムによっては、FDISK形式またはSFD形式のどちらか一方のみをサポートし他方をサポートしません。</p> +<p><tt>FM_SFD</tt>が指定されないときはFDISK形式となり、その物理ドライブ全体を占める1個の基本区画(パーテーション)が作成され、その中にFATボリュームが作成されます。<tt>FM_SFD</tt>が指定されたときはSFD形式となり、FATボリュームがその物理ドライブの先頭セクタからベタで作成されます。</p> +<p>マルチ パーテーション機能(<tt><a href="config.html#multi_partition">_MULTI_PARTITION</a></tt>)により、その論理ドライブが特定の区画(1～4)に結び付けられている場合は、その区画の中にFATボリュームが作成されます。<tt>FM_SFD</tt>の指定は無視され、その物理ドライブはこれに先立ち、<tt>f_fdisk</tt>関数または他のツールで適切に区画設定されている必要があります。</p> +</div> + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_MKFS == 1</tt>のとき使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> +<span class="c">/* Format default drive and create a file */</span> +int main (void) +{ + FATFS fs; <span class="c">/* File system object */</span> + FIL fil; <span class="c">/* File object */</span> + FRESULT res; <span class="c">/* API result code */</span> + UINT bw; <span class="c">/* Bytes written */</span> + BYTE work[_MAX_SS]; <span class="c">/* Work area (larger is better for process time) */</span> + + + <span class="c">/* Create FAT volume */</span> + res = f_mkfs("", FM_ANY, 0, work, sizeof work); + if (res) ... + + <span class="c">/* Register work area */</span> + f_mount(&fs, "", 0); + + <span class="c">/* Create a file as new */</span> + res = f_open(&fil, "hello.txt", FA_CREATE_NEW | FA_WRITE); + if (res) ... + + <span class="c">/* Write a message */</span> + f_write(&fil, "Hello, World!\r\n", 15, &bw); + if (bw != 15) ... + + <span class="c">/* Close the file */</span> + f_close(&fil); + + ... +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><a href="../res/mkfs.xls">ボリューム サイズとフォーマット パラメータ</a>, <a href="filename.html#vol">ボリューム管理</a>, <tt><a href="fdisk.html">f_fdisk</a></tt></p> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mount.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mount.html new file mode 100644 index 0000000..2ce701f --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/mount.html @@ -0,0 +1,82 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/mount.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_mount</title> +</head> + +<body> + +<div class="para func"> +<h2>f_mount</h2> +<p>論理ドライブにファイル システム オブジェクトを登録・抹消します。</p> +<pre> +FRESULT f_mount ( + FATFS* <span class="arg">fs</span>, <span class="c">/* [IN] ファイル システム オブジェクト */</span> + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] 論理ドライブ番号 */</span> + BYTE <span class="arg">opt</span> <span class="c">/* [IN] 動作オプション */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fs</dt> +<dd>登録するファイル システム オブジェクトへのポインタ、またはヌル ポインタ</dd> +<dt>path</dt> +<dd>対象となる論理ドライブの<a href="filename.html">パス名</a>を示すヌル文字'\0'終端の文字列へのポインタを指定します。パス名にドライブ番号が含まれない場合は、デフォルト ドライブを指定したことになります。</dd> +<dt>opt</dt> +<dd>ファイル システム オブジェクトの登録と同時にマウント動作を行うかどうかを指定するフラグ。登録抹消のときは意味を持ちません。</dd> +</dl> +</div> + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>FatFsモジュールでは、それぞれの論理ドライブに<em>ファイル システム オブジェクト</em>というワーク エリアが必要です。この関数は論理ドライブにファイル システム オブジェクトを登録したり抹消したりします。何らかのファイル関数を使用する前に、この関数でその論理ドライブのファイル システム オブジェクトを与えておかなければなりません。<tt class="arg">fs</tt>にヌル ポインタを指定すると、その論理ドライブのファイル システム オブジェクトの登録は抹消されるだけです。登録抹消されたファイル システム オブジェクトのメモリは解放できます。操作の対象の論理ドライブ上に開かれたままのファイルやディレクトリがあった場合、それらに対して作成された構造体は全て無効になります。この関数の内部処理は次のような順に行われます。</p> +<ol> +<li>対象の論理ドライブを<tt class="arg">path</tt>から得る。</li> +<li>登録されているファイル システム オブジェクトがあるときは、それをクリア(無効化)し、登録を解除する。</li> +<li><tt class="arg">fs</tt>が有効なポインタのときは、そのファイル システム オブジェクトをクリアし、登録する。</li> +<li>マウント動作が指定されているときは、それを実行する。</li> +</ol> +<p><tt class="arg">opt</tt>に0を指定すると、マウント動作(物理ドライブの初期化、FATボリュームの検索、BPBを解析しファイル システム オブジェクトを初期化)は行われず、関数は物理ドライブの状態に関わらず常に成功します。関数内では下位レイヤへのアクセスは発生せず、指定されたファイル システム オブジェクトをクリア(無効化)し、そのアドレスを内部配列に登録するだけです。単に登録済みのファイル システム オブジェクトをクリアする目的にも使えます。実際のマウント動作は、ボリュームへのアクセス(パス名を渡すもの全て)が行われたときに、次のうちいずれかの条件が真の場合に行われます。</p> +<ul> +<li>ファイル システム オブジェクトがクリア(無効)状態(<tt>f_mount</tt>関数の実行による)</li> +<li>物理ドライブが未初期化状態(システム リセットやメディアの交換による)</li> +</ul> +<p><tt class="arg">opt</tt>に1を指定すると、ファイル システムオブジェクトの登録に続きマウント動作が行われます。メディアが無いなどの理由でマウント動作に失敗すると対応するエラーを返しファイル システム オブジェクトはクリア状態のままになりますが、登録自体は有効なので続いてボリュームへのアクセスがあれば再びマウント動作が実行されます。</p> +<p>下位レイヤの実装上メディア交換の検出がサポートされない(<tt>disk_status</tt>関数に反映されない)ときは、アプリケーションはメディア交換の後この関数でファイル システム オブジェクトを明示的にクリアし、マウント動作が正常に行えるようにする必要があります。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>全ての構成で使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a></tt>, <tt><a href="sfatfs.html">FATFS</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/open.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/open.html new file mode 100644 index 0000000..1213074 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/open.html @@ -0,0 +1,172 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/open.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_open</title> +</head> + +<body> + +<div class="para func"> +<h2>f_open</h2> +<p>ファイルをオープンまたは作成します。</p> +<pre> +FRESULT f_open ( + FIL* <span class="arg">fp</span>, <span class="c">/* [OUT] 空のファイル オブジェクト構造体へのポインタ */</span> + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] ファイル名へのポインタ */</span> + BYTE <span class="arg">mode</span> <span class="c">/* [IN] モードフラグ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>新しく作成するファイル オブジェクト構造体へのポインタを指定します。以降、そのファイルを閉じるまでこのファイル オブジェクトを使用してファイル操作をします。</dd> +<dt>path</dt> +<dd>開くファイルの<a href="filename.html">ファイル名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +<dt>mode</dt> +<dd>ファイルのアクセス方法やオープン方法を決めるフラグです。このパラメータには次の組み合わせを指定します。<br> +<table class="lst"> +<tr><th>値</th><th>意味</th></tr> +<tr><td>FA_READ</td><td>読み出しモードで開きます。読み書きする場合は<tt>FA_WRITE</tt>と共に指定します。</td></tr> +<tr><td>FA_WRITE</td><td>書き込みモードで開きます。読み書きする場合は<tt>FA_READ</tt>と共に指定します。</td></tr> +<tr><td>FA_OPEN_EXISTING</td><td>既存のファイルを開きます。ファイルが無いときはエラーになります。(デフォルト)</td></tr> +<tr><td>FA_CREATE_NEW</td><td>ファイルを作成します。同名のファイルがある場合は、<tt>FR_EXIST</tt>で失敗します。</td></tr> +<tr><td>FA_CREATE_ALWAYS</td><td>ファイルを作成します。同名のファイルがある場合は、サイズを0にしてから開きます。</td></tr> +<tr><td>FA_OPEN_ALWAYS</td><td>既存のファイルを開きます。ファイルが無いときはファイルを作成します。</td></tr> +<tr><td>FA_OPEN_APPEND</td><td><tt>FA_OPEN_ALWAYS</tt>と同じですが、リード/ライト ポインタはファイルの最後尾にセットされます。</td></tr> +</table> +</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#ex">FR_EXIST</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#lo">FR_LOCKED</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a>, +<a href="rc.html#tf">FR_TOO_MANY_OPEN_FILES</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>既存のファイルを開いたり、新しいファイルを作成します。関数が成功するとファイル オブジェクトが作成され、以降そのファイルに対するアクセスに使用します。ファイルを閉じるときは、<a href="close.html"><tt>f_close</tt></a>関数を使用します。何らかの変更が行われたファイルがその後正しく閉じられなかった場合、そのファイルが破損する場合があります。</p> +<p>既に開かれているファイルを開く必要がある場合は、<a href="appnote.html#dup">多重アクセス制御</a>を参照してください。しかし、一つのファイルに対する書き込みモードを含む重複オープンは常に禁止です。</p> +<p>ファイル アクセスを開始する前に、<a href="mount.html"><tt>f_mount</tt></a>関数を使ってそれぞれの論理ドライブにワーク エリア(ファイル システム オブジェクト)を与える必要があります。この初期化の後、その論理ドライブに対して全てのファイル関数が使えるようになります。<tt>f_mkfs</tt>関数と<tt>f_fdsk</tt>関数は、ワークエリア無しでも使えます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>全ての構成で使用可能です。<tt>_FS_READONLY == 1</tt>のときは、<tt>FA_READ</tt>と<tt>FA_OPEN_EXISTING</tt>以外の各フラグはサポートされません。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> +<span class="c">/* テキストファイルを読み出して表示 */</span> + +FATFS FatFs; <span class="c">/* 論理ドライブのワーク エリア(ファイル システム オブジェクト) */</span> + +int main (void) +{ + FIL fil; <span class="c">/* ファイル オブジェクト */</span> + char line[82]; <span class="c">/* 行バッファ */</span> + FRESULT fr; <span class="c">/* 戻り値 */</span> + + + <span class="c">/* デフォルト ドライブにワークエリアを与える */</span> + f_mount(&FatFs, "", 0); + + <span class="c">/* テキスト ファイルを開く */</span> + fr = f_open(&fil, "message.txt", FA_READ); + if (fr) return (int)fr; + + <span class="c">/* 1行ずつ読み出して表示 */</span> + while (f_gets(line, sizeof line, &fil)) + printf(line); + + <span class="c">/* ファイルを閉じる */</span> + f_close(&fil); + + return 0; +} +</pre> +<pre> +<span class="c">/* ドライブ1のファイル "file.bin" をドライブ0へコピー */</span> + +int main (void) +{ + FATFS fs[2]; <span class="c">/* 論理ドライブのワークエリア(ファイル システム オブジェクト) */</span> + FIL fsrc, fdst; <span class="c">/* ファイル オブジェクト */</span> + BYTE buffer[4096]; <span class="c">/* File copy buffer */</span> + FRESULT fr; <span class="c">/* FatFs function common result code */</span> + UINT br, bw; <span class="c">/* File R/W count */</span> + + <span class="c">/* ドライブ0,1にワーク エリアを与える */</span> + f_mount(&fs[0], "0:", 0); + f_mount(&fs[1], "1:", 0); + + <span class="c">/* ドライブ1のコピー元ファイルを開く */</span> + res = f_open(&fsrc, "1:file.dat", FA_OPEN_EXISTING | FA_READ); + if (fr) return (int)fr; + + <span class="c">/* ドライブ0にコピー先ファイルを作成する */</span> + res = f_open(&fdst, "0:file.dat", FA_CREATE_ALWAYS | FA_WRITE); + if (fr) return (int)fr; + + <span class="c">/* コピー元からコピー先にデータ転送する */</span> + for (;;) { + res = f_read(&fsrc, buffer, sizeof buffer, &br); <span class="c">/* コピー元からから読み出す */</span> + if (res || br == 0) break; <span class="c">/* エラーかファイル終端 */</span> + res = f_write(&fdst, buffer, br, &bw); <span class="c">/* それをコピー先に書き込む */</span> + if (res || bw < br) break; <span class="c">/* エラーかディスク満杯 */</span> + } + + <span class="c">/* 全てのファイルを閉じる */</span> + f_close(&fsrc); + f_close(&fdst); + + <span class="c">/* ワーク エリアを開放する */</span> + f_mount(NULL, "0:", 0); + f_mount(NULL, "1:", 0); + + return (int)fr; +} +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="read.html">f_read</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a>, <a href="sfatfs.html">FATFS</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/opendir.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/opendir.html new file mode 100644 index 0000000..166ee7d --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/opendir.html @@ -0,0 +1,75 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/opendir.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_opendir</title> +</head> + +<body> + +<div class="para func"> +<h2>f_opendir</h2> +<p>ディレクトリを開きます。</p> +<pre> +FRESULT f_opendir ( + DIR* <span class="arg">dp</span>, <span class="c">/* [OUT] ディレクトリ ブジェクト構造体へのポインタ */</span> + const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] ディレクトリ名へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>dp</dt> +<dd>空のディレクトリ オブジェクト構造体へのポインタを指定します。</dd> +<dt>path</dt> +<dd>開くディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a>, +<a href="rc.html#tf">FR_TOO_MANY_OPEN_FILES</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ディレクトリを開きます。正常終了したら、作成されたディレクトリ オブジェクト構造体を使ってこのディレクトリの項目を順次読み出せます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_MINIMIZE <= 1</tt>のとき使用可能になります。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="readdir.html">f_readdir</a>, <a href="closedir.html">f_closedir</a>, <a href="sdir.html">DIR</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/printf.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/printf.html new file mode 100644 index 0000000..6534c84 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/printf.html @@ -0,0 +1,93 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/printf.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_printf</title> +</head> + +<body> + +<div class="para func"> +<h2>f_printf</h2> +<p>ファイルに書式化文字列を書き込みます。</p> +<pre> +int f_printf ( + FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト */</span> + const TCHAR* <span class="arg">fmt</span>, <span class="c">/* [IN] 書式制御文字列 */</span> + ... +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +<dt>fmt</dt> +<dd>ヌル文字<tt>'\0'</tt>終端の書式制御文字列を指すポインタを指定します。ヌル文字は書き込まれません。</dd> +<dt>...</dt> +<dd>オプションの引数。</dd> + +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはその他エラーにより正常に書き込まれなかったときは、関数は失敗し<tt>EOF (-1)</tt>が返されます。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>書式制御機能はC標準ライブラリのサブセットとなっていて、書式制御文字は次に示すものが使用可能です。</p> +<ul> +<li>タイプ: <tt>c C s S d D u U x X b B</tt></li> +<li>精度指定: <tt>l L</tt></li> +<li>フラグ: <tt>0 -</tt></li> +</ul> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>この関数は、<a href="putc.html"><tt>f_putc</tt></a>関数および<a href="puts.html"><tt>f_puts</tt></a>関数のラッパー関数です。<tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が1または2のとき使用可能になります。2の時は、出力に含まれる<tt>'\n'</tt>が<tt>'\r'+'\n'</tt>に展開されてファイルに書き込まれます。</p> +<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">fmt</tt>はUnicode文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + f_printf(&fil, "%d", 1234); <span class="c">/* "1234" */</span> + f_printf(&fil, "%6d,%3d%%", -200, 5); <span class="c">/* " -200, 5%" */</span> + f_printf(&fil, "%ld", 12345L); <span class="c">/* "12345" */</span> + f_printf(&fil, "%06d", 25); <span class="c">/* "000025" */</span> + f_printf(&fil, "%06d", -25); <span class="c">/* "000-25" */</span> + f_printf(&fil, "%-6d", 25); <span class="c">/* "25 " */</span> + f_printf(&fil, "%u", -1); <span class="c">/* "65535" or "4294967295" */</span> + f_printf(&fil, "%04x", 0xAB3); <span class="c">/* "0ab3" */</span> + f_printf(&fil, "%08LX", 0x123ABCL); <span class="c">/* "00123ABC" */</span> + f_printf(&fil, "%016b", 0x550F); <span class="c">/* "0101010100001111" */</span> + f_printf(&fil, "%s", "String"); <span class="c">/* "String" */</span> + f_printf(&fil, "%8s", "abc"); <span class="c">/* " abc" */</span> + f_printf(&fil, "%-8s", "abc"); <span class="c">/* "abc " */</span> + f_printf(&fil, "%c", 'a'); <span class="c">/* "a" */</span> + f_printf(&fil, "%f", 10.0); <span class="c">/* 浮動小数点は未サポート */</span> +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="putc.html">f_putc</a>, <a href="puts.html">f_puts</a>, <a href="gets.html">f_gets</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/putc.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/putc.html new file mode 100644 index 0000000..57af633 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/putc.html @@ -0,0 +1,62 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/putc.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_putc</title> +</head> + +<body> + +<div class="para func"> +<h2>f_putc</h2> +<p>ファイルに文字を書き込みます。</p> +<pre> +int f_putc ( + TCHAR <span class="arg">chr</span>, <span class="c">/* [IN] 書き込む文字 */</span> + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>chr</dt> +<dd>書き込む文字を指定します。</dd> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>文字が正常に書き込まれると書き込んだ文字数が返されます。ディスクが満杯またはエラーにより書き込まれなかったときは<tt>EOF (-1)</tt>が返されます。</p> +<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">chr</tt>はUTF-16文字になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>1文字をファイルに書き込みます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>この関数は<a href="write.html"><tt>f_write</tt></a>関数のラッパー関数です。<tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が 1または 2のとき使用可能です。2を指定すると、<tt>'\n'</tt>は<tt>'\r'+'\n'</tt>に展開されてファイルに書き込まれます。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="puts.html">f_puts</a>, <a href="printf.html">f_printf</a>, <a href="gets.html">f_gets</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/puts.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/puts.html new file mode 100644 index 0000000..4e4ed9e --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/puts.html @@ -0,0 +1,62 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/puts.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_puts</title> +</head> + +<body> + +<div class="para func"> +<h2>f_puts</h2> +<p>ファイルに文字列を書き込みます。</p> +<pre> +int f_puts ( + const TCHAR* <span class="arg">str</span>, <span class="c">/* [IN] 書き込む文字列 */</span> + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>str</dt> +<dd>書き込むヌル文字<tt>'\0'</tt>終端の文字列を指すポインタを指定します。ヌル文字は書き込まれません。</dd> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>文字列が正常に書き込まれると、書き込まれた文字数が返されます。ディスクが満杯またはエラーにより書き込みが中断されたときは<tt>EOF (-1)</tt>が返されます。</p> +<p>APIにUnicodeが選択(<tt>_LFN_UNICODE</tt>が1)されているときは、<tt class="arg">str</tt>はUTF-16文字列になりますが、ファイル上のエンコードは、<tt>_STRF_ENCODE</tt>オプションで選択できます。それ以外の時は無変換(1バイト/1文字)で書き込みます。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>文字列をファイルに書き込みます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>この関数は<a href="write.html"><tt>f_write</tt></a>関数のラッパー関数です。<tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_STRFUNC</tt>が1または2のとき使用可能です。2を指定すると、文字列に含まれる<tt>'\n'</tt>は<tt>'\r'+'\n'<tt>に展開されてファイルに書き込まれます。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="putc.html">f_putc</a>, <a href="printf.html">f_printf</a>, <a href="gets.html">f_gets</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/rc.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/rc.html new file mode 100644 index 0000000..82da6f2 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/rc.html @@ -0,0 +1,95 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/rc.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - 戻り値</title> +</head> + +<body> +<h1>ファイル関数の戻り値</h1> +<p>FatFsのAPIでは、一部の関数を除き結果に応じた共通のリザルト コード(FRESULT型(enum))を返します。関数が成功した場合は0 (<tt>FR_OK</tt>)を返します。失敗した場合は0以外の値を返し、値はエラーの種類を示します。</p> + +<dl class="ret"> +<dt id="ok">FR_OK (0)</dt> +<dd>関数は成功した。</dd> +<dt id="de">FR_DISK_ERR</dt> +<dd>下位レイヤ(<tt>disk_read/disk_write/disk_ioctl</tt>関数)で回復不能なエラーが発生した。<br>※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd> +<dt id="ie">FR_INT_ERR</dt> +<dd>内部処理の健全性チェックで何らかの異常が検出された。原因としては次のようなことが考えられます。 +<ul> +<li>スタック不足や不正なメモリ操作等によるワーク エリアの破壊。多くはこれが原因。</li> +<li>ボリューム上のFAT構造にエラーがある。</li> +<li>FatFsモジュール自体のバグ。</li> +</ul> +※開かれたファイルの操作においてこのエラーが発生すると、そのファイル オブジェクトはアボート状態となり、クローズ以外の操作ができなくなります。</dd> +<dt id="nr">FR_NOT_READY</dt> +<dd>下位レイヤ(<tt>disk_initialize</tt>関数)の失敗。つまり、物理ドライブが動作可能な状態にない。</dd> +<dt id="nf">FR_NO_FILE</dt> +<dd>指定されたファイルが見つからなかった。</dd> +<dt id="np">FR_NO_PATH</dt> +<dd>指定されたパスが見つからなかった。</dd> +<dt id="in">FR_INVALID_NAME</dt> +<dd>指定された文字列が<a href="filename.html">パス名のフォーマット</a>として無効。</dd> +<dt id="dn">FR_DENIED</dt> +<dd>そのオブジェクトに対する操作の拒否。原因としては次のようなことが考えられます。 +<ul> +<li>書き込み禁止属性(<tt>AM_RDO</tt>)を持つファイルを書き込みモードで開こうとした。</li> +<li>書き込み禁止属性を持つオブジェクトを削除しようとした。</li> +<li>空でないディレクトリまたはカレント ディレクトリを削除しようとした。</li> +<li><tt>FA_READ</tt>フラグを付けずに開いたファイルに対して読み出しを行った。</li> +<li><tt>FA_WRITE</tt>フラグを付けずに開いたファイルに対して変更を加えようとした。</li> +<li>ボリュームまたは静的ディレクトリ(FAT12/16のルート)が満杯でディレクトリ エントリの新規作成ができなかった。</li> +<li>ファイルに割り当てる連続領域が見つからなかった。</li> +</ul> +</dd> +<dt id="ex">FR_EXIST</dt> +<dd>新しく作成しようとしたオブジェクトと同じ名前のオブジェクトが既に存在する。</dd> +<dt id="io">FR_INVALID_OBJECT</dt> +<dd>指定されたファイル オブジェクトやディレクトリ オブジェクトが無効、またはヌル ポインタが渡された。無効になる理由は次のことが考えられます。 +<ul> +<li>オープンされていない、既に閉じられた、破損しているなど。</li> +<li>そのボリュームでマウント動作があり、ボリューム上の開かれたオブジェクトが全て無効化された。</li> +<li>物理ドライブがメディアの取り外しで動作不可能になっている。</li> +</ul> +</dd> +<dt id="wp">FR_WRITE_PROTECTED</dt> +<dd>物理ドライブが書き込み禁止状態のとき、書き込みを伴う操作を行おうとした。</dd> +<dt id="id">FR_INVALID_DRIVE</dt> +<dd>パス名中に指定されたドライブ番号が無効、またはパス名にヌル ポインタが渡された。(関連オプション: <tt><a href="config.html#volumes">_VOLUMES</a></tt>)</dd> +<dt id="ne">FR_NOT_ENABLED</dt> +<dd>そのボリュームの操作に必要なワーク エリア(ファイル システム オブジェクト構造体)が与えられていない。</dd> +<dt id="ns">FR_NO_FILESYSTEM</dt> +<dd>物理ドライブ上に有効なFATボリュームが見つからなかった。</dd> +<dt id="ma">FR_MKFS_ABORTED</dt> +<dd><tt>f_mkfs</tt>関数の処理が開始前に中断された。原因としては次のようなことが考えられます。 +<ul> +<li>指定されたパラメータでのフォーマットが不可能。</li> +<li>ボリュームのサイズが小さすぎる。</li> +<li>与えられたワークエリアが小さすぎる。</li> +<li>その論理ドライブに対応する区画が見つからなかった。(関連オプション: <tt><a href="config.html#multi_partition">_MULTI_PARTITION</a></tt>)</li> +</ul> +</dd> +<dt id="tm">FR_TIMEOUT</dt> +<dd><a href="appnote.html#reentrant">再入制御</a>による待ち時間が定義された時間を越えたため、関数は実行されなかった。(関連オプション: <tt><a href="config.html#timeout">_TIMEOUT</a></tt>)</dd> +<dt id="lo">FR_LOCKED</dt> +<dd><a href="appnote.html#dup">多重アクセス排他機能</a>により、そのファイルやディレクトリに対して行おうとしたアクセスが拒否された。(関連オプション: <tt><a href="config.html#fs_lock">_FS_LOCK</a></tt>)</dd> +<dt id="nc">FR_NOT_ENOUGH_CORE</dt> +<dd>メモリ不足による失敗。原因としては次のようなことが考えられます。 +<ul> +<li>LFN操作バッファの動的確保に失敗した。(関連オプション: <tt><a href="config.html#use_lfn">_USE_LFN</a></tt>)</li> +<li>与えられた配列のサイズが実際に必要なサイズに対して不足している。</li> +</ul> +</dd> +<dt id="tf">FR_TOO_MANY_OPEN_FILES</dt> +<dd>同時オープン可能なファイル数を越えてファイルを開こうとした。(関連オプション: <tt><a href="config.html#fs_lock">_FS_LOCK</a></tt>)</dd> +<dt id="ip">FR_INVALID_PARAMETER</dt> +<dd>与えられたパラメータが無効または矛盾している。</dd> +</dl> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/read.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/read.html new file mode 100644 index 0000000..b73a5d9 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/read.html @@ -0,0 +1,74 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/read.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_read</title> +</head> + +<body> + +<div class="para func"> +<h2>f_read</h2> +<p>ファイルからデータを読み出します。</p> +<pre> +FRESULT f_read ( + FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト構造体 */</span> + void* <span class="arg">buff</span>, <span class="c">/* [OUT] 読み出したデータを格納するバッファ */</span> + UINT <span class="arg">btr</span>, <span class="c">/* [IN] 読み出すバイト数 */</span> + UINT* <span class="arg">br</span> <span class="c">/* [OUT] 読み出されたバイト数 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +<dt>buff</dt> +<dd>読み出したデータを格納するバッファを指すポインタを指定します。</dd> +<dt>btr</dt> +<dd>読み出すバイト数(0～<tt>UINT</tt>型の最大値)を指定します。</dd> +<dt>br</dt> +<dd>実際に読み出されたバイト数を格納する変数を指すポインタを指定します。戻り値は関数の成否にかかわらず常に有効です。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>読み込み開始位置は、現在のリード/ライト ポインタからになります。リード/ライト ポインタは読み込まれたバイト数だけ進みます。関数が正常終了した後は、<tt class="arg">*br</tt>の値をチェックすべきです。<tt class="arg">*br</tt>が<tt class="arg">btr</tt>よりも小さいときは、読み込み中にファイルの終端に達したことを示しています。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>全ての構成で使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="gets.html">fgets</a>, <a href="write.html">f_write</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/readdir.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/readdir.html new file mode 100644 index 0000000..c80ce39 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/readdir.html @@ -0,0 +1,129 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/readdir.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_readdir</title> +</head> + +<body> + +<div class="para func"> +<h2>f_readdir</h2> +<p>ディレクトリ項目を読み出します。</p> +<pre> +FRESULT f_readdir ( + DIR* <span class="arg">dp</span>, <span class="c">/* [IN] ディレクトリ ブジェクト構造体へのポインタ */</span> + FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>dp</dt> +<dd><tt>f_opendir</tt>関数で作成された有効なディレクトリ オブジェクトへのポインタを指定します。</dd> +<dt>fno</dt> +<dd>読み出したディレクトリ項目を格納する<a href="sfileinfo.html">ファイル情報構造体</a>へのポインタ、またはヌル ポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ディレクトリの項目(ファイルおよびサブ ディレクトリ)の情報を順次読み出します。この関数を繰り返し実行することによりそのディレクトリの全ての項目を読み出すことができます。得られるファイル情報の詳細については <tt>FILINFO</tt>構造体を参照してください。全ての項目が読み出され、読み出す項目がもう無いときは、<tt>fno->fname[]</tt>にヌル文字列が返されます。<tt class="arg">fno</tt>にヌル ポインタを指定すると、そのディレクトリのリード インデックスを先頭に巻き戻します。サブ ディレクトリのドット エントリ(<tt>"."</tt>と<tt>".."</tt>)は、出力に現れません。</p> +<p>LFN構成では、<tt>altname[]</tt>が新たに定義され、そのオブジェクトの短いファイル名がストアされます。次の条件のときは長いファイル名を返せないので<tt>fname[]</tt>に短いファイル名がストアされ、<tt>altname[]</tt>はヌル文字列になります。</p> +<ul> +<li>オブジェクトが長いファイル名を持っていない。(exFATボリュームでは該当せず)</li> +<li><tt>_MAX_LFN</tt>の設定がその長いファイル名の長さに対して不十分 (<tt>_MAX_LFN == 255</tt>では該当せず)</li> +<li>長いファイル名にANSI/OEMコードに無い文字が含まれている。(<tt>_LFN_UNICODE == 1</tt>では該当せず)</li> +</ul> +<p>exFATボリュームのディレクトリを読み出すとき、構成によっては問題が発生します。exFATでは短いファイル名がサポートされません。つまり、上記の条件のとき代わりに返すファイル名が無いということです。このような場合は<tt>fname[]</tt>に"?"が返され、そのオブジェクトにアクセスできないことを示します。この問題を避けるには、FatFsの構成を<tt>_LFN_UNICODE = 1</tt>および<tt>_MAX_LFN = 255</tt>として長いファイル名に完全対応とする必要があります。</p> +</div> + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_MINIMIZE <= 1</tt>のときに使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> +FATFS fs; +char buff[256]; + +FRESULT scan_files ( + char* path <span class="c">/* 開始ノード (ワークエリアとしても使用) */</span> +) +{ + FRESULT res; + DIR dir; + UINT i; + static FILINFO fno; + + + res = f_opendir(&dir, path); <span class="c">/* ディレクトリを開く */</span> + if (res == FR_OK) { + for (;;) { + res = f_readdir(&dir, &fno); <span class="c">/* ディレクトリ項目を1個読み出す */</span> + if (res != FR_OK || fno.fname[0] == 0) break; <span class="c">/* エラーまたは項目無しのときは抜ける */</span> + if (fno.fattrib & AM_DIR) { <span class="c">/* ディレクトリ */</span> + i = strlen(path); + sprintf(&path[i], "/%s", fno.fname); + res = scan_files(path); <span class="c">/* 一つ下へ */</span> + if (res != FR_OK) break; + path[i] = 0; + } else { <span class="c">/* ファイル */</span> + printf("%s/%s\n", path, fno.fname); + } + } + f_closedir(&dir) + } + + return res; +} + + +int main (void) +{ + FRESULT res; + + + res = f_mount(&fs, "", 1); + if (res == FR_OK) { + strcpy(buff, "/"); + res = scan_files(buff); + } + + return res; +} +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="opendir.html">f_opendir</a>, <a href="closedir.html">f_closedir</a>, <a href="stat.html">f_stat</a>, <a href="sfileinfo.html">FILINFO</a>, <a href="sdir.html">DIR</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/rename.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/rename.html new file mode 100644 index 0000000..fe1aa90 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/rename.html @@ -0,0 +1,85 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/rename.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_rename</title> +</head> + +<body> + +<div class="para func"> +<h2>f_rename</h2> +<p>ファイルまたはサブ ディレクトリの名前の変更または移動します。</p> +<pre> +FRESULT f_rename ( + const TCHAR* <span class="arg">old_name</span>, <span class="c">/* [IN] 古いオブジェクト名 */</span> + const TCHAR* <span class="arg">new_name</span> <span class="c">/* [IN] 新しいオブジェクト名 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>old_name</dt> +<dd>変更対象のファイルまたはサブ ディレクトリの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +<dt>new_name</dt> +<dd>新しいパス名を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。また、ドライブ番号は指定しても無視され、<tt class="arg">old_name</tt>で決められたボリューム上のオブジェクトとして扱われます。これと同じパス名(<tt class="arg">old_name</tt>は除く)のオブジェクトが存在すると、関数は<tt>FR_EXIST</tt>で失敗します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#ex">FR_EXIST</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#lo">FR_LOCKED</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ファイルまたはサブ ディレクトリの名前を変更します。また、同時に別のディレクトリへの移動も可能ですが、異なるドライブ間の移動はできません。開かれているオブジェクトに対する使用は不正な操作となり、<em>FAT構造が破壊される可能性</em>があります。<a href="appnote.html#dup">多重アクセス制御</a>が有効のときは安全に拒否されます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + <span class="c">/* デフォルト ドライブにあるオブジェクトの名前を変更 */</span> + f_rename("oldname.txt", "newname.txt"); + + <span class="c">/* ドライブ2にあるオブジェクトの名前を変更 */</span> + f_rename("2:oldname.txt", "newname.txt"); + + <span class="c">/* 名前の変更と同時に別のディレクトリに移動 */</span> + f_rename("log.txt", "old/log0001.txt"); +</pre> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sdir.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sdir.html new file mode 100644 index 0000000..a189819 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sdir.html @@ -0,0 +1,38 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/sdir.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - DIR</title> +</head> + +<body> + +<div class="para"> +<h2>DIR</h2> +<p><tt>DIR</tt>構造体は、<tt>f_opendir/f_readdir/f_findfirst/f_findnext</tt>関数のワーク エリアとして使用されます。アプリケーションは、この構造体のメンバを書き換えてはなりません。</p> +<pre> +<span class="k">typedef</span> <span class="k">struct</span> { + _FDID obj; <span class="c">/* オブジェクトID */</span> + DOWRD dptr; <span class="c">/* 現在のread/writeオフセット */</span> + DWORD clust; <span class="c">/* 現在のクラスタ番号 */</span> + DWORD sect; <span class="c">/* 現在のセクタ番号 */</span> + BYTE* dir; <span class="c">/* 現在のSFNエントリ(Win[]内)へのポインタ */</span> + BYTE* fn; <span class="c">/* SFNバッファへのポインタ (in/out) {file[8],ext[3],status[1]} */</span> +<span class="k">#if</span> _USE_LFN + DWORD blk_ofs; <span class="c">/* 現在のエントリブロックの先頭 (0xFFFFFFFF:無効) */</span> + WCHAR* lfn; <span class="c">/* LFNバッファへのポインタ (in/out) */</span> +<span class="k">#endif</span> +<span class="k">#if</span> _USE_FIND + const TCHAR* pat; <span class="c">/* マッチング パターンへのポインタ */</span> +<span class="k">#endif</span> +} DIR; +</pre> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html new file mode 100644 index 0000000..c121719 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/setlabel.html @@ -0,0 +1,91 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/setlabel.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_setlabel</title> +</head> + +<body> + +<div class="para func"> +<h2>f_setlabel</h2> +<p>ボリュームにボリューム ラベルを設定します。</p> +<pre> +FRESULT f_setlabel ( + const TCHAR* <span class="arg">label</span> <span class="c">/* [IN] 設定するボリューム ラベルへのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>label</dt> +<dd>設定するボリューム ラベルを示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>文字列の先頭にドライブ番号を含む場合は、その論理ドライブに対して設定されます。含まない場合は、デフォルト ドライブに設定されます。ボリューム ラベルを削除するときは、ヌル文字列を指定します。FATボリューム上では、ボリューム ラベルのフォーマットは、ファイル名とほぼ同じですが、次の点が異なります。</p> +<ul> +<li>任意の位置にスペースを置くことができる。ただし、FATボリュームではトレーリング スペースは除去される。</li> +<li>ピリオドを含むことはできない。</li> +<li>FATボリュームでは、OEMコード換算で11バイト以下。</li> +<li>exFATボリュームでは、11文字以下で、大文字小文字は保持される。</li> +</ul> +<p>【補足】 標準システム(Windows)では<tt>\xE5</tt>で始まるボーリューム ラベル(CP932なら「薔薇」など)の扱いに問題があります。このため、この関数ではそのような名前は無効として処理しています。</p> +</div> + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_USE_LABEL == 1</tt>のときに使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + <span class="c">/* デフォルト ドライブにボリューム ラベルを設定 */</span> + f_setlabel("DATA DISK"); + + <span class="c">/* ドライブ2にボリューム ラベルを設定 */</span> + f_setlabel("2:DISK 3 OF 4"); + + <span class="c">/* ドライブ2のボリューム ラベルを削除 */</span> + f_setlabel("2:"); +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<tt><a href="getlabel.html">f_getlabel</a></tt> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfatfs.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfatfs.html new file mode 100644 index 0000000..fd356db --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfatfs.html @@ -0,0 +1,63 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/sfatfs.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - FATFS</title> +</head> + +<body> + +<div class="para"> +<h2>FATFS</h2> +<p><tt>FATFS</tt>構造体(ファイル システム オブジェクト)は、個々の論理ドライブのダイナミック ワーク エリアを保持し、<tt>f_mount</tt>関数でFatFsモジュールに登録されます。初期化が行われるタイミングは、<tt>f_mount</tt>関数(強制マウント指定)の実行またはメディア交換の後の最初のファイル アクセスの時です。アプリケーションは、この構造体のメンバを書き換えてはなりません。</p> + +<pre> +<span class="k">typedef</span> <span class="k">struct</span> { + BYTE fs_type; <span class="c">/* ファイル システム (0, FS_FAT12, FS_FAT16, FS_FAT32 or FS_EXFAT) */</span> + BYTE drv; <span class="c">/* 物理ドライブ番号 */</span> + BYTE n_fats; <span class="c">/* FATの多重化数 (1,2) */</span> + BYTE wflag; <span class="c">/* win[]ダーティ フラグ */</span> + BYTE fsi_flag; <span class="c">/* FSINFOフラグ (b7:Disabled, b0:Dirty) */</span> + WORD id; <span class="c">/* ファイル システム マウントID */</span> + WORD n_rootdir; <span class="c">/* ルート ディレクトリのエントリ数 (FAT12/16) */</span> + WORD csize; <span class="c">/* クラスタ当たりのセクタ数 */</span> +<span class="k">#if</span> _MAX_SS != _MIN_SS + WORD ssize; <span class="c">/* セクタ サイズ (512, 1024, 2048 or 4096) */</span> +<span class="k">#endif</span> +<span class="k">#if</span> _FS_EXFAT + BYTE* dirbuf; <span class="c">/* ディレクトリ エントリ ブロック操作バッファへのポインタ */</span> +<span class="k">#endif</span> +<span class="k">#if</span> _FS_REENTRANT + _SYNC_t sobj; <span class="c">/* 同期オブジェクトID */</span> +<span class="k">#endif</span> +<span class="k">#if</span> !_FS_READONLY + DWORD last_clust; <span class="c">/* FSINFO: 最後に割り当てられたクラスタ番号 */</span> + DWORD free_clust; <span class="c">/* FSINFO: 空きクラスタ数 */</span> +<span class="k">#endif</span> +<span class="k">#if</span> _FS_RPATH + DWORD cdir; <span class="c">/* カレント ディレクトリのクラスタ番号 (0:ルート) */</span> +<span class="k">#if</span> _FS_EXFAT + DWORD cdc_scl; <span class="c">/* カレント ディレクトリを含むディレクトリの開始クラスタ番号 (cdir == 0では無効) */</span> + DWORD cdc_size; <span class="c">/* b31-b8:カレント ディレクトリを含むディレクトリのサイズ, b7-b0: チェーン ステータス */</span> + DWORD cdc_ofs; <span class="c">/* カレント ディレクトリを含むディレクトリ内の位置 (cdir == 0では無効) */</span> +<span class="k">#endif</span> +<span class="k">#endif</span> + DWORD n_fatent; <span class="c">/* FATエントリ数 (総クラスタ数 + 2) */</span> + DWORD fsize; <span class="c">/* FAT 1個のセクタ数 */</span> + DWORD volbase; <span class="c">/* ボリューム開始セクタ */</span> + DWORD fatbase; <span class="c">/* FAT領域開始セクタ */</span> + DWORD dirbase; <span class="c">/* ルート ディレクトリ領域開始(セクタ|クラスタ) */</span> + DWORD database; <span class="c">/* データ領域開始セクタ */</span> + DWORD winsect; <span class="c">/* win[]に現れているセクタ番号 */</span> + BYTE win[_MAX_SS]; <span class="c">/* ディスク アクセス ウィンドウ */</span> +} FATFS; +</pre> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfile.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfile.html new file mode 100644 index 0000000..9521f70 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfile.html @@ -0,0 +1,45 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/sfile.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - FIL</title> +</head> + +<body> + +<div class="para"> +<h2>FIL</h2> +<p><tt>FIL</tt>構造体(ファイル オブジェクト)は、<tt>f_open</tt>関数で初期化され、以後そのファイルの状態を保持します。また、<tt>f_close</tt>関数でファイルが閉じられると無効化されます。アプリケーションは、この構造体のメンバを書き換えてはなりません(<tt>cltbl</tt>は例外)。非タイニー構成(<tt>_FS_TINY == 0</tt>)では、内部に<tt>_MAX_SS</tt>バイトのセクタ バッファが確保されるので、そのサイズには注意が必要です。</p> + +<pre> +<span class="k">typedef</span> <span class="k">struct</span> { + _FDID obj; <span class="c">/* オブジェクトID */</span> + BYTE flag; <span class="c">/* ファイル ステータス フラグ */</span> + BYTE err; <span class="c">/* エラー中断フラグ */</span> + FSIZE_t fptr; <span class="c">/* ファイル読み書きポインタ (ファイル先頭からのバイト オフセット) */</span> + DWORD clust; <span class="c">/* 現在のクラスタ (fptrがクラスタ境界上のときは前のクラスタ、fptrが0のときは無効) */</span> + DWORD dsect; <span class="c">/* 現在のデータ セクタ */</span> +<span class="k">#if</span> !_FS_READONLY + DWORD dir_sect; <span class="c">/* このファイルのディレクトリ エントリのあるセクタ */</span> + BYTE* dir_ptr; <span class="c">/* このファイルのディレクトリへのポインタ */</span> +<span class="k">#endif</span> +<span class="k">#if</span> _USE_FASTSEEK + DWORD* cltbl; <span class="c">/* ファイルのクラスタ リンク情報へのポインタ (オープン時にNULLがセットされる) */</span> +<span class="k">#endif</span> +<span class="k">#if</span> _FS_LOCK + UINT lockid; <span class="c">/* ファイル ロックID */</span> +<span class="k">#endif</span> +<span class="k">#if</span> !_FS_TINY + BYTE buf[_MAX_SS]; <span class="c">/* ファイル プライベート データ転送バッファ (fptrがセクタ境界上にない時は常に有効だが、fptrがセクタ境界上のときは無効な場合がある) */</span> +<span class="k">#endif</span> +} FIL; +</pre> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfileinfo.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfileinfo.html new file mode 100644 index 0000000..505f4b0 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sfileinfo.html @@ -0,0 +1,69 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/sfileinfo.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - FILINFO</title> +</head> + +<body> + +<div class="para"> +<h2>FILINFO</h2> +<p><tt>FILINFO</tt>構造体は、<tt>f_stat/f_readdir/f_findfirst/f_findnext</tt>関数で返されるオブジェクトに関する情報を保持します。</p> +<pre> +<span class="k">typedef</span> <span class="k">struct</span> { + FSIZE_t fsize; <span class="c">/* ファイル サイズ */</span> + WORD fdate; <span class="c">/* 最後に更新された日付 */</span> + WORD ftime; <span class="c">/* 最後に更新された時刻 */</span> + BYTE fattrib; <span class="c">/* アトリビュート */</span> +<span class="k">#if</span> _USE_LFN != 0 + TCHAR altname[13]; <span class="c">/* 代替ファイル名 */</span> + TCHAR fname[_MAX_LFN + 1]; <span class="c">/* 主ファイル名 */</span> +<span class="k">#else</span> + TCHAR fname[13]; <span class="c">/* ファイル名 */</span> +<span class="k">#endif</span> +} FILINFO; +</pre> +</div> + +<h4>メンバ</h4> +<dl> +<dt>fsize</dt> +<dd>ファイルのバイト単位のサイズが格納されます。ディレクトリの場合は常に0です。データ型<tt>FSIZE_t</tt>は、<tt>DWORD</tt>(32-bit)または<tt>QWORD</tt>(64-bit)のエリアスで、exFATサポートの有無により切り替わります。</dd> +<dt>fdate</dt> +<dd>ファイルの変更された日付、またはディレクトリの作成された日付が格納されます。<br> +<dl> +<dt>bit15:9</dt> +<dd>1980年を起点とした年が 0..127 で入ります。</dd> +<dt>bit8:5</dt> +<dd>月が 1..12 の値で入ります。</dd> +<dt>bit4:0</dt> +<dd>日が 1..31 の値で入ります。</dd> +</dl> +</dd> +<dt>ftime</dt> +<dd>ファイルの変更された時刻、またはディレクトリの作成された時刻が格納されます。<br> +<dl> +<dt>bit15:11</dt> +<dd>時が 0..23 の値で入ります。</dd> +<dt>bit10:5</dt> +<dd>分が 0..59 の値で入ります。</dd> +<dt>bit4:0</dt> +<dd>秒/2が 0..29 の値で入ります。</dd> +</dl> +</dd> +<dt>fattrib</dt> +<dd>属性フラグが格納されます。フラグは<tt>AM_DIR, AM_RDO, AM_HID, AM_SYS, AM_ARC</tt>の組み合わせとなります。</dd> +<dt>fname[]</dt> +<dd>オブジェクト名が<tt>'\0'</tt>で終わる文字列として格納されます。読み出すべき項目が無いときは、ヌル文字列が返され、この構造体が無効であることを示します。</dd> +<dt>altname[]</dt> +<dd>代替ファイル名があるときは、それが<tt>'\0'</tt>で終わる文字列として格納されます。非LFN構成のときは、このメンバはありません。</dd> +</dl> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/size.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/size.html new file mode 100644 index 0000000..d5ede8d --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/size.html @@ -0,0 +1,62 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/size.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_size</title> +</head> + +<body> + +<div class="para func"> +<h2>f_size</h2> +<p>ファイルのサイズを取得します。</p> +<pre> +FSIZE_t f_size ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>バイト単位のファイル サイズが返ります。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>この関数は、現リビジョンではマクロとして実装されています。ファイル オブジェクトの正当性チェックや排他制御は行いません。</p> +<pre> +<span class="k">#define</span> f_size(fp) ((fp)->obj.objsize) +</pre> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>常に使用可能。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/stat.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/stat.html new file mode 100644 index 0000000..a6d5567 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/stat.html @@ -0,0 +1,110 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/stat.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_stat</title> +</head> + +<body> + +<div class="para func"> +<h2>f_stat</h2> +<p>ファイルまたはサブ ディレクトリの存在を調べ、またその情報を取得します。</p> +<pre> +FRESULT f_stat ( + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] オブジェクト名へのポインタ */</span> + FILINFO* <span class="arg">fno</span> <span class="c">/* [OUT] ファイル情報構造体へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>チェックするオブジェクト名を示すヌル文字<tt>'\0'</tt>終端の文字列を指すポインタを指定します。</dd> +<dt>fno</dt> +<dd>オブジェクトが存在したときにその情報を格納するファイル情報構造体へのポインタを指定します。この情報が不要なときはヌル ポインタを指定してください。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>指定されたファイルまたはサブ ディレクトリの存在を調べます。存在しない場合は、<tt>FR_NO_FILE</tt>が帰ります。存在する場合は<tt>FR_OK</tt>が帰り、それ関する情報(サイズ、タイムスタンプおよび属性)がファイル情報構造体にストアされます。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> + FRESULT fr; + FILINFO fno; + + + printf("Test for 'file.txt'...\n"); + + fr = f_stat("file.txt", &fno); + switch (fr) { + + case FR_OK: + printf("Size: %lu\n", fno.fsize); + printf("Timestamp: %u/%02u/%02u, %02u:%02u\n", + (fno.fdate >> 9) + 1980, fno.fdate >> 5 & 15, fno.fdate & 31, + fno.ftime >> 11, fno.ftime >> 5 & 63); + printf("Attributes: %c%c%c%c%c\n", + (fno.fattrib & AM_DIR) ? 'D' : '-', + (fno.fattrib & AM_RDO) ? 'R' : '-', + (fno.fattrib & AM_HID) ? 'H' : '-', + (fno.fattrib & AM_SYS) ? 'S' : '-', + (fno.fattrib & AM_ARC) ? 'A' : '-'); + break; + + case FR_NO_FILE: + printf("It is not exist.\n"); + break; + + default: + printf("An error occured. (%d)\n", fr); + } +</pre> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="opendir.html">f_opendir</a>, <a href="readdir.html">f_readdir</a>, <a href="sfileinfo.html">FILINFO</a>, <a href="sdir.html">DIR</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sync.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sync.html new file mode 100644 index 0000000..fb6f336 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/sync.html @@ -0,0 +1,65 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/sync.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_sync</title> +</head> + +<body> + +<div class="para func"> +<h2>f_sync</h2> +<p>書き込み中のファイルのキャッシュされた情報をフラッシュします。</p> +<pre> +FRESULT f_sync ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト構造体へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>syncするファイルのファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>この関数は<tt>f_close</tt>関数と同じ処理を実行しますが、ファイルは引き続き開かれたままになり、読み書きを続行できます。ロギングなど、書き込みモードで長時間ファイルが開かれているアプリケーションにおいて、定期的または区切りの良いところでこの関数を使用することにより、不意の電源断やメディアの取り外しにより失われるデータを最小にすることができます。この背景については、<a href="appnote.html#critical">アプリケーション ノート</a>も参照してください。</p> +<p>実際のところ、<tt>f_close</tt>関数内ではこの関数を呼び出した後ファイル オブジェクトを無効化しているだけなので、<tt>f_close</tt>関数の直前に<tt>f_sync</tt>関数を置くことは無意味です。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>のときに使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="close.html">f_close</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/tell.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/tell.html new file mode 100644 index 0000000..39973e8 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/tell.html @@ -0,0 +1,62 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_e.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/tell.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_tell</title> +</head> + +<body> + +<div class="para func"> +<h2>f_tell</h2> +<p>現在のリード/ライト ポインタを取得します。</p> +<pre> +FSIZE_t f_tell ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクト */</span> +); +</pre> +</div> + + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p>現在のリード/ライト ポインタ(ファイル先頭からのバイト単位のオフセット)が返ります。</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>f_tell関数は、現リビジョンではマクロとして実装されています。ファイル オブジェクトの正当性チェックや排他制御は行いません。</p> +<pre> +<span class="k">#define</span> f_tell(fp) ((fp)->fptr) +</pre> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p>常に使用可能。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/truncate.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/truncate.html new file mode 100644 index 0000000..6302ee5 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/truncate.html @@ -0,0 +1,66 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/truncate.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_truncate</title> +</head> + +<body> + +<div class="para func"> +<h2>f_truncate</h2> +<p>ファイル長を切り詰めます。</p> +<pre> +FRESULT f_truncate ( + FIL* <span class="arg">fp</span> <span class="c">/* [IN] ファイル オブジェクトへのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>切り詰め対象ファイルのファイル オブジェクトへのポインタ</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>ファイルの長さが現在のリード/ライト ポインタに切り詰められます。リード/ライト ポインタが既にファイルの終端を指しているときは、この関数は何の効果も持ちません。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="lseek.html">f_lseek</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + + +<p class="foot"><a href="../00index_j.html">Return</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/unlink.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/unlink.html new file mode 100644 index 0000000..f75f3fc --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/unlink.html @@ -0,0 +1,73 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/unlink.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_unlink</title> +</head> + +<body> + +<div class="para func"> +<h2>f_unlink</h2> +<p>ファイルまたはサブ ディレクトリを削除します。</p> +<pre> +FRESULT f_unlink ( + const TCHAR* <span class="arg">path</span> <span class="c">/* [IN] オブジェクト名へのポインタ */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>削除対象の<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列へのポインタを指定します。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#lo">FR_LOCKED</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>削除対象のオブジェクトが次の条件に当てはまる場合、そのアクセスは拒否(<tt>FR_DENIED</tt>)され関数は失敗します。</p> +<ul> +<li>リード オンリー属性(<tt>AM_RDO</tt>)を持っている場合。</li> +<li>空でないサブ ディレクトリまたはカレント ディレクトリである場合。</li> +<li>開かれているオブジェクトである場合。<a href="appnote.html#dup">多重アクセス制御</a>が有効のときは安全に拒否されるが、そうでないときは不正な操作となり<em>FAT構造が破壊される可能性</em>がある。</li> +</ul> +</div> + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p> +</div> + + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/utime.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/utime.html new file mode 100644 index 0000000..8d16778 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/utime.html @@ -0,0 +1,99 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/utime.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_utime</title> +</head> + +<body> + +<div class="para func"> +<h2>f_utime</h2> +<p>ファイルまたはサブ ディレクトリのタイムスタンプを変更します。</p> +<pre> +FRESULT f_utime ( + const TCHAR* <span class="arg">path</span>, <span class="c">/* [IN] オブジェクト名へのポインタ */</span> + const FILINFO* <span class="arg">fno</span> <span class="c">/* [IN] 設定する日付 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>path</dt> +<dd>変更対象のオブジェクトの<a href="filename.html">パス名</a>を示すヌル文字<tt>'\0'</tt>終端の文字列を指定します。</dd> +<dt>fno</dt> +<dd>設定する日付と時間を<tt>fdate</tt>と<tt>ftime</tt>メンバに設定された<tt>FILINFO</tt>構造体へのポインタ。他のメンバはこの関数では意味を持ちません。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#nr">FR_NOT_READY</a>, +<a href="rc.html#ok">FR_NO_FILE</a>, +<a href="rc.html#np">FR_NO_PATH</a>, +<a href="rc.html#in">FR_INVALID_NAME</a>, +<a href="rc.html#wp">FR_WRITE_PROTECTED</a>, +<a href="rc.html#id">FR_INVALID_DRIVE</a>, +<a href="rc.html#ne">FR_NOT_ENABLED</a>, +<a href="rc.html#ns">FR_NO_FILESYSTEM</a>, +<a href="rc.html#tm">FR_TIMEOUT</a>, +<a href="rc.html#nc">FR_NOT_ENOUGH_CORE</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>オブジェクトのタイムスタンプを変更します。</p> +</div> + + +<div class="para use"> +<h4>使用例</h4> +<pre> +FRESULT set_timestamp ( + char *obj, <span class="c">/* ファイル名へのポインタ */</span> + int year, + int month, + int mday, + int hour, + int min, + int sec +) +{ + FILINFO fno; + + fno.fdate = (WORD)(((year - 1980) * 512U) | month * 32U | mday); + fno.ftime = (WORD)(hour * 2048U | min * 32U | sec / 2U); + + return f_utime(obj, &fno); +} +</pre> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>で、且つ<tt>_FS_MINIMIZE == 0</tt>のときに使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="stat.html">f_stat</a>, <a href="sfileinfo.html">FILINFO</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> diff --git a/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/write.html b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/write.html new file mode 100644 index 0000000..7783e95 --- /dev/null +++ b/thirdparty/nRF5_SDK_15.0.0_a53641a/external/fatfs/doc/ja/write.html @@ -0,0 +1,74 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> +<html lang="ja"> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<meta http-equiv="Content-Style-Type" content="text/css"> +<link rel="up" title="FatFs" href="../00index_j.html"> +<link rel="alternate" hreflang="en" title="English" href="../en/write.html"> +<link rel="stylesheet" href="../css_j.css" type="text/css" media="screen" title="ELM Default"> +<title>FatFs - f_write</title> +</head> + +<body> + +<div class="para func"> +<h2>f_write</h2> +<p>ファイルにデータを書き込みます。</p> +<pre> +FRESULT f_write ( + FIL* <span class="arg">fp</span>, <span class="c">/* [IN] ファイル オブジェクト */</span> + const void* <span class="arg">buff</span>, <span class="c">/* [IN] 書き込みデータ */</span> + UINT <span class="arg">btw</span>, <span class="c">/* [IN] 書き込むバイト数 */</span> + UINT* <span class="arg">bw</span> <span class="c">/* [OUT] 書き込まれたバイト数 */</span> +); +</pre> +</div> + +<div class="para arg"> +<h4>引数</h4> +<dl class="par"> +<dt>fp</dt> +<dd>ファイル オブジェクト構造体へのポインタを指定します。</dd> +<dt>buff</dt> +<dd>書き込むデータを格納したバッファを指すポインタを指定します。</dd> +<dt>btw</dt> +<dd>書き込むバイト数(0～<tt>UINT</tt>型の最大値)を指定します。</dd> +<dt>bw</dt> +<dd>書き込まれたバイト数を格納する変数を指すポインタを指定します。戻り値は関数の成否にかかわらず常に有効です。</dd> +</dl> +</div> + + +<div class="para ret"> +<h4>戻り値</h4> +<p> +<a href="rc.html#ok">FR_OK</a>, +<a href="rc.html#de">FR_DISK_ERR</a>, +<a href="rc.html#ie">FR_INT_ERR</a>, +<a href="rc.html#de">FR_DENIED</a>, +<a href="rc.html#io">FR_INVALID_OBJECT</a>, +<a href="rc.html#tm">FR_TIMEOUT</a> +</p> +</div> + + +<div class="para desc"> +<h4>解説</h4> +<p>書き込み開始位置は、リード/ライト ポインタの位置からになります。リード/ライト ポインタは実際に書き込まれたバイト数だけ進みます。関数が正常終了した後、要求したバイト数が書き込まれたかどうか<tt class="arg">*bw</tt>をチェックすべきです。<tt class="arg">*bw</tt>が<tt class="arg">btw</tt>より小さいときは、ディスク フルを意味します。ディスク フルが発生しているときまたはそれに近いときは、制御が帰るまで時間がかかる場合があります。</p> +</div> + + +<div class="para comp"> +<h4>対応情報</h4> +<p><tt>_FS_READONLY == 0</tt>のときに使用可能です。</p> +</div> + + +<div class="para ref"> +<h4>参照</h4> +<p><tt><a href="open.html">f_open</a>, <a href="read.html">f_read</a>, <a href="putc.html">fputc</a>, <a href="puts.html">fputs</a>, <a href="printf.html">fprintf</a>, <a href="close.html">f_close</a>, <a href="sfile.html">FIL</a></tt></p> +</div> + +<p class="foot"><a href="../00index_j.html">戻る</a></p> +</body> +</html> |