tomh/ns-3-dev-spectrum-wifi: comparison src/wifi/model/wifi-remote-station-manager.h

equal deleted inserted replaced

-:d203296efb63
+:072fb225b714
 /* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
 /*
 * Copyright (c) 2005,2006,2007 INRIA
 *
 * 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
 uint32_t GetFragmentationThreshold (void) const;
 void SetMaxSsrc (uint32_t maxSsrc);
 void SetMaxSlrc (uint32_t maxSlrc);
 void SetRtsCtsThreshold (uint32_t threshold);
 void SetFragmentationThreshold (uint32_t threshold);
 // Invoked in a STA upon dis-association
 // or in an AP upon reboot
 void Reset (void);
 // Invoked in a STA upon association to store
 // the set of rates which belong to the
 // BSSBasicRateSet of the associated AP
 // and which are supported locally.
 // Invoked in an AP to configure the BSSBasicRateSet
 void AddBasicMode (WifiMode mode);
 * Invoked in an AP upon disassociation of a
 * specific STA.
 */
 void Reset (Mac48Address address);
 /**
 * Invoked in a STA or AP to store the set of
 * modes supported by a destination which is
 * also supported locally.
 * The set of supported modes includes
 * the BSSBasicRateSet.
 */
 * Should be invoked whenever the AckTimeout associated to a transmission
 * attempt expires.
 */
 void ReportDataFailed (Mac48Address address, const WifiMacHeader *header);
 /**
 * Should be invoked whenever we receive the Cts associated to an RTS
 * we just sent.
 */
 void ReportRtsOk (Mac48Address address, const WifiMacHeader *header,
 double ctsSnr, WifiMode ctsMode, double rtsSnr);
 /**
 * we just sent.
 */
 void ReportDataOk (Mac48Address address, const WifiMacHeader *header,
 double ackSnr, WifiMode ackMode, double dataSnr);
 /**
 * Should be invoked after calling ReportRtsFailed if
 * NeedRtsRetransmission returns false
 */
 void ReportFinalRtsFailed (Mac48Address address, const WifiMacHeader *header);
 /**
 * Should be invoked after calling ReportDataFailed if
 * NeedDataRetransmission returns false
 */
 void ReportFinalDataFailed (Mac48Address address, const WifiMacHeader *header);
 /**
 Ptr<const Packet> packet);
 /**
 * \param address remote address
 * \param header MAC header
 * \param packet the packet to send
 * \returns true if we want to restart a failed RTS/CTS
 *          handshake, false otherwise.
 */
 bool NeedRtsRetransmission (Mac48Address address, const WifiMacHeader *header,
 Ptr<const Packet> packet);
 /**
 * \param address remote address
 * \param header MAC header
 * \param packet the packet to send
 * \returns true if we want to resend a packet
 *          after a failed transmission attempt, false otherwise.
 */
 bool NeedDataRetransmission (Mac48Address address, const WifiMacHeader *header,
 Ptr<const Packet> packet);
 * \param header MAC header
 * \param packet the packet to send
 * \returns true if this packet should be fragmented, false otherwise.
 */
 bool NeedFragmentation (Mac48Address address, const WifiMacHeader *header,
 Ptr<const Packet> packet);
 /**
 * \param address remote address
 * \param header MAC header
 * \param packet the packet to send
 * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).
 * \returns true if we want to use an RTS/CTS handshake for this
 *          packet before sending it, false otherwise.
 *
 * Note: This method is called before a unicast packet is sent on the medium.
 */
 virtual bool DoNeedRts (WifiRemoteStation *station,
 Ptr<const Packet> packet, bool normally);
 /**
 * \param station the station with which we need to communicate
 * \param packet the packet to send
 * \param normally indicates whether the normal 802.11 rts enable mechanism would
 *        request that the rts is retransmitted or not.
 * \returns true if we want to restart a failed RTS/CTS
 *          handshake, false otherwise.
 *
 * Note: This method is called after an rts/cts handshake has been attempted
 *       and has failed.
 */
 virtual bool DoNeedRtsRetransmission (WifiRemoteStation *station,
 Ptr<const Packet> packet, bool normally);
 /**
 * \param station the station with which we need to communicate
 * \param packet the packet to send
 * \param normally indicates whether the normal 802.11 data retransmission mechanism
 *        would request that the data is retransmitted or not.
 * \returns true if we want to resend a packet
 *          after a failed transmission attempt, false otherwise.
 *
 * Note: This method is called after a unicast packet transmission has been attempted
 *       and has failed.
 */
 virtual bool DoNeedDataRetransmission (WifiRemoteStation *station,
 Ptr<const Packet> packet, bool normally);
 /**
 * \param station the station with which we need to communicate
 * \param packet the packet to send
 *        would request that the data packet is fragmented or not.
 * \returns true if this packet should be fragmented, false otherwise.
 *
 * Note: This method is called before sending a unicast packet.
 */
 virtual bool DoNeedFragmentation (WifiRemoteStation *station,
 Ptr<const Packet> packet, bool normally);
 /**
 * \returns whether this manager is a manager designed to work in low-latency
 *          environments.
 *
 */
 virtual bool IsLowLatency (void) const = 0;
 /**
 * \return a new station data structure
 */
