C语言蓝牙库实战指南（从零开始掌握C语言蓝牙通信开发）

准备工作：安装 BlueZ 开发环境

在 Ubuntu 或 Debian 系统中，你可以通过以下命令安装 BlueZ 及其开发库：

sudo apt updatesudo apt install bluez libbluetooth-dev bluetooth

安装完成后，确保你的系统有蓝牙适配器，并已启用：

hciconfig

如果看到类似 hci0 的设备信息，说明蓝牙硬件已识别。

第一个 C 语言蓝牙程序：扫描附近设备

下面我们将编写一个简单的 C 程序，使用 C语言嵌入式蓝牙 库（libbluetooth）来扫描周围的蓝牙设备。这个例子非常适合初学者理解 蓝牙通信开发 的基本流程。

代码示例：device_scan.c

#include <stdio.h>#include <stdlib.h>#include <unistd.h>#include <sys/socket.h>#include <bluetooth/bluetooth.h>#include <bluetooth/hci.h>#include <bluetooth/hci_lib.h>int main(int argc, char **argv){    inquiry_info *ii = NULL;    int max_rsp, num_rsp;    int dev_id, sock, len, flags;    int i;    char addr[19] = { 0 };    char name[248] = { 0 };    // 获取默认蓝牙设备（通常是 hci0）    dev_id = hci_get_route(NULL);    if (dev_id < 0) {        perror("No Bluetooth adapter found");        exit(1);    }    // 打开 HCI socket    sock = hci_open_dev(dev_id);    if (sock < 0) {        perror("Can't open HCI socket");        exit(1);    }    len  = 8;   // 扫描最多 8 个设备    max_rsp = 255;    flags = IREQ_CACHE_FLUSH;    ii = (inquiry_info*)malloc(max_rsp * sizeof(inquiry_info));    // 开始设备发现（inquiry）    num_rsp = hci_inquiry(dev_id, len, max_rsp, NULL, &ii, flags);    if (num_rsp < 0) {        perror("Inquiry failed");        exit(1);    }    printf("Found %d devices\n", num_rsp);    for (i = 0; i < num_rsp; i++) {        ba2str(&(ii+i)->bdaddr, addr);        memset(name, 0, sizeof(name));                // 尝试获取设备名称        if (hci_read_remote_name(sock, &(ii+i)->bdaddr, sizeof(name),                                  name, 0) < 0)            strcpy(name, "[unknown]");        printf("%s  %s\n", addr, name);    }    free(ii);    close(sock);    return 0;}

编译与运行

将上述代码保存为 device_scan.c，然后使用以下命令编译：

gcc -o device_scan device_scan.c -lbluetooth

运行程序前，请确保蓝牙已开启：

sudo hciconfig hci0 upsudo ./device_scan

你将看到附近可被发现的蓝牙设备列表，包括 MAC 地址和设备名。

进阶：使用 BlueZ D-Bus API（适用于 BLE）

对于低功耗蓝牙（BLE）开发，BlueZ 推荐使用 D-Bus 接口而非传统的 HCI 原始操作。虽然这通常需要结合 GLib 或 sd-bus 等库，但它是现代 BlueZ蓝牙编程 的标准方式。

不过对于初学者，建议先掌握上述 libbluetooth 的基础用法，再逐步过渡到 D-Bus 编程模型。

常见问题与调试技巧

• 权限问题：操作蓝牙设备通常需要 root 权限，可使用 sudo 或配置 udev 规则。
• 设备未被发现：确保目标设备处于“可被发现”模式。
• 编译错误：确认已安装 libbluetooth-dev 包。

总结

通过本教程，你已经掌握了如何使用 C语言蓝牙库（BlueZ 的 libbluetooth）进行基础的蓝牙设备扫描。这是 蓝牙通信开发 的第一步，后续你可以探索连接、数据传输、GATT 服务等更高级的功能。

无论是做智能家居、可穿戴设备，还是工业物联网项目，扎实的 C语言嵌入式蓝牙 开发能力都将为你打下坚实基础。而 BlueZ 作为 Linux 下最成熟的蓝牙解决方案，值得每一位嵌入式开发者深入学习。

关键词回顾：C语言蓝牙库、蓝牙通信开发、C语言嵌入式蓝牙、BlueZ蓝牙编程。