DevKitQuickStart

From OpenBTS
Jump to: navigation, search

Range Networks OpenBTS Dev Kit Quick-Start Guide

Because this is product is intended for use by software developers, this page assumes a working knowledge of the Linux command line and normal IP networking. It is a "developer's kit", after all.

Hardware

The Range developer's kit comprises a Range Networks "RAD1" wideband digital radio and a mini-ITX computer running Ubuntu Linux. It also includes a power supply and a pair of multi-band omni antennas.

Radio Performance

All Dev Kits have a maximum output power of 100 mW (20 dBm).

The standard Dev Kit (part number 2110-001) does not include any band-specific filtering in the transmitter or receiver. This allows it to be used in any of the four standard GSM bands. The lack of filtering does limit performance, though, due to output power leaking back into the input antenna. There are a few ways to mitigate this effect:

  • Use the CLI "power" command to lower the output power. The setting "power 20 20" will lower the output power level to 0 dBm, which is probably the best tradeoff between downlink range and uplink range.
  • Place the transmit and receive antennas as far apart as possible.
  • Keep transmit and receive antennas at right angles to each other to minimize crosstalk.

Accessing and Using the Dev Kit

The primary interface to the Dev Kit is the Linux shell, accessed via ssh from the Ethernet connector on the front panel. The unit is accessed via ssh. The Dev Kit is shipped with a default IP address of 192.168.0.21. There is a sudo-capable account called "openbts" with the password "openbts". Once you have configured another PC or laptop on the 192.168.0.x subnet, you can access the unit via ssh. From a Unix-type system (Linux or Mac OS X, for example), you can

ssh openbts@192.168.0.21

and then give the password "openbts". From a Windows machine, an ssh client, like PuTTY, can be used.

Software

The Range Networks software suite is now hosted on GitHub. All of the projects are accessible from this location: https://github.com/RangeNetworks

To get started, you will want to read this document: https://github.com/RangeNetworks/dev/wiki

Obtaining the Source Code

Information for downloading the source code is available here: https://github.com/RangeNetworks/dev/wiki#downloading

Building the Source Code

To build the source code, follow the directions here: https://github.com/RangeNetworks/dev/wiki#building

All of the Range/OpenBTS software follows a standard GNU build process. Go to the trunk directly for each component and execute

./autogen
./configure
make

Running the Software

The full OpenBTS system includes several components, the main server programs being:

  • OpenBTS itself, the GSM stack from L1 forward error correction up through layer 3
  • smqueue, the SMS store and forward server
  • sipauthserve, the SIP registration proxy
  • the subscriber registry database
  • a SIP PBX, like Asterisk, which is installed on the Dev Kit.

The relationship among these components is shown in this diagram. For details on running all of these components, see https://github.com/RangeNetworks/dev/wiki#running. For full functionality, these comments must be running:

  • OpenBTS
  • sipauthserve
  • smqueue
  • Asterisk

Asterisk runs automatically at startup, and from the OpenBTSCLI you can control many features of OpenBTS. All other applications must be started by hand. Instructions for the individual components follow.

Support

Support is available for free through the OpenBTS-discuss mailing list. For subscription information, see the primary Support Portal. If you have a paid support contract with Range Networks, please contact support@rangenetworks.com.