Проекты с использованием контроллера Arduino

Часть III. Практическое применение Arduino 
Функция begin() 
Функция 
begin() 
инициализирует библиотеку 
SD
, назначая вывод для сигнала SS 
(Slave Select). 
Синтаксис 
SD.begin(); 
SD.begin(pin) 
Параметр:
pin
— вывод для сигнала SS. 
Возвращаемые значения: 
true
— в случае удачного соединения, 
false
— в случае 
неудачи. 
Функция exists() 
Функция 
exists() 
проверяет, существует на карте SD файл или каталог. 
Синтаксис: 
SD.exists(path) 
Параметр:
path
— имя файла или каталога. 
Возвращаемые значения: 
true
— в случае удачного соединения, 
false
— в случае 
неудачи. 
Функция mkdir() 
Функция 
mkdir() 
cоздает папку на карте памяти SD. 
Синтаксис: 
SD.exists(dirpath) 
Параметр:
dirpath
— имя создаваемого каталога (папки). Если параметр задается
в виде пути с несуществующими промежуточными каталогами, то создаются и все 
промежуточные каталоги. 
Возвращаемые значения: 
true
— если папка создана, 
false
— в случае неудачи. 
Функция rmdir() 
Функция 
rmdir() 
удаляет папку с карты памяти SD, папка должна быть пустой. 
Синтаксис: 
SD.exists(dirpath) 
Параметр:
dirpath
— имя удаляемой папки. 
Возвращаемые значения: 
true
— если папка удалена, 
false
— в случае неудачи. 
Функция open() 
Функция 
open() 
открывает файл на карте памяти SD. Если файл не существует и 
открывается для записи, то он будет создан. 

---

Глава 15. Arduino и карта памяти SD 
203 
Синтаксис: 
SD.open(filepath) 
SD.open(filepath, mode) 
Параметры: 
 
filepath
— имя открываемого файла; 
 
mode
— режим открытия файла: 
• 
FILE_READ
— открыть файл для чтения, начиная с начала файла; 
• 
FILE_WRITE
— открыть файл для чтения и записи, начиная с конца файла. 
Возвращаемые значения: 
true
— в случае удачи, 
false
— в случае неудачи. 
Функция remove() 
Функция 
remove() 
удаляет файл с карты памяти SD. 
Синтаксис: 
SD.remove(filepath) 
Параметр:
filepath
— имя удаляемого файла. 
Возвращаемые значения: 
true
— в случае удачи, 
false
— в случае неудачи. 
15.1.2. Класс File 
Класс 
File
предоставляет функции для чтения и записи отдельных файлов на карте 
памяти SD. 
Функции класса 
File
: 
 
available()
;
 
close()
;
 
flush()
;
 
peek()
;
 
position()
;
 
print()
;
 
println()
;
 
seek()
;
 
size()
;
 
read()
;
 
write()
;
 
isDirectory()
;
 
openNextFile()
;
 
rewindDirectory()
.
Функция available() 
Функция 
available()
проверяет, есть ли доступный для чтения байт в открытом 
файле. 
Синтаксис: 
myFile.available() 
Параметр:
File
— экземпляр файла 
File
, возвращаемый 
SD.open()
. 
Возвращаемое значение: число доступных для чтения байтов. 

---

204