app_queue.c: Queue don't play "thank-you" when here is no hold time announcements
[asterisk/asterisk.git] / codecs / gsm / inc / private.h
1 /*
2  * Copyright 1992 by Jutta Degener and Carsten Bormann, Technische
3  * Universitaet Berlin.  See the accompanying file "COPYRIGHT" for
4  * details.  THERE IS ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
5  */
6
7 /*$Header$*/
8
9 #ifndef PRIVATE_H
10 #define PRIVATE_H
11
12 typedef short                   word;           /* 16 bit signed int    */
13 typedef long                    longword;       /* 32 bit signed int    */
14
15 typedef unsigned short          uword;          /* unsigned word        */
16 typedef unsigned long           ulongword;      /* unsigned longword    */
17
18 struct gsm_state {
19
20         word            dp0[ 280 ];
21
22         word            z1;             /* preprocessing.c, Offset_com. */
23         longword        L_z2;           /*                  Offset_com. */
24         int             mp;             /*                  Preemphasis */
25
26         word            u[8];           /* short_term_aly_filter.c      */
27         word            LARpp[2][8];    /*                              */
28         word            j;              /*                              */
29
30         word            ltp_cut;        /* long_term.c, LTP crosscorr.  */
31         word            nrp; /* 40 */   /* long_term.c, synthesis       */
32         word            v[9];           /* short_term.c, synthesis      */
33         word            msr;            /* decoder.c,   Postprocessing  */
34
35         char            verbose;        /* only used if !NDEBUG         */
36         char            fast;           /* only used if FAST            */
37
38         char            wav_fmt;        /* only used if WAV49 defined   */
39         unsigned char   frame_index;    /*            odd/even chaining */
40         unsigned char   frame_chain;    /*   half-byte to carry forward */
41 };
42
43
44 #define MIN_WORD        (-32767 - 1)
45 #define MAX_WORD          32767
46
47 #define MIN_LONGWORD    (-2147483647 - 1)
48 #define MAX_LONGWORD      2147483647
49
50 #ifdef  SASR            /* flag: >> is a signed arithmetic shift right */
51 #undef  SASR
52 #define SASR(x, by)     ((x) >> (by))
53 #else
54 #define SASR(x, by)     ((x) >= 0 ? (x) >> (by) : (~(-((x) + 1) >> (by))))
55 #endif  /* SASR */
56
57 #include "proto.h"
58
59 /*
60  *      Prototypes from add.c
61  */
62 extern word     gsm_mult        P((word a, word b));
63 extern longword gsm_L_mult      P((word a, word b));
64 extern word     gsm_mult_r      P((word a, word b));
65
66 extern word     gsm_div         P((word num, word denum));
67
68 extern word     gsm_add         P(( word a, word b ));
69 extern longword gsm_L_add       P(( longword a, longword b ));
70
71 extern word     gsm_sub         P((word a, word b));
72 extern longword gsm_L_sub       P((longword a, longword b));
73
74 extern word     gsm_abs         P((word a));
75
76 extern word     gsm_norm        P(( longword a ));
77
78 extern longword gsm_L_asl       P((longword a, int n));
79 extern word     gsm_asl         P((word a, int n));
80
81 extern longword gsm_L_asr       P((longword a, int n));
82 extern word     gsm_asr         P((word a, int n));
83
84 /*
85  *  Inlined functions from add.h
86  */
87
88 /*
89  * #define GSM_MULT_R(a, b) (* word a, word b, !(a == b == MIN_WORD) *) \
90  *      (0x0FFFF & SASR(((longword)(a) * (longword)(b) + 16384), 15))
91  */
92 #define GSM_MULT_R(a, b) /* word a, word b, !(a == b == MIN_WORD) */    \
93         (SASR( ((longword)(a) * (longword)(b) + 16384), 15 ))
94
95 # define GSM_MULT(a,b)   /* word a, word b, !(a == b == MIN_WORD) */    \
96         (SASR( ((longword)(a) * (longword)(b)), 15 ))
97
98 # define GSM_L_MULT(a, b) /* word a, word b */  \
99         (((longword)(a) * (longword)(b)) << 1)
100
101 #if defined(__GNUC__) && defined(__i386__)
102
103 static __inline__ int GSM_L_ADD(int a, int b)
104 {
105         __asm__ __volatile__(
106
107                         "addl %2,%0; jno 0f; movl $0x7fffffff,%0; adcl $0,%0; 0:"
108                         : "=&r" (a)
109                         : "0" (a), "ir" (b)
110                         : "cc"
111                 );
112         return(a);
113 }
114
115 static __inline__ short GSM_ADD(short a, short b)
116 {
117         __asm__ __volatile__(
118                         "addw %2,%0; jno 0f; movw $0x7fff,%0; adcw $0,%0; 0:"
119                         : "=&r" (a)
120                         : "0" (a), "ir" (b)
121                         : "cc"
122                 );
123         return(a);
124 }
125
126 static __inline__ short GSM_SUB(short a, short b)
127 {
128         __asm__ __volatile__(
129                         "subw %2,%0; jno 0f; movw $0x7fff,%0; adcw $0,%0; 0:"
130                         : "=&r" (a)
131                         : "0" (a), "ir" (b)
132                         : "cc"
133                 );
134         return(a);
135 }
136
137 #else
138
139 #ifdef WIN32
140 #define inline __inline
141 #define __inline__ __inline
142 #endif
143
144 # define GSM_L_ADD(a, b)        \
145         ( (a) <  0 ? ( (b) >= 0 ? (a) + (b)     \
146                  : (utmp = (ulongword)-((a) + 1) + (ulongword)-((b) + 1)) \
147                    >= MAX_LONGWORD ? MIN_LONGWORD : -(longword)utmp-2 )   \
148         : ((b) <= 0 ? (a) + (b)   \
149                   : (utmp = (ulongword)(a) + (ulongword)(b)) >= MAX_LONGWORD \
150                     ? MAX_LONGWORD : utmp))
151
152 static inline word GSM_ADD(longword a, longword b)
153 {
154         register longword ltmp;
155         ltmp = a + b;
156         return (word)((ulongword) (ltmp - MIN_WORD) > MAX_WORD - MIN_WORD ? (ltmp > 0 ? MAX_WORD : MIN_WORD) : ltmp);
157 };
158
159 static inline word GSM_SUB(longword a, longword b)
160 {
161         register longword ltmp;
162         ltmp = a - b;
163         return (word)(ltmp >= MAX_WORD ? MAX_WORD : ltmp <= MIN_WORD ? MIN_WORD : ltmp);
164 };
165
166 #endif
167
168 # define GSM_ABS(a)     ((a) < 0 ? ((a) == MIN_WORD ? MAX_WORD : -(a)) : (a))
169
170 /* Use these if necessary:
171
172 # define GSM_MULT_R(a, b)       gsm_mult_r(a, b)
173 # define GSM_MULT(a, b)         gsm_mult(a, b)
174 # define GSM_L_MULT(a, b)       gsm_L_mult(a, b)
175
176 # define GSM_L_ADD(a, b)        gsm_L_add(a, b)
177 # define GSM_ADD(a, b)          gsm_add(a, b)
178 # define GSM_SUB(a, b)          gsm_sub(a, b)
179
180 # define GSM_ABS(a)             gsm_abs(a)
181
182 */
183
184 /*
185  *  More prototypes from implementations..
186  */
187 extern void Gsm_Coder P((
188                 struct gsm_state        * S,
189                 word    * s,    /* [0..159] samples             IN      */
190                 word    * LARc, /* [0..7] LAR coefficients      OUT     */
191                 word    * Nc,   /* [0..3] LTP lag               OUT     */
192                 word    * bc,   /* [0..3] coded LTP gain        OUT     */
193                 word    * Mc,   /* [0..3] RPE grid selection    OUT     */
194                 word    * xmaxc,/* [0..3] Coded maximum amplitude OUT   */
195                 word    * xMc   /* [13*4] normalized RPE samples OUT    */));
196
197 extern void Gsm_Long_Term_Predictor P((         /* 4x for 160 samples */
198                 struct gsm_state * S,
199                 word    * d,    /* [0..39]   residual signal    IN      */
200                 word    * dp,   /* [-120..-1] d'                IN      */
201                 word    * e,    /* [0..40]                      OUT     */
202                 word    * dpp,  /* [0..40]                      OUT     */
203                 word    * Nc,   /* correlation lag              OUT     */
204                 word    * bc    /* gain factor                  OUT     */));
205
206 extern void Gsm_LPC_Analysis P((
207                 struct gsm_state * S,
208                 word * s,        /* 0..159 signals      IN/OUT  */
209                 word * LARc));   /* 0..7   LARc's       OUT     */
210
211 extern void Gsm_Preprocess P((
212                 struct gsm_state * S,
213                 word * s, word * so));
214
215 extern void Gsm_Encoding P((
216                 struct gsm_state * S,
217                 word    * e,
218                 word    * ep,
219                 word    * xmaxc,
220                 word    * Mc,
221                 word    * xMc));
222
223 extern void Gsm_Short_Term_Analysis_Filter P((
224                 struct gsm_state * S,
225                 word    * LARc, /* coded log area ratio [0..7]  IN      */
226                 word    * d     /* st res. signal [0..159]      IN/OUT  */));
227
228 extern void Gsm_Decoder P((
229                 struct gsm_state * S,
230                 word    * LARcr,        /* [0..7]               IN      */
231                 word    * Ncr,          /* [0..3]               IN      */
232                 word    * bcr,          /* [0..3]               IN      */
233                 word    * Mcr,          /* [0..3]               IN      */
234                 word    * xmaxcr,       /* [0..3]               IN      */
235                 word    * xMcr,         /* [0..13*4]            IN      */
236                 word    * s));          /* [0..159]             OUT     */
237
238 extern void Gsm_Decoding P((
239                 struct gsm_state * S,
240                 word    xmaxcr,
241                 word    Mcr,
242                 word    * xMcr,         /* [0..12]              IN      */
243                 word    * erp));        /* [0..39]              OUT     */
244
245 extern void Gsm_Long_Term_Synthesis_Filtering P((
246                 struct gsm_state* S,
247                 word    Ncr,
248                 word    bcr,
249                 word    * erp,          /* [0..39]                IN    */
250                 word    * drp));        /* [-120..-1] IN, [0..40] OUT   */
251
252 void Gsm_RPE_Decoding P((
253         struct gsm_state *S,
254                 word xmaxcr,
255                 word Mcr,
256                 word * xMcr,  /* [0..12], 3 bits             IN      */
257                 word * erp)); /* [0..39]                     OUT     */
258
259 void Gsm_RPE_Encoding P((
260                 struct gsm_state * S,
261                 word    * e,            /* -5..-1][0..39][40..44     IN/OUT  */
262                 word    * xmaxc,        /*                              OUT */
263                 word    * Mc,           /*                              OUT */
264                 word    * xMc));        /* [0..12]                      OUT */
265
266 extern void Gsm_Short_Term_Synthesis_Filter P((
267                 struct gsm_state * S,
268                 word    * LARcr,        /* log area ratios [0..7]  IN   */
269                 word    * drp,          /* received d [0...39]     IN   */
270                 word    * s));          /* signal   s [0..159]    OUT   */
271
272 extern void Gsm_Update_of_reconstructed_short_time_residual_signal P((
273                 word    * dpp,          /* [0...39]     IN      */
274                 word    * ep,           /* [0...39]     IN      */
275                 word    * dp));         /* [-120...-1]  IN/OUT  */
276
277 /*
278  *  Tables from table.c
279  */
280 #ifndef GSM_TABLE_C
281
282 extern word gsm_A[8], gsm_B[8], gsm_MIC[8], gsm_MAC[8];
283 extern word gsm_INVA[8];
284 extern word gsm_DLB[4], gsm_QLB[4];
285 extern word gsm_H[11];
286 extern word gsm_NRFAC[8];
287 extern word gsm_FAC[8];
288
289 #endif  /* GSM_TABLE_C */
290
291 /*
292  *  Debugging
293  */
294 #ifdef NDEBUG
295
296 #       define  gsm_debug_words(a, b, c, d)             /* nil */
297 #       define  gsm_debug_longwords(a, b, c, d)         /* nil */
298 #       define  gsm_debug_word(a, b)                    /* nil */
299 #       define  gsm_debug_longword(a, b)                /* nil */
300
301 #else   /* !NDEBUG => DEBUG */
302
303         extern void  gsm_debug_words     P((char * name, int, int, word *));
304         extern void  gsm_debug_longwords P((char * name, int, int, longword *));
305         extern void  gsm_debug_longword  P((char * name, longword));
306         extern void  gsm_debug_word      P((char * name, word));
307
308 #endif /* !NDEBUG */
309
310 #include "unproto.h"
311
312 #endif  /* PRIVATE_H */