block-ack-agreement.cc

Go to the documentation of this file.

/*
 * Copyright (c) 2009 MIRKO BANCHI
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * Author: Mirko Banchi <mk.banchi@gmail.com>
 */
 
#include "block-ack-agreement.h"
 
#include "wifi-utils.h"
 
#include "ns3/log.h"
 
#include <set>
 
namespace ns3
{
 
NS_LOG_COMPONENT_DEFINE("BlockAckAgreement");
 
BlockAckAgreement::BlockAckAgreement(Mac48Address peer, uint8_t tid)
    : m_peer(peer),
      m_amsduSupported(false),
      m_blockAckPolicy(1),
      m_tid(tid),
      m_htSupported(false),
      m_inactivityEvent()
{
    NS_LOG_FUNCTION(this << peer << +tid);
}
 
BlockAckAgreement::~BlockAckAgreement()
{
    NS_LOG_FUNCTION(this);
    m_inactivityEvent.Cancel();
}
 
void
BlockAckAgreement::SetBufferSize(uint16_t bufferSize)
{
    NS_LOG_FUNCTION(this << bufferSize);
    m_bufferSize = bufferSize;
}
 
void
BlockAckAgreement::SetTimeout(uint16_t timeout)
{
    NS_LOG_FUNCTION(this << timeout);
    m_timeout = timeout;
}
 
void
BlockAckAgreement::SetStartingSequence(uint16_t seq)
{
    NS_LOG_FUNCTION(this << seq);
    NS_ASSERT(seq < 4096);
    m_startingSeq = seq;
}
 
void
BlockAckAgreement::SetStartingSequenceControl(uint16_t seq)
{
    NS_LOG_FUNCTION(this << seq);
    NS_ASSERT(((seq >> 4) & 0x0fff) < 4096);
    m_startingSeq = (seq >> 4) & 0x0fff;
}
 
void
BlockAckAgreement::SetImmediateBlockAck()
{
    NS_LOG_FUNCTION(this);
    m_blockAckPolicy = 1;
}
 
void
BlockAckAgreement::SetDelayedBlockAck()
{
    NS_LOG_FUNCTION(this);
    m_blockAckPolicy = 0;
}
 
void
BlockAckAgreement::SetAmsduSupport(bool supported)
{
    NS_LOG_FUNCTION(this << supported);
    m_amsduSupported = supported;
}
 
uint8_t
BlockAckAgreement::GetTid() const
{
    return m_tid;
}
 
Mac48Address
BlockAckAgreement::GetPeer() const
{
    NS_LOG_FUNCTION(this);
    return m_peer;
}
 
uint16_t
BlockAckAgreement::GetBufferSize() const
{
    return m_bufferSize;
}
 
uint16_t
BlockAckAgreement::GetTimeout() const
{
    return m_timeout;
}
 
uint16_t
BlockAckAgreement::GetStartingSequence() const
{
    return m_startingSeq;
}
 
uint16_t
BlockAckAgreement::GetStartingSequenceControl() const
{
    uint16_t seqControl = (m_startingSeq << 4) & 0xfff0;
    return seqControl;
}
 
bool
BlockAckAgreement::IsImmediateBlockAck() const
{
    return m_blockAckPolicy == 1;
}
 
bool
BlockAckAgreement::IsAmsduSupported() const
{
    return m_amsduSupported;
}
 
uint16_t
BlockAckAgreement::GetWinEnd() const
{
    return (GetStartingSequence() + GetBufferSize() - 1) % SEQNO_SPACE_SIZE;
}
 
void
BlockAckAgreement::SetHtSupported(bool htSupported)
{
    NS_LOG_FUNCTION(this << htSupported);
    m_htSupported = htSupported;
}
 
bool
BlockAckAgreement::IsHtSupported() const
{
    return m_htSupported;
}
 
BlockAckType
BlockAckAgreement::GetBlockAckType() const
{
    if (!m_htSupported)
    {
        return BlockAckType::BASIC;
    }
 
    std::set<uint16_t> lengths{64, 256, 512, 1024}; // bitmap lengths in bits
    // first bitmap length that is greater than or equal to the buffer size
    auto it = lengths.lower_bound(m_bufferSize);
    NS_ASSERT_MSG(it != lengths.cend(), "Buffer size too large: " << m_bufferSize);
    // Multi-TID Block Ack is not currently supported
    return {m_gcrGroupAddress ? BlockAckType::GCR : BlockAckType::COMPRESSED,
            {static_cast<uint8_t>(*it / 8)}};
}
 
BlockAckReqType
BlockAckAgreement::GetBlockAckReqType() const
{
    if (!m_htSupported)
    {
        return BlockAckReqType::BASIC;
    }
    // Multi-TID Block Ack Request is not currently supported
    return BlockAckReqType::COMPRESSED;
}
 
std::size_t
BlockAckAgreement::GetDistance(uint16_t seqNumber, uint16_t startingSeqNumber)
{
    NS_ASSERT(seqNumber < SEQNO_SPACE_SIZE && startingSeqNumber < SEQNO_SPACE_SIZE);
    return (seqNumber - startingSeqNumber + SEQNO_SPACE_SIZE) % SEQNO_SPACE_SIZE;
}
 
void
BlockAckAgreement::SetGcrGroupAddress(const Mac48Address& gcrGroupAddress)
{
    m_gcrGroupAddress = gcrGroupAddress;
}
 
const std::optional<Mac48Address>&
BlockAckAgreement::GetGcrGroupAddress() const
{
    return m_gcrGroupAddress;
}
 
} // namespace ns3