bts_avrcp_controller.h

浏览该文件的文档.

/*
 * Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2022. All rights reserved.
 * Description: BT AVRCP controller module.
 */
 
#ifndef BTS_AVRCP_CONTROLLER_H
#define BTS_AVRCP_CONTROLLER_H
 
#include "bts_def.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum {
    AVRCP_KEY_VOLUME_UP = 0x41,    
    AVRCP_KEY_VOLUME_DOWN = 0x42,  
    AVRCP_KEY_MUTE = 0x43,         
    AVRCP_KEY_PLAY = 0x44,         
    AVRCP_KEY_STOP = 0x45,         
    AVRCP_KEY_PAUSE = 0x46,        
    AVRCP_KEY_RECORD = 0x47,       
    AVRCP_KEY_REWIND = 0x48,       
    AVRCP_KEY_FAST_FORWARD = 0x49, 
    AVRCP_KEY_FORWARD = 0x4B,      
    AVRCP_KEY_BACKWARD = 0x4C,     
    AVRCP_KEY_INVALID = 0x7F,      
} avrcp_key_operation_t;
 
typedef enum {
    AVRCP_CT_ELEMENT_ATTR_TITLE = 0x01, 
    AVRCP_CT_ELEMENT_ATTR_ARTIST_NAME =
        0x02, 
    AVRCP_CT_ELEMENT_ATTR_ALBUM_NAME = 0x03,   
    AVRCP_CT_ELEMENT_ATTR_TRACK_NUMBER = 0x04, 
    AVRCP_CT_ELEMENT_ATTR_TOTAL_NUMBER_OF_TRACKS = 0x05, 
    AVRCP_CT_ELEMENT_ATTR_TRACK_GENRE = 0x06,            
    AVRCP_CT_ELEMENT_ATTR_TRACK_PLAYING_TIME = 0x07      
} avrcp_ct_element_attr_id_t;
 
 
typedef enum {
    AVRCP_NOTIFY_EVENT_PLAYBACK_STATUS_CHANGED = 0x01, 
    AVRCP_NOTIFY_EVENT_TRACK_CHANGED = 0x02, 
    AVRCP_NOTIFY_EVENT_TRACK_REACHED_END = 0x03,   
    AVRCP_NOTIFY_EVENT_TRACK_REACHED_START = 0x04, 
    AVRCP_NOTIFY_EVENT_PLAYBACK_POS_CHANGED = 0x05, 
    AVRCP_NOTIFY_EVENT_BATT_STATUS_CHANGED =
        0x06, 
    AVRCP_NOTIFY_EVENT_SYSTEM_STATUS_CHANGED =
        0x07, 
    AVRCP_NOTIFY_EVENT_PLAYER_APPLICATION_SETTING_CHANGED = 0x08, 
    AVRCP_NOTIFY_EVENT_NOW_PLAYING_CONTENT_CHANGED = 0x09, 
    AVRCP_NOTIFY_EVENT_AVAILABLE_PLAYERS_CHANGED = 0x0A,   
    AVRCP_NOTIFY_EVENT_ADDRESSED_PLAYER_CHANGED = 0x0B,    
    AVRCP_NOTIFY_EVENT_UIDS_CHANGED = 0x0C,                
    AVRCP_NOTIFY_EVENT_VOLUME_CHANGED = 0x0D,              
    AVRCP_NOTIFY_EVENT_RESERVED = 0x0E                     
} avrcp_notify_event_t;
 
typedef enum {
    AVRCP_ABSOLUTE_VOLUME_PERCENTAGE_0 = 0x00, 
    AVRCP_ABSOLUTE_VOLUME_PERCENTAGE_100 = 0x7F, 
    AVRCP_ABSOLUTE_VOLUME_INVALID = 0x80, 
} avrcp_absolute_volume_t;
 
typedef enum {
    AVRCP_PLAY_STATUS_STOPPED = 0x00,  
    AVRCP_PLAY_STATUS_PLAYING = 0x01,  
    AVRCP_PLAY_STATUS_PAUSED = 0x02,   
    AVRCP_PLAY_STATUS_FWD_SEEK = 0x03, 
    AVRCP_PLAY_STATUS_REV_SEEK = 0x04, 
    AVRCP_PLAY_STATUS_ERROR = 0xFF     
} avrcp_play_status_t;
 
typedef enum {
    AVRCP_BATTERY_STATUS_NORMAL = 0x00,      
    AVRCP_BATTERY_STATUS_WARNING = 0x01,     
    AVRCP_BATTERY_STATUS_CRITICAL = 0x02,    
    AVRCP_BATTERY_STATUS_EXTERNAL = 0x03,    
    AVRCP_BATTERY_STATUS_FULL_CHARGE = 0x04, 
} avrcp_battery_status_t;
 
