Trong bài này chúng ta sẽ lập trình ESP32 BLE Server (GATT Server), tạo một Service và Characteristic để điện thoại ghi ký tự 1/0 điều khiển LED. Khác với kết nối Serial ảo của Bluetooth Classic, BLE tổ chức dữ liệu thành các dịch vụ và thuộc tính có UUID để Client biết chỗ cần đọc hoặc ghi.
Đây là một bài thực hành trong Serie Lập trình ESP32 từ A tới Z.
Mô hình GATT trong BLE
BLE không có khái niệm “gửi text tự do” như Bluetooth Classic. Thay vào đó, thiết bị đóng vai Server sẽ khai báo sẵn một cấu trúc dữ liệu cố định gồm:
- Service: một nhóm chức năng, định danh bằng UUID (ví dụ “dịch vụ điều khiển đèn”).
- Characteristic: một giá trị cụ thể bên trong Service, cũng có UUID riêng — đây mới là nơi dữ liệu thực sự được đọc/ghi (ví dụ “trạng thái LED”: 1 = bật, 0 = tắt).
Thiết bị đóng vai Client (bài sau) sẽ quét tìm đúng Service theo UUID, kết nối vào, rồi đọc hoặc ghi giá trị vào đúng Characteristic đó. Cách này có vẻ rườm rà hơn Bluetooth Classic, nhưng lại chuẩn hóa hơn — chính là cách nhiều thiết bị BLE như vòng đeo tay và cảm biến trao đổi dữ liệu.
Bài này mình sẽ dựng ESP32 đóng vai Server, mở 1 Service với 1 Characteristic điều khiển LED, cho phép Client kết nối vào và ghi giá trị "1"/"0" để bật/tắt.
Lập trình ESP32 BLE Server
Khởi tạo Server, Service và Characteristic
#define SERVICE_UUID "4fafc201-1fb5-459e-8fcc-c5c9c331914b"
#define CHARACTERISTIC_UUID "beb5483e-36e1-4688-b7f5-ea07361b26a8"
BLEDevice::init("ESP32-BLE-LED");
BLEServer *server = BLEDevice::createServer();
BLEService *service = server->createService(SERVICE_UUID);
BLECharacteristic *ledCharacteristic = service->createCharacteristic(
CHARACTERISTIC_UUID,
BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_NOTIFY
);
service->start();
BLEDevice::getAdvertising()->start();
UUID là chuỗi định danh duy nhất (dạng xxxxxxxx-xxxx-...) — Server và Client phải dùng đúng chung 1 cặp UUID này thì mới “nhận ra nhau” được. Cờ PROPERTY_READ | PROPERTY_WRITE | PROPERTY_NOTIFY khai báo Characteristic này cho phép đọc, ghi, và gửi thông báo khi giá trị thay đổi.
Xử lý khi Client ghi giá trị
class LedCallbacks : public BLECharacteristicCallbacks {
void onWrite(BLECharacteristic *characteristic) override {
String value = characteristic->getValue().c_str();
if (value == "1") {
digitalWrite(led, HIGH);
} else if (value == "0") {
digitalWrite(led, LOW);
}
}
};
ledCharacteristic->setCallbacks(new LedCallbacks());
BLE hoạt động theo kiểu callback (hướng sự kiện) chứ không polling như SerialBT.available() ở bài trước — hàm onWrite() tự động được gọi bất cứ khi nào có Client ghi giá trị mới vào Characteristic này.
Các bạn để ý đuôi .c_str() sau getValue(). Trên Arduino core 2.x (môi trường PlatformIO dùng trong ví dụ), getValue() trả về std::string của C++, còn từ core 3.x lại trả về String của Arduino. Thêm .c_str() thì code biên dịch được trên cả 2 phiên bản.
Lưu ý: Ví dụ này dùng thao tác WRITE để điều khiển LED. Khai báo PROPERTY_NOTIFY chưa tự gửi thông báo: với thư viện BLE đang dùng, cần descriptor BLE2902, Client đăng ký nhận thông báo và chương trình gọi notify() khi muốn gửi. Code hiện tại chưa thực hiện luồng NOTIFY đó.
UUID giống địa chỉ phòng: cùng nhìn thấy một tòa nhà chưa đủ, Client còn phải tìm đúng phòng chứa chức năng điều khiển LED. Code dùng thư viện BLE đi kèm Arduino-ESP32; xem ghi chú chuyển đổi API BLE 2.x sang 3.x của Espressif khi đổi phiên bản.
Code đầy đủ
#include <Arduino.h>
#include <BLEDevice.h>
#include <BLEServer.h>
#include <BLEUtils.h>
#include <BLE2902.h>
#define SERVICE_UUID "4fafc201-1fb5-459e-8fcc-c5c9c331914b"
#define CHARACTERISTIC_UUID "beb5483e-36e1-4688-b7f5-ea07361b26a8"
const int led = 26;
BLECharacteristic *ledCharacteristic;
bool deviceConnected = false;
class ServerCallbacks : public BLEServerCallbacks {
void onConnect(BLEServer *server) override {
deviceConnected = true;
Serial.println("Co client ket noi toi BLE Server");
}
void onDisconnect(BLEServer *server) override {
deviceConnected = false;
Serial.println("Client ngat ket noi - bat dau quang cao (advertise) lai");
server->getAdvertising()->start();
}
};
class LedCallbacks : public BLECharacteristicCallbacks {
void onWrite(BLECharacteristic *characteristic) override {
String value = characteristic->getValue().c_str();
if (value.length() > 0) {
Serial.print("Nhan gia tri ghi vao characteristic: ");
Serial.println(value);
if (value == "1") {
digitalWrite(led, HIGH);
} else if (value == "0") {
digitalWrite(led, LOW);
}
}
}
};
void setup() {
Serial.begin(115200);
pinMode(led, OUTPUT);
digitalWrite(led, LOW);
BLEDevice::init("ESP32-BLE-LED");
BLEServer *server = BLEDevice::createServer();
server->setCallbacks(new ServerCallbacks());
BLEService *service = server->createService(SERVICE_UUID);
ledCharacteristic = service->createCharacteristic(
CHARACTERISTIC_UUID,
BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_WRITE | BLECharacteristic::PROPERTY_NOTIFY
);
ledCharacteristic->setCallbacks(new LedCallbacks());
ledCharacteristic->addDescriptor(new BLE2902());
ledCharacteristic->setValue("0");
service->start();
BLEAdvertising *advertising = BLEDevice::getAdvertising();
advertising->addServiceUUID(SERVICE_UUID);
advertising->setScanResponse(true);
BLEDevice::startAdvertising();
Serial.println("BLE Server da san sang, dang quang cao voi ten: ESP32-BLE-LED");
}
void loop() {
delay(1000);
}
Code đầy đủ mình để trên GitHub, các bạn xem tại 05-Bluetooth/02_BLE_Server nhé.
Kết quả
Đấu nối 1 LED vào GPIO26 qua điện trở 220Ω xuống GND như sơ đồ dưới. Đây là LED rời, không phải LED có sẵn trên board (LED onboard của ESP32 DevKit nằm ở GPIO2).
Nạp code, mở điện thoại cài app “nRF Connect” (miễn phí, cả Android/iOS), quét BLE, tìm thiết bị tên ESP32-BLE-LED, kết nối vào. Mở rộng Service vừa thấy, tìm đúng Characteristic, bấm biểu tượng mũi tên để ghi giá trị. Ở ô chọn kiểu dữ liệu, chọn Text (UTF-8) rồi gõ 1.
Lưu ý: Đừng để kiểu mặc định là Byte Array (hex) rồi gõ 01 — cách đó gửi xuống byte có giá trị 1, trong khi code so sánh với ký tự "1" (mã ASCII là 0x31). Hai giá trị khác nhau nên LED sẽ không sáng, dù app báo ghi thành công. Nếu vẫn muốn dùng hex thì phải gõ 31.

Ghi 1 rồi ghi 0, sau đó ngắt kết nối trên app. Serial Monitor (115200 baud) của board in ra đủ từng bước:
LED rời nối GPIO26 sẽ sáng khi Server nhận ký tự 1, đúng không nào. Ở bài tiếp theo, thay vì dùng điện thoại, mình sẽ dùng chính 1 board ESP32 khác đóng vai Client để tự động kết nối và điều khiển board Server này.
Kết
BLE Server là nền tảng của hầu hết thiết bị BLE thương mại ngoài kia — hiểu được mô hình Service/Characteristic sẽ giúp bạn đọc hiểu và tự viết firmware cho bất kỳ thiết bị BLE nào, từ cảm biến đơn giản tới thiết bị y tế phức tạp.
Nếu thấy bài viết có ích, hãy chia sẻ cho bạn bè cùng học. Có thắc mắc gì cứ để lại bình luận, mình sẽ giải đáp nhé!




