scatterlist: add more safeguards
[linux-2.6] / include / sound / cs46xx_dsp_spos.h
1 /*
2  *  The driver for the Cirrus Logic's Sound Fusion CS46XX based soundcards
3  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
4  *
5  *
6  *   This program is free software; you can redistribute it and/or modify
7  *   it under the terms of the GNU General Public License as published by
8  *   the Free Software Foundation; either version 2 of the License, or
9  *   (at your option) any later version.
10  *
11  *   This program is distributed in the hope that it will be useful,
12  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *   GNU General Public License for more details.
15  *
16  *   You should have received a copy of the GNU General Public License
17  *   along with this program; if not, write to the Free Software
18  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
19  *
20  */
21
22 #ifndef __CS46XX_DSP_SPOS_H__
23 #define __CS46XX_DSP_SPOS_H__
24
25 #include "cs46xx_dsp_scb_types.h"
26 #include "cs46xx_dsp_task_types.h"
27
28 #define SYMBOL_CONSTANT  0x0
29 #define SYMBOL_SAMPLE    0x1
30 #define SYMBOL_PARAMETER 0x2
31 #define SYMBOL_CODE      0x3
32
33 #define SEGTYPE_SP_PROGRAM              0x00000001
34 #define SEGTYPE_SP_PARAMETER            0x00000002
35 #define SEGTYPE_SP_SAMPLE               0x00000003
36 #define SEGTYPE_SP_COEFFICIENT          0x00000004
37
38 #define DSP_SPOS_UU      0x0deadul     /* unused */
39 #define DSP_SPOS_DC      0x0badul      /* don't care */
40 #define DSP_SPOS_DC_DC   0x0bad0badul  /* don't care */
41 #define DSP_SPOS_UUUU    0xdeadc0edul  /* unused */
42 #define DSP_SPOS_UUHI    0xdeadul
43 #define DSP_SPOS_UULO    0xc0edul
44 #define DSP_SPOS_DCDC    0x0badf1d0ul  /* don't care */
45 #define DSP_SPOS_DCDCHI  0x0badul
46 #define DSP_SPOS_DCDCLO  0xf1d0ul
47
48 #define DSP_MAX_TASK_NAME   60
49 #define DSP_MAX_SYMBOL_NAME 100
50 #define DSP_MAX_SCB_NAME    60
51 #define DSP_MAX_SCB_DESC    200
52 #define DSP_MAX_TASK_DESC   50
53
54 #define DSP_MAX_PCM_CHANNELS 32
55 #define DSP_MAX_SRC_NR       14
56
57 #define DSP_PCM_MAIN_CHANNEL        1
58 #define DSP_PCM_REAR_CHANNEL        2
59 #define DSP_PCM_CENTER_LFE_CHANNEL  3
60 #define DSP_PCM_S71_CHANNEL         4 /* surround 7.1 */
61 #define DSP_IEC958_CHANNEL          5
62
63 #define DSP_SPDIF_STATUS_OUTPUT_ENABLED       1
64 #define DSP_SPDIF_STATUS_PLAYBACK_OPEN        2
65 #define DSP_SPDIF_STATUS_HW_ENABLED           4
66 #define DSP_SPDIF_STATUS_INPUT_CTRL_ENABLED   8
67
68 struct dsp_symbol_entry {
69         u32 address;
70         char symbol_name[DSP_MAX_SYMBOL_NAME];
71         int symbol_type;
72
73         /* initialized by driver */
74         struct dsp_module_desc * module;
75         int deleted;
76 };
77
78 struct dsp_symbol_desc {
79         int nsymbols;
80
81         struct dsp_symbol_entry *symbols;
82
83         /* initialized by driver */
84         int highest_frag_index;
85 };
86
87 struct dsp_segment_desc {
88         int segment_type;
89         u32 offset;
90         u32 size;
91         u32 * data;
92 };
93
94 struct dsp_module_desc {
95         char * module_name;
96         struct dsp_symbol_desc symbol_table;
97         int nsegments;
98         struct dsp_segment_desc * segments;
99
100         /* initialized by driver */
101         u32 overlay_begin_address;
102         u32 load_address;
103         int nfixups;
104 };
105
106 struct dsp_scb_descriptor {
107         char scb_name[DSP_MAX_SCB_NAME];
108         u32 address;
109         int index;
110         u32 *data;
111
112         struct dsp_scb_descriptor * sub_list_ptr;
113         struct dsp_scb_descriptor * next_scb_ptr;
114         struct dsp_scb_descriptor * parent_scb_ptr;
115
116         struct dsp_symbol_entry * task_entry;
117         struct dsp_symbol_entry * scb_symbol;
118
119         struct snd_info_entry *proc_info;
120         int ref_count;
121         spinlock_t lock;
122
123         int deleted;
124 };
125
126 struct dsp_task_descriptor {
127         char task_name[DSP_MAX_TASK_NAME];
128         int size;
129         u32 address;
130         int index;
131         u32 *data;
132 };
133
134 struct dsp_pcm_channel_descriptor {
135         int active;
136         int src_slot;
137         int pcm_slot;
138         u32 sample_rate;
139         u32 unlinked;
140         struct dsp_scb_descriptor * pcm_reader_scb;
141         struct dsp_scb_descriptor * src_scb;
142         struct dsp_scb_descriptor * mixer_scb;
143
144         void * private_data;
145 };
146
147 struct dsp_spos_instance {
148         struct dsp_symbol_desc symbol_table; /* currently availble loaded symbols in SP */
149
150         int nmodules;
151         struct dsp_module_desc * modules; /* modules loaded into SP */
152
153         struct dsp_segment_desc code;
154
155         /* Main PCM playback mixer */
156         struct dsp_scb_descriptor * master_mix_scb;
157         u16 dac_volume_right;
158         u16 dac_volume_left;
159
160         /* Rear/surround PCM playback mixer */
161         struct dsp_scb_descriptor * rear_mix_scb;
162
163         /* Center/LFE mixer */
164         struct dsp_scb_descriptor * center_lfe_mix_scb;
165
166         int npcm_channels;
167         int nsrc_scb;
168         struct dsp_pcm_channel_descriptor pcm_channels[DSP_MAX_PCM_CHANNELS];
169         int src_scb_slots[DSP_MAX_SRC_NR];
170
171         /* cache this symbols */
172         struct dsp_symbol_entry * null_algorithm; /* used by PCMreaderSCB's */
173         struct dsp_symbol_entry * s16_up;         /* used by SRCtaskSCB's */
174
175         /* proc fs */  
176         struct snd_card *snd_card;
177         struct snd_info_entry * proc_dsp_dir;
178         struct snd_info_entry * proc_sym_info_entry;
179         struct snd_info_entry * proc_modules_info_entry;
180         struct snd_info_entry * proc_parameter_dump_info_entry;
181         struct snd_info_entry * proc_sample_dump_info_entry;
182
183         /* SCB's descriptors */
184         int nscb;
185         int scb_highest_frag_index;
186         struct dsp_scb_descriptor scbs[DSP_MAX_SCB_DESC];
187         struct snd_info_entry * proc_scb_info_entry;
188         struct dsp_scb_descriptor * the_null_scb;
189
190         /* Task's descriptors */
191         int ntask;
192         struct dsp_task_descriptor tasks[DSP_MAX_TASK_DESC];
193         struct snd_info_entry * proc_task_info_entry;
194
195         /* SPDIF status */
196         int spdif_status_out;
197         int spdif_status_in;
198         u16 spdif_input_volume_right;
199         u16 spdif_input_volume_left;
200         /* spdif channel status,
201            left right and user validity bits */
202         unsigned int spdif_csuv_default;
203         unsigned int spdif_csuv_stream;
204
205         /* SPDIF input sample rate converter */
206         struct dsp_scb_descriptor * spdif_in_src;
207         /* SPDIF input asynch. receiver */
208         struct dsp_scb_descriptor * asynch_rx_scb;
209
210         /* Capture record mixer SCB */
211         struct dsp_scb_descriptor * record_mixer_scb;
212     
213         /* CODEC input SCB */
214         struct dsp_scb_descriptor * codec_in_scb;
215
216         /* reference snooper */
217         struct dsp_scb_descriptor * ref_snoop_scb;
218
219         /* SPDIF output  PCM reference  */
220         struct dsp_scb_descriptor * spdif_pcm_input_scb;
221
222         /* asynch TX task */
223         struct dsp_scb_descriptor * asynch_tx_scb;
224
225         /* record sources */
226         struct dsp_scb_descriptor * pcm_input;
227         struct dsp_scb_descriptor * adc_input;
228
229         int spdif_in_sample_rate;
230 };
231
232 #endif /* __DSP_SPOS_H__ */