component/bt : add macro for adv_data_flag

1. add macro for adv data flag
2. add docs for doxygen

diff --git a/components/bt/bluedroid/api/include/esp_gap_ble_api.h b/components/bt/bluedroid/api/include/esp_gap_ble_api.h
index f500f8403140016f4fa52a014f8dfaebb9af2b36..f92143e6af859f5e2da391df34b4ee8994d353c0 100644 (file)
--- a/components/bt/bluedroid/api/include/esp_gap_ble_api.h
+++ b/components/bt/bluedroid/api/include/esp_gap_ble_api.h
@@ -25,6 +25,19 @@
 extern "C" {
 #endif
 
+/**@{
+ * BLE_ADV_DATA_FLAG data flag bit definition used for advertising data flag
+ */
+#define ESP_BLE_ADV_FLAG_LIMIT_DISC         (0x01 << 0)
+#define ESP_BLE_ADV_FLAG_GEN_DISC           (0x01 << 1)
+#define ESP_BLE_ADV_FLAG_BREDR_NOT_SPT      (0x01 << 2)
+#define ESP_BLE_ADV_FLAG_DMT_CONTROLLER_SPT (0x01 << 3)
+#define ESP_BLE_ADV_FLAG_DMT_HOST_SPT       (0x01 << 4)
+#define ESP_BLE_ADV_FLAG_NON_LIMIT_DISC     (0x00 )
+/**
+ * @}
+ */
+
 /// GAP BLE callback event type
 typedef enum {
        ESP_GAP_BLE_ADV_DATA_SET_COMPLETE_EVT        = 0,               /*!< When advertising data set complete, the event comes */
@@ -126,7 +139,7 @@ typedef struct {
     uint8_t                 *p_service_data;           /*!< Service data point */
     uint16_t                service_uuid_len;          /*!< Service uuid length */
     uint8_t                 *p_service_uuid;           /*!< Service uuid array point */
-    uint8_t                 flag;                                      /*!< Advertising flag of discovery mode */
+    uint8_t                 flag;                                      /*!< Advertising flag of discovery mode, see BLE_ADV_DATA_FLAG detail */
 } esp_ble_adv_data_t;
 
 /// Own BD address source of the device

diff --git a/docs/api/esp_gap_ble.rst b/docs/api/esp_gap_ble.rst
index f16fa0da14237acc88ced5b594bffe3d8b1c6ae6..856ed273025cc7a5c6847332f80d3b3d34d27dd5 100644 (file)
--- a/docs/api/esp_gap_ble.rst
+++ b/docs/api/esp_gap_ble.rst
@@ -33,6 +33,12 @@ Header Files
 Macros
 ^^^^^^
 
+.. doxygendefine:: ESP_BLE_ADV_FLAG_LIMIT_DISC
+.. doxygendefine:: ESP_BLE_ADV_FLAG_GEN_DISC
+.. doxygendefine:: ESP_BLE_ADV_FLAG_BREDR_NOT_SPT
+.. doxygendefine:: ESP_BLE_ADV_FLAG_DMT_CONTROLLER_SPT
+.. doxygendefine:: ESP_BLE_ADV_FLAG_DMT_HOST_SPT
+.. doxygendefine:: ESP_BLE_ADV_FLAG_NON_LIMIT_DISC
 .. doxygendefine:: ESP_BLE_ADV_DATA_LEN_MAX
 
 Type Definitions

diff --git a/examples/14_gatt_server/main/gatts_demo.c b/examples/14_gatt_server/main/gatts_demo.c
index 58deadc5c9fb822931a314827edb5420ce4bc875..cf9a5789b4e9374fb0f0a68e9e40e3b0985a80a7 100644 (file)
--- a/examples/14_gatt_server/main/gatts_demo.c
+++ b/examples/14_gatt_server/main/gatts_demo.c
@@ -68,7 +68,7 @@ static esp_ble_adv_data_t test_adv_data = {
     .p_service_data = NULL,
     .service_uuid_len = 32,
     .p_service_uuid = test_service_uuid128,
-    .flag = 0x6,
+    .flag = (ESP_BLE_ADV_FLAG_GEN_DISC | ESP_BLE_ADV_FLAG_BREDR_NOT_SPT),
 };
 
 static esp_ble_adv_params_t test_adv_params = {