system/include/hardware/bt_sdp.h

/*
 * Copyright (C) 2015 The Android Open Source Project
 *
 * 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 <bluetooth/uuid.h>
#include <raw_address.h>

#include "bluetooth.h"

#define SDP_OPP_SUPPORTED_FORMATS_MAX_LENGTH 15

__BEGIN_DECLS

/**
 * These events are handled by the state machine
 */
typedef enum {
  SDP_TYPE_RAW,         // Used to carry raw SDP search data for unknown UUIDs
  SDP_TYPE_MAP_MAS,     // Message Access Profile - Server
  SDP_TYPE_MAP_MNS,     // Message Access Profile - Client (Notification Server)
  SDP_TYPE_PBAP_PSE,    // Phone Book Profile - Server
  SDP_TYPE_PBAP_PCE,    // Phone Book Profile - Client
  SDP_TYPE_OPP_SERVER,  // Object Push Profile
  SDP_TYPE_SAP_SERVER,  // SIM Access Profile
  SDP_TYPE_DIP,         // Device Identification Profile
  SDP_TYPE_MPS          // Multi-Profile Specification
} bluetooth_sdp_types;

typedef struct _bluetooth_sdp_hdr {
  bluetooth_sdp_types type;
  bluetooth::Uuid uuid;
  uint32_t service_name_length;
  char* service_name;
  int32_t rfcomm_channel_number;
  int32_t l2cap_psm;
  int32_t profile_version;
} bluetooth_sdp_hdr;

/**
 * Some signals need additional pointers, hence we introduce a
 * generic way to handle these pointers.
 */
typedef struct _bluetooth_sdp_hdr_overlay {
  bluetooth_sdp_types type;
  bluetooth::Uuid uuid;
  uint32_t service_name_length;
  const char* service_name;
  int32_t rfcomm_channel_number;
  int32_t l2cap_psm;
  int32_t profile_version;

  // User pointers, only used for some signals - see bluetooth_sdp_ops_record
  int user1_ptr_len;
  const uint8_t* user1_ptr;
  int user2_ptr_len;
  const uint8_t* user2_ptr;
} bluetooth_sdp_hdr_overlay;

typedef struct _bluetooth_sdp_mas_record {
  bluetooth_sdp_hdr_overlay hdr;
  uint32_t mas_instance_id;
  uint32_t supported_features;
  uint32_t supported_message_types;
} bluetooth_sdp_mas_record;

typedef struct _bluetooth_sdp_mns_record {
  bluetooth_sdp_hdr_overlay hdr;
  uint32_t supported_features;
} bluetooth_sdp_mns_record;

typedef struct _bluetooth_sdp_pse_record {
  bluetooth_sdp_hdr_overlay hdr;
  uint32_t supported_features;
  uint32_t supported_repositories;
} bluetooth_sdp_pse_record;

typedef struct _bluetooth_sdp_pce_record {
  bluetooth_sdp_hdr_overlay hdr;
} bluetooth_sdp_pce_record;

typedef struct _bluetooth_sdp_ops_record {
  bluetooth_sdp_hdr_overlay hdr;
  int supported_formats_list_len;
  uint8_t supported_formats_list[SDP_OPP_SUPPORTED_FORMATS_MAX_LENGTH];
} bluetooth_sdp_ops_record;

typedef struct _bluetooth_sdp_sap_record {
  bluetooth_sdp_hdr_overlay hdr;
} bluetooth_sdp_sap_record;

typedef struct _bluetooth_sdp_dip_record {
  bluetooth_sdp_hdr_overlay hdr;
  uint16_t spec_id;
  uint16_t vendor;
  uint16_t vendor_id_source;
  uint16_t product;
  uint16_t version;
  bool primary_record;
} bluetooth_sdp_dip_record;

typedef struct _bluetooth_sdp_mps_record {
  bluetooth_sdp_hdr_overlay hdr;
  uint8_t supported_scenarios_mpsd[8];
  uint8_t supported_scenarios_mpmd[8];
  uint8_t supported_dependencies[2];
} bluetooth_sdp_mps_record;

typedef union {
  bluetooth_sdp_hdr_overlay hdr;
  bluetooth_sdp_mas_record mas;
  bluetooth_sdp_mns_record mns;
  bluetooth_sdp_pse_record pse;
  bluetooth_sdp_pce_record pce;
  bluetooth_sdp_ops_record ops;
  bluetooth_sdp_sap_record sap;
  bluetooth_sdp_dip_record dip;
  bluetooth_sdp_mps_record mps;
} bluetooth_sdp_record;

/** Callback for SDP search */
typedef void (*btsdp_search_callback)(bt_status_t status,
                                      const RawAddress& bd_addr,
                                      const bluetooth::Uuid& uuid,
                                      int num_records,
                                      bluetooth_sdp_record* records);

typedef struct {
  /** Set to sizeof(btsdp_callbacks_t) */
  size_t size;
  btsdp_search_callback sdp_search_cb;
} btsdp_callbacks_t;

typedef struct {
  /** Set to size of this struct */
  size_t size;

  /** Register BT SDP search callbacks */
  bt_status_t (*init)(btsdp_callbacks_t* callbacks);

  /** Unregister BT SDP */
  bt_status_t (*deinit)();

  /** Search for SDP records with specific uuid on remote device */
  bt_status_t (*sdp_search)(RawAddress* bd_addr, const bluetooth::Uuid& uuid);

  /**
   * Use listen in the socket interface to create rfcomm and/or l2cap PSM
   * channels, (without UUID and service_name and set the BTSOCK_FLAG_NO_SDP
   * flag in flags). Then use createSdpRecord to create the SDP record
   * associated with the rfcomm/l2cap channels.
   *
   * Returns a handle to the SDP record, which can be parsed to
   * remove_sdp_record.
   *
   * record           (in) The SDP record to create
   * record_handle    (out)The corresponding record handle will be written to
   * this pointer.
   */
  bt_status_t (*create_sdp_record)(bluetooth_sdp_record* record,
                                   int* record_handle);

  /** Remove a SDP record created by createSdpRecord */
  bt_status_t (*remove_sdp_record)(int sdp_handle);
} btsdp_interface_t;

__END_DECLS