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