29 #include <ns3/abort.h>
30 #include <ns3/simulator.h>
31 #include <ns3/spectrum-value.h>
32 #include <ns3/antenna-model.h>
33 #include <ns3/mobility-model.h>
34 #include <ns3/spectrum-channel.h>
35 #include <ns3/packet.h>
36 #include <ns3/packet-burst.h>
37 #include <ns3/net-device.h>
38 #include <ns3/random-variable-stream.h>
39 #include <ns3/double.h>
53 const LrWpanPhyDataAndSymbolRates
64 const LrWpanPhyPpduHeaderSymbolNumber
78 .SetGroupName (
"LrWpan")
80 .AddTraceSource (
"TrxStateValue",
81 "The state of the transceiver",
83 "ns3::TracedValueCallback::LrWpanPhyEnumeration")
84 .AddTraceSource (
"TrxState",
85 "The state of the transceiver",
87 "ns3::LrWpanPhy::StateTracedCallback")
88 .AddTraceSource (
"PhyTxBegin",
89 "Trace source indicating a packet has "
90 "begun transmitting over the channel medium",
92 "ns3::Packet::TracedCallback")
93 .AddTraceSource (
"PhyTxEnd",
94 "Trace source indicating a packet has been "
95 "completely transmitted over the channel.",
97 "ns3::Packet::TracedCallback")
98 .AddTraceSource (
"PhyTxDrop",
99 "Trace source indicating a packet has been "
100 "dropped by the device during transmission",
102 "ns3::Packet::TracedCallback")
103 .AddTraceSource (
"PhyRxBegin",
104 "Trace source indicating a packet has begun "
105 "being received from the channel medium by the device",
107 "ns3::Packet::TracedCallback")
108 .AddTraceSource (
"PhyRxEnd",
109 "Trace source indicating a packet has been "
110 "completely received from the channel medium "
113 "ns3::Packet::SinrTracedCallback")
114 .AddTraceSource (
"PhyRxDrop",
115 "Trace source indicating a packet has been "
116 "dropped by the device during reception",
118 "ns3::Packet::TracedCallback")
134 for (uint32_t i = 0; i < 32; i++)
152 m_signal = Create<LrWpanInterferenceHelper> (
m_noise->GetSpectrumModel ());
160 m_random = CreateObject<UniformRandomVariable> ();
292 if (lrWpanRxParams == 0)
295 m_signal->AddSignal (spectrumRxParams->psd);
311 Ptr<Packet> p = (lrWpanRxParams->packetBurst->GetPackets ()).front ();
334 m_signal->AddSignal (lrWpanRxParams->psd);
336 *interferenceAndNoise -= *lrWpanRxParams->psd;
337 *interferenceAndNoise += *
m_noise;
343 if (10 * log10 (sinr) > -5)
368 m_signal->AddSignal (lrWpanRxParams->psd);
377 m_signal->AddSignal (lrWpanRxParams->psd);
408 Ptr<Packet> currentPacket = currentRxParams->packetBurst->GetPackets ().front ();
415 *interferenceAndNoise -= *currentRxParams->psd;
416 *interferenceAndNoise += *
m_noise;
418 double per = 1.0 -
m_errorModel->GetChunkSuccessRate (sinr, chunkSize);
422 LrWpanLqiTag tag (std::numeric_limits<uint8_t>::max ());
424 uint8_t lqi = tag.
Get ();
425 tag.
Set (lqi - (per * lqi));
458 if (currentRxParams == params)
473 if (currentRxParams == params)
475 Ptr<Packet> currentPacket = currentRxParams->packetBurst->GetPackets ().front ();
479 LrWpanLqiTag tag (std::numeric_limits<uint8_t>::max ());
533 NS_LOG_DEBUG (
"Drop packet because psduLength too long: " << psduLength);
551 txParams->txPhy = GetObject<SpectrumPhy> ();
556 txParams->packetBurst = pb;
730 NS_LOG_DEBUG (
"Phy is busy; setting state pending to " << state);
746 NS_LOG_DEBUG (
"Receiver has valid SFD; defer state change");
877 bool retValue =
false;
879 for (uint32_t i = 0; i < 32; i++)
1084 uint8_t energyLevel;
1088 ratio = 10.0 * log10 (ratio);
1093 else if (ratio >= 40.0)
1100 energyLevel =
static_cast<uint8_t
> (((ratio - 10.0) / 30.0) * 255.0);
1175 NS_LOG_LOGIC (
this <<
"channel sensed state: " << sensedChannelState);
1285 return (rate * 1000.0);
1293 bool isData =
false;
1294 double totalPpduHdrSymbols;
1372 NS_LOG_INFO (
"\t computed noise_psd: " << *noisePsd );
Simulation virtual time values and global simulation resolution.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
void SetStream(int64_t stream)
Specifies the stream number for this RNG stream.
void SetPlmeSetTRXStateConfirmCallback(PlmeSetTRXStateConfirmCallback c)
set the callback for the end of an SetTRXState, as part of the interconnections betweenthe PHY and th...
TracedCallback< Ptr< const Packet > > m_phyTxDropTrace
The trace source fired when the phy layer drops a packet as it tries to transmit it.
Abstract base class for Spectrum-aware PHY layers.
Make LrWpanPhy a SpectrumPhy so we can enable the eventual modeling of device interference.
static const uint32_t aTurnaroundTime
The turnaround time for switching the transceiver from RX to TX or vice versa.
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
void SetPdDataConfirmCallback(PdDataConfirmCallback c)
set the callback for the end of a TX, as part of the interconnections betweenthe PHY and the MAC...
LrWpanPhyOption GetMyPhyOption(void)
Get the currently configured PHY option.
Ptr< UniformRandomVariable > m_random
Uniform random variable stream.
PdDataConfirmCallback m_pdDataConfirmCallback
This callback is used to report packet transmission status to the MAC layer.
LrWpanPibAttributeIdentifier
IEEE802.15.4-2006 PHY PIB Attribute Identifiers Table 23 in section 6.4.2.
TracedValue< LrWpanPhyEnumeration > m_trxState
The current transceiver state.
void SetPdDataIndicationCallback(PdDataIndicationCallback c)
set the callback for the end of a RX, as part of the interconnections betweenthe PHY and the MAC...
uint32_t phyCurrentPage
Current channel page.
void SetPlmeCcaConfirmCallback(PlmeCcaConfirmCallback c)
set the callback for the end of a CCA, as part of the interconnections betweenthe PHY and the MAC...
bool IsNull(void) const
Check for null implementation.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
PlmeEdConfirmCallback m_plmeEdConfirmCallback
This callback is used to report ED status to the MAC.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
void SetDevice(Ptr< NetDevice > d)
set the associated NetDevice instance
void SetPlmeEdConfirmCallback(PlmeEdConfirmCallback c)
set the callback for the end of an ED, as part of the interconnections betweenthe PHY and the MAC...
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
LrWpanEdPower m_edPower
Helper value for tracking the average power during ED.
Time measurementLength
Total measuremement period.
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Ptr< NetDevice > GetDevice(void) const
get the associated NetDevice instance
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
void ChangeTrxState(LrWpanPhyEnumeration newState)
Change the PHY state to the given new state, firing the state change trace.
bool IsRunning(void) const
This method is syntactic sugar for !IsExpired().
bool PhyIsBusy(void) const
Check if the PHY is busy, which is the case if the PHY is currently sending or receiving a frame...
PacketAndStatus m_currentTxPacket
Statusinformation of the currently transmitted packet.
virtual void DoDispose(void)
Destructor implementation.
TracedCallback< Ptr< const Packet > > m_phyRxBeginTrace
The trace source fired when a packet begins the reception process from the medium.
uint8_t phyCCAMode
CCA mode.
PlmeGetAttributeConfirmCallback m_plmeGetAttributeConfirmCallback
This callback is used to report requested attribute values back to the MAC.
void EndSetTRXState(void)
Called after applying a deferred transceiver state switch.
Ptr< SpectrumValue > m_txPsd
The transmit power spectral density.
TracedCallback< Ptr< const Packet > > m_phyRxDropTrace
The trace source fired when the phy layer drops a packet it has received.
Introspection did not find any typical Config paths.
IEEE802.15.4-2006 PHY PIB Attributes Table 23 in section 6.4.2.
static const LrWpanPhyPpduHeaderSymbolNumber ppduHeaderSymbolNumbers[7]
The preamble, SFD, and PHR lengths in symbols for the different PHY options.
double m_rxSensitivity
The receiver sensitivity.
double GetDataOrSymbolRate(bool isData)
implement PLME SetAttribute confirm SAP
TracedCallback< Time, LrWpanPhyEnumeration, LrWpanPhyEnumeration > m_trxStateLogger
The trace source fired when the phy layer changes the transceiver state.
PlmeSetTRXStateConfirmCallback m_plmeSetTRXStateConfirmCallback
This callback is used to report transceiver state change status to the MAC.
uint8_t Get(void) const
Get the LQI value.
static const uint32_t aMaxPhyPacketSize
The maximum packet size accepted by the PHY.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
static TypeId GetTypeId(void)
Get the type ID.
void SetPlmeSetAttributeConfirmCallback(PlmeSetAttributeConfirmCallback c)
set the callback for the end of an SetAttribute, as part of the interconnections betweenthe PHY and t...
Ptr< SpectrumChannel > m_channel
The channel attached to this transceiver.
void SetChannel(Ptr< SpectrumChannel > c)
Set the channel attached to this device.
Time lastUpdate
Last update time.
static const LrWpanPhyDataAndSymbolRates dataSymbolRates[7]
The data and symbol rates for the different PHY options.
bool PeekPacketTag(Tag &tag) const
Search a matching tag and call Tag::Deserialize if it is found.
uint32_t phyChannelsSupported[32]
BitField representing the available channels supported by a channel page.
void SetPlmeGetAttributeConfirmCallback(PlmeGetAttributeConfirmCallback c)
set the callback for the end of an GetAttribute, as part of the interconnections betweenthe PHY and t...
LrWpanPhyEnumeration m_trxStatePending
The next pending state to applied after the current action of the PHY is completed.
void SetErrorModel(Ptr< LrWpanErrorModel > e)
set the error model to use
double m_ccaPeakPower
Helper value for the peak power value during CCA.
Ptr< LrWpanErrorModel > GetErrorModel(void) const
get the error model in use
static EventId Schedule(Time const &delay, MEM mem_ptr, OBJ obj)
Schedule an event to expire after delay.
Time GetPpduHeaderTxTime(void)
Calculate the time required for sending the PPDU header, that is the preamble, SFD and PHR...
Ptr< const SpectrumValue > GetNoisePowerSpectralDensity(void)
Get the noise power spectral density.
Ptr< LrWpanInterferenceHelper > m_signal
The accumulated signals currently received by the transceiver, including the signal of a possibly rec...
void SetMyPhyOption(void)
Configure the PHY option according to the current channel and channel page.
virtual Ptr< const SpectrumModel > GetRxSpectrumModel(void) const
Ptr< AntennaModel > m_antenna
The antenna used by the transceiver.
void SetTxPowerSpectralDensity(Ptr< SpectrumValue > txPsd)
Set the Power Spectral Density of outgoing signals in W/Hz.
Time m_rxLastUpdate
Timestamp of the last calculation of the PER of a packet currently received.
uint8_t phyTransmitPower
Transmit power.
Ptr< const SpectrumModel > GetSpectrumModel() const
void SetAntenna(Ptr< AntennaModel > a)
Set the attached antenna.
Ptr< const SpectrumValue > m_noise
The spectral density for for the noise.
EventId m_setTRXState
Scheduler event of a currently running deferred transceiver state switch.
bool ReplacePacketTag(Tag &tag)
Replace the value of a packet tag.
This class defines all functions to create spectrum model for LrWpan.
Ptr< NetDevice > m_device
The configured net device.
void PlmeGetAttributeRequest(LrWpanPibAttributeIdentifier id)
IEEE 802.15.4-2006 section 6.2.2.5 PLME-GET.request Get attributes per definition from Table 23 in se...
LrWpanPhy(void)
Default constructor.
Ptr< SpectrumChannel > GetChannel(void)
Get the currently attached channel.
Ptr< MobilityModel > GetMobility(void)
get the associated MobilityModel instance
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
EventId m_edRequest
Scheduler event of a currently running ED request.
std::pair< Ptr< LrWpanSpectrumSignalParameters >, bool > m_currentRxPacket
Statusinformation of the currently received packet.
Ptr< MobilityModel > m_mobility
The mobility model used by the PHY.
LrWpanPhyOption m_phyOption
The currently configured PHY type.
void EndCca(void)
Called at the end of the CCA.
void PlmeSetTRXStateRequest(LrWpanPhyEnumeration state)
IEEE 802.15.4-2006 section 6.2.2.7 PLME-SET-TRX-STATE.request Set PHY state.
bool ChannelSupported(uint8_t channel)
Check if the given channel is supported by the PHY.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void SetMobility(Ptr< MobilityModel > m)
Set the mobility model associated with this device.
PdDataIndicationCallback m_pdDataIndicationCallback
This callback is used to notify incoming packets to the MAC layer.
double symbolRate
symbol rate
double averagePower
Average measured power.
int64_t GetTimeStep(void) const
Get the raw time value, in the current resolution unit.
PlmeSetAttributeConfirmCallback m_plmeSetAttributeConfirmCallback
This callback is used to report attribute set results back to the MAC.
TracedCallback< Ptr< const Packet > > m_phyTxEndTrace
The trace source fired when a packet ends the transmission process on the medium. ...
Ptr< AntennaModel > GetRxAntenna(void)
get the AntennaModel used by the NetDevice for reception
TracedCallback< Ptr< const Packet > > m_phyTxBeginTrace
The trace source fired when a packet begins the transmission process on the medium.
static Time Now(void)
Return the current simulation virtual time.
void EndTx(void)
Finish the transmission of a frame.
EventId m_ccaRequest
Scheduler event of a currently running CCA request.
void CheckInterference(void)
Check if the interference destroys a frame currently received.
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
double GetPhySymbolsPerOctet(void) const
Get the number of symbols per octet, depending on the currently selected channel. ...
#define NS_ABORT_IF(cond)
Abnormal program termination if a condition is true.
EventId m_pdDataRequest
Scheduler event of a currently running data transmission request.
PlmeCcaConfirmCallback m_plmeCcaConfirmCallback
This callback is used to report CCA status to the MAC or CSMA/CA.
Ptr< SpectrumValue > CreateNoisePowerSpectralDensity(uint32_t channel)
create spectrum value for noise
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model...
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
void SetNoisePowerSpectralDensity(Ptr< const SpectrumValue > noisePsd)
Set the noise power spectral density.
LrWpanPhyPibAttributes m_phyPIBAttributes
The current PHY PIB attributes.
virtual void StartRx(Ptr< SpectrumSignalParameters > params)
Notify the SpectrumPhy instance of an incoming waveform.
bool RemovePacketTag(Tag &tag)
Remove a packet tag.
Ptr< SpectrumValue > CreateTxPowerSpectralDensity(double txPower, uint32_t channel)
create spectrum value
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Time Seconds(double value)
Construct a Time in the indicated unit.
TracedCallback< Ptr< const Packet >, double > m_phyRxEndTrace
The trace source fired when a packet ends the reception process from the medium.
void EndEd(void)
Called at the end of the ED procedure.
void PlmeSetAttributeRequest(LrWpanPibAttributeIdentifier id, LrWpanPhyPibAttributes *attribute)
IEEE 802.15.4-2006 section 6.2.2.9 PLME-SET.request Set attributes per definition from Table 23 in se...
void PdDataRequest(const uint32_t psduLength, Ptr< Packet > p)
IEEE 802.15.4-2006 section 6.2.1.1 PD-DATA.request Request to transfer MPDU from MAC (transmitting) ...
void Cancel(void)
This method is syntactic sugar for the ns3::Simulator::Cancel method.
static double TotalAvgPower(Ptr< const SpectrumValue > psd, uint32_t channel)
total average power of the signal is the integral of the PSD using the limits of the given channel ...
uint8_t phyCurrentChannel
The RF channel to use.
void Set(uint8_t lqi)
Set the LQI to the given value.
LrWpanPhyEnumeration
IEEE802.15.4-2006 PHY Emumerations Table 18 in section 6.2.3.
Time CalculateTxTime(Ptr< const Packet > packet)
Calculate the time required for sending the given packet, including preamble, SFD and PHR...
void PlmeCcaRequest(void)
IEEE 802.15.4-2006 section 6.2.2.1 PLME-CCA.request Perform a CCA per section 6.9.9.
void PlmeEdRequest(void)
IEEE 802.15.4-2006 section 6.2.2.3 PLME-ED.request Perform an ED per section 6.9.7.
void CancelEd(LrWpanPhyEnumeration state)
Cancel an ongoing ED procedure.
virtual void DoDispose(void)
Destructor implementation.
LrWpanPhyOption
This Phy option will be used to index various Tables in IEEE802.15.4-2006.
uint64_t GetPhySHRDuration(void) const
Get the duration of the SHR (preamble and SFD) in symbols, depending on the currently selected channe...
This class can be used to hold variables of floating point type such as 'double' or 'float'...
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
bool IsExpired(void) const
This method is syntactic sugar for the ns3::Simulator::IsExpired method.
Ptr< LrWpanErrorModel > m_errorModel
The error model describing the bit and packet error rates.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
void EndRx(Ptr< SpectrumSignalParameters > params)
Finish the reception of a frame.