satellite-geo-mac.h

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: Bastien Tauran <bastien.tauran@viveris.fr>
 */
 
#ifndef SATELLITE_GEO_MAC_H
#define SATELLITE_GEO_MAC_H
 
#include "satellite-fwd-link-scheduler.h"
#include "satellite-geo-user-llc.h"
#include "satellite-mac.h"
#include "satellite-phy.h"
#include "satellite-signal-parameters.h"
 
#include <ns3/address.h>
#include <ns3/nstime.h>
#include <ns3/object.h>
#include <ns3/packet.h>
#include <ns3/ptr.h>
 
namespace ns3
{
 
class SatGeoMac : public SatMac
{
  public:
    SatGeoMac(void);
 
    SatGeoMac(uint32_t satId,
              uint32_t beamId,
              SatEnums::RegenerationMode_t forwardLinkRegenerationMode,
              SatEnums::RegenerationMode_t returnLinkRegenerationMode);
 
    virtual ~SatGeoMac();
 
    static TypeId GetTypeId(void);
    TypeId GetInstanceTypeId(void) const;
    virtual void DoInitialize(void);
 
    virtual void DoDispose(void);
 
    void StartPeriodicTransmissions();
 
    virtual void EnquePacket(Ptr<Packet> packet) = 0;
 
    void SetFwdScheduler(Ptr<SatFwdLinkScheduler> fwdScheduler);
 
    void SetLlc(Ptr<SatGeoLlc> llc);
 
    virtual Time GetGuardTime() const;
    virtual void SetGuardTime(Time guardTime);
 
    typedef Callback<void, Ptr<SatSignalParameters>> TransmitCallback;
 
    void SetTransmitCallback(SatGeoMac::TransmitCallback cb);
 
    typedef Callback<void, SatPhy::PacketContainer_t, Ptr<SatSignalParameters>>
        ReceiveNetDeviceCallback;
 
    void SetReceiveNetDeviceCallback(SatGeoMac::ReceiveNetDeviceCallback cb);
 
  protected:
    void StartTransmission(uint32_t carrierId);
 
    virtual void SendPacket(SatPhy::PacketContainer_t packets,
                            uint32_t carrierId,
                            Time duration,
                            SatSignalParameters::txInfo_s txInfo);
 
    virtual void RxTraces(SatPhy::PacketContainer_t packets);
 
    virtual SatEnums::SatLinkDir_t GetSatLinkTxDir() = 0;
 
    virtual SatEnums::SatLinkDir_t GetSatLinkRxDir() = 0;
 
    virtual Address GetRxUtAddress(Ptr<Packet> packet) = 0;
 
    Ptr<SatFwdLinkScheduler> m_fwdScheduler;
 
    Time m_guardTime;
 
    uint32_t m_satId;
 
    uint32_t m_beamId;
 
    Ptr<SatGeoLlc> m_llc;
 
    TracedCallback<Ptr<SatBbFrame>> m_bbFrameTxTrace;
 
    TransmitCallback m_txCallback;
    ReceiveNetDeviceCallback m_rxNetDeviceCallback;
};
 
} // namespace ns3
 
#endif /* SATELLITE_GEO_MAC_H */