2 * Copyright (C) 2012 The Android Open Source Project
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 #ifndef ANDROID_INCLUDE_BT_RC_H
18 #define ANDROID_INCLUDE_BT_RC_H
22 /* Change this macro to use multiple RC */
23 #define BT_RC_NUM_APP 1
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
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 */
40 /* Macros for supported character encoding */
41 #define BTRC_CHARSET_ID_UTF8 0x006A
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 */
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 */
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
67 /* Macros for media types */
68 #define BTRC_MEDIA_TYPE_AUDIO 0x00 /* audio */
69 #define BTRC_MEDIA_TYPE_VIDEO 0x01 /* video */
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 */
75 #define BTRC_HANDLE_NONE 0xFF
77 typedef uint8_t btrc_uid_t[BTRC_UID_SIZE];
80 BTRC_CONNECTION_STATE_DISCONNECTED = 0,
81 BTRC_CONNECTION_STATE_CONNECTED
82 } btrc_connection_state_t;
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;
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 */
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,
115 BTRC_NOTIFICATION_TYPE_INTERIM = 0,
116 BTRC_NOTIFICATION_TYPE_CHANGED = 1,
117 } btrc_notification_type_t;
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;
127 BTRC_TRANSPORT_ATTR_DELAY = 0x01,
128 BTRC_TRANSPORT_ATTR_VOLUME
129 } btrc_transport_attr_t;
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,
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;
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;
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 */
182 uint16_t uid_counter;
183 } btrc_addr_player_changed_t;
187 uint8_t attr_ids[BTRC_MAX_APP_SETTINGS];
188 uint8_t attr_values[BTRC_MAX_APP_SETTINGS];
189 } btrc_player_settings_t;
196 } btrc_player_app_ext_attr_val_t;
204 btrc_player_app_ext_attr_val_t ext_attr_val[BTRC_MAX_APP_ATTR_SIZE];
205 } btrc_player_app_ext_attr_t;
210 uint8_t attr_val[BTRC_MAX_APP_ATTR_SIZE];
211 } btrc_player_app_attr_t;
217 uint32_t attrs[BTRC_MAX_ELEM_ATTR_SIZE];
219 } btrc_getfolderitem_t;
223 uint16_t uid_counter;
224 } btrc_uids_changed_t;
228 } btrc_now_playing_changed_t;
231 btrc_play_status_t play_status;
232 btrc_uid_t track; /* queue position in NowPlaying */
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;
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;
248 uint8_t text[BTRC_MAX_ATTR_STR_LEN];
249 } btrc_element_attr_val_t;
256 uint8_t features[BTRC_FEATURE_BIT_MASK_SIZE];
258 uint8_t name[BTRC_MAX_ATTR_STR_LEN];
259 } btrc_item_player_t;
262 uint8_t uid[BTRC_UID_SIZE];
266 uint8_t name[BTRC_MAX_ATTR_STR_LEN];
267 } btrc_item_folder_t;
270 uint8_t uid[BTRC_UID_SIZE];
273 uint8_t name[BTRC_MAX_ATTR_STR_LEN];
275 btrc_element_attr_val_t* p_attrs;
281 btrc_item_player_t player;
282 btrc_item_folder_t folder;
283 btrc_item_media_t media;
285 } btrc_folder_items_t;
289 uint8_t p_str[BTRC_MAX_ATTR_STR_LEN];
290 } btrc_br_folder_name_t;
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);
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);
301 /** Callback for play status request */
302 typedef void (*btrc_get_play_status_callback)(bt_bdaddr_t *bd_addr);
304 /** Callback for list player application attributes (Shuffle, Repeat,...) */
305 typedef void (*btrc_list_player_app_attr_callback)(bt_bdaddr_t *bd_addr);
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);
311 /** Callback for getting the current player application settings value
312 ** num_attr: specifies the number of attribute ids contained in p_attrs
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);
317 /** Callback for getting the player application settings attributes' text
318 ** num_attr: specifies the number of attribute ids contained in p_attrs
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);
323 /** Callback for getting the player application settings values' text
324 ** num_attr: specifies the number of value ids contained in p_vals
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);
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);
333 /** Callback to fetch the get element attributes of the current song
334 ** num_attr: specifies the number of attributes requested in p_attrs
336 typedef void (*btrc_get_element_attr_callback) (uint8_t num_attr, btrc_media_attr_t *p_attrs,
337 bt_bdaddr_t *bd_addr);
339 /** Callback for register notification (Play state change/track change/...)
340 ** param: Is only valid if event_id is BTRC_EVT_PLAY_POS_CHANGED
342 typedef void (*btrc_register_notification_callback) (btrc_event_id_t event_id, uint32_t param,
343 bt_bdaddr_t *bd_addr);
345 /* AVRCP 1.4 Enhancements */
346 /** Callback for volume change on CT
347 ** volume: Current volume setting on the CT (0-127)
349 typedef void (*btrc_volume_change_callback) (uint8_t volume, uint8_t ctype, bt_bdaddr_t *bd_addr);
351 /** Callback for delay change **/
352 typedef void (*btrc_delay_change_callback) (uint16_t delay, bt_bdaddr_t *bd_addr);
354 /** Callback for passthrough commands */
355 typedef void (*btrc_passthrough_cmd_callback) (int id, int key_state, bt_bdaddr_t *bd_addr);
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);
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);
363 /** Callback for get folder items on TG
364 ** num_attr: specifies the number of attributes requested in p_attr_ids
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);
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);
373 /** Callback to fetch the get item attributes of the media item
374 ** num_attr: specifies the number of attributes requested in p_attrs
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);
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);
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);
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);
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);
394 /** BT-RC Target callback structure. */
396 /** set to sizeof(BtRcCallbacks) */
399 btrc_tg_connection_state_callback connection_state_cb;
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;
425 /** Represents the standard BT-RC AVRCP Target interface. */
428 /** set to sizeof(BtRcInterface) */
431 * Register the BtRc callbacks
433 bt_status_t (*init)(btrc_callbacks_t* callbacks);
436 /** connect to AVRCP controller device */
437 bt_status_t (*connect)(bt_bdaddr_t *bd_addr);
439 /** dis-connect from AVRCP controller device */
440 bt_status_t (*disconnect)(bt_bdaddr_t *bd_addr);
443 /** Respose to GetPlayStatus request. Contains the current
445 ** 2. Song duration/length
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);
451 /** Lists the support player application attributes (Shuffle/Repeat/...)
452 ** num_attr: Specifies the number of attributes contained in the pointer p_attrs
454 bt_status_t (*list_player_app_attr_rsp)(bt_bdaddr_t *bd_addr, int num_attr,
455 btrc_player_attr_t *p_attrs);
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
460 bt_status_t (*list_player_app_value_rsp)(bt_bdaddr_t *bd_addr, int num_val, uint8_t *p_vals);
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);
465 /** Returns the application attributes text ("Shuffle"/"Repeat"/...)
466 ** num_attr: Specifies the number of attributes' text contained in the pointer p_attrs
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);
471 /** Returns the application attributes text ("Shuffle"/"Repeat"/...)
472 ** num_attr: Specifies the number of attribute values' text contained in the pointer p_vals
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);
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
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);
483 /** Response to set player attribute request ("Shuffle"/"Repeat")
484 ** rsp_status: Status of setting the player attributes for the current media player
486 bt_status_t (*set_player_app_value_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
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
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);
497 /* AVRCP 1.4 enhancements */
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
504 bt_status_t (*set_volume)(bt_bdaddr_t *bd_addr, uint32_t volume);
506 bt_status_t (*get_volume)(bt_bdaddr_t *bd_addr, uint32_t *volume);
508 /* Set addressed player response from TG to CT */
509 bt_status_t (*set_addressed_player_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
511 /* Set browsed player response from TG to CT */
512 bt_status_t (*set_browsed_player_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
513 uint32_t num_items, uint16_t charset_id, uint8_t folder_depth,
514 btrc_br_folder_name_t *p_folders);
516 /* Get folder item list response from TG to CT */
517 bt_status_t (*get_folder_items_list_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
518 uint16_t uid_counter, uint8_t num_items, btrc_folder_items_t *p_items);
520 /* Change path response from TG to CT */
521 bt_status_t (*change_path_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
524 /** Returns the element's attributes num_attr: Specifies the number of attributes' text
525 * contained in the pointer p_attrs
527 bt_status_t (*get_item_attr_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
528 uint8_t num_attr, btrc_element_attr_val_t *p_attrs);
530 /* play media item response from TG to CT */
531 bt_status_t (*play_item_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
533 /* get total number of items response from TG to CT*/
534 bt_status_t (*get_total_num_of_items_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status,
535 uint32_t uid_counter, uint32_t num_items);
537 /* Search VFS response from TG to CT */
538 bt_status_t (*search_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status, uint32_t uid_counter,
541 /* add_to_now playing list response from TG to CT */
542 bt_status_t (*add_to_now_playing_rsp)(bt_bdaddr_t *bd_addr, btrc_status_t rsp_status);
544 /** Closes the interface. */
545 void (*cleanup)(void);
548 typedef void (*btrc_passthrough_rsp_callback) (bt_bdaddr_t *bd_addr, int id, int key_state);
550 typedef void (*btrc_groupnavigation_rsp_callback) (int id, int key_state);
552 typedef void (*btrc_connection_state_callback) (
553 bool rc_connect, bool bt_connect, bt_bdaddr_t *bd_addr);
555 typedef void (*btrc_ctrl_getrcfeatures_callback) (bt_bdaddr_t *bd_addr, int features);
557 typedef void (*btrc_ctrl_setabsvol_cmd_callback) (bt_bdaddr_t *bd_addr, uint8_t abs_vol, uint8_t label);
559 typedef void (*btrc_ctrl_registernotification_abs_vol_callback) (bt_bdaddr_t *bd_addr, uint8_t label);
561 typedef void (*btrc_ctrl_setplayerapplicationsetting_rsp_callback) (bt_bdaddr_t *bd_addr,
564 typedef void (*btrc_ctrl_playerapplicationsetting_callback)(bt_bdaddr_t *bd_addr,
566 btrc_player_app_attr_t *app_attrs,
567 uint8_t num_ext_attr,
568 btrc_player_app_ext_attr_t *ext_attrs);
570 typedef void (*btrc_ctrl_playerapplicationsetting_changed_callback)(bt_bdaddr_t *bd_addr,
571 btrc_player_settings_t *p_vals);
573 typedef void (*btrc_ctrl_track_changed_callback)(bt_bdaddr_t *bd_addr, uint8_t num_attr,
574 btrc_element_attr_val_t *p_attrs);
576 typedef void (*btrc_ctrl_play_position_changed_callback)(bt_bdaddr_t *bd_addr,
577 uint32_t song_len, uint32_t song_pos);
579 typedef void (*btrc_ctrl_play_status_changed_callback)(bt_bdaddr_t *bd_addr,
580 btrc_play_status_t play_status);
582 typedef void (*btrc_ctrl_get_folder_items_callback)(bt_bdaddr_t *bd_addr,
583 btrc_status_t status,
584 const btrc_folder_items_t *folder_items,
587 typedef void (*btrc_ctrl_change_path_callback)(bt_bdaddr_t *bd_addr, uint8_t count);
589 typedef void (*btrc_ctrl_set_browsed_player_callback)(
590 bt_bdaddr_t *bd_addr, uint8_t num_items, uint8_t depth);
591 typedef void (*btrc_ctrl_set_addressed_player_callback)(bt_bdaddr_t *bd_addr, uint8_t status);
592 /** BT-RC Controller callback structure. */
594 /** set to sizeof(BtRcCallbacks) */
596 btrc_passthrough_rsp_callback passthrough_rsp_cb;
597 btrc_groupnavigation_rsp_callback groupnavigation_rsp_cb;
598 btrc_connection_state_callback connection_state_cb;
599 btrc_ctrl_getrcfeatures_callback getrcfeatures_cb;
600 btrc_ctrl_setplayerapplicationsetting_rsp_callback setplayerappsetting_rsp_cb;
601 btrc_ctrl_playerapplicationsetting_callback playerapplicationsetting_cb;
602 btrc_ctrl_playerapplicationsetting_changed_callback playerapplicationsetting_changed_cb;
603 btrc_ctrl_setabsvol_cmd_callback setabsvol_cmd_cb;
604 btrc_ctrl_registernotification_abs_vol_callback registernotification_absvol_cb;
605 btrc_ctrl_track_changed_callback track_changed_cb;
606 btrc_ctrl_play_position_changed_callback play_position_changed_cb;
607 btrc_ctrl_play_status_changed_callback play_status_changed_cb;
608 btrc_ctrl_get_folder_items_callback get_folder_items_cb;
609 btrc_ctrl_change_path_callback change_folder_path_cb;
610 btrc_ctrl_set_browsed_player_callback set_browsed_player_cb;
611 btrc_ctrl_set_addressed_player_callback set_addressed_player_cb;
612 } btrc_ctrl_callbacks_t;
614 /** Represents the standard BT-RC AVRCP Controller interface. */
617 /** set to sizeof(BtRcInterface) */
620 * Register the BtRc callbacks
622 bt_status_t (*init)(btrc_ctrl_callbacks_t* callbacks);
624 /** connect to headset */
625 bt_status_t (*connect)(bt_bdaddr_t *bd_addr);
627 /** dis-connect from headset */
628 bt_status_t (*disconnect)(bt_bdaddr_t *bd_addr);
630 /** send pass through command to target */
631 bt_status_t (*send_pass_through_cmd) (bt_bdaddr_t *bd_addr, uint8_t key_code,
633 /** send group navigation command to target */
634 bt_status_t (*send_group_navigation_cmd) (bt_bdaddr_t *bd_addr, uint8_t key_code,
637 /** send command to set player applicaiton setting attributes to target */
638 bt_status_t (*set_player_app_setting_cmd) (bt_bdaddr_t *bd_addr, uint8_t num_attrib,
639 uint8_t* attrib_ids, uint8_t* attrib_vals);
641 /** send command to set delay, volume to target */
642 bt_status_t (*set_transport_setting_cmd) (bt_bdaddr_t *bd_addr, uint8_t num_attrib,
643 int* attrib_ids, uint32_t* attrib_vals);
645 /** send command to play a particular item */
646 bt_status_t (*play_item_cmd) (
647 bt_bdaddr_t *bd_addr, uint8_t scope, uint8_t *uid, uint16_t uid_counter);
649 /** get the playback state */
650 bt_status_t (*get_playback_state_cmd) (bt_bdaddr_t *bd_addr);
652 /** get the now playing list */
653 bt_status_t (*get_now_playing_list_cmd) (bt_bdaddr_t *bd_addr, uint8_t start, uint8_t items);
655 /** get the folder list */
656 bt_status_t (*get_folder_list_cmd) (bt_bdaddr_t *bd_addr, uint8_t start, uint8_t items);
658 /** get the folder list */
659 bt_status_t (*get_player_list_cmd) (bt_bdaddr_t *bd_addr, uint8_t start, uint8_t items);
661 /** get the folder list */
662 bt_status_t (*change_folder_path_cmd) (bt_bdaddr_t *bd_addr, uint8_t direction, uint8_t * uid);
664 /** set browsed player */
665 bt_status_t (*set_browsed_player_cmd) (bt_bdaddr_t *bd_addr, uint16_t player_id);
667 /** set addressed player */
668 bt_status_t (*set_addressed_player_cmd) (bt_bdaddr_t *bd_addr, uint16_t player_id);
670 /** send rsp to set_abs_vol received from target */
671 bt_status_t (*set_volume_rsp) (bt_bdaddr_t *bd_addr, uint8_t abs_vol, uint8_t label);
673 /** send notificaiton rsp for abs vol to target */
674 bt_status_t (*register_abs_vol_rsp) (bt_bdaddr_t *bd_addr, btrc_notification_type_t rsp_type,
675 uint8_t abs_vol, uint8_t label);
677 /** Closes the interface. */
678 void (*cleanup)(void);
679 } btrc_ctrl_interface_t;
683 #endif /* ANDROID_INCLUDE_BT_RC_H */