在 YouTube 上观看

ESP32 Tutorial 37/55 - Using Bluetooth App with ESP32 BLE | SunFounder's ESP32 IoT Learning kit

In this tutorial, we will explore how to use the ESP32 as a Bluetooth server to send and receive messages from a mobile app. This allows for interactive communication between your ESP32 board and your mobile device, making it a versatile addition to your IoT projects. By the end of this lesson, you will be able to send text from your mobile device to the ESP32 and see it displayed on the serial monitor.

We will utilize the LightBlue Explorer app, available on both iOS and Android, to communicate with the ESP32. This tutorial is foundational for understanding Bluetooth Low Energy (BLE) communication and sets the stage for more advanced projects. For a visual guide, please refer to the video at (in video at 02:00).

Hardware Explained

The primary component in this project is the ESP32 microcontroller, which integrates both Wi-Fi and Bluetooth capabilities. This allows the ESP32 to act as a server, receiving and sending data wirelessly. The ESP32's built-in Bluetooth functionality supports BLE, making it efficient for low-power applications.

In addition to the ESP32, we will use a mobile device with the LightBlue app installed. This app allows users to connect to the ESP32 and send data through Bluetooth. The integration of these components enables seamless communication between the ESP32 and mobile devices, enhancing user interaction.

Datasheet Details

• Ensure stable power supply (3.3 V) to prevent brownouts.
• Use capacitors for decoupling near the power pins.
• Maintain proper heat dissipation if using high current.
• Be cautious with GPIO pin voltage levels; they are 3.3 V tolerant.
• Utilize pull-up or pull-down resistors as needed for GPIO configurations.
• Monitor BLE connections; ensure the app is properly paired.
• Verify UUIDs for services and characteristics are unique.
• Regularly check the serial monitor for debugging messages.
• Consider using a logic analyzer for complex signal troubleshooting.

Wiring Instructions

Wiring for this project is straightforward since the ESP32 primarily connects via USB for power and programming. Connect the ESP32 to your computer using a micro USB cable. Ensure that the USB port is providing sufficient power (typically 5 V). The serial monitor will be used for debugging, so no additional hardware connections are needed for this application.

When using the ESP32 with external components in future projects, remember to connect the ground pins to a common ground. This ensures that the ESP32 and any connected sensors or modules share the same reference point. Additionally, if you're using a battery, connect the positive terminal to the 3.3 V pin and the negative terminal to a ground pin on the ESP32.

Code Examples & Walkthrough

The provided code initializes the Bluetooth server, sets up the necessary services and characteristics, and handles incoming messages. Key identifiers include bleName, which defines the name of the Bluetooth device, and receivedText, which stores the incoming message from the mobile app.

const char *bleName = "ESP32_Bluetooth";
String receivedText = "";

The setup() function initializes the serial communication and the BLE setup. This is crucial for establishing a connection with the LightBlue app.

void setup() {
  Serial.begin(115200);  // Initialize the serial port
  setupBLE();            // Initialize the Bluetooth BLE
}

Within the loop() function, the code checks for incoming messages. If a new message is received, it gets printed to the serial monitor, and a notification is sent to the connected BLE device.

if (receivedText.length() > 0 && millis() - lastMessageTime > 1000) {
    Serial.print("Received message: ");
    Serial.println(receivedText);
    pCharacteristic->setValue(receivedText.c_str());
    pCharacteristic->notify();
    receivedText = "";
}

For a complete understanding, refer to the full code which loads below the article. This will provide you with all the necessary details to implement the project successfully.

Demonstration / What to Expect

Upon successful implementation, you should be able to send messages from the LightBlue app to the ESP32. As you type a message, such as "Hello," it will appear on the serial monitor. Additionally, you can send messages back to the app, confirming the two-way communication. If you encounter issues like messages not appearing, ensure that the ESP32 is properly paired with the app and that the UUIDs match.

Video Timestamps

• 00:00 Start
• 2:10 Introduction to the project
• 2:45 Documentation page
• 4:04 Arduino code
• 6:31 Installing Bluetooth App
• 7:12 Selecting ESP32 board and COM port
• 8:54 Demonstration of project

图像

bluetooth_lightblue

bluetooth_lightblue