Arduino.ru

arduino.cc/playground/Main/InterfacingWithHardware#Storage и немного вниз прокрутить.

SD.Begin(CS) – инициализация SD карты, где CS – номер порта для CS.
SD.Exists(filename) – Проверяет  существует  файл или каталог на SD-карте.
Параметры:
filename: имя файла для проверки существования, которое может включать в себя каталоги (разделенные вперед-косой черты /)
Возвращение:
значение true, если файл или каталог существует, значение false, если нет.
SD.mkdir(filename) - Создаёт каталог на SD-карте. Также создаст любые промежуточные каталоги, которые ещё не существует; например создаст SD.mkdir("a/b/c"), b и c.
filename: имя каталога для создания с sub-directories, разделенных вперед-косой черты /
значение true, если создание каталога удалось, false если нет.
SD.open(filepath)
SD.open(filepath, mode) - Открывает файл на SD-карте. Если файл открыт для записи, он будет создан, если он еще не существует (но уже должен существовать каталог, содержащий его).
mode (опционально):  режим, в котором для открытия файла, по умолчанию используется FILE_READ - байт. один из:
FILE_READ: Откройте файл для чтения, начиная с начала файла.
FILE_WRITE: Откройте файл для чтения и записи, начиная с конца файла.
объект файла, ссылается на открытый файл; Если этот файл не может быть открыт, этот объект будет оценивать значение false, то есть можно проверить возвращаемое значение с "if (f)".
SD.Remove(filename) – Удаление файла из SD-карты.
значение true, если удаление файла успешно, ложь если нет (если файл не существует, возвращаемое значение не определено).
SD.rmdir(filename) – Удаляет каталог из SD-карты. Каталог должен быть пустым.
filename: имя каталога для удаления с sub-directories, разделенных через черту /
значение true, если удаление директории успешно, ложь если нет. (если папка не существует, возвращаемое значение не определено)

file.available() – Проверка наличия каких-либо байт доступных для чтения из файла.
Возвращение: количество доступных байтов (int).
file.close() – Закрывает файл и проверяет, что любые данные, записанные на него физически, сохранятся в SD-карте.
file.flush() – Гарантирует, что любые байты, записанные в файл, физически сохранятся на SD-карте. Это делается автоматически при закрытии файла.
file.peek() –читает байт из файла без продвижения вперед к следующему. То есть успешные вызовы peek() возвращает то же значение, как и следующий вызов read().
Возвращение: следующий байт (или символ), или -1, если никто не доступен.
file.position() – Получить текущую позицию в файле (то есть местоположение из которого будет считывается или записывается следующий байт).
file.print(data)
file.print(data, BASE) – Печать данных в файл, который должен быть открыт для записи. Печатает номера как последовательность цифр, каждый символ ASCII (например: номер 123 отправляется как три символы '1', '2', ' 3').
data: данные для печати (char, byte, int, long, or string).
BASE (optional): база в котором печатать номера: BIN for binary (base 2), DEC for decimal (base 10), OCT for octal (base 8), HEX for hexadecimal (base 16).
Возвращение: байт (возвращает количество записанных байтов).
file.seek(pos) – Обратиться в новую позицию в файле, которая должна быть между 0 и размер файла (включительно).
Возвращение: значение true при успехе, false при отказе.
file.size() – Получить размер файла.
file.read() – читает байт из файла.
Возвращение: Следующий байт (или символ), или -1, если никто не доступен.
file.write(data)
file.write(buf, len) – Запись данных в файл.
data: the byte, char, или string (char *) для записи
buf: массив символов или байтов
len: количество элементов в buf
Возвращает количество записанных байт.
file.isDirectory() – эта функция сообщает является ли текущий файл каталогом или нет.
file.openNextFile() – Сообщает имя следующего файла или папки.
file.rewindDirectory() – вернет вас к первому файлу в каталоге.
 

Какая у библиотеки скорость записи-чтения на SD?

В примерах создают файл в корне карты.

А как создать файл в подкаталоге?

"\подкаталог\имяфайла"

Пробовал. Не создает

надо по разному пропробовать. Может косая черта в другую сторону, не помню

в мануале написано так: "directory/filename.txt"

ок. попробую отпишусь.

PS. есть ссылка на мануал?

https://www.arduino.cc/en/Reference/SD