File: /usr/include/linux/telephony.h
1 /******************************************************************************
2 *
3 * telephony.h
4 *
5 * Basic Linux Telephony Interface
6 *
7 * (c) Copyright 1999 Quicknet Technologies, Inc.
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * as published by the Free Software Foundation; either version
12 * 2 of the License, or (at your option) any later version.
13 *
14 * Authors: Ed Okerson, <eokerson@quicknet.net>
15 * Greg Herlein, <gherlein@quicknet.net>
16 *
17 * Contributors: Alan Cox, <alan@redhat.com>
18 * David W. Erhart, <derhart@quicknet.net>
19 *
20 * Version: 0.1.0 - December 19, 1999
21 *
22 * Fixes:
23 *
24 *****************************************************************************/
25
26 #ifndef TELEPHONY_H
27 #define TELEPHONY_H
28
29 #define PHONE_VENDOR_IXJ 1
30 #define PHONE_VENDOR_QUICKNET PHONE_VENDOR_IXJ
31 #define PHONE_VENDOR_VOICETRONIX 2
32 #define PHONE_VENDOR_ACULAB 3
33 #define PHONE_VENDOR_DIGI 4
34 #define PHONE_VENDOR_FRANKLIN 5
35
36 /******************************************************************************
37 * Vendor Summary Information Area
38 *
39 * Quicknet Technologies, Inc. - makes low density analog telephony cards
40 * with audio compression, POTS and PSTN interfaces (www.quicknet.net)
41 *
42 * (other vendors following this API shuld add a short description of
43 * the telephony products they support under Linux)
44 *
45 *****************************************************************************/
46 #define QTI_PHONEJACK 100
47 #define QTI_LINEJACK 300
48 #define QTI_PHONEJACK_LITE 400
49 #define QTI_PHONEJACK_PCI 500
50 #define QTI_PHONECARD 600
51
52 /******************************************************************************
53 *
54 * The capabilities ioctls can inform you of the capabilities of each phone
55 * device installed in your system. The PHONECTL_CAPABILITIES ioctl
56 * returns an integer value indicating the number of capabilities the
57 * device has. The PHONECTL_CAPABILITIES_LIST will fill an array of
58 * capability structs with all of it's capabilities. The
59 * PHONECTL_CAPABILITIES_CHECK takes a single capability struct and returns
60 * a TRUE if the device has that capability, otherwise it returns false.
61 *
62 ******************************************************************************/
63 typedef enum {
64 vendor = 0,
65 device,
66 port,
67 codec,
68 dsp
69 } phone_cap;
70
71 struct phone_capability {
72 char desc[80];
73 phone_cap captype;
74 int cap;
75 int handle;
76 };
77
78 typedef enum {
79 pots = 0,
80 pstn,
81 handset,
82 speaker
83 } phone_ports;
84
85 #define PHONE_CAPABILITIES _IO ('q', 0x80)
86 #define PHONE_CAPABILITIES_LIST _IOR ('q', 0x81, struct phone_capability *)
87 #define PHONE_CAPABILITIES_CHECK _IOW ('q', 0x82, struct phone_capability *)
88
89 typedef struct {
90 char month[3];
91 char day[3];
92 char hour[3];
93 char min[3];
94 int numlen;
95 char number[11];
96 int namelen;
97 char name[80];
98 } PHONE_CID;
99
100 #define PHONE_RING _IO ('q', 0x83)
101 #define PHONE_HOOKSTATE _IO ('q', 0x84)
102 #define PHONE_MAXRINGS _IOW ('q', 0x85, char)
103 #define PHONE_RING_CADENCE _IOW ('q', 0x86, short)
104 #define OLD_PHONE_RING_START _IO ('q', 0x87)
105 #define PHONE_RING_START _IOW ('q', 0x87, PHONE_CID *)
106 #define PHONE_RING_STOP _IO ('q', 0x88)
107
108 #define USA_RING_CADENCE 0xC0C0
109
110 #define PHONE_REC_CODEC _IOW ('q', 0x89, int)
111 #define PHONE_REC_START _IO ('q', 0x8A)
112 #define PHONE_REC_STOP _IO ('q', 0x8B)
113 #define PHONE_REC_DEPTH _IOW ('q', 0x8C, int)
114 #define PHONE_FRAME _IOW ('q', 0x8D, int)
115 #define PHONE_REC_VOLUME _IOW ('q', 0x8E, int)
116 #define PHONE_REC_LEVEL _IO ('q', 0x8F)
117
118 #define PHONE_PLAY_CODEC _IOW ('q', 0x90, int)
119 #define PHONE_PLAY_START _IO ('q', 0x91)
120 #define PHONE_PLAY_STOP _IO ('q', 0x92)
121 #define PHONE_PLAY_DEPTH _IOW ('q', 0x93, int)
122 #define PHONE_PLAY_VOLUME _IOW ('q', 0x94, int)
123 #define PHONE_PLAY_LEVEL _IO ('q', 0x95)
124 #define PHONE_DTMF_READY _IOR ('q', 0x96, int)
125 #define PHONE_GET_DTMF _IOR ('q', 0x97, int)
126 #define PHONE_GET_DTMF_ASCII _IOR ('q', 0x98, int)
127 #define PHONE_DTMF_OOB _IOW ('q', 0x99, int)
128 #define PHONE_EXCEPTION _IOR ('q', 0x9A, int)
129 #define PHONE_PLAY_TONE _IOW ('q', 0x9B, char)
130 #define PHONE_SET_TONE_ON_TIME _IOW ('q', 0x9C, int)
131 #define PHONE_SET_TONE_OFF_TIME _IOW ('q', 0x9D, int)
132 #define PHONE_GET_TONE_ON_TIME _IO ('q', 0x9E)
133 #define PHONE_GET_TONE_OFF_TIME _IO ('q', 0x9F)
134 #define PHONE_GET_TONE_STATE _IO ('q', 0xA0)
135 #define PHONE_BUSY _IO ('q', 0xA1)
136 #define PHONE_RINGBACK _IO ('q', 0xA2)
137 #define PHONE_DIALTONE _IO ('q', 0xA3)
138 #define PHONE_CPT_STOP _IO ('q', 0xA4)
139
140 #define PHONE_PSTN_SET_STATE _IOW ('q', 0xA4, int)
141 #define PHONE_PSTN_GET_STATE _IO ('q', 0xA5)
142
143 #define PSTN_ON_HOOK 0
144 #define PSTN_RINGING 1
145 #define PSTN_OFF_HOOK 2
146 #define PSTN_PULSE_DIAL 3
147
148 /******************************************************************************
149 *
150 * The wink duration is tunable with this ioctl. The default wink duration
151 * is 320ms. You do not need to use this ioctl if you do not require a
152 * different wink duration.
153 *
154 ******************************************************************************/
155 #define PHONE_WINK_DURATION _IOW ('q', 0xA6, int)
156
157
158 /******************************************************************************
159 *
160 * Codec Definitions
161 *
162 ******************************************************************************/
163 typedef enum {
164 G723_63 = 1,
165 G723_53 = 2,
166 TS85 = 3,
167 TS48 = 4,
168 TS41 = 5,
169 G728 = 6,
170 G729 = 7,
171 ULAW = 8,
172 ALAW = 9,
173 LINEAR16 = 10,
174 LINEAR8 = 11,
175 WSS = 12
176 } phone_codec;
177
178 struct phone_codec_data
179 {
180 phone_codec type;
181 unsigned short buf_min, buf_opt, buf_max;
182 };
183
184 #define PHONE_QUERY_CODEC _IOWR ('q', 0xA7, struct phone_codec_data *)
185 #define PHONE_PSTN_LINETEST _IO ('q', 0xA8)
186
187 /******************************************************************************
188 *
189 * This controls the VAD/CNG functionality of G.723.1. The driver will
190 * always pass full size frames, any unused bytes will be padded with zeros,
191 * and frames passed to the driver should also be padded with zeros. The
192 * frame type is encoded in the least significant two bits of the first
193 * WORD of the frame as follows:
194 *
195 * bits 1-0 Frame Type Data Rate Significant Words
196 * 00 0 G.723.1 6.3 12
197 * 01 1 G.723.1 5.3 10
198 * 10 2 VAD/CNG 2
199 * 11 3 Repeat last CNG 2 bits
200 *
201 ******************************************************************************/
202 #define PHONE_VAD _IOW ('q', 0xA9, int)
203
204
205 /******************************************************************************
206 *
207 * The exception structure allows us to multiplex multiple events onto the
208 * select() exception set. If any of these flags are set select() will
209 * return with a positive indication on the exception set. The dtmf_ready
210 * bit indicates if there is data waiting in the DTMF buffer. The
211 * hookstate bit is set if there is a change in hookstate status, it does not
212 * indicate the current state of the hookswitch. The pstn_ring bit
213 * indicates that the DAA on a LineJACK card has detected ring voltage on
214 * the PSTN port. The caller_id bit indicates that caller_id data has been
215 * received and is available. The pstn_wink bit indicates that the DAA on
216 * the LineJACK has received a wink from the telco switch. The f0, f1, f2
217 * and f3 bits indicate that the filter has been triggered by detecting the
218 * frequency programmed into that filter.
219 *
220 * The remaining bits should be set to zero. They will become defined over time
221 * for other interface cards and their needs.
222 *
223 ******************************************************************************/
224 struct phone_except
225 {
226 unsigned int dtmf_ready:1;
227 unsigned int hookstate:1;
228 unsigned int pstn_ring:1;
229 unsigned int caller_id:1;
230 unsigned int pstn_wink:1;
231 unsigned int f0:1;
232 unsigned int f1:1;
233 unsigned int f2:1;
234 unsigned int f3:1;
235 unsigned int flash:1;
236 unsigned int fc0:1;
237 unsigned int fc1:1;
238 unsigned int fc2:1;
239 unsigned int fc3:1;
240 unsigned int reserved:18;
241 };
242
243 union telephony_exception {
244 struct phone_except bits;
245 unsigned int bytes;
246 };
247
248
249 #endif /* TELEPHONY_H */
250