Class modeling a Lora SX1301 chip. More...

#include "simple-gateway-lora-phy.h"

Inheritance diagram for ns3::lorawan::SimpleGatewayLoraPhy:

Collaboration diagram for ns3::lorawan::SimpleGatewayLoraPhy:

Public Member Functions
	SimpleGatewayLoraPhy ()
	Default constructor.

	~SimpleGatewayLoraPhy () override
	Destructor.

void	EndReceive (Ptr< Packet > packet, Ptr< LoraInterferenceHelper::Event > event) override
	Finish reception of a packet.

void	Send (Ptr< Packet > packet, LoraTxParameters txParams, double frequencyMHz, double txPowerDbm) override
	Instruct the PHY to send a packet according to some parameters.

void	StartReceive (Ptr< Packet > packet, double rxPowerDbm, uint8_t sf, Time duration, double frequencyMHz) override
	Start receiving a packet.

Public Member Functions inherited from ns3::lorawan::GatewayLoraPhy
	GatewayLoraPhy ()
	Default constructor.

	~GatewayLoraPhy () override
	Destructor.

void	AddFrequency (double frequencyMHz)
	Add a frequency to the list of frequencies we are listening to.

void	AddReceptionPath ()
	Add a reception path, locked on a specific frequency.

void	EndReceive (Ptr< Packet > packet, Ptr< LoraInterferenceHelper::Event > event) override=0
	Finish reception of a packet.

bool	IsOnFrequency (double frequencyMHz) override
	Check whether the GatewayLoraPhy is currently listening to the specified frequency.

bool	IsTransmitting () override
	Whether this device is transmitting or not.

void	ResetReceptionPaths ()
	Reset the list of reception paths.

void	Send (Ptr< Packet > packet, LoraTxParameters txParams, double frequencyMHz, double txPowerDbm) override=0
	Instruct the PHY to send a packet according to some parameters.

void	StartReceive (Ptr< Packet > packet, double rxPowerDbm, uint8_t sf, Time duration, double frequencyMHz) override=0
	Start receiving a packet.

Public Member Functions inherited from ns3::lorawan::LoraPhy
	LoraPhy ()
	Default constructor.

	~LoraPhy () override
	Destructor.

virtual void	EndReceive (Ptr< Packet > packet, Ptr< LoraInterferenceHelper::Event > event)=0
	Finish reception of a packet.

Ptr< LoraChannel >	GetChannel () const
	Get the channel instance associated to this PHY.

Ptr< NetDevice >	GetDevice () const
	Get the NetDevice associated to this PHY.

Ptr< MobilityModel >	GetMobility ()
	Get the mobility model associated to this PHY.

virtual bool	IsOnFrequency (double frequency)=0
	Whether this device is listening on the specified frequency or not.

virtual bool	IsTransmitting ()=0
	Whether this device is transmitting or not.

virtual void	Send (Ptr< Packet > packet, LoraTxParameters txParams, double frequencyMHz, double txPowerDbm)=0
	Instruct the PHY to send a packet according to some parameters.

void	SetChannel (Ptr< LoraChannel > channel)
	Set the LoraChannel instance PHY transmits on.

void	SetDevice (Ptr< NetDevice > device)
	Set the NetDevice that owns this PHY.

void	SetMobility (Ptr< MobilityModel > mobility)
	Set the mobility model associated to this PHY.

void	SetReceiveFailedCallback (RxFailedCallback callback)
	Set the callback to call upon failed reception of a packet we were previously locked on.

void	SetReceiveOkCallback (RxOkCallback callback)
	Set the callback to call upon successful reception of a packet.

void	SetTxFinishedCallback (TxFinishedCallback callback)
	Set the callback to call after transmission of a packet.

virtual void	StartReceive (Ptr< Packet > packet, double rxPowerDbm, uint8_t sf, Time duration, double frequencyMHz)=0
	Start receiving a packet.

Public Member Functions inherited from ns3::Object
	Object ()
	Constructor.

	~Object () override
	Destructor.

void	AggregateObject (Ptr< Object > other)
	Aggregate two Objects together.

void	Dispose ()
	Dispose of this Object.

AggregateIterator	GetAggregateIterator () const
	Get an iterator to the Objects aggregated to this one.

TypeId	GetInstanceTypeId () const override
	Get the most derived TypeId for this Object.

