gmpc8 gsm cell data file & cli description_b1

GSM Cell Data File and CLI DescriptionGMPC

Copyright

© Ericsson AB 2006 - All Rights Reserved

Disclaimer

No part of this document may be reproduced in any form without the writtenpermission of the copyright owner.

The contents of this document are subject to revision without notice due tocontinued progress in methodology, design and manufacturing. Ericsson shallhave no liability for any error or damage of any kind resulting from the useof this document.

3/198 18-HSD 101 94 Uen B1 2006-03-23

GSM Cell Data File and CLI Description

Contents

1 Introduction 1

1.1 Typographical Conventions 1

2 Cell Data File Format 3

2.1 Cell Data 3

2.2 Coordinate System 11

2.3 Cell Accuracy 11

3 CLI 13

3.1 Syntax and Commands 13

Glossary 15

Reference List 17

3/198 18-HSD 101 94 Uen B1 2006-03-23


3/198 18-HSD 101 94 Uen B1 2006-03-23


1 Introduction

The Gateway Mobile Positioning Centre (GMPC) uses the CellStoragedatabase when calculating the positions of Mobile Stations (MSs).

The Cellular Network Administration Interface (CNAI) is a file interface forexchange of cellular data between an external system and the Cellular NetworkAdministration (CNA).

The data is exchanged by means of data files. Two interfaces are available tothe CellStorage database, the GMPC Tool, see User Guide GMPC Tool, and aseparate program, the cgicli, see Section 3 on page 13.

1.1 Typographical Conventions

This section describes the typographical conventions used in this document.

Table 1 Typographical Conventions

Convention Description Example

User Input A command to enter in aCommand Line Interface(CLI) exactly as written.

cd HOME

Command Variables Values the user mustspecify.

home_directory

GUI Objects Menus, fields, buttons,and so on.

Choose Exit in the Filemenu.

Key Combinations Combinations of keysto press for a specificfunction.

Press Ctrl+x to delete theselected value.(1)

System Elements Command and parameternames, program names,path names, UniformResource Locators(URLs), and directorynames.

The files are located inc:/HOME/bin.

Output Information Text the system displays. System awaitinginput

Code Examples Code examples. grep ’:title. ’$i | \awk -f.’

(1) The plus sign (+) indicates that the keys must be pressed simultaneously.

13/198 18-HSD 101 94 Uen B1 2006-03-23


Table 2 System Users

User Prompt

root #

mpc >

Boot-prompt ok

Note: When a command is too long to fit into one row in the document, it isshown with a backslash “\” that the command continues on the nextrow. Do not leave out or add spaces at the command line comparedto the document. Do not press space before or after the backslash asthe example below:

# more /var/opt/fds/logs\

/fdspm.logyyyy-mm-dd.log

2 3/198 18-HSD 101 94 Uen B1 2006-03-23


2 Cell Data File Format

This chapter describes the cell data file and its content.

2.1 Cell Data

The cell data file must have the format which is specified by Ericsson Operationand Support System (OSS) for International Telecommunication Union (ITU),American National Standards Institute (ANSI), and China. The OSS defines aninterface to the CNA database, called CNAI. CNA supports the following foursets of parameters: GSM800, GSM900, GSM1800, and GSM1900. Whennothing else is shown, the parameter value is valid for all systems.

Note: A parameter which has no value defined, is represented by the value“NULL” in the cell data file. An unrecognized column is ignored duringimport. All parameters must contain values. For parameters with value“NULL”, a default value will be used. The default value is specified inthe description of the parameter.

2.1.1 File Format Description

The CNAI cell data file is an ASCII-based text file. The header line describesthe contents of the data section. The object types will be in upper case and theparameter names will be in lower case. The order in which the object typesappear in the cell data file header, defines the order of corresponding objectnames and parameter values in the data section.

The second line separates the header line from the data section. The line has tostart with at least three hyphens (“— — —”) after which a comment can follow.

