satellite-channel.cc

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2013 Magister Solutions Ltd.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Author: Jani Puttonen <jani.puttonen@magister.fi>
 */
 
#include "satellite-channel.h"
 
#include "satellite-fading-external-input-trace-container.h"
#include "satellite-fading-output-trace-container.h"
#include "satellite-id-mapper.h"
#include "satellite-mac-tag.h"
#include "satellite-phy-rx.h"
#include "satellite-phy-tx.h"
#include "satellite-rx-cno-input-trace-container.h"
#include "satellite-rx-power-input-trace-container.h"
#include "satellite-rx-power-output-trace-container.h"
#include "satellite-utils.h"
 
#include "ns3/boolean.h"
#include "ns3/enum.h"
#include "ns3/log.h"
#include "ns3/mobility-model.h"
#include "ns3/net-device.h"
#include "ns3/node.h"
#include "ns3/object.h"
#include "ns3/packet.h"
#include "ns3/propagation-delay-model.h"
#include "ns3/simulator.h"
#include "ns3/singleton.h"
 
#include <algorithm>
#include <cstddef>
#include <utility>
#include <vector>
 
NS_LOG_COMPONENT_DEFINE("SatChannel");
 
namespace ns3
{
 
NS_OBJECT_ENSURE_REGISTERED(SatChannel);
 
SatChannel::SatChannel()
    : m_fwdMode(SatChannel::ONLY_DEST_BEAM),
      m_phyRxContainer(),
      m_channelType(SatEnums::UNKNOWN_CH),
      m_carrierFreqConverter(),
      m_freqId(),
      m_propagationDelay(),
      m_freeSpaceLoss(),
      m_rxPowerCalculationMode(SatEnums::RX_PWR_CALCULATION),
      /*
       * Currently, the Rx power calculation mode is fully independent of other
       * possible satellite network configurations, e.g. fading, antenna patterns.
       * TODO optimization: Tie Rx power calculation mode to other PHY/channel level
       * configurations. If using input Rx trace, there is no need to enable e.g. Markov
       * fading, nor antenna patterns.
       */
      m_enableRxPowerOutputTrace(false),
      m_enableFadingOutputTrace(false),
      m_enableExternalFadingInputTrace(false),
      m_satFadingExternalInputTraceContainer(nullptr)
{
    NS_LOG_FUNCTION(this);
}
 
void
SatChannel::NotifyConstructionCompleted()
{
    NS_LOG_FUNCTION(this);
 
    Channel::NotifyConstructionCompleted();
 
    if (m_enableExternalFadingInputTrace)
    {
        m_satFadingExternalInputTraceContainer =
            CreateObject<SatFadingExternalInputTraceContainer>();
    }
}
 
SatChannel::~SatChannel()
{
    NS_LOG_FUNCTION(this);
}
 
void
SatChannel::DoDispose()
{
    NS_LOG_FUNCTION(this);
    m_phyRxContainer.clear();
    m_propagationDelay = 0;
    Channel::DoDispose();
}
 
TypeId
SatChannel::GetTypeId(void)
{
    static TypeId tid =
        TypeId("ns3::SatChannel")
            .SetParent<Channel>()
            .AddConstructor<SatChannel>()
            .AddAttribute("EnableRxPowerOutputTrace",
                          "Enable Rx power output trace.",
                          BooleanValue(false),
                          MakeBooleanAccessor(&SatChannel::m_enableRxPowerOutputTrace),
                          MakeBooleanChecker())
            .AddAttribute("EnableFadingOutputTrace",
                          "Enable fading output trace.",
                          BooleanValue(false),
                          MakeBooleanAccessor(&SatChannel::m_enableFadingOutputTrace),
                          MakeBooleanChecker())
            .AddAttribute("EnableExternalFadingInputTrace",
                          "Enable external fading input trace.",
                          BooleanValue(false),
                          MakeBooleanAccessor(&SatChannel::m_enableExternalFadingInputTrace),
                          MakeBooleanChecker())
            .AddAttribute("RxPowerCalculationMode",
                          "Rx Power calculation mode",
                          EnumValue(SatEnums::RX_PWR_CALCULATION),
                          MakeEnumAccessor<SatEnums::RxPowerCalculationMode_t>(
                              &SatChannel::m_rxPowerCalculationMode),
                          MakeEnumChecker(SatEnums::RX_PWR_CALCULATION,
                                          "RxPowerCalculation",
                                          SatEnums::RX_PWR_INPUT_TRACE,
                                          "RxPowerInputTrace",
                                          SatEnums::RX_CNO_INPUT_TRACE,
                                          "RxCnoInputTrace"))
            .AddAttribute("ForwardingMode",
                          "Channel forwarding mode.",
                          EnumValue(SatChannel::ALL_BEAMS),
                          MakeEnumAccessor<SatChannel::SatChannelFwdMode_e>(&SatChannel::m_fwdMode),
                          MakeEnumChecker(SatChannel::ONLY_DEST_NODE,
                                          "OnlyDestNode",
                                          SatChannel::ONLY_DEST_BEAM,
                                          "OnlyDestBeam",
                                          SatChannel::ALL_BEAMS,
                                          "AllBeams"));
    return tid;
}
 
void
SatChannel::AddRx(Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << phyRx);
 
