A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
TestAmpduReception Class Reference

A-MPDU reception test. More...

+ Inheritance diagram for TestAmpduReception:
+ Collaboration diagram for TestAmpduReception:

Public Member Functions

 TestAmpduReception ()
 
- Public Member Functions inherited from WifiPhyReceptionTest
 WifiPhyReceptionTest (std::string test_name)
 Constructor.
 
 ~WifiPhyReceptionTest () override=default
 Destructor.
 
- Public Member Functions inherited from ns3::TestCase
 TestCase (const TestCase &)=delete
 
virtual ~TestCase ()
 Destructor.
 
std::string GetName () const
 
TestCaseoperator= (const TestCase &)=delete
 

Private Member Functions

void CheckPhyState (WifiPhyState expectedState)
 Check the PHY state.
 
void CheckRxDroppedBitmapAmpdu1 (uint8_t expected)
 Check the RX dropped bitmap for A-MPDU 1.
 
void CheckRxDroppedBitmapAmpdu2 (uint8_t expected)
 Check the RX dropped bitmap for A-MPDU 2.
 
void CheckRxFailureBitmapAmpdu1 (uint8_t expected)
 Check the RX failure bitmap for A-MPDU 1.
 
void CheckRxFailureBitmapAmpdu2 (uint8_t expected)
 Check the RX failure bitmap for A-MPDU 2.
 
void CheckRxSuccessBitmapAmpdu1 (uint8_t expected)
 Check the RX success bitmap for A-MPDU 1.
 
void CheckRxSuccessBitmapAmpdu2 (uint8_t expected)
 Check the RX success bitmap for A-MPDU 2.
 
void DoRun () override
 Implementation to actually run this TestCase.
 
void DoSetup () override
 Implementation to do any local setup required for this TestCase.
 
void IncrementFailureBitmap (uint32_t size)
 Increment reception failure bitmap.
 
void IncrementSuccessBitmap (uint32_t size)
 Increment reception success bitmap.
 
void ResetBitmaps ()
 Reset bitmaps function.
 
void RxDropped (Ptr< const Packet > p, WifiPhyRxfailureReason reason)
 RX dropped function.
 
void RxFailure (Ptr< const WifiPsdu > psdu)
 RX failure function.
 
void RxSuccess (Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, WifiTxVector txVector, std::vector< bool > statusPerMpdu)
 RX success function.
 
void SendAmpduWithThreeMpdus (dBm_u rxPower, uint32_t referencePacketSize)
 Send A-MPDU with 3 MPDUs of different size (i-th MSDU will have 100 bytes more than (i-1)-th).
 

Private Attributes

uint8_t m_rxDroppedBitmapAmpdu1 {0}
 bitmap of dropped MPDUs in A-MPDU #1
 
uint8_t m_rxDroppedBitmapAmpdu2 {0}
 bitmap of dropped MPDUs in A-MPDU #2
 
uint8_t m_rxFailureBitmapAmpdu1 {0}
 bitmap of unsuccessfully received MPDUs in A-MPDU #1
 
uint8_t m_rxFailureBitmapAmpdu2 {0}
 bitmap of unsuccessfully received MPDUs in A-MPDU #2
 
uint8_t m_rxSuccessBitmapAmpdu1 {0}
 bitmap of successfully received MPDUs in A-MPDU #1
 
uint8_t m_rxSuccessBitmapAmpdu2 {0}
 bitmap of successfully received MPDUs in A-MPDU #2
 

Additional Inherited Members

- Public Types inherited from ns3::TestCase
enum class  Duration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
 How long the test takes to execute. More...
 
- Static Public Attributes inherited from ns3::TestCase
static constexpr auto QUICK = Duration::QUICK
 Deprecated test duration simple enums.
 
static constexpr auto EXTENSIVE = Duration::EXTENSIVE
 
static constexpr auto TAKES_FOREVER = Duration::TAKES_FOREVER
 
- Protected Member Functions inherited from WifiPhyReceptionTest
void CheckPhyState (WifiPhyState expectedState)
 Schedule now to check the PHY state.
 
void DoCheckPhyState (WifiPhyState expectedState)
 Check the PHY state now.
 
