This class implements the ranging response message described by "IEEE Standard for Local and metropolitan area networks Part 16: Air Interface for Fixed Broadband Wireless Access Systems" 6.3.2.3.6 Ranging response (RNG-RSP) message, page 50. More...
#include "mac-messages.h"
Public Member Functions | |
RngRsp (void) | |
virtual | ~RngRsp (void) |
uint32_t | Deserialize (Buffer::Iterator start) |
uint8_t | GetAasBdcastPermission (void) const |
Cid | GetBasicCid (void) const |
uint32_t | GetDlFreqOverride (void) const |
uint16_t | GetDlOperBurstProfile (void) const |
uint32_t | GetFrameNumber (void) const |
uint8_t | GetInitRangOppNumber (void) const |
virtual TypeId | GetInstanceTypeId (void) const |
Get the most derived TypeId for this Object. More... | |
Mac48Address | GetMacAddress (void) const |
std::string | GetName (void) const |
uint32_t | GetOffsetFreqAdjust (void) const |
uint8_t | GetPowerLevelAdjust (void) const |
Cid | GetPrimaryCid (void) const |
uint8_t | GetRangStatus (void) const |
uint8_t | GetRangSubchnl (void) const |
uint32_t | GetSerializedSize (void) const |
uint32_t | GetTimingAdjust (void) const |
uint8_t | GetUlChnlIdOverride (void) const |
void | Print (std::ostream &os) const |
void | Serialize (Buffer::Iterator start) const |
void | SetAasBdcastPermission (uint8_t aasBdcastPermission) |
set AAS broadcast permission. More... | |
void | SetBasicCid (Cid basicCid) |
set basic CID. More... | |
void | SetDlFreqOverride (uint32_t dlFreqOverride) |
set the Center frequency, in kHz, of new downlink channel where the SS should redo initial ranging. More... | |
void | SetDlOperBurstProfile (uint16_t dlOperBurstProfile) |
set the DL oper burst profile More... | |
void | SetFrameNumber (uint32_t frameNumber) |
set frame number. More... | |
void | SetInitRangOppNumber (uint8_t initRangOppNumber) |
set initial range opp number. More... | |
void | SetMacAddress (Mac48Address macAddress) |
set the MAC address More... | |
void | SetOffsetFreqAdjust (uint32_t offsetFreqAdjust) |
set the relative change in transmission frequency that the SS should take in order to better match the BS. More... | |
void | SetPowerLevelAdjust (uint8_t powerLevelAdjust) |
set the relative change in transmission power level that the SS should make in order that transmissions arrive at the BS at the desired power. More... | |
void | SetPrimaryCid (Cid primaryCid) |
set primary CID. More... | |
void | SetRangStatus (uint8_t rangStatus) |
set the range status. More... | |
void | SetRangSubchnl (uint8_t rangSubchnl) |
set range sub channel. More... | |
void | SetTimingAdjust (uint32_t timingAdjust) |
set the Tx timing offset adjustment (signed 32-bit). More... | |
void | SetUlChnlIdOverride (uint8_t ulChnlIdOverride) |
set the identifier of the uplink channel with which the SS is to redo initial ranging More... | |
Public Member Functions inherited from ns3::Header | |
virtual | ~Header () |
virtual uint32_t | Deserialize (Buffer::Iterator start)=0 |
Deserialize the object from a buffer iterator. More... | |
virtual uint32_t | Deserialize (Buffer::Iterator start, Buffer::Iterator end) |
Deserialize the object from a buffer iterator. More... | |
Public Member Functions inherited from ns3::Chunk | |
virtual uint32_t | Deserialize (Buffer::Iterator start, Buffer::Iterator end) |
Deserialize the object from a buffer iterator. 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) |
Register this type. More... | |
Static Public Member Functions inherited from ns3::Header | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Chunk | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Private Attributes | |
uint8_t | m_aasBdcastPermission |
AAS broadcast permission. More... | |
Cid | m_basicCid |
basic CID More... | |
uint32_t | m_dlFreqOverride |
Center frequency, in kHz, of new downlink channel where the SS should redo initial ranging. More... | |
uint16_t | m_dlOperBurstProfile |
This parameter is sent in response to the RNG-REQ Requested Downlink Burst Profile parameter. More... | |
uint32_t | m_frameNumber |
Frame number where the associated RNG_REQ message was detected by the BS. More... | |
uint8_t | m_initRangOppNumber |
Initial Ranging opportunity (1–255) in which the associated RNG_REQ message was detected by the BS. More... | |
Mac48Address | m_macAddress |
MAC address. More... | |
uint32_t | m_offsetFreqAdjust |
Specifies the relative change in transmission frequency that the SS is to make in order to better match the BS. More... | |
uint8_t | m_powerLevelAdjust |
Specifies the relative change in transmission power level that the SS is to make in order that transmissions arrive at the BS at the desired power. More... | |
Cid | m_primaryCid |
primary CID More... | |
uint8_t | m_rangStatus |
range status. More... | |
uint8_t | m_rangSubchnl |
Used to indicate the OFDM subchannel reference that was used to transmit the initial ranging message (OFDM with subchannelization). More... | |
uint8_t | m_reserved |
changed as per the amendment 802.16e-2005 More... | |
uint32_t | m_timingAdjust |
Tx timing offset adjustment (signed 32-bit). More... | |
uint8_t | m_ulChnlIdOverride |
Licensed bands: The identifier of the uplink channel with which the SS is to redo initial ranging (not used with PHYs without channelized uplinks). More... | |
Additional Inherited Members | |
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 implements the ranging response message described by "IEEE Standard for Local and metropolitan area networks Part 16: Air Interface for Fixed Broadband Wireless Access Systems" 6.3.2.3.6 Ranging response (RNG-RSP) message, page 50.
Introspection did not find any typical Config paths.
No Attributes are defined for this type.
No TraceSources are defined for this type.
Size of this type is 56 bytes (on a 64-bit architecture).
Definition at line 121 of file mac-messages.h.
ns3::RngRsp::RngRsp | ( | void | ) |
Definition at line 234 of file mac-messages.cc.
|
virtual |
Definition at line 253 of file mac-messages.cc.
|
virtual |
start | an iterator which points to where the header should read from. |
This method is used by Packet::RemoveHeader to re-create a header from the byte buffer of a packet. The data read is expected to match bit-for-bit the representation of this header in real networks.
Note that data is not actually removed from the buffer to which the iterator points. Both Packet::RemoveHeader() and Packet::PeekHeader() call Deserialize(), but only the RemoveHeader() has additional statements to remove the header bytes from the underlying buffer and associated metadata.
Implements ns3::Header.
Definition at line 489 of file mac-messages.cc.
References ns3::Buffer::Iterator::GetDistanceFrom(), m_aasBdcastPermission, m_basicCid, m_dlFreqOverride, m_dlOperBurstProfile, m_frameNumber, m_initRangOppNumber, m_macAddress, m_offsetFreqAdjust, m_powerLevelAdjust, m_primaryCid, m_rangStatus, m_rangSubchnl, m_reserved, m_timingAdjust, m_ulChnlIdOverride, ns3::ReadFrom(), ns3::Buffer::Iterator::ReadU16(), ns3::Buffer::Iterator::ReadU32(), ns3::Buffer::Iterator::ReadU8(), and visualizer.core::start().
uint8_t ns3::RngRsp::GetAasBdcastPermission | ( | void | ) | const |
Definition at line 402 of file mac-messages.cc.
References m_aasBdcastPermission.
Cid ns3::RngRsp::GetBasicCid | ( | void | ) | const |
Definition at line 390 of file mac-messages.cc.
References m_basicCid.
Referenced by ns3::SSLinkManager::PerformRanging().
uint32_t ns3::RngRsp::GetDlFreqOverride | ( | void | ) | const |
Definition at line 366 of file mac-messages.cc.
References m_dlFreqOverride.
Referenced by ns3::SSLinkManager::PerformRanging().
uint16_t ns3::RngRsp::GetDlOperBurstProfile | ( | void | ) | const |
Definition at line 378 of file mac-messages.cc.
References m_dlOperBurstProfile.
uint32_t ns3::RngRsp::GetFrameNumber | ( | void | ) | const |
Definition at line 408 of file mac-messages.cc.
References m_frameNumber.
Referenced by ns3::SSLinkManager::PerformRanging().
uint8_t ns3::RngRsp::GetInitRangOppNumber | ( | void | ) | const |
Definition at line 414 of file mac-messages.cc.
References m_initRangOppNumber.
Referenced by ns3::SSLinkManager::PerformRanging().
|
virtual |
Get the most derived TypeId for this Object.
This method is typically implemented by ns3::Object::GetInstanceTypeId but some classes which derive from ns3::ObjectBase directly have to implement it themselves.
Implements ns3::ObjectBase.
Definition at line 443 of file mac-messages.cc.
References GetTypeId().
Mac48Address ns3::RngRsp::GetMacAddress | ( | void | ) | const |
Definition at line 384 of file mac-messages.cc.
References m_macAddress.
Referenced by ns3::SSLinkManager::PerformRanging().
std::string ns3::RngRsp::GetName | ( | void | ) | const |
Definition at line 426 of file mac-messages.cc.
uint32_t ns3::RngRsp::GetOffsetFreqAdjust | ( | void | ) | const |
Definition at line 354 of file mac-messages.cc.
References m_offsetFreqAdjust.
Referenced by ns3::SSLinkManager::AdjustRangingParameters().
uint8_t ns3::RngRsp::GetPowerLevelAdjust | ( | void | ) | const |
Definition at line 348 of file mac-messages.cc.
References m_powerLevelAdjust.
Referenced by ns3::SSLinkManager::AdjustRangingParameters().
Cid ns3::RngRsp::GetPrimaryCid | ( | void | ) | const |
Definition at line 396 of file mac-messages.cc.
References m_primaryCid.
Referenced by ns3::SSLinkManager::PerformRanging().
uint8_t ns3::RngRsp::GetRangStatus | ( | void | ) | const |
Definition at line 360 of file mac-messages.cc.
References m_rangStatus.
Referenced by ns3::SSLinkManager::PerformRanging(), and ns3::BSLinkManager::ScheduleRngRspMessage().
uint8_t ns3::RngRsp::GetRangSubchnl | ( | void | ) | const |
|
virtual |
This method is used by Packet::AddHeader to store a header into the byte buffer of a packet. This method should return the number of bytes which are needed to store the full header data by Serialize.
Implements ns3::Header.
Definition at line 462 of file mac-messages.cc.
uint32_t ns3::RngRsp::GetTimingAdjust | ( | void | ) | const |
Definition at line 342 of file mac-messages.cc.
References m_timingAdjust.
Referenced by ns3::SSLinkManager::AdjustRangingParameters().
|
static |
Register this type.
Definition at line 432 of file mac-messages.cc.
References ns3::TypeId::SetParent().
Referenced by GetInstanceTypeId().
uint8_t ns3::RngRsp::GetUlChnlIdOverride | ( | void | ) | const |
Definition at line 372 of file mac-messages.cc.
References m_ulChnlIdOverride.
|
virtual |
os | output stream This method is used by Packet::Print to print the content of a header as ascii data to a c++ output stream. Although the header is free to format its output as it wishes, it is recommended to follow a few rules to integrate with the packet pretty printer: start with flags, small field values located between a pair of parens. Values should be separated by whitespace. Follow the parens with the important fields, separated by whitespace. i.e.: (field1 val1 field2 val2 field3 val3) field4 val4 field5 val5 |
Implements ns3::Header.
Definition at line 449 of file mac-messages.cc.
References m_aasBdcastPermission, m_basicCid, m_dlFreqOverride, m_dlOperBurstProfile, m_frameNumber, m_initRangOppNumber, m_macAddress, m_offsetFreqAdjust, m_powerLevelAdjust, m_primaryCid, m_rangStatus, m_rangSubchnl, m_timingAdjust, and m_ulChnlIdOverride.
|
virtual |
start | an iterator which points to where the header should be written. |
This method is used by Packet::AddHeader to store a header into the byte buffer of a packet. The data written is expected to match bit-for-bit the representation of this header in a real network.
Implements ns3::Header.
Definition at line 468 of file mac-messages.cc.
References ns3::Cid::GetIdentifier(), m_aasBdcastPermission, m_basicCid, m_dlFreqOverride, m_dlOperBurstProfile, m_frameNumber, m_initRangOppNumber, m_macAddress, m_offsetFreqAdjust, m_powerLevelAdjust, m_primaryCid, m_rangStatus, m_rangSubchnl, m_reserved, m_timingAdjust, m_ulChnlIdOverride, visualizer.core::start(), ns3::WriteTo(), ns3::Buffer::Iterator::WriteU16(), ns3::Buffer::Iterator::WriteU32(), and ns3::Buffer::Iterator::WriteU8().
void ns3::RngRsp::SetAasBdcastPermission | ( | uint8_t | aasBdcastPermission | ) |
set AAS broadcast permission.
aasBdcastPermission |
Definition at line 318 of file mac-messages.cc.
References m_aasBdcastPermission.
void ns3::RngRsp::SetBasicCid | ( | Cid | basicCid | ) |
set basic CID.
basicCid |
Definition at line 306 of file mac-messages.cc.
References m_basicCid.
Referenced by ns3::ConnectionManager::AllocateManagementConnections().
void ns3::RngRsp::SetDlFreqOverride | ( | uint32_t | dlFreqOverride | ) |
set the Center frequency, in kHz, of new downlink channel where the SS should redo initial ranging.
dlFreqOverride | the Center frequency in kHz |
Definition at line 282 of file mac-messages.cc.
References m_dlFreqOverride.
Referenced by ns3::BSLinkManager::PerformInitialRanging().
void ns3::RngRsp::SetDlOperBurstProfile | ( | uint16_t | dlOperBurstProfile | ) |
set the DL oper burst profile
dlOperBurstProfile | the oper burt profile |
Definition at line 294 of file mac-messages.cc.
References m_dlOperBurstProfile.
Referenced by ns3::BSLinkManager::PerformInitialRanging().
void ns3::RngRsp::SetFrameNumber | ( | uint32_t | frameNumber | ) |
set frame number.
frameNumber |
Definition at line 324 of file mac-messages.cc.
References m_frameNumber.
Referenced by ns3::BSLinkManager::PerformRanging().
void ns3::RngRsp::SetInitRangOppNumber | ( | uint8_t | initRangOppNumber | ) |
set initial range opp number.
initRangOppNumber |
Definition at line 330 of file mac-messages.cc.
References m_initRangOppNumber.
Referenced by ns3::BSLinkManager::PerformRanging().
void ns3::RngRsp::SetMacAddress | ( | Mac48Address | macAddress | ) |
set the MAC address
macAddress | the MAC address |
Definition at line 300 of file mac-messages.cc.
References m_macAddress.
Referenced by ns3::BSLinkManager::PerformInitialRanging().
void ns3::RngRsp::SetOffsetFreqAdjust | ( | uint32_t | offsetFreqAdjust | ) |
set the relative change in transmission frequency that the SS should take in order to better match the BS.
This is fine-frequency adjustment within a channel, not reassignment to a different channel
offsetFreqAdjust |
Definition at line 270 of file mac-messages.cc.
References m_offsetFreqAdjust.
Referenced by ns3::BSLinkManager::SetParametersToAdjust().
void ns3::RngRsp::SetPowerLevelAdjust | ( | uint8_t | powerLevelAdjust | ) |
set the relative change in transmission power level that the SS should make in order that transmissions arrive at the BS at the desired power.
When subchannelization is employed, the subscriber shall interpret the power offset adjustment as a required change to the transmitted power density.
powerLevelAdjust | the relative change in transmission power level |
Definition at line 264 of file mac-messages.cc.
References m_powerLevelAdjust.
Referenced by ns3::BSLinkManager::SetParametersToAdjust().
void ns3::RngRsp::SetPrimaryCid | ( | Cid | primaryCid | ) |
set primary CID.
primaryCid |
Definition at line 312 of file mac-messages.cc.
References m_primaryCid.
Referenced by ns3::ConnectionManager::AllocateManagementConnections().
void ns3::RngRsp::SetRangStatus | ( | uint8_t | rangStatus | ) |
set the range status.
rangStatus |
Definition at line 276 of file mac-messages.cc.
References m_rangStatus.
Referenced by ns3::BSLinkManager::AbortRanging(), ns3::BSLinkManager::AcceptRanging(), ns3::BSLinkManager::ContinueRanging(), and ns3::BSLinkManager::PerformRanging().
void ns3::RngRsp::SetRangSubchnl | ( | uint8_t | rangSubchnl | ) |
set range sub channel.
rangSubchnl |
Definition at line 336 of file mac-messages.cc.
References m_rangSubchnl.
void ns3::RngRsp::SetTimingAdjust | ( | uint32_t | timingAdjust | ) |
set the Tx timing offset adjustment (signed 32-bit).
timingAdjust | The time required to advance SS transmission so frames arrive at the expected time instance at the BS. |
Definition at line 258 of file mac-messages.cc.
References m_timingAdjust.
Referenced by ns3::BSLinkManager::SetParametersToAdjust().
void ns3::RngRsp::SetUlChnlIdOverride | ( | uint8_t | ulChnlIdOverride | ) |
set the identifier of the uplink channel with which the SS is to redo initial ranging
ulChnlIdOverride | the uplink channel index |
Definition at line 288 of file mac-messages.cc.
References m_ulChnlIdOverride.
|
private |
AAS broadcast permission.
Definition at line 328 of file mac-messages.h.
Referenced by Deserialize(), GetAasBdcastPermission(), Print(), Serialize(), and SetAasBdcastPermission().
|
private |
basic CID
Definition at line 326 of file mac-messages.h.
Referenced by Deserialize(), GetBasicCid(), Print(), Serialize(), and SetBasicCid().
|
private |
Center frequency, in kHz, of new downlink channel where the SS should redo initial ranging.
Definition at line 310 of file mac-messages.h.
Referenced by Deserialize(), GetDlFreqOverride(), Print(), Serialize(), and SetDlFreqOverride().
|
private |
This parameter is sent in response to the RNG-REQ Requested Downlink Burst Profile parameter.
Byte 0: Specifies the least robust DIUC that may be used by the BS for transmissions to the SS. Byte 1: Configuration Change Count value of DCD defining the burst profile associated with DIUC.
Definition at line 323 of file mac-messages.h.
Referenced by Deserialize(), GetDlOperBurstProfile(), Print(), Serialize(), and SetDlOperBurstProfile().
|
private |
Frame number where the associated RNG_REQ message was detected by the BS.
Usage is mutually exclusive with SS MAC Address
Definition at line 334 of file mac-messages.h.
Referenced by Deserialize(), GetFrameNumber(), Print(), Serialize(), and SetFrameNumber().
|
private |
Initial Ranging opportunity (1–255) in which the associated RNG_REQ message was detected by the BS.
Usage is mutually exclusive with SS MAC Address
Definition at line 340 of file mac-messages.h.
Referenced by Deserialize(), GetInitRangOppNumber(), Print(), Serialize(), and SetInitRangOppNumber().
|
private |
MAC address.
Definition at line 325 of file mac-messages.h.
Referenced by Deserialize(), GetMacAddress(), Print(), Serialize(), and SetMacAddress().
|
private |
Specifies the relative change in transmission frequency that the SS is to make in order to better match the BS.
This is fine-frequency adjustment within a channel, not reassignment to a different channel.
Definition at line 302 of file mac-messages.h.
Referenced by Deserialize(), GetOffsetFreqAdjust(), Print(), Serialize(), and SetOffsetFreqAdjust().
|
private |
Specifies the relative change in transmission power level that the SS is to make in order that transmissions arrive at the BS at the desired power.
When subchannelization is employed, the subscriber shall interpret the power offset adjustment as a required change to the transmitted power density.
Definition at line 296 of file mac-messages.h.
Referenced by Deserialize(), GetPowerLevelAdjust(), Print(), Serialize(), and SetPowerLevelAdjust().
|
private |
primary CID
Definition at line 327 of file mac-messages.h.
Referenced by Deserialize(), GetPrimaryCid(), Print(), Serialize(), and SetPrimaryCid().
|
private |
range status.
Definition at line 307 of file mac-messages.h.
Referenced by Deserialize(), GetRangStatus(), Print(), Serialize(), and SetRangStatus().
|
private |
Used to indicate the OFDM subchannel reference that was used to transmit the initial ranging message (OFDM with subchannelization).
Definition at line 346 of file mac-messages.h.
Referenced by Deserialize(), GetRangSubchnl(), Print(), Serialize(), and SetRangSubchnl().
|
private |
changed as per the amendment 802.16e-2005
Definition at line 280 of file mac-messages.h.
Referenced by Deserialize(), and Serialize().
|
private |
Tx timing offset adjustment (signed 32-bit).
The time required to advance SS transmission so frames arrive at the expected time instance at the BS.
Definition at line 288 of file mac-messages.h.
Referenced by Deserialize(), GetTimingAdjust(), Print(), Serialize(), and SetTimingAdjust().
|
private |
Licensed bands: The identifier of the uplink channel with which the SS is to redo initial ranging (not used with PHYs without channelized uplinks).
Definition at line 316 of file mac-messages.h.
Referenced by Deserialize(), GetUlChnlIdOverride(), Print(), Serialize(), and SetUlChnlIdOverride().