    m_phyRxContainer.push_back(phyRx);
}
 
void
SatChannel::RemoveRx(Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << phyRx);
 
    PhyRxContainer::iterator phyIter =
        std::find(m_phyRxContainer.begin(), m_phyRxContainer.end(), phyRx);
 
    if (phyIter != m_phyRxContainer.end()) // == vector.end() means the element was not found
    {
        m_phyRxContainer.erase(phyIter);
    }
}
 
void
SatChannel::StartTx(Ptr<SatSignalParameters> txParams)
{
    NS_LOG_FUNCTION(this << txParams);
    NS_ASSERT_MSG(txParams->m_phyTx, "NULL phyTx");
 
    switch (m_fwdMode)
    {
    case SatChannel::ONLY_DEST_NODE: {
        // For all receivers
        for (PhyRxContainer::const_iterator rxPhyIterator = m_phyRxContainer.begin();
             rxPhyIterator != m_phyRxContainer.end();
             ++rxPhyIterator)
        {
            // If the same beam
            if ((*rxPhyIterator)->GetBeamId() == txParams->m_beamId)
            {
                switch (m_channelType)
                {
                // If the destination is satellite
                case SatEnums::FORWARD_FEEDER_CH:
                case SatEnums::RETURN_USER_CH: {
                    // The packet burst is passed on to the satellite receiver
                    ScheduleRx(txParams, *rxPhyIterator);
                    break;
                }
                // If the destination is terrestrial node
                case SatEnums::FORWARD_USER_CH:
                case SatEnums::RETURN_FEEDER_CH: {
                    // Go through the packets and check their destination address by peeking the MAC
                    // tag
                    SatSignalParameters::PacketsInBurst_t::const_iterator it =
                        txParams->m_packetsInBurst.begin();
                    for (; it != txParams->m_packetsInBurst.end(); ++it)
                    {
                        SatMacTag macTag;
                        bool mSuccess = (*it)->PeekPacketTag(macTag);
                        if (!mSuccess)
                        {
                            NS_FATAL_ERROR("MAC tag was not found from the packet!");
                        }
 
                        Mac48Address dest = macTag.GetDestAddress();
 
                        // If the packet destination is the same as the receiver MAC
                        if (dest == (*rxPhyIterator)->GetAddress() || dest.IsBroadcast() ||
                            dest.IsGroup())
                        {
                            ScheduleRx(txParams, *rxPhyIterator);
 
                            // Remember to break the packet loop, so that the transmission
                            // is not received several times!
                            break;
                        }
                    }
                    break;
                }
                default: {
                    NS_FATAL_ERROR("Unsupported channel type!");
                    break;
                }
                }
            }
        }
        break;
    }
    case SatChannel::ONLY_DEST_BEAM: {
        for (PhyRxContainer::const_iterator rxPhyIterator = m_phyRxContainer.begin();
             rxPhyIterator != m_phyRxContainer.end();
             ++rxPhyIterator)
        {
            // If the same beam
            if ((*rxPhyIterator)->GetBeamId() == txParams->m_beamId)
            {
                ScheduleRx(txParams, *rxPhyIterator);
            }
        }
        break;
    }
    case SatChannel::ALL_BEAMS: {
        for (PhyRxContainer::const_iterator rxPhyIterator = m_phyRxContainer.begin();
             rxPhyIterator != m_phyRxContainer.end();
             ++rxPhyIterator)
        {
            ScheduleRx(txParams, *rxPhyIterator);
        }
        break;
    }
    default: {
        NS_FATAL_ERROR("Unsupported SatChannel FwdMode!");
        break;
    }
    }
}
 
