A Discrete-Event Network Simulator
Home
Tutorials ▼
English
Documentation ▼
Installation
Manual
Models
Contributing
Wiki
Development ▼
API Docs
Issue Tracker
Merge Requests
API
Loading...
Searching...
No Matches
wifi-tx-current-model.h
Go to the documentation of this file.
1
/*
2
* Copyright (c) 2014 Universita' degli Studi di Napoli "Federico II"
3
*
4
* This program is free software; you can redistribute it and/or modify
5
* it under the terms of the GNU General Public License version 2 as
6
* published by the Free Software Foundation;
7
*
8
* This program is distributed in the hope that it will be useful,
9
* but WITHOUT ANY WARRANTY; without even the implied warranty of
10
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
* GNU General Public License for more details.
12
*
13
* You should have received a copy of the GNU General Public License
14
* along with this program; if not, write to the Free Software
15
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16
*
17
* Author: Stefano Avallone <stefano.avallone@unina.it>
18
*/
19
20
#ifndef WIFI_TX_CURRENT_MODEL_H
21
#define WIFI_TX_CURRENT_MODEL_H
22
23
#include "ns3/object.h"
24
25
namespace
ns3
26
{
27
28
/**
29
* \ingroup energy
30
*
31
* \brief Model the transmit current as a function of the transmit power and mode
32
*
33
*/
34
class
WifiTxCurrentModel
:
public
Object
35
{
36
public
:
37
/**
38
* \brief Get the type ID.
39
* \return the object TypeId
40
*/
41
static
TypeId
GetTypeId
();
42
43
WifiTxCurrentModel
();
44
~WifiTxCurrentModel
()
override
;
45
46
/**
47
* \param txPowerDbm the nominal TX power in dBm
48
* \returns the transmit current (in Ampere)
49
*/
50
virtual
double
CalcTxCurrent
(
double
txPowerDbm)
const
= 0;
51
};
52
53
/**
54
* \ingroup energy
55
*
56
* \brief a linear model of the Wifi transmit current
57
*
58
* This model assumes that the transmit current is a linear function
59
* of the nominal transmit power used to send the frame.
60
* In particular, the power absorbed during the transmission of a frame \f$ W_{tx} \f$
61
* is given by the power absorbed by the power amplifier \f$ W_{pa} \f$ plus the power
62
* absorbed by the RF subsystem. The latter is assumed to be the same as the power
63
* absorbed in the IDLE state \f$ W_{idle} \f$.
64
*
65
* The efficiency \f$ \eta \f$ of the power amplifier is given by
66
* \f$ \eta = \frac{P_{tx}}{W_{pa}} \f$, where \f$ P_{tx} \f$ is the output power, i.e.,
67
* the nominal transmit power. Hence, \f$ W_{pa} = \frac{P_{tx}}{\eta} \f$
68
*
69
* It turns out that \f$ W_{tx} = \frac{P_{tx}}{\eta} + W_{idle} \f$. By dividing both
70
* sides by the supply voltage \f$ V \f$: \f$ I_{tx} = \frac{P_{tx}}{V \cdot \eta} + I_{idle} \f$,
71
* where \f$ I_{tx} \f$ and \f$ I_{idle} \f$ are, respectively, the transmit current and
72
* the idle current.
73
*
74
* For more information, refer to:
75
* Francesco Ivan Di Piazza, Stefano Mangione, and Ilenia Tinnirello.
76
* "On the Effects of Transmit Power Control on the Energy Consumption of WiFi Network Cards",
77
* Proceedings of ICST QShine 2009, pp. 463--475
78
*
79
* If the TX current corresponding to a given nominal transmit power is known, the efficiency
80
* of the power amplifier is given by the above formula:
81
* \f$ \eta = \frac{P_{tx}}{(I_{tx}-I_{idle})\cdot V} \f$
82
*
83
*/
84
class
LinearWifiTxCurrentModel
:
public
WifiTxCurrentModel
85
{
86
public
:
87
/**
88
* \brief Get the type ID.
89
* \return the object TypeId
90
*/
91
static
TypeId
GetTypeId
();
92
93
LinearWifiTxCurrentModel
();
94
~LinearWifiTxCurrentModel
()
override
;
95
96
double
CalcTxCurrent
(
double
txPowerDbm)
const override
;
97
98
private
:
99
double
m_eta
;
///< ETA
100
double
m_voltage
;
///< voltage in Volts
101
double
m_idleCurrent
;
///< idle current in Amperes
102
};
103
104
}
// namespace ns3
105
106
#endif
/* WIFI_TX_CURRENT_MODEL_H */
ns3::LinearWifiTxCurrentModel
a linear model of the Wifi transmit current
Definition:
wifi-tx-current-model.h:85
ns3::LinearWifiTxCurrentModel::LinearWifiTxCurrentModel
LinearWifiTxCurrentModel()
Definition:
wifi-tx-current-model.cc:77
ns3::LinearWifiTxCurrentModel::m_eta
double m_eta
ETA.
Definition:
wifi-tx-current-model.h:99
ns3::LinearWifiTxCurrentModel::CalcTxCurrent
double CalcTxCurrent(double txPowerDbm) const override
Definition:
wifi-tx-current-model.cc:88
ns3::LinearWifiTxCurrentModel::~LinearWifiTxCurrentModel
~LinearWifiTxCurrentModel() override
Definition:
wifi-tx-current-model.cc:82
ns3::LinearWifiTxCurrentModel::m_voltage
double m_voltage
voltage in Volts
Definition:
wifi-tx-current-model.h:100
ns3::LinearWifiTxCurrentModel::GetTypeId
static TypeId GetTypeId()
Get the type ID.
Definition:
wifi-tx-current-model.cc:52
ns3::LinearWifiTxCurrentModel::m_idleCurrent
double m_idleCurrent
idle current in Amperes
Definition:
wifi-tx-current-model.h:101
ns3::Object
A base class which provides memory management and object aggregation.
Definition:
object.h:89
ns3::TypeId
a unique identifier for an interface.
Definition:
type-id.h:59
ns3::WifiTxCurrentModel
Model the transmit current as a function of the transmit power and mode.
Definition:
wifi-tx-current-model.h:35
ns3::WifiTxCurrentModel::~WifiTxCurrentModel
~WifiTxCurrentModel() override
Definition:
wifi-tx-current-model.cc:45
ns3::WifiTxCurrentModel::WifiTxCurrentModel
WifiTxCurrentModel()
Definition:
wifi-tx-current-model.cc:41
ns3::WifiTxCurrentModel::GetTypeId
static TypeId GetTypeId()
Get the type ID.
Definition:
wifi-tx-current-model.cc:35
ns3::WifiTxCurrentModel::CalcTxCurrent
virtual double CalcTxCurrent(double txPowerDbm) const =0
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
src
wifi
model
wifi-tx-current-model.h
Generated on Tue May 28 2024 23:40:45 for ns-3 by
1.9.6