void DoSetup () override
 Implementation to do any local setup required for this TestCase.
 
void DoTeardown () override
 Implementation to do any local setup required for this TestCase.
 
void SendPacket (dBm_u rxPower, uint32_t packetSize, uint8_t mcs)
 Send packet function.
 
- Protected Member Functions inherited from ns3::TestCase
 TestCase (std::string name)
 Constructor.
 
void AddTestCase (TestCase *testCase, Duration duration=Duration::QUICK)
 Add an individual child TestCase to this test suite.
 
TestCaseGetParent () const
 Get the parent of this TestCase.
 
bool IsStatusFailure () const
 Check if any tests failed.
 
bool IsStatusSuccess () const
 Check if all tests passed.
 
void SetDataDir (std::string directory)
 Set the data directory where reference trace files can be found.
 
void ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
 Log the failure of this TestCase.
 
bool MustAssertOnFailure () const
 Check if this run should assert on failure.
 
bool MustContinueOnFailure () const
 Check if this run should continue on failure.
 
std::string CreateDataDirFilename (std::string filename)
 Construct the full path to a file in the data directory.
 
std::string CreateTempDirFilename (std::string filename)
 Construct the full path to a file in a temporary directory.
 
- Protected Attributes inherited from WifiPhyReceptionTest
Ptr< SpectrumWifiPhym_phy
 the PHY
 
uint64_t m_uid {0}
 the UID to use for the PPDU
 

Detailed Description

A-MPDU reception test.

Definition at line 2421 of file wifi-phy-reception-test.cc.

Constructor & Destructor Documentation

◆ TestAmpduReception()

TestAmpduReception::TestAmpduReception ( )

Definition at line 2524 of file wifi-phy-reception-test.cc.

Member Function Documentation

◆ CheckPhyState()

void TestAmpduReception::CheckPhyState ( WifiPhyState expectedState)
private

Check the PHY state.

Parameters
expectedStatethe expected PHY state

Definition at line 2715 of file wifi-phy-reception-test.cc.

References ns3::DynamicCast(), ns3::PointerValue::Get(), WifiPhyReceptionTest::m_phy, ns3::Simulator::Now(), and NS_TEST_ASSERT_MSG_EQ.

+ Here is the call graph for this function:

◆ CheckRxDroppedBitmapAmpdu1()

void TestAmpduReception::CheckRxDroppedBitmapAmpdu1 ( uint8_t expected)
private

Check the RX dropped bitmap for A-MPDU 1.

Parameters
expectedthe expected bitmap

Definition at line 2699 of file wifi-phy-reception-test.cc.

References m_rxDroppedBitmapAmpdu1, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ CheckRxDroppedBitmapAmpdu2()

void TestAmpduReception::CheckRxDroppedBitmapAmpdu2 ( uint8_t expected)
private

Check the RX dropped bitmap for A-MPDU 2.

Parameters
expectedthe expected bitmap

Definition at line 2707 of file wifi-phy-reception-test.cc.

References m_rxDroppedBitmapAmpdu2, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ CheckRxFailureBitmapAmpdu1()

void TestAmpduReception::CheckRxFailureBitmapAmpdu1 ( uint8_t expected)
private

Check the RX failure bitmap for A-MPDU 1.

Parameters
expectedthe expected bitmap

Definition at line 2683 of file wifi-phy-reception-test.cc.

References m_rxFailureBitmapAmpdu1, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ CheckRxFailureBitmapAmpdu2()

void TestAmpduReception::CheckRxFailureBitmapAmpdu2 ( uint8_t expected)
private

Check the RX failure bitmap for A-MPDU 2.

Parameters
expectedthe expected bitmap

Definition at line 2691 of file wifi-phy-reception-test.cc.

References m_rxFailureBitmapAmpdu2, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ CheckRxSuccessBitmapAmpdu1()

void TestAmpduReception::CheckRxSuccessBitmapAmpdu1 ( uint8_t expected)
private

Check the RX success bitmap for A-MPDU 1.

Parameters
expectedthe expected bitmap

Definition at line 2667 of file wifi-phy-reception-test.cc.