void
SatChannel::ScheduleRx(Ptr<SatSignalParameters> txParams, Ptr<SatPhyRx> receiver)
{
    NS_LOG_FUNCTION(this << txParams << receiver);
 
    Time delay = Seconds(0);
 
    Ptr<MobilityModel> senderMobility = txParams->m_phyTx->GetMobility();
    Ptr<MobilityModel> receiverMobility = receiver->GetMobility();
 
    NS_LOG_INFO("copying signal parameters " << txParams);
    Ptr<SatSignalParameters> rxParams = txParams->Copy();
 
    if (m_propagationDelay)
    {
        delay = m_propagationDelay->GetDelay(senderMobility, receiverMobility);
    }
    else
    {
        NS_FATAL_ERROR("SatChannel::ScheduleRx - propagation delay model not set!");
    }
 
    NS_LOG_INFO("Setting propagation delay: " << delay);
 
    Ptr<NetDevice> netDev = receiver->GetDevice();
    uint32_t dstNodeId = netDev->GetNode()->GetId();
    Simulator::ScheduleWithContext(dstNodeId,
                                   delay,
                                   &SatChannel::StartRx,
                                   this,
                                   rxParams,
                                   receiver);
}
 
void
SatChannel::StartRx(Ptr<SatSignalParameters> rxParams, Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx);
 
    rxParams->m_channelType = m_channelType;
 
    double frequency_hz = m_carrierFreqConverter(m_channelType, m_freqId, rxParams->m_carrierId);
    rxParams->m_carrierFreq_hz = frequency_hz;
 
    switch (m_rxPowerCalculationMode)
    {
    case SatEnums::RX_PWR_CALCULATION: {
        DoRxPowerCalculation(rxParams, phyRx);
 
        if (m_enableRxPowerOutputTrace)
        {
            DoRxPowerOutputTrace(rxParams, phyRx);
        }
        break;
    }
    case SatEnums::RX_PWR_INPUT_TRACE: {
        DoRxPowerInputTrace(rxParams, phyRx);
        break;
    }
    case SatEnums::RX_CNO_INPUT_TRACE: {
        DoRxCnoInputTrace(rxParams, phyRx);
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::StartRx - Invalid Rx power calculation mode");
        break;
    }
    }
 
    phyRx->StartRx(rxParams);
}
 
void
SatChannel::DoRxPowerOutputTrace(Ptr<SatSignalParameters> rxParams, Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx);
 
    // Get the bandwidth of the currently used carrier
    double carrierBandwidthHz = m_carrierBandwidthConverter(m_channelType,
                                                            rxParams->m_carrierId,
                                                            SatEnums::EFFECTIVE_BANDWIDTH);
 
    NS_LOG_INFO("Carrier bw: " << carrierBandwidthHz
                               << ", rxPower: " << SatUtils::LinearToDb(rxParams->m_rxPower_W)
                               << ", carrierId: " << rxParams->m_carrierId
                               << ", channelType: " << SatEnums::GetChannelTypeName(m_channelType));
 
    std::vector<double> tempVector;
    tempVector.push_back(Now().GetSeconds());
 
    // Output the Rx power density (W / Hz)
    tempVector.push_back(rxParams->m_rxPower_W / carrierBandwidthHz);
 
    switch (m_channelType)
    {
    case SatEnums::RETURN_FEEDER_CH:
    case SatEnums::FORWARD_USER_CH: {
        Singleton<SatRxPowerOutputTraceContainer>::Get()->AddToContainer(
            std::make_pair(phyRx->GetDevice()->GetAddress(), m_channelType),
            tempVector);
        break;
    }
    case SatEnums::FORWARD_FEEDER_CH:
    case SatEnums::RETURN_USER_CH: {
        Singleton<SatRxPowerOutputTraceContainer>::Get()->AddToContainer(
            std::make_pair(GetSourceAddress(rxParams), m_channelType),
            tempVector);
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::DoRxPowerOutputTrace - Invalid channel type");
        break;
    }
    }
}
 
