telephony.h
上传用户:weyjxb
上传日期:2020-05-18
资源大小:52k
文件大小:9k
源码类别:

多显示器编程

开发平台:

Unix_Linux

  1. /******************************************************************************
  2.  *
  3.  * telephony.h
  4.  *
  5.  * Basic Linux Telephony Interface
  6.  *
  7.  * (c) Copyright 1999-2001 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.  * IN NO EVENT SHALL QUICKNET TECHNOLOGIES, INC. BE LIABLE TO ANY PARTY FOR
  21.  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
  22.  * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF QUICKNET
  23.  * TECHNOLOGIES, INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24.  *
  25.  * QUICKNET TECHNOLOGIES, INC. SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  26.  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  27.  * AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  28.  * ON AN "AS IS" BASIS, AND QUICKNET TECHNOLOGIES, INC. HAS NO OBLIGATION
  29.  * TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  30.  *
  31.  * Version:       $Revision: 1.1.1.1 $
  32.  *
  33.  * $Id: telephony.h,v 1.1.1.1 2001/11/14 05:05:07 tadavis Exp $
  34.  *
  35.  *****************************************************************************/
  36. #ifndef TELEPHONY_H
  37. #define TELEPHONY_H
  38. #define TELEPHONY_VERSION 3013
  39. #define PHONE_VENDOR_IXJ          1
  40. #define PHONE_VENDOR_QUICKNET   PHONE_VENDOR_IXJ
  41. #define PHONE_VENDOR_VOICETRONIX  2
  42. #define PHONE_VENDOR_ACULAB       3
  43. #define PHONE_VENDOR_DIGI         4
  44. #define PHONE_VENDOR_FRANKLIN     5
  45. #define PHONE_VENDOR_VOIPBLASTER  6
  46. /******************************************************************************
  47.  *  Vendor Summary Information Area
  48.  *
  49.  *  Quicknet Technologies, Inc. - makes low density analog telephony cards
  50.  *    with audio compression, POTS and PSTN interfaces (www.quicknet.net)
  51.  *
  52.  *  (other vendors following this API shuld add a short description of
  53.  *  the telephony products they support under Linux)
  54.  *
  55.  *****************************************************************************/
  56. #define QTI_PHONEJACK 100
  57. #define QTI_LINEJACK 300
  58. #define QTI_PHONEJACK_LITE 400
  59. #define QTI_PHONEJACK_PCI 500
  60. #define QTI_PHONECARD 600
  61. #define CREATIVE_VOIPBLASTER 700
  62. /******************************************************************************
  63. *
  64. * The capabilities ioctls can inform you of the capabilities of each phone
  65. * device installed in your system.  The PHONECTL_CAPABILITIES ioctl
  66. * returns an integer value indicating the number of capabilities the   
  67. * device has.  The PHONECTL_CAPABILITIES_LIST will fill an array of 
  68. * capability structs with all of it's capabilities.  The
  69. * PHONECTL_CAPABILITIES_CHECK takes a single capability struct and returns
  70. * a TRUE if the device has that capability, otherwise it returns false.
  71. ******************************************************************************/
  72. typedef enum {
  73. vendor = 0,
  74. device,
  75. port,
  76. codec,
  77. dsp
  78. } phone_cap;
  79. struct phone_capability {
  80. char desc[80];
  81. phone_cap captype;
  82. int cap;
  83. int handle;
  84. };
  85. typedef enum {
  86. pots = 0,
  87. pstn,
  88. handset,
  89. speaker
  90. } phone_ports;
  91. #define PHONE_CAPABILITIES              _IO  ('q', 0x80)
  92. #define PHONE_CAPABILITIES_LIST         _IOR ('q', 0x81, struct phone_capability *)
  93. #define PHONE_CAPABILITIES_CHECK        _IOW ('q', 0x82, struct phone_capability *)
  94. typedef struct {
  95.         char month[3];
  96.         char day[3];
  97.         char hour[3];
  98.         char min[3];
  99.         int numlen;
  100.         char number[11];
  101.         int namelen;
  102.         char name[80];
  103. } PHONE_CID;
  104.  
  105. #define PHONE_RING _IO  ('q', 0x83)
  106. #define PHONE_HOOKSTATE _IO  ('q', 0x84)
  107. #define PHONE_MAXRINGS _IOW ('q', 0x85, char)
  108. #define PHONE_RING_CADENCE _IOW ('q', 0x86, short)
  109. #define OLD_PHONE_RING_START            _IO  ('q', 0x87)
  110. #define PHONE_RING_START _IOW ('q', 0x87, PHONE_CID *)
  111. #define PHONE_RING_STOP _IO  ('q', 0x88)
  112. #define USA_RING_CADENCE  0xC0C0
  113. #define PHONE_REC_CODEC _IOW ('q', 0x89, int)
  114. #define PHONE_REC_START _IO  ('q', 0x8A)
  115. #define PHONE_REC_STOP _IO  ('q', 0x8B)
  116. #define PHONE_REC_DEPTH _IOW ('q', 0x8C, int)
  117. #define PHONE_FRAME _IOW ('q', 0x8D, int)
  118. #define PHONE_REC_VOLUME _IOW ('q', 0x8E, int)
  119. #define PHONE_REC_VOLUME_LINEAR _IOW ('q', 0xDB, int)
  120. #define PHONE_REC_LEVEL _IO  ('q', 0x8F)
  121. #define PHONE_PLAY_CODEC _IOW ('q', 0x90, int)
  122. #define PHONE_PLAY_START _IO  ('q', 0x91)
  123. #define PHONE_PLAY_STOP _IO  ('q', 0x92)
  124. #define PHONE_PLAY_DEPTH _IOW ('q', 0x93, int)
  125. #define PHONE_PLAY_VOLUME _IOW ('q', 0x94, int)
  126. #define PHONE_PLAY_VOLUME_LINEAR _IOW ('q', 0xDC, int)
  127. #define PHONE_PLAY_LEVEL _IO  ('q', 0x95)
  128. #define PHONE_DTMF_READY _IOR ('q', 0x96, int)
  129. #define PHONE_GET_DTMF _IOR ('q', 0x97, int)
  130. #define PHONE_GET_DTMF_ASCII _IOR ('q', 0x98, int)
  131. #define PHONE_DTMF_OOB _IOW ('q', 0x99, int)
  132. #define PHONE_EXCEPTION _IOR ('q', 0x9A, int)
  133. #define PHONE_PLAY_TONE _IOW ('q', 0x9B, char)
  134. #define PHONE_SET_TONE_ON_TIME _IOW ('q', 0x9C, int)
  135. #define PHONE_SET_TONE_OFF_TIME _IOW ('q', 0x9D, int)
  136. #define PHONE_GET_TONE_ON_TIME _IO  ('q', 0x9E)
  137. #define PHONE_GET_TONE_OFF_TIME _IO  ('q', 0x9F)
  138. #define PHONE_GET_TONE_STATE _IO  ('q', 0xA0)
  139. #define PHONE_BUSY _IO  ('q', 0xA1)
  140. #define PHONE_RINGBACK _IO  ('q', 0xA2)
  141. #define PHONE_DIALTONE _IO  ('q', 0xA3)
  142. #define PHONE_CPT_STOP _IO  ('q', 0xA4)
  143. #define PHONE_PSTN_SET_STATE _IOW ('q', 0xA4, int)
  144. #define PHONE_PSTN_GET_STATE _IO  ('q', 0xA5)
  145. #define PSTN_ON_HOOK 0
  146. #define PSTN_RINGING 1
  147. #define PSTN_OFF_HOOK 2
  148. #define PSTN_PULSE_DIAL 3
  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. #define PHONE_WINK_DURATION _IOW ('q', 0xA6, int)
  155. #define PHONE_WINK _IOW ('q', 0xAA, int)
  156. /******************************************************************************
  157. *  Codec Definitions
  158. ******************************************************************************/
  159. typedef enum {
  160. G723_63 = 1,
  161. G723_53 = 2,
  162. TS85 = 3,
  163. TS48 = 4,
  164. TS41 = 5,
  165. G728 = 6,
  166. G729 = 7,
  167. ULAW = 8,
  168. ALAW = 9,
  169. LINEAR16 = 10,
  170. LINEAR8 = 11,
  171. WSS = 12,
  172. G729B = 13
  173. } phone_codec;
  174. struct phone_codec_data
  175. {
  176.         phone_codec type;
  177.         unsigned short buf_min, buf_opt, buf_max;
  178. };
  179. #define PHONE_QUERY_CODEC               _IOWR ('q', 0xA7, struct phone_codec_data *)
  180. #define PHONE_PSTN_LINETEST             _IO ('q', 0xA8)
  181. /******************************************************************************
  182. * This controls the VAD/CNG functionality of G.723.1.  The driver will
  183. * always pass full size frames, any unused bytes will be padded with zeros,
  184. * and frames passed to the driver should also be padded with zeros.  The
  185. * frame type is encoded in the least significant two bits of the first
  186. * WORD of the frame as follows:
  187. *
  188. * bits 1-0 Frame Type Data Rate Significant Words
  189. * 00 0 G.723.1 6.3 12
  190. * 01 1 G.723.1 5.3 10
  191. * 10 2 VAD/CNG  2
  192. * 11 3 Repeat last CNG  2 bits
  193. ******************************************************************************/
  194. #define PHONE_VAD _IOW ('q', 0xA9, int)
  195. /******************************************************************************
  196. *
  197. * The exception structure allows us to multiplex multiple events onto the
  198. * select() exception set.  If any of these flags are set select() will
  199. * return with a positive indication on the exception set.  The dtmf_ready
  200. * bit indicates if there is data waiting in the DTMF buffer.  The
  201. * hookstate bit is set if there is a change in hookstate status, it does not
  202. * indicate the current state of the hookswitch.  The pstn_ring bit
  203. * indicates that the DAA on a LineJACK card has detected ring voltage on
  204. * the PSTN port.  The caller_id bit indicates that caller_id data has been
  205. * recieved and is available.  The pstn_wink bit indicates that the DAA on
  206. * the LineJACK has recieved a wink from the telco switch.  The f0, f1, f2
  207. * and f3 bits indicate that the filter has been triggered by detecting the
  208. * frequency programmed into that filter.
  209. *
  210. * The remaining bits should be set to zero. They will become defined over time
  211. * for other interface cards and their needs.
  212. *
  213. ******************************************************************************/
  214. struct phone_except
  215. {
  216. unsigned int dtmf_ready:1;
  217. unsigned int hookstate:1;
  218. unsigned int pstn_ring:1;
  219. unsigned int caller_id:1;
  220. unsigned int pstn_wink:1;
  221. unsigned int f0:1;
  222. unsigned int f1:1;
  223. unsigned int f2:1;
  224. unsigned int f3:1;
  225. unsigned int flash:1;
  226. unsigned int fc0:1;
  227. unsigned int fc1:1;
  228. unsigned int fc2:1;
  229. unsigned int fc3:1;
  230. unsigned int reserved:18;
  231. };
  232. union telephony_exception {
  233. struct phone_except bits;
  234. unsigned int bytes;
  235. };
  236. #endif /* TELEPHONY_H */