uan-phy-dual.h

Go to the documentation of this file.

/*
 * Copyright (c) 2009 University of Washington
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * Author: Leonard Tracy <lentracy@gmail.com>
 *         Andrea Sacco <andrea.sacco85@gmail.com>
 */
 
#ifndef UAN_PHY_DUAL_H
#define UAN_PHY_DUAL_H
 
#include "uan-phy.h"
 
namespace ns3
{
 
class UanTxMode;
class UanModesList;
 
/**
 * Default SINR model for UanPhyDual
 *
 * Considers interfering packet power as additional ambient noise only
 * if there is overlap in frequency band as found from supplied UanTxMode.
 * If there is no overlap, then the packets are considered not to interfere.
 */
class UanPhyCalcSinrDual : public UanPhyCalcSinr
{
  public:
    /** Constructor */
    UanPhyCalcSinrDual();
    /** Destructor */
    ~UanPhyCalcSinrDual() override;
 
    /**
     * Register this type.
     * @return The TypeId.
     */
    static TypeId GetTypeId();
 
    double CalcSinrDb(Ptr<Packet> pkt,
                      Time arrTime,
                      double rxPowerDb,
                      double ambNoiseDb,
                      UanTxMode mode,
                      UanPdp pdp,
                      const UanTransducer::ArrivalList& arrivalList) const override;
 
    // end of class UanPhyCalcSinrDual
};
 
/**
 * @ingroup uan
 *
 * Two channel Phy.
 *
 * A class that wraps two generic UAN Phy layers (UanPhyGen) into a single PHY.
 * This is used to simulate two receivers (and transmitters) that use
 * the same front end hardware.  When attached to a UanTransducerHd,
 * this results in a net device able to transmit on one or two channels
 * simultaneously or receive on one or two channels simultaneously but
 * that cannot transmit and receive simultaneously.
 *
 * Many of the standard PHY functions here become ambiguous.  In most cases
 * information for "Phy1" are returned.
 */
class UanPhyDual : public UanPhy
{
  public:
    /** Constructor */
    UanPhyDual();
    /** Dummy destructor \see DoDispose */
    ~UanPhyDual() override;
 
    /**
     * Register this type.
     * @return The TypeId.
     */
    static TypeId GetTypeId();
 
    // Inherited methods:
    void SetEnergyModelCallback(energy::DeviceEnergyModel::ChangeStateCallback callback) override;
    void EnergyDepletionHandler() override;
    void EnergyRechargeHandler() override;
    void SendPacket(Ptr<Packet> pkt, uint32_t modeNum) override;
 
    /**
     * Register a UanPhyListener to be notified of common UanPhy events.
     *
     * @param listener New listener to register.
     *
     * @note You may receive duplicate
     * messages as underneath there are two generic phys here.
     * Each will notify of state changes independently.
     */
    void RegisterListener(UanPhyListener* listener) override;
    void StartRxPacket(Ptr<Packet> pkt, double rxPowerDb, UanTxMode txMode, UanPdp pdp) override;
    void SetReceiveOkCallback(RxOkCallback cb) override;
    void SetReceiveErrorCallback(RxErrCallback cb) override;
    void SetTxPowerDb(double txpwr) override;
    void SetRxThresholdDb(double thresh) override;
    void SetCcaThresholdDb(double thresh) override;
    double GetTxPowerDb() override;
    double GetRxThresholdDb() override;
    double GetCcaThresholdDb() override;
    bool IsStateSleep() override;
    bool IsStateIdle() override;
    bool IsStateBusy() override;
    bool IsStateRx() override;
    bool IsStateTx() override;
    bool IsStateCcaBusy() override;
    Ptr<UanChannel> GetChannel() const override;
    Ptr<UanNetDevice> GetDevice() const override;
    void SetChannel(Ptr<UanChannel> channel) override;
    void SetDevice(Ptr<UanNetDevice> device) override;
    void SetMac(Ptr<UanMac> mac) override;
    void NotifyTransStartTx(Ptr<Packet> packet, double txPowerDb, UanTxMode txMode) override;
    void NotifyIntChange() override;
    void SetTransducer(Ptr<UanTransducer> trans) override;
    Ptr<UanTransducer> GetTransducer() override;
    uint32_t GetNModes() override;
    UanTxMode GetMode(uint32_t n) override;
    void Clear() override;
 
    void SetSleepMode(bool /* sleep */) override
    {
        /// @todo This method has to be implemented
    }
 
    int64_t AssignStreams(int64_t stream) override;
    Ptr<Packet> GetPacketRx() const override;
 
