Receiving commands over Bluetooth in Arduino - Step-by-Step Execution

Concept Flow - Receiving commands over Bluetooth

Start Bluetooth Serial

↓

Wait for Data Available?

No→Keep Waiting

Yes↓

Read Incoming Command

↓

Process Command

↓

Execute Action

↓

Loop Back to Wait

The Arduino waits for Bluetooth data, reads commands when available, processes them, and executes actions in a loop.

Execution Sample

Arduino

void loop() {
  if (Serial.available()) {
    char cmd = Serial.read();
    if (cmd == 'A') {
      digitalWrite(LED_BUILTIN, HIGH);
    }
  }
}

This code reads a character from Bluetooth and turns on the LED if the command is 'A'.

Execution Table

Step	Serial.available()	Serial.read()	Command	Action Taken	Output
1	0 (No data)	-	-	Wait	No change
2	1 (Data available)	'A'	A	Turn LED ON	LED ON
3	1 (Data available)	'B'	B	No action	LED stays ON
4	0 (No data)	-	-	Wait	LED stays ON

💡 Loop runs continuously; waits when no data, acts when data received.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4
cmd	undefined	'A'	'B'	undefined
LED state	OFF	ON	ON	ON

Key Moments - 2 Insights

Why does the program wait when Serial.available() is 0?

Because no data has arrived yet, so the program skips reading and waits for data, as shown in step 1 and 4 of the execution_table.

What happens if the command is not 'A'?

No action is taken and the LED state remains unchanged, as seen in step 3 where command 'B' does not turn the LED on.

Visual Quiz - 3 Questions

Look at the execution_table, what is the value of 'cmd' at step 3?

A 'B'

B 'A'

C undefined

D 'C'

💡 Hint

Check the 'Serial.read()' and 'Command' columns at step 3 in the execution_table.

At which step does the LED turn ON according to the execution_table?

A Step 1

B Step 2

C Step 3

D Step 4

💡 Hint

Look at the 'Action Taken' and 'Output' columns for when LED changes state.

If Serial.available() is always 0, what will happen to the LED state?

A LED will turn ON

B LED will turn OFF

C LED state will never change

D LED will blink

💡 Hint

Refer to variable_tracker and execution_table steps where Serial.available() is 0.

Concept Snapshot

Receiving commands over Bluetooth:
- Use Serial.available() to check data
- Use Serial.read() to get command
- Use if conditions to process commands
- Execute actions like turning LED on/off
- Loop continuously to keep checking

Full Transcript

This example shows how an Arduino receives commands over Bluetooth using the Serial interface. The program continuously checks if data is available with Serial.available(). When data arrives, it reads one character with Serial.read(). If the character matches a command like 'A', it performs an action such as turning on the built-in LED. If no data is available, the program waits and checks again. This loop runs forever, allowing the Arduino to respond to Bluetooth commands anytime they come in.

Practice

1. What does the available() function do when receiving Bluetooth commands on Arduino?

easy

A. It sends data to the Bluetooth device.

B. It checks if there is data ready to be read from the Bluetooth module.

C. It resets the Bluetooth connection.

D. It closes the Bluetooth communication.

Solution

1. Step 1: Understand the role of available()

   The available() function returns the number of bytes available to read from the Bluetooth serial buffer.

2. Step 2: Identify its use in receiving commands

   It is used to check if any data has arrived and is ready to be read, so the program knows when to read incoming commands.

3. Final Answer:

   It checks if there is data ready to be read from the Bluetooth module. -> Option B

4. Quick Check:

   available() checks data presence [OK]

Hint: Remember: available() means data is ready to read [OK]

Common Mistakes:

• Thinking available() sends data instead of checking
• Confusing available() with read()
• Assuming available() resets connection

2. Which of the following is the correct way to read a single character from Bluetooth in Arduino?

easy

A. char command = Bluetooth.read();

B. char command = Bluetooth.available();

C. char command = Bluetooth.write();

D. char command = Bluetooth.begin();

Solution

