arduino_básico_Michael_McRoberts

Capítulo 15 ■ Leitura e escrita de dados em um cartão SD
349
Projeto 42 – Operação simples de leitura/escrita em um cartão SD – Análise do código
Você inicia incluindo as duas bibliotecas do pacote da biblioteca sdfatlib que permitirão
ao código funcionar:
#include
#include
Na sequência, você tem de criar as instâncias de Sd2Card, SdVolume e SdFile, e nomeá-las:
Sd2Card card;
SdVolume volume;
SdFile root;
SdFile file;
O objeto Sd2Card oferece acesso a cartões SD e SDHC comuns. O objeto SdVolume oferece
suporte a partições FAT16 e FAT32. O objeto SdFile oferece funções de acesso ao
arquivo, como open(), read(), remove(), write(), close() e sync(). Esse objeto lhe fornece
acesso ao diretório raiz e aos seus subdiretórios.
Em seguida, temos uma diretiva de definição para captura de erros. Você define
error(s), fazendo uma referência à função error_P:
#define error(s) error_P(PSTR(s))
Depois, você cria uma função error_P, cujo propósito é simplesmente imprimir mensagens
de erros transmitidas a ela, assim como códigos de erros relevantes gerados.
O parâmetro para a função é uma referência a uma string de caracteres. A string de
caracteres é precedida por const. Isso é conhecido como um qualificador de variável, e
serve para modificar o comportamento da variável. Nesse caso, ele qualifica a variável
como somente leitura. Ela poderá ser utilizada da mesma forma que qualquer outra
variável, mas seu valor não poderá ser alterado.
void error_P(const char* str) {
Em seguida, temos um comando PGMPrint(), parte da biblioteca sdfatlib, que armazena
em memória flash, e imprime a string dentro de seus parênteses:
PgmPrint("error: ");
Então, temos o comando SerialPrintIn. Uma vez mais, estamos falando de um comando
da biblioteca que imprime uma string da memória flash na porta serial, seguida de
um CR/LF 1 (carriage return, retorno de carro, e line feed, alimentação de linha).
SerialPrintln_P(str);
1 N.T.: Na computação, o carriage return (CR) é um dos caracteres de controle do código ASCII,
Unicode ou EBCDIC que faz com que uma impressora ou dispositivo de saída mova a posição
do cursor para a primeira posição da linha onde se encontra. Esse comando é normalmente utilizado
acompanhado do line feed (avanço de linha): o retorno de carro (carriage return) antecede
o avanço de linha (line feed), de maneira a indicar uma nova linha (Fonte: Wikipédia).