References m_rxSuccessBitmapAmpdu1, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ CheckRxSuccessBitmapAmpdu2()

void TestAmpduReception::CheckRxSuccessBitmapAmpdu2 ( uint8_t expected)
private

Check the RX success bitmap for A-MPDU 2.

Parameters
expectedthe expected bitmap

Definition at line 2675 of file wifi-phy-reception-test.cc.

References m_rxSuccessBitmapAmpdu2, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ DoRun()

void TestAmpduReception::DoRun ( )
overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 2795 of file wifi-phy-reception-test.cc.

References CheckRxDroppedBitmapAmpdu1(), CheckRxDroppedBitmapAmpdu2(), CheckRxFailureBitmapAmpdu1(), CheckRxFailureBitmapAmpdu2(), CheckRxSuccessBitmapAmpdu1(), CheckRxSuccessBitmapAmpdu2(), ns3::Simulator::Destroy(), WifiPhyReceptionTest::m_phy, ns3::MicroSeconds(), ns3::NanoSeconds(), ResetBitmaps(), ns3::Simulator::Run(), ns3::Simulator::Schedule(), ns3::Seconds(), SendAmpduWithThreeMpdus(), ns3::RngSeedManager::SetRun(), and ns3::RngSeedManager::SetSeed().

+ Here is the call graph for this function:

◆ DoSetup()

void TestAmpduReception::DoSetup ( )
overrideprivatevirtual

Implementation to do any local setup required for this TestCase.

Subclasses should override this method to perform any costly per-test setup before DoRun is invoked.

Reimplemented from ns3::TestCase.

Definition at line 2774 of file wifi-phy-reception-test.cc.

References ns3::CreateObject(), WifiPhyReceptionTest::DoSetup(), WifiPhyReceptionTest::m_phy, ns3::MakeCallback(), ns3::MicroSeconds(), RxDropped(), RxFailure(), and RxSuccess().

+ Here is the call graph for this function:

◆ IncrementFailureBitmap()

void TestAmpduReception::IncrementFailureBitmap ( uint32_t size)
private

Increment reception failure bitmap.

Parameters
sizethe size of the received packet

Definition at line 2608 of file wifi-phy-reception-test.cc.

References m_rxFailureBitmapAmpdu1, and m_rxFailureBitmapAmpdu2.

Referenced by RxFailure(), and RxSuccess().

+ Here is the caller graph for this function:

◆ IncrementSuccessBitmap()

void TestAmpduReception::IncrementSuccessBitmap ( uint32_t size)
private

Increment reception success bitmap.

Parameters
sizethe size of the received packet

Definition at line 2569 of file wifi-phy-reception-test.cc.

References m_rxSuccessBitmapAmpdu1, and m_rxSuccessBitmapAmpdu2.

Referenced by RxSuccess().

+ Here is the caller graph for this function:

◆ ResetBitmaps()

void TestAmpduReception::ResetBitmaps ( )
private

Reset bitmaps function.

Definition at line 2530 of file wifi-phy-reception-test.cc.

References m_rxDroppedBitmapAmpdu1, m_rxDroppedBitmapAmpdu2, m_rxFailureBitmapAmpdu1, m_rxFailureBitmapAmpdu2, m_rxSuccessBitmapAmpdu1, and m_rxSuccessBitmapAmpdu2.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ RxDropped()

void TestAmpduReception::RxDropped ( Ptr< const Packet > p,
WifiPhyRxfailureReason reason )
private

RX dropped function.

Parameters
pthe packet
reasonthe reason

Definition at line 2637 of file wifi-phy-reception-test.cc.

References m_rxDroppedBitmapAmpdu1, m_rxDroppedBitmapAmpdu2, and NS_LOG_FUNCTION.

Referenced by DoSetup().

+ Here is the caller graph for this function:

◆ RxFailure()

void TestAmpduReception::RxFailure ( Ptr< const WifiPsdu > psdu)
private

RX failure function.

Parameters
psduthe PSDU

Definition at line 2598 of file wifi-phy-reception-test.cc.

References IncrementFailureBitmap(), and NS_LOG_FUNCTION.

Referenced by DoSetup().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ RxSuccess()