1. Step 1: Identify the function to read data

   The read() function reads one byte (character) from the Bluetooth serial buffer.

2. Step 2: Confirm correct syntax

   Assigning Bluetooth.read() to a char variable correctly stores the incoming character.

3. Final Answer:

   char command = Bluetooth.read(); -> Option A

4. Quick Check:

   Use read() to get one char [OK]

Hint: Use read() to get data, not available() or write() [OK]

Common Mistakes:

• Using available() to read data instead of read()
• Using write() which sends data, not reads
• Calling begin() which initializes, not reads

3. What will be printed on the Serial Monitor when the following Arduino code receives the character 'L' over Bluetooth?

if (Bluetooth.available()) {
  char cmd = Bluetooth.read();
  if (cmd == 'L') {
    Serial.println("LED ON");
  } else {
    Serial.println("UNKNOWN COMMAND");
  }
}

medium

A. LED ON

B. UNKNOWN COMMAND

C. L

D. No output

Solution

1. Step 1: Check if data is available

   The code first checks if Bluetooth data is available, which it is since 'L' is sent.

2. Step 2: Read and compare the character

   The character 'L' is read and compared to 'L', which matches, so it prints "LED ON".

3. Final Answer:

   LED ON -> Option A

4. Quick Check:

   Received 'L' triggers "LED ON" print [OK]

Hint: Match received char to command to print correct message [OK]

Common Mistakes:

• Assuming it prints the character itself
• Ignoring the if condition and expecting UNKNOWN COMMAND
• Thinking no output if Bluetooth.available() is true

4. Identify the error in this Arduino Bluetooth command reading code:

if (Bluetooth.available > 0) {
  char cmd = Bluetooth.read();
  Serial.println(cmd);
}

medium

A. Bluetooth.read() should be Bluetooth.readChar().

B. The if condition should check for Bluetooth.read() instead.

C. Serial.println() cannot print characters.

D. Bluetooth.available should be called as a function with parentheses.

Solution

1. Step 1: Check usage of available()

   The code uses Bluetooth.available without parentheses, but it is a function and must be called as Bluetooth.available().

2. Step 2: Verify other parts

   Bluetooth.read() is correct to read a char, and Serial.println() can print characters, so no errors there.

3. Final Answer:

   Bluetooth.available should be called as a function with parentheses. -> Option D

4. Quick Check:

   available() needs parentheses [OK]

Hint: Remember functions need () to work [OK]

Common Mistakes:

• Forgetting parentheses on available()
• Thinking read() is readChar()
• Believing Serial.println() can't print chars

5. You want your Arduino to turn an LED on when it receives the command '1' and off when it receives '0' over Bluetooth. Which code snippet correctly implements this behavior?

if (Bluetooth.available()) {
  char cmd = Bluetooth.read();
  switch (cmd) {
    case '1':
      digitalWrite(LED_PIN, HIGH);
      Serial.println("LED ON");
      break;
    case '0':
      digitalWrite(LED_PIN, LOW);
      Serial.println("LED OFF");
      break;
    default:
      Serial.println("Invalid command");
  }
}

hard

A. digitalWrite cannot be used with Bluetooth commands.

B. The code should use if-else instead of switch for Bluetooth commands.

C. This code correctly reads commands and controls the LED accordingly.

D. Bluetooth.read() returns an integer, so char cmd is wrong.

Solution

1. Step 1: Analyze command reading and control

   The code reads a character from Bluetooth and uses a switch to check if it is '1' or '0'.

2. Step 2: Verify LED control and feedback

   It sets the LED pin HIGH or LOW accordingly and prints the status, which matches the requirement.

3. Final Answer:

   This code correctly reads commands and controls the LED accordingly. -> Option C

4. Quick Check:

   Switch-case handles commands and controls LED [OK]

Hint: Use switch-case to handle multiple commands cleanly [OK]

Common Mistakes:

• Thinking if-else is required instead of switch
• Believing digitalWrite can't be used with Bluetooth input
• Confusing data types returned by Bluetooth.read()