Reading data from SD card in Arduino - Step-by-Step Execution

Concept Flow - Reading data from SD card

Start

↓

Initialize SD card

↓

Open file for reading

↓

Check if file opened?

No→Error: Cannot open file

Yes↓

Read data line by line

↓

Print or process data

↓

Close file

↓

End

The program starts by initializing the SD card, then opens a file to read. If successful, it reads data line by line, processes it, closes the file, and ends.

Execution Sample

Arduino

void setup() {
  Serial.begin(9600);
  if (!SD.begin(10)) {
    Serial.println("SD init failed");
    return;
  }
  File dataFile = SD.open("data.txt");
  if (dataFile) {
    while (dataFile.available()) {
      Serial.write(dataFile.read());
    }
    dataFile.close();
  } else {
    Serial.println("Error opening file");
  }
}

void loop() {
  // Empty loop
}

This code initializes the SD card, opens 'data.txt', reads its content byte by byte, prints it to Serial, then closes the file.

Execution Table

Step	Action	Condition/Check	Result/Output
1	Start Serial communication	None	Serial ready at 9600 baud
2	Initialize SD card with pin 10	SD.begin(10)	Returns true if SD card found
3	Check SD card init result	If SD.begin(10) == false	Print 'SD init failed' and stop
4	Open file 'data.txt'	SD.open("data.txt")	Returns file object if exists
5	Check if file opened	If file is valid	Proceed to read data
6	Read data byte by byte	While file.available() == true	Read byte and print to Serial
7	Close file	After reading all bytes	File closed
8	If file not opened	Else branch	Print 'Error opening file'
9	End	All steps done	Program waits for next action

💡 Program ends after file is closed or error message printed

Variable Tracker

Variable	Start	After SD.begin	After File open	During reading	Final
SD.begin(10)	Not called	true (if SD card found) or false	N/A	N/A	N/A
dataFile	Not opened	N/A	File object or invalid	Reading bytes	Closed
Serial output	Empty	Ready	N/A	Data bytes printed	Data printed or error message

Key Moments - 3 Insights

Why does the program check if SD.begin(10) returns true?

Because SD.begin(10) tells if the SD card is ready. If false, the program stops reading to avoid errors (see execution_table step 3).

What happens if the file 'data.txt' does not exist or cannot open?

The program prints 'Error opening file' and does not try to read data (see execution_table step 8).

Why do we need to close the file after reading?

Closing the file frees resources and ensures data integrity (see execution_table step 7).

Visual Quiz - 3 Questions

Look at the execution table, what is printed if SD.begin(10) returns false?

A File data bytes

B "SD init failed"

C "Error opening file"

D Nothing

💡 Hint

Check execution_table step 3 where SD.begin(10) is false

At which step does the program start reading data from the file?

A Step 6

B Step 4

C Step 5

D Step 7

💡 Hint

See execution_table step 6 where reading happens

If the file 'data.txt' is empty, what will happen during reading?

A The program prints all file bytes

B The program prints 'Error opening file'

C The reading loop does not run, file closes immediately

D The program crashes

💡 Hint

Look at variable_tracker 'dataFile' during reading and execution_table step 6

Concept Snapshot

Reading data from SD card in Arduino:
- Initialize SD with SD.begin(chipSelectPin)
- Open file with SD.open(filename)
- Check if file opened successfully
- Read data with file.read() or file.available()
- Close file after reading
- Use Serial to print or process data

Full Transcript

This example shows how an Arduino program reads data from an SD card. First, it starts serial communication to print messages. Then it initializes the SD card using SD.begin with the chip select pin 10. If initialization fails, it prints 'SD init failed' and stops. If successful, it tries to open a file named 'data.txt'. If the file opens, it reads the data byte by byte and prints each byte to the Serial monitor. After reading all data, it closes the file. If the file cannot be opened, it prints 'Error opening file'. This process ensures safe reading from the SD card and proper resource management.

Practice

1. What is the correct function to open a file for reading from an SD card in Arduino?

easy

A. SD.open(filename, FILE_READ)

B. SD.read(filename)

C. SD.begin(filename)

D. SD.load(filename)

Solution

1. Step 1: Identify the function to open files on SD card

   The Arduino SD library uses SD.open() to open files.

2. Step 2: Specify the mode for reading

   To read a file, the mode FILE_READ must be passed as the second argument.

3. Final Answer:

   SD.open(filename, FILE_READ) -> Option A

4. Quick Check:

   Open file for reading = SD.open(filename, FILE_READ) [OK]

