# 入门指南

Source: [https://docs.qualcomm.com/doc/80-70017-13SC/topic/get-started.html](https://docs.qualcomm.com/doc/80-70017-13SC/topic/get-started.html)

Qualcomm Linux 蓝牙解决方案包括 BlueZ 协议栈和示例测试应用程序。这些应用程序与 BlueZ 堆栈的蓝牙守护程序交互以运行蓝牙功能。

Qualcomm Linux 支持 BlueZ 堆栈的以下示例应用程序：

- bluetoothctl
- obexctl
- ofono
- evtool

以下工作流显示了如何使用示例应用程序开始验证蓝牙功能。

![](data:image/png;base64,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)

完成工作流程的顺序如下：

1. 应按照 [Qualcomm Linux 编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254)和 [Qualcomm Linux Yocto 指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-27)所述搭建架构。[Qualcomm Linux
                    编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254)还提供了有关常见编译工作流程的信息。
2. 运行示例应用程序并验证蓝牙功能，如[验证 BlueZ 堆栈的功能](https://docs.qualcomm.com/doc/80-70017-13SC/topic/verify-bluetooth-functionality-of-bluez-stack.html)中所述。
3. 如果出现任何问题，请按照[调试](https://docs.qualcomm.com/doc/80-70017-13SC/topic/bt_debugging.html)中的说明进行记录并调试。

## 设置蓝牙 MAC 地址

默认情况下，工厂会在一次性可编程存储器中设置蓝牙 MAC 地址。如果您想手动设置蓝牙 MAC 地址，请完成以下步骤。

注释： 手动设置的蓝牙 MAC 地址在设备重新启动后不会保留。

**前提条件**

- 启用 SSH 以访问您的主机设备。相关说明，可参见[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh)。
- [关闭设备上的蓝牙。](https://docs.qualcomm.com/doc/80-70017-13SC/topic/bluez-perform-bluetooth-gap-functions.html#bluez-perform-bluetooth-gap-functions__section_s3x_z1s_lcc_navyanka_08-21-24-1205-42-982)

**步骤**

1. 在命令提示符下使用以下命令运行 SSH： 

        ssh root@<device_IP_address>Copy to clipboard

    **示例**

如果设备的 IP 地址为 `10.92.160.222`，则运行以下命令：

        ssh root@10.92.160.222Copy to clipboard
2. 输入以下密码来连接 SSH： 

        oelinux123Copy to clipboard
3. 打开蓝牙管理工具并通过运行以下命令设置蓝牙地址：

        btmgmt public-addr <bt_address>Copy to clipboard

例如，请运行以下命令，将设备的蓝牙地址设置为 `22:22:9B:2C:79:1E`：

        btmgmt public-addr 22:22:9B:2C:79:1ECopy to clipboard

    **示例输出**

sh-5.1# btmgmt public-addr 22:22:9B:2C:79:1E
        hci0 Set Public Address complete, options:
        sh-5.1# hciconfig
        hci0:     Type: Primary Bus: UART    
                  BD Address: 22:22:9B:2C:79:1E ACL MTU: 1024:7 SCO MTU: 240:8
                  DOWN
                  RX bytes: 7763 acl:0 sco:0 events:364 errors:0
                  TX bytes: 938685 acl:0 sco:0 commands:4004 errors:0Copy to clipboard

## 源代码位置

下表列出了蓝牙组件（例如协议栈、示例测试应用程序和驱动程序）的源代码位置。

| 组件 | 源代码位置 |
| --- | --- |
| bluetoothctl | [https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools](https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools) |
| obexctl | [https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools](https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/tools) |
| ofono | [https://git.kernel.org/pub/scm/network/ofono/ofono.git](https://git.kernel.org/pub/scm/network/ofono/ofono.git) |
| BlueZ 协议栈 | <ul class="ul" id="get-started__ul_sh3_4zf_ncc_navyanka_08-26-24-2355-37-544"><br>                                    <li class="li"><br>                                        <p class="p">BlueZ 的 git 代码仓库位于：<a href="https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/')">https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/</a></p><br><br>                                    </li><br><br>                                    <li class="li">可以在 <a href="https://mirrors.edge.kernel.org/pub/linux/bluetooth/bluez-5.65.tar.gz" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://mirrors.edge.kernel.org/pub/linux/bluetooth/bluez-5.65.tar.gz')">https://mirrors.edge.kernel.org/pub/linux/bluetooth/bluez-5.65.tar.gz</a> 下载该堆栈：</li><br><br>                                    <li class="li">蓝牙内核子系统的 git 代码仓库位于：<ul class="ul" id="get-started__ul_zpf_rzf_ncc_navyanka_08-26-24-2356-28-459"><br>                                            <li class="li"><a href="https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth.git/tree/" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth.git/tree/')">https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth.git/tree/</a></li><br><br>                                            <li class="li"><a href="https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/')">https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/</a></li><br><br>                                        </ul><br></li><br><br>                                </ul> |
| 蓝牙驱动程序 | 可以从以下位置下载蓝牙驱动程序：<br><ul class="ul" id="get-started__ul_hkl_thq_mcc_navyanka_08-24-24-2009-41-311"><br>                                    <li class="li"><a href="https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/hci_qca.c" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/hci_qca.c')">https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/hci_qca.c</a></li><br><br>                                    <li class="li"><a href="https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/btqca.c" target="_blank" class="xref cursorpointer" onclick="Window.BookmapComponent.navigateExternalFile('https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/btqca.c')">https://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git/tree/drivers/bluetooth/btqca.c</a></li><br><br>                                </ul> |

Last Published: Jan 23, 2025

[Previous Topic
概述](https://docs.qualcomm.com/bundle/publicresource/80-70017-13SC/topics/introduction.md) [Next Topic
功能](https://docs.qualcomm.com/bundle/publicresource/80-70017-13SC/topics/bt_ft_overview.md)