Библиотека SD позволяет считывать и записывать информацию на карту памяти SD (например, на плате расширения Arduino Ethernet). Она основана на библиотеке sdfatlib (ныне SdFat автор William Greiman). Библиотека поддерживает работу со стандартными картами памяти типа SD и SDHC, отформатированными в файловой системе FAT16 или FAT32. При работе с картой памяти необходимо использовать короткие имена файлов в формате 8.3 (8 символов - имя файла, 3 символа - расширение). Функции библиотеки SD в качестве параметра могут принимать не только имя файла, но и путь к нему. При этом в качестве разделителя между каталогами используется прямой слеш (например, "directory/filename.txt"). Добавление косой черты перед именем файла необязательно, поскольку рабочей директорией всегда является корневой каталог карты памяти (таким образом, имя "/file.txt" эквивалентно "file.txt"). Начиная с версии 1.0, в библиотеке реализована возможность одновременного открытия нескольких файлов.

Взаимодействие между микроконтроллером и SD-картой памяти осуществляется по шине SPI, объединяющей в себе контакты 11, 12 и 13 (на большинстве плат Ардуино), либо 50, 51 и 52 (на Arduino Mega). Помимо перечисленных, еще один контакт должен использоваться для активизации SD-карты. Для этого может использоваться как аппаратный контакт SS - вывод 10 (на большинстве плат Ардуино) или контакт 53 (на Arduino Mega), так и любой другой контакт, указанный при вызове метода SD.begin(). Обратите внимание, что для корректной работы библиотеки SD, контакт SS должен быть сконфигурирован как выход, даже в тех случаях, когда он не используется.

Замечания по использованию библиотеки с различными платами расширения.

Класс SD

Класс SD содержит функции для доступа к SD-карте памяти и позволяет совершать различные операции над файлами и каталогами.

begin()

exists()

mkdir()

open()

remove()

rmdir()

Класс File

Этот класс предназначен для чтения и записи данных в отдельные файлы на SD-карте памяти.

available()

close()

flush()

name()

peek()

position()

print()

println()

seek()

size()

read()

write()

isDirectory()

openNextFile()

rewindDirectory()

Примеры

Datalogger: Запись данных с трех аналоговых датчиков на SD-карту памяти с помощью библиотеки SD

DumpFile: Считывание файла с SD-карты памяти и отправка его содержимого через последовательный порт

Files: Создание и удаление файла с SD-карты памяти

ReadWrite: Чтение и запись данных в файл на SD-карте

CardInfo: Получение информации об SD-карте памяти

Справочник

Материалы взяты с официального сайта проекта Arduino и представлены по лицензии Creative Commons Attribution-ShareAlike 3.0 License.