This class realizes Uplink Power Control functionality. More...
#include "lte-ue-power-control.h"
Public Types | |
typedef void(* | TxPowerTracedCallback) (uint16_t cellId, uint16_t rnti, double power) |
TracedCallback signature for uplink transmit power. More... | |
Public Member Functions | |
LteUePowerControl () | |
virtual | ~LteUePowerControl () |
void | CalculatePucchTxPower () |
Calculate PUCCH transmit power function. More... | |
void | CalculatePuschTxPower () |
Calculate PUSCH transmit power function. More... | |
void | CalculateSrsTxPower () |
Calculate SRS transmit power function. More... | |
void | ConfigureReferenceSignalPower (int8_t referenceSignalPower) |
Configure reference signal power function. More... | |
virtual void | DoDispose (void) |
Destructor implementation. More... | |
virtual void | DoInitialize (void) |
Initialize() implementation. More... | |
double | GetPcmax () |
Get PC maximum function. More... | |
double | GetPucchTxPower (std::vector< int > rb) |
Get PUCCH transmit power function. More... | |
double | GetPuschTxPower (std::vector< int > rb) |
Get PUSCH transmit power function. More... | |
double | GetSrsTxPower (std::vector< int > rb) |
Get SRS transmit power function. More... | |
void | ReportTpc (uint8_t tpc) |
Set RSRP function. More... | |
void | SetAlpha (double value) |
Set alpha function. More... | |
void | SetCellId (uint16_t cellId) |
Set the cell ID function. More... | |
void | SetPcmax (double value) |
Set PC maximum function. More... | |
void | SetPoNominalPusch (int16_t value) |
Set PO nominal PUSCH function. More... | |
void | SetPoUePusch (int16_t value) |
Set PO UE PUSCH function. More... | |
void | SetRnti (uint16_t rnti) |
Set the RNTI function. More... | |
void | SetRsrp (double value) |
Set RSRP function. More... | |
void | SetTxPower (double value) |
Set transmit power function. More... | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. More... | |
virtual | ~Object () |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose (void) |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator (void) const |
Get an iterator to the Objects aggregated to this one. More... | |
virtual TypeId | GetInstanceTypeId (void) const |
Get the most derived TypeId for this Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (void) const |
Get a pointer to the requested aggregated Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. More... | |
void | Initialize (void) |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized (void) const |
Check if the object has been initialized. More... | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. More... | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount (void) const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. More... | |
void | Ref (void) const |
Increment the reference count. More... | |
void | Unref (void) const |
Decrement the reference count. More... | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. More... | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising erros. More... | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. More... | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. More... | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. More... | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. More... | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. More... | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId (void) |
Register this type. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Private Member Functions | |
void | SetSubChannelMask (std::vector< int > mask) |
Set subchannel mask function. More... | |
Private Attributes | |
bool | m_accumulationEnabled |
accumulation enabled More... | |
std::vector< double > | m_alpha |
alpha values More... | |
uint16_t | m_cellId |
cell ID More... | |
bool | m_closedLoop |
is closed loop More... | |
double | m_curPucchTxPower |
current PUCCH transmit power More... | |
double | m_curPuschTxPower |
current PUSCH transmit power More... | |
double | m_curSrsTxPower |
current SRS transmit power More... | |
std::vector< int8_t > | m_deltaPusch |
delta PUSCH More... | |
double | m_deltaTF |
delta TF More... | |
double | m_fc |
FC. More... | |
uint16_t | m_M_Pusch |
size of DL RB list More... | |
double | m_pathLoss |
path loss value More... | |
double | m_Pcmax |
PC maximum. More... | |
double | m_Pcmin |
PC minimum. More... | |
std::vector< int16_t > | m_PoNominalPusch |
PO nominal PUSCH. More... | |
std::vector< int16_t > | m_PoUePusch |
PO US PUSCH. More... | |
int16_t | m_PsrsOffset |
PSRS offset. More... | |
double | m_referenceSignalPower |
reference signal power More... | |
TracedCallback< uint16_t, uint16_t, double > | m_reportPucchTxPower |
Trace information regarding Uplink TxPower uint16_t cellId, uint16_t rnti, double txPower. More... | |
TracedCallback< uint16_t, uint16_t, double > | m_reportPuschTxPower |
Trace information regarding Uplink TxPower uint16_t cellId, uint16_t rnti, double txPower. More... | |
TracedCallback< uint16_t, uint16_t, double > | m_reportSrsTxPower |
Trace information regarding Uplink TxPower uint16_t cellId, uint16_t rnti, double txPower. More... | |
uint16_t | m_rnti |
RNTI. More... | |
double | m_rsrp |
RSRP value. More... | |
bool | m_rsrpSet |
is RSRP set? More... | |
uint16_t | m_srsBandwidth |
SRS bandwidth. More... | |
double | m_txPower |
transmit power More... | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | NotifyNewAggregate (void) |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted (void) |
Notifier called once the ObjectBase is fully constructed. More... | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid (void) |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
This class realizes Uplink Power Control functionality.
Introspection did not find any typical Config paths.
When LteUePhy is about sending PUSCH/PUCCH/SRS it should ask LteUePowerControl for current channel TX power level and then use it while creating SpectrumValue for Uplink Transmission
LteUePowerControl computes TX power level for PUSCH and SRS. PUCCH is realized in ideal way and PUSCH do not use any resources, so there is no need to compute power for that channel
LteUePowerControlcomputes TX power based on some preconfigured parameters and current Path-loss. Path-loss is computed as difference between current RSRP and referenceSignalPower level. Current RSRP is passed to LteUePowerControl by LteUePhy. referenceSignalPower is configurable by attribute system
Moreover, LteUePhy pass all received TPC values to LteUePowerControl, what is a part of Closed Loop Power Control functionality
Size of this type is 312 bytes (on a 64-bit architecture).
Definition at line 54 of file lte-ue-power-control.h.
typedef void(* ns3::LteUePowerControl::TxPowerTracedCallback) (uint16_t cellId, uint16_t rnti, double power) |
TracedCallback signature for uplink transmit power.
[in] | cellId | Cell identifier. |
[in] | rnti | The C-RNTI identifying the UE. |
[in] | power | The current TX power. |
Definition at line 178 of file lte-ue-power-control.h.
ns3::LteUePowerControl::LteUePowerControl | ( | ) |
Definition at line 35 of file lte-ue-power-control.cc.
References m_cellId, m_curPucchTxPower, m_curPuschTxPower, m_curSrsTxPower, m_deltaTF, m_fc, m_M_Pusch, m_pathLoss, m_rnti, m_rsrpSet, m_txPower, and NS_LOG_FUNCTION.
|
virtual |
Definition at line 53 of file lte-ue-power-control.cc.
References NS_LOG_FUNCTION.
void ns3::LteUePowerControl::CalculatePucchTxPower | ( | ) |
Calculate PUCCH transmit power function.
Definition at line 390 of file lte-ue-power-control.cc.
References m_curPucchTxPower, m_curPuschTxPower, NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetPucchTxPower().
void ns3::LteUePowerControl::CalculatePuschTxPower | ( | ) |
Calculate PUSCH transmit power function.
Definition at line 362 of file lte-ue-power-control.cc.
References m_alpha, m_curPuschTxPower, m_deltaTF, m_fc, m_M_Pusch, m_pathLoss, m_Pcmax, m_Pcmin, m_PoNominalPusch, m_PoUePusch, NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetPuschTxPower().
void ns3::LteUePowerControl::CalculateSrsTxPower | ( | ) |
Calculate SRS transmit power function.
Definition at line 398 of file lte-ue-power-control.cc.
References m_alpha, m_curSrsTxPower, m_deltaTF, m_fc, m_M_Pusch, m_pathLoss, m_Pcmax, m_Pcmin, m_PoNominalPusch, m_PoUePusch, m_PsrsOffset, m_srsBandwidth, NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by GetSrsTxPower().
void ns3::LteUePowerControl::ConfigureReferenceSignalPower | ( | int8_t | referenceSignalPower | ) |
Configure reference signal power function.
referenceSignalPower | the reference signal power |
Definition at line 160 of file lte-ue-power-control.cc.
References m_referenceSignalPower, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::DoConfigureReferenceSignalPower().
|
virtual |
Destructor implementation.
This method is called by Dispose() or by the Object's destructor, whichever comes first.
Subclasses are expected to implement their real destruction code in an overridden version of this method and chain up to their parent's implementation once they are done. i.e, for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose() method.
It is safe to call GetObject() from within this method.
Reimplemented from ns3::Object.
Definition at line 65 of file lte-ue-power-control.cc.
References NS_LOG_FUNCTION.
|
virtual |
Initialize() implementation.
This method is called only once by Initialize(). If the user calls Initialize() multiple times, DoInitialize() is called only the first time.
Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject() and AggregateObject() from within this method.
Reimplemented from ns3::Object.
Definition at line 59 of file lte-ue-power-control.cc.
References NS_LOG_FUNCTION.
double ns3::LteUePowerControl::GetPcmax | ( | ) |
Get PC maximum function.
Definition at line 143 of file lte-ue-power-control.cc.
References m_Pcmax, and NS_LOG_FUNCTION.
double ns3::LteUePowerControl::GetPucchTxPower | ( | std::vector< int > | rb | ) |
Get PUCCH transmit power function.
rb | unused |
Definition at line 435 of file lte-ue-power-control.cc.
References CalculatePucchTxPower(), m_cellId, m_curPucchTxPower, m_reportPucchTxPower, m_rnti, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::SubframeIndication().
double ns3::LteUePowerControl::GetPuschTxPower | ( | std::vector< int > | rb | ) |
Get PUSCH transmit power function.
rb | the DL RB list |
Definition at line 422 of file lte-ue-power-control.cc.
References CalculatePuschTxPower(), m_cellId, m_curPuschTxPower, m_M_Pusch, m_reportPuschTxPower, m_rnti, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::SubframeIndication().
double ns3::LteUePowerControl::GetSrsTxPower | ( | std::vector< int > | rb | ) |
Get SRS transmit power function.
rb | the DL RB list |
Definition at line 447 of file lte-ue-power-control.cc.
References CalculateSrsTxPower(), m_cellId, m_curSrsTxPower, m_reportSrsTxPower, m_rnti, m_srsBandwidth, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::SendSrs().
|
static |
Get the type ID.
Definition at line 71 of file lte-ue-power-control.cc.
References m_accumulationEnabled, m_closedLoop, m_Pcmax, m_Pcmin, m_PsrsOffset, m_reportPucchTxPower, m_reportPuschTxPower, m_reportSrsTxPower, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeDoubleAccessor(), ns3::MakeIntegerAccessor(), ns3::MakeTraceSourceAccessor(), SetAlpha(), ns3::TypeId::SetParent(), SetPoNominalPusch(), and SetPoUePusch().
void ns3::LteUePowerControl::ReportTpc | ( | uint8_t | tpc | ) |
Set RSRP function.
tpc | the TPC to report |
Definition at line 269 of file lte-ue-power-control.cc.
References m_accumulationEnabled, m_closedLoop, m_curPuschTxPower, m_deltaPusch, m_fc, m_Pcmax, m_Pcmin, NS_FATAL_ERROR, NS_LOG_FUNCTION, and NS_LOG_INFO.
Referenced by ns3::LteUePhy::ReceiveLteControlMessageList().
void ns3::LteUePowerControl::SetAlpha | ( | double | value | ) |
Set alpha function.
value | the alpha value to set |
Definition at line 216 of file lte-ue-power-control.cc.
References m_alpha, NS_FATAL_ERROR, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::LteUePowerControl::SetCellId | ( | uint16_t | cellId | ) |
Set the cell ID function.
cellId | the cell ID |
Definition at line 167 of file lte-ue-power-control.cc.
References m_cellId, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::DoSetRnti().
void ns3::LteUePowerControl::SetPcmax | ( | double | value | ) |
Set PC maximum function.
value | the PC maximum value |
Definition at line 136 of file lte-ue-power-control.cc.
References m_Pcmax, and NS_LOG_FUNCTION.
void ns3::LteUePowerControl::SetPoNominalPusch | ( | int16_t | value | ) |
Set PO nominal PUSCH function.
value | the value to set |
Definition at line 180 of file lte-ue-power-control.cc.
References m_PoNominalPusch, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::LteUePowerControl::SetPoUePusch | ( | int16_t | value | ) |
Set PO UE PUSCH function.
value | the value to set |
Definition at line 199 of file lte-ue-power-control.cc.
References m_PoUePusch, and NS_LOG_FUNCTION.
Referenced by GetTypeId().
void ns3::LteUePowerControl::SetRnti | ( | uint16_t | rnti | ) |
Set the RNTI function.
rnti | the RNTI |
Definition at line 173 of file lte-ue-power-control.cc.
References m_rnti, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::DoSetRnti().
void ns3::LteUePowerControl::SetRsrp | ( | double | value | ) |
Set RSRP function.
value | the RSRP value to set |
Definition at line 252 of file lte-ue-power-control.cc.
References m_pathLoss, m_referenceSignalPower, m_rsrp, m_rsrpSet, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::ReportRsReceivedPower().
|
private |
Set subchannel mask function.
[in] | mask | the subchannel mask |
Definition at line 355 of file lte-ue-power-control.cc.
References m_M_Pusch, and NS_LOG_FUNCTION.
void ns3::LteUePowerControl::SetTxPower | ( | double | value | ) |
Set transmit power function.
value | the transmit power value |
Definition at line 150 of file lte-ue-power-control.cc.
References m_curPucchTxPower, m_curPuschTxPower, m_curSrsTxPower, m_txPower, and NS_LOG_FUNCTION.
Referenced by ns3::LteUePhy::SetTxPower().
|
private |
accumulation enabled
Definition at line 216 of file lte-ue-power-control.h.
Referenced by GetTypeId(), and ReportTpc().
|
private |
alpha values
Definition at line 206 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), and SetAlpha().
|
private |
cell ID
Definition at line 218 of file lte-ue-power-control.h.
Referenced by GetPucchTxPower(), GetPuschTxPower(), GetSrsTxPower(), LteUePowerControl(), and SetCellId().
|
private |
is closed loop
Definition at line 215 of file lte-ue-power-control.h.
Referenced by GetTypeId(), and ReportTpc().
|
private |
current PUCCH transmit power
Definition at line 193 of file lte-ue-power-control.h.
Referenced by CalculatePucchTxPower(), GetPucchTxPower(), LteUePowerControl(), and SetTxPower().
|
private |
current PUSCH transmit power
Definition at line 192 of file lte-ue-power-control.h.
Referenced by CalculatePucchTxPower(), CalculatePuschTxPower(), GetPuschTxPower(), LteUePowerControl(), ReportTpc(), and SetTxPower().
|
private |
current SRS transmit power
Definition at line 194 of file lte-ue-power-control.h.
Referenced by CalculateSrsTxPower(), GetSrsTxPower(), LteUePowerControl(), and SetTxPower().
|
private |
|
private |
delta TF
Definition at line 208 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), and LteUePowerControl().
|
private |
FC.
Definition at line 211 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), LteUePowerControl(), and ReportTpc().
|
private |
size of DL RB list
Definition at line 205 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), GetPuschTxPower(), LteUePowerControl(), and SetSubChannelMask().
|
private |
path loss value
Definition at line 207 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), LteUePowerControl(), and SetRsrp().
|
private |
PC maximum.
Definition at line 189 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), GetPcmax(), GetTypeId(), ReportTpc(), and SetPcmax().
|
private |
PC minimum.
Definition at line 190 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), GetTypeId(), and ReportTpc().
|
private |
PO nominal PUSCH.
Definition at line 200 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), and SetPoNominalPusch().
|
private |
PO US PUSCH.
Definition at line 201 of file lte-ue-power-control.h.
Referenced by CalculatePuschTxPower(), CalculateSrsTxPower(), and SetPoUePusch().
|
private |
PSRS offset.
Definition at line 203 of file lte-ue-power-control.h.
Referenced by CalculateSrsTxPower(), and GetTypeId().
|
private |
reference signal power
Definition at line 196 of file lte-ue-power-control.h.
Referenced by ConfigureReferenceSignalPower(), and SetRsrp().
|
private |
Trace information regarding Uplink TxPower uint16_t cellId, uint16_t rnti, double txPower.
Definition at line 229 of file lte-ue-power-control.h.
Referenced by GetPucchTxPower(), and GetTypeId().
|
private |
Trace information regarding Uplink TxPower uint16_t cellId, uint16_t rnti, double txPower.
Definition at line 224 of file lte-ue-power-control.h.
Referenced by GetPuschTxPower(), and GetTypeId().
|
private |
Trace information regarding Uplink TxPower uint16_t cellId, uint16_t rnti, double txPower.
Definition at line 234 of file lte-ue-power-control.h.
Referenced by GetSrsTxPower(), and GetTypeId().
|
private |
RNTI.
Definition at line 219 of file lte-ue-power-control.h.
Referenced by GetPucchTxPower(), GetPuschTxPower(), GetSrsTxPower(), LteUePowerControl(), and SetRnti().
|
private |
|
private |
is RSRP set?
Definition at line 197 of file lte-ue-power-control.h.
Referenced by LteUePowerControl(), and SetRsrp().
|
private |
SRS bandwidth.
Definition at line 213 of file lte-ue-power-control.h.
Referenced by CalculateSrsTxPower(), and GetSrsTxPower().
|
private |
transmit power
Definition at line 188 of file lte-ue-power-control.h.
Referenced by LteUePowerControl(), and SetTxPower().