Hint: Use SD.open() with FILE_READ to open files for reading [OK]

Common Mistakes:

• Using SD.read() to open files
• Forgetting FILE_READ mode
• Using SD.begin() to open files
• Using SD.load() which doesn't exist

2. Which of the following is the correct syntax to check if a file opened successfully before reading?

easy

A. if (file != NULL) { /* read file */ }

B. if (file.isOpen()) { /* read file */ }

C. if (file) { /* read file */ }

D. if (file.exists()) { /* read file */ }

Solution

1. Step 1: Understand file object truthiness in Arduino

   In Arduino, File objects can be checked directly in if statements to see if they opened successfully.

2. Step 2: Recognize correct syntax

   Using if (file) is the standard way to check if the file opened.

3. Final Answer:

   if (file) { /* read file */ } -> Option C

4. Quick Check:

   Check file open with if (file) [OK]

Hint: Use if (file) to check if file opened successfully [OK]

Common Mistakes:

• Comparing file to NULL (not Arduino style)
• Using file.isOpen() which doesn't exist
• Using file.exists() which checks SD, not file open

3. What will be the output of this Arduino code snippet reading from an SD card file named "data.txt" containing the text "Hello"?

File file = SD.open("data.txt", FILE_READ);
if (file) {
  char c = file.read();
  Serial.println(c);
  file.close();
} else {
  Serial.println("Error opening file");
}

medium

A. H

B. Hello

C. Error opening file

D. 104

Solution

1. Step 1: Understand file.read() returns a byte

   The read() method returns the ASCII value of the first character, but when assigned to a char and printed with Serial.println(char), it prints the character itself.

2. Step 2: Check code carefully

   Since c is a char and Serial.println(c) prints the character, the output is 'H'.

3. Final Answer:

   H -> Option A

4. Quick Check:

   file.read() returns char 'H' printed as H [OK]

Hint: file.read() returns one char; Serial.println prints char [OK]

Common Mistakes:

• Thinking read() returns whole string
• Expecting ASCII number printed
• Confusing file.read() with readStringUntil()

4. Identify the error in this Arduino code snippet that reads a line from an SD card file:

File file = SD.open("log.txt", FILE_READ);
if (file) {
  String line = file.readStringUntil('\n');
  Serial.println(line);
}
file.close();

medium

A. readStringUntil() is not a valid File method

B. file.close() is called outside the if block

C. Missing SD.begin() before opening file

D. Using single quotes instead of double quotes in readStringUntil

Solution

1. Step 1: Check file.close() placement

   file.close() should be called only if file opened successfully, so it must be inside the if block.

2. Step 2: Understand consequences

   If file failed to open, calling file.close() causes error because file is invalid.

3. Final Answer:

   file.close() is called outside the if block -> Option B

4. Quick Check:

   Close file only if opened [OK]

Hint: Call file.close() only inside if (file) block [OK]

Common Mistakes:

• Calling file.close() unconditionally
• Assuming readStringUntil() is invalid
• Forgetting SD.begin() but not shown here
• Confusing single vs double quotes in char argument

5. You want to read all lines from a file "config.txt" on an SD card and print each line to Serial. Which code snippet correctly does this?

hard

A. File file = SD.open("config.txt", FILE_READ);
while (file) {
Serial.println(file.readStringUntil('\n'));
}
file.close();

B. File file = SD.open("config.txt", FILE_READ);
while (!file.available()) {
Serial.println(file.readStringUntil('\n'));
}
file.close();

C. File file = SD.open("config.txt", FILE_READ);
while (file.read()) {
Serial.println(file.readStringUntil('\n'));
}
file.close();

D. File file = SD.open("config.txt", FILE_READ);
while (file.available()) {
Serial.println(file.readStringUntil('\n'));
}
file.close();

Solution

1. Step 1: Use file.available() to check for data

   file.available() returns true if there is data left to read, so loop while available() is true.

2. Step 2: Read each line with readStringUntil('\n')

   This method reads until newline, perfect for line-by-line reading.

3. Step 3: Close file after reading

   Call file.close() after finishing reading to free resources.

4. Final Answer:

   Use while (file.available()) with readStringUntil('\n') -> Option D

5. Quick Check:

   Loop with file.available() to read lines [OK]

Hint: Loop while file.available() to read all lines [OK]

Common Mistakes:

• Using while (!file.available()) which loops incorrectly
• Using while (file.read()) which reads bytes, not lines
• Using while (file) which doesn't check data availability