The data section begins with the third line. Each data line specifies thenames of the objects and their respective parameter values, according to thespecification in the header line.

See Example 1 on page 4 and Example 2 on page 4 for examples of a celldata file.

33/198 18-HSD 101 94 Uen B1 2006-03-23


BSC SITE latitude longitude CELL accmin antenna_type------------------------------------------------------------------BSC64 STP64S640001 N56-09-51 E15-40-25 S640001 100 OMNIBSC64 STP64S640002 N56-09-53 E15-40-23 S640002 100 OMNI

bcc bcchno bspwr c_sys_type cell_dir ci env_char lac latitude--------------------------------------------------------------------NULL NULL 60 GSM800 180 1 NULL 1 NULLNULL NULL 60 GSM800 180 2 NULL 1 NULL

longitude max_altitude min_altitude max_cell_radius mcc mnc talim-------------------------------------------------------------------NULL NULL NULL 40000 1 1 4NULL NULL NULL 20000 1 1 4

Example 1 Cell Data File – Mandatory Parameters

BSC SITE altitude latitude longitude CELL accmin---------------------------------------------------------------BSC64 STP64S640010 NULL N56-09-9 E15-40-23 S640010 100BSC64 STP64S640007 NULL N56-09-3 E15-40-25 S640007 100

antenna_type bcc bcchno bspwr c_sys_type cell_dir ci-------------------------------------------------------OMNI NULL NULL 60 GSM800 180 147OMNI NULL NULL 60 GSM800 180 7147

env_char lac latitude longitude max_altitude max_cell_radius-------------------------------------------------------------NULL 95 NULL NULL NULL 40000NULL 95 NULL NULL NULL 20000

mcc min_altitude mnc ncc sector_angle talim-----------------------------------------------234 NULL 15 NULL 180 4234 NULL 15 NULL 180 4

Example 2 Cell Data File – With Additional Parameters

2.1.2 Syntax for the Header Line

The syntax for allowed combinations of objects in the header line is as follows:

BSC (SITE <SITE parameter-list> ) (CELL <CELL parameter-list>)

All objects can optionally be followed by a list of parameter names, chosenamong those allowed for the object type.

The parameters in the list can be given in any order.

4 3/198 18-HSD 101 94 Uen B1 2006-03-23


The following notation is used to describe the syntax in the cell data file:

• ( ) Grouping

• [ ] Optional

• { } Repeat

• | Or

• <string> Replace with the output of the string.

2.1.3 Data Parameters

Depending on the license status for the GMPC 8.0, different parameters aremandatory and additional. This is shown (in the following tables) in the columnsMan (for mandatory) and Add (for additional). The following abbreviationsare used:

• A = Assisted Global Positioning System (A-GPS)

• C = Cell Global Identity/Timing Advanced (CGI/TA)

Both mandatory and additional parameter columns must be present in the celldata file. The value for additional parameters can be set to NULL independentlyof the value range.

The Mobile Network Code (MNC), Mobile Country Code (MCC), LocationArea Code (LAC) and Cell Identity (CI) together forms a CGI-number. TheCGI-number and the combination SITE - CELL have to be unique in the celldata file. During import of a cell data file the CGI-number is the primary key, ifthe CGI-number already exists in the GMPC, the existing cell data record isupdated when necessary. If the same CGI-number does not exist in the celldata file, a check is done if the combination SITE - CELL exists. If the samecombination SITE - CELL is found, the existing cell data record is removed andthe new cell data record is added and in case there are fields in the old cell datarecord that is missing in the new cell data record, these fields are copied to thenew cell data record. If there is no duplicate of CGI-number or SITE - CELLcombination the new cell data is added.

See Example 1 on page 4 and Example 2 on page 4 for examples of a celldata file.

2.1.3.1 BSC

The parameters in Table 3 on page 6 is for the Base Station Controller (BSC).

53/198 18-HSD 101 94 Uen B1 2006-03-23


Table 3 BSC Data Parameters

Parameter Format ValueRange

