/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
//
// Copyright (c) 2007 Emmanuelle Laprise
//
// 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: Emmanuelle Laprise <emmanuelle.laprise@bluekazoo.ca>
//

#ifndef __CSMA_CD_IPV4_TOPOLOGY_H__
#define __CSMA_CD_IPV4_TOPOLOGY_H__

#include "ns3/ptr.h"
#include "ns3/ipv4-address.h"
#include "ns3/ipv4.h"
#include "ns3/ipv4-route.h"
#include "ns3/internet-node.h"
#include "ns3/csma-cd-net-device.h"

// The topology class consists of only static methods thar are used to
// create the topology and data flows for an ns3 simulation

namespace ns3 {

class CsmaCdIpv4Channel;
class Node;
class IPAddr;
class DataRate;
class Queue;

/**
 * \brief A helper class to create Topologies based on the
 * InternetNodes and CsmaCdChannels. Either the
 * SimpleCsmaCdNetDevice or the LLCCsmaCdNetDevice can be used
 * when constructing these topologies.
 */
class CsmaCdIpv4Topology {
public:

  /**
   * \param n1 Node to be attached to the Csma/Cd channel
   * \param ch CsmaCdChannel to which node n1 should be attached
   * \param addr Mac address of the node
   *
   * Add a Csma/Cd node to a Csma/Cd channel. This function adds
   * a EthernetCsmaCdNetDevice to the nodes so that they can
   * connect to a CsmaCdChannel. This means that Ethernet headers
   * and trailers will be added to the packet before sending out on
   * the net device.
   * 
   * \return ifIndex of the device
   */
  static uint32_t AddIpv4CsmaCdNode( Ptr<Node> n1,
                                 Ptr<CsmaCdChannel> ch,
                                 MacAddress addr);

  /**
   * \param n1 Node to be attached to the Csma/Cd channel
   * \param ch CsmaCdChannel to which node n1 should be attached
   * \param addr Mac address of the node
   *
   * Add a Csma/Cd node to a Csma/Cd channel. This function adds
   * a RawCsmaCdNetDevice to the nodes so that they can connect
   * to a CsmaCdChannel.
   */
  static void AddIpv4RawCsmaCdNode( Ptr<Node> n1,
                                    Ptr<CsmaCdChannel> ch,
                                    MacAddress addr);

  /**
   * \param n1 Node to be attached to the Csma/Cd channel
   * \param ch CsmaCdChannel to which node n1 should be attached
   * \param addr Mac address of the node
   *
   * Add a Csma/Cd node to a Csma/Cd channel. This function adds
   * a LlcCsmaCdNetDevice to the nodes so that they can connect
   * to a CsmaCdChannel.
   */
  static void AddIpv4LlcCsmaCdNode( Ptr<Node> n1,
                                    Ptr<CsmaCdChannel> ch,
                                    MacAddress addr);



  /** 
   * \param n1 Node
   * \param ndNum NetDevice number with which to associate address
   * \param addr1 Ipv4 Address for ndNum of n1
   * \param network network mask for ndNum of node n1
   * 
   * Add an Ipv4Address to the Ipv4 interface associated with the
   * ndNum CsmaCdIpv4NetDevices on the provided
   * CsmaCdIpv4Channel
   */
  static void AddIpv4Address(Ptr<Node> n1, int ndNum, 
                             const Ipv4Address& addr1,
                             const Ipv4Mask& netmask1);

  /**
   * \param nd1 Node
   * \param nd2 Node
   * 
   * Add an IPV4 host route between the two specified net devices
   */
  static void AddIpv4Routes (Ptr<NetDevice> nd1, Ptr<NetDevice> nd2);
};

} // namespace ns3

#endif