Internalize stack::sdp::sdp_api (ecca852c) · Commits · e / os / android_packages_modules_Bluetooth

system/stack/include/sdp_api.h

+1 −432

Original line number	Diff line number	Diff line
		@@ -27,426 +27,11 @@
		#include "stack/include/sdp_device_id.h"
		#include "stack/include/sdp_status.h"
		#include "stack/include/sdpdefs.h"
		#include "stack/sdp/internal/sdp_api.h"
		#include "stack/sdp/sdp_discovery_db.h"
		#include "types/bluetooth/uuid.h"
		#include "types/raw_address.h"

		/*****************************************************************************
		* Constants
		****************************************************************************/

		/*****************************************************************************
		* Type Definitions
		****************************************************************************/

		/* 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
		@@ -459,22 +44,6 @@ uint16_t SDP_GetDiRecord(uint8_t getRecordIndex,
		******************************************************************************/
		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 {

system/stack/sdp/internal/sdp_api.h

0 → 100644

+448 −0

File added.

Preview size limit exceeded, changes collapsed.