telephony.h
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:7k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

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