typedef enum {
    AVRCP_CT_SYSTEM_STATUS_POWER_ON = 0x00,  
    AVRCP_CT_SYSTEM_STATUS_POWER_OFF = 0x01, 
    AVRCP_CT_SYSTEM_STATUS_UNPLUGGED = 0x02  
} avrcp_ct_system_status_t;
 
typedef struct {
    unsigned char attr_num;     
    unsigned int *attr_id_list; 
} avrcp_ct_get_element_attr_para_t;
 
typedef struct {
    unsigned char company_num; 
    unsigned int *company_id;  
} avrcp_ct_support_company_para_t;
 
typedef struct {
    unsigned char event_num; 
    unsigned char *event_id; 
} avrcp_ct_support_event_para_t;
 
typedef struct {
    unsigned int attr_id;            
    unsigned short character_set_id; 
    unsigned short value_len; 
    unsigned char *value;            
} avrcp_ct_element_attr_value_cb_t;
 
typedef struct {
    unsigned char attr_num;                       
    avrcp_ct_element_attr_value_cb_t *attr_value; 
} avrcp_ct_element_attr_para_cb_t;
 
typedef struct {
    unsigned short player_id;   
    unsigned short uid_counter; 
} avrcp_ct_addressed_player_changed_cb_t;
 
typedef struct {
    unsigned int song_length;        
    unsigned int song_position;      
    avrcp_play_status_t play_status; 
} avrcp_ct_play_status_cb_t;
 
typedef union {
    avrcp_play_status_t play_status; 
    unsigned long long identifier;   
    unsigned int playback_position;
    avrcp_battery_status_t battery_status;  
    avrcp_ct_system_status_t system_status; 
    avrcp_ct_addressed_player_changed_cb_t addressed_player;
    unsigned short uid_counter; 
    unsigned char volume;       
} avrcp_ct_notification_value_cb_t;
 
typedef void (*avrcp_ct_conn_state_changed_callback)(const bd_addr_t *bd_addr, profile_connect_state_t state);
 
typedef void (*avrcp_ct_press_button_response_callback)(const bd_addr_t *bd_addr, int key_operation);
 
typedef void (*avrcp_ct_release_button_response_callback)(const bd_addr_t *bd_addr, int key_operation);
 
typedef void (*avrcp_ct_supported_companies_callback)(
    const bd_addr_t *bd_addr, avrcp_ct_support_company_para_t *company);
 
typedef void (*avrcp_ct_supported_event_callback)(const bd_addr_t *bd_addr, avrcp_ct_support_event_para_t *event);
 
typedef void (*avrcp_ct_get_element_attribute_callback)(
    const bd_addr_t *bd_addr, avrcp_ct_element_attr_para_cb_t *attr_cb_para);
 
typedef void (*avrcp_ct_get_play_status_callback)(const bd_addr_t *bd_addr, avrcp_ct_play_status_cb_t *status);
 
typedef void (*avrcp_ct_notification_callback)(
    const bd_addr_t *bd_addr, avrcp_notify_event_t event_id, avrcp_ct_notification_value_cb_t *notification);
 
typedef struct {
    avrcp_ct_conn_state_changed_callback conn_state_changed_cb;
    avrcp_ct_press_button_response_callback press_button_cb;
    avrcp_ct_release_button_response_callback release_button_cb;
    avrcp_ct_supported_companies_callback supported_companies_cb;
    avrcp_ct_supported_event_callback supported_event_cb;
    avrcp_ct_get_element_attribute_callback element_attr_cb;
    avrcp_ct_get_play_status_callback play_status_cb;
    avrcp_ct_notification_callback notification_cb;
} avrcp_ct_callbacks_t;
 
int avrcp_ct_get_device_connect_state(const bd_addr_t *bd_addr);
 
int avrcp_ct_connect(const bd_addr_t *bd_addr);
 
int avrcp_ct_disconnect(const bd_addr_t *bd_addr);
 
int avrcp_ct_press_button(const bd_addr_t *bd_addr, int key_operation);
 
int avrcp_ct_release_button(const bd_addr_t *bd_addr, int key_operation);
 
int avrcp_ct_get_supported_companies(const bd_addr_t *bd_addr);
 
int avrcp_ct_get_supported_events(const bd_addr_t *bd_addr);
 
int avrcp_ct_get_element_attributes(const bd_addr_t *bd_addr, const avrcp_ct_get_element_attr_para_t *param);
 
int avrcp_ct_get_play_status(const bd_addr_t *bd_addr);
 
int avrcp_ct_register_notification(const bd_addr_t *bd_addr, unsigned char event_id, unsigned int interval);
 
int avrcp_ct_set_absolute_volume(const bd_addr_t *bd_addr, unsigned char volume);
 
int avrcp_ct_register_callbacks(avrcp_ct_callbacks_t *func);
 
#ifdef __cplusplus
}
#endif
#endif