doc/ss7.txt

   1 ("Taken from the README in libss7")
   2 Tested Switches:
   3 ================
   4 Siemens EWSD - (ITU style) MTP2 and MTP3 comes up, ISUP inbound and outbound calls work as well.
   5 DTI DXC 4K - (ANSI style) 56kbps link, MTP2 and MTP3 come up, ISUP inbound and outbound calls work as well.
   6 Huawei M800 - (ITU style) MTP2 and MTP3 comes up, ISUP National, International inbound and outbound calls work as well, CallerID presentation&screening work.
   7 and MORE~!
   8
   9 Thanks:
  10 =======
  11 Mark Spencer, for writing Asterisk and libpri and being such a great friend and boss.
  12
  13 Luciano Ramos, for donating a link in getting the first "real" ITU switch working.
  14
  15 Collin Rose and John Lodden, John for introducing me to Collin, and Collin for the first
  16 "real" ANSI link and for holding my hand through the remaining changes that had to be
  17 done for ANSI switches.
  18
  19 To Use:
  20 =======
  21 In order to use libss7, you must get at least the following versions of Zaptel and Asterisk:
  22 Zaptel: 1.4.x
  23 libss7: trunk (currently, there *only* is a trunk release).
  24 Asterisk: trunk
  25
  26 You must then do a `make; make install` in each of the directories that you installed
  27 in the given order (Zaptel first, libss7 second, and Asterisk last).
  28
  29 NOTE: In order to check out the code, you must have the subversion client installed.  This
  30 is how to check them out from the public subversion server.
  31
  32 These are the commands you would type to install them:
  33
  34 #jpeeler: REVISIT
  35 `svn co http://svn.digium.com/svn/zaptel/branches/1.4 zaptel-1.4`
  36 `cd zaptel-1.4`
  37 `make; make install`
  38
  39 `svn co http://svn.digium.com/svn/libss7/trunk libss7-trunk`
  40 `cd libss7-trunk`
  41 `make; make install`
  42
  43 `svn co http://svn.digium.com/svn/asterisk/trunk asterisk-trunk`
  44 `cd asterisk-trunk`
  45 `./configure; make; make install;`
  46
  47 This should build Zaptel, libss7, and Asterisk with SS7 support.
  48
  49 In the past, there was a special asterisk-ss7 branch to use which contained the SS7 code.
  50 That code has been merged back into the trunk version of Asterisk, and the old asterisk-ss7
  51 branch has been deprecated and removed.  If you are still using the asterisk-ss7 branch, it
  52 will not work against the current version of libss7, and you should switch to asterisk-trunk
  53 instead.
  54
  55 CONFIGURATION:
  56 In zaptel.conf, your signalling channel(s) should be a "dchan" and your bearers should
  57 be set as "bchan".
  58
  59 In the asterisk-ss7 branch, there is a sample zapata.conf that is installed which
  60 contains sample configuration for setting up an E1 link.
  61
  62 In brief, here is a simple ss7 linkset setup:
  63
  64 signalling = ss7
  65 ss7type = itu           ; or ansi if you are using an ANSI link
  66
  67 linkset = 1             ; Pick a number for your linkset identifier in zapata.conf
  68
  69 pointcode = 28          ; The decimal form of your point code.  If you are using an
  70                         ; ANSI linkset, you can use the xxx-xxx-xxx notation for
  71                         ; specifying your linkset pointcode.
  72 adjpointcode = 2        ; The point code of the switch adjacent to your linkset
  73
  74 defaultdpc = 3          ; The point code of the switch you want to send your ISUP
  75                         ; traffic to.  A lot of the time, this is the same as your
  76                         ; adjpointcode.
  77
  78 ; Now we configure our Bearer channels (CICs)
  79
  80 cicbeginswith = 1       ; Number to start counting the CICs from.  So if Zap/1 to
  81                         ; Zap/15 are CICs 1-15, you would set this to 1 before you
  82                         ; declare channel=1-15
  83
  84 channel=1-15            ; Use Zap/1-15 and assign them to CICs 1-15
  85
  86 cicbeginswith = 17      ; Now for Zap/17 to Zap/31, they are CICs 17-31 so we initialize
  87                         ; cicbeginswith to 17 before we declare those channels
  88
  89 channel = 17-31         ; This assigns CICs 17-31 to channels 17-31
  90
  91 sigchan = 16            ; This is where you declare which Zap channel is your signalling
  92                         ; channel.  In our case it is Zap/16.  You can add redundant
  93                         ; signalling channels by adding additional sigchan= lines.
  94
  95 ; If we want an alternate redundant signalling channel add this
  96
  97 sigchan = 48            ; This would put two signalling channels in our linkset, one at
  98                         ; Zap/16 and one at Zap/48 which both would be used to send/receive
  99                         ; ISUP traffic.
 100
 101 ; End of zapata.conf
 102
 103 This is how a basic linkset is setup.  For more detailed zapata.conf SS7 config information
 104 as well as other options available for that file, see the default zapata.conf that comes
 105 with the samples in asterisk.  If you would like, you can do a `make samples` in your
 106 asterisk-trunk directory and it will install a sample zapata.conf for you that contains
 107 more information about SS7 setup.
 108
 109 For more information, please use the Asterisk-ss7 or Asterisk-dev mailing
 110 lists (I monitor them regularly) or email me directly.
 111
 112 Matthew Fredrickson
 113 creslin@digium.com
 114