SatSite LMI Configuration for GSM

From YateBTS
Jump to: navigation, search

The YateSDR local management interface allows control and management of one Lab Kit or SatSite unit, locally.

YateSDR can also be used by engineers if a SatSite unit they had previously configured via the Yate MMI needs local maintenance after it has been installed in the field.

To begin, you must first select the working mode. Depending on the configuration mode, select:

  • GSM nipc (for GSM Network-in-a-PC mode)
  • GSM roaming (for a GSM BTS connected to YateUCN/Hosted Core for voice and SMS services)
  • GSM dataroam (for a GSM BTS connected to YateUCN/Hosted Core for voice, SMS and data services mode)
  • LTE enb (for an LTE eNodeB connected to an MME or a Hosted Core)


GSM NiPC configuration

To enabled the GSM nipc mode click on the Modify button, select the GSM nipc mode and Save.

working mode GSM nipc enable.png

BTS Configuration - Radio interface (GSM)

Click on the BTS Configuration tab. You will automatically be directed to the Radio - GSM section, which allows setting the parameter values for the GSM radio interface.

These parameters are the same as in the ybts.conf file.

After modifying these parameters, Yate iautomatically restarts.

BTS configuration basic.png

Minimum configuration to start your YateBTS

As an absolute minimum you must configure the radio frequency and the output power as seen below:

all GSM working modes Radio GSM settings.png

1. Select an appropriate Radio.Band, from 850 (GSM850), 900 (PGSM900), 1800 (DCS1800) to 1900 (PCS1900).

2. Select the Radio.C0 ARFCN depending on the Radio.Band you previously chose. To see the available values click on the ? sign.

3. Select the Radio.PowerManager.MaxAttenDB=40. The recommended value is 40.

4. Select the Radio.PowerManager.MinAttenDB. The recommended value is 40.

Important note: Make sure you have the right to use the radio frequency you selected. Please do not break your local law.

Example for 1800 DCS

Run a spectrum survey with a spectrum analyzer to find a gap in the spectrum for downlink 1805-1880 and uplink 1710-1785. You must find pairs that are open in both downlink and uplink which are 95MHz apart. It is better to operate below ARFCN 786(downlink 1860 MHz).

Example with a mobile spectrum analyzer

Freq Span

Start-Stop

Set Start - lower limit

Set Stop - upper limit

Peak Hold - use it for a couple of minutes to find gaps (Downlink freq)

A minimum configuration of this type will use the default identity MCC=001 MNC=01 LAC=1000 (0x3e8) CI=10 (0x000a). Most phones will identify it as Test or Test PLMN.

Below is an example for channel 50 of GSM900 (900MHz uplink, 945MHz downlink):

[[image with the following values: radioband->900, radio.c0->50]]

BTS Configuration - Radio interface (GPRS)

1. Click on the GPRS section in the same Radio tab to configure the parameters for GPRS operation.

2. Select Enable to advertise GPRS in the C0T0 beacon and start the service on demand.

To see how many channels are reserved, click on the Advanced link and go to the GPRS Advanced section.

3. Select the RAC (GPRS Routing Area Code) as advertised in the C0T0 beacon.

The allowed interval is between 0..255. The default is 0.

4. Select the RA COLOUR (GPRS Routing Area Colour) as advertised in the C0T0 beacon.

The allowed interval is between 0..7. The default is 0.

The GSM Advanced, GPRS Advanced and Control sections should normally not be changed from the already set default values.

Subscriber Management

The Subscribers tab allows you to

  • add and remove subscribers
  • manage security features of each individual subscriber
  • assign telephone numbers

Adding and listing subscribers

Click on the List Subscribers section. If you already have one or more subscribers they will be listed here.

If you want to add a subscriber and configure each IMSI by hand, click on the Add subscriber option at the bottom of the screen.

If you want to insert a regular expression, click on the Accept by REGEXP option.

Listsubscribers step1.png

Accept by REGEXP

Click on Accept by REGEXP to add regular expressions.

They must be written without “/” at the beginning and end of the REGEXP.

