sync any left over changes
[asterisk/asterisk.git] / channels / h323 / ast_h323.h
1 /*
2  * ast_h323.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  * Version Info: $Id$ 
27  */
28
29
30 #include <ptlib.h>
31 #include <h323.h>
32 #include <h323pdu.h>
33 #include <mediafmt.h>
34 #include <lid.h>
35
36 #include <list>
37 #include <string>
38 #include <algorithm>
39
40 #include "chan_h323.h"
41
42 /**  These need to be redefined here because the C++
43          side of this driver is blind to the asterisk headers */
44         
45 /*! G.723.1 compression */
46 #define AST_FORMAT_G723_1       (1 << 0)
47 /*! GSM compression */
48 #define AST_FORMAT_GSM          (1 << 1)
49 /*! Raw mu-law data (G.711) */
50 #define AST_FORMAT_ULAW         (1 << 2)
51 /*! Raw A-law data (G.711) */
52 #define AST_FORMAT_ALAW         (1 << 3)
53 /*! MPEG-2 layer 3 */
54 #define AST_FORMAT_MP3          (1 << 4)
55 /*! ADPCM (whose?) */
56 #define AST_FORMAT_ADPCM        (1 << 5)
57 /*! Raw 16-bit Signed Linear (8000 Hz) PCM */
58 #define AST_FORMAT_SLINEAR      (1 << 6)
59 /*! LPC10, 180 samples/frame */
60 #define AST_FORMAT_LPC10        (1 << 7)
61 /*! G.729A audio */
62 #define AST_FORMAT_G729A        (1 << 8)
63 /*! SpeeX Free Compression */
64 #define AST_FORMAT_SPEEX        (1 << 9)
65 /*! ILBC Free Codec */
66 #define AST_FORMAT_ILBC         (1 << 10)
67
68 /**This class describes the G.723.1 codec capability.
69  */
70 class H323_G7231Capability : public H323AudioCapability
71 {
72     PCLASSINFO(H323_G7231Capability, H323AudioCapability);
73   public:
74     H323_G7231Capability(
75       BOOL annexA = TRUE  /// Enable Annex A silence insertion descriptors
76     );
77     Comparison Compare(const PObject & obj) const;
78
79     PObject * Clone() const;
80   
81         virtual H323Codec * CreateCodec(
82       H323Codec::Direction direction  /// Direction in which this instance runs
83     ) const;
84
85         unsigned GetSubType() const;
86     PString GetFormatName() const;
87     BOOL OnSendingPDU(
88       H245_AudioCapability & pdu,  /// PDU to set information on
89       unsigned packetSize          /// Packet size to use in capability
90     ) const;
91
92     BOOL OnReceivedPDU(
93       const H245_AudioCapability & pdu,  /// PDU to get information from
94       unsigned & packetSize              /// Packet size to use in capability
95     );
96   
97   protected:
98     BOOL annexA;
99 };
100
101 class MyH323EndPoint : public H323EndPoint {
102
103         PCLASSINFO(MyH323EndPoint, H323EndPoint);
104
105         public:
106
107         int MakeCall(const PString &, PString &, unsigned int *, unsigned int, char *);
108         BOOL ClearCall(const PString &);
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   
125 class MyH323Connection : public H323Connection {
126
127         PCLASSINFO(MyH323Connection, H323Connection);
128
129         public:
130         MyH323Connection(MyH323EndPoint &, unsigned, unsigned);
131         ~MyH323Connection();
132
133         H323Channel * CreateRealTimeLogicalChannel(const H323Capability &, H323Channel::Directions, unsigned, 
134                                                                                            const H245_H2250LogicalChannelParameters *);
135         H323Connection::AnswerCallResponse OnAnswerCall(const PString &, const H323SignalPDU &, H323SignalPDU &);
136         BOOL OnAlerting(const H323SignalPDU &, const PString &);
137         BOOL OnSendReleaseComplete(H323SignalPDU &);
138         BOOL OnReceivedSignalSetup(const H323SignalPDU &);
139         void OnReceivedReleaseComplete(const H323SignalPDU &);
140         BOOL OnReceivedFacility(const H323SignalPDU &);
141         BOOL OnSendSignalSetup(H323SignalPDU &);
142         BOOL OnStartLogicalChannel(H323Channel &);
143         BOOL OnClosingLogicalChannel(H323Channel &);
144         void SendUserInputTone(char, unsigned);
145         void OnUserInputTone(char, unsigned, unsigned, unsigned);
146         void OnUserInputString(const PString &value);
147
148         PString sourceAliases;
149         PString destAliases;
150         PString sourceE164;
151         PString destE164;
152
153         PIPSocket::Address externalIpAddress;   // IP address of media server
154     PIPSocket::Address remoteIpAddress;         // IP Address of remote endpoint
155         WORD                       externalPort;                // local media server Data port (control is dataPort+1)
156         WORD                       remotePort;                  // remote endpoint Data port (control is dataPort+1)
157         WORD                       sessionId;
158         BOOL                       bridging;                    // Used to help determine which IP to use
159 };
160
161
162 #if 0
163 class MyGatekeeperServer : public H323GatekeeperServer
164 {
165     PCLASSINFO(MyGatekeeperServer, H323GatekeeperServer);
166   public:
167     MyGatekeeperServer(MyH323EndPoint & ep);
168
169     // Overrides
170     virtual H323GatekeeperCall * CreateCall(
171       const OpalGloballyUniqueID & callIdentifier,
172       H323GatekeeperCall::Direction direction
173     );
174     virtual BOOL TranslateAliasAddressToSignalAddress(
175       const H225_AliasAddress & alias,
176       H323TransportAddress & address
177     );
178
179     // new functions
180     BOOL Initialise();
181
182   private:
183     class RouteMap : public PObject {
184         PCLASSINFO(RouteMap, PObject);
185       public:
186         RouteMap(
187           const PString & alias,
188           const PString & host
189         );
190         RouteMap(
191           const RouteMap & map
192         ) : alias(map.alias), regex(map.alias), host(map.host) { }
193
194         void PrintOn(
195           ostream & strm
196         ) const;
197
198         BOOL IsValid() const;
199
200         BOOL IsMatch(
201           const PString & alias
202         ) const;
203
204         const H323TransportAddress & GetHost() const { return host; }
205
206       private:
207         PString              alias;
208         PRegularExpression   regex;
209         H323TransportAddress host;
210     };
211     PList<RouteMap> routes;
212
213     PMutex reconfigurationMutex;
214 };
215
216 #endif
217
218 /**
219  * The MyProcess is a necessary descendant PProcess class so that the H323EndPoint 
220  * objected to be created from within that class. (Who owns main() problem). 
221  */
222 class MyProcess : public PProcess {
223
224         PCLASSINFO(MyProcess, PProcess);
225     
226         public:
227         MyProcess();
228         ~MyProcess();
229
230         void Main(); 
231         
232         
233 };
234
235
236 /** 
237  * This class handles the termination of a call.
238  * Note that OpenH323 Library requires that the termination
239  * of a call should be done inside a separate thread of execution.
240  */
241 class ClearCallThread : public PThread {
242
243         PCLASSINFO(ClearCallThread, PThread);
244
245         public:
246         ClearCallThread(const char *tc);
247         ~ClearCallThread();    
248         
249         void Main();
250         
251         protected:
252         PString token;
253 };
254
255