YateBTS Lab Kit Quick Start Guide

From YateBTS
Revision as of 17:42, 21 May 2018 by Dburgess (Talk | contribs) (Assembling your LabKit)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Congratulations for purchasing YateBTS LabKit! Please follow the steps below to get started.

What you get

1 LabKit

1 LabKit 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

10 SIM cards (configured for Hosted Core for LTE and GSM, and for GSM NiPC)

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 10 SIM cards you receive are already associated to your Hosted Core account. You will receive the Hosted Core credentials on the e-mail you used to place the order.

Assembling your LabKit

Rear view of the LabKit

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 900 Filter if you are inside the Americas and the 850 Filter if you are in the rest of the world.

This is backwards from what mobile operators do. We advise this to prevent interference between other commercial bands and your LabKit's.

This also prevents interference between what the LabKit transmits and what it receives.

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 Oceania. 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 securely. Always angle the antennas at a 90° orientation.

3. Connect the LabKit 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

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

Accessing your LabKit


Accessing the operating system

1. Connect the LabKit 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. You will be asked for a password as soon as you have powered on the LabKit. The password is the serial number found on the front of your LabKit.

Serial number on the front of the LabKit

Note: Icons/Shortcuts for Local Management Interface (LMI), the YateBTS/LabKit online documentation, the Yate forum and the LabKit terminal console are located on Desktop.

You can also find your LabKit's serial number by opening the LabKit terminal console on the first line: [yatebts@ybts-'serial number'~]$.

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

Connect to the internet icon

Once you have connected the LabKit to your local network/Internet, you will be able to find our your assigned IP address by typing in the LabKit terminal console:


You will need this information if you want to access the LabKit remotely.

Accessing the Local Management Interface (LMI)

1. Click the LMI icon on the desktop.

Configuration icon logo

2. This allows you to access the LMI, via HTTP, from the browser.

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

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


Accessing the operating system

Through a SSH port connection

1. Open a console if you are a Linux user or download the Putty free software and use it, if you are a Windows user.

2. Type in the following command

ssh yatebts@network-assigned-ip -p 54321

You will use yatebts as username and 54321 as SSH port to access the LabKit terminal console.

3.You will be asked for password ('the serial number on the front of your LabKit') .

Accessing the Local Management Interface (LMI)

Note: If you want access your LabKit LMI from another computer in your network, use this URL: http://network-assigned-ip:2080/lmi, with 2080 as an HTTP port for newer YateBTS versions.

You will be prompted to enter valid credentials of a system account, as seen below.

Credentials to enter the LMI

Use the following credentials:

username: yatebts
password: 'the serial number on the front of your LabKit'
DHCP through the Intel Ethernet port

1. Connect the LabKit to your router or switch with an Ethernet cable, in the Intel Ethernet port, as seen in the image showing LabKit's rear side.

2. 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.

3. Open your computer's browser and go to: http://network-assigned-ip:2080/lmi/main.php to access the LMI.

DHCP through the Intel Wi-Fi antenna

1. Connect the Wi-Fi antenna to your LabKit.

2. 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.

3. Click on you SSID and select the Configure option to find out your assigned IP address.

4. Open your computer's browser and go to: http://network-assigned-ip:2080/lmi/main.php to access the LMI.

Through a fixed IP address

1. Connect the LabKit to your laptop or personal computer via the Atheros Ethernet port, as seen in the image showing the LabKit's rear side.

2. Go to your computer's Network Configuration and manually set up your network to the fixed IP address.

3. Open your browser and go to: to access the LMI.

Configuring your LabKit

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

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

Modify working mode

2. Select the GSM NiPC 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 LabKit.

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. Select an ARFCN value corresponding to the operating band you have selected, in the Radio.C0 field.

YateBTS configuration screen

Making your first call

1. Turn on the phones. They should now register to the 00101 test network if all the steps above have been correctly performed. If the network hasn't been selected automatically, select the 00101 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. To test your GSM network, register the two phones to the network and then dial each other using the allocated phone numbers received by SMS.


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.


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


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

File:YateBTSLabKit QuickGuide.pdf

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

File:LabKitPhone quickguide.pdf

Additional documentation

Add a subscriber from the LabKit

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 LabKit in one of USB ports.

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


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

File: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.

File: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

File:edit subscriber.png