YateBTS Lab Kit Quick Start Guide

From YateBTS
Jump to: navigation, search

Congratulations for purchasing this Lab Kit! Please follow the steps below to get started.

What you get

1 Lab Kit

1 Lab Kit power adapter

2 GSM antennas

2 filters, one for use in the Americas (in red) and one for the rest of the world (in black)

2 phones and their chargers

5 SIM cards (two of them are already written and inserted in the phones)

1 Smart Card Reader

1 Wi-Fi antenna

Important! Your YateBTS LabKit is also pre-configured to provide access to the Hosted Core, a free service that allows users to experiment with a fully-functional GSM/GPRS or LTE/IMS network. The 5 SIM cards you have received will have already been registered there. The Hosted Core credentials are:

username: 
password: 


A. Assembling your Lab Kit

Rear view of the Lab Kit

1. Connect one antenna to the TX socket.

2. Connect the filter to the RX socket. Then, connect the other antenna to the filter.

Note: Use the European filter, in red, if you are in the Americas. Use the American filter, in black, if you are in the rest of the world. This is mandatory to avoid local interference.

By the Americas we are referring to the following regions: North America, South and Central America. The GSM operating bands for the American region are typically 850 MHz and 1,900 MHz.

By the rest of the world we are referring to the following regions: Europe, Middle East, Asia, Africa and Australia. The GSM operating bands for these regions are 900 MHz and 1800 MHz.

Filter Color Use
900 MHz Red For use in the Americas (ITU Region 2)
850 MHz Black For use in the rest of the world (ITU Regions 1 and 3)
Note: Screw the antennas as tight as possible. Always angle the antennas at a 90° orientation.

3. Connect the Lab Kit to the power supply with a cable via the +12VDC socket.

Keep in mind that the adapter's label should also indicate the power output.

Adapter label

Optional: steps 4 and 5

4. Connect the Wi-Fi antenna to the two sockets.

5. Connect the Smart Card Reader to a USB port.

To start writing SIM cards insert one of the empty SIMs into the reader, with the metal contact facing up. To learn more about writing SIMs and adding subscribers, go to the Add a subscriber from the Lab Kit section.

Smart Card Reader and SIM card

B. Accessing your Lab Kit

Locally

1. Connect the Lab Kit to the monitor via the HDMI or DVI video outputs ; connect the keyboard and mouse to any of the USB sockets or to the dedicated mouse/keyboard PS2 port.

2. As soon as you have powered the Lab Kit you will be asked for a password. The password is the serial number found on the front of your Lab Kit.

Serial number on the front of the Lab Kit

You can also find your Lab Kit's serial number by opening the LXTerminal console on the taskbar of your desktop, on the first line: [yatebts@ybts-'serial number'~]$.

3. Access the YateBTS WebGUI locally by clicking on the YateBTS Config icon on the desktop.

Configuration icon logo

This allows you to access the GUI, via HTTP, on two different ports.

1. If the machine is not in a secured network, it should be made accessible only from localhost by uncommenting the content of the .htaccess:

or

2. You may also connect to the web server using the following links:

or

Remotely

Note: Use the 2080 port to access the web server installed on the Lab Kit.

1. DHCP through the Intel Ethernet port

  • Connect the Lab Kit to your Wi-Fi router or switch with an Ethernet cable, in the Intel Ethernet port, as seen in the image showing Lab Kit's rear side.
  • To find out your assigned IP address, enter the Mageia Control Center, go to Network & Internet, open the Network Center and select Wired (Ethernet) and click on Configure.
  • Open your computer's browser and go to: http://assigned-IP-address:2080/nib/main.php to access the YateBTS WebGUI.

2. DHCP through the Intel Wi-Fi antenna

  • Connect the Wi-Fi antenna to your Lab Kit.
  • To find out the IP address you have been assigned, enter the Mageia Control Center, go to Network & Internet, open the Network Center and look for the Wireless (Wi-Fi) connection.
  • Click on you SSID and select the Configure option to find out your assigned IP address.
  • Open your computer's browser and go to: http://assigned-IP-address:2080/nib/main.php to access the YateBTS WebGUI.