void
SatChannel::DoRxPowerInputTrace(Ptr<SatSignalParameters> rxParams, Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx);
 
    // Get the bandwidth of the currently used carrier
    double carrierBandwidthHz = m_carrierBandwidthConverter(m_channelType,
                                                            rxParams->m_carrierId,
                                                            SatEnums::EFFECTIVE_BANDWIDTH);
 
    switch (m_channelType)
    {
    case SatEnums::RETURN_FEEDER_CH:
    case SatEnums::FORWARD_USER_CH: {
        // Calculate the Rx power from Rx power density
        rxParams->m_rxPower_W =
            carrierBandwidthHz *
            Singleton<SatRxPowerInputTraceContainer>::Get()->GetRxPowerDensity(
                std::make_pair(phyRx->GetDevice()->GetAddress(), m_channelType));
 
        break;
    }
    case SatEnums::FORWARD_FEEDER_CH:
    case SatEnums::RETURN_USER_CH: {
        // Calculate the Rx power from Rx power density
        rxParams->m_rxPower_W =
            carrierBandwidthHz * Singleton<SatRxPowerInputTraceContainer>::Get()->GetRxPowerDensity(
                                     std::make_pair(GetSourceAddress(rxParams), m_channelType));
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::DoRxPowerInputTrace - Invalid channel type");
        break;
    }
    }
 
    NS_LOG_INFO("Carrier bw: " << carrierBandwidthHz
                               << ", rxPower: " << SatUtils::LinearToDb(rxParams->m_rxPower_W)
                               << ", carrierId: " << rxParams->m_carrierId
                               << ", channelType: " << SatEnums::GetChannelTypeName(m_channelType));
 
    // get external fading input trace
    if (m_enableExternalFadingInputTrace)
    {
        rxParams->m_rxPower_W /= GetExternalFadingTrace(rxParams, phyRx);
    }
}
 
void
SatChannel::DoRxCnoInputTrace(Ptr<SatSignalParameters> rxParams, Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx);
 
    /* Get the required parameters
     *
     * We have C/N0 = B*P/N
     * So P = N/B * C/N0
     * Where:
     * B is the carrier bandwidth
     * N is the noise
     * P is the required power to get the selected C/N0
     */
    double cno;
    double carrierBandwidthHz = m_carrierBandwidthConverter(m_channelType,
                                                            rxParams->m_carrierId,
                                                            SatEnums::EFFECTIVE_BANDWIDTH);
    double rxTemperatureK = phyRx->GetRxTemperatureK(rxParams);
    ;
    double rxNoisePowerW =
        SatConstVariables::BOLTZMANN_CONSTANT * rxTemperatureK * carrierBandwidthHz;
 
    switch (m_channelType)
    {
    case SatEnums::RETURN_FEEDER_CH:
    case SatEnums::FORWARD_USER_CH: {
        // Calculate the Rx power from C/N0
        cno = Singleton<SatRxCnoInputTraceContainer>::Get()->GetRxCno(
            std::make_pair(phyRx->GetDevice()->GetAddress(), m_channelType));
        if (cno == 0)
        {
            DoRxPowerCalculation(rxParams, phyRx);
            NS_LOG_INFO("Use calculation downlink \t" << cno << " " << carrierBandwidthHz << " "
                                                      << rxNoisePowerW << " "
                                                      << rxParams->m_rxPower_W);
            return;
        }
        rxParams->m_rxPower_W = rxNoisePowerW * cno / carrierBandwidthHz;
        NS_LOG_INFO("Channel downlink \t" << cno << " " << carrierBandwidthHz << " "
                                          << rxNoisePowerW << " "
                                          << rxNoisePowerW * cno / carrierBandwidthHz);
        break;
    }
    case SatEnums::FORWARD_FEEDER_CH:
    case SatEnums::RETURN_USER_CH: {
        // Calculate the Rx power from C/N0
        cno = Singleton<SatRxCnoInputTraceContainer>::Get()->GetRxCno(
            std::make_pair(GetSourceAddress(rxParams), m_channelType));
        if (cno == 0)
        {
            DoRxPowerCalculation(rxParams, phyRx);
            NS_LOG_INFO("Use calculation uplink   \t" << cno << " " << carrierBandwidthHz << " "
                                                      << rxNoisePowerW << " "
                                                      << rxParams->m_rxPower_W);
            return;
        }
        rxParams->m_rxPower_W = rxNoisePowerW * cno / carrierBandwidthHz;
        NS_LOG_INFO("Channel uplink   \t" << cno << " " << carrierBandwidthHz << " "
                                          << rxNoisePowerW << " "
                                          << rxNoisePowerW * cno / carrierBandwidthHz);
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::DoRxCnoInputTrace - Invalid channel type");
        break;
    }
    }
 
    NS_LOG_INFO("Target C/N0: " << cno << ", carrier bw: " << carrierBandwidthHz
                                << ", rxPower: " << SatUtils::LinearToDb(rxParams->m_rxPower_W)
                                << ", carrierId: " << rxParams->m_carrierId << ", channelType: "
                                << SatEnums::GetChannelTypeName(m_channelType));
 
    // get external fading input trace
    if (m_enableExternalFadingInputTrace)
    {
        rxParams->m_rxPower_W /= GetExternalFadingTrace(rxParams, phyRx);
    }
}
 
