23 #include "ns3/wifi-net-device.h" 24 #include "ns3/minstrel-wifi-manager.h" 25 #include "ns3/minstrel-ht-wifi-manager.h" 26 #include "ns3/ap-wifi-mac.h" 27 #include "ns3/ampdu-subframe-header.h" 28 #include "ns3/mobility-model.h" 30 #include "ns3/pointer.h" 31 #include "ns3/radiotap-header.h" 32 #include "ns3/config.h" 33 #include "ns3/names.h" 34 #include "ns3/net-device-queue-interface.h" 35 #include "ns3/wifi-mac-queue.h" 36 #include "ns3/qos-utils.h" 37 #include "ns3/ht-configuration.h" 38 #include "ns3/vht-configuration.h" 39 #include "ns3/he-configuration.h" 40 #include "ns3/obss-pd-algorithm.h" 41 #include "ns3/wifi-ack-policy-selector.h" 66 NS_LOG_FUNCTION (stream << context << p << mode << preamble << txLevel);
227 uint16_t channelFreqMhz,
231 uint32_t dlt =
file->GetDataLinkType ();
239 NS_FATAL_ERROR (
"PcapSniffTxEvent(): DLT_PRISM_HEADER not implemented");
251 NS_ABORT_MSG (
"PcapSniffTxEvent(): Unexpected data link type " << dlt);
259 uint16_t channelFreqMhz,
264 uint32_t dlt =
file->GetDataLinkType ();
272 NS_FATAL_ERROR (
"PcapSniffRxEvent(): DLT_PRISM_HEADER not implemented");
286 NS_ABORT_MSG (
"PcapSniffRxEvent(): Unexpected data link type " << dlt);
293 uint16_t channelFreqMhz,
324 header.
SetRate (static_cast<uint8_t> (rate));
327 uint16_t channelFlags = 0;
341 if (channelFreqMhz < 2500)
378 if (txVector.
GetNess () & 0x01)
382 if (txVector.
GetNess () & 0x02)
404 uint32_t extractedLength;
407 packet = packet->
CreateFragment (0, static_cast<uint32_t> (extractedLength));
419 uint8_t vhtBandwidth = 0;
420 uint8_t vhtMcsNss[4] = {0,0,0,0};
421 uint8_t vhtCoding = 0;
422 uint8_t vhtGroupId = 0;
423 uint16_t vhtPartialAid = 0;
455 vhtMcsNss[0] |= (txVector.
GetNss () & 0x0f);
458 header.
SetVhtFields (vhtKnown, vhtFlags, vhtBandwidth, vhtMcsNss, vhtCoding, vhtGroupId, vhtPartialAid);
528 NS_ABORT_MSG (
"WifiPhyHelper::SetPcapFormat(): Unexpected format");
541 NS_LOG_FUNCTION (
this << prefix << nd << promiscuous << explicitFilename);
549 NS_LOG_INFO (
"WifiHelper::EnablePcapInternal(): Device " << &device <<
" not of type ns3::WifiNetDevice");
554 NS_ABORT_MSG_IF (
phy == 0,
"WifiPhyHelper::EnablePcapInternal(): Phy layer in WifiNetDevice must be set");
558 std::string filename;
559 if (explicitFilename)
579 bool explicitFilename)
587 NS_LOG_INFO (
"WifiHelper::EnableAsciiInternal(): Device " << device <<
" not of type ns3::WifiNetDevice");
595 uint32_t nodeid = nd->GetNode ()->GetId ();
596 uint32_t deviceid = nd->GetIfIndex ();
597 std::ostringstream oss;
610 std::string filename;
611 if (explicitFilename)
626 oss <<
"/NodeList/" << nodeid <<
"/DeviceList/" << deviceid <<
"/$ns3::WifiNetDevice/Phy/State/RxOk";
630 oss <<
"/NodeList/" << nodeid <<
"/DeviceList/" << deviceid <<
"/$ns3::WifiNetDevice/Phy/State/Tx";
642 oss <<
"/NodeList/" << nodeid <<
"/DeviceList/" << deviceid <<
"/$ns3::WifiNetDevice/Phy/State/RxOk";
646 oss <<
"/NodeList/" << nodeid <<
"/DeviceList/" << deviceid <<
"/$ns3::WifiNetDevice/Phy/State/Tx";
786 obssPdAlgorithm->ConnectWifiNetDevice (device);
800 rmac->GetAttributeFailSafe (
"QosSupported", qosSupported);
801 if (qosSupported.
Get ())
803 ndqi = CreateObjectWithAttributes<NetDeviceQueueInterface> (
"NTxQueues",
806 rmac->GetAttributeFailSafe (
"BE_Txop", ptr);
808 ackSelector->SetQosTxop (ptr.
Get<
QosTxop> ());
809 ptr.
Get<
QosTxop> ()->SetAckPolicySelector (ackSelector);
810 wmq = ptr.
Get<
QosTxop> ()->GetWifiMacQueue ();
811 ndqi->GetTxQueue (0)->ConnectQueueTraces (wmq);
813 rmac->GetAttributeFailSafe (
"BK_Txop", ptr);
815 ackSelector->SetQosTxop (ptr.
Get<
QosTxop> ());
816 ptr.
Get<
QosTxop> ()->SetAckPolicySelector (ackSelector);
817 wmq = ptr.
Get<
QosTxop> ()->GetWifiMacQueue ();
818 ndqi->GetTxQueue (1)->ConnectQueueTraces (wmq);
820 rmac->GetAttributeFailSafe (
"VI_Txop", ptr);
822 ackSelector->SetQosTxop (ptr.
Get<
QosTxop> ());
823 ptr.
Get<
QosTxop> ()->SetAckPolicySelector (ackSelector);
824 wmq = ptr.
Get<
QosTxop> ()->GetWifiMacQueue ();
825 ndqi->GetTxQueue (2)->ConnectQueueTraces (wmq);
827 rmac->GetAttributeFailSafe (
"VO_Txop", ptr);
829 ackSelector->SetQosTxop (ptr.
Get<
QosTxop> ());
830 ptr.
Get<
QosTxop> ()->SetAckPolicySelector (ackSelector);
831 wmq = ptr.
Get<
QosTxop> ()->GetWifiMacQueue ();
832 ndqi->GetTxQueue (3)->ConnectQueueTraces (wmq);
837 ndqi = CreateObject<NetDeviceQueueInterface> ();
839 rmac->GetAttributeFailSafe (
"Txop", ptr);
840 wmq = ptr.
Get<
Txop> ()->GetWifiMacQueue ();
841 ndqi->GetTxQueue (0)->ConnectQueueTraces (wmq);
867 Ptr<Node> node = Names::Find<Node> (nodeName);
936 int64_t currentStream = stream;
945 currentStream +=
wifi->GetPhy ()->AssignStreams (currentStream);
952 currentStream += minstrel->AssignStreams (currentStream);
958 currentStream += minstrelHt->AssignStreams (currentStream);
967 rmac->GetAttribute (
"Txop", ptr);
971 rmac->GetAttribute (
"VO_Txop", ptr);
975 rmac->GetAttribute (
"VI_Txop", ptr);
979 rmac->GetAttribute (
"BE_Txop", ptr);
983 rmac->GetAttribute (
"BK_Txop", ptr);
991 currentStream += apmac->AssignStreams (currentStream);
996 return (currentStream - stream);
WifiPhyStandard m_standard
wifi standard
uint32_t RemoveHeader(Header &header)
Deserialize and remove the header from the internal buffer.
void Set(std::string name, const AttributeValue &v)
void SetPreambleDetectionModel(std::string name, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
bool IsAggregation(void) const
Checks whether the PSDU contains A-MPDU.
Prefix all trace prints with simulation node.
Manage ASCII trace files for device models.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
AttributeValue implementation for Boolean.
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
virtual NetDeviceContainer Install(const WifiPhyHelper &phy, const WifiMacHelper &mac, NodeContainer::Iterator first, NodeContainer::Iterator last) const
static void AsciiPhyReceiveSinkWithoutContext(Ptr< OutputStreamWrapper > stream, Ptr< const Packet > p, double snr, WifiMode mode, enum WifiPreamble preamble)
ASCII Phy receive sink without context.
void SetObssPdAlgorithm(std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
std::vector< Ptr< Node > >::const_iterator Iterator
Node container iterator.
void SetRemoteStationManager(std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
Iterator End(void) const
Get an iterator which indicates past-the-last NetDevice in the container.
Hold a value for an Attribute.
Manage pcap files for device models.
Callback< R > MakeBoundCallback(R(*fnPtr)(TX), ARG a1)
Make Callbacks with one bound argument.
PcapHelper::DataLinkType m_pcapDlt
PCAP data link type.
void AggregateObject(Ptr< Object > other)
Aggregate two Objects together.
Handle packet fragmentation and retransmissions for QoS data frames as well as MSDU aggregation (A-MS...
double GetSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
Ptr< Packet > CreateFragment(uint32_t start, uint32_t length) const
Create a new packet which contains a fragment of the original packet.
void SetHtConfiguration(Ptr< HtConfiguration > htConfiguration)
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
HE PHY for the 2.4 GHz band (clause 26)
OBSS PD algorithm interfaceThis object provides the interface for all OBSS_PD algorithms and is desig...
void SetTypeId(TypeId tid)
Set the TypeId of the Objects to be created by this factory.
bool IsStbc(void) const
Check if STBC is used or not.
static void AsciiPhyReceiveSinkWithContext(Ptr< OutputStreamWrapper > stream, std::string context, Ptr< const Packet > p, double snr, WifiMode mode, enum WifiPreamble preamble)
ASCII Phy receive sink with context.
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
uint8_t GetNess(void) const
uint16_t GetGuardInterval(void) const
Ptr< OutputStreamWrapper > CreateFileStream(std::string filename, std::ios::openmode filemode=std::ios::out)
Create and initialize an output stream object we'll use to write the traced bits. ...
HT PHY for the 2.4 GHz band (clause 20)
Iterator End(void) const
Get an iterator which indicates past-the-last Node in the container.
ObjectFactory m_errorRateModel
error rate model
std::string GetFilenameFromDevice(std::string prefix, Ptr< NetDevice > device, bool useObjectNames=true)
Let the ascii trace helper figure out a reasonable filename to use for an ascii trace file associated...
Ptr< PcapFileWrapper > CreateFile(std::string filename, std::ios::openmode filemode, DataLinkType dataLinkType, uint32_t snapLen=std::numeric_limits< uint32_t >::max(), int32_t tzCorrection=0)
Create and initialize a pcap file.
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
WifiHelper()
Create a Wifi helper in an empty state: all its parameters must be set before calling ns3::WifiHelper...
virtual void EnableAsciiInternal(Ptr< OutputStreamWrapper > stream, std::string prefix, Ptr< NetDevice > nd, bool explicitFilename)
Enable ASCII trace output on the indicated net device.
ObjectFactory m_preambleDetectionModel
preamble detection model
static void PcapSniffTxEvent(Ptr< PcapFileWrapper > file, Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu)
WifiPreamble GetPreambleType(void) const
DataLinkType
This enumeration holds the data link types that will be written to the pcap file. ...
void SetHeConfiguration(Ptr< HeConfiguration > heConfiguration)
virtual void SetStandard(WifiPhyStandard standard)
WifiPreamble
The type of preamble to be used by an IEEE 802.11 transmission.
Keep track of the current position and velocity of an object.
WifiPhyStandard
Identifies the PHY specification that a Wifi device is configured to use.
HE PHY for the 5 GHz band (clause 26)
std::string GetFilenameFromDevice(std::string prefix, Ptr< NetDevice > device, bool useObjectNames=true)
Let the pcap helper figure out a reasonable filename to use for a pcap file associated with a device...
void LogComponentEnable(char const *name, enum LogLevel level)
Enable the logging output associated with that log component.
static Mac48Address Allocate(void)
Allocate a new Mac48Address.
static void EnablePrinting(void)
Enable printing packets metadata.
Ptr< Object > Create(void) const
Create an Object instance of the configured TypeId.
void SetMac(const Ptr< WifiMac > mac)
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model...
Iterator Begin(void) const
Get an iterator which refers to the first NetDevice in the container.
Hold an unsigned integer type.
holds a vector of ns3::NetDevice pointers
static void PcapSniffRxEvent(Ptr< PcapFileWrapper > file, Ptr< const Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu, SignalNoiseDbm signalNoise)
void SetFrameCaptureModel(std::string name, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
WifiMode GetMode(void) const
int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used by the PHY and MAC aspects ...
Hold together all Wifi-related objects.
void ConnectWithoutContext(std::string path, const CallbackBase &cb)
ObjectFactory m_obssPdAlgorithm
OBSS_PD algorithm.
PcapHelper::DataLinkType GetPcapDataLinkType(void) const
Get the data link type of PCAP traces to be used.
hold a list of per-remote-station state.
WifiModulationClass GetModulationClass() const
void Connect(std::string path, const CallbackBase &cb)
Include Prism monitor mode information.
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Ptr< WifiPhy > GetPhy(void) const
double f(double x, void *params)
static RadiotapHeader GetRadiotapHeader(Ptr< Packet > packet, uint16_t channelFreqMhz, WifiTxVector txVector, MpduInfo aMpdu)
Get the Radiotap header.
void LogComponentEnableAll(enum LogLevel level)
Enable the logging output for all registered log components.
Prefix all trace prints with simulation time.
OFDM PHY for the 5 GHz band (Clause 17)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
keep track of a set of node pointers.
Hold objects of type Ptr<T>.
uint8_t SelectQueueByDSField(Ptr< QueueItem > item)
Determine the TX queue for a given packet.
ObjectFactory m_ackPolicySelector[4]
ack policy selector for all ACs
Ptr< Packet > Copy(void) const
performs a COW copy of the packet.
SelectQueueCallback m_selectQueueCallback
select queue callback
void Set(std::string name, const AttributeValue &value)
Set an attribute to be set during construction.
ObjectFactory m_stationManager
station manager
create MAC layers for a ns3::WifiNetDevice.
static Time Now(void)
Return the current simulation virtual time.
void SetPcapDataLinkType(SupportedPcapDataLinkTypes dlt)
Set the data link type of PCAP traces to be used.
void SetErrorRateModel(std::string name, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
bool IsTypeIdSet(void) const
Check if the ObjectFactory has been configured with a TypeId.
virtual void EnablePcapInternal(std::string prefix, Ptr< NetDevice > nd, bool promiscuous, bool explicitFilename)
Enable pcap output the indicated net device.
ObjectFactory m_phy
PHY object.
virtual Ptr< WifiMac > Create(Ptr< NetDevice > device) const
Instantiate subclasses of ns3::Object.
void SetPhy(const Ptr< WifiPhy > phy)
static void EnableLogComponents(void)
Helper to enable all WifiNetDevice log components with one statement.
virtual Ptr< WifiPhy > Create(Ptr< Node > node, Ptr< NetDevice > device) const =0
void SetSelectQueueCallback(SelectQueueCallback f)
uint32_t AddDevice(Ptr< NetDevice > device)
Associate a NetDevice to this node.
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
SignalNoiseDbm structure.
uint32_t mpduRefNumber
MPDU ref number.
The MPDU is the last aggregate in an A-MPDU with multiple MPDUs.
std::vector< Ptr< NetDevice > >::const_iterator Iterator
NetDevice container iterator.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
IEEE 802.11 Wireless LAN headers on packets.
ObjectFactory m_frameCaptureModel
frame capture model
std::function< std::size_t(Ptr< QueueItem >)> SelectQueueCallback
Callback invoked to determine the MAC queue selected for a given packet.
uint16_t GetChannelWidth(void) const
SupportedPcapDataLinkTypes
An enumeration of the pcap data link types (DLTs) which this helper supports.
void DisablePreambleDetectionModel()
Disable the preamble detection model.
WifiAckPolicySelector is in charge of selecting the acknowledgment policy for PSDUs containing QoS Da...
uint8_t GetMcsValue(void) const
void SetAckPolicySelectorForAc(AcIndex ac, std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())
a unique identifier for an interface.
Include Radiotap link layer information.
static void AsciiPhyTransmitSinkWithContext(Ptr< OutputStreamWrapper > stream, std::string context, Ptr< const Packet > p, WifiMode mode, WifiPreamble preamble, uint8_t txLevel)
ASCII Phy transmit sink with context.
AcIndex
This enumeration defines the Access Categories as an enumeration with values corresponding to the AC ...
void SetVhtConfiguration(Ptr< VhtConfiguration > vhtConfiguration)
std::ostream * GetStream(void)
Return a pointer to an ostream previously set in the wrapper.
uint64_t GetDataRate(uint16_t channelWidth, uint16_t guardInterval, uint8_t nss) const
void AddHeader(const Header &header)
Add header to this packet.
Iterator Begin(void) const
Get an iterator which refers to the first Node in the container.
uint8_t GetNss(void) const
void SetRemoteStationManager(const Ptr< WifiRemoteStationManager > manager)
Handle packet fragmentation and retransmissions for data and management frames.
static void AsciiPhyTransmitSinkWithoutContext(Ptr< OutputStreamWrapper > stream, Ptr< const Packet > p, WifiMode mode, WifiPreamble preamble, uint8_t txLevel)
ASCII Phy transmit sink without context.