| /****************************************************************************** |
| * |
| * Copyright 1999-2012 Broadcom Corporation |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at: |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| * |
| ******************************************************************************/ |
| |
| #pragma once |
| |
| #include <base/strings/stringprintf.h> |
| |
| #include <cstdint> |
| |
| #include "bt_target.h" |
| #include "sdpdefs.h" |
| #include "types/bluetooth/uuid.h" |
| #include "types/raw_address.h" |
| |
| /***************************************************************************** |
| * Constants |
| ****************************************************************************/ |
| |
| /* Success code and error codes */ |
| typedef enum : uint16_t { |
| SDP_SUCCESS = 0x0000, |
| SDP_INVALID_VERSION = 0x0001, |
| SDP_INVALID_SERV_REC_HDL = 0x0002, |
| SDP_INVALID_REQ_SYNTAX = 0x0003, |
| SDP_INVALID_PDU_SIZE = 0x0004, |
| SDP_INVALID_CONT_STATE = 0x0005, |
| SDP_NO_RESOURCES = 0x0006, |
| SDP_DI_REG_FAILED = 0x0007, |
| SDP_DI_DISC_FAILED = 0x0008, |
| SDP_NO_DI_RECORD_FOUND = 0x0009, |
| SDP_ERR_ATTR_NOT_PRESENT = 0x000A, |
| SDP_ILLEGAL_PARAMETER = 0x000B, |
| |
| HID_SDP_NO_SERV_UUID = (SDP_ILLEGAL_PARAMETER + 1), |
| HID_SDP_MANDATORY_MISSING, |
| |
| SDP_NO_RECS_MATCH = 0xFFF0, |
| SDP_CONN_FAILED = 0xFFF1, |
| SDP_CFG_FAILED = 0xFFF2, |
| SDP_GENERIC_ERROR = 0xFFF3, |
| SDP_DB_FULL = 0xFFF4, |
| SDP_CANCEL = 0xFFF8, |
| } tSDP_STATUS; |
| using tSDP_RESULT = tSDP_STATUS; |
| using tSDP_REASON = tSDP_STATUS; |
| |
| #define CASE_RETURN_TEXT(code) \ |
| case code: \ |
| return #code |
| |
| inline std::string sdp_status_text(const tSDP_STATUS& status) { |
| switch (status) { |
| CASE_RETURN_TEXT(SDP_SUCCESS); |
| CASE_RETURN_TEXT(SDP_INVALID_VERSION); |
| CASE_RETURN_TEXT(SDP_INVALID_SERV_REC_HDL); |
| CASE_RETURN_TEXT(SDP_INVALID_REQ_SYNTAX); |
| CASE_RETURN_TEXT(SDP_INVALID_PDU_SIZE); |
| CASE_RETURN_TEXT(SDP_INVALID_CONT_STATE); |
| CASE_RETURN_TEXT(SDP_NO_RESOURCES); |
| CASE_RETURN_TEXT(SDP_DI_REG_FAILED); |
| CASE_RETURN_TEXT(SDP_DI_DISC_FAILED); |
| CASE_RETURN_TEXT(SDP_NO_DI_RECORD_FOUND); |
| CASE_RETURN_TEXT(SDP_ERR_ATTR_NOT_PRESENT); |
| CASE_RETURN_TEXT(SDP_ILLEGAL_PARAMETER); |
| |
| CASE_RETURN_TEXT(HID_SDP_NO_SERV_UUID); |
| CASE_RETURN_TEXT(HID_SDP_MANDATORY_MISSING); |
| |
| CASE_RETURN_TEXT(SDP_NO_RECS_MATCH); |
| CASE_RETURN_TEXT(SDP_CONN_FAILED); |
| CASE_RETURN_TEXT(SDP_CFG_FAILED); |
| CASE_RETURN_TEXT(SDP_GENERIC_ERROR); |
| CASE_RETURN_TEXT(SDP_DB_FULL); |
| CASE_RETURN_TEXT(SDP_CANCEL); |
| default: |
| return base::StringPrintf("UNKNOWN[%hu]", status); |
| } |
| } |
| const auto sdp_result_text = sdp_status_text; |
| |
| #undef CASE_RETURN_TEXT |
| |
| /* Masks for attr_value field of tSDP_DISC_ATTR */ |
| #define SDP_DISC_ATTR_LEN_MASK 0x0FFF |
| #define SDP_DISC_ATTR_TYPE(len_type) ((len_type) >> 12) |
| #define SDP_DISC_ATTR_LEN(len_type) ((len_type)&SDP_DISC_ATTR_LEN_MASK) |
| |
| /* Maximum number of protocol list items (list_elem in tSDP_PROTOCOL_ELEM) */ |
| #define SDP_MAX_LIST_ELEMS 3 |
| |
| /***************************************************************************** |
| * Type Definitions |
| ****************************************************************************/ |
| |
| /* Define a callback function for when discovery is complete. */ |
| typedef void(tSDP_DISC_CMPL_CB)(tSDP_RESULT result); |
| typedef void(tSDP_DISC_CMPL_CB2)(tSDP_RESULT result, const void* user_data); |
| |
| typedef struct { |
| RawAddress peer_addr; |
| uint16_t peer_mtu; |
| } tSDP_DR_OPEN; |
| |
| typedef struct { |
| uint8_t* p_data; |
| uint16_t data_len; |
| } tSDP_DR_DATA; |
| |
| typedef union { |
| tSDP_DR_OPEN open; |
| tSDP_DR_DATA data; |
| } tSDP_DATA; |
| |
| /* Define a structure to hold the discovered service information. */ |
| typedef struct { |
| union { |
| uint8_t u8; /* 8-bit integer */ |
| uint16_t u16; /* 16-bit integer */ |
| uint32_t u32; /* 32-bit integer */ |
| struct t_sdp_disc_attr* p_sub_attr; /* Addr of first sub-attr (list)*/ |
| uint8_t array[]; /* Variable length field */ |
| /* flexible array member */ |
| /* requiring backing store */ |
| /* from SDP DB */ |
| } v; |
| |
| } tSDP_DISC_ATVAL; |
| |
| typedef struct t_sdp_disc_attr { |
| struct t_sdp_disc_attr* p_next_attr; /* Addr of next linked attr */ |
| uint16_t attr_id; /* Attribute ID */ |
| uint16_t attr_len_type; /* Length and type fields */ |
| tSDP_DISC_ATVAL attr_value; /* Variable length entry data */ |
| } tSDP_DISC_ATTR; |
| |
| typedef struct t_sdp_disc_rec { |
| tSDP_DISC_ATTR* p_first_attr; /* First attribute of record */ |
| struct t_sdp_disc_rec* p_next_rec; /* Addr of next linked record */ |
| uint32_t time_read; /* The time the record was read */ |
| RawAddress remote_bd_addr; /* Remote BD address */ |
| } tSDP_DISC_REC; |
| |
| typedef struct { |
| uint32_t mem_size; /* Memory size of the DB */ |
| uint32_t mem_free; /* Memory still available */ |
| tSDP_DISC_REC* p_first_rec; /* Addr of first record in DB */ |
| uint16_t num_uuid_filters; /* Number of UUIds to filter */ |
| bluetooth::Uuid uuid_filters[SDP_MAX_UUID_FILTERS]; /* UUIDs to filter */ |
| uint16_t num_attr_filters; /* Number of attribute filters */ |
| uint16_t attr_filters[SDP_MAX_ATTR_FILTERS]; /* Attributes to filter */ |
| uint8_t* p_free_mem; /* Pointer to free memory */ |
| uint8_t* |
| raw_data; /* Received record from server. allocated/released by client */ |
| uint32_t raw_size; /* size of raw_data */ |
| uint32_t raw_used; /* length of raw_data used */ |
| } tSDP_DISCOVERY_DB; |
| |
| /* This structure is used to add protocol lists and find protocol elements */ |
| typedef struct { |
| uint16_t protocol_uuid; |
| uint16_t num_params; |
| uint16_t params[SDP_MAX_PROTOCOL_PARAMS]; |
| } tSDP_PROTOCOL_ELEM; |
| |
| typedef struct { |
| uint16_t num_elems; |
| tSDP_PROTOCOL_ELEM list_elem[SDP_MAX_LIST_ELEMS]; |
| } tSDP_PROTO_LIST_ELEM; |
| |
| /* Device Identification (DI) data structure |
| */ |
| /* Used to set the DI record */ |
| typedef struct t_sdp_di_record { |
| uint16_t vendor; |
| uint16_t vendor_id_source; |
| uint16_t product; |
| uint16_t version; |
| bool primary_record; |
| char client_executable_url[SDP_MAX_ATTR_LEN]; /* optional */ |
| char service_description[SDP_MAX_ATTR_LEN]; /* optional */ |
| char documentation_url[SDP_MAX_ATTR_LEN]; /* optional */ |
| } tSDP_DI_RECORD; |
| |
| /* Used to get the DI record */ |
| typedef struct t_sdp_di_get_record { |
| uint16_t spec_id; |
| tSDP_DI_RECORD rec; |
| } tSDP_DI_GET_RECORD; |
| |
| /* API into the SDP layer for service discovery. */ |
| |
| /******************************************************************************* |
| * |
| * Function SDP_InitDiscoveryDb |
| * |
| * Description This function is called to initialize a discovery database. |
| * |
| * Returns true if successful, false if one or more parameters are bad |
| * |
| ******************************************************************************/ |
| bool SDP_InitDiscoveryDb(tSDP_DISCOVERY_DB* p_db, uint32_t len, |
| uint16_t num_uuid, const bluetooth::Uuid* p_uuid_list, |
| uint16_t num_attr, const uint16_t* p_attr_list); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_CancelServiceSearch |
| * |
| * Description This function cancels an active query to an SDP server. |
| * |
| * Returns true if discovery cancelled, false if a matching activity is |
| * not found. |
| * |
| ******************************************************************************/ |
| bool SDP_CancelServiceSearch(const tSDP_DISCOVERY_DB* p_db); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_ServiceSearchRequest |
| * |
| * Description This function queries an SDP server for information. |
| * |
| * Returns true if discovery started, false if failed. |
| * |
| ******************************************************************************/ |
| bool SDP_ServiceSearchRequest(const RawAddress& p_bd_addr, |
| tSDP_DISCOVERY_DB* p_db, tSDP_DISC_CMPL_CB* p_cb); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_ServiceSearchAttributeRequest |
| * |
| * Description This function queries an SDP server for information. |
| * |
| * The difference between this API function and the function |
| * SDP_ServiceSearchRequest is that this one does a |
| * combined ServiceSearchAttributeRequest SDP function. |
| * |
| * Returns true if discovery started, false if failed. |
| * |
| ******************************************************************************/ |
| bool SDP_ServiceSearchAttributeRequest(const RawAddress& p_bd_addr, |
| tSDP_DISCOVERY_DB* p_db, |
| tSDP_DISC_CMPL_CB* p_cb); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_ServiceSearchAttributeRequest2 |
| * |
| * Description This function queries an SDP server for information. |
| * |
| * The difference between this API function and the function |
| * SDP_ServiceSearchRequest is that this one does a |
| * combined ServiceSearchAttributeRequest SDP function with the |
| * user data piggyback |
| * |
| * Returns true if discovery started, false if failed. |
| * |
| ******************************************************************************/ |
| bool SDP_ServiceSearchAttributeRequest2(const RawAddress& p_bd_addr, |
| tSDP_DISCOVERY_DB* p_db, |
| tSDP_DISC_CMPL_CB2* p_cb, |
| const void* user_data); |
| |
| /* API of utilities to find data in the local discovery database */ |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindAttributeInRec |
| * |
| * Description This function searches an SDP discovery record for a |
| * specific attribute. |
| * |
| * Returns Pointer to matching attribute entry, or NULL |
| * |
| ******************************************************************************/ |
| tSDP_DISC_ATTR* SDP_FindAttributeInRec(const tSDP_DISC_REC* p_rec, |
| uint16_t attr_id); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindServiceInDb |
| * |
| * Description This function queries an SDP database for a specific |
| * service. If the p_start_rec pointer is NULL, it looks from |
| * the beginning of the database, else it continues from the |
| * next record after p_start_rec. |
| * |
| * Returns Pointer to record containing service class, or NULL |
| * |
| ******************************************************************************/ |
| tSDP_DISC_REC* SDP_FindServiceInDb(const tSDP_DISCOVERY_DB* p_db, |
| uint16_t service_uuid, |
| tSDP_DISC_REC* p_start_rec); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindServiceUUIDInDb |
| * |
| * Description This function queries an SDP database for a specific |
| * service. If the p_start_rec pointer is NULL, it looks from |
| * the beginning of the database, else it continues from the |
| * next record after p_start_rec. |
| * |
| * NOTE the only difference between this function and the previous |
| * function "SDP_FindServiceInDb()" is that this function takes |
| * a Uuid input. |
| * |
| * Returns Pointer to record containing service class, or NULL |
| * |
| ******************************************************************************/ |
| tSDP_DISC_REC* SDP_FindServiceUUIDInDb(const tSDP_DISCOVERY_DB* p_db, |
| const bluetooth::Uuid& uuid, |
| tSDP_DISC_REC* p_start_rec); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindServiceUUIDInRec_128bit |
| * |
| * Description Read the 128-bit service UUID within a record, |
| * if there is any. |
| * |
| * Parameters: p_rec - pointer to a SDP record. |
| * p_uuid - output parameter to save the UUID found. |
| * |
| * Returns true if found, otherwise false. |
| * |
| ******************************************************************************/ |
| bool SDP_FindServiceUUIDInRec_128bit(const tSDP_DISC_REC* p_rec, |
| bluetooth::Uuid* p_uuid); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindServiceInDb_128bit |
| * |
| * Description Query an SDP database for a specific service. |
| * If the p_start_rec pointer is NULL, look from the beginning |
| * of the database, else continue from the next record after |
| * p_start_rec. |
| * |
| * Returns Pointer to record containing service class, or NULL |
| * |
| ******************************************************************************/ |
| tSDP_DISC_REC* SDP_FindServiceInDb_128bit(const tSDP_DISCOVERY_DB* p_db, |
| tSDP_DISC_REC* p_start_rec); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindProtocolListElemInRec |
| * |
| * Description This function looks at a specific discovery record for a |
| * protocol list element. |
| * |
| * Returns true if found, false if not |
| * If found, the passed protocol list element is filled in. |
| * |
| ******************************************************************************/ |
| bool SDP_FindProtocolListElemInRec(const tSDP_DISC_REC* p_rec, |
| uint16_t layer_uuid, |
| tSDP_PROTOCOL_ELEM* p_elem); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindProfileVersionInRec |
| * |
| * Description This function looks at a specific discovery record for the |
| * Profile list descriptor, and pulls out the version number. |
| * The version number consists of an 8-bit major version and |
| * an 8-bit minor version. |
| * |
| * Returns true if found, false if not |
| * If found, the major and minor version numbers that were |
| * passed in are filled in. |
| * |
| ******************************************************************************/ |
| bool SDP_FindProfileVersionInRec(const tSDP_DISC_REC* p_rec, |
| uint16_t profile_uuid, uint16_t* p_version); |
| |
| /* API into SDP for local service database updates */ |
| |
| /******************************************************************************* |
| * |
| * Function SDP_CreateRecord |
| * |
| * Description This function is called to create a record in the database. |
| * This would be through the SDP database maintenance API. The |
| * record is created empty, teh application should then call |
| * "add_attribute" to add the record's attributes. |
| * |
| * Returns Record handle if OK, else 0. |
| * |
| ******************************************************************************/ |
| uint32_t SDP_CreateRecord(void); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_DeleteRecord |
| * |
| * Description This function is called to add a record (or all records) |
| * from the database. This would be through the SDP database |
| * maintenance API. |
| * |
| * If a record handle of 0 is passed, all records are deleted. |
| * |
| * Returns true if succeeded, else false |
| * |
| ******************************************************************************/ |
| bool SDP_DeleteRecord(uint32_t handle); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddAttribute |
| * |
| * Description This function is called to add an attribute to a record. |
| * This would be through the SDP database maintenance API. |
| * If the attribute already exists in the record, it is |
| * replaced with the new value. |
| * |
| * NOTE Attribute values must be passed as a Big Endian stream. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddAttribute(uint32_t handle, uint16_t attr_id, uint8_t attr_type, |
| uint32_t attr_len, uint8_t* p_val); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddSequence |
| * |
| * Description This function is called to add a sequence to a record. |
| * This would be through the SDP database maintenance API. |
| * If the sequence already exists in the record, it is replaced |
| * with the new sequence. |
| * |
| * NOTE Element values must be passed as a Big Endian stream. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddSequence(uint32_t handle, uint16_t attr_id, uint16_t num_elem, |
| uint8_t type[], uint8_t len[], uint8_t* p_val[]); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddUuidSequence |
| * |
| * Description This function is called to add a UUID sequence to a record. |
| * This would be through the SDP database maintenance API. |
| * If the sequence already exists in the record, it is replaced |
| * with the new sequence. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddUuidSequence(uint32_t handle, uint16_t attr_id, uint16_t num_uuids, |
| uint16_t* p_uuids); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddProtocolList |
| * |
| * Description This function is called to add a protocol descriptor list to |
| * a record. This would be through the SDP database |
| * maintenance API. If the protocol list already exists in the |
| * record, it is replaced with the new list. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddProtocolList(uint32_t handle, uint16_t num_elem, |
| tSDP_PROTOCOL_ELEM* p_elem_list); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddAdditionProtoLists |
| * |
| * Description This function is called to add a protocol descriptor list to |
| * a record. This would be through the SDP database maintenance |
| * API. If the protocol list already exists in the record, it |
| * is replaced with the new list. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddAdditionProtoLists(uint32_t handle, uint16_t num_elem, |
| tSDP_PROTO_LIST_ELEM* p_proto_list); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddProfileDescriptorList |
| * |
| * Description This function is called to add a profile descriptor list to |
| * a record. This would be through the SDP database maintenance |
| * API. If the version already exists in the record, it is |
| * replaced with the new one. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddProfileDescriptorList(uint32_t handle, uint16_t profile_uuid, |
| uint16_t version); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddLanguageBaseAttrIDList |
| * |
| * Description This function is called to add a language base attr list to |
| * a record. This would be through the SDP database maintenance |
| * API. If the version already exists in the record, it is |
| * replaced with the new one. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddLanguageBaseAttrIDList(uint32_t handle, uint16_t lang, |
| uint16_t char_enc, uint16_t base_id); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_AddServiceClassIdList |
| * |
| * Description This function is called to add a service list to a record. |
| * This would be through the SDP database maintenance API. |
| * If the service list already exists in the record, it is |
| * replaced with the new list. |
| * |
| * Returns true if added OK, else false |
| * |
| ******************************************************************************/ |
| bool SDP_AddServiceClassIdList(uint32_t handle, uint16_t num_services, |
| uint16_t* p_service_uuids); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_DeleteAttribute |
| * |
| * Description Delete an attribute from a record. |
| * This would be through the SDP database maintenance API. |
| * |
| * Returns true if deleted OK, else false if not found |
| * |
| ******************************************************************************/ |
| bool SDP_DeleteAttribute(uint32_t handle, uint16_t attr_id); |
| |
| /* Device Identification APIs */ |
| |
| /******************************************************************************* |
| * |
| * Function SDP_SetLocalDiRecord |
| * |
| * Description This function adds a DI record to the local SDP database. |
| * |
| * Returns Returns SDP_SUCCESS if record added successfully, else error |
| * |
| ******************************************************************************/ |
| uint16_t SDP_SetLocalDiRecord(const tSDP_DI_RECORD* device_info, |
| uint32_t* p_handle); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_DiDiscover |
| * |
| * Description This function queries a remote device for DI information. |
| * |
| * Returns SDP_SUCCESS if query started successfully, else error |
| * |
| ******************************************************************************/ |
| tSDP_STATUS SDP_DiDiscover(const RawAddress& remote_device, |
| tSDP_DISCOVERY_DB* p_db, uint32_t len, |
| tSDP_DISC_CMPL_CB* p_cb); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_GetNumDiRecords |
| * |
| * Description Searches specified database for DI records |
| * |
| * Returns number of DI records found |
| * |
| ******************************************************************************/ |
| uint8_t SDP_GetNumDiRecords(const tSDP_DISCOVERY_DB* p_db); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_GetDiRecord |
| * |
| * Description This function retrieves a remote device's DI record from |
| * the specified database. |
| * |
| * Returns SDP_SUCCESS if record retrieved, else error |
| * |
| ******************************************************************************/ |
| uint16_t SDP_GetDiRecord(uint8_t getRecordIndex, |
| tSDP_DI_GET_RECORD* device_info, |
| const tSDP_DISCOVERY_DB* p_db); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_SetTraceLevel |
| * |
| * Description This function sets the trace level for SDP. If called with |
| * a value of 0xFF, it simply reads the current trace level. |
| * |
| * Returns the new (current) trace level |
| * |
| ******************************************************************************/ |
| uint8_t SDP_SetTraceLevel(uint8_t new_level); |
| |
| /******************************************************************************* |
| * |
| * Function SDP_FindServiceUUIDInRec |
| * |
| * Description Read the service UUID within a record, |
| * if there is any. |
| * |
| * Parameters: p_rec - pointer to a SDP record. |
| * p_uuid - pointer to a UUID |
| * |
| * Returns true if found, otherwise false. |
| * |
| ******************************************************************************/ |
| bool SDP_FindServiceUUIDInRec(const tSDP_DISC_REC* p_rec, |
| bluetooth::Uuid* p_uuid); |
| |
| namespace bluetooth { |
| namespace legacy { |
| namespace stack { |
| namespace sdp { |
| |
| struct tSdpApi { |
| struct { |
| /******************************************************************************* |
| Function SDP_InitDiscoveryDb |
| |
| Description This function is called to initialize a discovery |
| database. |
| |
| Parameters: p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| len - (input) size (in bytes) of the memory |
| NOTE: This must be larger than sizeof(tSDP_DISCOVERY_DB) |
| num_uuid - (input) number of UUID filters applied |
| p_uuid_list - (input) list of UUID filters |
| num_attr - (input) number of attribute filters |
| applied |
| p_attr_list - (input) list of attribute filters |
| |
| Returns true if successful, false if one or more parameters are |
| bad |
| ******************************************************************************/ |
| bool (*SDP_InitDiscoveryDb)(tSDP_DISCOVERY_DB*, uint32_t, uint16_t, |
| const bluetooth::Uuid*, uint16_t, |
| const uint16_t*); |
| |
| /******************************************************************************* |
| |
| Function SDP_CancelServiceSearch |
| |
| Description This function cancels an active query to an SDP server. |
| |
| Parameters: p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| |
| Returns true if discovery cancelled, false if a matching |
| activity is not found. |
| |
| ******************************************************************************/ |
| bool (*SDP_CancelServiceSearch)(const tSDP_DISCOVERY_DB*); |
| |
| /******************************************************************************* |
| |
| Function SDP_ServiceSearchRequest |
| |
| Description This function queries an SDP server for information. |
| |
| Parameters: p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| p_cb - (input) callback executed when complete |
| |
| Returns true if discovery started, false if failed. |
| |
| ******************************************************************************/ |
| bool (*SDP_ServiceSearchRequest)(const RawAddress&, tSDP_DISCOVERY_DB*, |
| tSDP_DISC_CMPL_CB*); |
| |
| /******************************************************************************* |
| |
| Function SDP_ServiceSearchAttributeRequest |
| |
| Description This function queries an SDP server for information. |
| |
| The difference between this API function and the |
| function SDP_ServiceSearchRequest is that this one does |
| a combined ServiceSearchAttributeRequest SDP function. |
| |
| Parameters: bd_addr - (input) device address for service search |
| p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| p_cb - (input) callback executed when complete |
| |
| Returns true if discovery started, false if failed. |
| |
| ******************************************************************************/ |
| bool (*SDP_ServiceSearchAttributeRequest)(const RawAddress&, |
| tSDP_DISCOVERY_DB*, |
| tSDP_DISC_CMPL_CB*); |
| |
| /******************************************************************************* |
| |
| Function SDP_ServiceSearchAttributeRequest2 |
| |
| Description This function queries an SDP server for information. |
| |
| The difference between this API function and the |
| function SDP_ServiceSearchRequest is that this one does |
| a combined ServiceSearchAttributeRequest SDP function |
| with the user data piggyback |
| |
| parameters: bd_addr - (input) device address for service search |
| p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| p_cb2 - (input) callback executed when complete |
| p_data - (input) user data |
| |
| Returns true if discovery started, false if failed. |
| |
| ******************************************************************************/ |
| bool (*SDP_ServiceSearchAttributeRequest2)(const RawAddress&, |
| tSDP_DISCOVERY_DB*, |
| tSDP_DISC_CMPL_CB2*, |
| const void*); |
| } service; |
| |
| struct { |
| /******************************************************************************* |
| |
| Function SDP_FindServiceInDb |
| |
| Description This function queries an SDP database for a specific |
| service. If the p_start_rec pointer is NULL, it looks |
| from the beginning of the database, else it continues |
| from the next record after p_start_rec. |
| |
| parameters: p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| uuid16 - (input) Uuid to search in db |
| disc_rec - (output) Record found, null otherwise |
| |
| Returns Pointer to record containing service class, or NULL |
| |
| ******************************************************************************/ |
| tSDP_DISC_REC* (*SDP_FindServiceInDb)(const tSDP_DISCOVERY_DB*, uint16_t, |
| tSDP_DISC_REC*); |
| |
| /******************************************************************************* |
| |
| Function SDP_FindServiceUUIDInDb |
| |
| Description This function queries an SDP database for a specific |
| service. If the p_start_rec pointer is NULL, it looks |
| from the beginning of the database, else it continues |
| from the next record after p_start_rec. |
| |
| NOTE the only difference between this function and the |
| previous function "SDP_FindServiceInDb()" is that this |
| function takes a Uuid input. |
| |
| parameters: p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| uuid - (input) Uuid to search in db |
| disc_rec - (input) Start record, null from beginning |
| |
| Returns Pointer to record containing service class, or NULL |
| |
| ******************************************************************************/ |
| tSDP_DISC_REC* (*SDP_FindServiceUUIDInDb)(const tSDP_DISCOVERY_DB*, |
| const bluetooth::Uuid&, |
| tSDP_DISC_REC*); |
| |
| /******************************************************************************* |
| |
| Function SDP_FindServiceInDb_128bit |
| |
| Description Query an SDP database for a specific service. |
| If the p_start_rec pointer is NULL, look from the |
| beginning of the database, else continue from the next |
| record after p_start_rec. |
| |
| parameters: p_db - (input) address of an area of memory where |
| the discovery database is managed. |
| disc_rec - (input) Start record, null from beginning |
| |
| Returns Pointer to record containing service class, or NULL |
| |
| ******************************************************************************/ |
| tSDP_DISC_REC* (*SDP_FindServiceInDb_128bit)(const tSDP_DISCOVERY_DB*, |
| tSDP_DISC_REC*); |
| } db; |
| |
| struct { |
| /******************************************************************************* |
| |
| Local discovery database API |
| |
| Function SDP_FindAttributeInRec |
| |
| Description This function searches an SDP discovery record for a |
| specific attribute. |
| |
| parameters: disc_rec - (input) Start record must not be null |
| attr_id - (input) Attribute id to search |
| |
| Returns Pointer to matching attribute entry, or NULL |
| |
| ******************************************************************************/ |
| tSDP_DISC_ATTR* (*SDP_FindAttributeInRec)(const tSDP_DISC_REC*, uint16_t); |
| |
| /******************************************************************************* |
| |
| Function SDP_FindServiceUUIDInRec_128bit |
| |
| Description Read the 128-bit service UUID within a record; |
| if there is any. |
| |
| Parameters: p_rec - (input) pointer to a SDP record. |
| p_uuid - (output) parameter to save the UUID found. |
| |
| Returns true if found, otherwise false. |
| |
| ******************************************************************************/ |
| bool (*SDP_FindServiceUUIDInRec_128bit)(const tSDP_DISC_REC*, |
| bluetooth::Uuid*); |
| |
| /******************************************************************************* |
| |
| Function SDP_FindProtocolListElemInRec |
| |
| Description This function looks at a specific discovery record for a |
| protocol list element. |
| |
| Parameters: p_rec - (input) pointer to a SDP record. |
| p_uuid - (input) layer UUID. |
| p_elem - (output) protocol element |
| |
| Returns true if found, false if not |
| If found, the passed protocol list element is filled in. |
| |
| ******************************************************************************/ |
| bool (*SDP_FindProtocolListElemInRec)(const tSDP_DISC_REC*, uint16_t, |
| tSDP_PROTOCOL_ELEM*); |
| |
| /******************************************************************************* |
| |
| Function SDP_FindProfileVersionInRec |
| |
| Description This function looks at a specific discovery record for |
| the Profile list descriptor, and pulls out the version |
| number. The version number consists of an 8-bit major |
| version and an 8-bit minor version. |
| |
| Parameters: p_rec - (input) pointer to a SDP record. |
| p_uuid - (input) profile UUID. |
| p_elem - (output) major and minor version numbers |
| |
| Returns true if found, false if not |
| |
| ******************************************************************************/ |
| bool (*SDP_FindProfileVersionInRec)(const tSDP_DISC_REC*, uint16_t, |
| uint16_t*); |
| |
| /******************************************************************************* |
| |
| Function SDP_FindServiceUUIDInRec |
| |
| Description Read the service UUID within a record; |
| if there is any. |
| |
| Parameters: p_rec - (input) pointer to a SDP record. |
| p_uuid - (output) found UUID or null. |
| |
| Returns true if found, otherwise false. |
| |
| ******************************************************************************/ |
| bool (*SDP_FindServiceUUIDInRec)(const tSDP_DISC_REC* p_rec, |
| bluetooth::Uuid* p_uuid); |
| } record; |
| |
| struct { |
| /******************************************************************************* |
| |
| API into SDP for Local service database updates |
| |
| Function SDP_CreateRecord |
| |
| Description This function is called to create a record in the |
| database. This would be through the SDP database |
| maintenance API. The record is created empty, teh |
| application should then call "add_attribute" *to add |
| the record's attributes. |
| |
| Returns Record handle if OK, else 0. |
| |
| ******************************************************************************/ |
| uint32_t (*SDP_CreateRecord)(void); |
| |
| /******************************************************************************* |
| |
| Function SDP_DeleteRecord |
| |
| Description This function is called to add a record (or all records) |
| from the database. This would be through the SDP |
| database maintenance API. |
| |
| Parameters: handle - (input) Handle to delete, 0 for all records |
| to be deleted |
| |
| Returns true if succeeded, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_DeleteRecord)(uint32_t); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddAttribute |
| |
| Description This function is called to add an attribute to a record. |
| This would be through the SDP database maintenance API. |
| If the attribute already exists in the record, it is |
| replaced with the new value. |
| |
| NOTE Attribute values must be passed as a Big Endian stream. |
| |
| Parameters: handle - (input) Handle to add |
| attr_id - (input) Attribute id to add |
| attr_type - (input) Attribute type to add |
| attr_len - (input) Attribute data length |
| p_val - (input) Attribute data value |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddAttribute)(uint32_t handle, uint16_t attr_id, |
| uint8_t attr_type, uint32_t attr_len, |
| uint8_t* p_val); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddSequence |
| |
| Description This function is called to add a sequence to a record. |
| This would be through the SDP database maintenance API. |
| If the sequence already exists in the record, it is |
| replaced with the new sequence. |
| |
| NOTE Element values must be passed as a Big Endian stream. |
| |
| Parameters: handle - (input) Handle to add |
| attr_id - (input) Attribute id to add |
| num_elem - (input) Number of elements in array |
| type[] - (input) Element type |
| len[] - (input) Element data length |
| p_val[] - (input) Element data value |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddSequence)(uint32_t handle, uint16_t attr_id, |
| uint16_t num_elem, uint8_t type[], uint8_t len[], |
| uint8_t* p_val[]); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddUuidSequence |
| |
| Description This function is called to add a UUID sequence to a |
| record. This would be through the SDP database |
| maintenance API. If the sequence already exists in the |
| record, it is replaced with the new sequence. |
| |
| Parameters: handle - (input) Handle to add |
| attr_id - (input) Attribute id to add |
| num_uuids - (input) Number of uuids in array |
| p_uuids[] - (input) Array uuid |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddUuidSequence)(uint32_t handle, uint16_t attr_id, |
| uint16_t num_uuids, uint16_t* p_uuids); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddProtocolList |
| |
| Description This function is called to add a protocol descriptor |
| list to a record. This would be through the SDP database |
| maintenance API. If the protocol list already exists in |
| the record, it is replaced with the new list. |
| |
| Parameters: handle - (input) Handle to add |
| num_elem - (input) Number of elements to add |
| elem_list[]- (input) Element data list to add |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddProtocolList)(uint32_t handle, uint16_t num_elem, |
| tSDP_PROTOCOL_ELEM* p_elem_list); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddAdditionProtoLists |
| |
| Description This function is called to add a protocol descriptor |
| list to a record. This would be through the SDP database |
| maintenance API. If the protocol list already exists in |
| the record, it is replaced with the new list. |
| |
| Parameters: handle - (input) Handle to add |
| num_elem - (input) Number of elements to add |
| proto_list[]- (input) Element data list to add |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddAdditionProtoLists)(uint32_t handle, uint16_t num_elem, |
| tSDP_PROTO_LIST_ELEM* p_proto_list); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddProfileDescriptorList |
| |
| Description This function is called to add a profile descriptor list |
| to a record. This would be through the SDP database |
| maintenance API. If the version already exists in the |
| record, it is replaced with the new one. |
| |
| Parameters: handle - (input) Handle to add |
| uuid - (input) Uuid to add |
| version - (input) major and minor version |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddProfileDescriptorList)(uint32_t handle, uint16_t profile_uuid, |
| uint16_t version); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddLanguageBaseAttrIDList |
| |
| Description This function is called to add a language base attr list |
| to a record. This would be through the SDP database |
| maintenance API. If the version already exists in the |
| record, it is replaced with the new one. |
| |
| Parameters: handle - (input) Handle to add |
| lang - (input) language base descriptor |
| char_enc - (input) character encoding |
| base_id - (input) base id |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddLanguageBaseAttrIDList)(uint32_t handle, uint16_t lang, |
| uint16_t char_enc, uint16_t base_id); |
| |
| /******************************************************************************* |
| |
| Function SDP_AddServiceClassIdList |
| |
| Description This function is called to add a service list to a |
| record. This would be through the SDP database |
| maintenance API. If the service list already exists in |
| the record, it is replaced with the new list. |
| |
| Parameters: handle - (input) Handle to add |
| num_services - (input) number of services to add |
| uuids[] - (input) list of service uuids to add |
| |
| Returns true if added OK, else false |
| |
| ******************************************************************************/ |
| bool (*SDP_AddServiceClassIdList)(uint32_t handle, uint16_t num_services, |
| uint16_t* p_service_uuids); |
| |
| /******************************************************************************* |
| |
| Function SDP_DeleteAttribute |
| |
| Description Delete an attribute from a record. |
| This would be through the SDP database maintenance API. |
| |
| Parameters: handle - (input) Handle to add |
| attr_id - (input) attribute id to delete |
| |
| Returns true if deleted OK, else false if not found |
| |
| ******************************************************************************/ |
| bool (*SDP_DeleteAttribute)(uint32_t handle, uint16_t attr_id); |
| } handle; |
| |
| struct { |
| /******************************************************************************* |
| |
| Device Identification API |
| |
| Function SDP_SetLocalDiRecord |
| |
| Description This function adds a DI record to the local SDP |
| database. |
| |
| Parameters: info - (input) device identification record |
| p_handle - (output) handle of record if successful |
| |
| Returns Returns SDP_SUCCESS if record added successfully, else |
| error |
| |
| ******************************************************************************/ |
| uint16_t (*SDP_SetLocalDiRecord)(const tSDP_DI_RECORD* device_info, |
| uint32_t* p_handle); |
| |
| /******************************************************************************* |
| |
| Device Identification API |
| |
| Function SDP_DiDiscover |
| |
| Description This function queries a remote device for DI |
| information. |
| |
| Parameters: bd_addr - (input) remote device |
| p_db - (input) dicovery database |
| len - (input ) data base length |
| p_cb - (input) callback when complete |
| |
| Returns SDP_SUCCESS if query started successfully, else error |
| |
| ******************************************************************************/ |
| tSDP_STATUS (*SDP_DiDiscover)(const RawAddress& remote_device, |
| tSDP_DISCOVERY_DB* p_db, uint32_t len, |
| tSDP_DISC_CMPL_CB* p_cb); |
| |
| /******************************************************************************* |
| |
| Device Identification API |
| |
| Function SDP_GetNumDiRecords |
| |
| Description Searches specified database for DI records |
| |
| Parameters: p_db - (input) dicovery database |
| |
| Returns number of DI records found |
| |
| ******************************************************************************/ |
| uint8_t (*SDP_GetNumDiRecords)(const tSDP_DISCOVERY_DB* p_db); |
| |
| /******************************************************************************* |
| |
| Device Identification API |
| |
| Function SDP_GetDiRecord |
| |
| Description This function retrieves a remote device's DI record from |
| the specified database. |
| |
| Parameters: index - (input) record index to retrieve |
| device_info - (input) dicovery database |
| p_cb - (input) callback when complete |
| |
| Returns SDP_SUCCESS if record retrieved, else error |
| |
| ******************************************************************************/ |
| uint16_t (*SDP_GetDiRecord)(uint8_t getRecordIndex, |
| tSDP_DI_GET_RECORD* device_info, |
| const tSDP_DISCOVERY_DB* p_db); |
| |
| } device_id; |
| }; |
| |
| const struct tSdpApi* get_legacy_stack_sdp_api(); |
| |
| struct tLegacyStackSdbCallback { |
| void(tSDP_DISC_CMPL_CB)(tSDP_RESULT result); |
| void(tSDP_DISC_CMPL_CB2)(tSDP_RESULT result, const void* user_data); |
| }; |
| |
| } // namespace sdp |
| } // namespace stack |
| } // namespace legacy |
| } // namespace bluetooth |