void
SatChannel::DoFadingOutputTrace(Ptr<SatSignalParameters> rxParams,
                                Ptr<SatPhyRx> phyRx,
                                double fadingValue)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx << fadingValue);
 
    std::vector<double> tempVector;
    tempVector.push_back(Now().GetSeconds());
    tempVector.push_back(fadingValue);
 
    switch (m_channelType)
    {
    case SatEnums::RETURN_FEEDER_CH:
    case SatEnums::FORWARD_USER_CH: {
        Singleton<SatFadingOutputTraceContainer>::Get()->AddToContainer(
            std::make_pair(phyRx->GetDevice()->GetAddress(), m_channelType),
            tempVector);
        break;
    }
    case SatEnums::FORWARD_FEEDER_CH:
    case SatEnums::RETURN_USER_CH: {
        Singleton<SatFadingOutputTraceContainer>::Get()->AddToContainer(
            std::make_pair(GetSourceAddress(rxParams), m_channelType),
            tempVector);
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::DoFadingOutputTrace - Invalid channel type");
        break;
    }
    }
}
 
void
SatChannel::DoRxPowerCalculation(Ptr<SatSignalParameters> rxParams, Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx);
 
    Ptr<MobilityModel> txMobility = rxParams->m_phyTx->GetMobility();
    Ptr<MobilityModel> rxMobility = phyRx->GetMobility();
 
    double txAntennaGain_W = 0.0;
    double rxAntennaGain_W = 0.0;
    double markovFading = 0.0;
    double extFading = 1.0;
 
    // use always UT's or GW's position when getting antenna gain
    switch (m_channelType)
    {
    case SatEnums::RETURN_FEEDER_CH:
    case SatEnums::FORWARD_USER_CH: {
        txAntennaGain_W = rxParams->m_phyTx->GetAntennaGain(rxMobility);
        rxAntennaGain_W = phyRx->GetAntennaGain(rxMobility);
        markovFading = phyRx->GetFadingValue(phyRx->GetDevice()->GetAddress(), m_channelType);
        break;
    }
    case SatEnums::RETURN_USER_CH:
    case SatEnums::FORWARD_FEEDER_CH: {
        txAntennaGain_W = rxParams->m_phyTx->GetAntennaGain(txMobility);
        rxAntennaGain_W = phyRx->GetAntennaGain(txMobility);
        markovFading = rxParams->m_phyTx->GetFadingValue(GetSourceAddress(rxParams), m_channelType);
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::DoRxPowerCalculation - Invalid channel type");
        break;
    }
    }

    if (m_enableExternalFadingInputTrace)
    {
        extFading = GetExternalFadingTrace(rxParams, phyRx);
    }

    if (m_enableFadingOutputTrace)
    {
        DoFadingOutputTrace(rxParams, phyRx, markovFading);
    }
 
    // get (calculate) free space loss and RX power and set it to RX params
    double rxPower_W = (rxParams->m_txPower_W * txAntennaGain_W) /
                       m_freeSpaceLoss->GetFsl(txMobility, rxMobility, rxParams->m_carrierFreq_hz);
    rxParams->m_rxPower_W =
        rxPower_W * rxAntennaGain_W / phyRx->GetLosses() * markovFading / extFading;
}
 
