Headers for BlockAck response. More...
#include "ctrl-headers.h"
Public Member Functions | |
CtrlBAckResponseHeader () | |
~CtrlBAckResponseHeader () | |
uint32_t | Deserialize (Buffer::Iterator start) |
const uint16_t * | GetBitmap (void) const |
Return the bitmap from the BlockAck response header. More... | |
uint64_t | GetCompressedBitmap (void) const |
Return the compressed bitmap from the BlockAck response header. More... | |
const uint64_t * | GetExtendedCompressedBitmap (void) const |
Return the extended compressed bitmap from the BlockAck response header. More... | |
TypeId | GetInstanceTypeId (void) const |
Get the most derived TypeId for this Object. More... | |
uint32_t | GetSerializedSize (void) const |
uint16_t | GetStartingSequence (void) const |
Return the starting sequence number. More... | |
uint16_t | GetStartingSequenceControl (void) const |
Return the starting sequence control. More... | |
uint8_t | GetTidInfo (void) const |
Return the Traffic ID (TID). More... | |
BlockAckType | GetType (void) const |
Return the block ack type ID. More... | |
bool | IsBasic (void) const |
Check if the current BA policy is Basic Block Ack. More... | |
bool | IsCompressed (void) const |
Check if the current BA policy is Compressed Block Ack. More... | |
bool | IsExtendedCompressed (void) const |
Check if the current BA policy is Extended Compressed Block Ack. More... | |
bool | IsFragmentReceived (uint16_t seq, uint8_t frag) const |
Check if the packet with the given sequence number and fragment number was acknowledged in this BlockAck response. More... | |
bool | IsMultiTid (void) const |
Check if the current BA policy is Multi-TID Block Ack. More... | |
bool | IsPacketReceived (uint16_t seq) const |
Check if the packet with the given sequence number was acknowledged in this BlockAck response. More... | |
bool | MustSendHtImmediateAck (void) const |
Check if the current Ack Policy is immediate. More... | |
void | Print (std::ostream &os) const |
void | ResetBitmap (void) |
Reset the bitmap to 0. More... | |
void | Serialize (Buffer::Iterator start) const |
void | SetHtImmediateAck (bool immediateAck) |
Enable or disable HT immediate Ack. More... | |
void | SetReceivedFragment (uint16_t seq, uint8_t frag) |
Set the bitmap that the packet with the given sequence number and fragment number was received. More... | |
void | SetReceivedPacket (uint16_t seq) |
Set the bitmap that the packet with the given sequence number was received. More... | |
void | SetStartingSequence (uint16_t seq) |
Set the starting sequence number from the given raw sequence control field. More... | |
void | SetStartingSequenceControl (uint16_t seqControl) |
Set the starting sequence control with the given sequence control value. More... | |
void | SetTidInfo (uint8_t tid) |
Set Traffic ID (TID). More... | |
void | SetType (BlockAckType type) |
Set the block ack type. More... | |
![]() | |
virtual | ~Header () |
virtual uint32_t | Deserialize (Buffer::Iterator start, Buffer::Iterator end) |
Deserialize the object from a buffer iterator. More... | |
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... | |
![]() | |
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 TypeId | GetTypeId (void) |
Get the type ID. More... | |
![]() | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
![]() | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Private Member Functions | |
Buffer::Iterator | DeserializeBitmap (Buffer::Iterator start) |
Deserialize bitmap from the given buffer. More... | |
uint16_t | GetBaControl (void) const |
Return the Block Ack control. More... | |
uint16_t | IndexInBitmap (uint16_t seq) const |
This function is used to correctly index in both bitmap and compressed bitmap, one bit or one block of 16 bits respectively. More... | |
bool | IsInBitmap (uint16_t seq) const |
Checks if sequence number seq can be acknowledged in the bitmap. More... | |
Buffer::Iterator | SerializeBitmap (Buffer::Iterator start) const |
Serialize bitmap to the given buffer. More... | |
void | SetBaControl (uint16_t ba) |
Set the Block Ack control. More... | |
Private Attributes | |
union { | |
uint16_t m_bitmap [64] | |
the basic BlockAck bitmap More... | |
uint64_t m_compressedBitmap | |
the compressed BlockAck bitmap More... | |
uint64_t m_extendedCompressedBitmap [4] | |
the extended compressed BlockAck bitmap More... | |
} | bitmap |
bitmap union type More... | |
bool | m_baAckPolicy |
The LSB bit of the BA control field is used only for the HT (High Throughput) delayed block ack configuration. More... | |
BlockAckType | m_baType |
BA type. More... | |
uint16_t | m_startingSeq |
starting sequence number More... | |
uint16_t | m_tidInfo |
TID info. More... | |
Additional Inherited Members | |
![]() | |
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... | |
![]() | |
static TypeId | GetObjectIid (void) |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
Headers for BlockAck response.
Introspection did not find any typical Config paths.
802.11n standard includes three types of BlockAck:
No Attributes are defined for this type.
No TraceSources are defined for this type.
Size of this type is 152 bytes (on a 64-bit architecture).
Definition at line 193 of file ctrl-headers.h.
ns3::CtrlBAckResponseHeader::CtrlBAckResponseHeader | ( | ) |
Definition at line 270 of file ctrl-headers.cc.
References bitmap.
ns3::CtrlBAckResponseHeader::~CtrlBAckResponseHeader | ( | ) |
Definition at line 277 of file ctrl-headers.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 353 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, DeserializeBitmap(), ns3::EXTENDED_COMPRESSED_BLOCK_ACK, ns3::Buffer::Iterator::GetDistanceFrom(), m_baType, ns3::MULTI_TID_BLOCK_ACK, NS_FATAL_ERROR, ns3::Buffer::Iterator::ReadLsbtohU16(), SetBaControl(), SetStartingSequenceControl(), and visualizer.core::start().
|
private |
Deserialize bitmap from the given buffer.
start | the iterator |
Definition at line 544 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, bitmap, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baType, ns3::MULTI_TID_BLOCK_ACK, NS_FATAL_ERROR, ns3::Buffer::Iterator::ReadLsbtohU16(), ns3::Buffer::Iterator::ReadLsbtohU64(), and visualizer.core::start().
Referenced by Deserialize().
|
private |
Return the Block Ack control.
Definition at line 449 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baAckPolicy, m_baType, m_tidInfo, ns3::MULTI_TID_BLOCK_ACK, and NS_FATAL_ERROR.
Referenced by Serialize().
const uint16_t * ns3::CtrlBAckResponseHeader::GetBitmap | ( | void | ) | const |
Return the bitmap from the BlockAck response header.
Definition at line 762 of file ctrl-headers.cc.
References bitmap.
uint64_t ns3::CtrlBAckResponseHeader::GetCompressedBitmap | ( | void | ) | const |
Return the compressed bitmap from the BlockAck response header.
Definition at line 768 of file ctrl-headers.cc.
References bitmap.
Referenced by CtrlBAckResponseHeaderTest::DoRun().
const uint64_t * ns3::CtrlBAckResponseHeader::GetExtendedCompressedBitmap | ( | void | ) | const |
Return the extended compressed bitmap from the BlockAck response header.
Definition at line 774 of file ctrl-headers.cc.
References bitmap.
|
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 293 of file ctrl-headers.cc.
References GetTypeId().
|
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 305 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baType, m_tidInfo, ns3::MULTI_TID_BLOCK_ACK, and NS_FATAL_ERROR.
Referenced by ns3::GetBlockAckSize().
uint16_t ns3::CtrlBAckResponseHeader::GetStartingSequence | ( | void | ) | const |
Return the starting sequence number.
Definition at line 419 of file ctrl-headers.cc.
References m_startingSeq.
Referenced by ns3::BlockAckCache::FillBlockAckBitmap().
uint16_t ns3::CtrlBAckResponseHeader::GetStartingSequenceControl | ( | void | ) | const |
Return the starting sequence control.
Definition at line 501 of file ctrl-headers.cc.
References m_startingSeq.
Referenced by Serialize().
uint8_t ns3::CtrlBAckResponseHeader::GetTidInfo | ( | void | ) | const |
Return the Traffic ID (TID).
Definition at line 412 of file ctrl-headers.cc.
References m_tidInfo.
Referenced by ns3::GetTid(), ns3::QosTxop::NeedBarRetransmission(), and ns3::BlockAckManager::NotifyGotBlockAck().
BlockAckType ns3::CtrlBAckResponseHeader::GetType | ( | void | ) | const |
Return the block ack type ID.
Definition at line 388 of file ctrl-headers.cc.
References m_baType.
Referenced by ns3::MacLow::SendBlockAckResponse().
|
static |
Get the type ID.
Definition at line 282 of file ctrl-headers.cc.
References ns3::TypeId::SetParent().
Referenced by GetInstanceTypeId().
|
private |
This function is used to correctly index in both bitmap and compressed bitmap, one bit or one block of 16 bits respectively.
for more details see 7.2.1.8 in IEEE 802.11n/D4.00
seq | the sequence number |
Definition at line 726 of file ctrl-headers.cc.
References ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baType, m_startingSeq, and NS_ASSERT.
Referenced by IsFragmentReceived(), IsPacketReceived(), SetReceivedFragment(), and SetReceivedPacket().
bool ns3::CtrlBAckResponseHeader::IsBasic | ( | void | ) | const |
Check if the current BA policy is Basic Block Ack.
Definition at line 425 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, and m_baType.
Referenced by ns3::BlockAckCache::FillBlockAckBitmap(), and ns3::BlockAckManager::NotifyGotBlockAck().
bool ns3::CtrlBAckResponseHeader::IsCompressed | ( | void | ) | const |
Check if the current BA policy is Compressed Block Ack.
Definition at line 431 of file ctrl-headers.cc.
References ns3::COMPRESSED_BLOCK_ACK, and m_baType.
Referenced by ns3::BlockAckCache::FillBlockAckBitmap(), and ns3::BlockAckManager::NotifyGotBlockAck().
bool ns3::CtrlBAckResponseHeader::IsExtendedCompressed | ( | void | ) | const |
Check if the current BA policy is Extended Compressed Block Ack.
Definition at line 437 of file ctrl-headers.cc.
References ns3::EXTENDED_COMPRESSED_BLOCK_ACK, and m_baType.
Referenced by ns3::BlockAckCache::FillBlockAckBitmap(), and ns3::BlockAckManager::NotifyGotBlockAck().
bool ns3::CtrlBAckResponseHeader::IsFragmentReceived | ( | uint16_t | seq, |
uint8_t | frag | ||
) | const |
Check if the packet with the given sequence number and fragment number was acknowledged in this BlockAck response.
seq | the sequence number |
frag | the fragment number |
Definition at line 684 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, bitmap, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, IndexInBitmap(), IsInBitmap(), m_baType, ns3::MULTI_TID_BLOCK_ACK, NS_ASSERT, and NS_FATAL_ERROR.
Referenced by ns3::BlockAckManager::NotifyGotBlockAck().
|
private |
Checks if sequence number seq can be acknowledged in the bitmap.
seq | the sequence number |
Definition at line 749 of file ctrl-headers.cc.
References ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baType, and m_startingSeq.
Referenced by IsFragmentReceived(), IsPacketReceived(), SetReceivedFragment(), and SetReceivedPacket().
bool ns3::CtrlBAckResponseHeader::IsMultiTid | ( | void | ) | const |
Check if the current BA policy is Multi-TID Block Ack.
Definition at line 443 of file ctrl-headers.cc.
References m_baType, and ns3::MULTI_TID_BLOCK_ACK.
Referenced by ns3::BlockAckCache::FillBlockAckBitmap(), and ns3::BlockAckManager::NotifyGotBlockAck().
bool ns3::CtrlBAckResponseHeader::IsPacketReceived | ( | uint16_t | seq | ) | const |
Check if the packet with the given sequence number was acknowledged in this BlockAck response.
seq | the sequence number |
Definition at line 642 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, bitmap, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, IndexInBitmap(), IsInBitmap(), m_baType, ns3::MULTI_TID_BLOCK_ACK, and NS_FATAL_ERROR.
Referenced by CtrlBAckResponseHeaderTest::DoRun(), and ns3::BlockAckManager::NotifyGotBlockAck().
bool ns3::CtrlBAckResponseHeader::MustSendHtImmediateAck | ( | void | ) | const |
Check if the current Ack Policy is immediate.
Definition at line 406 of file ctrl-headers.cc.
References m_baAckPolicy.
|
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 299 of file ctrl-headers.cc.
References m_startingSeq, and m_tidInfo.
void ns3::CtrlBAckResponseHeader::ResetBitmap | ( | void | ) |
Reset the bitmap to 0.
Definition at line 780 of file ctrl-headers.cc.
References bitmap.
Referenced by CtrlBAckResponseHeaderTest::DoRun().
|
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 331 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, GetBaControl(), GetStartingSequenceControl(), m_baType, ns3::MULTI_TID_BLOCK_ACK, NS_FATAL_ERROR, SerializeBitmap(), visualizer.core::start(), and ns3::Buffer::Iterator::WriteHtolsbU16().
|
private |
Serialize bitmap to the given buffer.
start | the iterator |
Definition at line 513 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, bitmap, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baType, ns3::MULTI_TID_BLOCK_ACK, NS_FATAL_ERROR, visualizer.core::start(), ns3::Buffer::Iterator::WriteHtolsbU16(), and ns3::Buffer::Iterator::WriteHtolsbU64().
Referenced by Serialize().
|
private |
Set the Block Ack control.
ba | the BA control to set |
Definition at line 478 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, m_baAckPolicy, m_baType, m_tidInfo, and ns3::MULTI_TID_BLOCK_ACK.
Referenced by Deserialize().
void ns3::CtrlBAckResponseHeader::SetHtImmediateAck | ( | bool | immediateAck | ) |
Enable or disable HT immediate Ack.
immediateAck | enable or disable HT immediate Ack |
Definition at line 376 of file ctrl-headers.cc.
References m_baAckPolicy.
void ns3::CtrlBAckResponseHeader::SetReceivedFragment | ( | uint16_t | seq, |
uint8_t | frag | ||
) |
Set the bitmap that the packet with the given sequence number and fragment number was received.
seq | the sequence number |
frag | the fragment number |
Definition at line 615 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, bitmap, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, IndexInBitmap(), IsInBitmap(), m_baType, ns3::MULTI_TID_BLOCK_ACK, NS_ASSERT, and NS_FATAL_ERROR.
void ns3::CtrlBAckResponseHeader::SetReceivedPacket | ( | uint16_t | seq | ) |
Set the bitmap that the packet with the given sequence number was received.
seq | the sequence number |
Definition at line 575 of file ctrl-headers.cc.
References ns3::BASIC_BLOCK_ACK, bitmap, ns3::COMPRESSED_BLOCK_ACK, ns3::EXTENDED_COMPRESSED_BLOCK_ACK, IndexInBitmap(), IsInBitmap(), m_baType, ns3::MULTI_TID_BLOCK_ACK, and NS_FATAL_ERROR.
Referenced by CtrlBAckResponseHeaderTest::DoRun(), and ns3::BlockAckCache::FillBlockAckBitmap().
void ns3::CtrlBAckResponseHeader::SetStartingSequence | ( | uint16_t | seq | ) |
Set the starting sequence number from the given raw sequence control field.
seq | the raw sequence control |
Definition at line 400 of file ctrl-headers.cc.
References m_startingSeq.
Referenced by CtrlBAckResponseHeaderTest::DoRun(), and ns3::MacLow::SendBlockAckAfterBlockAckRequest().
void ns3::CtrlBAckResponseHeader::SetStartingSequenceControl | ( | uint16_t | seqControl | ) |
Set the starting sequence control with the given sequence control value.
seqControl | the raw sequence control value |
Definition at line 507 of file ctrl-headers.cc.
References m_startingSeq.
Referenced by Deserialize().
void ns3::CtrlBAckResponseHeader::SetTidInfo | ( | uint8_t | tid | ) |
Set Traffic ID (TID).
tid | the TID |
Definition at line 394 of file ctrl-headers.cc.
References m_tidInfo.
Referenced by ns3::MacLow::SendBlockAckAfterBlockAckRequest().
void ns3::CtrlBAckResponseHeader::SetType | ( | BlockAckType | type | ) |
Set the block ack type.
type | the BA type |
Definition at line 382 of file ctrl-headers.cc.
References m_baType.
Referenced by CtrlBAckResponseHeaderTest::DoRun(), ns3::GetBlockAckSize(), and ns3::MacLow::SendBlockAckAfterBlockAckRequest().
union { ... } ns3::CtrlBAckResponseHeader::bitmap |
bitmap union type
Referenced by CtrlBAckResponseHeader(), DeserializeBitmap(), GetBitmap(), GetCompressedBitmap(), GetExtendedCompressedBitmap(), IsFragmentReceived(), IsPacketReceived(), ResetBitmap(), SerializeBitmap(), SetReceivedFragment(), and SetReceivedPacket().
|
private |
The LSB bit of the BA control field is used only for the HT (High Throughput) delayed block ack configuration.
For now only non HT immediate block ack is implemented so this field is here only for a future implementation of HT delayed variant.BA Ack Policy
Definition at line 423 of file ctrl-headers.h.
Referenced by GetBaControl(), MustSendHtImmediateAck(), SetBaControl(), and SetHtImmediateAck().
|
private |
BA type.
Definition at line 424 of file ctrl-headers.h.
Referenced by Deserialize(), DeserializeBitmap(), GetBaControl(), GetSerializedSize(), GetType(), IndexInBitmap(), IsBasic(), IsCompressed(), IsExtendedCompressed(), IsFragmentReceived(), IsInBitmap(), IsMultiTid(), IsPacketReceived(), Serialize(), SerializeBitmap(), SetBaControl(), SetReceivedFragment(), SetReceivedPacket(), and SetType().
uint16_t ns3::CtrlBAckResponseHeader::m_bitmap[64] |
the basic BlockAck bitmap
Definition at line 430 of file ctrl-headers.h.
uint64_t ns3::CtrlBAckResponseHeader::m_compressedBitmap |
the compressed BlockAck bitmap
Definition at line 431 of file ctrl-headers.h.
uint64_t ns3::CtrlBAckResponseHeader::m_extendedCompressedBitmap[4] |
the extended compressed BlockAck bitmap
Definition at line 432 of file ctrl-headers.h.
|
private |
starting sequence number
Definition at line 426 of file ctrl-headers.h.
Referenced by GetStartingSequence(), GetStartingSequenceControl(), IndexInBitmap(), IsInBitmap(), Print(), SetStartingSequence(), and SetStartingSequenceControl().
|
private |
TID info.
Definition at line 425 of file ctrl-headers.h.
Referenced by GetBaControl(), GetSerializedSize(), GetTidInfo(), Print(), SetBaControl(), and SetTidInfo().