36b127bf149141d985ad067a885e8fc75deab58f
[asterisk/asterisk.git] / channels / iax2.h
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * Implementation of Inter-Asterisk eXchange
5  * 
6  * Copyright (C) 2003, Digium
7  *
8  * Mark Spencer <markster@linux-support.net>
9  *
10  * This program is free software, distributed under the terms of
11  * the GNU General Public License
12  */
13  
14 #ifndef _IAX2_H
15 #define _IAX2_H
16
17 /* Max version of IAX protocol we support */
18 #define IAX_PROTO_VERSION 2
19
20 #define IAX_MAX_CALLS 32768
21
22 #define IAX_FLAG_FULL           0x8000
23
24 #define IAX_FLAG_RETRANS        0x8000
25
26 #define IAX_FLAG_SC_LOG         0x80
27
28 #define IAX_MAX_SHIFT           0x1F
29
30 #define IAX_WINDOW                      64
31
32 /* Subclass for AST_FRAME_IAX */
33 #define IAX_COMMAND_NEW         1
34 #define IAX_COMMAND_PING        2
35 #define IAX_COMMAND_PONG        3
36 #define IAX_COMMAND_ACK         4
37 #define IAX_COMMAND_HANGUP      5
38 #define IAX_COMMAND_REJECT      6
39 #define IAX_COMMAND_ACCEPT      7
40 #define IAX_COMMAND_AUTHREQ     8
41 #define IAX_COMMAND_AUTHREP     9
42 #define IAX_COMMAND_INVAL       10
43 #define IAX_COMMAND_LAGRQ       11
44 #define IAX_COMMAND_LAGRP       12
45 #define IAX_COMMAND_REGREQ      13      /* Registration request */
46 #define IAX_COMMAND_REGAUTH     14      /* Registration authentication required */
47 #define IAX_COMMAND_REGACK      15      /* Registration accepted */
48 #define IAX_COMMAND_REGREJ      16      /* Registration rejected */
49 #define IAX_COMMAND_REGREL      17      /* Force release of registration */
50 #define IAX_COMMAND_VNAK        18      /* If we receive voice before valid first voice frame, send this */
51 #define IAX_COMMAND_DPREQ       19      /* Request status of a dialplan entry */
52 #define IAX_COMMAND_DPREP       20      /* Request status of a dialplan entry */
53 #define IAX_COMMAND_DIAL        21      /* Request a dial on channel brought up TBD */
54 #define IAX_COMMAND_TXREQ       22      /* Transfer Request */
55 #define IAX_COMMAND_TXCNT       23      /* Transfer Connect */
56 #define IAX_COMMAND_TXACC       24      /* Transfer Accepted */
57 #define IAX_COMMAND_TXREADY     25      /* Transfer ready */
58 #define IAX_COMMAND_TXREL       26      /* Transfer release */
59 #define IAX_COMMAND_TXREJ       27      /* Transfer reject */
60 #define IAX_COMMAND_QUELCH      28      /* Stop audio/video transmission */
61 #define IAX_COMMAND_UNQUELCH 29 /* Resume audio/video transmission */
62 #define IAX_COMMAND_POKE    30  /* Like ping, but does not require an open connection */
63 #define IAX_COMMAND_PAGE        31      /* Paging description */
64 #define IAX_COMMAND_MWI 32      /* Stand-alone message waiting indicator */
65 #define IAX_COMMAND_UNSUPPORT   33      /* Unsupported message received */
66 #define IAX_COMMAND_TRANSFER    34      /* Request remote transfer */
67 #define IAX_COMMAND_PROVISION   35      /* Provision device */
68
69 #define IAX_DEFAULT_REG_EXPIRE  60      /* By default require re-registration once per minute */
70
71 #define IAX_LINGER_TIMEOUT              10 /* How long to wait before closing bridged call */
72
73 #define IAX_DEFAULT_PORTNO              4569
74
75 /* IAX Information elements */
76 #define IAX_IE_CALLED_NUMBER            1               /* Number/extension being called - string */
77 #define IAX_IE_CALLING_NUMBER           2               /* Calling number - string */
78 #define IAX_IE_CALLING_ANI                      3               /* Calling number ANI for billing  - string */
79 #define IAX_IE_CALLING_NAME                     4               /* Name of caller - string */
80 #define IAX_IE_CALLED_CONTEXT           5               /* Context for number - string */
81 #define IAX_IE_USERNAME                         6               /* Username (peer or user) for authentication - string */
82 #define IAX_IE_PASSWORD                         7               /* Password for authentication - string */
83 #define IAX_IE_CAPABILITY                       8               /* Actual codec capability - unsigned int */
84 #define IAX_IE_FORMAT                           9               /* Desired codec format - unsigned int */
85 #define IAX_IE_LANGUAGE                         10              /* Desired language - string */
86 #define IAX_IE_VERSION                          11              /* Protocol version - short */
87 #define IAX_IE_ADSICPE                          12              /* CPE ADSI capability - short */
88 #define IAX_IE_DNID                                     13              /* Originally dialed DNID - string */
89 #define IAX_IE_AUTHMETHODS                      14              /* Authentication method(s) - short */
90 #define IAX_IE_CHALLENGE                        15              /* Challenge data for MD5/RSA - string */
91 #define IAX_IE_MD5_RESULT                       16              /* MD5 challenge result - string */
92 #define IAX_IE_RSA_RESULT                       17              /* RSA challenge result - string */
93 #define IAX_IE_APPARENT_ADDR            18              /* Apparent address of peer - struct sockaddr_in */
94 #define IAX_IE_REFRESH                          19              /* When to refresh registration - short */
95 #define IAX_IE_DPSTATUS                         20              /* Dialplan status - short */
96 #define IAX_IE_CALLNO                           21              /* Call number of peer - short */
97 #define IAX_IE_CAUSE                            22              /* Cause - string */
98 #define IAX_IE_IAX_UNKNOWN                      23              /* Unknown IAX command - byte */
99 #define IAX_IE_MSGCOUNT                         24              /* How many messages waiting - short */
100 #define IAX_IE_AUTOANSWER                       25              /* Request auto-answering -- none */
101 #define IAX_IE_MUSICONHOLD                      26              /* Request musiconhold with QUELCH -- none or string */
102 #define IAX_IE_TRANSFERID                       27              /* Transfer Request Identifier -- int */
103 #define IAX_IE_RDNIS                            28              /* Referring DNIS -- string */
104 #define IAX_IE_PROVISIONING                     29              /* Provisioning info */
105 #define IAX_IE_AESPROVISIONING                  30              /* AES Provisioning info */
106
107 #define IAX_AUTH_PLAINTEXT                      (1 << 0)
108 #define IAX_AUTH_MD5                            (1 << 1)
109 #define IAX_AUTH_RSA                            (1 << 2)
110
111 #define IAX_META_TRUNK                          1               /* Trunk meta-message */
112 #define IAX_META_VIDEO                          2               /* Video frame */
113
114 #define IAX_DPSTATUS_EXISTS                     (1 << 0)
115 #define IAX_DPSTATUS_CANEXIST           (1 << 1)
116 #define IAX_DPSTATUS_NONEXISTANT        (1 << 2)
117 #define IAX_DPSTATUS_IGNOREPAT          (1 << 14)
118 #define IAX_DPSTATUS_MATCHMORE          (1 << 15)
119
120 /* Full frames are always delivered reliably */
121 struct ast_iax2_full_hdr {
122         unsigned short scallno; /* Source call number -- high bit must be 1 */
123         unsigned short dcallno; /* Destination call number -- high bit is 1 if retransmission */
124         unsigned int ts;                /* 32-bit timestamp in milliseconds (from 1st transmission) */
125         unsigned char oseqno;   /* Packet number (outgoing) */
126         unsigned char iseqno;   /* Packet number (next incoming expected) */
127         char type;                              /* Frame type */
128         unsigned char csub;             /* Compressed subclass */
129         unsigned char iedata[0];
130 } __attribute__ ((__packed__));
131
132 /* Mini header is used only for voice frames -- delivered unreliably */
133 struct ast_iax2_mini_hdr {
134         unsigned short callno;  /* Source call number -- high bit must be 0, rest must be non-zero */
135         unsigned short ts;              /* 16-bit Timestamp (high 16 bits from last ast_iax2_full_hdr) */
136                                                         /* Frametype implicitly VOICE_FRAME */
137                                                         /* subclass implicit from last ast_iax2_full_hdr */
138         unsigned char data[0];
139 } __attribute__ ((__packed__));
140
141 struct ast_iax2_meta_hdr {
142         unsigned short zeros;                   /* Zeros field -- must be zero */
143         unsigned char metacmd;                  /* Meta command */
144         unsigned char cmddata;                  /* Command Data */
145         unsigned char data[0];
146 } __attribute__ ((__packed__));
147
148 struct ast_iax2_video_hdr {
149         unsigned short zeros;                   /* Zeros field -- must be zero */
150         unsigned short callno;                  /* Video call number */
151         unsigned short ts;                              /* Timestamp and mark if present */
152         unsigned char data[0];
153 } __attribute__ ((__packed__));
154
155 struct ast_iax2_meta_trunk_hdr {
156         unsigned int ts;                                /* 32-bit timestamp for all messages */
157         unsigned char data[0];
158 } __attribute__ ((__packed__));
159
160 struct ast_iax2_meta_trunk_entry {
161         unsigned short callno;                  /* Call number */
162         unsigned short len;                             /* Length of data for this callno */
163 } __attribute__ ((__packed__));
164
165 #endif