Description Man Add

BSC Alphanumeric(1–7characters)

A - Z, 0 – 9,and \%#+[ ]Illegal values: ALL,NULL

Name of the BSC. Stringvalue.

AC

2.1.3.2 SITE

See Table 4 on page 6 for SITE data parameters.

Table 4 SITE Data Parameters

Parameter

Format Value Range Description Man Add

SITE Alphanumeric(1–15characters)

A – Z, 0 – 9,and \%#+[ ]Illegal values: ALL, NULL

Name of the SITE. Stringvalue.

AC

altitude Numeric

– 500 – 8000Illegal value:NULL

Altitude above the WGS84ellipsoid in meters, seethe TS 23.032. Digitalcellular telecommunicationssystem (Phase 2+); UniversalMobile TelecommunicationsSystem (UMTS); UniversalGeographical AreaDescription (GAD) (Release5).

A

6 3/198 18-HSD 101 94 Uen B1 2006-03-23


Parameter


latitude Alphanumeric

FromS90–00–00toN90–00–00Illegal value:NULL

String with direction indicatorand degrees, minutes andseconds (lat. three degreesis given as N3–00–00,N03–00–00). Degreesmust be between 0 and90. The seconds can begiven with up to six decimals(N03–00–03.166667).This value is used if no valueat CELL level exists. Refer toTable 5 on page 7.

AC

longitude Alphanumeric

FromW180–00–00toE180–00–00Illegal value:NULL

String with direction indicatorand degrees, minutes andseconds (long. three degreesis given as E3–00–00,E03–00–00 or E003–00–00).Degrees must be between 0and 180. The seconds can begiven with up to six decimals(E03–00–03.166667).This value is used if no valueat CELL level exists. Refer toTable 5 on page 7.

AC

2.1.3.3 CELL

See Table 5 on page 7 for CELL data parameters.

Table 5 CELL Data Parameters

Parameter


CELL Alphanumeric(1–7characters)

A – Z, 0 – 9 and\%#+[]Illegal values:ALL, NULL

Name of the CELL. Stringvalue.

AC

accmin

NumericInteger

47 – 110Illegal value:NULL

Minimum received signallevel at the MS for permissionto access the system.Specified in dBm.

AC

73/198 18-HSD 101 94 Uen B1 2006-03-23


Parameter


antenna_type

Alphanumeric

OMNI, SECTORIllegal value:NULL

Type of antenna:OMNI: The cell radio beamis omni-directional.SECTOR: The cell beam is asector defined in the directionfield.

AC

bcc NumericInteger

0 – 7 if nocombinedBCCH is used.Otherwise 0 – 2

Base Station Color Code(BCC), identifying the BaseStation (BS). It is used todistinguish cells transmittingon the same frequency.For example, recognizingcochannel interference.

A(1)

bcchno

NumericInteger

128 – 251 forGSM8000 – 124,975 – 1023 forGSM900512 – 885 forGSM1800512 – 810 forGSM1900Illegal value:NULL

Absolute Radio Frequency(RF) channel number forBroadcast Control Channel(BCCH).

A(1)

bspwr NumericInteger


Base Station Nominal Power(BSPWR). Specified in dBm.

AC

cell_dir

NumericInteger


Cell direction. The directionangle of a sector cell. Thisparameter is inactive if thecell is omni-directional.For antenna_type OMNI, use"0".

AC

c_sys_type

Alphanumeric

Allowed values:GSM800,GSM900,GSM1800, andGSM1900.

System type, that is readonly. At Cell creationby import, this value hasto be the same as theBSC’s g_sys_type, unlessg_sys_type is “MIXED”.

AC

ci NumericInteger


Cell Identity (CI). Identifyingthe cell within a LocationArea (LA).

AC

8 3/198 18-HSD 101 94 Uen B1 2006-03-23


Parameter


env_char

NumericInteger

0 or 1Illegal value:NULL