template<typename T >
Ptr< T >	GetObject () const
	Get a pointer to the requested aggregated Object.

template<>
Ptr< Object >	GetObject () const
	Specialization of () for objects of type ns3::Object.

template<typename T >
Ptr< T >	GetObject (TypeId tid) const
	Get a pointer to the requested aggregated Object by TypeId.

template<>
Ptr< Object >	GetObject (TypeId tid) const
	Specialization of (TypeId tid) for objects of type ns3::Object.

void	Initialize ()
	Invoke DoInitialize on all Objects aggregated to this one.

bool	IsInitialized () const
	Check if the object has been initialized.

void	UnidirectionalAggregateObject (Ptr< Object > other)
	Aggregate an Object to another Object.

Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	SimpleRefCount ()
	Default constructor.

	SimpleRefCount (const SimpleRefCount &o)
	Copy constructor.

uint32_t	GetReferenceCount () const
	Get the reference count of the object.

SimpleRefCount &	operator= (const SimpleRefCount &o)
	Assignment operator.

void	Ref () const
	Increment the reference count.

void	Unref () const
	Decrement the reference count.

Public Member Functions inherited from ns3::ObjectBase
virtual	~ObjectBase ()
	Virtual destructor.

void	GetAttribute (std::string name, AttributeValue &value) const
	Get the value of an attribute, raising fatal errors if unsuccessful.

bool	GetAttributeFailSafe (std::string name, AttributeValue &value) const
	Get the value of an attribute without raising errors.

virtual TypeId	GetInstanceTypeId () const =0
	Get the most derived TypeId for this Object.

void	SetAttribute (std::string name, const AttributeValue &value)
	Set a single attribute, raising fatal errors if unsuccessful.

bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)
	Set a single attribute without raising errors.

bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)
	Connect a TraceSource to a Callback with a context.

bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
	Connect a TraceSource to a Callback without a context.

bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected with a context.

bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected without a context.

Static Public Member Functions
static TypeId	GetTypeId ()
	Register this type.

Static Public Member Functions inherited from ns3::lorawan::GatewayLoraPhy
static TypeId	GetTypeId ()
	Register this type.

Static Public Member Functions inherited from ns3::lorawan::LoraPhy
static Time	GetOnAirTime (Ptr< Packet > packet, LoraTxParameters txParams)
	Compute the time that a packet with certain characteristics will take to be transmitted.

static Time	GetTSym (LoraTxParameters txParams)
	Compute the symbol time from spreading factor and bandwidth.

static TypeId	GetTypeId ()
	Register this type.

Static Public Member Functions inherited from ns3::Object
static TypeId	GetTypeId ()
	Register this type.

Static Public Member Functions inherited from ns3::ObjectBase
static TypeId	GetTypeId ()
	Get the type ID.

Additional Inherited Members
Public Types inherited from ns3::lorawan::LoraPhy
typedef Callback< void, Ptr< const Packet > >	RxFailedCallback
	Type definition for a callback for when a packet reception fails.

typedef Callback< void, Ptr< const Packet > >	RxOkCallback
	Type definition for a callback for when a packet is correctly received.

typedef Callback< void, Ptr< const Packet > >	TxFinishedCallback
	Type definition for a callback to call when a packet has finished sending.

Static Public Attributes inherited from ns3::lorawan::GatewayLoraPhy
static const double	sensitivity [6] = {-130.0, -132.5, -135.0, -137.5, -140.0, -142.5}
	A vector containing the sensitivities required to correctly decode different spreading factors.

Protected Member Functions inherited from ns3::lorawan::GatewayLoraPhy
void	TxFinished (Ptr< const Packet > packet) override
	Signals the end of a transmission by the GatewayLoraPhy.

Protected Member Functions inherited from ns3::Object
	Object (const Object &o)
	Copy an Object.

virtual void	DoDispose ()
	Destructor implementation.

virtual void	DoInitialize ()
	Initialize() implementation.

virtual void	NotifyNewAggregate ()
	Notify all Objects aggregated to this one of a new Object being aggregated.

Protected Member Functions inherited from ns3::ObjectBase
void	ConstructSelf (const AttributeConstructionList &attributes)
	Complete construction of ObjectBase; invoked by derived classes.

virtual void	NotifyConstructionCompleted ()
	Notifier called once the ObjectBase is fully constructed.

