Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
pcxhr.h
Go to the documentation of this file.
1 /*
2  * Driver for Digigram pcxhr soundcards
3  *
4  * main header file
5  *
6  * Copyright (c) 2004 by Digigram <[email protected]>
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 
23 #ifndef __SOUND_PCXHR_H
24 #define __SOUND_PCXHR_H
25 
26 #include <linux/interrupt.h>
27 #include <linux/mutex.h>
28 #include <sound/pcm.h>
29 
30 #define PCXHR_DRIVER_VERSION 0x000906 /* 0.9.6 */
31 #define PCXHR_DRIVER_VERSION_STRING "0.9.6" /* 0.9.6 */
32 
33 
34 #define PCXHR_MAX_CARDS 6
35 #define PCXHR_PLAYBACK_STREAMS 4
36 
37 #define PCXHR_GRANULARITY 96 /* min 96 and multiple of 48 */
38 /* transfer granularity of pipes and the dsp time (MBOX4) */
39 #define PCXHR_GRANULARITY_MIN 96
40 /* TODO : granularity could be 64 or 128 */
41 #define PCXHR_GRANULARITY_HR22 192 /* granularity for stereo cards */
42 
43 struct snd_pcxhr;
44 struct pcxhr_mgr;
45 
46 struct pcxhr_stream;
47 struct pcxhr_pipe;
48 
62 };
63 
64 struct pcxhr_mgr {
65  unsigned int num_cards;
67 
68  struct pci_dev *pci;
69 
70  int irq;
71 
73 
74  /* card access with 1 mem bar and 2 io bar's */
75  unsigned long port[3];
76 
77  /* share the name */
78  char shortname[32]; /* short name of this soundcard */
79  char longname[96]; /* name of this soundcard */
80 
81  /* message tasklet */
83  struct pcxhr_rmh *prmh;
84  /* trigger tasklet */
86 
87  spinlock_t lock; /* interrupt spinlock */
88  spinlock_t msg_lock; /* message spinlock */
89 
90  struct mutex setup_mutex; /* mutex used in hw_params, open and close */
91  struct mutex mixer_mutex; /* mutex for mixer */
92 
93  /* hardware interface */
94  unsigned int dsp_loaded; /* bit flags of loaded dsp indices */
95  unsigned int dsp_version; /* read from embedded once firmware is loaded */
100  unsigned int is_hr_stereo:1;
101  unsigned int board_has_aes1:1; /* if 1 board has AES1 plug and SRC */
102  unsigned int board_has_analog:1; /* if 0 the board is digital only */
103  unsigned int board_has_mic:1; /* if 1 the board has microphone input */
104  unsigned int board_aes_in_192k:1;/* if 1 the aes input plugs do support 192kHz */
105  unsigned int mono_capture:1; /* if 1 the board does mono capture */
106  unsigned int capture_ltc:1; /* if 1 the board captures LTC input */
107 
109 
110  enum pcxhr_clock_type use_clock_type; /* clock type selected by mixer */
111  enum pcxhr_clock_type cur_clock_type; /* current clock type synced */
114  int timer_toggle; /* timer interrupt toggles between the two values 0x200 and 0x300 */
115  int dsp_time_last; /* the last dsp time (read by interrupt) */
116  int dsp_time_err; /* dsp time errors */
117  unsigned int src_it_dsp; /* dsp interrupt source */
118  unsigned int io_num_reg_cont; /* backup of IO_NUM_REG_CONT */
119  unsigned int codec_speed; /* speed mode of the codecs */
120  unsigned int sample_rate_real; /* current real sample rate */
125 
126  unsigned char xlx_cfg; /* copy of PCXHR_XLX_CFG register */
127  unsigned char xlx_selmic; /* copy of PCXHR_XLX_SELMIC register */
128  unsigned char dsp_reset; /* copy of PCXHR_DSP_RESET register */
129 };
130 
131 
141 };
142 
143 struct pcxhr_stream {
146  struct pcxhr_pipe *pipe;
147 
148  enum pcxhr_stream_status status; /* free, open, running, draining, pause */
149 
150  u_int64_t timer_abs_periods; /* timer: samples elapsed since TRIGGER_START (multiple of period_size) */
151  u_int32_t timer_period_frag; /* timer: samples elapsed since last call to snd_pcm_period_elapsed (0..period_size) */
152  u_int32_t timer_buf_periods; /* nb of periods in the buffer that have already elapsed */
153  int timer_is_synced; /* if(0) : timer needs to be resynced with real hardware pointer */
154 
155  int channels;
156 };
157 
158 
162 };
163 
164 struct pcxhr_pipe {
166  int is_capture; /* this is a capture pipe */
167  int first_audio; /* first audio num */
168 };
169 
170 
171 struct snd_pcxhr {
172  struct snd_card *card;
173  struct pcxhr_mgr *mgr;
174  int chip_idx; /* zero based */
175 
176  struct snd_pcm *pcm; /* PCM */
177 
178  struct pcxhr_pipe playback_pipe; /* 1 stereo pipe only */
179  struct pcxhr_pipe capture_pipe[2]; /* 1 stereo or 2 mono pipes */
180 
182  struct pcxhr_stream capture_stream[2]; /* 1 stereo or 2 mono streams */
185 
186  int analog_playback_active[2]; /* Mixer : Master Playback !mute */
187  int analog_playback_volume[2]; /* Mixer : Master Playback Volume */
188  int analog_capture_volume[2]; /* Mixer : Master Capture Volume */
191  int digital_capture_volume[2]; /* Mixer : Digital Capture Volume */
192  int monitoring_active[2]; /* Mixer : Monitoring Active */
193  int monitoring_volume[2]; /* Mixer : Monitoring Volume */
194  int audio_capture_source; /* Mixer : Audio Capture Source */
195  int mic_volume; /* used by cards with MIC only */
196  int mic_boost; /* used by cards with MIC only */
197  int mic_active; /* used by cards with MIC only */
198  int analog_capture_active; /* used by cards with MIC only */
199  int phantom_power; /* used by cards with MIC only */
200 
201  unsigned char aes_bits[5]; /* Mixer : IEC958_AES bits */
202 };
203 
205 {
206  char purgebuffer[6];
207  char reserved[2];
208 };
209 
210 /* exported */
211 int pcxhr_create_pcm(struct snd_pcxhr *chip);
212 int pcxhr_set_clock(struct pcxhr_mgr *mgr, unsigned int rate);
213 int pcxhr_get_external_clock(struct pcxhr_mgr *mgr,
214  enum pcxhr_clock_type clock_type,
215  int *sample_rate);
216 
217 #endif /* __SOUND_PCXHR_H */