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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. /*
  2.  *              telephony.h
  3.  *
  4.  *              Basic Linux Telephony Interface
  5.  *
  6.  *              (c) Copyright 1999 Quicknet Technologies, Inc.
  7.  *
  8.  *              This program is free software; you can redistribute it and/or
  9.  *              modify it under the terms of the GNU General Public License
  10.  *              as published by the Free Software Foundation; either version
  11.  *              2 of the License, or (at your option) any later version.
  12.  *
  13.  * Authors:       Ed Okerson, <eokerson@quicknet.net>
  14.  *                Greg Herlein, <gherlein@quicknet.net>
  15.  *
  16.  * Contributors:  Alan Cox, <acox@redhat.com>
  17.  *                David W. Erhart, <derhart@quicknet.net>
  18.  *
  19.  * Version:       0.1.0 - December 19, 1999
  20.  *
  21.  * Fixes:
  22.  */
  23. #ifndef TELEPHONY_H
  24. #define TELEPHONY_H
  25. /* vendor identification numbers */
  26. #define PHONE_VENDOR_IXJ          1
  27. #define PHONE_VENDOR_QUICKNET     PHONE_IXJ
  28. #define PHONE_VENDOR_VOICETRONIX  2
  29. #define PHONE_VENDOR_ACULAB       3
  30. #define PHONE_VENDOR_DIGI         4
  31. #define PHONE_VENDOR_FRANKLIN     5
  32. /******************************************************************************
  33.  *  Vendor Summary Information Area
  34.  *
  35.  *  Quicknet Technologies, Inc. - makes low density analog telephony cards
  36.  *    with audio compression, POTS and PSTN interfaces (www.quicknet.net)
  37.  *
  38.  *  (other vendors following this API should add a short description of
  39.  *  the telephony products they support under Linux)
  40.  *
  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 its 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. typedef struct phone_capability {
  61. char desc[80];
  62. phone_cap captype;
  63. int cap;
  64. int handle;
  65. } PHONE_CAPABILITY;
  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. *
  124. *  Codec Definitions
  125. *
  126. * LINEAR16 (16 bit linear data) is signed integer (2's complement
  127. * form), positive full scale is 7FFFH, negative full scale is 8000H,
  128. * zero is 0000H. The data format is MSB first (Big Endian)
  129. *
  130. * 8 bit linear data is signed byte (2's complement form), positive
  131. * full scale is 7FH, negative full scale is 80H, zero is 00H
  132. *
  133. * 8 bit linear WSS data is unsigned byte, positive full scale is FFH,
  134. * negative full scale is 00H, zero is 80H.  This is the format used
  135. * for 8-bit WAVE format data (Windows Sound System).  Data can be
  136. * converted between the two 8-bit formats by simply inverting the ms
  137. * bit.
  138. *
  139. ******************************************************************************/
  140. typedef enum {
  141. G723_63 = 1,
  142. G723_53 = 2,
  143. TS85 = 3,
  144. TS48 = 4,
  145. TS41 = 5,
  146. G728 = 6,
  147. G729 = 7,
  148. ULAW = 8,
  149. ALAW = 9,
  150. LINEAR16 = 10,
  151. LINEAR8 = 11,
  152. WSS = 12
  153. } phone_codec;
  154. /******************************************************************************
  155. *
  156. * The exception structure allows us to multiplex multiple events onto
  157. * the select() exception set.  If any of these flags are set select()
  158. * will return with a positive indication on the exception set.  The
  159. * dtmf_ready bit indicates if there is data waiting in the DTMF
  160. * buffer.  The hookstate bit is set if there is a change in hookstate
  161. * status, it does not indicate the current state of the hookswitch.
  162. * The pstn_ring bit indicates that the DAA on an Internet LineJACK
  163. * card has detected ring voltage on the PSTN port.  The caller_id bit
  164. * indicates that caller_id data has been recieved and is available.
  165. * The pstn_wink bit indicates that the DAA on the Internet LineJACK
  166. * has recieved a wink from the telco switch.  The f0, f1, f2 and f3
  167. * bits indicate that the filter has been triggered by detecting the
  168. * frequency programmed into that filter.
  169. *
  170. * The remaining bits should be set to zero. They will become defined over time
  171. * for other interface cards and their needs.
  172. *
  173. ******************************************************************************/
  174. typedef struct phone_except
  175. {
  176. unsigned int dtmf_ready:1;
  177. unsigned int hookstate:1;
  178. unsigned int pstn_ring:1;
  179. unsigned int caller_id:1;
  180. unsigned int pstn_wink:1;
  181. unsigned int f0:1;
  182. unsigned int f1:1;
  183. unsigned int f2:1;
  184. unsigned int f3:1;
  185. unsigned int reserved:23;
  186. } TELEPHONY_EXCEPT;
  187. typedef union telephony_exception {
  188. struct phone_except bits;
  189. unsigned int bytes;
  190. } TELEPHONY_EXCEPTION;
  191. #endif /* TELEPHONY_H */