void TestAmpduReception::RxSuccess ( Ptr< const WifiPsdu > psdu,
RxSignalInfo rxSignalInfo,
WifiTxVector txVector,
std::vector< bool > statusPerMpdu )
private

RX success function.

Parameters
psduthe PSDU
rxSignalInfothe info on the received signal (
See also
RxSignalInfo)
Parameters
txVectorthe transmit vector
statusPerMpdureception status per MPDU

Definition at line 2541 of file wifi-phy-reception-test.cc.

References IncrementFailureBitmap(), IncrementSuccessBitmap(), NS_ABORT_MSG_IF, and NS_LOG_FUNCTION.

Referenced by DoSetup().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ SendAmpduWithThreeMpdus()

void TestAmpduReception::SendAmpduWithThreeMpdus ( dBm_u rxPower,
uint32_t referencePacketSize )
private

Send A-MPDU with 3 MPDUs of different size (i-th MSDU will have 100 bytes more than (i-1)-th).

Parameters
rxPowerthe transmit power
referencePacketSizethe reference size of the packets in bytes (i-th MSDU will have 100 bytes more than (i-1)-th)

Definition at line 2729 of file wifi-phy-reception-test.cc.

References CHANNEL_WIDTH, ns3::Create(), ns3::WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(), ns3::DbmToW(), FREQUENCY, ns3::HePhy::GetHeMcs0(), GUARD_WIDTH, WifiPhyReceptionTest::m_phy, WifiPhyReceptionTest::m_uid, ns3::NanoSeconds(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetType(), ns3::WIFI_MAC_QOSDATA, and ns3::WIFI_PREAMBLE_HE_SU.

Referenced by DoRun().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Member Data Documentation

◆ m_rxDroppedBitmapAmpdu1

uint8_t TestAmpduReception::m_rxDroppedBitmapAmpdu1 {0}
private

bitmap of dropped MPDUs in A-MPDU #1

Definition at line 2520 of file wifi-phy-reception-test.cc.

Referenced by CheckRxDroppedBitmapAmpdu1(), ResetBitmaps(), and RxDropped().

◆ m_rxDroppedBitmapAmpdu2

uint8_t TestAmpduReception::m_rxDroppedBitmapAmpdu2 {0}
private

bitmap of dropped MPDUs in A-MPDU #2

Definition at line 2521 of file wifi-phy-reception-test.cc.

Referenced by CheckRxDroppedBitmapAmpdu2(), ResetBitmaps(), and RxDropped().

◆ m_rxFailureBitmapAmpdu1

uint8_t TestAmpduReception::m_rxFailureBitmapAmpdu1 {0}
private

bitmap of unsuccessfully received MPDUs in A-MPDU #1

Definition at line 2517 of file wifi-phy-reception-test.cc.

Referenced by CheckRxFailureBitmapAmpdu1(), IncrementFailureBitmap(), and ResetBitmaps().

◆ m_rxFailureBitmapAmpdu2

uint8_t TestAmpduReception::m_rxFailureBitmapAmpdu2 {0}
private

bitmap of unsuccessfully received MPDUs in A-MPDU #2

Definition at line 2518 of file wifi-phy-reception-test.cc.

Referenced by CheckRxFailureBitmapAmpdu2(), IncrementFailureBitmap(), and ResetBitmaps().

◆ m_rxSuccessBitmapAmpdu1

uint8_t TestAmpduReception::m_rxSuccessBitmapAmpdu1 {0}
private

bitmap of successfully received MPDUs in A-MPDU #1

Definition at line 2514 of file wifi-phy-reception-test.cc.

Referenced by CheckRxSuccessBitmapAmpdu1(), IncrementSuccessBitmap(), and ResetBitmaps().

◆ m_rxSuccessBitmapAmpdu2

uint8_t TestAmpduReception::m_rxSuccessBitmapAmpdu2 {0}
private

bitmap of successfully received MPDUs in A-MPDU #2

Definition at line 2515 of file wifi-phy-reception-test.cc.

Referenced by CheckRxSuccessBitmapAmpdu2(), IncrementSuccessBitmap(), and ResetBitmaps().


The documentation for this class was generated from the following file: