蓝牙文件传输主要用到 bluez 下 obex 协议支持，需要在启动 bluetoothd 蓝牙守护进程后再启动 obexd 文件传输服务进程，关于蓝牙协议栈可以参考以下图片：

bluez 5.50 蓝牙协议栈体系结构

蓝牙技术的系统结构分为三大部分：底层硬件模块、中间协议层和应用层

1、底层硬件模块

蓝牙的 GIG 规定了四种与硬件连接的物理总线方式 USB、RS232、UART、PC卡

2、bluezcore 核心层包含各种 profile

• GAP：设备连接
• SDAP：查询相关信息
• SPP：虚拟串口连接
• GOEP：数据传输

3、中间协议层

• HCI接口：设备扫描、配对
• L2CAP协议：蓝牙适配

4、应用层及 bluez 各种工具集

• hciconfig：配置蓝牙设备，用于打印设备信息和配置设备
• hcitool：配置蓝牙连接，执行扫描等命令
• gatttool：直接使用参数对蓝牙设备进行控制，使用 -l 参数进入 interactive 模式对蓝牙设备进行控制
• sdptool：搜索并管理设备服务

buildroot 配置添加

这里使用的 bluez 5.50，在 buildroot 配置中能够看到 bluez 分为 bluez 和 bluez5.x ，这是因为 bluez(3.xx-4.xx) 版本与 bluez5.xx 版本相差很大，之前旧版本的 bluez 会包含很多上层 a2dp、obex 等应用服务，而在新版本的 bluez 中为了方便应用配置和简化代码将上层应用进行了剥离。

由于我们使用的是 bluez5.50 ，所以在添加配置时注意要选择我们所需要的 bluez 协议：

文件传输启动流程

在 bluetoothd 蓝牙守护进程启动之前需要确保 dbus 服务已经正常启动了，具体启动流程可以参考以下脚本：

【bluetooth_init.sh】

#!/bin/sh
btmgmt -i hci0 name "blueztest"
btmgmt -i hci0 connectable on
btmgmt -i hci0 le on
btmgmt -i hci0 advertising on
btmgmt -i hci0 power on
export $(dbus-launch)
sdptool add --channel=1 GATT SP A2SNK A2DP
btgatt-server &
/usr/libexec/bluetooth/bluetoothd -d -C -n &
pulseaudio -D  --exit-idle-time=-1 --start --log-target=file:/tmp/pulse.log
/usr/libexec/bluetooth/obexd -a -n -r /home/ &
1
2
3
4
5
6
7
8
9
10
11
12
13
14

注意 export $(dbus-launch) 操作是为了添加 dbus session 环境变量 DBUS_SESSION_BUS_ADDRESS ，如果启动 obexd 服务发现有以下报错肯定是这个环境变量没有配置：

# /usr/libexec/bluetooth/obexd

Using X11 for dbus-daemon autolaunch was disabled at compile time, set your DBUS_SESSION_BUS_ADDRESS instead
1
2
3

在启动 bluetoothd 时可以将 -d 选项去掉，这里添加是为了方便进行调试，-d 选项是 debug 使能操作。

同理，obexd 启动时也可以将 -n 选项去掉，-n 选项是为了将 log 信息显示到前台。

服务启动后的文件传输操作

1、先确定蓝牙设备是否挂载成功并且使能，hciconfig -a 查看，如下：

2、顺利执行 bluetooth_init.sh 脚本，脚本内容如前一小节所示，启动成功后，能够进入 bluetoothd 并执行 show 操作：

3、在 bluetoothctl 交互对话中执行 scan on 搜索设备，如下所示：

4、devices 查看搜索到的设备，这时候就可以通过 connect 连接我们的手机或者蓝牙设备：

5、连接操作：

连接成功后，当前标签就会变成连接后的设备名称，并且能够通过help查看支持的操作，如下所示：

此时可以输入 quit 退出 bluetoothctl 操作，蓝牙会继续保持连接，如果需要使得该设备每次启动后自动连接，需要执行 trust <设备addr> 操作即可。

6、前面已经在启用 obexd 时添加了 -a 自动接收文件操作，这时候可以操作手机完成文件上传，如下图所示：

这里的接收路径是在启用 obexd 时的 -r 参数配置的，我这里配置成 /home 路径，所以自动接收的文件会存放到这里。如果这一步报错有编码问题，需要重新编译 builroot ，具体参考后面的【问题及解决方法】

7、蓝牙文件发送操作

文件发送操作在板子上需要借助 obexctl 工具，这个工具 buildroot 不会自动拷贝过来，它存在 bluez 的 tools 下，在编译过程中应该已经编译完成，我们拷贝到板子上使用即可。

启用 obexctl 进入界面：

遇到的问题及解决方法

1、在从手机端向设备进行文件传输请求时：

failed: Conversion from character set “UTF-16BE” to “UTF-8” is not supported

https://blog.csdn.net/qq_32017483/article/details/124304238

buildroot 中要添加 libiconv 库支持，就需要在 Toolchain 中选择如下：（注意在添加选项后，需要重新编译 glibc、dbus、bluez才能有效）

2、启动 obexctl 失败

obexctl 启动 arguments to dbus_connection_unref() were incorrect, assertion "connection != NULL" failed in file dbus-connection.c

这里还是 dbus 环境问题，重启后调用dbus-launch 后，export 设置环境变量DBUS_SESSION_BUS_ADDRESS 再次尝试即可正常