LabKit Quick Start Guide

From YateBTS
Jump to: navigation, search


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

The LabKit provides the full functionality of either an LTE or a GSM network on your desktop. It is intended for mobile network operator labs, IoT and M2M application development, mobile phone vendors, and researchers.

The LabKit allows the easy and stable development of experiments and test procedures with YateENB and YateBTS.

It can be used stand alone in GSM NiPC or with the MiniCore, the hosted YateUCN core network (Hosted Core) or with your own YateUCN core network server (GSM roaming mode, GSM dataroam mode and LTE enb mode).


What you get

  • 1 LabKit
  • 1 LabKit power adapter
  • 2 antennas
  • 2 filters, one for use in the Americas (in red) and one for the rest of the world (in black)
  • 1 LTE smartphone and its charger
  • 1 GSM phone and its charger
  • 10 pre-written SIM cards (two of them are already inserted in each of the two phones)
  • 1 Wi-Fi antenna

Important! Your 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.

You will receive the Hosted Core credentials on the e-mail you used to make 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.

Filters

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. 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 (ITU Region 2).

Filter Color Use
LTE band 8, EGSM 900 Red In the Americas (ITU Region 2)
LTE band 5, GSM 850 Black In the rest of the world. (ITU Regions 1 and 3)

By the Americas we are referring to the following regions: North America, South and Central America. The typical bands for these regions are the LTE band 5 and the GSM 850.

By the rest of the world we are referring to the following regions: Europe, Middle East, Asia, Africa and Oceania. The typical bands for these regions are the LTE band 8 and the EGSM 900.

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.


4. (Optional) Connect the USB WiFi adapter.


Accessing your LabKit

The operating system of the LabKit is Mageia Linux. The following guide assumes you are familiar with simple console administration tasks.

Locally

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: This grants you access to the Local Management Interface (LMI), the YateBTS and LabKit online documentation, the Yate forum and the LabKit terminal console though the icons located on the 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: ifconfig 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, on two different ports.

Remotely

Accessing the operating system

Through a SSH port connection

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

You will use the 54321 SSH port to access the LabKit terminal console.

2. From Linux type in the following command: ssh yatebts@network-assigned-ip -p 54321

As Windows user, connect with putty.exe to network-assigned-ip through SSH protocol on port 54321.

You will be asked for credentials, and you must insert the information in lower case.

username: yatebts
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 Gigabyte Ethernet port 2

1. Connect the LabKit to your Wi-Fi router or switch with an Ethernet cable, in the Gigabyte Eth port 2, as seen in the image showing LabKit's rear side.

2. To find your IP address assigned through DHCP, 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 USB WiFi adapter

1. Connect the USB WiFi adapter 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 your 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 Gigabyte Eth port 1, 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 10.0.3.2 fixed IP address.

3. Open your browser and go to: http://10.0.3.1:2080/lmi/main.php to access the LMI.


LabKit GSM configuration

For information about how to configure your LabKit for GSM use, please refer to the GSM LabKit Configuration page.

Making your first call

Please select operation mode of your LabKit from Working Mode tab of your LMI interface, it comes without an activated working mode.

Configure your LabKit using GSM LabKit Configuration, once you configured it for GSM use, get ready to make your first call.

1. Turn on the phones. They should now register to the 00101 (or Test on other UE's) test network if all the steps above have been correctly performed.

If the network hasn't been selected automatically, select the 00101/Test 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.

Note: In case the phone was tested in-house with the LabKit, you won't get the automatic SMS anymore.

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. You can also use GPRS with Local breakout in YateBTS and start your GSM data session through your LabKit Internet connection.

Alternatively,

4. Call the number 32843 (DAVID). When you call the number, a "Welcome" IVR function will play a prompt and offer two options:

  • press 1 to start an echo test
  • press 2 to be sent to conference room.

5. Bonus You can have SMS conversations with Eliza, our chat robot by sending text messages to the number 35492 (ELIZA).

SMS Examples: "hello" "how are you" "dream".

LabKit GSM roaming / GSM dataroam configuration

Your LabKit is also pre-configured to provide access to the Hosted Core, your credentials were sent on the e-mail you used to make the order.

For more information, log into HostedCore web interface page and see the "How to" section from the top menu.

In GSM roaming mode, voice will go through HostedCore and data is used with local breakout: this allows mobile stations to receive data services using their LabKit internet connection.

Making a call through Hosted Core

In order to use Hosted Core's roaming service, select Working Mode as GSM roaming and go to

BTS Configuration -> Core -> Roaming and set Reg SIP to 100.127.0.1:5058 and My SIP from drop down to your associated IP address starting with 100.127.X.X

Please restart the phones and check assigned MSISDNs in HostedCore web interface page to make a test call. (The 10 SIM cards you receive are already associated to your Hosted Core account)

You can call a public subscriber, Public Subscribers tab will list online public subscribers or you can call one of your own subscribers.

Starting your data session through Hosted Core

Set up LabKit on GSM dataroam working mode and get ready to start your data session through Hosted Core's Internet connection.

Keep same BTS Configuration -> Core -> Roaming configurations as described earlier in this document,  regarding connections.
From BTS Configuration -> Core -> GPRS Roaming set NNSF bit to 8 and Explicitly map network nodes to IP address to 1=100.127.0.1

Activate Airplane mode, deactivate Airplane mode (or reboot the phones)/ and after phones register to the 00101 (Test) Test Network, be free to navigate on the web.


LabKit LTE configuration

For information about how to configure your LabKit for LTE use, please refer to the LTE LabKit Configuration page.

Starting your first data session

Once you configured your LabKit for LTE use, get ready to start your first LTE data session.

Turn on the smartphone. It should register to the 00101 (or Test Network 4G) if all the steps from LTE LabKit Configuration have been correctly performed.

If the network registration did not automatically function, select the 00101 (or Test Network 4G) network manually.

At this point, you should be able to browse through your favourite websites.