pcxhr.h 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189
  1. /*
  2. * Driver for Digigram pcxhr soundcards
  3. *
  4. * main header file
  5. *
  6. * Copyright (c) 2004 by Digigram <alsa@digigram.com>
  7. *
  8. * This program is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation; either version 2 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * This program is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License
  19. * along with this program; if not, write to the Free Software
  20. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  21. */
  22. #ifndef __SOUND_PCXHR_H
  23. #define __SOUND_PCXHR_H
  24. #include <linux/interrupt.h>
  25. #include <linux/mutex.h>
  26. #include <sound/pcm.h>
  27. #define PCXHR_DRIVER_VERSION 0x000804 /* 0.8.4 */
  28. #define PCXHR_DRIVER_VERSION_STRING "0.8.4" /* 0.8.4 */
  29. #define PCXHR_MAX_CARDS 6
  30. #define PCXHR_PLAYBACK_STREAMS 4
  31. #define PCXHR_GRANULARITY 96 /* transfer granularity (should be min 96 and multiple of 48) */
  32. #define PCXHR_GRANULARITY_MIN 96 /* transfer granularity of pipes and the dsp time (MBOX4) */
  33. struct snd_pcxhr;
  34. struct pcxhr_mgr;
  35. struct pcxhr_stream;
  36. struct pcxhr_pipe;
  37. enum pcxhr_clock_type {
  38. PCXHR_CLOCK_TYPE_INTERNAL = 0,
  39. PCXHR_CLOCK_TYPE_WORD_CLOCK,
  40. PCXHR_CLOCK_TYPE_AES_SYNC,
  41. PCXHR_CLOCK_TYPE_AES_1,
  42. PCXHR_CLOCK_TYPE_AES_2,
  43. PCXHR_CLOCK_TYPE_AES_3,
  44. PCXHR_CLOCK_TYPE_AES_4,
  45. };
  46. struct pcxhr_mgr {
  47. unsigned int num_cards;
  48. struct snd_pcxhr *chip[PCXHR_MAX_CARDS];
  49. struct pci_dev *pci;
  50. int irq;
  51. /* card access with 1 mem bar and 2 io bar's */
  52. unsigned long port[3];
  53. /* share the name */
  54. char shortname[32]; /* short name of this soundcard */
  55. char longname[96]; /* name of this soundcard */
  56. /* message tasklet */
  57. struct tasklet_struct msg_taskq;
  58. struct pcxhr_rmh *prmh;
  59. /* trigger tasklet */
  60. struct tasklet_struct trigger_taskq;
  61. spinlock_t lock; /* interrupt spinlock */
  62. spinlock_t msg_lock; /* message spinlock */
  63. struct mutex setup_mutex; /* mutex used in hw_params, open and close */
  64. struct mutex mixer_mutex; /* mutex for mixer */
  65. /* hardware interface */
  66. unsigned int dsp_loaded; /* bit flags of loaded dsp indices */
  67. unsigned int dsp_version; /* read from embedded once firmware is loaded */
  68. int board_has_analog; /* if 0 the board is digital only */
  69. int mono_capture; /* if 1 the board does mono capture */
  70. int playback_chips; /* 4 or 6 */
  71. int capture_chips; /* 4 or 1 */
  72. int firmware_num; /* 41 or 42 */
  73. struct snd_dma_buffer hostport;
  74. enum pcxhr_clock_type use_clock_type; /* clock type selected by mixer */
  75. enum pcxhr_clock_type cur_clock_type; /* current clock type synced */
  76. int sample_rate;
  77. int ref_count_rate;
  78. int timer_toggle; /* timer interrupt toggles between the two values 0x200 and 0x300 */
  79. int dsp_time_last; /* the last dsp time (read by interrupt) */
  80. int dsp_time_err; /* dsp time errors */
  81. unsigned int src_it_dsp; /* dsp interrupt source */
  82. unsigned int io_num_reg_cont; /* backup of IO_NUM_REG_CONT */
  83. unsigned int codec_speed; /* speed mode of the codecs */
  84. unsigned int sample_rate_real; /* current real sample rate */
  85. int last_reg_stat;
  86. int async_err_stream_xrun;
  87. int async_err_pipe_xrun;
  88. int async_err_other_last;
  89. };
  90. enum pcxhr_stream_status {
  91. PCXHR_STREAM_STATUS_FREE,
  92. PCXHR_STREAM_STATUS_OPEN,
  93. PCXHR_STREAM_STATUS_SCHEDULE_RUN,
  94. PCXHR_STREAM_STATUS_STARTED,
  95. PCXHR_STREAM_STATUS_RUNNING,
  96. PCXHR_STREAM_STATUS_SCHEDULE_STOP,
  97. PCXHR_STREAM_STATUS_STOPPED,
  98. PCXHR_STREAM_STATUS_PAUSED
  99. };
  100. struct pcxhr_stream {
  101. struct snd_pcm_substream *substream;
  102. snd_pcm_format_t format;
  103. struct pcxhr_pipe *pipe;
  104. enum pcxhr_stream_status status; /* free, open, running, draining, pause */
  105. u_int64_t timer_abs_periods; /* timer: samples elapsed since TRIGGER_START (multiple of period_size) */
  106. u_int32_t timer_period_frag; /* timer: samples elapsed since last call to snd_pcm_period_elapsed (0..period_size) */
  107. u_int32_t timer_buf_periods; /* nb of periods in the buffer that have already elapsed */
  108. int timer_is_synced; /* if(0) : timer needs to be resynced with real hardware pointer */
  109. int channels;
  110. };
  111. enum pcxhr_pipe_status {
  112. PCXHR_PIPE_UNDEFINED,
  113. PCXHR_PIPE_DEFINED
  114. };
  115. struct pcxhr_pipe {
  116. enum pcxhr_pipe_status status;
  117. int is_capture; /* this is a capture pipe */
  118. int first_audio; /* first audio num */
  119. };
  120. struct snd_pcxhr {
  121. struct snd_card *card;
  122. struct pcxhr_mgr *mgr;
  123. int chip_idx; /* zero based */
  124. struct snd_pcm *pcm; /* PCM */
  125. struct pcxhr_pipe playback_pipe; /* 1 stereo pipe only */
  126. struct pcxhr_pipe capture_pipe[2]; /* 1 stereo pipe or 2 mono pipes */
  127. struct pcxhr_stream playback_stream[PCXHR_PLAYBACK_STREAMS];
  128. struct pcxhr_stream capture_stream[2]; /* 1 stereo stream or 2 mono streams */
  129. int nb_streams_play;
  130. int nb_streams_capt;
  131. int analog_playback_active[2]; /* Mixer : Master Playback active (!mute) */
  132. int analog_playback_volume[2]; /* Mixer : Master Playback Volume */
  133. int analog_capture_volume[2]; /* Mixer : Master Capture Volume */
  134. int digital_playback_active[PCXHR_PLAYBACK_STREAMS][2]; /* Mixer : Digital Playback Active [streams][stereo]*/
  135. int digital_playback_volume[PCXHR_PLAYBACK_STREAMS][2]; /* Mixer : Digital Playback Volume [streams][stereo]*/
  136. int digital_capture_volume[2]; /* Mixer : Digital Capture Volume [stereo] */
  137. int monitoring_active[2]; /* Mixer : Monitoring Active */
  138. int monitoring_volume[2]; /* Mixer : Monitoring Volume */
  139. int audio_capture_source; /* Mixer : Audio Capture Source */
  140. unsigned char aes_bits[5]; /* Mixer : IEC958_AES bits */
  141. };
  142. struct pcxhr_hostport
  143. {
  144. char purgebuffer[6];
  145. char reserved[2];
  146. };
  147. /* exported */
  148. int pcxhr_create_pcm(struct snd_pcxhr *chip);
  149. int pcxhr_set_clock(struct pcxhr_mgr *mgr, unsigned int rate);
  150. int pcxhr_get_external_clock(struct pcxhr_mgr *mgr, enum pcxhr_clock_type clock_type, int *sample_rate);
  151. #endif /* __SOUND_PCXHR_H */