A Discrete-Event Network Simulator
API
ns3::LteUeCphySapProvider Class Referenceabstract

Service Access Point (SAP) offered by the UE PHY to the UE RRC for control purposes. More...

#include "lte-ue-cphy-sap.h"

+ Inheritance diagram for ns3::LteUeCphySapProvider:

Public Member Functions

virtual ~LteUeCphySapProvider ()
 Destructor. More...
 
virtual void ConfigureReferenceSignalPower (int8_t referenceSignalPower)=0
 Configure referenceSignalPower. More...
 
virtual void ConfigureUplink (uint32_t ulEarfcn, uint16_t ulBandwidth)=0
 Configure uplink (normally done after reception of SIB2) More...
 
virtual uint16_t GetCellId ()=0
 Get PHY cell ID. More...
 
virtual uint32_t GetDlEarfcn ()=0
 Get PHY DL EARFCN. More...
 
virtual void Reset ()=0
 Reset the PHY. More...
 
virtual void ResetPhyAfterRlf ()=0
 Reset the PHY after radio link failure function It resets the physical layer parameters of the UE after RLF. More...
 
virtual void ResetRlfParams ()=0
 Reset radio link failure parameters. More...
 
virtual void SetDlBandwidth (uint16_t dlBandwidth)=0
 
virtual void SetImsi (uint64_t imsi)=0
 A method call by UE RRC to communicate the IMSI to the UE PHY. More...
 
virtual void SetPa (double pa)=0
 Set P_A value for UE power control. More...
 
virtual void SetRnti (uint16_t rnti)=0
 Set Rnti function. More...
 
virtual void SetRsrpFilterCoefficient (uint8_t rsrpFilterCoefficient)=0
 Set RSRP filter coefficient. More...
 
virtual void SetSrsConfigurationIndex (uint16_t srcCi)=0
 Set SRS configuration index. More...
 
virtual void SetTransmissionMode (uint8_t txMode)=0
 Set transmission mode. More...
 
virtual void StartCellSearch (uint32_t dlEarfcn)=0
 Tell the PHY entity to listen to PSS from surrounding cells and measure the RSRP. More...
 
virtual void StartInSyncDetection ()=0
 Start in-sync detection function When T310 timer is started, it indicates that physical layer problems are detected at the UE and the recovery process is started by checking if the radio frames are in-sync for N311 consecutive times. More...
 
virtual void SynchronizeWithEnb (uint16_t cellId)=0
 Tell the PHY entity to synchronize with a given eNodeB over the currently active EARFCN for communication purposes. More...
 
virtual void SynchronizeWithEnb (uint16_t cellId, uint32_t dlEarfcn)=0
 Tell the PHY entity to align to the given EARFCN and synchronize with a given eNodeB for communication purposes. More...
 

Detailed Description

Service Access Point (SAP) offered by the UE PHY to the UE RRC for control purposes.

This is the PHY SAP Provider, i.e., the part of the SAP that contains the PHY methods called by the MAC

Definition at line 41 of file lte-ue-cphy-sap.h.

Constructor & Destructor Documentation

◆ ~LteUeCphySapProvider()

ns3::LteUeCphySapProvider::~LteUeCphySapProvider ( )
virtual

Destructor.

Definition at line 25 of file lte-ue-cphy-sap.cc.

Member Function Documentation

◆ ConfigureReferenceSignalPower()

virtual void ns3::LteUeCphySapProvider::ConfigureReferenceSignalPower ( int8_t  referenceSignalPower)
pure virtual

Configure referenceSignalPower.

Parameters
referenceSignalPowerreceived from eNB in SIB2

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ ConfigureUplink()

virtual void ns3::LteUeCphySapProvider::ConfigureUplink ( uint32_t  ulEarfcn,
uint16_t  ulBandwidth 
)
pure virtual

Configure uplink (normally done after reception of SIB2)

Parameters
ulEarfcnthe uplink carrier frequency (EARFCN)
ulBandwidththe UL bandwidth in number of PRBs

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ GetCellId()

virtual uint16_t ns3::LteUeCphySapProvider::GetCellId ( )
pure virtual

Get PHY cell ID.

Returns
cell ID this PHY is synchronized to

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ GetDlEarfcn()

virtual uint32_t ns3::LteUeCphySapProvider::GetDlEarfcn ( )
pure virtual

Get PHY DL EARFCN.

Returns
DL EARFCN this PHY is synchronized to

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ Reset()

virtual void ns3::LteUeCphySapProvider::Reset ( )
pure virtual

Reset the PHY.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ ResetPhyAfterRlf()

virtual void ns3::LteUeCphySapProvider::ResetPhyAfterRlf ( )
pure virtual

Reset the PHY after radio link failure function It resets the physical layer parameters of the UE after RLF.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ ResetRlfParams()

