Remote eAntenna Extension

Oct 4, 2018

1 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Outline
RAE Settings Window
• Weight Factor Tab
• Get beam data
• Get direction data
• Get weight data
• Management Tab
• Upload file
• Download weight file
• Reset weightfactors/module

2 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Remote eAntenna Extension
• Currently is a storage box for beam forming related data.
• Stores and send weighting factor file and other auxiliary information.
• Can have multiple subunits, and is usually bundled with RETs (shared RCU devices)
• Has device type of = 0x31
• Can only be accessed via RAE settings window (in SEM)

Weighting factor is a set of amplitude and phase settings for one RF port of a beam forming
antenna.

3 © 2017 Nokia
RAE initialization sequence
Todo: Seq diagram
Same as other ALD’s device sequence initialization except it has more additional device
data to be fetched.
1. Executes DeviceDataQueryAction to fetch Altitude, Latitude and Longitude
(tDeviceData_Altitude, tDeviceData_LatitudeAndLongitude)
2. Retrieves information to be stored in ANTENNA_PARAMETERS object.
3. Updates status and data to LIM.

4 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
ANTENNA_PARAMETERS
Todo: Seq diagram
1. Executes FileCountQueryAction
2. Executes GetFileInformationAction
a. File types: weightFactor and antennaPattern
3. Executes GetWeightFactorAction with the following parameters
a. tWeightValue_FormatingCode
b. tWeightValue_FileName
c. tWeightValue_FileVersion
d. tWeightValue_FileInformation
e. tWeightValue_AdvancedParameters
f. tWeightValue_FrequencyBand

5 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
RAE Settings window (Weight factors tab)
1. Gets RAE properties shown in
ANTENNA_PARAMETERS (RAE 1 (Antenna unit1)
details)
2. User selects frequency, then beamwidth values
shows up.
3. User sets beamwidth, then direction values shows
up.
4. User sets direction, then weight factors shows up.
5. User select weight factors, then the values of Port,
Polarity, Amplitude and Phase shows up.

6 © 2017 Nokia
RAE Settings window (Weight factors tab)

When RAE Settings window is opened, BTSSM requests GetRAEProperties to BTS via XOH commands
• Upon receiving the GetRAEProperties command, SysAdapter reads the ANTENNA_PARAMETERS and
sends back the Response.
• With that response, the file Information and supported Frequency band info displayed on RAE Settings
window.
• Remaining all other attributes of RAE displayed in RAE Settings window are executed based on the user
input selection. All these operations are sequential operations.
• To get BeamData ( Horizontal & Vertical BeamWidth) user has to select the FrequencyBand first.
• Once the user selects the Frequency, BTSSM sends GetBeamDataRequest to BTS and SysAdapter creates
GET_BEAM_DATA_IND and populates the horizontal and vertical beamwidth.
• Based on the user selected BeamData & Frequency, BTSSM request BTS to populate Direction Data ( like
Tilt and Azimuth information) using GET_DIRECTION_DATA_IND.
• Based on the user selected FrequencyBand, BeamData, Direction Data BTESM request BTS to populate the
Weight data using GET_WEIGHT_DATA_IND.

7 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Get beam data

8 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
RAE Settings window (Management tab)

9 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Upload file

• Used to upload the weight

factor file from the RAE to
BTSSM.
• UPLOADFILE_IND/ ACK or
NACK, ALD_OPER_RESULT
• UPLOADFILE_REQ/
ALD_OPER_RESULT
• UPLOADFILE_TASK/
ALD_OPER_RESULT
• RAEU_L/
ALD_OPER_RESULT
• UploadFileAction – UploadFile
Message
10 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Download Weight file

• Downloads the weight file from

BTSSM to RAE.
• DOWNLOAD_WEIGHTFILE_IN
D/ACK or NACK,
ALD_OPER_RESULT
• DOWNLOAD_WEIGHTFILE_R
EQ/ALD_OPER_RESULT
• DOWNLOAD_WEIGHTFILE_T
ASK/ALD_OPER_RESULT
• DownloadWeightFileAction –
RAEFileDownloadStart,
RAEFileDownloadFile,
RAEFileDownloadEnd

11 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Reset Weight Factor / Module