Protected Attributes inherited from ns3::lorawan::GatewayLoraPhy
std::list< double >	m_frequencies
	List of frequencies the GatewayLoraPhy is listening to.

bool	m_isTransmitting
	Flag indicating whether a transmission is going on.

TracedCallback< Ptr< const Packet >, uint32_t >	m_noMoreDemodulators
	Trace source fired when a packet cannot be received because all available ReceivePath instances are busy.

TracedCallback< Ptr< const Packet >, uint32_t >	m_noReceptionBecauseTransmitting
	Trace source fired when a packet cannot be received because the gateway is in transmission state.

TracedValue< int >	m_occupiedReceptionPaths
	The number of occupied reception paths.

std::list< Ptr< ReceptionPath > >	m_receptionPaths
	A list containing the various parallel receivers that are managed by this gateway.

Protected Attributes inherited from ns3::lorawan::LoraPhy
Ptr< LoraChannel >	m_channel
	The channel this PHY transmits on.

Ptr< NetDevice >	m_device
	The net device this PHY is attached to.

TracedCallback< Ptr< const Packet >, uint32_t >	m_interferedPacket
	The trace source fired when a packet cannot be correctly received because of interference.

LoraInterferenceHelper	m_interference
	The LoraInterferenceHelper associated to this PHY.

TracedCallback< Ptr< const Packet > >	m_phyRxBeginTrace
	The trace source fired when a packet begins the reception process from the medium.

TracedCallback< Ptr< const Packet > >	m_phyRxEndTrace
	The trace source fired when a packet reception ends.

RxFailedCallback	m_rxFailedCallback
	The callback to perform upon failed reception of a packet we were locked on.

RxOkCallback	m_rxOkCallback
	The callback to perform upon correct reception of a packet.

TracedCallback< Ptr< const Packet >, uint32_t >	m_startSending
	The trace source fired when a packet is sent.

TracedCallback< Ptr< const Packet >, uint32_t >	m_successfullyReceivedPacket
	The trace source fired when a packet was correctly received.

TxFinishedCallback	m_txFinishedCallback
	The callback to perform upon the end of a transmission.

TracedCallback< Ptr< const Packet >, uint32_t >	m_underSensitivity
	The trace source fired when a packet cannot be received because its power is below the sensitivity threshold.

Related Functions inherited from ns3::ObjectBase
static TypeId	GetObjectIid ()
	Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly.

Detailed Description

Class modeling a Lora SX1301 chip.

Definition at line 46 of file simple-gateway-lora-phy.h.

Constructor & Destructor Documentation

◆ SimpleGatewayLoraPhy()

ns3::lorawan::SimpleGatewayLoraPhy::SimpleGatewayLoraPhy ( )

Default constructor.

Definition at line 51 of file simple-gateway-lora-phy.cc.

References NS_LOG_FUNCTION_NOARGS.

◆ ~SimpleGatewayLoraPhy()

ns3::lorawan::SimpleGatewayLoraPhy::~SimpleGatewayLoraPhy ( )

override

Destructor.

Definition at line 56 of file simple-gateway-lora-phy.cc.

References NS_LOG_FUNCTION_NOARGS.

Member Function Documentation

◆ EndReceive()

void ns3::lorawan::SimpleGatewayLoraPhy::EndReceive	(	Ptr< Packet >	packet,
		Ptr< LoraInterferenceHelper::Event >	event
	)

overridevirtual

Finish reception of a packet.

This method is scheduled by StartReceive, based on the packet duration. By passing a LoraInterferenceHelper Event to this method, the class will be able to identify the packet that is being received among all those that were registered as interference by StartReceive.

Parameters

packet	The received packet.
event	The event that is tied to this packet in the LoraInterferenceHelper.

Implements ns3::lorawan::GatewayLoraPhy.

Definition at line 229 of file simple-gateway-lora-phy.cc.