virtual void ns3::LteUeCphySapProvider::ResetRlfParams ( )
pure virtual

Reset radio link failure parameters.

Upon receiving N311 in-sync indications from the UE PHY the UE RRC instructs the UE PHY to reset the RLF parameters so, it can start RLF detection again.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetDlBandwidth()

virtual void ns3::LteUeCphySapProvider::SetDlBandwidth ( uint16_t  dlBandwidth)
pure virtual
Parameters
dlBandwidththe DL bandwidth in number of PRBs

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetImsi()

virtual void ns3::LteUeCphySapProvider::SetImsi ( uint64_t  imsi)
pure virtual

A method call by UE RRC to communicate the IMSI to the UE PHY.

Parameters
imsithe IMSI of the UE

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetPa()

virtual void ns3::LteUeCphySapProvider::SetPa ( double  pa)
pure virtual

Set P_A value for UE power control.

Parameters
pathe P_A value

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetRnti()

virtual void ns3::LteUeCphySapProvider::SetRnti ( uint16_t  rnti)
pure virtual

Set Rnti function.

Parameters
rntithe cell-specific UE identifier

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetRsrpFilterCoefficient()

virtual void ns3::LteUeCphySapProvider::SetRsrpFilterCoefficient ( uint8_t  rsrpFilterCoefficient)
pure virtual

Set RSRP filter coefficient.

Determines the strength of smoothing effect induced by layer 3 filtering of RSRP used for uplink power control in all attached UE. If equals to 0, no layer 3 filtering is applicable.

Parameters
rsrpFilterCoefficientvalue.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetSrsConfigurationIndex()

virtual void ns3::LteUeCphySapProvider::SetSrsConfigurationIndex ( uint16_t  srcCi)
pure virtual

Set SRS configuration index.

Parameters
srcCithe SRS configuration index

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SetTransmissionMode()

virtual void ns3::LteUeCphySapProvider::SetTransmissionMode ( uint8_t  txMode)
pure virtual

Set transmission mode.

Parameters
txModethe transmissionMode of the user

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ StartCellSearch()

virtual void ns3::LteUeCphySapProvider::StartCellSearch ( uint32_t  dlEarfcn)
pure virtual

Tell the PHY entity to listen to PSS from surrounding cells and measure the RSRP.

Parameters
dlEarfcnthe downlink carrier frequency (EARFCN) to listen to

This function will instruct this PHY instance to listen to the DL channel over the bandwidth of 6 RB at the frequency associated with the given EARFCN.

After this, it will start receiving Primary Synchronization Signal (PSS) and periodically returning measurement reports to RRC via LteUeCphySapUser::ReportUeMeasurements function.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ StartInSyncDetection()

virtual void ns3::LteUeCphySapProvider::StartInSyncDetection ( )
pure virtual

Start in-sync detection function When T310 timer is started, it indicates that physical layer problems are detected at the UE and the recovery process is started by checking if the radio frames are in-sync for N311 consecutive times.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SynchronizeWithEnb() [1/2]

virtual void ns3::LteUeCphySapProvider::SynchronizeWithEnb ( uint16_t  cellId)
pure virtual

Tell the PHY entity to synchronize with a given eNodeB over the currently active EARFCN for communication purposes.

Parameters
cellIdthe ID of the eNodeB to synchronize with

By synchronizing, the PHY will start receiving various information transmitted by the eNodeB. For instance, when receiving system information, the message will be relayed to RRC via LteUeCphySapUser::RecvMasterInformationBlock and LteUeCphySapUser::RecvSystemInformationBlockType1 functions.

Initially, the PHY will be configured to listen to 6 RBs of BCH. LteUeCphySapProvider::SetDlBandwidth can be called afterwards to increase the bandwidth.

Implemented in ns3::MemberLteUeCphySapProvider< C >.

◆ SynchronizeWithEnb() [2/2]

virtual void ns3::LteUeCphySapProvider::SynchronizeWithEnb ( uint16_t  cellId,
uint32_t  dlEarfcn 
)
pure virtual

Tell the PHY entity to align to the given EARFCN and synchronize with a given eNodeB for communication purposes.

Parameters
cellIdthe ID of the eNodeB to synchronize with
dlEarfcnthe downlink carrier frequency (EARFCN)

By synchronizing, the PHY will start receiving various information transmitted by the eNodeB. For instance, when receiving system information, the message will be relayed to RRC via LteUeCphySapUser::RecvMasterInformationBlock and LteUeCphySapUser::RecvSystemInformationBlockType1 functions.

Initially, the PHY will be configured to listen to 6 RBs of BCH. LteUeCphySapProvider::SetDlBandwidth can be called afterwards to increase the bandwidth.

Implemented in ns3::MemberLteUeCphySapProvider< C >.


The documentation for this class was generated from the following files: