e42d985719fa8f9fb26367ffbe7720df097dd882
[asterisk/asterisk.git] / channels / h323 / ast_h323.h
1 /*
2  * h323wrap.h
3  *
4  * OpenH323 Channel Driver for ASTERISK PBX.
5  *                      By Jeremy McNamara
6  *                      For The NuFone Network 
7  * 
8  * This code has been derived from code created by 
9  *              Michael Manousos and Mark Spencer
10  *
11  * This file is part of the chan_h323 driver for Asterisk
12  *
13  * chan_h323 is free software; you can redistribute it and/or modify
14  * it under the terms of the GNU General Public License as published by
15  * the Free Software Foundation; either version 2 of the License, or
16  * (at your option) any later version. 
17  *
18  * chan_h323 is distributed WITHOUT ANY WARRANTY; without even 
19  * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
20  * PURPOSE. See the GNU General Public License for more details. 
21  *
22  * You should have received a copy of the GNU General Public License
23  * along with this program; if not, write to the Free Software
24  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 
25  *
26  */
27
28
29 #include <ptlib.h>
30 #include <h323.h>
31 #include <h323pdu.h>
32 #include <mediafmt.h>
33 #include <lid.h>
34
35 #include <list>
36 #include <string>
37 #include <algorithm>
38
39 #include "chan_h323.h"
40
41 /**  These need to be redefined here because the C++
42          side of this driver is blind to the asterisk headers */
43         
44 /*! G.723.1 compression */
45 #define AST_FORMAT_G723_1       (1 << 0)
46 /*! GSM compression */
47 #define AST_FORMAT_GSM          (1 << 1)
48 /*! Raw mu-law data (G.711) */
49 #define AST_FORMAT_ULAW         (1 << 2)
50 /*! Raw A-law data (G.711) */
51 #define AST_FORMAT_ALAW         (1 << 3)
52 /*! MPEG-2 layer 3 */
53 #define AST_FORMAT_MP3          (1 << 4)
54 /*! ADPCM (whose?) */
55 #define AST_FORMAT_ADPCM        (1 << 5)
56 /*! Raw 16-bit Signed Linear (8000 Hz) PCM */
57 #define AST_FORMAT_SLINEAR      (1 << 6)
58 /*! LPC10, 180 samples/frame */
59 #define AST_FORMAT_LPC10        (1 << 7)
60 /*! G.729A audio */
61 #define AST_FORMAT_G729A        (1 << 8)
62 /*! SpeeX Free Compression */
63 #define AST_FORMAT_SPEEX        (1 << 9)
64 /*! ILBC Free Codec */
65 #define AST_FORMAT_ILBC         (1 << 10)
66
67 /**This class describes the G.723.1 codec capability.
68  */
69 class H323_G7231Capability : public H323AudioCapability
70 {
71     PCLASSINFO(H323_G7231Capability, H323AudioCapability);
72   public:
73     H323_G7231Capability(
74       BOOL annexA = TRUE  /// Enable Annex A silence insertion descriptors
75     );
76     Comparison Compare(const PObject & obj) const;
77
78     PObject * Clone() const;
79   
80         virtual H323Codec * CreateCodec(
81       H323Codec::Direction direction  /// Direction in which this instance runs
82     ) const;
83
84         unsigned GetSubType() const;
85     PString GetFormatName() const;
86     BOOL OnSendingPDU(
87       H245_AudioCapability & pdu,  /// PDU to set information on
88       unsigned packetSize          /// Packet size to use in capability
89     ) const;
90
91     BOOL OnReceivedPDU(
92       const H245_AudioCapability & pdu,  /// PDU to get information from
93       unsigned & packetSize              /// Packet size to use in capability
94     );
95   
96   protected:
97     BOOL annexA;
98 };
99
100 class MyH323EndPoint : public H323EndPoint {
101
102         PCLASSINFO(MyH323EndPoint, H323EndPoint);
103
104         public:
105
106         int MakeCall(const PString &, PString &, unsigned int *, unsigned int);
107         BOOL ClearCall(const PString &);
108 //      BOOL OnIncomingCall( H323Connection & connection, const H323SignalPDU &, H323SignalPDU &);
109
110         void OnClosedLogicalChannel(H323Connection &, const H323Channel &);
111         void OnConnectionEstablished(H323Connection &, const PString &);
112         void OnConnectionCleared(H323Connection &, const PString &);
113         H323Connection * CreateConnection(unsigned, void *);
114         void SendUserTone(const PString &, char);
115         H323Capabilities GetCapabilities(void);
116
117         PStringArray SupportedPrefixes; 
118         
119     void SetEndpointTypeInfo( H225_EndpointType & info ) const;
120     void SetGateway(void);
121 };
122
123   
124 class MyH323Connection : public H323Connection {
125
126         PCLASSINFO(MyH323Connection, H323Connection);
127
128         public:
129         MyH323Connection(MyH323EndPoint &, unsigned, unsigned, WORD);
130         ~MyH323Connection();
131
132         H323Channel * CreateRealTimeLogicalChannel(const H323Capability &, H323Channel::Directions, unsigned, 
133                                                                                            const H245_H2250LogicalChannelParameters *);
134         H323Connection::AnswerCallResponse OnAnswerCall(const PString &, const H323SignalPDU &, H323SignalPDU &);
135         BOOL OnAlerting(const H323SignalPDU &, const PString &);
136         BOOL OnReceivedSignalSetup(const H323SignalPDU &);
137         void OnReceivedReleaseComplete(const H323SignalPDU &);
138         BOOL OnSendSignalSetup(H323SignalPDU &);
139         BOOL OnStartLogicalChannel(H323Channel &);
140         BOOL OnClosingLogicalChannel(H323Channel &);
141         void SendUserInputTone(char, unsigned);
142         void OnUserInputTone(char, unsigned, unsigned, unsigned);
143         void OnUserInputString(const PString &value);
144
145         PString sourceAliases;
146         PString destAliases;
147         PString sourceE164;
148         PString destE164;
149
150         PIPSocket::Address externalIpAddress;   // IP address of media server
151     PIPSocket::Address remoteIpAddress;         // IP Address of remote endpoint
152         WORD                       externalPort;                // local media server Data port (control is dataPort+1)
153         WORD                       remotePort;                  // remote endpoint Data port (control is dataPort+1)
154 };
155
156
157 #if 0
158 class MyGatekeeperServer : public H323GatekeeperServer
159 {
160     PCLASSINFO(MyGatekeeperServer, H323GatekeeperServer);
161   public:
162     MyGatekeeperServer(MyH323EndPoint & ep);
163
164     // Overrides
165     virtual H323GatekeeperCall * CreateCall(
166       const OpalGloballyUniqueID & callIdentifier,
167       H323GatekeeperCall::Direction direction
168     );
169     virtual BOOL TranslateAliasAddressToSignalAddress(
170       const H225_AliasAddress & alias,
171       H323TransportAddress & address
172     );
173
174     // new functions
175     BOOL Initialise();
176
177   private:
178     class RouteMap : public PObject {
179         PCLASSINFO(RouteMap, PObject);
180       public:
181         RouteMap(
182           const PString & alias,
183           const PString & host
184         );
185         RouteMap(
186           const RouteMap & map
187         ) : alias(map.alias), regex(map.alias), host(map.host) { }
188
189         void PrintOn(
190           ostream & strm
191         ) const;
192
193         BOOL IsValid() const;
194
195         BOOL IsMatch(
196           const PString & alias
197         ) const;
198
199         const H323TransportAddress & GetHost() const { return host; }
200
201       private:
202         PString              alias;
203         PRegularExpression   regex;
204         H323TransportAddress host;
205     };
206     PList<RouteMap> routes;
207
208     PMutex reconfigurationMutex;
209 };
210
211 #endif
212
213 /**
214  * The MyProcess is a necessary descendant PProcess class so that the H323EndPoint 
215  * objected to be created from within that class. (Who owns main() problem). 
216  */
217 class MyProcess : public PProcess {
218
219         PCLASSINFO(MyProcess, PProcess);
220     
221         public:
222         MyProcess();
223         ~MyProcess();
224
225         void Main(); 
226         
227         
228 };
229
230
231 /** 
232  * This class handles the termination of a call.
233  * Note that OpenH323 Library requires that the termination
234  * of a call should be done inside a separate thread of execution.
235  */
236 class ClearCallThread : public PThread {
237
238         PCLASSINFO(ClearCallThread, PThread);
239
240         public:
241         ClearCallThread(const char *tc);
242         ~ClearCallThread();    
243         
244         void Main();
245         
246         protected:
247         PString token;
248 };
249
250