References ns3::lorawan::LoraInterferenceHelper::IsDestroyedByInterference(), ns3::Callback< R, UArgs >::IsNull(), ns3::lorawan::LoraPhy::m_device, ns3::lorawan::LoraPhy::m_interferedPacket, ns3::lorawan::LoraPhy::m_interference, ns3::lorawan::GatewayLoraPhy::m_occupiedReceptionPaths, ns3::lorawan::LoraPhy::m_phyRxEndTrace, ns3::lorawan::GatewayLoraPhy::m_receptionPaths, ns3::lorawan::LoraPhy::m_rxOkCallback, ns3::lorawan::LoraPhy::m_successfullyReceivedPacket, NS_LOG_DEBUG, NS_LOG_FUNCTION, NS_LOG_INFO, ns3::lorawan::LoraTag::SetDestroyedBy(), ns3::lorawan::LoraTag::SetFrequency(), and ns3::lorawan::LoraTag::SetReceivePower().

Here is the call graph for this function:

◆ GetTypeId()

TypeId ns3::lorawan::SimpleGatewayLoraPhy::GetTypeId ( )

static

Register this type.

Returns: The object TypeId.

Definition at line 41 of file simple-gateway-lora-phy.cc.

References ns3::TypeId::SetParent().

Here is the call graph for this function:

◆ Send()

void ns3::lorawan::SimpleGatewayLoraPhy::Send	(	Ptr< Packet >	packet,
		LoraTxParameters	txParams,
		double	frequencyMHz,
		double	txPowerDbm
	)

overridevirtual

Instruct the PHY to send a packet according to some parameters.

Parameters

packet	The packet to send.
txParams	The desired transmission parameters.
frequencyMHz	The frequency on which to transmit.
txPowerDbm	The power in dBm with which to transmit the packet.

Implements ns3::lorawan::GatewayLoraPhy.

Definition at line 62 of file simple-gateway-lora-phy.cc.

References ns3::Simulator::Cancel(), ns3::lorawan::LoraPhy::GetOnAirTime(), ns3::lorawan::LoraPhy::m_channel, ns3::lorawan::LoraPhy::m_device, ns3::lorawan::GatewayLoraPhy::m_isTransmitting, ns3::lorawan::GatewayLoraPhy::m_noReceptionBecauseTransmitting, ns3::lorawan::GatewayLoraPhy::m_receptionPaths, ns3::lorawan::LoraPhy::m_startSending, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), ns3::lorawan::LoraTxParameters::sf, and ns3::lorawan::GatewayLoraPhy::TxFinished().

Here is the call graph for this function:

◆ StartReceive()

void ns3::lorawan::SimpleGatewayLoraPhy::StartReceive	(	Ptr< Packet >	packet,
		double	rxPowerDbm,
		uint8_t	sf,
		Time	duration,
		double	frequencyMHz
	)

overridevirtual

Start receiving a packet.

This method is typically called by LoraChannel.

Parameters

packet	The packet that is arriving at this PHY layer.
rxPowerDbm	The power of the arriving packet (assumed to be constant for the whole reception).
sf	The Spreading Factor of the arriving packet.
duration	The on air time of this packet.
frequencyMHz	The frequency this packet is being transmitted on.

Implements ns3::lorawan::GatewayLoraPhy.

Definition at line 122 of file simple-gateway-lora-phy.cc.

References ns3::lorawan::LoraInterferenceHelper::Add(), ns3::lorawan::LoraPhy::EndReceive(), ns3::lorawan::LoraPhy::m_device, ns3::lorawan::LoraPhy::m_interference, ns3::lorawan::GatewayLoraPhy::m_isTransmitting, ns3::lorawan::GatewayLoraPhy::m_noMoreDemodulators, ns3::lorawan::GatewayLoraPhy::m_noReceptionBecauseTransmitting, ns3::lorawan::GatewayLoraPhy::m_occupiedReceptionPaths, ns3::lorawan::LoraPhy::m_phyRxBeginTrace, ns3::lorawan::LoraPhy::m_phyRxEndTrace, ns3::lorawan::GatewayLoraPhy::m_receptionPaths, ns3::lorawan::LoraPhy::m_underSensitivity, NS_LOG_FUNCTION, NS_LOG_INFO, ns3::Simulator::Schedule(), and ns3::lorawan::GatewayLoraPhy::sensitivity.

Here is the call graph for this function:

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

src/lorawan/model/simple-gateway-lora-phy.h
src/lorawan/model/simple-gateway-lora-phy.cc

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SimpleGatewayLoraPhy()

◆ ~SimpleGatewayLoraPhy()

Member Function Documentation

◆ EndReceive()

◆ GetTypeId()

◆ Send()

◆ StartReceive()