-virtual WifiRemoteStation *DoCreateStation (void) const = 0;
+virtual WifiRemoteStation* DoCreateStation (void) const = 0;
 /**
 * \param station the station with which we need to communicate
 * \param size size of the packet or fragment we want to send
 * \returns the transmission mode to use to send a packet to the station
 *
 virtual void DoReportFinalRtsFailed (WifiRemoteStation *station) = 0;
 virtual void DoReportFinalDataFailed (WifiRemoteStation *station) = 0;
 virtual void DoReportRxOk (WifiRemoteStation *station,
 double rxSnr, WifiMode txMode) = 0;
-WifiRemoteStationState *LookupState (Mac48Address address) const;
+WifiRemoteStationState* LookupState (Mac48Address address) const;
-WifiRemoteStation *Lookup (Mac48Address address, uint8_t tid) const;
+WifiRemoteStation* Lookup (Mac48Address address, uint8_t tid) const;
 /// Find a remote station by its remote address and TID taken from MAC header
-WifiRemoteStation *Lookup (Mac48Address address, const WifiMacHeader *header) const;
+WifiRemoteStation* Lookup (Mac48Address address, const WifiMacHeader *header) const;
 WifiMode GetControlAnswerMode (Mac48Address address, WifiMode reqMode);
 uint32_t GetNFragments (Ptr<const Packet> packet);
 typedef std::vector <WifiRemoteStation *> Stations;
 typedef std::vector <WifiRemoteStationState *> StationStates;
 /**
 * The trace source fired when the transmission of a single RTS has failed
 */
 TracedCallback<Mac48Address> m_macTxRtsFailed;
 /**
 * The trace source fired when the transmission of a single data packet has failed
 */
 TracedCallback<Mac48Address> m_macTxDataFailed;
 /**
 * The trace source fired when the transmission of a RTS has
 * exceeded the maximum number of attempts
 };
 struct WifiRemoteStationState
 {
 enum
 {
 BRAND_NEW,
 DISASSOC,
 WAIT_ASSOC_TX_OK,
 GOT_ASSOC_TX_OK
 } m_state;
 /**
 * This member is the list of WifiMode objects that comprise the
 * OperationalRateSet parameter for this remote station. This list
 * is constructed through calls to
 uint32_t m_slrc;
 uint8_t m_tid;
 };
 } // namespace ns3
 #endif /* WIFI_REMOTE_STATION_MANAGER_H */

changeset 7141	072fb225b714
parent 7139	79dd02ed46ec
child 7385	10beb0e53130