[嵌入式]ESP32 Bluedroid蓝牙main device API函数介绍

零. 声明

本专栏文章我们会以连载的方式持续更新，本专栏计划更新内容如下：

第一篇：ESP-IDF基本介绍，主要会涉及模组，芯片，开发板的介绍，环境搭建，程序编译下载，启动流程等一些基本的操作，让你对ESP-IDF开发有一个总体的认识，比我们后续学习打下基础！

第二篇：ESP32-IDF外设驱动介绍，主要会根据esp-idf现有的driver，提供各个外设的驱动，比如LED,OLED,SPI LCD,TOUCH,红外,Codec ic等等，在这一篇中，我们不仅仅来做外设驱动，还会对常用的外设总线做一个介绍，让大家知其然又知其所以然！

第三篇：目前比较火热的GUI LVGL介绍，主要会设计LVGL7.1,LVGL8的移植介绍,并且也会介绍各个组件，知道原理后，最后，我们会推出一款组态软件来构建我们的GUI，来提升我们的效率！

第四篇：ESP32-蓝牙，熟悉我的，应该都知道，我即使从事蓝牙协议栈的开发的，所以这个是我们独有的优势，在这一篇章，我们会提供不仅仅是蓝牙应用方法的知识，也会应用结合蓝牙底层协议栈的理论，让你彻底从上到下打通蓝牙任督二脉！

第五篇：Wi-Fi介绍，熟悉我的，应该也知道，我们也做过一款sdio wifi的驱动教程板子，所以在wifi这方面我们也是有独有的优势，在这一篇章，我们同样不仅仅提供Wi-Fi应用方面的知识，也会结合底层理论，让你对Wi-Fi有一个清晰的认知！

第六篇：FreeRTOS介绍，主要介绍下FreeRTOS各个功能(任务管理/消息队列/信号量/互斥量/事件/软件定时器/任务通知/内存管理/中断管理等)的使用以及运作机制。

第七篇：Arduino介绍，主要介绍ESP32 Arduino的基本操作(环境搭建,烧录,下载等开发流程)，以及介绍下基于Arduino的外设，蓝牙，wifi的使用。

第八篇：Demo，此篇章是融会贯通以上章节，做一些综合性的demo，让你巩固以上篇章的同时，还能学到实际项目！！

另外，我们的教程包括但是不局限于以上篇章，为了给你一个更好的导航，以下信息尤其重要，请详细查看！！

------------------------------------------------------------------------------------------------------------------------------------------

购买开发板(点击我)

文档目录(点击我)

Github代码仓库(点击我)

蓝牙交流扣扣群：539357317

微信公众号↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

------------------------------------------------------------------------------------------------------------------------------------------

一.介绍

之前我们看过我们写的文章，ESP32可以用Bluedroid跟Nimble作为蓝牙Host,如下图所示：

我们本章主要讲解Bluedroid Host的common API！官网连接为：

BT MAIN API - ESP32 - — ESP-IDF 编程指南 v4.4.1 文档

BT DEVICE APIs - ESP32 - — ESP-IDF 编程指南 v4.4.1 文档

二.Bluedtooth Main

在这个头文件中：bt/host/bluedroid/api/include/api/esp_bt_main.h

esp_bluedroid_status_t esp_bluedroid_get_status(void)

作用：获取蓝牙Host的状态

esp_err_t esp_bluedroid_enable(void)

作用：Enable bt host bluedroid ，必须在esp_bluedroid_init之后调用

esp_err_t esp_bluedroid_disable(void)

作用：Disable bt host bluedroid,必须在esp_bluedroid_deinit之前调用

esp_err_t esp_bluedroid_init(void)

作用：Init bt host bluedroid,必须在所有蓝牙操作之前调用

esp_err_t esp_bluedroid_deinit(void)

作用：Deinit bt host bluedroid，必须在所有蓝牙操作之后调用

整个流程如下：

其实我们做enable很简单，只是调用几个API就行，下面我们来展示下代码(附带之前小节controller API的代码)

ESP_LOGI(DEBUG_TAG, "Hello everybody,This is wireless link classical bluetooth hfp hf role project\n");
    esp_err_t ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND)
    {
        ESP_ERROR_CHECK(nvs_flash_erase());
        ret = nvs_flash_init();
    }
    ESP_ERROR_CHECK( ret );

    esp_bt_controller_config_t bt_cfg = BT_CONTROLLER_INIT_CONFIG_DEFAULT();
    if ((ret = esp_bt_controller_init(&bt_cfg)) != ESP_OK)
    {
        ESP_LOGE(DEBUG_TAG, "%s initialize controller failed: %s\n", __func__, esp_err_to_name(ret));
        return;
    }

    if ((ret = esp_bt_controller_enable(ESP_BT_MODE_BTDM)) != ESP_OK)
    {
        ESP_LOGE(DEBUG_TAG, "%s enable controller failed: %s\n", __func__, esp_err_to_name(ret));
        return;
    }

    ESP_LOGI(DEBUG_TAG, "Controller enable success\n");

    if ((ret = esp_bluedroid_init()) != ESP_OK) 
	{
        ESP_LOGE(DEBUG_TAG, "%s initialize bluedroid failed: %s\n", __func__, esp_err_to_name(ret));
        return;
    }

    if ((ret = esp_bluedroid_enable()) != ESP_OK) 
	{
        ESP_LOGE(DEBUG_TAG, "%s enable bluedroid failed: %s\n", __func__, esp_err_to_name(ret));
        return;
    }

三.Bluedtoot Device

在这个头文件中：bt/host/bluedroid/api/include/api/esp_bt_device.h

const uint8_t *esp_bt_dev_get_address(void)

作用：获取Local的蓝牙地址，必须在esp_bluedroid_enable后使用

esp_err_t esp_bt_dev_set_device_name(const char *name)

作用：设置Local的蓝牙地址，必须在esp_bluedroid_enable之后调用

创作打卡挑战赛

赢取流量/现金/CSDN周边激励大奖