Environment characterization.0 = Possible heavy multi-pathand No Line Of Sight (NLOS)conditions.1 = No or light multi-path andLine Of Sight (LOS).Default value: 0.

A

height NumericInteger


The antenna height abovesite ground level in meters.

A

lac NumericInteger


Location Area Code (LAC).Identifying the location areawithin Public Land MobileNetwork (PLMN).

AC

max_altitude

NumericInteger

-500 – 8500NULL

Maximum altitude.The highest location in thecell with radio coverage.The value is given in metersabove sea level.Default value: Altitude (Site)+ height (Cell).

A

mcc NumericInteger


Mobile Country Code (MCC).Identifying the country inwhich the called PLMN islocated.

AC

min_altitude

NumericInteger

-500 – 8000Illegal value:NULL

Minimum altitude.The lowest location in thecell with radio coverage.The value is given in metersabove sea level.

A

mnc NumericInteger

00 – 99 or000–999Illegal value:NULL

Mobile Network Code (MNC).Identifying the PLMN calledwithin a given country.GSM900, GSM1800: 2–3digits.GSM800, GSM1900: 3digits.

AC

93/198 18-HSD 101 94 Uen B1 2006-03-23


Parameter


ncc NumericInteger


National Color Code(NCC), see the TS23.003. 3rd GenerationPartnership Project;Technical SpecificationGroup Core Network;Numbering, addressing andidentification (Release 6)

A(1)

talim NumericInteger

0 – 630 – 219Extended rangecellIllegal value:NULL

Timing Advance (TA) Limit.Determines the maximumTA that the MS will use in thecell. The parameter value isgiven in number of bit periods(bp). Extended range cell isapplicable for BTSs of typeRBS200 (model G01).

AC

latitude

Alphanumeric

FromS90–00–00 toN90–00–00NULL

String with direction indicatorand degrees, minutes andseconds (lat. three degreesis given as N3-00-00,N03–00–00). Degreesmust be between 0 and90. The seconds can begiven with up to six decimals(N03-00-03.166667).This value is used insteadof the value at SITE level.Refer to Table 4 on page 6.

AC

longitude

Alphanumeric

FromW180–00–00to E180–00–00NULL

String with direction indicatorand degrees, minutes andseconds (long. threedegrees is given asE3–00–00, E03–00–00or E003–00–00). Degreesmust be between 0 and180. The seconds can begiven with up to six decimals(E03–00–03.166667).This value is used insteadof the value at SITE level.Refer to Table 4 on page 6.

AC

10 3/198 18-HSD 101 94 Uen B1 2006-03-23


Parameter


sector_angle

NumericInteger

0 – 359NULL

Sector angle states theopening angle for a cell indegrees (aperture-angle).Numeric value. If the value0 or NULL is given fora SECTOR, the value isreplaced with the defaultvalue. The default valuefor a SECTOR is 120. Thisparameter can be added toexisting cells.This parameter is inactive ifthe cell is omni directional.

AC

max_cell_radius

NumericInteger

0 – 120000NULL

Maximum radius for cellsignal coverage in meters.A general algorithm is usedfor an estimation of the max.cell-radius if not specified.

AC

override_ta

Alphanumeric

NOYESdefault value:NO

Override TA.NO: The TA value is used inCGI/TA calculation.YES: The TA value is notused in CGI/TA calculation,if the corresponding value inthe TA radius matrix is higherthan max cell radius.

C

(1) Mandatory for A-GPS when Fine Timing Assistance license is installed.

2.2 Coordinate System

The Cell data import supports the format LL/WGS84 for given coordinates.

2.3 Cell Accuracy

To improve cell accuracy the max_cell_radius has to be specified or theparameter talim has to be set to a relevant value. If the max_cell_radius isnot specified, a general algorithm is used for an estimation of the maximumcell-radius. This is based on the assumption that the antenna is placed insuburban area (antenna height 30 m and frequency 900 MHz), disregarding thetype of cell.

113/198 18-HSD 101 94 Uen B1 2006-03-23


