Alexander Chemeris | 040b305 | 2013-06-16 14:29:54 +0400 | [diff] [blame] | 1 | Welcome to the OpenBTS source code. |
| 2 | |
| 3 | |
| 4 | For free support, please subscribe to openbts-discuss@lists.sourceforge.net. |
| 5 | See http://sourceforge.net/mailarchive/forum.php?forum_name=openbts-discuss |
| 6 | and https://lists.sourceforge.net/lists/listinfo/openbts-discuss for details. |
| 7 | |
| 8 | For additional information, refer to http://openbts.org. |
| 9 | |
| 10 | |
| 11 | These are the directories: |
| 12 | |
| 13 | AsteriskConfig Asterisk configuration files for use with OpenBTS. |
| 14 | CommonLib Common-use libraries, mostly C++ wrappers for basic facilities. |
| 15 | Control Control-layer functions for the protocols of GSM 04.08 and SIP. |
| 16 | GSM The GSM stack. |
| 17 | SIP Components of the SIP state machines ued by the control layer. |
| 18 | SMS The SMS stack. |
| 19 | SR The subscriber registry. |
| 20 | TRXManager The interface between the GSM stack and the radio. |
| 21 | Transceiver The software transceiver and specific installation tests. |
| 22 | apps OpenBTS application binaries. |
| 23 | doc Project documentation. |
| 24 | tests Test fixtures for subsets of OpenBTS components. |
| 25 | smqueue RFC-3428 store-and-forward server for SMS |
| 26 | |
| 27 | |
| 28 | |
| 29 | By default, OpenBTS assumes the following UDP port assignments: |
| 30 | |
| 31 | 5060 -- Asterisk SIP interface |
| 32 | 5061 -- local SIP softphone |
| 33 | 5062 -- OpenBTS SIP interface |
| 34 | 5063 -- smqueue SIP interface |
| 35 | 5064 -- subscriber registry SIP interface |
| 36 | 5700-range -- OpenBTS-transceiver interface |
| 37 | |
| 38 | These can be controlled in the CONFIG table in /etc/OpenBTS.db. |
| 39 | |
| 40 | Standrd paths: |
| 41 | /OpenBTS -- Binary installation. |
| 42 | /etc/OpenBTS -- Configuration databases. |
| 43 | /var/run/OpenBTS -- Real-time reporting databases. |
| 44 | |
| 45 | The script apps/setUpFiles.sh will create these directories and install the |
| 46 | correct files in them. |
| 47 | |
| 48 | |
| 49 | |
| 50 | |
| 51 | Release history: |
| 52 | |
| 53 | Release Name SVN Reposiory SVN Rev Comments |
| 54 | |
| 55 | 1.0 (none) SF.net ?? completed L1, L2 |
| 56 | |
| 57 | 1.1 Arnaudville GNU Radio r10019 (trunk) |
| 58 | |
| 59 | 1.2 Breaux Bridge GNU Radio r10088 (trunk) GNU Build, very early assignment |
| 60 | |
| 61 | 1.3 Carencro KSP r1 (trunk) first post-injunction release |
| 62 | |
| 63 | 1.4 Donaldsonville KSP r23 (trunk) fixed Ubuntu build error |
| 64 | |
| 65 | 1.5 Eunice KSP r39 (trunk) fixed L2 bugs related to segmentation |
| 66 | removed incomplete SMS directory |
| 67 | moved "abort" calls into L3 subclasses |
| 68 | |
| 69 | 1.6 New Iberia KSP r130 (trunk) import of all 2.2 improvements to non-SMS release |
| 70 | |
| 71 | |
| 72 | 2.0 St. Francisville KSP r54 (smswork) SMS support |
| 73 | file-based configuration |
| 74 | |
| 75 | 2.1 Grand Coteau KSP r70 (smswork) DTMF support |
| 76 | fixed more Linux-related build errors |
| 77 | -lpthread |
| 78 | TLMessage constructor |
| 79 | expanded stack to prevent overflows in Linux |
| 80 | moved gSIPInterface to main app |
| 81 | fixed iterator bug in Pager |
| 82 | |
| 83 | 2.2 Houma KSP r122 (smswork) added LEGAL notice |
| 84 | removed Assert classes |
| 85 | stop paging on page response |
| 86 | fixed Pager-spin bug |
| 87 | fixed Transceiver spin bugs |
| 88 | fixed 2^32 microsecond rollover bug |
| 89 | reduced stack footprints in Transceiver |
| 90 | fixed SMS timestamps |
| 91 | check LAI before using TMSI in LUR |
| 92 | reduced memory requirement by 75% |
| 93 | removed PagerTest |
| 94 | fixed stale-transaction bug in paging handler |
| 95 | fixed USRP clock rollover bug |
| 96 | faster call connection |
| 97 | new USRPDevice design |
| 98 | |
| 99 | 2.3 Jean Lafitte KSP r190? (trunk) check for out-of-date RACH bursts |
| 100 | better TRX-GSM clock sync |
| 101 | formal logging system |
| 102 | command line interface |
| 103 | emergency call setup |
| 104 | |
| 105 | 2.4 Kinder KSP r208? (trunk) fixed BCCH neighbor list bug |
| 106 | support for neighbor lists |
| 107 | fixed support for non-local Asterisk servers |
| 108 | cleaner configuration management |
| 109 | more realtime control of BCCH parameters |
| 110 | proper rejection of Hold messages |
| 111 | fixed L3 hanging bug in MTDCheckBYE |
| 112 | |
| 113 | 2.4.1 Kinder KSP r462 fixed lots of valgrind errors |
| 114 | |
| 115 | 2.4.2 Kinder KSP r482 zero-length calling party number bug |
| 116 | g++ 4.4 #includes |
| 117 | |
| 118 | 2.5 Lacassine KSP r551 imported Joshua Lackey patches |
| 119 | SIP fixes from Anne Kwong |
| 120 | SIP fixes from testing with SMS server |
| 121 | L3 TI handling fixes |
| 122 | SMS server support |
| 123 | GNU Radio 3.2 compatibility |
| 124 | configurable max range and LU-reject cause |
| 125 | "page" & "testcall" CLI features |
| 126 | |
| 127 | 2.5.1 Lacassine KSP r595 fixed some build bugs for some Linux distros |
| 128 | |
| 129 | 2.5.2 Lacassine KSP r630 fixed channel assignment bug for Nokia DCT4+ handsets |
| 130 | |
| 131 | 2.5.3 Lacassine KSP r756 merged fix for transceiver startup crash |
| 132 | due to use of uninitialized variables (r646) |
| 133 | merged fix for fusb bug from trunk (r582) |
| 134 | |
| 135 | 2.5.4 Lacassine KSP r812 merged fixes to build under latest Fedora and |
| 136 | to build with git GnuRadio (r814) |
| 137 | |
| 138 | 2.6 Mamou KSP r886 fixed infamous fusb bug (r582) |
| 139 | fixed idle-filling table size bug |
| 140 | smoother uplink power control |
| 141 | load-limiting downlink power control |
| 142 | new "config" features (optional, static) |
| 143 | IMEI interrogation |
| 144 | fixed MOD "missing FIFO" bug |
| 145 | configurable short code features |
| 146 | fixed transceiver startup crash (r646) |
| 147 | readline support is back |
| 148 | fixed timing advance bug (r844) |
| 149 | added CLI "chans" command |
| 150 | track time-of-use in TMSI table (r844) |
| 151 | added CLI "noise" command (r844) |
| 152 | added CLI "rxpower" command (r844) |
| 153 | added CLI "unconfig" command |
| 154 | |
| 155 | 2.7 Natchitoches Range rxxx (never released publicly) |
| 156 | converted TMSITable to sqlite3 (r902) |
| 157 | sqlite3-based configuration (r???) |
| 158 | converted Logger to syslogd (r903) |
| 159 | added support for rest octets (r1022) |
| 160 | external database for transaction reporting (r1184) |
| 161 | external database for channel status reporting (r1203) |
| 162 | in-call delivery and submission of text messages (r1231) |
| 163 | RFC-2833 DMTF (r1249) |
| 164 | |
| 165 | 2.8 Opelousas Range rxxx move databases to /etc and /var |
| 166 | RRLP aiding support |
| 167 | |
| 168 | |