SDP

This section defines the server part API of the service discovery protocol, so that the user can add the customized records. More...

Overview

This section defines the server part API of the service discovery protocol, so that the user can add the customized records.

Terms and Acronyms

Terms	Details
SDP	Service Discovery Protocol. For more information, please refer to Wikipedia.
L2CAP	Logical Link Control And Adaptation Protocol Specification. For more information, please refer to Wikipedia.
ATT	Attribute Protocol. For more information, please refer to Wikipedia.
UUID	Universally Unique Identifier. For more information, please refer to Wikipedia.
RFCOMM	Radio Frequency Communications. For more information, please refer to Wikipedia.
OBEX	Object exchange. For more information, please refer to Wikipedia.
SIM	Subscriber identity module. For more information, please refer to Wikipedia.
URL	Uniform resource locator. For more information, please refer to Wikipedia.

How to use this module

• Add a customized record with the service name, language list, service class ID list and the protocol description list for a sample profile. Please add your own record according to the SDP interoperability requirements in the related profile specification. To add customized records with the SDP macros and API:
  • Sample code:

    static const uint8_t bt_sample_service_name[] =
    {
        BT_SDP_TEXT_8BIT(7), // The string length of the service name.
        'S', 'a', 'm', 'p', 'l', 'e','\0'
    };
    
    static const uint8_t bt_sample_language_list[] =
    {
        BT_SDP_ATTRIBUTE_HEADER_8BIT(9),// In this example, each item is 3 bytes and the total length of the following list items is 9 bytes.
    
        // The language is defined as "en". A language identifier represents the natural language. Please refer to the ISO 639:1988 (E/F): "Code for the representation of names of languages" and
        // the ISO 639 Codes (Names of Languages) at "http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_639.html".
        BT_SDP_UINT_16BIT(0x656E),
    
        // The encoding is defined as UTF-8. A character encoding identifier which can be found in IANA'S database and
        // the Character Sets at "http://www.isi.edu/in-notes/iana/assignments/character-sets".
        BT_SDP_UINT_16BIT(0x006A),
    
        // A base attribute ID for the natural language in the service record.
        BT_SDP_UINT_16BIT(0x0100)
    };
    
    static const uint8_t bt_sample_service_class_id_list[] =
    {
        BT_SDP_ATTRIBUTE_HEADER_8BIT(6),                    // In this example, each item is 3 bytes and the total length of the following list items is 6 bytes.
        BT_SDP_UUID_16BIT(BT_SDP_SERVICE_CLASS_HANDSFREE),
        BT_SDP_UUID_16BIT(BT_SDP_SERVICE_CLASS_GENERIC_AUDIO)
    };
    
    static const uint8_t bt_sample_protocol_description_list[] =
    {
        BT_SDP_ATTRIBUTE_HEADER_8BIT(12),         // The total length of all list items is 12 bytes.
    
        BT_SDP_ATTRIBUTE_HEADER_8BIT(3),          // The total length of the following list item is 3 bytes.
        BT_SDP_UUID_16BIT(BT_SDP_PROTOCOL_L2CAP),
    
    
        BT_SDP_ATTRIBUTE_HEADER_8BIT(5),          // The total length of the following two list items is 5 bytes.
        BT_SDP_UUID_16BIT(BT_SDP_PROTOCOL_RFCOMM),
        BT_SDP_UINT_8BIT(0x01)
    };
    
    static const bt_sdps_attribute_t bt_sample_sdp_attributes[] =
    {
        BT_SDP_ATTRIBUTE(BT_SDP_ATTRIBUTE_ID_SERVICE_CLASS_ID_LIST, bt_sample_service_class_id_list),
        BT_SDP_ATTRIBUTE(BT_SDP_ATTRIBUTE_ID_PROTOCOL_DESC_LIST, bt_sample_protocol_description_list),
        BT_SDP_ATTRIBUTE(BT_SDP_ATTRIBUTE_ID_LANG_BASE_ID_LIST, bt_sample_language_list),
        //Service name must add a base attribute ID, default is 0x0100, please refer to your profile.
        BT_SDP_ATTRIBUTE(BT_SDP_ATTRIBUTE_ID_SERVICE_NAME+0x0100, bt_sample_service_name)
    };
    
    static const bt_sdps_record_t bt_sample_sdp_record =
    {
        .attribute_list_length = sizeof(bt_sample_sdp_attributes),
        .attribute_list = bt_sample_sdp_attributes,
    };
    
    static const bt_sdps_record_t *sdps_sample_record[]= {
        &bt_sample_sdp_record,
    };
    
    // This API invoked by the SDK process should be implemented by the application.
    // If no records to be found by the remote device, set the record_list to NULL and return 0.
    uint8_t bt_sdps_get_customized_record(const bt_sdps_record_t *** record_list)
    {
        *record_list = &sdps_sample_record;
        return sizeof(sdps_sample_record)/sizeof(bt_sdps_record_t*);
    }

Functions
uint8_t	bt_sdps_get_customized_record (const bt_sdps_record_t ***record_list)
	This is a user defined callback and called by the SDP. More...

Modules
	Define
	This section defines the macros for the SDP server.
	Struct
	This section defines the structures for the SDP server.

Function Documentation

uint8_t bt_sdps_get_customized_record

(

const bt_sdps_record_t ***

record_list

)

This is a user defined callback and called by the SDP.

It might be implemented by the application to provide the customized record and record number.

Parameters

[in]

record_list

is a pointer to the record list. If there is no customized record, the record_list should be NULL and return 0.

Returns

The record number.