double
SatChannel::GetExternalFadingTrace(Ptr<SatSignalParameters> rxParams, Ptr<SatPhyRx> phyRx)
{
    NS_LOG_FUNCTION(this << rxParams << phyRx);
 
    int32_t nodeId;
    Ptr<MobilityModel> mobility;
 
    switch (m_channelType)
    {
    case SatEnums::RETURN_FEEDER_CH: {
        nodeId = Singleton<SatIdMapper>::Get()->GetGwIdWithMac(phyRx->GetDevice()->GetAddress());
        mobility = phyRx->GetMobility();
        break;
    }
    case SatEnums::FORWARD_USER_CH: {
        nodeId = Singleton<SatIdMapper>::Get()->GetUtIdWithMac(phyRx->GetDevice()->GetAddress());
        mobility = phyRx->GetMobility();
        break;
    }
    case SatEnums::RETURN_USER_CH: {
        nodeId = Singleton<SatIdMapper>::Get()->GetUtIdWithMac(GetSourceAddress(rxParams));
        mobility = rxParams->m_phyTx->GetMobility();
        break;
    }
    case SatEnums::FORWARD_FEEDER_CH: {
        nodeId = Singleton<SatIdMapper>::Get()->GetGwIdWithMac(GetSourceAddress(rxParams));
        mobility = rxParams->m_phyTx->GetMobility();
        break;
    }
    default: {
        NS_FATAL_ERROR("SatChannel::GetExternalFadingTrace - Invalid channel type");
        break;
    }
    }
 
    if (nodeId < 0)
    {
        NS_FATAL_ERROR("SatChannel::GetExternalFadingTrace - Invalid node ID");
    }
 
    return (m_satFadingExternalInputTraceContainer->GetFadingTrace((uint32_t)nodeId,
                                                                   m_channelType,
                                                                   mobility))
        ->GetFading();
}

Mac48Address
SatChannel::GetSourceAddress(Ptr<SatSignalParameters> rxParams)
{
    NS_LOG_FUNCTION(this << rxParams);
 
    SatMacTag tag;
 
    SatSignalParameters::PacketsInBurst_t::const_iterator i = rxParams->m_packetsInBurst.begin();
 
    if (*i == nullptr)
    {
        NS_FATAL_ERROR("SatChannel::GetSourceAddress - Empty packet list");
    }
 
    (*i)->PeekPacketTag(tag);
 
    return tag.GetSourceAddress();
}
 
void
SatChannel::SetChannelType(SatEnums::ChannelType_t chType)
{
    NS_LOG_FUNCTION(this << chType);
    NS_ASSERT(chType != SatEnums::UNKNOWN_CH);
 
    m_channelType = chType;
}
 
void
SatChannel::SetFrequencyId(uint32_t freqId)
{
    NS_LOG_FUNCTION(this << freqId);
 
    m_freqId = freqId;
}
 
void
SatChannel::SetFrequencyConverter(CarrierFreqConverter converter)
{
    NS_LOG_FUNCTION(this << &converter);
 
    m_carrierFreqConverter = converter;
}
 
void
SatChannel::SetBandwidthConverter(SatTypedefs::CarrierBandwidthConverter_t converter)
{
    NS_LOG_FUNCTION(this << &converter);
 
    m_carrierBandwidthConverter = converter;
}
 
SatEnums::ChannelType_t
SatChannel::GetChannelType()
{
    NS_LOG_FUNCTION(this);
    NS_ASSERT(m_channelType != SatEnums::UNKNOWN_CH);
 
    return m_channelType;
}
 
void
SatChannel::SetPropagationDelayModel(Ptr<PropagationDelayModel> delay)
{
    NS_LOG_FUNCTION(this << delay);
    NS_ASSERT(m_propagationDelay == nullptr);
    m_propagationDelay = delay;
}
 
Ptr<PropagationDelayModel>
SatChannel::GetPropagationDelayModel()
{
    NS_LOG_FUNCTION(this);
    NS_ASSERT(m_propagationDelay != nullptr);
 
    return m_propagationDelay;
}
 
void
SatChannel::SetFreeSpaceLoss(Ptr<SatFreeSpaceLoss> loss)
{
    NS_LOG_FUNCTION(this << loss);
    NS_ASSERT(m_freeSpaceLoss == nullptr);
    m_freeSpaceLoss = loss;
}
 
Ptr<SatFreeSpaceLoss>
SatChannel::GetFreeSpaceLoss() const
{
    NS_LOG_FUNCTION(this);
    NS_ASSERT(m_freeSpaceLoss != nullptr);
    return m_freeSpaceLoss;
}
 
std::size_t
SatChannel::GetNDevices(void) const
{
    NS_LOG_FUNCTION(this);
    return m_phyRxContainer.size();
}
 
Ptr<NetDevice>
SatChannel::GetDevice(std::size_t i) const
{
    NS_LOG_FUNCTION(this << i);
    return m_phyRxContainer.at(i)->GetDevice()->GetObject<NetDevice>();
}
 
} // namespace ns3