Home | History | Annotate | Download | only in include
      1 /******************************************************************************
      2  *
      3  *  Copyright (C) 2015 The Android Open Source Project
      4  *
      5  *  Licensed under the Apache License, Version 2.0 (the "License");
      6  *  you may not use this file except in compliance with the License.
      7  *  You may obtain a copy of the License at:
      8  *
      9  *  http://www.apache.org/licenses/LICENSE-2.0
     10  *
     11  *  Unless required by applicable law or agreed to in writing, software
     12  *  distributed under the License is distributed on an "AS IS" BASIS,
     13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     14  *  See the License for the specific language governing permissions and
     15  *  limitations under the License.
     16  *
     17  ******************************************************************************/
     18 
     19 /******************************************************************************
     20  *
     21  *  This is the public interface file for the BTA SDP I/F
     22  *
     23  ******************************************************************************/
     24 #ifndef BTA_SDP_API_H
     25 #define BTA_SDP_API_H
     26 
     27 #include <hardware/bt_sdp.h>
     28 
     29 #include "bt_target.h"
     30 #include "bt_types.h"
     31 #include "bta_api.h"
     32 #include "btm_api.h"
     33 
     34 /* status values */
     35 #define BTA_SDP_SUCCESS 0 /* Successful operation. */
     36 #define BTA_SDP_FAILURE 1 /* Generic failure. */
     37 #define BTA_SDP_BUSY 2    /* Temporarily can not handle this request. */
     38 
     39 typedef uint8_t tBTA_SDP_STATUS;
     40 
     41 /* SDP I/F callback events */
     42 /* events received by tBTA_SDP_DM_CBACK */
     43 #define BTA_SDP_ENABLE_EVT 0             /* SDP service i/f enabled*/
     44 #define BTA_SDP_SEARCH_EVT 1             /* SDP Service started */
     45 #define BTA_SDP_SEARCH_COMP_EVT 2        /* SDP search complete */
     46 #define BTA_SDP_CREATE_RECORD_USER_EVT 3 /* SDP search complete */
     47 #define BTA_SDP_REMOVE_RECORD_USER_EVT 4 /* SDP search complete */
     48 #define BTA_SDP_MAX_EVT 5                /* max number of SDP events */
     49 
     50 #define BTA_SDP_MAX_RECORDS 15
     51 
     52 typedef uint16_t tBTA_SDP_EVT;
     53 
     54 /* data associated with BTA_SDP_DISCOVERY_COMP_EVT */
     55 typedef struct {
     56   tBTA_SDP_STATUS status;
     57   BD_ADDR remote_addr;
     58   tBT_UUID uuid;
     59   int record_count;
     60   bluetooth_sdp_record records[BTA_SDP_MAX_RECORDS];
     61 } tBTA_SDP_SEARCH_COMP;
     62 
     63 typedef union {
     64   tBTA_SDP_STATUS status;               /* BTA_SDP_SEARCH_EVT */
     65   tBTA_SDP_SEARCH_COMP sdp_search_comp; /* BTA_SDP_SEARCH_COMP_EVT */
     66 } tBTA_SDP;
     67 
     68 /* SDP DM Interface callback */
     69 typedef void(tBTA_SDP_DM_CBACK)(tBTA_SDP_EVT event, tBTA_SDP* p_data,
     70                                 void* user_data);
     71 
     72 /* MCE configuration structure */
     73 typedef struct {
     74   uint16_t sdp_db_size;        /* The size of p_sdp_db */
     75   tSDP_DISCOVERY_DB* p_sdp_db; /* The data buffer to keep SDP database */
     76 } tBTA_SDP_CFG;
     77 
     78 /*******************************************************************************
     79  *
     80  * Function         BTA_SdpEnable
     81  *
     82  * Description      Enable the SDP I/F service. When the enable
     83  *                  operation is complete the callback function will be
     84  *                  called with a BTA_SDP_ENABLE_EVT. This function must
     85  *                  be called before other functions in the MCE API are
     86  *                  called.
     87  *
     88  * Returns          BTA_SDP_SUCCESS if successful.
     89  *                  BTA_SDP_FAIL if internal failure.
     90  *
     91  ******************************************************************************/
     92 extern tBTA_SDP_STATUS BTA_SdpEnable(tBTA_SDP_DM_CBACK* p_cback);
     93 
     94 /*******************************************************************************
     95  *
     96  * Function         BTA_SdpSearch
     97  *
     98  * Description      Start a search for sdp records for a specific BD_ADDR with a
     99  *                  specific profile uuid.
    100  *                  When the search operation is completed, the callback
    101  *                  function will be called with a BTA_SDP_SEARCH_EVT.
    102  * Returns          BTA_SDP_SUCCESS if successful.
    103  *                  BTA_SDP_FAIL if internal failure.
    104  *
    105  ******************************************************************************/
    106 extern tBTA_SDP_STATUS BTA_SdpSearch(BD_ADDR bd_addr, tSDP_UUID* uuid);
    107 
    108 /*******************************************************************************
    109  *
    110  * Function         BTA_SdpCreateRecordByUser
    111  *
    112  * Description      This function is used to request a callback to create a SDP
    113  *                  record. The registered callback will be called with event
    114  *                  BTA_SDP_CREATE_RECORD_USER_EVT.
    115  *
    116  * Returns          BTA_SDP_SUCCESS, if the request is being processed.
    117  *                  BTA_SDP_FAILURE, otherwise.
    118  *
    119  ******************************************************************************/
    120 extern tBTA_SDP_STATUS BTA_SdpCreateRecordByUser(void* user_data);
    121 
    122 /*******************************************************************************
    123  *
    124  * Function         BTA_SdpRemoveRecordByUser
    125  *
    126  * Description      This function is used to request a callback to remove a SDP
    127  *                  record. The registered callback will be called with event
    128  *                  BTA_SDP_REMOVE_RECORD_USER_EVT.
    129  *
    130  * Returns          BTA_SDP_SUCCESS, if the request is being processed.
    131  *                  BTA_SDP_FAILURE, otherwise.
    132  *
    133  ******************************************************************************/
    134 extern tBTA_SDP_STATUS BTA_SdpRemoveRecordByUser(void* user_data);
    135 
    136 #endif /* BTA_SDP_API_H */
    137