    /** @copydoc UanPhy::IsStateIdle */
    bool IsPhy1Idle();
    /** @copydoc UanPhy::IsStateIdle */
    bool IsPhy2Idle();
    /** @copydoc UanPhy::IsStateRx */
    bool IsPhy1Rx();
    /** @copydoc UanPhy::IsStateRx */
    bool IsPhy2Rx();
    /** @copydoc UanPhy::IsStateTx */
    bool IsPhy1Tx();
    /** @copydoc UanPhy::IsStateTx */
    bool IsPhy2Tx();
 
    // Attribute getters and setters
    /** @copydoc ns3::UanPhy::GetCcaThresholdDb() */
    double GetCcaThresholdPhy1() const;
    /** @copydoc UanPhy::GetCcaThresholdDb() */
    double GetCcaThresholdPhy2() const;
    /** @copydoc UanPhy::SetCcaThresholdDb */
    void SetCcaThresholdPhy1(double thresh);
    /** @copydoc UanPhy::SetCcaThresholdDb */
    void SetCcaThresholdPhy2(double thresh);
 
    /** @copydoc UanPhy::GetTxPowerDb */
    double GetTxPowerDbPhy1() const;
    /** @copydoc UanPhy::GetTxPowerDb */
    double GetTxPowerDbPhy2() const;
    /** @copydoc UanPhy::SetTxPowerDb */
    void SetTxPowerDbPhy1(double txpwr);
    /** @copydoc UanPhy::SetTxPowerDb */
    void SetTxPowerDbPhy2(double txpwr);
 
    /**
     * Get the list of available modes.
     *
     * @return The mode list.
     */
    UanModesList GetModesPhy1() const;
    /** @copydoc GetModesPhy1 */
    UanModesList GetModesPhy2() const;
 
    /**
     * Set the available modes.
     *
     * @param modes List of modes.
     */
    void SetModesPhy1(UanModesList modes);
    /** @copydoc SetModesPhy1 */
    void SetModesPhy2(UanModesList modes);
 
    /**
     * Get the error probability model.
     *
     * @return The error model.
     */
    Ptr<UanPhyPer> GetPerModelPhy1() const;
    /** @copydoc GetPerModelPhy1() */
    Ptr<UanPhyPer> GetPerModelPhy2() const;
 
    /**
     * Set the error probability model.
     *
     * @param per The error model.
     */
    void SetPerModelPhy1(Ptr<UanPhyPer> per);
    /** @copydoc SetPerModelPhy1 */
    void SetPerModelPhy2(Ptr<UanPhyPer> per);
 
    /**
     * Get the SINR calculator.
     *
     * @return The SINR calculator.
     */
    Ptr<UanPhyCalcSinr> GetSinrModelPhy1() const;
    /** @copydoc GetSinrModelPhy1 */
    Ptr<UanPhyCalcSinr> GetSinrModelPhy2() const;
 
    /**
     * Set the SINR calculator.
     *
     * @param calcSinr The SINR calculator.
     */
    void SetSinrModelPhy1(Ptr<UanPhyCalcSinr> calcSinr);
    /** @copydoc SetSinrModelPhy1 */
    void SetSinrModelPhy2(Ptr<UanPhyCalcSinr> calcSinr);
 
    /** @copydoc UanPhy::GetPacketRx */
    Ptr<Packet> GetPhy1PacketRx() const;
    /** @copydoc UanPhy::GetPacketRx */
    Ptr<Packet> GetPhy2PacketRx() const;
 
  private:
    /** First Phy layer. */
    Ptr<UanPhy> m_phy1;
    /** Second Phy layer. */
    Ptr<UanPhy> m_phy2;
 
    /** A packet was received successfully. */
    ns3::TracedCallback<Ptr<const Packet>, double, UanTxMode> m_rxOkLogger;
    /** A packet was received unsuccessfuly. */
    ns3::TracedCallback<Ptr<const Packet>, double, UanTxMode> m_rxErrLogger;
    /** A packet was sent from this Phy. */
    ns3::TracedCallback<Ptr<const Packet>, double, UanTxMode> m_txLogger;
    /** Callback when packet received without errors. */
    RxOkCallback m_recOkCb;
    /** Callback when packet received with errors. */
    RxErrCallback m_recErrCb;
 
    /**
     * Handle callback and logger for packets received without error.
     *
     * @param pkt The packet.
     * @param sinr The SINR.
     * @param mode The channel mode.
     */
    void RxOkFromSubPhy(Ptr<Packet> pkt, double sinr, UanTxMode mode);
    /**
     * Handle callback and logger for packets received with error.
     *
     * @param pkt The packet.
     * @param sinr The SINR.
     */
    void RxErrFromSubPhy(Ptr<Packet> pkt, double sinr);
 
  protected:
    void DoDispose() override;
 
    // end of class UanPhyDual
};
 
} // namespace ns3
 
#endif /* UAN_PHY_DUAL_H */