message.h

   1 /*****************************************************************************\
   2 **                                                                           **
   3 ** Linux Call Router                                                         **
   4 **                                                                           **
   5 **---------------------------------------------------------------------------**
   6 ** Copyright: Andreas Eversberg                                              **
   7 **                                                                           **
   8 ** message types and parameters                                              **
   9 **                                                                           **
  10 \*****************************************************************************/
  11
  12 #define ISDN_TRANSMIT   256 // samples
  13
  14 enum { /* interface types */
  15         INFO_ITYPE_ISDN, /* call from external */
  16         INFO_ITYPE_ISDN_EXTENSION, /* call from internal extension */
  17         INFO_ITYPE_CHAN,
  18         INFO_ITYPE_VBOX
  19 };
  20
  21 enum { /* number types */
  22         INFO_NTYPE_NOTPRESENT = 0,
  23         INFO_NTYPE_UNKNOWN,
  24         INFO_NTYPE_SUBSCRIBER,
  25         INFO_NTYPE_NATIONAL,
  26         INFO_NTYPE_INTERNATIONAL
  27 };
  28
  29 enum { /* number presentation */
  30         INFO_PRESENT_NOTAVAIL,
  31         INFO_PRESENT_ALLOWED,
  32         INFO_PRESENT_RESTRICTED
  33 };
  34
  35 enum { /* number presentation */
  36         INFO_SCREEN_USER, /* user provided */
  37         INFO_SCREEN_USER_VERIFIED_PASSED,
  38         INFO_SCREEN_USER_VERIFIED_FAILED,
  39         INFO_SCREEN_NETWORK /* network provided */
  40 };
  41
  42 enum { /* redirection reason */
  43         INFO_REDIR_UNKNOWN = 0,
  44         INFO_REDIR_BUSY,
  45         INFO_REDIR_NORESPONSE,
  46         INFO_REDIR_UNCONDITIONAL,
  47         INFO_REDIR_OUTOFORDER,
  48         INFO_REDIR_CALLDEFLECT
  49 };
  50
  51 #define INFO_NOTIFY_NONE                        0x00
  52 #define INFO_NOTIFY_USER_SUSPENDED              0x80
  53 #define INFO_NOTIFY_USER_RESUMED                0x81
  54 #define INFO_NOTIFY_BEARER_SERVICE_CHANGED      0x82
  55 #define INFO_NOTIFY_CALL_COMPLETION_DELAY       0x83
  56 #define INFO_NOTIFY_CONFERENCE_ESTABLISHED      0xc2
  57 #define INFO_NOTIFY_CONFERENCE_DISCONNECTED     0xc3
  58 #define INFO_NOTIFY_OTHER_PARTY_ADDED           0xc4
  59 #define INFO_NOTIFY_ISOLATED                    0xc5
  60 #define INFO_NOTIFY_REATTACHED                  0xc6
  61 #define INFO_NOTIFY_OTHER_PARTY_ISOLATED        0xc7
  62 #define INFO_NOTIFY_OTHER_PARTY_REATTACHED      0xc8
  63 #define INFO_NOTIFY_OTHER_PARTY_SPLIT           0xc9
  64 #define INFO_NOTIFY_OTHER_PARTY_DISCONNECTED    0xca
  65 #define INFO_NOTIFY_CONFERENCE_FLOATING         0xcb
  66 #define INFO_NOTIFY_CONFERENCE_DISCONNECTED_P   0xcc /* preemted */
  67 #define INFO_NOTIFY_CONFERENCE_FLOATING_S_U_P   0xcf /* served user preemted */
  68 #define INFO_NOTIFY_CALL_IS_A_WAITING_CALL      0xe0
  69 #define INFO_NOTIFY_DIVERSION_ACTIVATED         0xe8
  70 #define INFO_NOTIFY_RESERVED_CT_1               0xe9
  71 #define INFO_NOTIFY_RESERVED_CT_2               0xea
  72 #define INFO_NOTIFY_REVERSE_CHARGING            0xee
  73 #define INFO_NOTIFY_REMOTE_HOLD                 0xf9
  74 #define INFO_NOTIFY_REMOTE_RETRIEVAL            0xfa
  75 #define INFO_NOTIFY_CALL_IS_DIVERTING           0xfb
  76
  77 enum { /* diversion types */
  78         INFO_DIVERSION_CFU,
  79         INFO_DIVERSION_CFNR,
  80         INFO_DIVERSION_CFB,
  81         INFO_DIVERSION_CFP,
  82 };
  83
  84 /* bearer capabilities */
  85 #define INFO_BC_SPEECH                                  0x00
  86 #define INFO_BC_DATAUNRESTRICTED                        0x08
  87 #define INFO_BC_DATARESTRICTED                          0x09
  88 #define INFO_BC_AUDIO                                   0x10
  89 #define INFO_BC_DATAUNRESTRICTED_TONES                  0x11
  90 #define INFO_BC_VIDEO                                   0x18
  91
  92 /* bearer mode */
  93 #define INFO_BMODE_CIRCUIT                              0
  94 #define INFO_BMODE_PACKET                               2
  95
  96 /* bearer user l1 */
  97 #define INFO_INFO1_NONE                                 0x00
  98 #define INFO_INFO1_V110                                 0x81
  99 #define INFO_INFO1_ULAW                                 0x82
 100 #define INFO_INFO1_ALAW                                 0x83
 101 #define INFO_INFO1_G721                                 0x84
 102 #define INFO_INFO1_H221H242                             0x85
 103 #define INFO_INFO1_NONCCITT                             0x87
 104 #define INFO_INFO1_V120                                 0x88
 105 #define INFO_INFO1_X31HDLC                              0x89
 106
 107 /* hlc */
 108 #define INFO_HLC_NONE                                   0x00
 109 #define INFO_HLC_TELEPHONY                              0x81
 110 #define INFO_HLC_FAXG2G3                                0x84
 111 #define INFO_HLC_FAXG4                                  0xa1
 112 #define INFO_HLC_TELETEX1                               0xa4
 113 #define INFO_HLC_TELETEX2                               0xa8
 114 #define INFO_HLC_TELETEX3                               0xb1
 115 #define INFO_HLC_VIDEOTEX1                              0xb2
 116 #define INFO_HLC_VIDEOTEX2                              0xb3
 117 #define INFO_HLC_TELEX                                  0xb5
 118 #define INFO_HLC_MHS                                    0xb8
 119 #define INFO_HLC_OSI                                    0xc1
 120 #define INFO_HLC_MAINTENANCE                            0xde
 121 #define INFO_HLC_MANAGEMENT                             0xdf
 122 #define INFO_HLC_AUDIOVISUAL                            0xe0
 123
 124 enum { /* isdnsignal */
 125         mISDNSIGNAL_VOLUME,             /* change volume */
 126         mISDNSIGNAL_CONF,               /* joint/split conference */
 127         mISDNSIGNAL_JOINDATA,           /* data required by join instance */
 128         mISDNSIGNAL_ECHO,               /* enable/disable echoe */
 129         mISDNSIGNAL_DELAY,              /* use delay or adaptive jitter */
 130 };
 131
 132 enum { /* bchannel assignment */
 133         BCHANNEL_REQUEST,               /* application requests bchannel */
 134         BCHANNEL_RELEASE,               /* application releases bchannel */
 135         BCHANNEL_ASSIGN,                /* bchannel assigned by LCR */
 136         BCHANNEL_ASSIGN_ACK,            /* application acknowledges */
 137         BCHANNEL_REMOVE,                /* bchannel removed by LCR */
 138         BCHANNEL_REMOVE_ACK,            /* application acknowledges */
 139 };
 140 enum {
 141         B_STATE_IDLE,           /* not open */
 142         B_STATE_ACTIVATING,     /* DL_ESTABLISH sent */
 143         B_STATE_ACTIVE,         /* channel active */
 144         B_STATE_DEACTIVATING,   /* DL_RELEASE sent */
 145         B_STATE_EXPORTING,      /* BCHANNEL_ASSIGN sent */
 146         B_STATE_REMOTE,         /* bchannel assigned to remote application */
 147         B_STATE_IMPORTING,      /* BCHANNEL_REMOVE sent */
 148 };
 149 enum {
 150         B_MODE_TRANSPARENT,     /* normal transparent audio */
 151         B_MODE_HDLC,            /* hdlc data mode */
 152 };
 153
 154 /* call-info structure CALLER */
 155 struct caller_info {
 156         char id[32];                    /* id of caller (user number) */
 157         char extension[32];             /* internal id */
 158         char name[16];
 159         int isdn_port;                  /* internal/external port (if call is isdn) */
 160         char interface[32];             /* interface name the call was from */
 161         int itype;                      /* type of interface */
 162         int ntype;                      /* type of number */
 163         int present;                    /* presentation */
 164         int screen;                     /* who provided the number */
 165         char display[84];               /* display information */
 166         char id2[32];                   /* second callerid */
 167         int ntype2;                     /* second type of number */
 168         int present2;                   /* second presentation */
 169         int screen2;                    /* second who provided the number */
 170         char imsi[16];                  /* IMSI for gsm originated calls */
 171 };
 172
 173 /* call-info structure DIALING */
 174 struct dialing_info {
 175         char id[256];                   /* number dialing (so far) */
 176         char interfaces[128];           /* interfaces for extenal calls */
 177         int itype;                      /* type of interface */
 178         int ntype;                      /* type of number */
 179         int sending_complete;           /* end of dialing */
 180         char display[84];               /* display information */
 181 };
 182
 183 /* call-info structure CONNECT */
 184 struct connect_info {
 185         char id[32];                    /* id of caller (user number) */
 186         char extension[32];             /* internal id */
 187         char name[16];
 188         int isdn_port;                  /* internal/external port (if call is isdn) */
 189         char interface[128];            /* interface for extenal calls */
 190         int itype;                      /* type of interface */
 191         int ntype;                      /* type of number */
 192         int present;                    /* presentation */
 193         int screen;                     /* who provided the number */
 194         char display[84];               /* display information */
 195         char imsi[16];                  /* IMSI for gsm terminated calls */
 196 };
 197
 198 /* call-info structure DISCONNECT */
 199 struct disconnect_info {
 200         int cause;                      /* reason for disconnect */
 201         int location;                   /* disconnect location */
 202         char display[84];               /* optional display information */
 203 };
 204
 205 /* call-info structure REDIR */
 206 struct redir_info {
 207         char id[32];                    /* id of caller (user number) */
 208         char extension[32];             /* internal id */
 209         int isdn_port;                  /* internal/external port (if call is isdn) */
 210         int itype;                      /* type of interface */
 211         int ntype;                      /* type of number */
 212         int present;                    /* presentation */
 213         int screen;                     /* who provided the number */
 214         int reason;                     /* reason for redirecing */
 215 };
 216
 217 /* call-info structure capability */
 218 struct capa_info {
 219         int source_mode;                /* forward mode */
 220         int bearer_capa;                /* capability */
 221         int bearer_mode;                /* circuit/packet */
 222         int bearer_info1;               /* alaw,ulaw,... */
 223         int hlc;                        /* hlc capability */
 224         int exthlc;                     /* extendet hlc */
 225 };
 226
 227 /* call-info structure NOTIFY */
 228 struct notify_info {
 229         int notify;                     /* notifications (see INFO_NOTIFY_*) */
 230         char id[32];                    /* redirection id (user number) */
 231         char extension[32];             /* internal id */
 232         int isdn_port;                  /* internal/external port (if call is isdn) */
 233         int itype;                      /* type of interface */
 234         int ntype;                      /* type of number */
 235         int present;                    /* redirection presentation */
 236         char display[84];               /* display information */
 237         int local;                      /* if set, endpoints gets information about audio channel (open/close) */
 238 };
 239
 240 /* call-info structure FACILITY */
 241 struct facility_info {
 242         char data[256];                 /* data info about facility */
 243         int len;                        /* length of facility content */
 244 };
 245
 246 /* call-info structure USERUSER */
 247 struct useruser_info {
 248         int protocol;
 249         int len;
 250         unsigned char data[128];        /* user-user info (not a sting!)*/
 251 };
 252
 253 /* call-info structure SETUP */
 254 struct message_setup {
 255         int isdn_port; /* card number 1...n (only on calls from isdn port) */
 256         int port_type; /* type of port (only required if message is port -> epoint) */
 257         int partyline; /* if set, call will be a conference room */
 258         int partyline_jingle; /* if set, the jingle will be played on conference join */
 259         struct caller_info callerinfo;          /* information about the caller */
 260         struct dialing_info dialinginfo;        /* information about dialing */
 261         struct redir_info redirinfo;            /* info on redirection (to the calling user) */
 262         struct capa_info capainfo;              /* info on l2,l3 capability */
 263         struct useruser_info useruser;          /* user-user */
 264         char context[128];                      /* asterisk context */
 265 };
 266
 267 /* call-info structure PARK */
 268 struct park_info {
 269         char callid[8];
 270         int len;
 271 };
 272
 273 /* DATA */
 274 struct param_data {
 275         unsigned char data[ISDN_TRANSMIT]; /* audio/hdlc data */
 276         int len; /* audio/hdlc data */
 277 };
 278
 279 struct param_play {
 280         char file[512]; /* file name */
 281         int offset; /* offset to start file at (in seconds) */
 282 };
 283
 284 struct param_tone {
 285         char dir[128]; /* directory */
 286         char name[128]; /* file name */
 287 };
 288
 289 struct param_counter {
 290         int current; /* current counter in seconds */
 291         int max; /* total size of file (0=no info) */
 292 };
 293
 294 struct param_mISDNsignal {
 295         int message;
 296         int tx_gain;
 297         int rx_gain;
 298         int conf;
 299         int joindata;
 300         int tone;
 301         int echo;
 302         int delay;
 303 };
 304
 305 /* encryption control structure CRYPT */
 306 struct param_crypt {
 307         int type; /* see messages in crypt.h */
 308         int len;
 309         unsigned char data[512+32]; /* a block of 512 byte + some overhead */
 310 };
 311
 312 struct param_hello {
 313         char application[32]; /* name of remote application */
 314 };
 315
 316 struct param_bchannel {
 317         int type; /* BCHANNEL_* */
 318         unsigned int handle; /* bchannel stack/portid */
 319         int tx_gain, rx_gain;
 320         char pipeline[256];
 321         unsigned char crypt[128];
 322         int crypt_len;
 323         int crypt_type; /* 1 = blowfish */
 324 };
 325
 326 /* structure of message parameter */
 327 union parameter {
 328         struct param_tone tone; /* MESSAGE_TONE */
 329         char dtmf; /* MESSAGE_DTMF */
 330         struct message_setup setup; /* MESSAGE_SETUP */
 331         struct dialing_info information; /* MESSAGE_INFO */
 332         struct connect_info connectinfo; /* CONNECT INFO */
 333         struct disconnect_info disconnectinfo; /* DISCONNECT INFO */
 334         struct notify_info notifyinfo; /* some notifications */
 335         struct facility_info facilityinfo; /* some notifications */
 336         struct park_info parkinfo; /* MESSAGE_SUSPEND, MESSAGE_RESUME */
 337         int state; /* MESSAGE_TIMEOUT */
 338         int knock; /* MESSAGE_KNOCK 0=off !0=on */
 339         int audiopath; /* MESSAGE_audiopath see RELATION_CHANNEL_* (join.h) */
 340         struct param_data data; /* MESSAGE_DATA */
 341         struct param_play play; /* MESSAGE_VBOX_PLAY */
 342         int speed; /* MESSAGE_VBOX_PLAY_SPEED */
 343         struct param_counter counter; /* MESSAGE_TONE_COUNTER */
 344         struct param_mISDNsignal mISDNsignal; /* MESSAGE_mISDNSIGNAL */
 345         struct extension ext; /* tell port about extension information */
 346         struct param_crypt crypt; /* MESSAGE_CRYPT */
 347         struct param_hello hello; /* MESSAGE_HELLO */
 348         struct param_bchannel bchannel; /* MESSAGE_BCHANNEL */
 349         int direction; /* MESSAGE_NEWREF */
 350 };
 351
 352 enum { /* message flow */
 353         PORT_TO_EPOINT,
 354         EPOINT_TO_JOIN,
 355         JOIN_TO_EPOINT,
 356         EPOINT_TO_PORT,
 357 };
 358
 359 /* message structure */
 360 struct lcr_msg {
 361         struct lcr_msg *next;
 362         int type; /* type of message */
 363         int flow; /* from where to where */
 364         unsigned int id_from; /* in case of flow==PORT_TO_EPOINT: id_from is the port's serial, id_to is the epoint's serial */
 365         unsigned int id_to;
 366         int keep;
 367         union parameter param;
 368 };
 369
 370 enum { /* messages between entities */
 371         MESSAGE_NONE,           /* no message */
 372         MESSAGE_TONE,           /* set information tone (to isdn port) */
 373         MESSAGE_DTMF,           /* dtmf digit (from isdn port) */
 374         MESSAGE_ENABLEKEYPAD,   /* remote application requests keypad/dtmf */
 375         MESSAGE_mISDNSIGNAL,    /* special mixer command (down to isdn port) */
 376         MESSAGE_SETUP,          /* setup message */
 377         MESSAGE_INFORMATION,    /* additional digit information */
 378         MESSAGE_OVERLAP,        /* call accepted, send more information */
 379         MESSAGE_PROCEEDING,     /* proceeding */
 380         MESSAGE_ALERTING,       /* ringing */
 381         MESSAGE_CONNECT,        /* connect */
 382         MESSAGE_DISCONNECT,     /* disconnect with cause */
 383         MESSAGE_RELEASE,        /* release with cause */
 384         MESSAGE_TIMEOUT,        /* protocol state has timed out (port->epoint) */
 385         MESSAGE_NOTIFY,         /* used to send progress and notify infos */
 386         MESSAGE_FACILITY,       /* used to facility infos, like aocd */
 387         MESSAGE_SUSPEND,        /* suspend port */
 388         MESSAGE_RESUME,         /* resume port */
 389         MESSAGE_AUDIOPATH,      /* set status of audio path to endpoint (to call, audio is also set) */
 390 //      MESSAGE_REMOTE_AUDIO,   /* tell remote to set audio status */
 391         MESSAGE_PATTERN,        /* pattern information tones available */
 392         MESSAGE_NOPATTERN,      /* pattern information tones unavailable */
 393         MESSAGE_CRYPT,          /* encryption message */
 394         MESSAGE_DATA,           /* audio/hdlc data */
 395         MESSAGE_VBOX_PLAY,      /* play recorded file */
 396         MESSAGE_VBOX_PLAY_SPEED,/* change speed of file */
 397         MESSAGE_VBOX_TONE,      /* set answering VBOX tone */
 398         MESSAGE_TONE_COUNTER,   /* tone counter (for VBOX tone use) */
 399         MESSAGE_TONE_EOF,       /* tone is end of file */
 400         MESSAGE_BCHANNEL,       /* request/assign/remove bchannel */
 401         MESSAGE_HELLO,          /* hello message for remote application */
 402         MESSAGE_NEWREF,         /* special message to create and inform ref */
 403 };
 404
 405 #define MESSAGES static const char *messages_txt[] = { \
 406         "MESSAGE_NONE", \
 407         "MESSAGE_TONE", \
 408         "MESSAGE_DTMF", \
 409         "MESSAGE_ENABLEKEYPAD", \
 410         "MESSAGE_mISDNSIGNAL", \
 411         "MESSAGE_SETUP", \
 412         "MESSAGE_INFORMATION", \
 413         "MESSAGE_OVERLAP", \
 414         "MESSAGE_PROCEEDING", \
 415         "MESSAGE_ALERTING", \
 416         "MESSAGE_CONNECT", \
 417         "MESSAGE_DISCONNECT", \
 418         "MESSAGE_RELEASE", \
 419         "MESSAGE_TIMEOUT", \
 420         "MESSAGE_NOTIFY", \
 421         "MESSAGE_FACILITY", \
 422         "MESSAGE_SUSPEND", \
 423         "MESSAGE_RESUME", \
 424         "MESSAGE_AUDIOPATH", \
 425 /*      "MESSAGE_REMOTE_AUDIO",*/ \
 426         "MESSAGE_PATTERN", \
 427         "MESSAGE_NOPATTERN", \
 428         "MESSAGE_CRYPT", \
 429         "MESSAGE_DATA", \
 430         "MESSAGE_VBOX_PLAY", \
 431         "MESSAGE_VBOX_PLAY_SPEED", \
 432         "MESSAGE_VBOX_TONE", \
 433         "MESSAGE_TONE_COUNTER", \
 434         "MESSAGE_TONE_EOF", \
 435         "MESSAGE_BCHANNEL", \
 436         "MESSAGE_HELLO", \
 437         "MESSAGE_NEWREF", \
 438 };
 439
 440
 441 struct lcr_msg *message_create(int id_from, int id_to, int flow, int type);
 442 void message_put(struct lcr_msg *message);
 443 struct lcr_msg *message_forward(int id_from, int id_to, int flow, union parameter *param);
 444 struct lcr_msg *message_get(void);
 445 void message_free(struct lcr_msg *message);
 446
 447
 448