• Resets the RAE module or reset to the

factory weight file.
• RESET_IND/ ACK or NACK,
ALD_OPER_RESULT
• WeightFactors – created under RAEU_L
• Reset_Module – created under ALD_L
• RESET_REQ/ALD_OPER_RESULT
• RESET_TASK/ALD_OPER_RESULT

12 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Procedural codes

RAEAPMSGID_RAERESETFACTORYWEIGHTINGFACTORS = RETAPMSGID_TMASETMODE = 0x70,

RAEAPMSGID_RAESETDEVICEDATA = RETAPMSGID_TMASETDEVICEDATA = 0x74,
RAEAPMSGID_RAEGETDEVICEDATA = RETAPMSGID_TMAGETDEVICEDATA = 0x75,
RAEAPMSGID_RAEALARMINDICATION = RETAPMSGID_TMAALARMINDICATION = 0x76,
RAEAPMSGID_RAECLEARACTIVEALARMS = RETAPMSGID_TMACLEARACTIVEALARMS = 0x77,
RAEAPMSGID_RAEGETALARMSTATUS = RETAPMSGID_TMAGETALARMSTATUS = 0x78,
RAEAPMSGID_RAEGETNUMBEROFSUBUNITS = RETAPMSGID_TMAGETNUMBEROFSUBUNITS = 0x79,
RAEAPMSGID_RAEFILEDOWNLOADSTART = 0x43,
RAEAPMSGID_RAEFILEDOWNLOADFILE = 0x44,
RAEAPMSGID_RAEFILEDOWNLOADEND = 0x45,
RAEAPMSGID_RAEGETNUMBEROFFILES = 0x46,
RAEAPMSGID_RAEGETFILEINFORMATION = 0x47,
RAEAPMSGID_RAEUPLOADFILE = 0x48,
RAEAPMSGID_GETWEIGHTINGFACTOR = RETAPMSGID_TMAGETGAIN = 0x73,
RAEAPMSGID_GETSUPPORTEDFUNCTIONS = RETAPMSGID_TMAGETSUPPORTEDFUNCTIONS = 0x7A,
RAEAPMSGID_RAEGETWEIGHTVALUE = RETAPMSGID_TMAGETSUPPORTEDGAINVALUES = 0x7B

13 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>
Copyright and confidentiality

The contents of this document are proprietary and Such Feedback may be used in Nokia products and are made in relation to the accuracy, reliability or
confidential property of Nokia. This document is related specifications or other documentation. contents of this document. NOKIA SHALL NOT
provided subject to confidentiality obligations of the Accordingly, if the user of this document gives Nokia BE RESPONSIBLE IN ANY EVENT FOR ERRORS
applicable agreement(s). Feedback on the contents of this document, Nokia IN THIS DOCUMENT or for any loss of data or
may freely use, disclose, reproduce, license, income or any special, incidental, consequential,
This document is intended for use of Nokia’s distribute and otherwise commercialize the indirect or direct damages howsoever caused, that
customers and collaborators only for the purpose for feedback in any Nokia product, technology, service, might arise from the use of this document or any
which this document is submitted by Nokia. No part specification or other documentation. contents of this document.
of this document may be reproduced or made
available to the public or to any third party in any Nokia operates a policy of ongoing development. This document and the product(s) it describes
form or means without the prior written permission Nokia reserves the right to make changes and are protected by copyright according to the
of Nokia. This document is to be used by properly improvements to any of the products and/or applicable laws.
trained professional personnel. Any use of the services described in this document or withdraw this
contents in this document is limited strictly to the document at any time without prior notice. Nokia is a registered trademark of Nokia
use(s) specifically created in the applicable Corporation. Other product and company names
agreement(s) under which the document is The contents of this document are provided "as is". mentioned herein may be trademarks or trade
submitted. The user of this document may Except as required by applicable law, no warranties names of their respective owners.
voluntarily provide suggestions, comments or other of any kind, either express or implied, including, but
feedback to Nokia in respect of the contents of this not limited to, the implied warranties of
document ("Feedback"). merchantability and fitness for a particular purpose,

15 © 2017 Nokia <Document ID: change ID in footer or remove> <Change information classification in footer>