GM-3568JHF 开发板集成了 RTL8723DU 无线通信模块，该模块不仅提供 WIFI 功能，同时还集成了蓝牙功能。蓝牙模块支持经典蓝牙和低功耗蓝牙（BLE）协议，为开发板提供了丰富的短距离无线通信能力。
本篇教程基于ShiMetaPi 研发的FPGA+ARM开发板------GM-3568JHF展开。
1 蓝牙模块概述
1.1 RTL8723DU 蓝牙技术规格
|-------|------------------------------------------------|
| 参数 | 规格 |
| 芯片型号 | Realtek RTL8723DU |
| 蓝牙版本 | Bluetooth 4.2 |
| 协议支持 | Classic Bluetooth + BLE (Bluetooth Low Energy) |
| 工作频段 | 2.4GHz ISM 频段 (2.402~2.480GHz) |
| 调制方式 | FHSS (跳频扩频) |
| 发射功率 | Class 2 (最大 4dBm) |
| 接收灵敏度 | -90dBm @ 0.1% BER |
| 传输距离 | 10 米 (Class 2) |
| 数据速率 | 最大 3Mbps (EDR) |
1.2 驱动和软件支持
Linux 蓝牙协议栈
-
BlueZ: Linux 标准蓝牙协议栈
-
内核支持: 内核原生驱动支持
-
用户空间工具: bluetoothctl, hciconfig, hcitool 等
-
D-Bus 接口: 标准 D-Bus API 接口
支持的应用场景
-
音频设备: 蓝牙耳机、音箱连接
-
输入设备: 蓝牙键盘、鼠标
-
文件传输: 与手机、电脑文件互传
-
串口通信: 蓝牙串口数据传输
-
IoT 应用: BLE 传感器数据采集
2 蓝牙连接配置
开发板已适配 RTL8723DU 模块，蓝牙驱动和协议栈已完成适配配置。
2.1 连接测试
测试需要一部智能手机（该小节测试使用的是安卓手机），打开手机蓝牙功能，并且打开开发板蓝牙功能，然后进行连接，如下图所示：
开发板端：
手机端：
2.2 数据收发测试
首先在 home/linaro 文件夹下新建一个 bluetooth_test.txt 文件，内容为：bluetooth_test
1）文件发送
开发板通过蓝牙将 bluetooth_test.txt 发送到手机，手机接收
开发板端：
手机端：
查看文件内容是否一致：
2）文件接收
手机通过蓝牙将 bluetooth_test.txt 发送到开发板，开发板接收
手机端：
开发板端：
2.3 命令行蓝牙配置
hciconfig 和 hcitool
# 查看蓝牙适配器信息
hciconfig -a
# 启用蓝牙适配器
sudo hciconfig hci0 up
# 设置可发现模式
sudo hciconfig hci0 piscan
# 扫描附近设备
hcitool scan
# 查看设备信息
hcitool info XX:XX:XX:XX:XX:XX
# 检查连接状态
hcitool con配对和认证
# 使用 simple-agent 配对
sudo simple-agent hci0 XX:XX:XX:XX:XX:XX
# 或使用 bluez-simple-agent
bluez-simple-agent hci0 XX:XX:XX:XX:XX:XX3 蓝牙音频应用
3.1 连接蓝牙音频设备
安装音频支持包
# 安装 PulseAudio 蓝牙模块
sudo apt-get install pulseaudio-module-bluetooth
# 重启 PulseAudio
pulseaudio -k
pulseaudio --start配置音频设备
# 查看音频设备
pactl list short sinks
# 设置默认音频输出
pactl set-default-sink bluez_sink.XX_XX_XX_XX_XX_XX.a2dp_sink
# 播放测试音频
speaker-test -t wav -c 2
# 使用 aplay 播放音频文件
aplay /usr/share/sounds/alsa/Front_Left.wav3.2 A2DP音频流传输
# 连接 A2DP 设备后，检查音频配置
bluetoothctl
[bluetooth]# info XX:XX:XX:XX:XX:XX
# 在 PulseAudio 中查看蓝牙音频设备
pactl list sinks | grep -A 10 bluez
# 播放音频到蓝牙设备
mpg123 -a bluez_sink.XX_XX_XX_XX_XX_XX.a2dp_sink music.mp34 BLE (低功耗蓝牙) 应用
BLE 设备扫描和连接
使用 gatttool
# 扫描 BLE 设备
sudo hcitool lescan
# 连接 BLE 设备
gatttool -b XX:XX:XX:XX:XX:XX -I
# 在 gatttool 交互模式中：
[XX:XX:XX:XX:XX:XX][LE]> connect
[XX:XX:XX:XX:XX:XX][LE]> primary # 列出主要服务
[XX:XX:XX:XX:XX:XX][LE]> characteristics # 列出特征值
[XX:XX:XX:XX:XX:XX][LE]> char-read-hnd 0x0010 # 读取特征值
[XX:XX:XX:XX:XX:XX][LE]> char-write-req 0x0010 0100 # 写入特征值使用 bluetoothctl 进行 BLE 操作
bluetoothctl
[bluetooth]# scan on
[bluetooth]# connect XX:XX:XX:XX:XX:XX
[bluetooth]# gatt list-attributes
[bluetooth]# gatt select-attribute /org/bluez/hci0/dev_XX_XX_XX_XX_XX_XX/service0010/char0011
[bluetooth]# gatt read
[bluetooth]# gatt write "0x01 0x02"5 故障排除
5.1 蓝牙模块无法识别
检查步骤:
# 检查 USB 设备
lsusb | grep Realtek
# 检查蓝牙适配器
hciconfig -a
# 检查内核模块
lsmod | grep bluetooth
# 手动加载蓝牙模块
sudo modprobe bluetooth
sudo modprobe btusb
# 检查蓝牙服务状态
sudo systemctl status bluetooth5.2 设备配对失败
可能原因和解决方案:
# 重置蓝牙适配器
sudo hciconfig hci0 reset
# 清除配对缓存
sudo rm -rf /var/lib/bluetooth/*/cache
# 重启蓝牙服务
sudo systemctl restart bluetooth
# 检查认证代理
ps aux | grep agent5.3 音频连接问题
解决步骤:
# 检查 PulseAudio 模块
pactl list modules | grep bluetooth
# 重新加载蓝牙模块
pactl unload-module module-bluetooth-discover
pactl load-module module-bluetooth-discover
# 检查音频配置文件
bluetoothctl
[bluetooth]# info XX:XX:XX:XX:XX:XX5.4 连接不稳定
优化建议:
# 检查信号强度
hcitool rssi XX:XX:XX:XX:XX:XX
# 调整功率管理
echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="0bda", ATTRS{idProduct}=="d723", ATTR{power/autosuspend}="-1"' | sudo tee /etc/udev/rules.d/50-usb-bluetooth.rules
# 重启 udev 服务
sudo udevadm control --reload-rules5.5 文件传输失败
检查和修复:
# 检查 OBEX 服务
sudo systemctl status obex
# 安装 OBEX 工具
sudo apt-get install obexftp obex-data-server
# 启动 OBEX 服务
obex-data-server --auto-accept原文链接:
https://forum.shimetapi.cn/wiki/zh/fpga-arm/GM-3568JHF/Peripherals/ch05-%E8%93%9D%E7%89%99.html