3. Through a fixed IP address.

  • Connect the Lab Kit to your laptop or personal computer via the Atheros Ethernet port, as seen in the image showing the Lab Kit's rear side.
  • Go to your computer's Network Configuration and manually set up your network to the 10.0.3.2 fixed IP address.
  • Open your browser and go to: http://10.0.3.1:2080/nib/main.php to access the YateBTS WebGUI.

4. Through a SSH port connection

  • Open a console if you are a Linux user or download the Putty free software and use it, if you are a Windows user.
  • Type in the following command
ssh yatebts@network-ip-assigned-ip -p 54321
  • You will use the 54321 SSH port to access the YateBTS console.

You will be asked for credentials before entering the WebGUI interface. You must insert the information in lowercase.

username: yatebts
password: 'the serial number on the front of your Lab Kit'

Note: To connect to the internet, click the icon below, in your task bar.

Connect to the internet icon

C. Configuring your Lab Kit

Important! If you are operating your Lab Kit in the Americas, skip the next step, as your machine is already set up to function in these areas.

1. When you first enter the Local Management Interface (LMI), you are first required to select the appropriate working mode. Click the Modify button to choose GSM nib.

Modify working mode

2. Select the GSM nib working mode and click the Save button.

Modify working mode

3. Click the BTS Configuration tab. In the GSM section enter the GSM radio interface tab and select the GSM operating band in the Radio.Band field, depending on the region where you operate the Lab Kit. If you are in Europe, Middle East, Asia, Africa or Australia, change the operating band to 850 MHz (the typical operating band for America), to avoid local interference. (For more information go back to step A.2)

4. Insert an ARFCN value corresponding to the operating band you have selected, in the C0 field.

YateBTS configuration screen


D. Making your first call

1. Turn on the phones. They should now register to the 00150 test network if all the steps above have been correctly performed. If the network hasn't been selected automatically, select the 00150 network manually.

At this point you should receive the following automatic SMS: "Your allocated phone no. is ..... Thank you for installing YateBTS. Call David at david(32843).", to find out the phone number allocated to the SIM card and to confirm that the phone has connected to the network.

2. Dial 302 from the phone marked with the number 301 or viceversa to test the network connection.

Alternatively,

3. Call the number 32843. When you call the number, a "Welcome" IVR function will play a prompt and offer three options:

  • press 1 to start EchoTest;
  • press 2 to be sent to conference;
  • press 3 to make an outbound call to David.

Bonus

You can have SMS conversations with the Eliza chat robot by sending text messages to the number 35492.

You have now successfully configured your Lab Kit.

For more information please check the YateBTS Wiki at http://wiki.yatebts.com with an emphasis on the Network in a Box and Lab Kit section at: http://wiki.yatebts.com/index.php/Network_in_a_Box.

Resources

  • Download the Lab Kit Quick Start Guide here to learn how to assemble, access and configure your Lab Kit.

File:YateBTSLabKit QuickGuide.pdf

  • Download the Alcatel One Touch 358 for Lab Kit Quick Start Guide to learn how to connect to the test network.

File:LabKitPhone quickguide.pdf

Additional documentation

Add a subscriber from the Lab Kit

When adding a new subscriber you usually do it in 2 steps. You first write the SIM card, if you don't have it already written and then you finish configuring subscriber and you activate it. If you are using a SIM that is already written, you can skip the first step.

Write SIM

1. Insert an empty SIM card, with the metal contact facing up, in the Smart Card Reader and connect it to the Lab Kit in one of USB ports.

To write the SIM card from the NIB interface click the "Write SIM" button:

Manage-sims.png

Make sure that both boxes are ticked and click the "Save" button.

Manage sims form.png

Activate subscriber

2. To activate the subscriber you have just added, click the "List Subscribers" tab.

Select the IMSI associated to the newly added SIM card and click the "Edit" button.

List subscribers.png

Tick the "Active" field. Click the "Save" button if you don't want to choose a preferred phone number. Your SIM will be generated a random phone number which you will receive in an SMS.

Optional: You can choose your own phone number by filling in the "MSISDN" and "Short Number" fields, according to your preference.

For example, to choose a 301 short phone number, follow this algorithm:

MSISDN xxx000301 (where 'xxx' is the Country Code Number and '301' is the preferred phone number)
Short Number 301


Edit subscriber.png