firmware/export/audiohw.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2007 by Christian Gmeiner
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21
  22 #ifndef _AUDIOHW_H_
  23 #define _AUDIOHW_H_
  24
  25 #include "config.h"
  26 #include <stdbool.h>
  27
  28 /* define some audiohw caps */
  29 #define TREBLE_CAP            (1 << 0)
  30 #define BASS_CAP              (1 << 1)
  31 #define BALANCE_CAP           (1 << 2)
  32 #define CLIPPING_CAP          (1 << 3)
  33 #define PRESCALER_CAP         (1 << 4)
  34 #define BASS_CUTOFF_CAP       (1 << 5)
  35 #define TREBLE_CUTOFF_CAP     (1 << 6)
  36 #define EQ_CAP                (1 << 7)
  37 #define DEPTH_3D_CAP          (1 << 8)
  38
  39 #ifdef HAVE_UDA1380
  40 #include "uda1380.h"
  41 #elif defined(HAVE_UDA1341)
  42 #include "uda1341.h"
  43 #elif defined(HAVE_WM8750) || defined(HAVE_WM8751)
  44 #include "wm8751.h"
  45 #elif defined(HAVE_WM8978)
  46 #include "wm8978.h"
  47 #elif defined(HAVE_WM8975)
  48 #include "wm8975.h"
  49 #elif defined(HAVE_WM8985)
  50 #include "wm8985.h"
  51 #elif defined(HAVE_WM8758)
  52 #include "wm8758.h"
  53 #elif defined(HAVE_WM8711) || defined(HAVE_WM8721) || \
  54       defined(HAVE_WM8731)
  55 #include "wm8731.h"
  56 #elif defined(HAVE_TLV320)
  57 #include "tlv320.h"
  58 #elif defined(HAVE_AS3514)
  59 #include "as3514.h"
  60 #elif defined(HAVE_MAS35XX)
  61 #include "mas35xx.h"
  62 #elif defined(HAVE_TSC2100)
  63 #include "tsc2100.h"
  64 #elif defined(HAVE_JZ4740_CODEC)
  65 #include "jz4740-codec.h"
  66 #elif defined(HAVE_AK4537)
  67 #include "ak4537.h"
  68 #endif
  69
  70
  71
  72 #define ONE_DB 10
  73
  74 #if !defined(VOLUME_MIN) && !defined(VOLUME_MAX)
  75 #warning define for VOLUME_MIN and VOLUME_MAX is missing
  76 #define VOLUME_MIN -700
  77 #define VOLUME_MAX  0
  78 #endif
  79
  80 #ifndef AUDIOHW_NUM_TONE_CONTROLS
  81 #define AUDIOHW_NUM_TONE_CONTROLS 0
  82 #endif
  83
  84 /* volume/balance/treble/bass interdependency main part */
  85 #define VOLUME_RANGE (VOLUME_MAX - VOLUME_MIN)
  86
  87
  88 /* convert caps into defines */
  89 #ifdef AUDIOHW_CAPS
  90 /* Tone controls */
  91 #if (AUDIOHW_CAPS & TREBLE_CAP)
  92 #define AUDIOHW_HAVE_TREBLE
  93 #endif
  94
  95 #if (AUDIOHW_CAPS & BASS_CAP)
  96 #define AUDIOHW_HAVE_BASS
  97 #endif
  98
  99 #if (AUDIOHW_CAPS & BASS_CUTOFF_CAP)
 100 #define AUDIOHW_HAVE_BASS_CUTOFF
 101 #endif
 102
 103 #if (AUDIOHW_CAPS & TREBLE_CUTOFF_CAP)
 104 #define AUDIOHW_HAVE_TREBLE_CUTOFF
 105 #endif
 106
 107 #if (AUDIOHW_CAPS & BALANCE_CAP)
 108 #define AUDIOHW_HAVE_BALANCE
 109 #endif
 110
 111 #if (AUDIOHW_CAPS & CLIPPING_CAP)
 112 #define AUDIOHW_HAVE_CLIPPING
 113 #endif
 114
 115 #if (AUDIOHW_CAPS & PRESCALER_CAP)
 116 #define AUDIOHW_HAVE_PRESCALER
 117 #endif
 118
 119 /* Hardware EQ tone controls */
 120 #if (AUDIOHW_CAPS & EQ_CAP)
 121 /* A hardware equalizer is present (or perhaps some tone control variation
 122  * that is not Bass and/or Treble) */
 123 #define AUDIOHW_HAVE_EQ
 124
 125 /* Defined band indexes for supported bands */
 126 enum
 127 {
 128     /* Band 1 is implied; bands must be contiguous, 1 to N */
 129     AUDIOHW_EQ_BAND1 = 0,
 130 #define AUDIOHW_HAVE_EQ_BAND1
 131 #if (AUDIOHW_EQ_BAND_CAPS & (EQ_CAP << 1))
 132     AUDIOHW_EQ_BAND2,
 133 #define AUDIOHW_HAVE_EQ_BAND2
 134 #if (AUDIOHW_EQ_BAND_CAPS & (EQ_CAP << 2))
 135     AUDIOHW_EQ_BAND3,
 136 #define AUDIOHW_HAVE_EQ_BAND3
 137 #if (AUDIOHW_EQ_BAND_CAPS & (EQ_CAP << 3))
 138     AUDIOHW_EQ_BAND4,
 139 #define AUDIOHW_HAVE_EQ_BAND4
 140 #if (AUDIOHW_EQ_BAND_CAPS & (EQ_CAP << 4))
 141     AUDIOHW_EQ_BAND5,
 142 #define AUDIOHW_HAVE_EQ_BAND5
 143 #endif /* 5 */
 144 #endif /* 4 */
 145 #endif /* 3 */
 146 #endif /* 2 */
 147     AUDIOHW_EQ_BAND_NUM, /* Keep last */
 148 };
 149
 150 #ifdef AUDIOHW_EQ_FREQUENCY_CAPS
 151 /* One or more bands supports frequency cutoff or center adjustment */
 152 #define AUDIOHW_HAVE_EQ_FREQUENCY
 153 enum
 154 {
 155     __AUDIOHW_EQ_BAND_FREQUENCY = -1,
 156 #if defined(AUDIOHW_HAVE_EQ_BAND1) && \
 157         (AUDIOHW_EQ_FREQUENCY_CAPS & (EQ_CAP << 0))
 158     AUDIOHW_EQ_BAND1_FREQUENCY,
 159 #define AUDIOHW_HAVE_EQ_BAND1_FREQUENCY
 160 #endif
 161 #if defined(AUDIOHW_HAVE_EQ_BAND2) && \
 162         (AUDIOHW_EQ_FREQUENCY_CAPS & (EQ_CAP << 1))
 163     AUDIOHW_EQ_BAND2_FREQUENCY,
 164 #define AUDIOHW_HAVE_EQ_BAND2_FREQUENCY
 165 #endif
 166 #if defined(AUDIOHW_HAVE_EQ_BAND3) && \
 167         (AUDIOHW_EQ_FREQUENCY_CAPS & (EQ_CAP << 2))
 168     AUDIOHW_EQ_BAND3_FREQUENCY,
 169 #define AUDIOHW_HAVE_EQ_BAND3_FREQUENCY
 170 #endif
 171 #if defined(AUDIOHW_HAVE_EQ_BAND4) && \
 172         (AUDIOHW_EQ_FREQUENCY_CAPS & (EQ_CAP << 3))
 173     AUDIOHW_EQ_BAND4_FREQUENCY,
 174 #define AUDIOHW_HAVE_EQ_BAND4_FREQUENCY
 175 #endif
 176 #if defined(AUDIOHW_HAVE_EQ_BAND5) && \
 177         (AUDIOHW_EQ_FREQUENCY_CAPS & (EQ_CAP << 4))
 178     AUDIOHW_EQ_BAND5_FREQUENCY,
 179 #define AUDIOHW_HAVE_EQ_BAND5_FREQUENCY
 180 #endif
 181     AUDIOHW_EQ_FREQUENCY_NUM,
 182 };
 183 #endif /* AUDIOHW_EQ_FREQUENCY_CAPS */
 184
 185 #ifdef AUDIOHW_EQ_WIDTH_CAPS
 186 /* One or more bands supports bandwidth adjustment */
 187 #define AUDIOHW_HAVE_EQ_WIDTH
 188 enum
 189 {
 190     __AUDIOHW_EQ_BAND_WIDTH = -1,
 191 #if defined(AUDIOHW_HAVE_EQ_BAND1) && \
 192         (AUDIOHW_EQ_WIDTH_CAPS & (EQ_CAP << 1))
 193     AUDIOHW_EQ_BAND2_WIDTH,
 194 #define AUDIOHW_HAVE_EQ_BAND2_WIDTH
 195 #endif
 196 #if defined(AUDIOHW_HAVE_EQ_BAND2) && \
 197         (AUDIOHW_EQ_WIDTH_CAPS & (EQ_CAP << 2))
 198     AUDIOHW_EQ_BAND3_WIDTH,
 199 #define AUDIOHW_HAVE_EQ_BAND3_WIDTH
 200 #endif
 201 #if defined(AUDIOHW_HAVE_EQ_BAND3) && \
 202         (AUDIOHW_EQ_WIDTH_CAPS & (EQ_CAP << 3))
 203     AUDIOHW_EQ_BAND4_WIDTH,
 204 #define AUDIOHW_HAVE_EQ_BAND4_WIDTH
 205 #endif
 206     AUDIOHW_EQ_WIDTH_NUM, /* Keep last */
 207 };
 208 #endif /* AUDIOHW_EQ_WIDTH_CAPS */
 209
 210 /* Types and number of settings types (gain, frequency, width) */
 211 enum AUDIOHW_EQ_SETTINGS
 212 {
 213     AUDIOHW_EQ_GAIN = 0,
 214 #ifdef AUDIOHW_HAVE_EQ_FREQUENCY
 215     AUDIOHW_EQ_FREQUENCY,
 216 #endif
 217 #ifdef AUDIOHW_HAVE_EQ_WIDTH
 218     AUDIOHW_EQ_WIDTH,
 219 #endif
 220     AUDIOHW_EQ_SETTING_NUM
 221 };
 222
 223 #endif /* (AUDIOHW_CAPS & EQ_CAP) */
 224
 225 #if (AUDIOHW_CAPS & DEPTH_3D_CAP)
 226 #define AUDIOHW_HAVE_DEPTH_3D
 227 #endif
 228 #else
 229 #if defined (HAVE_SW_TONE_CONTROLS)
 230 /* Needed for proper sound support */
 231 #define AUDIOHW_HAVE_BASS
 232 #define AUDIOHW_HAVE_TREBLE
 233 #endif
 234 #endif /* AUDIOHW_CAPS */
 235
 236 enum {
 237     SOUND_VOLUME = 0,
 238 /* Tone control */
 239 #if defined(AUDIOHW_HAVE_BASS)
 240     SOUND_BASS,
 241 #endif
 242 #if defined(AUDIOHW_HAVE_TREBLE)
 243     SOUND_TREBLE,
 244 #endif
 245     SOUND_BALANCE,
 246     SOUND_CHANNELS,
 247     SOUND_STEREO_WIDTH,
 248 #if (CONFIG_CODEC == MAS3587F) || (CONFIG_CODEC == MAS3539F)
 249     SOUND_LOUDNESS,
 250     SOUND_AVC,
 251     SOUND_MDB_STRENGTH,
 252     SOUND_MDB_HARMONICS,
 253     SOUND_MDB_CENTER,
 254     SOUND_MDB_SHAPE,
 255     SOUND_MDB_ENABLE,
 256     SOUND_SUPERBASS,
 257 #endif
 258 #if defined(HAVE_RECORDING)
 259     SOUND_LEFT_GAIN,
 260     SOUND_RIGHT_GAIN,
 261     SOUND_MIC_GAIN,
 262 #endif
 263 /* Bass and treble tone controls */
 264 #if defined(AUDIOHW_HAVE_BASS_CUTOFF)
 265     SOUND_BASS_CUTOFF,
 266 #endif
 267 #if defined(AUDIOHW_HAVE_TREBLE_CUTOFF)
 268     SOUND_TREBLE_CUTOFF,
 269 #endif
 270 /* 3D effect */
 271 #if defined(AUDIOHW_HAVE_DEPTH_3D)
 272     SOUND_DEPTH_3D,
 273 #endif
 274 /* Hardware EQ tone controls */
 275 /* Band gains */
 276 #if defined(AUDIOHW_HAVE_EQ)
 277     /* Band 1 implied */
 278     SOUND_EQ_BAND1_GAIN,
 279 #if defined(AUDIOHW_HAVE_EQ_BAND2)
 280     SOUND_EQ_BAND2_GAIN,
 281 #endif
 282 #if defined(AUDIOHW_HAVE_EQ_BAND3)
 283     SOUND_EQ_BAND3_GAIN,
 284 #endif
 285 #if defined(AUDIOHW_HAVE_EQ_BAND4)
 286     SOUND_EQ_BAND4_GAIN,
 287 #endif
 288 #if defined(AUDIOHW_HAVE_EQ_BAND5)
 289     SOUND_EQ_BAND5_GAIN,
 290 #endif
 291 /* Band frequencies */
 292 #if defined(AUDIOHW_HAVE_EQ_BAND1_FREQUENCY)
 293     SOUND_EQ_BAND1_FREQUENCY,
 294 #endif
 295 #if defined(AUDIOHW_HAVE_EQ_BAND2_FREQUENCY)
 296     SOUND_EQ_BAND2_FREQUENCY,
 297 #endif
 298 #if defined(AUDIOHW_HAVE_EQ_BAND3_FREQUENCY)
 299     SOUND_EQ_BAND3_FREQUENCY,
 300 #endif
 301 #if defined(AUDIOHW_HAVE_EQ_BAND4_FREQUENCY)
 302     SOUND_EQ_BAND4_FREQUENCY,
 303 #endif
 304 #if defined(AUDIOHW_HAVE_EQ_BAND5_FREQUENCY)
 305     SOUND_EQ_BAND5_FREQUENCY,
 306 #endif
 307 /* Band widths */
 308 #if defined(AUDIOHW_HAVE_EQ_BAND2_WIDTH)
 309     SOUND_EQ_BAND2_WIDTH,
 310 #endif
 311 #if defined(AUDIOHW_HAVE_EQ_BAND3_WIDTH)
 312     SOUND_EQ_BAND3_WIDTH,
 313 #endif
 314 #if defined(AUDIOHW_HAVE_EQ_BAND4_WIDTH)
 315     SOUND_EQ_BAND4_WIDTH,
 316 #endif
 317 #endif /* AUDIOHW_HAVE_EQ */
 318     SOUND_LAST_SETTING, /* Keep this last */
 319 };
 320
 321 enum Channel {
 322     SOUND_CHAN_STEREO,
 323     SOUND_CHAN_MONO,
 324     SOUND_CHAN_CUSTOM,
 325     SOUND_CHAN_MONO_LEFT,
 326     SOUND_CHAN_MONO_RIGHT,
 327     SOUND_CHAN_KARAOKE,
 328     SOUND_CHAN_NUM_MODES,
 329 };
 330
 331 struct sound_settings_info {
 332     const char *unit;
 333     char numdecimals;
 334     char steps;
 335     short minval;
 336     short maxval;
 337     short defaultval;
 338 };
 339
 340 /* This struct is used by every driver to export its min/max/default values for
 341  * its audio settings. Keep in mind that the order must be correct! */
 342 extern const struct sound_settings_info audiohw_settings[];
 343
 344 /* All usable functions implemented by a audio codec drivers. Most of
 345  * the function in sound settings are only called, when in audio codecs
 346  * .h file suitable defines are added.
 347  */
 348
 349 /**
 350  * Initialize audio codec to a well defined state. Includes SoC-specific
 351  * setup.
 352  */
 353 void audiohw_init(void);
 354
 355 /**
 356  * Do initial audio codec setup. Usually called from audiohw_init.
 357  */
 358 void audiohw_preinit(void);
 359
 360 /**
 361  * Do some stuff (codec related) after audiohw_init that needs to be
 362  * delayed such as enabling outputs to prevent popping. This lets
 363  * other inits in the system complete in the meantime.
 364  */
 365 void audiohw_postinit(void);
 366
 367 /**
 368  * Close audio codec.
 369  */
 370 void audiohw_close(void);
 371
 372 #ifdef AUDIOHW_HAVE_CLIPPING
 373  /**
 374  * Set new volume value
 375  * @param val to set.
 376  * NOTE: AUDIOHW_CAPS need to contain
 377  *          CLIPPING_CAP
 378  */
 379 void audiohw_set_volume(int val);
 380 #endif
 381
 382 #ifdef AUDIOHW_HAVE_PRESCALER
 383 /**
 384  * Set new prescaler value.
 385  * @param val to set.
 386  * NOTE: AUDIOHW_CAPS need to contain
 387  *          PRESCALER_CAP
 388  */
 389 void audiohw_set_prescaler(int val);
 390 #endif
 391
 392 #ifdef AUDIOHW_HAVE_BALANCE
 393 /**
 394  * Set new balance value
 395  * @param val to set.
 396  * NOTE: AUDIOHW_CAPS need to contain
 397  *          BALANCE_CAP
 398  */
 399 void audiohw_set_balance(int val);
 400 #endif
 401
 402 #ifdef AUDIOHW_HAVE_TREBLE
 403 /**
 404  * Set new treble value.
 405  * @param val to set.
 406  * NOTE: AUDIOHW_CAPS need to contain
 407  *          TREBLE_CAP
 408  */
 409 void audiohw_set_treble(int val);
 410 #endif
 411
 412 #ifdef AUDIOHW_HAVE_BASS
 413 /**
 414  * Set new bass value.
 415  * @param val to set.
 416  * NOTE: AUDIOHW_CAPS need to contain
 417  *          BASS_CAP
 418  */
 419 void audiohw_set_bass(int val);
 420 #endif
 421
 422 #ifdef AUDIOHW_HAVE_BASS_CUTOFF
 423 /**
 424  * Set new bass cut off value.
 425  * @param val to set.
 426  * NOTE: AUDIOHW_CAPS need to contain
 427  *          BASS_CUTOFF_CAP
 428  */
 429 void audiohw_set_bass_cutoff(int val);
 430 #endif
 431
 432 #ifdef AUDIOHW_HAVE_TREBLE_CUTOFF
 433 /**
 434  * Set new treble cut off value.
 435  * @param val to set.
 436  * NOTE: AUDIOHW_CAPS need to contain
 437  *          TREBLE_CUTOFF_CAP
 438  */
 439 void audiohw_set_treble_cutoff(int val);
 440 #endif
 441
 442 #ifdef AUDIOHW_HAVE_EQ
 443 /**
 444  * Set new band gain value.
 445  * @param band index to which val is set
 446  * @param val to set.
 447  * NOTE: AUDIOHW_CAPS need to contain
 448  *          EQ_CAP
 449  *
 450  *       AUDIOHW_EQ_BAND_CAPS must be defined as a bitmask
 451  *       of EQ_CAP each shifted by the zero-based band number
 452  *       for each band. Bands 1 to N are indexed 0 to N-1.
 453  */
 454 void audiohw_set_eq_band_gain(unsigned int band, int val);
 455 #endif
 456
 457 #ifdef AUDIOHW_HAVE_EQ_FREQUENCY
 458 /**
 459  * Set new band cutoff or center frequency value.
 460  * @param band index to which val is set
 461  * @param val to set.
 462  * NOTE: AUDIOHW_CAPS need to contain
 463  *          EQ_CAP
 464  *
 465  *       AUDIOHW_EQ_FREQUENCY_CAPS must be defined as a bitmask
 466  *       of EQ_CAP each shifted by the zero-based band number
 467  *       for each band that supports frequency adjustment.
 468  *       Bands 1 to N are indexed 0 to N-1.
 469  */
 470 void audiohw_set_eq_band_frequency(unsigned int band, int val);
 471 #endif
 472
 473 #ifdef AUDIOHW_HAVE_EQ_WIDTH
 474 /**
 475  * Set new band cutoff or center frequency value.
 476  * @param band index to which val is set
 477  * @param val to set.
 478  * NOTE: AUDIOHW_CAPS need to contain
 479  *          EQ_CAP
 480  *
 481  *       AUDIOHW_EQ_WIDTH_CAPS must be defined as a bitmask
 482  *       of EQ_CAP each shifted by the zero-based band number
 483  *       for each band that supports width adjustment.
 484  *       Bands 1 to N are indexed 0 to N-1.
 485  */
 486 void audiohw_set_eq_band_width(unsigned int band, int val);
 487 #endif
 488
 489 #ifdef AUDIOHW_HAVE_DEPTH_3D
 490 /**
 491  * Set new 3-d enhancement (stereo expansion) effect value.
 492  * @param val to set.
 493  * NOTE: AUDIOHW_CAPS need to contain
 494  *          DEPTH_3D_CAP
 495  */
 496 void audiohw_set_depth_3d(int val);
 497 #endif
 498
 499
 500 void audiohw_set_frequency(int fsel);
 501
 502 #ifdef HAVE_RECORDING
 503
 504 /**
 505  * Enable recording.
 506  * @param source_mic if this is true, we want to record from microphone,
 507  *                   else we want to record FM/LineIn.
 508  */
 509 void audiohw_enable_recording(bool source_mic);
 510
 511 /**
 512  * Disable recording.
 513  */
 514 void audiohw_disable_recording(void);
 515
 516 /**
 517  * Set gain of recording source.
 518  * @param left gain value.
 519  * @param right will not be used if recording from micophone (mono).
 520  * @param type AUDIO_GAIN_MIC, AUDIO_GAIN_LINEIN.
 521  */
 522 void audiohw_set_recvol(int left, int right, int type);
 523
 524 #endif /*HAVE_RECORDING*/
 525
 526 #if defined(HAVE_RECORDING) || defined(HAVE_FMRADIO_IN)
 527
 528 /**
 529  * Enable or disable recording monitor.
 530  * @param enable ture or false.
 531  */
 532 void audiohw_set_monitor(bool enable);
 533
 534 #endif /* HAVE_RECORDING || HAVE_FMRADIO_IN */
 535
 536 #if CONFIG_CODEC != SWCODEC
 537
 538 /* functions which are only used by mas35xx codecs, but are also
 539    aviable on SWCODECS through dsp */
 540
 541 /**
 542  * Set channel configuration.
 543  * @param val new channel value (see enum Channel).
 544  */
 545 void audiohw_set_channel(int val);
 546
 547 /**
 548  * Set stereo width.
 549  * @param val new stereo width value.
 550  */
 551 void audiohw_set_stereo_width(int val);
 552
 553 #endif /* CONFIG_CODEC != SWCODEC */
 554
 555 #ifdef HAVE_SPEAKER
 556
 557 void audiohw_enable_speaker(bool on);
 558
 559 #endif /* HAVE_SPEAKER */
 560
 561 #endif /* _AUDIOHW_H_ */