xref: /linux/drivers/isdn/mISDN/dsp.h (revision daa2be74b1b2302004945b2a5e32424e177cc7da)
1 /*
2  * Audio support data for ISDN4Linux.
3  *
4  * Copyright 2002/2003 by Andreas Eversberg (jolly@eversberg.eu)
5  *
6  * This software may be used and distributed according to the terms
7  * of the GNU General Public License, incorporated herein by reference.
8  *
9  */
10 
11 #define DEBUG_DSP_CTRL		0x0001
12 #define DEBUG_DSP_CORE		0x0002
13 #define DEBUG_DSP_DTMF		0x0004
14 #define DEBUG_DSP_CMX		0x0010
15 #define DEBUG_DSP_TONE		0x0020
16 #define DEBUG_DSP_BLOWFISH	0x0040
17 #define DEBUG_DSP_DELAY		0x0100
18 #define DEBUG_DSP_CLOCK		0x0200
19 #define DEBUG_DSP_DTMFCOEFF	0x8000 /* heavy output */
20 
21 /* options may be:
22  *
23  * bit 0 = use ulaw instead of alaw
24  * bit 1 = enable hfc hardware acceleration for all channels
25  *
26  */
27 #define DSP_OPT_ULAW		(1 << 0)
28 #define DSP_OPT_NOHARDWARE	(1 << 1)
29 
30 #include <linux/timer.h>
31 #include <linux/workqueue.h>
32 
33 #include "dsp_ecdis.h"
34 
35 extern int dsp_options;
36 extern int dsp_debug;
37 extern int dsp_poll;
38 extern int dsp_tics;
39 extern spinlock_t dsp_lock;
40 extern struct work_struct dsp_workq;
41 extern u32 dsp_poll_diff; /* calculated fix-comma corrected poll value */
42 
43 /***************
44  * audio stuff *
45  ***************/
46 
47 extern s32 dsp_audio_alaw_to_s32[256];
48 extern s32 dsp_audio_ulaw_to_s32[256];
49 extern s32 *dsp_audio_law_to_s32;
50 extern u8 dsp_audio_s16_to_law[65536];
51 extern u8 dsp_audio_alaw_to_ulaw[256];
52 extern u8 dsp_audio_mix_law[65536];
53 extern u8 dsp_audio_seven2law[128];
54 extern u8 dsp_audio_law2seven[256];
55 extern void dsp_audio_generate_law_tables(void);
56 extern void dsp_audio_generate_s2law_table(void);
57 extern void dsp_audio_generate_seven(void);
58 extern void dsp_audio_generate_mix_table(void);
59 extern void dsp_audio_generate_ulaw_samples(void);
60 extern void dsp_audio_generate_volume_changes(void);
61 extern u8 dsp_silence;
62 
63 
64 /*************
65  * cmx stuff *
66  *************/
67 
68 #define MAX_POLL	256	/* maximum number of send-chunks */
69 
70 #define CMX_BUFF_SIZE	0x8000	/* must be 2**n (0x1000 about 1/2 second) */
71 #define CMX_BUFF_HALF	0x4000	/* CMX_BUFF_SIZE / 2 */
72 #define CMX_BUFF_MASK	0x7fff	/* CMX_BUFF_SIZE - 1 */
73 
74 /* how many seconds will we check the lowest delay until the jitter buffer
75    is reduced by that delay */
76 #define MAX_SECONDS_JITTER_CHECK 5
77 
78 extern struct timer_list dsp_spl_tl;
79 
80 /* the datatype need to match jiffies datatype */
81 extern unsigned long dsp_spl_jiffies;
82 
83 /* the structure of conferences:
84  *
85  * each conference has a unique number, given by user space.
86  * the conferences are linked in a chain.
87  * each conference has members linked in a chain.
88  * each dsplayer points to a member, each member points to a dsplayer.
89  */
90 
91 /* all members within a conference (this is linked 1:1 with the dsp) */
92 struct dsp;
93 struct dsp_conf_member {
94 	struct list_head	list;
95 	struct dsp		*dsp;
96 };
97 
98 /* the list of all conferences */
99 struct dsp_conf {
100 	struct list_head	list;
101 	u32			id;
102 	/* all cmx stacks with the same ID are
103 	   connected */
104 	struct list_head	mlist;
105 	int			software; /* conf is processed by software */
106 	int			hardware; /* conf is processed by hardware */
107 	/* note: if both unset, has only one member */
108 };
109 
110 
111 /**************
112  * DTMF stuff *
113  **************/
114 
115 #define DSP_DTMF_NPOINTS 102
116 
117 #define ECHOCAN_BUFF_SIZE 0x400 /* must be 2**n */
118 #define ECHOCAN_BUFF_MASK 0x3ff /* -1 */
119 
120 struct dsp_dtmf {
121 	int		enable; /* dtmf is enabled */
122 	int		treshold; /* above this is dtmf (square of) */
123 	int		software; /* dtmf uses software decoding */
124 	int		hardware; /* dtmf uses hardware decoding */
125 	int		size; /* number of bytes in buffer */
126 	signed short	buffer[DSP_DTMF_NPOINTS];
127 	/* buffers one full dtmf frame */
128 	u8		lastwhat, lastdigit;
129 	int		count;
130 	u8		digits[16]; /* dtmf result */
131 };
132 
133 
134 /******************
135  * pipeline stuff *
136  ******************/
137 struct dsp_pipeline {
138 	rwlock_t  lock;
139 	struct list_head list;
140 	int inuse;
141 };
142 
143 /***************
144  * tones stuff *
145  ***************/
146 
147 struct dsp_tone {
148 	int		software; /* tones are generated by software */
149 	int		hardware; /* tones are generated by hardware */
150 	int		tone;
151 	void		*pattern;
152 	int		count;
153 	int		index;
154 	struct timer_list tl;
155 };
156 
157 /***************
158  * echo stuff *
159  ***************/
160 
161 struct dsp_echo {
162 	int		software; /* echo is generated by software */
163 	int		hardware; /* echo is generated by hardware */
164 };
165 
166 /*****************
167  * general stuff *
168  *****************/
169 
170 struct dsp {
171 	struct list_head list;
172 	struct mISDNchannel	ch;
173 	struct mISDNchannel	*up;
174 	unsigned char	name[64];
175 	int		b_active;
176 	struct dsp_echo	echo;
177 	int		rx_disabled; /* what the user wants */
178 	int		rx_is_off; /* what the card is */
179 	int		tx_mix;
180 	struct dsp_tone	tone;
181 	struct dsp_dtmf	dtmf;
182 	int		tx_volume, rx_volume;
183 
184 	/* queue for sending frames */
185 	struct work_struct	workq;
186 	struct sk_buff_head	sendq;
187 	int		hdlc;	/* if mode is hdlc */
188 	int		data_pending;	/* currently an unconfirmed frame */
189 
190 	/* conference stuff */
191 	u32		conf_id;
192 	struct dsp_conf	*conf;
193 	struct dsp_conf_member
194 	*member;
195 
196 	/* buffer stuff */
197 	int		rx_W; /* current write pos for data without timestamp */
198 	int		rx_R; /* current read pos for transmit clock */
199 	int		rx_init; /* if set, pointers will be adjusted first */
200 	int		tx_W; /* current write pos for transmit data */
201 	int		tx_R; /* current read pos for transmit clock */
202 	int		rx_delay[MAX_SECONDS_JITTER_CHECK];
203 	int		tx_delay[MAX_SECONDS_JITTER_CHECK];
204 	u8		tx_buff[CMX_BUFF_SIZE];
205 	u8		rx_buff[CMX_BUFF_SIZE];
206 	int		last_tx; /* if set, we transmitted last poll interval */
207 	int		cmx_delay; /* initial delay of buffers,
208 				      or 0 for dynamic jitter buffer */
209 	int		tx_dejitter; /* if set, dejitter tx buffer */
210 	int		tx_data; /* enables tx-data of CMX to upper layer */
211 
212 	/* hardware stuff */
213 	struct dsp_features features;
214 	int		features_rx_off; /* set if rx_off is featured */
215 	int		features_fill_empty; /* set if fill_empty is featured */
216 	int		pcm_slot_rx; /* current PCM slot (or -1) */
217 	int		pcm_bank_rx;
218 	int		pcm_slot_tx;
219 	int		pcm_bank_tx;
220 	int		hfc_conf; /* unique id of current conference (or -1) */
221 
222 	/* encryption stuff */
223 	int		bf_enable;
224 	u32		bf_p[18];
225 	u32		bf_s[1024];
226 	int		bf_crypt_pos;
227 	u8		bf_data_in[9];
228 	u8		bf_crypt_out[9];
229 	int		bf_decrypt_in_pos;
230 	int		bf_decrypt_out_pos;
231 	u8		bf_crypt_inring[16];
232 	u8		bf_data_out[9];
233 	int		bf_sync;
234 
235 	struct dsp_pipeline
236 	pipeline;
237 };
238 
239 /* functions */
240 
241 extern void dsp_change_volume(struct sk_buff *skb, int volume);
242 
243 extern struct list_head dsp_ilist;
244 extern struct list_head conf_ilist;
245 extern void dsp_cmx_debug(struct dsp *dsp);
246 extern void dsp_cmx_hardware(struct dsp_conf *conf, struct dsp *dsp);
247 extern int dsp_cmx_conf(struct dsp *dsp, u32 conf_id);
248 extern void dsp_cmx_receive(struct dsp *dsp, struct sk_buff *skb);
249 extern void dsp_cmx_hdlc(struct dsp *dsp, struct sk_buff *skb);
250 extern void dsp_cmx_send(struct timer_list *arg);
251 extern void dsp_cmx_transmit(struct dsp *dsp, struct sk_buff *skb);
252 extern int dsp_cmx_del_conf_member(struct dsp *dsp);
253 extern int dsp_cmx_del_conf(struct dsp_conf *conf);
254 
255 extern void dsp_dtmf_goertzel_init(struct dsp *dsp);
256 extern void dsp_dtmf_hardware(struct dsp *dsp);
257 extern u8 *dsp_dtmf_goertzel_decode(struct dsp *dsp, u8 *data, int len,
258 				    int fmt);
259 
260 extern int dsp_tone(struct dsp *dsp, int tone);
261 extern void dsp_tone_copy(struct dsp *dsp, u8 *data, int len);
262 extern void dsp_tone_timeout(struct timer_list *t);
263 
264 extern void dsp_bf_encrypt(struct dsp *dsp, u8 *data, int len);
265 extern void dsp_bf_decrypt(struct dsp *dsp, u8 *data, int len);
266 extern int dsp_bf_init(struct dsp *dsp, const u8 *key, unsigned int keylen);
267 extern void dsp_bf_cleanup(struct dsp *dsp);
268 
269 extern int  dsp_pipeline_module_init(void);
270 extern void dsp_pipeline_module_exit(void);
271 extern int  dsp_pipeline_init(struct dsp_pipeline *pipeline);
272 extern void dsp_pipeline_destroy(struct dsp_pipeline *pipeline);
273 extern int  dsp_pipeline_build(struct dsp_pipeline *pipeline, const char *cfg);
274 extern void dsp_pipeline_process_tx(struct dsp_pipeline *pipeline, u8 *data,
275 				    int len);
276 extern void dsp_pipeline_process_rx(struct dsp_pipeline *pipeline, u8 *data,
277 				    int len, unsigned int txlen);
278