bluetooth.h

Go to the documentation of this file.

#pragma once
 
#include "esp_err.h"
#include "esp_a2dp_api.h"     /* esp_a2d_source_data_cb_t for the audio data path */
#include "esp_gap_bt_api.h"   /* esp_bd_addr_t, ESP_BT_GAP_MAX_BDNAME_LEN */
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>


esp_err_t bluetooth_init(void);

esp_err_t bluetooth_shutdown(void);

void bluetooth_set_auto_shutdown(bool enable);

esp_err_t bluetooth_load_known(void);

#define BLUETOOTH_MAX_DEVICES 16

typedef struct {
    esp_bd_addr_t bda;                              
    char          name[ESP_BT_GAP_MAX_BDNAME_LEN + 1]; 
    int8_t        rssi;                             
} bluetooth_device_t;

esp_err_t bluetooth_scan_start(void);

esp_err_t bluetooth_scan_stop(void);

bool bluetooth_is_scanning(void);

bool bluetooth_is_powered(void);

size_t bluetooth_get_devices(bluetooth_device_t *out, size_t cap);

esp_err_t bluetooth_connect(const esp_bd_addr_t bda);

esp_err_t bluetooth_connect_by_name(const char *name_substr);

esp_err_t bluetooth_disconnect(void);

bool bluetooth_is_connected(void);

typedef enum {
    BLUETOOTH_CONN_IDLE,        
    BLUETOOTH_CONN_CONNECTING,  
    BLUETOOTH_CONN_CONNECTED,   
    BLUETOOTH_CONN_FAILED,      
} bluetooth_conn_state_t;

bluetooth_conn_state_t bluetooth_get_conn_state(void);

typedef struct {
    esp_bd_addr_t bda;                                 
    char          name[ESP_BT_GAP_MAX_BDNAME_LEN + 1]; 
} bt_known_device_t;

#define BLUETOOTH_MAX_KNOWN 8

size_t bluetooth_get_known_devices(bt_known_device_t *out, size_t cap);

bool bluetooth_get_last_device(bt_known_device_t *out);

void bluetooth_set_last_device(const bt_known_device_t *dev);

esp_err_t bluetooth_reconnect_last(void);

esp_err_t bluetooth_forget_device(const esp_bd_addr_t bda);

esp_err_t bluetooth_audio_start(esp_a2d_source_data_cb_t pcm_cb);

esp_err_t bluetooth_audio_stop(void);

esp_err_t bluetooth_set_absolute_volume(uint8_t volume);

bool bluetooth_is_avrc_connected(void);

bool bluetooth_volume_acked(void);