12 3/198 18-HSD 101 94 Uen B1 2006-03-23


3 CLI

A separate binary file named cgicli, with a simple Command Line Interface(CLI) is provided. A CellStorage user that will be created during installation isused for this program.

To use the CLI, the user must log on as mpc user.

3.1 Syntax and Commands

This section describes the commands and their syntax.

3.1.1 Syntax

The name of the program is cgicli and the syntax is as follows:

cgicli <command>

3.1.2 Commands

The following commands are available:

• Import

• Export

• Delete

• Get

For Import see Example 3 on page 13, for Export see Example 4 on page 13,for Delete see Example 5 on page 14 and for Get see Example 6 on page 14.

Example 3 Import

cgicli Import <filename>

The import command is used to import a new cell data text file into the database.If a filename is not specified, all files in the default directory is imported.

Note: The GMPC-OM component is configured to delete or keep the inputfile after the import is executed. If the files are kept, they are storedin either and “old” or “error” directory depending on if the import wassuccessful or not.

Example 4 Export

133/198 18-HSD 101 94 Uen B1 2006-03-23


cgicli Export <filename>

The export command is used to export the database to a new CellData text file.If a path is not specified, the file will be located in /var/opt/fds/logs.

Example 5 Delete

cgicli Delete 46-708-33-255

cgicli Delete PLMN 46-708

cgicli Delete ALL

Delete is used when one, several, or ALL cells need to be deleted from thecell database.

The Cell Global Identity (CGI) number has the following syntax:MCC-MNC-LAC-CI and the PLMN-number has the syntax: MCC-MNC.

Caution!

The command Delete ALL erases the entire cell database content with nowarning. Use with caution.

Example 6 Get

cgicli Get 46-708-33-255

“Get <CGI>” returns an extensible Markup Language (XML) describing a cell.

14 3/198 18-HSD 101 94 Uen B1 2006-03-23

Glossary

Glossary

ANSIAmerican National Standards Institute

ASCIIAmerican Standard Code for InformationInterchange

BCCBase Station Color Code

BCCHBroadcast Control Channel

bpbit period

BSBase Station

BSCBase Station Controller

BSPWRBase Station Nominal Power

CGICell Global Identity

CICell Identity

CLICommand Line Interface

CNACellular Network Administration

CNAICellular Network Administration Interface

dBmDecibel referred to one milliwatt

GADGeographical Area Description

GMPCGateway Mobile Positioning Centre

GSMGlobal System for Mobile communication

ITUInternational Telecommunication Union

LALocation Area

LACLocation Area Code

LLLatitude Longitude

LOSLine Of Sight

MCCMobile Country Code

MNCMobile Network Code

MSMobile Station

NLOSNo Line Of Sight

OMOperations and Maintenance

OSSOperations and Support System

PLMNPublic Land Mobile Network

RFRadio Frequency

153/198 18-HSD 101 94 Uen B1 2006-03-23

Glossary

TATiming Advance

UMTSUniversal Mobile Telecommunications System

URLUniform Resource Locators

WGS84World Geodetic System 1984

XMLExtensible Markup Language

16 3/198 18-HSD 101 94 Uen B1 2006-03-23

Reference List

Reference List

Ericsson Documents

[1] User Guide GMPC Tool, 1/1553–HSD 101 94 Uen

[2] Parameter List GMPC, 1/190 59–HSD 101 94 Uen

Standards

[3] TS 23.032. Digital cellular telecommunications system (Phase 2+);Universal Mobile Telecommunications System (UMTS); UniversalGeographical Area Description (GAD) (Release 5), TS 23.032 V5.0.0.3GPP, 2003-04-07.

[4] TS 23.003. 3rd Generation Partnership Project; Technical SpecificationGroup Core Network; Numbering, addressing and identification (Release6), TS 23.003 V6.0.0 3GPP, 2003-10-10.

173/198 18-HSD 101 94 Uen B1 2006-03-23