SDカードの読み書きを可能とする。
Arduino/GenuinoボードのSPIインターフェイスにSDメモリカードを接続すると、ファイルの作成、読み書きが可能となる。SDカード内のディレクトリ移動も可能である。
互換性
このライブラリは全てのアーキテクチャで利用できるので、全てのArduinoボードで利用できる。
リリース
このライブラリを使うためには、Arduino IDEでライブラリマネージャを開きインストールする。
- 1.2.4(最新)
使用方法
SDライブラリを利用することで、SDカードの読み書きが可能である。SDカードは、例えば、Arduino Ethernet Shieldに搭載されている。SDライブラリはWilliam Greimanによるsdfatlib上に作成されている。このライブラリは、SDカードとSDHCカードのFAT16とFAT32ファイルシステムをサポートしている。8.3形式のファイル名を利用する。SDライブラリの関数に渡すファイル名には、“directory/filename.txt"のように、スラッシュ(/)を含めることができる。作業ディレクトリは常にSDカードのルートディレクトリなので、先頭のスラッシュがあってもなくても同じファイルを参照する。例えば、"/file.txt"と"file.txt"は同じである。バージョン1.0からは複数ファイルの同時オープンに対応している。
マイクロコントローラとSDカードの通信にはSPIを利用する。このため、デジタルピンの11番と12番、13番(ほとんどのArduinoボードの場合)、もしくは50番と51番、52番(Arduino Megaの場合)が利用される。さらに、もう一本のピンをSDカードを選択するために利用する必要がある。これは、ハードウェアSSピンで、10番ピン(ほとんどのArduinoボードの場合)もしくは53番ピン(Arduino Megaの場合)で、SDClass::begin()を呼ぶときに指定するピンである。ハードウェアSSピンを使わないときでも、出力用としてとっておく必要がある。そうしないと、SDライブラリは動作しない。
このライブラリを使うためには、以下を宣言する。
#include <SPI.h>
#include <SD.h>プログラム例
プログラム例のリンク先はすべて英語です。