blob: 965ac62c9b7f1a5394a386f9a9206d546a646d91 [file] [log] [blame]
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -08001/*
Shiv Maliyappanahalli34b585f2013-10-01 15:49:05 -07002 * Copyright (c) 2013, The Linux Foundation. All rights reserved.
3 * Not a contribution.
4 *
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -08005 * Copyright (C) 2013 The Android Open Source Project
6 *
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
10 *
11 * http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
18 */
19
Eric Laurentb23d5282013-05-14 15:27:20 -070020#ifndef QCOM_AUDIO_HW_H
21#define QCOM_AUDIO_HW_H
22
23#include <cutils/list.h>
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080024#include <hardware/audio.h>
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080025#include <tinyalsa/asoundlib.h>
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -070026#include <tinycompress/tinycompress.h>
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080027
28#include <audio_route/audio_route.h>
Shiv Maliyappanahalli34b585f2013-10-01 15:49:05 -070029#include "voice.h"
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080030
Eric Laurentc4aef752013-09-12 17:45:53 -070031#define VISUALIZER_LIBRARY_PATH "/system/lib/soundfx/libqcomvisualizer.so"
32
Eric Laurentb23d5282013-05-14 15:27:20 -070033/* Flags used to initialize acdb_settings variable that goes to ACDB library */
34#define DMIC_FLAG 0x00000002
Mingming Yin8e5a4f62013-10-07 15:23:41 -070035#define QMIC_FLAG 0x00000004
Eric Laurentb23d5282013-05-14 15:27:20 -070036#define TTY_MODE_OFF 0x00000010
37#define TTY_MODE_FULL 0x00000020
38#define TTY_MODE_VCO 0x00000040
39#define TTY_MODE_HCO 0x00000080
40#define TTY_MODE_CLEAR 0xFFFFFF0F
41
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080042#define ACDB_DEV_TYPE_OUT 1
43#define ACDB_DEV_TYPE_IN 2
44
Eric Laurentb23d5282013-05-14 15:27:20 -070045#define MAX_SUPPORTED_CHANNEL_MASKS 2
Eric Laurent07eeafd2013-10-06 12:52:49 -070046#define DEFAULT_HDMI_OUT_CHANNELS 2
Ravi Kumar Alamanda72c411f2013-02-12 02:09:33 -080047
Eric Laurentb23d5282013-05-14 15:27:20 -070048typedef int snd_device_t;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080049
50/* These are the supported use cases by the hardware.
51 * Each usecase is mapped to a specific PCM device.
52 * Refer to pcm_device_table[].
53 */
54typedef enum {
55 USECASE_INVALID = -1,
56 /* Playback usecases */
57 USECASE_AUDIO_PLAYBACK_DEEP_BUFFER = 0,
58 USECASE_AUDIO_PLAYBACK_LOW_LATENCY,
59 USECASE_AUDIO_PLAYBACK_MULTI_CH,
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -070060 USECASE_AUDIO_PLAYBACK_OFFLOAD,
Shruthi Krishnaace10852013-10-25 14:32:12 -070061
Apoorv Raghuvanshi6e262842013-10-06 14:39:35 -070062 /* FM usecase */
63 USECASE_AUDIO_PLAYBACK_FM,
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080064
65 /* Capture usecases */
66 USECASE_AUDIO_RECORD,
67 USECASE_AUDIO_RECORD_LOW_LATENCY,
68
Shiv Maliyappanahalli34b585f2013-10-01 15:49:05 -070069 /* Voice usecase */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080070 USECASE_VOICE_CALL,
71
Shiv Maliyappanahalli34b585f2013-10-01 15:49:05 -070072 /* Voice extension usecases */
73 USECASE_VOICE2_CALL,
74 USECASE_VOLTE_CALL,
75 USECASE_QCHAT_CALL,
76
Shiv Maliyappanahallida107642013-10-17 11:16:13 -070077 USECASE_INCALL_REC_UPLINK,
78 USECASE_INCALL_REC_DOWNLINK,
79 USECASE_INCALL_REC_UPLINK_AND_DOWNLINK,
80
Shiv Maliyappanahallif3b9a422013-10-22 16:38:08 -070081 USECASE_INCALL_MUSIC_UPLINK,
82 USECASE_INCALL_MUSIC_UPLINK2,
83
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080084 AUDIO_USECASE_MAX
85} audio_usecase_t;
86
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080087#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
88
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080089/*
90 * tinyAlsa library interprets period size as number of frames
91 * one frame = channel_count * sizeof (pcm sample)
92 * so if format = 16-bit PCM and channels = Stereo, frame size = 2 ch * 2 = 4 bytes
93 * DEEP_BUFFER_OUTPUT_PERIOD_SIZE = 1024 means 1024 * 4 = 4096 bytes
94 * We should take care of returning proper size when AudioFlinger queries for
95 * the buffer size of an input/output stream
96 */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -080097
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -070098enum {
99 OFFLOAD_CMD_EXIT, /* exit compress offload thread loop*/
100 OFFLOAD_CMD_DRAIN, /* send a full drain request to DSP */
101 OFFLOAD_CMD_PARTIAL_DRAIN, /* send a partial drain request to DSP */
102 OFFLOAD_CMD_WAIT_FOR_BUFFER, /* wait for buffer released by DSP */
103};
104
105enum {
106 OFFLOAD_STATE_IDLE,
107 OFFLOAD_STATE_PLAYING,
108 OFFLOAD_STATE_PAUSED,
109};
110
111struct offload_cmd {
112 struct listnode node;
113 int cmd;
114 int data[];
115};
116
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800117struct stream_out {
118 struct audio_stream_out stream;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800119 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700120 pthread_cond_t cond;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800121 struct pcm_config config;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700122 struct compr_config compr_config;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800123 struct pcm *pcm;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700124 struct compress *compr;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800125 int standby;
126 int pcm_device_id;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700127 unsigned int sample_rate;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800128 audio_channel_mask_t channel_mask;
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700129 audio_format_t format;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800130 audio_devices_t devices;
131 audio_output_flags_t flags;
132 audio_usecase_t usecase;
133 /* Array of supported channel mask configurations. +1 so that the last entry is always 0 */
134 audio_channel_mask_t supported_channel_masks[MAX_SUPPORTED_CHANNEL_MASKS + 1];
Eric Laurenta9024de2013-04-04 09:19:12 -0700135 bool muted;
Glenn Kasten2ccd7ba2013-09-10 09:04:31 -0700136 uint64_t written; /* total frames written, not cleared when entering standby */
Eric Laurentc4aef752013-09-12 17:45:53 -0700137 audio_io_handle_t handle;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800138
Ravi Kumar Alamanda4e02e552013-07-17 15:22:04 -0700139 int non_blocking;
140 int playback_started;
141 int offload_state;
142 pthread_cond_t offload_cond;
143 pthread_t offload_thread;
144 struct listnode offload_cmd_list;
145 bool offload_thread_blocked;
146
147 stream_callback_t offload_callback;
148 void *offload_cookie;
Haynes Mathew George352f27b2013-07-26 00:00:15 -0700149 struct compr_gapless_mdata gapless_mdata;
150 int send_new_metadata;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800151
152 struct audio_device *dev;
153};
154
155struct stream_in {
156 struct audio_stream_in stream;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800157 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800158 struct pcm_config config;
159 struct pcm *pcm;
160 int standby;
161 int source;
162 int pcm_device_id;
163 int device;
164 audio_channel_mask_t channel_mask;
165 audio_usecase_t usecase;
Ravi Kumar Alamandaf70ffb42013-04-16 15:55:53 -0700166 bool enable_aec;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800167
168 struct audio_device *dev;
169};
170
171typedef enum {
172 PCM_PLAYBACK,
173 PCM_CAPTURE,
174 VOICE_CALL
175} usecase_type_t;
176
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800177union stream_ptr {
178 struct stream_in *in;
179 struct stream_out *out;
180};
181
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800182struct audio_usecase {
Ravi Kumar Alamanda3b1816c2013-02-27 23:01:21 -0800183 struct listnode list;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800184 audio_usecase_t id;
185 usecase_type_t type;
186 audio_devices_t devices;
Ravi Kumar Alamanda71c84b72013-03-10 23:50:28 -0700187 snd_device_t out_snd_device;
188 snd_device_t in_snd_device;
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800189 union stream_ptr stream;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800190};
191
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800192struct audio_device {
193 struct audio_hw_device device;
Eric Laurent150dbfe2013-02-27 14:31:02 -0800194 pthread_mutex_t lock; /* see note below on mutex acquisition order */
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800195 struct mixer *mixer;
196 audio_mode_t mode;
197 audio_devices_t out_device;
Eric Laurentc8400632013-02-14 19:04:54 -0800198 struct stream_in *active_input;
Ravi Kumar Alamanda096c87f2013-02-28 20:54:57 -0800199 struct stream_out *primary_output;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800200 bool bluetooth_nrec;
201 bool screen_off;
Eric Laurentb23d5282013-05-14 15:27:20 -0700202 int *snd_dev_ref_cnt;
Ravi Kumar Alamanda3b1816c2013-02-27 23:01:21 -0800203 struct listnode usecase_list;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800204 struct audio_route *audio_route;
205 int acdb_settings;
Jean-Michel Trivic56336b2013-05-24 16:55:17 -0700206 bool speaker_lr_swap;
Shiv Maliyappanahalli34b585f2013-10-01 15:49:05 -0700207 struct voice voice;
Eric Laurent07eeafd2013-10-06 12:52:49 -0700208 unsigned int cur_hdmi_channels;
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800209
Eric Laurentb23d5282013-05-14 15:27:20 -0700210 void *platform;
Eric Laurentc4aef752013-09-12 17:45:53 -0700211
212 void *visualizer_lib;
213 int (*visualizer_start_output)(audio_io_handle_t);
214 int (*visualizer_stop_output)(audio_io_handle_t);
Ravi Kumar Alamanda2dfba2b2013-01-17 16:50:22 -0800215};
216
Apoorv Raghuvanshi6e262842013-10-06 14:39:35 -0700217int select_devices(struct audio_device *adev,
218 audio_usecase_t uc_id);
219int disable_audio_route(struct audio_device *adev,
220 struct audio_usecase *usecase,
221 bool update_mixer);
222int disable_snd_device(struct audio_device *adev,
223 snd_device_t snd_device,
224 bool update_mixer);
225struct audio_usecase *get_usecase_from_list(struct audio_device *adev,
226 audio_usecase_t uc_id);
Eric Laurent150dbfe2013-02-27 14:31:02 -0800227/*
228 * NOTE: when multiple mutexes have to be acquired, always take the
229 * stream_in or stream_out mutex first, followed by the audio_device mutex.
230 */
231
Eric Laurentb23d5282013-05-14 15:27:20 -0700232#endif // QCOM_AUDIO_HW_H