bt-oal/hardware/bt_rc.h

   1 /*
   2  * Copyright (C) 2012 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef ANDROID_INCLUDE_BT_RC_H
  18 #define ANDROID_INCLUDE_BT_RC_H
  19
  20 __BEGIN_DECLS
  21
  22 /* Change this macro to use multiple RC */
  23 #define BT_RC_NUM_APP 1
  24
  25 /* Macros */
  26 #define BTRC_MAX_ATTR_STR_LEN       (1 << 16)
  27 #define BTRC_UID_SIZE               8
  28 #define BTRC_MAX_APP_SETTINGS       8
  29 #define BTRC_MAX_FOLDER_DEPTH       4
  30 #define BTRC_MAX_APP_ATTR_SIZE      16
  31 #define BTRC_MAX_ELEM_ATTR_SIZE     8
  32 #define BTRC_FEATURE_BIT_MASK_SIZE 16
  33
  34 /* Macros for valid scopes in get_folder_items */
  35 #define BTRC_SCOPE_PLAYER_LIST  0x00 /* Media Player List */
  36 #define BTRC_SCOPE_FILE_SYSTEM  0x01 /* Virtual File System */
  37 #define BTRC_SCOPE_SEARCH  0x02 /* Search */
  38 #define BTRC_SCOPE_NOW_PLAYING   0x03 /* Now Playing */
  39
  40 /* Macros for supported character encoding */
  41 #define BTRC_CHARSET_ID_UTF8  0x006A
  42
  43 /* Macros for item types */
  44 #define BTRC_ITEM_PLAYER  0x01 /* Media Player */
  45 #define BTRC_ITEM_FOLDER  0x02 /* Folder */
  46 #define BTRC_ITEM_MEDIA   0x03 /* Media File */
  47
  48 /* Macros for media attribute IDs */
  49 #define BTRC_MEDIA_ATTR_ID_INVALID               -1
  50 #define BTRC_MEDIA_ATTR_ID_TITLE                 0x00000001
  51 #define BTRC_MEDIA_ATTR_ID_ARTIST                0x00000002
  52 #define BTRC_MEDIA_ATTR_ID_ALBUM                 0x00000003
  53 #define BTRC_MEDIA_ATTR_ID_TRACK_NUM             0x00000004
  54 #define BTRC_MEDIA_ATTR_ID_NUM_TRACKS            0x00000005
  55 #define BTRC_MEDIA_ATTR_ID_GENRE                 0x00000006
  56 #define BTRC_MEDIA_ATTR_ID_PLAYING_TIME          0x00000007        /* in miliseconds */
  57
  58 /* Macros for folder types */
  59 #define BTRC_FOLDER_TYPE_MIXED      0x00
  60 #define BTRC_FOLDER_TYPE_TITLES     0x01
  61 #define BTRC_FOLDER_TYPE_ALBUMS     0x02
  62 #define BTRC_FOLDER_TYPE_ARTISTS    0x03
  63 #define BTRC_FOLDER_TYPE_GENRES     0x04
  64 #define BTRC_FOLDER_TYPE_PLAYLISTS  0x05
  65 #define BTRC_FOLDER_TYPE_YEARS      0x06
  66
  67 /* Macros for media types */
  68 #define BTRC_MEDIA_TYPE_AUDIO  0x00 /* audio */
  69 #define BTRC_MEDIA_TYPE_VIDEO  0x01 /* video */
  70
  71 /* Macros for num attributes */
  72 #define BTRC_NUM_ATTR_NONE 0xFF /* No attributes required */
  73 #define BTRC_NUM_ATTR_ALL  0X00 /* All attributes required */
  74
  75 #define BTRC_HANDLE_NONE 0xFF
  76
  77 typedef uint8_t btrc_uid_t[BTRC_UID_SIZE];
  78
  79 typedef enum {
  80         BTRC_CONNECTION_STATE_DISCONNECTED = 0,
  81         BTRC_CONNECTION_STATE_CONNECTED
  82 } btrc_connection_state_t;
  83
  84 typedef enum {
  85         BTRC_FEAT_NONE = 0x00,    /* AVRCP 1.0 */
  86         BTRC_FEAT_METADATA = 0x01,    /* AVRCP 1.3 */
  87         BTRC_FEAT_ABSOLUTE_VOLUME = 0x02,    /* Supports TG role and volume sync */
  88         BTRC_FEAT_BROWSE = 0x04,    /* AVRCP 1.4 and up, with Browsing support */
  89 } btrc_remote_features_t;
  90
  91 typedef enum {
  92         BTRC_PLAYSTATE_STOPPED = 0x00,    /* Stopped */
  93         BTRC_PLAYSTATE_PLAYING = 0x01,    /* Playing */
  94         BTRC_PLAYSTATE_PAUSED = 0x02,    /* Paused  */
  95         BTRC_PLAYSTATE_FWD_SEEK = 0x03,    /* Fwd Seek*/
  96         BTRC_PLAYSTATE_REV_SEEK = 0x04,    /* Rev Seek*/
  97         BTRC_PLAYSTATE_ERROR = 0xFF,    /* Error   */
  98 } btrc_play_status_t;
  99
 100 typedef enum {
 101         BTRC_EVT_PLAY_STATUS_CHANGED = 0x01,
 102         BTRC_EVT_TRACK_CHANGE = 0x02,
 103         BTRC_EVT_TRACK_REACHED_END = 0x03,
 104         BTRC_EVT_TRACK_REACHED_START = 0x04,
 105         BTRC_EVT_PLAY_POS_CHANGED = 0x05,
 106         BTRC_EVT_APP_SETTINGS_CHANGED = 0x08,
 107         BTRC_EVT_NOW_PLAYING_CONTENT_CHANGED = 0x09,
 108         BTRC_EVT_AVAL_PLAYER_CHANGE = 0x0a,
 109         BTRC_EVT_ADDR_PLAYER_CHANGE = 0x0b,
 110         BTRC_EVT_UIDS_CHANGED = 0x0c,
 111         BTRC_EVT_VOL_CHANGED = 0x0d,
 112 } btrc_event_id_t;
 113
 114 typedef enum {
 115         BTRC_NOTIFICATION_TYPE_INTERIM = 0,
 116         BTRC_NOTIFICATION_TYPE_CHANGED = 1,
 117 } btrc_notification_type_t;
 118
 119 typedef enum {
 120         BTRC_PLAYER_ATTR_EQUALIZER = 0x01,
 121         BTRC_PLAYER_ATTR_REPEAT = 0x02,
 122         BTRC_PLAYER_ATTR_SHUFFLE = 0x03,
 123         BTRC_PLAYER_ATTR_SCAN = 0x04,
 124 } btrc_player_attr_t;
 125
 126 typedef enum {
 127         BTRC_TRANSPORT_ATTR_DELAY = 0x01,
 128         BTRC_TRANSPORT_ATTR_VOLUME
 129 } btrc_transport_attr_t;
 130
 131 typedef enum {
 132         BTRC_MEDIA_ATTR_TITLE = 0x01,
 133         BTRC_MEDIA_ATTR_ARTIST = 0x02,
 134         BTRC_MEDIA_ATTR_ALBUM = 0x03,
 135         BTRC_MEDIA_ATTR_TRACK_NUM = 0x04,
 136         BTRC_MEDIA_ATTR_NUM_TRACKS = 0x05,
 137         BTRC_MEDIA_ATTR_GENRE = 0x06,
 138         BTRC_MEDIA_ATTR_PLAYING_TIME = 0x07,
 139 } btrc_media_attr_t;
 140
 141 typedef enum {
 142         BTRC_PLAYER_VAL_OFF_REPEAT = 0x01,
 143         BTRC_PLAYER_VAL_SINGLE_REPEAT = 0x02,
 144         BTRC_PLAYER_VAL_ALL_REPEAT = 0x03,
 145         BTRC_PLAYER_VAL_GROUP_REPEAT = 0x04
 146 } btrc_player_repeat_val_t;
 147
 148 typedef enum {
 149         BTRC_PLAYER_VAL_OFF_SHUFFLE = 0x01,
 150         BTRC_PLAYER_VAL_ALL_SHUFFLE = 0x02,
 151         BTRC_PLAYER_VAL_GROUP_SHUFFLE = 0x03
 152 } btrc_player_shuffle_val_t;
 153
 154 typedef enum {
 155         BTRC_STS_BAD_CMD        = 0x00, /* Invalid command */
 156         BTRC_STS_BAD_PARAM      = 0x01, /* Invalid parameter */
 157         BTRC_STS_NOT_FOUND      = 0x02, /* Specified parameter is wrong or not found */
 158         BTRC_STS_INTERNAL_ERR   = 0x03, /* Internal Error */
 159         BTRC_STS_NO_ERROR       = 0x04, /* Operation Success */
 160         BTRC_STS_UID_CHANGED    = 0x05, /* UIDs changed */
 161         BTRC_STS_RESERVED       = 0x06, /* Reserved */
 162         BTRC_STS_INV_DIRN       = 0x07, /* Invalid direction */
 163         BTRC_STS_INV_DIRECTORY  = 0x08, /* Invalid directory */
 164         BTRC_STS_INV_ITEM       = 0x09, /* Invalid Item */
 165         BTRC_STS_INV_SCOPE      = 0x0a, /* Invalid scope */
 166         BTRC_STS_INV_RANGE      = 0x0b, /* Invalid range */
 167         BTRC_STS_DIRECTORY      = 0x0c, /* UID is a directory */
 168         BTRC_STS_MEDIA_IN_USE   = 0x0d, /* Media in use */
 169         BTRC_STS_PLAY_LIST_FULL = 0x0e, /* Playing list full */
 170         BTRC_STS_SRCH_NOT_SPRTD = 0x0f, /* Search not supported */
 171         BTRC_STS_SRCH_IN_PROG   = 0x10, /* Search in progress */
 172         BTRC_STS_INV_PLAYER     = 0x11, /* Invalid player */
 173         BTRC_STS_PLAY_NOT_BROW  = 0x12, /* Player not browsable */
 174         BTRC_STS_PLAY_NOT_ADDR  = 0x13, /* Player not addressed */
 175         BTRC_STS_INV_RESULTS    = 0x14, /* Invalid results */
 176         BTRC_STS_NO_AVBL_PLAY   = 0x15, /* No available players */
 177         BTRC_STS_ADDR_PLAY_CHGD = 0x16, /* Addressed player changed */
 178 } btrc_status_t;
 179
 180 typedef struct {
 181         uint16_t player_id;
 182         uint16_t uid_counter;
 183 } btrc_addr_player_changed_t;
 184
 185 typedef struct {
 186         uint8_t num_attr;
 187         uint8_t attr_ids[BTRC_MAX_APP_SETTINGS];
 188         uint8_t attr_values[BTRC_MAX_APP_SETTINGS];
 189 } btrc_player_settings_t;
 190
 191 typedef struct {
 192         uint8_t   val;
 193         uint16_t  charset_id;
 194         uint16_t  str_len;
 195         uint8_t   *p_str;
 196 } btrc_player_app_ext_attr_val_t;
 197
 198 typedef struct {
 199         uint8_t   attr_id;
 200         uint16_t  charset_id;
 201         uint16_t  str_len;
 202         uint8_t   *p_str;
 203         uint8_t   num_val;
 204         btrc_player_app_ext_attr_val_t ext_attr_val[BTRC_MAX_APP_ATTR_SIZE];
 205 } btrc_player_app_ext_attr_t;
 206
 207 typedef struct {
 208         uint8_t attr_id;
 209         uint8_t num_val;
 210         uint8_t attr_val[BTRC_MAX_APP_ATTR_SIZE];
 211 } btrc_player_app_attr_t;
 212
 213 typedef struct {
 214         uint32_t start_item;
 215         uint32_t end_item;
 216         uint32_t size;
 217         uint32_t attrs[BTRC_MAX_ELEM_ATTR_SIZE];
 218         uint8_t  attr_count;
 219 } btrc_getfolderitem_t;
 220
 221 typedef struct {
 222         uint16_t type;
 223         uint16_t uid_counter;
 224 } btrc_uids_changed_t;
 225
 226 typedef struct {
 227         uint16_t type;
 228 } btrc_now_playing_changed_t;
 229
 230 typedef union {
 231         btrc_play_status_t play_status;
 232         btrc_uid_t track; /* queue position in NowPlaying */
 233         uint32_t song_pos;
 234         uint16_t uid_counter;
 235         btrc_player_settings_t player_setting;
 236         btrc_addr_player_changed_t addr_player_changed;
 237         btrc_uids_changed_t uids_changed;
 238         btrc_now_playing_changed_t now_playing_changed;
 239 } btrc_register_notification_t;
 240
 241 typedef struct {
 242         uint8_t id; /* can be attr_id or value_id */
 243         uint8_t text[BTRC_MAX_ATTR_STR_LEN];
 244 } btrc_player_setting_text_t;
 245
 246 typedef struct {
 247         uint32_t attr_id;
 248         uint8_t text[BTRC_MAX_ATTR_STR_LEN];
 249 } btrc_element_attr_val_t;
 250
 251 typedef struct {
 252         uint16_t  player_id;
 253         uint8_t   major_type;
 254         uint32_t  sub_type;
 255         uint8_t   play_status;
 256         uint8_t   features[BTRC_FEATURE_BIT_MASK_SIZE];
 257         uint16_t  charset_id;
 258         uint8_t   name[BTRC_MAX_ATTR_STR_LEN];
 259 } btrc_item_player_t;
 260
 261 typedef struct {
 262         uint8_t   uid[BTRC_UID_SIZE];
 263         uint8_t   type;
 264         uint8_t   playable;
 265         uint16_t  charset_id;
 266         uint8_t   name[BTRC_MAX_ATTR_STR_LEN];
 267 } btrc_item_folder_t;
 268
 269 typedef struct {
 270         uint8_t  uid[BTRC_UID_SIZE];
 271         uint8_t  type;
 272         uint16_t charset_id;
 273         uint8_t  name[BTRC_MAX_ATTR_STR_LEN];
 274         int      num_attrs;
 275         btrc_element_attr_val_t* p_attrs;
 276 } btrc_item_media_t;
 277
 278 typedef struct {
 279         uint8_t item_type;
 280         union {
 281                 btrc_item_player_t player;
 282                 btrc_item_folder_t folder;
 283                 btrc_item_media_t  media;
 284         };
 285 } btrc_folder_items_t;
 286
 287 typedef struct {
 288         uint16_t  str_len;
 289         uint8_t   p_str[BTRC_MAX_ATTR_STR_LEN];
 290 } btrc_br_folder_name_t;
 291
 292 #ifdef TIZEN_BT_HAL
 293 /** Callback for the target connection state */
 294 typedef void (*btrc_tg_connection_state_callback) (bt_bdaddr_t *bd_addr, btrc_connection_state_t state);
 295 #endif
 296
 297 /** Callback for the controller's supported feautres */
 298 typedef void (*btrc_remote_features_callback)(bt_bdaddr_t *bd_addr,
 299                 btrc_remote_features_t features);
 300
 301 /** Callback for play status request */
 302 typedef void (*btrc_get_play_status_callback)(bt_bdaddr_t *bd_addr);
 303
 304 /** Callback for list player application attributes (Shuffle, Repeat,...) */
 305 typedef void (*btrc_list_player_app_attr_callback)(bt_bdaddr_t *bd_addr);
 306
 307 /** Callback for list player application attributes (Shuffle, Repeat,...) */
 308 typedef void (*btrc_list_player_app_values_callback)(btrc_player_attr_t attr_id,
 309                 bt_bdaddr_t *bd_addr);
 310
 311 /** Callback for getting the current player application settings value
 312  **  num_attr: specifies the number of attribute ids contained in p_attrs
 313  */
 314 typedef void (*btrc_get_player_app_value_callback) (uint8_t num_attr,
 315                 btrc_player_attr_t *p_attrs, bt_bdaddr_t *bd_addr);
 316
 317 /** Callback for getting the player application settings attributes' text
 318  **  num_attr: specifies the number of attribute ids contained in p_attrs
 319  */
 320 typedef void (*btrc_get_player_app_attrs_text_callback) (uint8_t num_attr,
 321                 btrc_player_attr_t *p_attrs, bt_bdaddr_t *bd_addr);
 322
 323 /** Callback for getting the player application settings values' text
 324  **  num_attr: specifies the number of value ids contained in p_vals
 325  */
 326 typedef void (*btrc_get_player_app_values_text_callback) (uint8_t attr_id, uint8_t num_val,
 327                 uint8_t *p_vals, bt_bdaddr_t *bd_addr);
 328
 329 /** Callback for setting the player application settings values */
 330 typedef void (*btrc_set_player_app_value_callback) (btrc_player_settings_t *p_vals,
 331                 bt_bdaddr_t *bd_addr);
 332
 333 /** Callback to fetch the get element attributes of the current song
 334  **  num_attr: specifies the number of attributes requested in p_attrs
 335  */
 336 typedef void (*btrc_get_element_attr_callback) (uint8_t num_attr, btrc_media_attr_t *p_attrs,
 337                 bt_bdaddr_t *bd_addr);
 338
 339 /** Callback for register notification (Play state change/track change/...)
 340  **  param: Is only valid if event_id is BTRC_EVT_PLAY_POS_CHANGED
 341  */
 342 typedef void (*btrc_register_notification_callback) (btrc_event_id_t event_id, uint32_t param,
 343                 bt_bdaddr_t *bd_addr);
 344
 345 /* AVRCP 1.4 Enhancements */
 346 /** Callback for volume change on CT
 347  **  volume: Current volume setting on the CT (0-127)
 348  */
 349 typedef void (*btrc_volume_change_callback) (uint8_t volume, uint8_t ctype, bt_bdaddr_t *bd_addr);
 350
 351 /** Callback for delay change **/
 352 typedef void (*btrc_delay_change_callback) (uint16_t delay, bt_bdaddr_t *bd_addr);
 353
 354 /** Callback for passthrough commands */
 355 typedef void (*btrc_passthrough_cmd_callback) (int id, int key_state, bt_bdaddr_t *bd_addr);
 356
 357 /** Callback for set addressed player response on TG **/
 358 typedef void (*btrc_set_addressed_player_callback) (uint16_t player_id, bt_bdaddr_t *bd_addr);
 359
 360 /** Callback for set browsed player response on TG **/
 361 typedef void (*btrc_set_browsed_player_callback) (uint16_t player_id, bt_bdaddr_t *bd_addr);
 362
 363 /** Callback for get folder items on TG
 364  **  num_attr: specifies the number of attributes requested in p_attr_ids
 365  */
 366 typedef void (*btrc_get_folder_items_callback) (uint8_t scope, uint32_t start_item,
 367                 uint32_t end_item, uint8_t num_attr, uint32_t *p_attr_ids, bt_bdaddr_t *bd_addr);
 368
 369 /** Callback for changing browsed path on TG **/
 370 typedef void (*btrc_change_path_callback) (uint8_t direction,
 371                 uint8_t* folder_uid, bt_bdaddr_t *bd_addr);
 372
 373 /** Callback to fetch the get item attributes of the media item
 374  **  num_attr: specifies the number of attributes requested in p_attrs
 375  */
 376 typedef void (*btrc_get_item_attr_callback) (uint8_t scope, uint8_t* uid, uint16_t uid_counter,
 377                 uint8_t num_attr, btrc_media_attr_t *p_attrs, bt_bdaddr_t *bd_addr);
 378
 379 /** Callback for play request for the media item indicated by an identifier */
 380 typedef void (*btrc_play_item_callback) (uint8_t scope,
 381                 uint16_t uid_counter, uint8_t* uid, bt_bdaddr_t *bd_addr);
 382
 383 /** Callback to fetch total number of items from a folder **/
 384 typedef void (*btrc_get_total_num_of_items_callback) (uint8_t scope, bt_bdaddr_t *bd_addr);
 385
 386 /** Callback for conducting recursive search on a current browsed path for a specified string */
 387 typedef void (*btrc_search_callback) (uint16_t charset_id,
 388                 uint16_t str_len, uint8_t* p_str, bt_bdaddr_t *bd_addr);
 389
 390 /** Callback to add a specified media item indicated by an identifier to now playing queue. */
 391 typedef void (*btrc_add_to_now_playing_callback) (uint8_t scope,
 392                 uint8_t* uid, uint16_t  uid_counter, bt_bdaddr_t *bd_addr);
 393
 394 /** BT-RC Target callback structure. */
 395 typedef struct {
 396         /** set to sizeof(BtRcCallbacks) */
 397         size_t      size;
 398 #ifdef TIZEN_BT_HAL
 399         btrc_tg_connection_state_callback               connection_state_cb;
 400 #endif
 401         btrc_remote_features_callback               remote_features_cb;
 402         btrc_get_play_status_callback               get_play_status_cb;
 403         btrc_list_player_app_attr_callback          list_player_app_attr_cb;
 404         btrc_list_player_app_values_callback        list_player_app_values_cb;
 405         btrc_get_player_app_value_callback          get_player_app_value_cb;
 406         btrc_get_player_app_attrs_text_callback     get_player_app_attrs_text_cb;
 407         btrc_get_player_app_values_text_callback    get_player_app_values_text_cb;
 408         btrc_set_player_app_value_callback          set_player_app_value_cb;
 409         btrc_get_element_attr_callback              get_element_attr_cb;
 410         btrc_register_notification_callback         register_notification_cb;
 411         btrc_volume_change_callback                 volume_change_cb;
 412         btrc_delay_change_callback                  delay_change_cb;
 413         btrc_passthrough_cmd_callback               passthrough_cmd_cb;
 414         btrc_set_addressed_player_callback          set_addressed_player_cb;
 415         btrc_set_browsed_player_callback            set_browsed_player_cb;
 416         btrc_get_folder_items_callback              get_folder_items_cb;
 417         btrc_change_path_callback                   change_path_cb;
 418         btrc_get_item_attr_callback                 get_item_attr_cb;
 419         btrc_play_item_callback                     play_item_cb;
 420         btrc_get_total_num_of_items_callback        get_total_num_of_items_cb;
 421         btrc_search_callback                        search_cb;
 422         btrc_add_to_now_playing_callback            add_to_now_playing_cb;
 423 } btrc_callbacks_t;
 424
 425 /** Represents the standard BT-RC AVRCP Target interface. */
 426 typedef struct {
 427
 428         /** set to sizeof(BtRcInterface) */
 429         size_t          size;
 430         /**
 431          * Register the BtRc callbacks
 432          */
 433         bt_status_t (*init)(btrc_callbacks_t* callbacks);
 434
 435 #ifdef TIZEN_BT_HAL
 436         /** connect to AVRCP controller device */
 437         bt_status_t (*connect)(bt_bdaddr_t *bd_addr);
 438
 439         /** dis-connect from AVRCP controller device */
 440         bt_status_t (*disconnect)(bt_bdaddr_t *bd_addr);
 441 #endif
 442
 443         /** Respose to GetPlayStatus request. Contains the current
 444          **  1. Play status
 445          **  2. Song duration/length
 446          **  3. Song position
 447          */
 448         bt_status_t (*get_play_status_rsp)(bt_bdaddr_t *bd_addr, btrc_play_status_t play_status,
 449                         uint32_t song_len, uint32_t song_pos);
 450
 451         /** Lists the support player application attributes (Shuffle/Repeat/...)
 452          **  num_attr: Specifies the number of attributes contained in the pointer p_attrs
 453          */
 454         bt_status_t (*list_player_app_attr_rsp)(bt_bdaddr_t *bd_addr, int num_attr,
 455                         btrc_player_attr_t *p_attrs);
 456
 457         /** Lists the support player application attributes (Shuffle Off/On/Group)
 458          **  num_val: Specifies the number of values contained in the pointer p_vals
 459          */
 460         bt_status_t (*list_player_app_value_rsp)(bt_bdaddr_t *bd_addr, int num_val, uint8_t *p_vals);
 461
 462         /** Returns the current application attribute values for each of the specified attr_id */
 463         bt_status_t (*get_player_app_value_rsp)(bt_bdaddr_t *bd_addr, btrc_player_settings_t *p_vals);
 464
 465         /** Returns the application attributes text ("Shuffle"/"Repeat"/...)
 466          **  num_attr: Specifies the number of attributes' text contained in the pointer p_attrs
 467          */
 468         bt_status_t (*get_player_app_attr_text_rsp)(bt_bdaddr_t *bd_addr, int num_attr,
 469                         btrc_player_setting_text_t *p_attrs);
 470
 471         /** Returns the application attributes text ("Shuffle"/"Repeat"/...)
 472          **  num_attr: Specifies the number of attribute values' text contained in the pointer p_vals
 473          */
 474         bt_status_t (*get_player_app_value_text_rsp)(bt_bdaddr_t *bd_addr, int num_val,
 475                         btrc_player_setting_text_t *p_vals);
 476
 477         /** Returns the current songs' element attributes text ("Title"/"Album"/"Artist")
 478          **  num_attr: Specifies the number of attributes' text contained in the pointer p_attrs
 479          */
 480         bt_status_t (*get_element_attr_rsp)(bt_bdaddr_t *bd_addr, uint8_t num_attr,
 481                         btrc_element_attr_val_t *p_attrs);
 482
 483         /** Response to set player attribute request ("Shuffle"/"Repeat")
 484          **  rsp_status: Status of setting the player attributes for the current media player
 485          */
 486         bt_status_t (*set_player_app_value_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
 487
 488         /* Response to the register notification request (Play state change/track change/...).
 489          ** event_id: Refers to the event_id this notification change corresponds too
 490          ** type: Response type - interim/changed
 491          ** p_params: Based on the event_id, this parameter should be populated
 492          */
 493         bt_status_t (*register_notification_rsp)(btrc_event_id_t event_id,
 494                         btrc_notification_type_t type,
 495                         btrc_register_notification_t *p_param);
 496
 497         /* AVRCP 1.4 enhancements */
 498
 499         /**Send current volume setting to remote side. Support limited to SetAbsoluteVolume
 500          ** This can be enhanced to support Relative Volume (AVRCP 1.0).
 501          ** With RelateVolume, we will send VOLUME_UP/VOLUME_DOWN opposed to absolute volume level
 502          ** volume: Should be in the range 0-127. bit7 is reseved and cannot be set
 503          */
 504         bt_status_t (*set_volume)(uint8_t volume);
 505
 506         /* Set addressed player response from TG to CT */
 507         bt_status_t (*set_addressed_player_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
 508
 509         /* Set browsed player response from TG to CT */
 510         bt_status_t (*set_browsed_player_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
 511                         uint32_t num_items, uint16_t charset_id, uint8_t folder_depth,
 512                         btrc_br_folder_name_t *p_folders);
 513
 514         /* Get folder item list response from TG to CT */
 515         bt_status_t (*get_folder_items_list_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
 516                         uint16_t uid_counter, uint8_t num_items, btrc_folder_items_t *p_items);
 517
 518         /* Change path response from TG to CT */
 519         bt_status_t (*change_path_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
 520                         uint32_t num_items);
 521
 522         /** Returns the element's attributes num_attr: Specifies the number of attributes' text
 523          * contained in the pointer p_attrs
 524          */
 525         bt_status_t (*get_item_attr_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
 526                         uint8_t num_attr, btrc_element_attr_val_t *p_attrs);
 527
 528         /* play media item response from TG to CT */
 529         bt_status_t (*play_item_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
 530
 531         /* get total number of items response from TG to CT*/
 532         bt_status_t (*get_total_num_of_items_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
 533                         uint32_t uid_counter, uint32_t num_items);
 534
 535         /* Search VFS response from TG to CT */
 536         bt_status_t (*search_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status, uint32_t uid_counter,
 537                         uint32_t num_items);
 538
 539         /* add_to_now playing list response from TG to CT */
 540         bt_status_t (*add_to_now_playing_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
 541
 542         /** Closes the interface. */
 543         void  (*cleanup)(void);
 544 } btrc_interface_t;
 545
 546 typedef void (*btrc_passthrough_rsp_callback) (bt_bdaddr_t *bd_addr, int id, int key_state);
 547
 548 typedef void (*btrc_groupnavigation_rsp_callback) (int id, int key_state);
 549
 550 typedef void (*btrc_connection_state_callback) (
 551                 bool rc_connect, bool bt_connect, bt_bdaddr_t *bd_addr);
 552
 553 typedef void (*btrc_ctrl_getrcfeatures_callback) (bt_bdaddr_t *bd_addr, int features);
 554
 555 typedef void (*btrc_ctrl_setabsvol_cmd_callback) (bt_bdaddr_t *bd_addr, uint8_t abs_vol, uint8_t label);
 556
 557 typedef void (*btrc_ctrl_registernotification_abs_vol_callback) (bt_bdaddr_t *bd_addr, uint8_t label);
 558
 559 typedef void (*btrc_ctrl_setplayerapplicationsetting_rsp_callback) (bt_bdaddr_t *bd_addr,
 560                 uint8_t accepted);
 561
 562 typedef void (*btrc_ctrl_playerapplicationsetting_callback)(bt_bdaddr_t *bd_addr,
 563                 uint8_t num_attr,
 564                 btrc_player_app_attr_t *app_attrs,
 565                 uint8_t num_ext_attr,
 566                 btrc_player_app_ext_attr_t *ext_attrs);
 567
 568 typedef void (*btrc_ctrl_playerapplicationsetting_changed_callback)(bt_bdaddr_t *bd_addr,
 569                 btrc_player_settings_t *p_vals);
 570
 571 typedef void (*btrc_ctrl_track_changed_callback)(bt_bdaddr_t *bd_addr, uint8_t num_attr,
 572                 btrc_element_attr_val_t *p_attrs);
 573
 574 typedef void (*btrc_ctrl_play_position_changed_callback)(bt_bdaddr_t *bd_addr,
 575                 uint32_t song_len, uint32_t song_pos);
 576
 577 typedef void (*btrc_ctrl_play_status_changed_callback)(bt_bdaddr_t *bd_addr,
 578                 btrc_play_status_t play_status);
 579
 580 typedef void (*btrc_ctrl_get_folder_items_callback)(bt_bdaddr_t *bd_addr,
 581                 btrc_status_t status,
 582                 const btrc_folder_items_t *folder_items,
 583                 uint8_t count);
 584
 585 typedef void (*btrc_ctrl_change_path_callback)(bt_bdaddr_t *bd_addr, uint8_t count);
 586
 587 typedef void (*btrc_ctrl_set_browsed_player_callback)(
 588                 bt_bdaddr_t *bd_addr, uint8_t num_items, uint8_t depth);
 589 typedef void (*btrc_ctrl_set_addressed_player_callback)(bt_bdaddr_t *bd_addr, uint8_t status);
 590 /** BT-RC Controller callback structure. */
 591 typedef struct {
 592         /** set to sizeof(BtRcCallbacks) */
 593         size_t      size;
 594         btrc_passthrough_rsp_callback                               passthrough_rsp_cb;
 595         btrc_groupnavigation_rsp_callback                           groupnavigation_rsp_cb;
 596         btrc_connection_state_callback                              connection_state_cb;
 597         btrc_ctrl_getrcfeatures_callback                            getrcfeatures_cb;
 598         btrc_ctrl_setplayerapplicationsetting_rsp_callback          setplayerappsetting_rsp_cb;
 599         btrc_ctrl_playerapplicationsetting_callback                 playerapplicationsetting_cb;
 600         btrc_ctrl_playerapplicationsetting_changed_callback         playerapplicationsetting_changed_cb;
 601         btrc_ctrl_setabsvol_cmd_callback                            setabsvol_cmd_cb;
 602         btrc_ctrl_registernotification_abs_vol_callback             registernotification_absvol_cb;
 603         btrc_ctrl_track_changed_callback                            track_changed_cb;
 604         btrc_ctrl_play_position_changed_callback                    play_position_changed_cb;
 605         btrc_ctrl_play_status_changed_callback                      play_status_changed_cb;
 606         btrc_ctrl_get_folder_items_callback                         get_folder_items_cb;
 607         btrc_ctrl_change_path_callback                              change_folder_path_cb;
 608         btrc_ctrl_set_browsed_player_callback                       set_browsed_player_cb;
 609         btrc_ctrl_set_addressed_player_callback                     set_addressed_player_cb;
 610 } btrc_ctrl_callbacks_t;
 611
 612 /** Represents the standard BT-RC AVRCP Controller interface. */
 613 typedef struct {
 614
 615         /** set to sizeof(BtRcInterface) */
 616         size_t          size;
 617         /**
 618          * Register the BtRc callbacks
 619          */
 620         bt_status_t (*init)(btrc_ctrl_callbacks_t* callbacks);
 621 #ifdef TIZEN_BT_HAL
 622         /** connect to headset */
 623         bt_status_t (*connect)(bt_bdaddr_t *bd_addr);
 624
 625         /** dis-connect from headset */
 626         bt_status_t (*disconnect)(bt_bdaddr_t *bd_addr);
 627 #endif
 628         /** send pass through command to target */
 629         bt_status_t (*send_pass_through_cmd) (bt_bdaddr_t *bd_addr, uint8_t key_code,
 630                         uint8_t key_state);
 631         /** send group navigation command to target */
 632         bt_status_t (*send_group_navigation_cmd) (bt_bdaddr_t *bd_addr, uint8_t key_code,
 633                         uint8_t key_state);
 634
 635         /** send command to set player applicaiton setting attributes to target */
 636         bt_status_t (*set_player_app_setting_cmd) (bt_bdaddr_t *bd_addr, uint8_t num_attrib,
 637                         uint8_t* attrib_ids, uint8_t* attrib_vals);
 638
 639         /** send command to set delay, volume to target */
 640         bt_status_t (*set_transport_setting_cmd) (bt_bdaddr_t *bd_addr, uint8_t num_attrib,
 641                         uint8_t* attrib_ids, uint8_t* attrib_vals);
 642
 643         /** send command to play a particular item */
 644         bt_status_t (*play_item_cmd) (
 645                         bt_bdaddr_t *bd_addr, uint8_t scope, uint8_t *uid, uint16_t uid_counter);
 646
 647         /** get the playback state */
 648         bt_status_t (*get_playback_state_cmd) (bt_bdaddr_t *bd_addr);
 649
 650         /** get the now playing list */
 651         bt_status_t (*get_now_playing_list_cmd) (bt_bdaddr_t *bd_addr, uint8_t start, uint8_t items);
 652
 653         /** get the folder list */
 654         bt_status_t (*get_folder_list_cmd) (bt_bdaddr_t *bd_addr, uint8_t start, uint8_t items);
 655
 656         /** get the folder list */
 657         bt_status_t (*get_player_list_cmd) (bt_bdaddr_t *bd_addr, uint8_t start, uint8_t items);
 658
 659         /** get the folder list */
 660         bt_status_t (*change_folder_path_cmd) (bt_bdaddr_t *bd_addr, uint8_t direction, uint8_t * uid);
 661
 662         /** set browsed player */
 663         bt_status_t (*set_browsed_player_cmd) (bt_bdaddr_t *bd_addr, uint16_t player_id);
 664
 665         /** set addressed player */
 666         bt_status_t (*set_addressed_player_cmd) (bt_bdaddr_t *bd_addr, uint16_t player_id);
 667
 668         /** send rsp to set_abs_vol received from target */
 669         bt_status_t (*set_volume_rsp) (bt_bdaddr_t *bd_addr, uint8_t abs_vol, uint8_t label);
 670
 671         /** send notificaiton rsp for abs vol to target */
 672         bt_status_t (*register_abs_vol_rsp) (bt_bdaddr_t *bd_addr, btrc_notification_type_t rsp_type,
 673                         uint8_t abs_vol, uint8_t label);
 674
 675         /** Closes the interface. */
 676         void  (*cleanup)(void);
 677 } btrc_ctrl_interface_t;
 678
 679 __END_DECLS
 680
 681 #endif /* ANDROID_INCLUDE_BT_RC_H */