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