Note: In the initial version the “/.../” were required.

If you are unsure about how to set them check the example by pressing the question mark symbol: ?

The Modify button will allow the editing of the existing REGEX and the button Set subscribers will display the form for adding Subscribers parameters.

This is the same form as if the Add subscriber link was chosen instead of Accept by REGEXP, as seen in the example below.

Regexp-example.png

After inserting the regular expression and pressing Save button you will see the information below:

[[File:Regexp-example-save.png]

Set subscribers individually

Use the Add subscriber option to insert subscribers individually. Click the question mark ? for each field to find out their descriptions.

The fields marked with the asterisk “*” are required.

Add subscriber.png

After clicking on the Save button, the subscriber will be saved in subscribers.conf from Yate's configuration directory and the subscriber will appear in the Subscribers List as seen below.

subscribers.png

Note: After Adding/Editing/Moving from REGEXP to individual subscribers or Moving to REGEXP from individual subscribers, Yate will restart.

Country Code and SMSC

This section allows you to set or change the country code and the SMSC for your existing subscribers.

country-code-gsm-nipc.png

Online Subscribers

This section allow you too see your online subscribers. (note: or active?)

Online Subscribers.png

Outgoing

This section allows you to specify a SIP or IAX connection for routing calls out of the local network to the rest of the world.

Outgoing Call Route Management

This page allows you to specify a SIP or IAX connection for routing calls out of the local network to the rest of the world.

First, you need to select the protocol for the outbound connection from the drop-down list. This will generate the parameters that need to be configured. There are 2 types of parameters:

  • basic parameters (that are displayed when the protocol is chosen)

and

  • advanced parameters (that are hidden and will be displayed if “Advanced” is clicked).

The “Save” button will save the configuration in accfile.conf. A typical example of setting up a SIP outbound connection will start with an outgoing form without any protocol selected.

Here is the SIP configuration page. After selecting the SIP protocol, the Basic parameters will be displayed:

Outgoingparameters.png

Finally, after adding the connection data, click the "Save" button.

Outgoingsave.png

The "Modify" button permits editing the parameters.

The parameters controlled here are the same ones described in Outbound_connection.

The “Switch to IAX” button deletes the old configuration and permits the new outbound connection to be set.

Switch iax.png

If you click on “Yes”, the SIP outbound connection is deleted from accfile.conf file and the form for adding the IAX outbound connection is displayed:

Addiaxoutbound.png

Call Logs

This section allows you to see all the call logs made through the Lab Kit you are accessing.

It provides information about:

  • the time
  • the billed ....?
  • the channel type
  • the address
  • the caller
  • the called number
  • the billed time
  • the status
  • the reason

and more.

call-logs.png

GSM roaming

Once you selected GSM roaming in the Working Mode tab, you must to the BTS Configuration tab and select Core - Roaming section.

working mode GSM roaming enable.png


The Roaming section controls the parameters used by roaming.js when connecting YateBTS to a core network.

1. Select and Expire time for registrations.

2. Set a Reg sip string ip:port where SIP requests are sent.

3. Set a Nodes sip ip:port of each YateUCN server node, which is computed based on the TMSI received from the handset.

GSM dataroam

Once you selected GSM dataroam in the Working Mode tab, you must to the BTS Configuration tab and select Core - GPRS Roaming section.

This section controls the parameters of the dataroam.js file when connecting YateBTS to a core data network.

1. Activate the local IP address termination in the Local breakout field. It defaults to no.

2. Set the NNSF bits, or the number of bits to use for SGSN. It defaults to 0.

3. Set the NNSF DNS for SGSN node mapping. It defaults to no if the nnsf_bits is zero or an explicit node mapping already exists.

4. Set the Explicitly map network nodes to IP addresses.

5. Finally, Submit the values you have just set.

Click on the Handover section to set the parameters used by roaming.js.

1. Tick the box to globally enable handover functions.

2. Add the neighbor SIP addresses, separated by commas, in the Neighbors field.

3. Write the text to place in the Reason SIP header. The default is: GSM;text="Handover".