Home | History | Annotate | Download | only in hal
      1 /*
      2  * Copyright (C) 2013-2014 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 AUDIO_PLATFORM_API_H
     18 #define AUDIO_PLATFORM_API_H
     19 
     20 #include "voice.h"
     21 #define MAX_VOLUME_CAL_STEPS 15
     22 
     23 struct amp_db_and_gain_table {
     24     float amp;
     25     float db;
     26     uint32_t level;
     27 };
     28 
     29 enum card_status_t;
     30 
     31 void *platform_init(struct audio_device *adev);
     32 void platform_deinit(void *platform);
     33 const char *platform_get_snd_device_name(snd_device_t snd_device);
     34 int platform_get_snd_device_name_extn(void *platform, snd_device_t snd_device,
     35                                       char *device_name);
     36 void platform_add_backend_name(void *platform, char *mixer_path,
     37                                                     snd_device_t snd_device);
     38 bool platform_send_gain_dep_cal(void *platform, int level);
     39 int platform_get_pcm_device_id(audio_usecase_t usecase, int device_type);
     40 int platform_get_snd_device_index(char *snd_device_index_name);
     41 int platform_set_snd_device_acdb_id(snd_device_t snd_device, unsigned int acdb_id);
     42 int platform_get_snd_device_acdb_id(snd_device_t snd_device);
     43 int platform_send_audio_calibration(void *platform, snd_device_t snd_device);
     44 int platform_switch_voice_call_device_pre(void *platform);
     45 int platform_switch_voice_call_enable_device_config(void *platform,
     46                                                     snd_device_t out_snd_device,
     47                                                     snd_device_t in_snd_device);
     48 int platform_switch_voice_call_device_post(void *platform,
     49                                            snd_device_t out_snd_device,
     50                                            snd_device_t in_snd_device);
     51 int platform_switch_voice_call_usecase_route_post(void *platform,
     52                                                   snd_device_t out_snd_device,
     53                                                   snd_device_t in_snd_device);
     54 int platform_start_voice_call(void *platform, uint32_t vsid);
     55 int platform_stop_voice_call(void *platform, uint32_t vsid);
     56 int platform_set_voice_volume(void *platform, int volume);
     57 void platform_set_speaker_gain_in_combo(struct audio_device *adev,
     58                                         snd_device_t snd_device,
     59                                         bool enable);
     60 int platform_set_mic_mute(void *platform, bool state);
     61 int platform_get_sample_rate(void *platform, uint32_t *rate);
     62 int platform_set_device_mute(void *platform, bool state, char *dir);
     63 snd_device_t platform_get_output_snd_device(void *platform, audio_devices_t devices);
     64 snd_device_t platform_get_input_snd_device(void *platform, audio_devices_t out_device);
     65 int platform_set_hdmi_channels(void *platform, int channel_count);
     66 int platform_edid_get_max_channels(void *platform);
     67 void platform_add_operator_specific_device(snd_device_t snd_device,
     68                                            const char *operator,
     69                                            const char *mixer_path,
     70                                            unsigned int acdb_id);
     71 /* return true if adding entry success
     72    return false if adding entry fails */
     73 
     74 bool platform_add_gain_level_mapping(struct amp_db_and_gain_table *tbl_entry);
     75 
     76 /* return 0 if no custome mapping table found or when error detected
     77             use default mapping in this case
     78    return > 0 indicates number of entries in mapping table */
     79 
     80 int platform_get_gain_level_mapping(struct amp_db_and_gain_table *mapping_tbl,
     81                                     int table_size);
     82 
     83 /* returns the latency for a usecase in Us */
     84 int64_t platform_render_latency(audio_usecase_t usecase);
     85 
     86 int platform_set_incall_recording_session_id(void *platform,
     87                                              uint32_t session_id, int rec_mode);
     88 int platform_stop_incall_recording_usecase(void *platform);
     89 int platform_start_incall_music_usecase(void *platform);
     90 int platform_stop_incall_music_usecase(void *platform);
     91 
     92 int platform_set_snd_device_backend(snd_device_t snd_device, const char * backend,
     93                                     const char * hw_interface);
     94 
     95 /* From platform_info.c */
     96 int platform_info_init(const char *filename, void *);
     97 
     98 int platform_get_usecase_index(const char * usecase);
     99 int platform_set_usecase_pcm_id(audio_usecase_t usecase, int32_t type, int32_t pcm_id);
    100 void platform_set_echo_reference(struct audio_device *adev, bool enable, audio_devices_t out_device);
    101 int platform_swap_lr_channels(struct audio_device *adev, bool swap_channels);
    102 
    103 int platform_can_split_snd_device(snd_device_t in_snd_device,
    104                                   int *num_devices,
    105                                   snd_device_t *out_snd_devices);
    106 
    107 bool platform_check_backends_match(snd_device_t snd_device1, snd_device_t snd_device2);
    108 
    109 int platform_set_parameters(void *platform, struct str_parms *parms);
    110 
    111 bool platform_check_and_set_capture_backend_cfg(struct audio_device* adev,
    112                    struct audio_usecase *usecase, snd_device_t snd_device);
    113 
    114 int platform_snd_card_update(void *platform, enum card_status_t status);
    115 #endif // AUDIO_PLATFORM_API_H
    116