Models the transmission of RRC messages from the UE to the eNB in a real fashion, by creating real RRC PDUs and transmitting them over Signaling Radio Bearers using radio resources allocated by the LTE MAC scheduler. More...
#include "lte-rrc-protocol-real.h"
Public Member Functions | |
LteEnbRrcProtocolReal () | |
~LteEnbRrcProtocolReal () override | |
void | DoDispose () override |
Destructor implementation. | |
LteEnbRrcSapUser * | GetLteEnbRrcSapUser () |
Get LTE ENB RRC SAP user function. | |
LteUeRrcSapProvider * | GetUeRrcSapProvider (uint16_t rnti) |
Get UE RRC SAP provider function. | |
void | SetCellId (uint16_t cellId) |
Set cell ID function. | |
void | SetLteEnbRrcSapProvider (LteEnbRrcSapProvider *p) |
Set LTE ENB RRC SAP provider function. | |
void | SetUeRrcSapProvider (uint16_t rnti, LteUeRrcSapProvider *p) |
Set UE RRC SAP provider function. | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. | |
~Object () override | |
Destructor. | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. | |
void | Dispose () |
Dispose of this Object. | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. | |
bool | IsInitialized () const |
Check if the object has been initialized. | |
void | UnidirectionalAggregateObject (Ptr< Object > other) |
Aggregate an Object to another Object. | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const |
Get the value of an attribute, raising fatal errors if unsuccessful. | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. | |
Private Member Functions | |
LteRrcSap::RrcConnectionReconfiguration | DoDecodeHandoverCommand (Ptr< Packet > p) |
Decode handover command function. | |
LteRrcSap::HandoverPreparationInfo | DoDecodeHandoverPreparationInformation (Ptr< Packet > p) |
Decode handover preparation information function. | |
Ptr< Packet > | DoEncodeHandoverCommand (LteRrcSap::RrcConnectionReconfiguration msg) |
Encode handover command function. | |
Ptr< Packet > | DoEncodeHandoverPreparationInformation (LteRrcSap::HandoverPreparationInfo msg) |
Encode handover preparation information function. | |
void | DoReceivePdcpPdu (uint16_t rnti, Ptr< Packet > p) |
Receive PDCP PDU function. | |
void | DoReceivePdcpSdu (LtePdcpSapUser::ReceivePdcpSduParameters params) |
Receive PDCP SDU function. | |
void | DoRemoveUe (uint16_t rnti) |
Remove UE function. | |
void | DoSendRrcConnectionReconfiguration (uint16_t rnti, LteRrcSap::RrcConnectionReconfiguration msg) |
Send RRC connection reconfiguration function. | |
void | DoSendRrcConnectionReestablishment (uint16_t rnti, LteRrcSap::RrcConnectionReestablishment msg) |
Send RRC connection reestabishment function. | |
void | DoSendRrcConnectionReestablishmentReject (uint16_t rnti, LteRrcSap::RrcConnectionReestablishmentReject msg) |
Send RRC connection reestabishment reject function. | |
void | DoSendRrcConnectionReject (uint16_t rnti, LteRrcSap::RrcConnectionReject msg) |
Send RRC connection reject function. | |
void | DoSendRrcConnectionRelease (uint16_t rnti, LteRrcSap::RrcConnectionRelease msg) |
Send RRC connection release function. | |
void | DoSendRrcConnectionSetup (uint16_t rnti, LteRrcSap::RrcConnectionSetup msg) |
Send RRC connection setup function. | |
void | DoSendSystemInformation (uint16_t cellId, LteRrcSap::SystemInformation msg) |
Send system information function. | |
void | DoSetupUe (uint16_t rnti, LteEnbRrcSapUser::SetupUeParameters params) |
Setup UE function. | |
void | SendSystemInformation (uint16_t cellId, LteRrcSap::SystemInformation msg) |
Send system information function. | |
Private Attributes | |
uint16_t | m_cellId |
the cell ID | |
std::map< uint16_t, LteEnbRrcSapProvider::CompleteSetupUeParameters > | m_completeSetupUeParametersMap |
complete setup UE parameters map | |
LteEnbRrcSapProvider * | m_enbRrcSapProvider |
ENB RRC SAP provider. | |
std::map< uint16_t, LteUeRrcSapProvider * > | m_enbRrcSapProviderMap |
ENB RRC SAP provider map. | |
LteEnbRrcSapUser * | m_enbRrcSapUser |
ENB RRC SAP user. | |
uint16_t | m_rnti |
the RNTI | |
std::map< uint16_t, LteEnbRrcSapUser::SetupUeParameters > | m_setupUeParametersMap |
setup UE parameters map | |
Friends | |
class | LtePdcpSpecificLtePdcpSapUser< LteEnbRrcProtocolReal > |
allow LtePdcpSpecificLtePdcpSapUser<LteEnbRrcProtocolReal> class friend access | |
class | LteRlcSpecificLteRlcSapUser< LteEnbRrcProtocolReal > |
allow LteRlcSpecificLteRlcSapUser<LteEnbRrcProtocolReal> class friend access | |
class | MemberLteEnbRrcSapUser< LteEnbRrcProtocolReal > |
allow MemberLteEnbRrcSapUser<LteEnbRrcProtocolReal> class friend access | |
class | RealProtocolRlcSapUser |
allow RealProtocolRlcSapUser class friend access | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | DoInitialize () |
Initialize() implementation. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Models the transmission of RRC messages from the UE to the eNB in a real fashion, by creating real RRC PDUs and transmitting them over Signaling Radio Bearers using radio resources allocated by the LTE MAC scheduler.
Definition at line 172 of file lte-rrc-protocol-real.h.
ns3::LteEnbRrcProtocolReal::LteEnbRrcProtocolReal | ( | ) |
Definition at line 375 of file lte-rrc-protocol-real.cc.
References m_enbRrcSapUser, MemberLteEnbRrcSapUser< LteEnbRrcProtocolReal >, and NS_LOG_FUNCTION.
|
override |
Definition at line 382 of file lte-rrc-protocol-real.cc.
References NS_LOG_FUNCTION.
|
private |
Decode handover command function.
p | the packet |
Definition at line 804 of file lte-rrc-protocol-real.cc.
References ns3::RrcConnectionReconfigurationHeader::GetMessage().
|
private |
Decode handover preparation information function.
p | the packet |
Definition at line 785 of file lte-rrc-protocol-real.cc.
References ns3::HandoverPreparationInfoHeader::GetMessage().
|
overridevirtual |
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 388 of file lte-rrc-protocol-real.cc.
References m_completeSetupUeParametersMap, m_enbRrcSapUser, and NS_LOG_FUNCTION.
|
private |
Encode handover command function.
msg | LteRrcSap::RrcConnectionReconfiguration |
Definition at line 794 of file lte-rrc-protocol-real.cc.
References ns3::Create(), and ns3::RrcConnectionReconfigurationHeader::SetMessage().
|
private |
Encode handover preparation information function.
msg | LteRrcSap::HandoverPreparationInfo |
Definition at line 773 of file lte-rrc-protocol-real.cc.
References ns3::Create(), and ns3::HandoverPreparationInfoHeader::SetMessage().
Receive PDCP PDU function.
rnti | the RNTI |
p | the packet |
Definition at line 689 of file lte-rrc-protocol-real.cc.
References ns3::RrcConnectionReestablishmentRequestHeader::GetMessage(), ns3::RrcConnectionRequestHeader::GetMessage(), ns3::RrcAsn1Header::GetMessageType(), m_enbRrcSapProvider, ns3::LteEnbRrcSapProvider::RecvRrcConnectionReestablishmentRequest(), and ns3::LteEnbRrcSapProvider::RecvRrcConnectionRequest().
Referenced by ns3::RealProtocolRlcSapUser::ReceivePdcpPdu().
|
private |
Receive PDCP SDU function.
params | LtePdcpSapUser::ReceivePdcpSduParameters |
Definition at line 721 of file lte-rrc-protocol-real.cc.
References ns3::MeasurementReportHeader::GetMessage(), ns3::RrcConnectionReconfigurationCompleteHeader::GetMessage(), ns3::RrcConnectionReestablishmentCompleteHeader::GetMessage(), ns3::RrcConnectionSetupCompleteHeader::GetMessage(), ns3::RrcAsn1Header::GetMessageType(), m_enbRrcSapProvider, ns3::LteEnbRrcSapProvider::RecvMeasurementReport(), ns3::LteEnbRrcSapProvider::RecvRrcConnectionReconfigurationCompleted(), ns3::LteEnbRrcSapProvider::RecvRrcConnectionReestablishmentComplete(), and ns3::LteEnbRrcSapProvider::RecvRrcConnectionSetupCompleted().
|
private |
Remove UE function.
rnti | the RNTI |
Definition at line 512 of file lte-rrc-protocol-real.cc.
References m_completeSetupUeParametersMap, m_enbRrcSapProviderMap, m_setupUeParametersMap, NS_ASSERT, and NS_LOG_FUNCTION.
|
private |
Send RRC connection reconfiguration function.
rnti | the RNTI |
msg | LteRrcSap::RrcConnectionReconfiguration |
Definition at line 594 of file lte-rrc-protocol-real.cc.
References ns3::Create(), ns3::LtePdcpSapProvider::TransmitPdcpSduParameters::lcid, m_setupUeParametersMap, ns3::LtePdcpSapProvider::TransmitPdcpSduParameters::pdcpSdu, ns3::LtePdcpSapProvider::TransmitPdcpSduParameters::rnti, and ns3::RrcConnectionReconfigurationHeader::SetMessage().
|
private |
Send RRC connection reestabishment function.
rnti | the RNTI |
msg | LteRrcSap::RrcConnectionReestablishment |
Definition at line 614 of file lte-rrc-protocol-real.cc.
References ns3::Create(), ns3::LteRlcSapProvider::TransmitPdcpPduParameters::lcid, m_setupUeParametersMap, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::pdcpPdu, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::rnti, and ns3::RrcConnectionReestablishmentHeader::SetMessage().
|
private |
Send RRC connection reestabishment reject function.
rnti | the RNTI |
msg | LteRrcSap::RrcConnectionReestablishmentReject |
Definition at line 634 of file lte-rrc-protocol-real.cc.
References ns3::Create(), ns3::LteRlcSapProvider::TransmitPdcpPduParameters::lcid, m_setupUeParametersMap, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::pdcpPdu, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::rnti, and ns3::RrcConnectionReestablishmentRejectHeader::SetMessage().
|
private |
Send RRC connection reject function.
rnti | the RNTI |
msg | LteRrcSap::RrcConnectionReject |
Definition at line 576 of file lte-rrc-protocol-real.cc.
References ns3::Create(), ns3::LteRlcSapProvider::TransmitPdcpPduParameters::lcid, m_setupUeParametersMap, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::pdcpPdu, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::rnti, and ns3::RrcConnectionRejectHeader::SetMessage().
|
private |
Send RRC connection release function.
rnti | the RNTI |
msg | LteRrcSap::RrcConnectionRelease |
Send RRC connection release in an idle way to ensure UE goes to idle mode during handover failure and connection setup timeout. Implemented to avoid unnecessary triggering of assert msgs due to reception of msgs (SRS CQI reports) from UE after UE context is deleted at eNodeB. TODO: Detection of handover failure and connection setup timeout at UE, so that the RRC connection release can be sent through the physical channel again.
Definition at line 654 of file lte-rrc-protocol-real.cc.
References GetUeRrcSapProvider(), NS_LOG_FUNCTION, ns3::LteUeRrcSapProvider::RecvRrcConnectionRelease(), ns3::RRC_REAL_MSG_DELAY, and ns3::Simulator::Schedule().
|
private |
Send RRC connection setup function.
rnti | the RNTI |
msg | LteRrcSap::RrcConnectionSetup |
Definition at line 558 of file lte-rrc-protocol-real.cc.
References ns3::Create(), ns3::LteRlcSapProvider::TransmitPdcpPduParameters::lcid, m_setupUeParametersMap, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::pdcpPdu, ns3::LteRlcSapProvider::TransmitPdcpPduParameters::rnti, and ns3::RrcConnectionSetupHeader::SetMessage().
|
private |
Send system information function.
cellId | cell ID |
msg | LteRrcSap::SystemInformation |
Definition at line 525 of file lte-rrc-protocol-real.cc.
References ns3::NodeList::Begin(), ns3::NodeList::End(), NS_LOG_FUNCTION, NS_LOG_LOGIC, ns3::LteUeRrcSapProvider::RecvSystemInformation(), ns3::RRC_REAL_MSG_DELAY, and ns3::Simulator::ScheduleWithContext().
|
private |
Setup UE function.
rnti | the RNTI |
params | LteEnbRrcSapUser::SetupUeParameters |
Definition at line 450 of file lte-rrc-protocol-real.cc.
References ns3::LteEnbRrcSapProvider::CompleteSetupUe(), LtePdcpSpecificLtePdcpSapUser< LteEnbRrcProtocolReal >, m_completeSetupUeParametersMap, m_enbRrcSapProvider, m_enbRrcSapProviderMap, m_setupUeParametersMap, NS_LOG_FUNCTION, RealProtocolRlcSapUser, ns3::LteEnbRrcSapProvider::CompleteSetupUeParameters::srb0SapUser, and ns3::LteEnbRrcSapProvider::CompleteSetupUeParameters::srb1SapUser.
LteEnbRrcSapUser * ns3::LteEnbRrcProtocolReal::GetLteEnbRrcSapUser | ( | ) |
Get LTE ENB RRC SAP user function.
Definition at line 419 of file lte-rrc-protocol-real.cc.
References m_enbRrcSapUser.
|
static |
Get the type ID.
Definition at line 403 of file lte-rrc-protocol-real.cc.
References ns3::TypeId::SetParent().
LteUeRrcSapProvider * ns3::LteEnbRrcProtocolReal::GetUeRrcSapProvider | ( | uint16_t | rnti | ) |
Get UE RRC SAP provider function.
rnti | the RNTI |
Definition at line 431 of file lte-rrc-protocol-real.cc.
References m_enbRrcSapProviderMap, and NS_ASSERT_MSG.
Referenced by DoSendRrcConnectionRelease().
|
private |
Send system information function.
cellId | cell ID |
msg | LteRrcSap::SystemInformation |
void ns3::LteEnbRrcProtocolReal::SetCellId | ( | uint16_t | cellId | ) |
Set cell ID function.
cellId | the cell ID |
Definition at line 425 of file lte-rrc-protocol-real.cc.
References m_cellId.
void ns3::LteEnbRrcProtocolReal::SetLteEnbRrcSapProvider | ( | LteEnbRrcSapProvider * | p | ) |
Set LTE ENB RRC SAP provider function.
p | LteEnbRrcSapProvider * |
Definition at line 413 of file lte-rrc-protocol-real.cc.
References m_enbRrcSapProvider.
void ns3::LteEnbRrcProtocolReal::SetUeRrcSapProvider | ( | uint16_t | rnti, |
LteUeRrcSapProvider * | p ) |
Set UE RRC SAP provider function.
rnti | the RNTI |
p | LteUeRrcSapProvider * |
Definition at line 439 of file lte-rrc-protocol-real.cc.
References m_enbRrcSapProviderMap.
|
friend |
allow LtePdcpSpecificLtePdcpSapUser<LteEnbRrcProtocolReal> class friend access
Definition at line 162 of file lte-rrc-protocol-real.h.
Referenced by DoSetupUe().
|
friend |
allow LteRlcSpecificLteRlcSapUser<LteEnbRrcProtocolReal> class friend access
Definition at line 162 of file lte-rrc-protocol-real.h.
|
friend |
allow MemberLteEnbRrcSapUser<LteEnbRrcProtocolReal> class friend access
Definition at line 162 of file lte-rrc-protocol-real.h.
Referenced by LteEnbRrcProtocolReal().
|
friend |
allow RealProtocolRlcSapUser class friend access
Definition at line 181 of file lte-rrc-protocol-real.h.
Referenced by DoSetupUe().
|
private |
|
private |
complete setup UE parameters map
Definition at line 356 of file lte-rrc-protocol-real.h.
Referenced by DoDispose(), DoRemoveUe(), and DoSetupUe().
|
private |
ENB RRC SAP provider.
Definition at line 350 of file lte-rrc-protocol-real.h.
Referenced by DoReceivePdcpPdu(), DoReceivePdcpSdu(), DoSetupUe(), and SetLteEnbRrcSapProvider().
|
private |
ENB RRC SAP provider map.
Definition at line 352 of file lte-rrc-protocol-real.h.
Referenced by DoRemoveUe(), DoSetupUe(), GetUeRrcSapProvider(), and SetUeRrcSapProvider().
|
private |
ENB RRC SAP user.
Definition at line 351 of file lte-rrc-protocol-real.h.
Referenced by LteEnbRrcProtocolReal(), DoDispose(), and GetLteEnbRrcSapUser().
|
private |
the RNTI
Definition at line 348 of file lte-rrc-protocol-real.h.
|
private |
setup UE parameters map
Definition at line 354 of file lte-rrc-protocol-real.h.
Referenced by DoRemoveUe(), DoSendRrcConnectionReconfiguration(), DoSendRrcConnectionReestablishment(), DoSendRrcConnectionReestablishmentReject(), DoSendRrcConnectionReject(), DoSendRrcConnectionSetup(), and DoSetupUe().