ESP32 Bluedroid蓝牙main device API函数介绍

Posted 2022-05-05 Wireless_Link

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了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_bluedroid_status_t

typedef enum

ESP_BLUEDROID_STATUS_UNINITIALIZED = 0, /*!< Bluetooth not initialized */

ESP_BLUEDROID_STATUS_INITIALIZED, /*!< Bluetooth initialized but not enabled */

ESP_BLUEDROID_STATUS_ENABLED /*!< Bluetooth initialized and enabled */

esp_bluedroid_status_t;

esp_err_t esp_bluedroid_enable(void)

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

返回值：esp_err_t

typedef int esp_err_t;

/* Definitions for error constants. */

#define ESP_OK 0 /*!< esp_err_t value indicating success (no error) */

#define ESP_FAIL -1 /*!< Generic esp_err_t code indicating failure */

#define ESP_ERR_NO_MEM 0x101 /*!< Out of memory */

#define ESP_ERR_INVALID_ARG 0x102 /*!< Invalid argument */

#define ESP_ERR_INVALID_STATE 0x103 /*!< Invalid state */

#define ESP_ERR_INVALID_SIZE 0x104 /*!< Invalid size */

#define ESP_ERR_NOT_FOUND 0x105 /*!< Requested resource not found */

#define ESP_ERR_NOT_SUPPORTED 0x106 /*!< Operation or feature not supported */

#define ESP_ERR_TIMEOUT 0x107 /*!< Operation timed out */

#define ESP_ERR_INVALID_RESPONSE 0x108 /*!< Received response was invalid */

#define ESP_ERR_INVALID_CRC 0x109 /*!< CRC or checksum was invalid */

#define ESP_ERR_INVALID_VERSION 0x10A /*!< Version was invalid */

#define ESP_ERR_INVALID_MAC 0x10B /*!< MAC address was invalid */

#define ESP_ERR_WIFI_BASE 0x3000 /*!< Starting number of WiFi error codes */

#define ESP_ERR_MESH_BASE 0x4000 /*!< Starting number of MESH error codes */

#define ESP_ERR_FLASH_BASE 0x6000 /*!< Starting number of flash error codes */

#define ESP_ERR_HW_CRYPTO_BASE 0xc000 /*!< Starting number of HW cryptography module error codes */

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;