A Discrete-Event Network Simulator
API
hwmp-protocol-mac.h
Go to the documentation of this file.
1/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2/*
3 * Copyright (c) 2008,2009 IITP RAS
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation;
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 *
18 * Author: Kirill Andreev <andreev@iitp.ru>
19 */
20
21#ifndef HWMP_STATE_H
22#define HWMP_STATE_H
23
24#include "ns3/mesh-wifi-interface-mac-plugin.h"
25#include "ns3/hwmp-protocol.h"
26
27namespace ns3 {
28
29class MeshWifiInterfaceMac;
30class WifiActionHeader;
31
32namespace dot11s {
33
34class IePreq;
35class IePrep;
36class IePerr;
37
44{
45public:
52 HwmpProtocolMac (uint32_t ifIndex, Ptr<HwmpProtocol> protocol);
54
55 // Inherited from MAC plugin
57 bool Receive (Ptr<Packet> packet, const WifiMacHeader & header);
59 // Update beacon is empty, because HWMP does not know anything about beacons
60 void UpdateBeacon (MeshWifiBeacon & beacon) const {};
61 int64_t AssignStreams (int64_t stream);
62
63private:
65 friend class HwmpProtocol;
72
76 void SendPreq (IePreq preq);
81 void SendPreqVector (std::vector<IePreq> preq);
87 void SendPrep (IePrep prep, Mac48Address receiver);
93 void ForwardPerr (std::vector<HwmpProtocol::FailedDestination> destinations, std::vector<Mac48Address> receivers);
99 void InitiatePerr (std::vector<HwmpProtocol::FailedDestination> destinations, std::vector<Mac48Address> receivers);
107 void RequestDestination (Mac48Address dest, uint32_t originator_seqno, uint32_t dst_seqno);
109
111 void SendMyPreq ();
113 void SendMyPerr ();
118 uint32_t GetLinkMetric (Mac48Address peerAddress) const;
123 uint16_t GetChannelId () const;
128 void Report (std::ostream & os) const;
130 void ResetStats ();
131private:
135
139 std::vector<IePreq> m_myPreq;
141
146 struct MyPerr {
147 std::vector<HwmpProtocol::FailedDestination> destinations;
148 std::vector<Mac48Address> receivers;
149 };
152
155
160 {
161 uint16_t txPreq;
162 uint16_t rxPreq;
163 uint16_t txPrep;
164 uint16_t rxPrep;
165 uint16_t txPerr;
166 uint16_t rxPerr;
167 uint16_t txMgt;
169 uint16_t rxMgt;
171 uint16_t txData;
173 uint16_t rxData;
179 void Print (std::ostream & os) const;
180 Statistics ();
181 };
182
185
186private:
194 bool ReceiveData (Ptr<Packet> packet, const WifiMacHeader & header);
202 bool ReceiveAction (Ptr<Packet> packet, const WifiMacHeader & header);
203};
204} // namespace dot11s
205} // namespace ns3
206#endif
An identifier for simulation events.
Definition: event-id.h:54
an EUI-48 address
Definition: mac48-address.h:44
Beacon is beacon header + list of arbitrary information elements.
Common interface for mesh point interface MAC plugins.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:74
See IEEE 802.11 chapter 7.3.1.11 Header format: | category: 1 | action value: 1 |.
Definition: mgt-headers.h:885
Implements the IEEE 802.11 MAC header.
Hybrid wireless mesh protocol – a mesh routing protocol defined in IEEE 802.11-2012 standard.
Definition: hwmp-protocol.h:64
Interface MAC plugin for HWMP – 802.11s routing protocol.
static WifiActionHeader GetWifiActionHeader()
void SendMyPreq()
Sends one PREQ when PreqMinInterval after last PREQ expires (if any PREQ exists in rhe queue)
void SendPreq(IePreq preq)
Send PREQ function.
HwmpProtocolMac(uint32_t ifIndex, Ptr< HwmpProtocol > protocol)
Constructor.
void SendPreqVector(std::vector< IePreq > preq)
Send PREQ function for vector of PREQ.
void SendPrep(IePrep prep, Mac48Address receiver)
Send PREP function.
void SendMyPerr()
Send PERR function.
uint16_t GetChannelId() const
Get the channel ID.
void ForwardPerr(std::vector< HwmpProtocol::FailedDestination > destinations, std::vector< Mac48Address > receivers)
Forward a path error.
Ptr< HwmpProtocol > m_protocol
protocol
bool ReceiveData(Ptr< Packet > packet, const WifiMacHeader &header)
Receive data frame.
Statistics m_stats
statistics
bool Receive(Ptr< Packet > packet, const WifiMacHeader &header)
Process received frame.
EventId m_preqTimer
Timer for PREQs.
void ResetStats()
Reset statistics.
uint32_t GetLinkMetric(Mac48Address peerAddress) const
bool ReceiveAction(Ptr< Packet > packet, const WifiMacHeader &header)
Receive action management frame.
void InitiatePerr(std::vector< HwmpProtocol::FailedDestination > destinations, std::vector< Mac48Address > receivers)
initiate my own path error
void UpdateBeacon(MeshWifiBeacon &beacon) const
Update beacon before it will be formed and sent.
std::vector< IePreq > m_myPreq
container of PREQs
void SetParent(Ptr< MeshWifiInterfaceMac > parent)
Each plugin must be installed on an interface to work.
void Report(std::ostream &os) const
Report statistics.
bool UpdateOutcomingFrame(Ptr< Packet > packet, WifiMacHeader &header, Mac48Address from, Mac48Address to)
Update frame before it will be forwarded down.
Ptr< MeshWifiInterfaceMac > m_parent
parent
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model.
void RequestDestination(Mac48Address dest, uint32_t originator_seqno, uint32_t dst_seqno)
Request a destination.
See 7.3.2.97 of 802.11s draft 2.07.
See 7.3.2.96 of 802.11s draft 2.07.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
std::vector< HwmpProtocol::FailedDestination > destinations
destinations
std::vector< Mac48Address > receivers
receivers
uint32_t txMgtBytes
transmit management bytes
void Print(std::ostream &os) const
Print function.
uint32_t txDataBytes
transmit data bytes
uint32_t rxMgtBytes
receive management bytes