|
41 |
.SetGroupName ("Energy") |
41 |
.SetGroupName ("Energy") |
42 |
.AddConstructor<LiIonEnergySource> () |
42 |
.AddConstructor<LiIonEnergySource> () |
43 |
.AddAttribute ("LiIonEnergySourceInitialEnergyJ", |
43 |
.AddAttribute ("LiIonEnergySourceInitialEnergyJ", |
44 |
"Initial energy stored in basic energy source.", |
44 |
"Initial energy stored in LiIon energy source.", |
45 |
DoubleValue (31752.0), // in Joules |
45 |
DoubleValue (0), // in Joules |
46 |
MakeDoubleAccessor (&LiIonEnergySource::SetInitialEnergy, |
46 |
MakeDoubleAccessor (&LiIonEnergySource::SetInitialEnergy, |
47 |
&LiIonEnergySource::GetInitialEnergy), |
47 |
&LiIonEnergySource::GetInitialEnergy), |
48 |
MakeDoubleChecker<double> ()) |
48 |
MakeDoubleChecker<double> ()) |
|
|
49 |
.AddAttribute ("LiIonEnergySourceCapacityJ", |
50 |
"Energy capacity that can be stored in LiIon energy source.", |
51 |
DoubleValue (0), // in Joules |
52 |
MakeDoubleAccessor (&LiIonEnergySource::SetEnergyCapacity, |
53 |
&LiIonEnergySource::GetEnergyCapacity), |
54 |
MakeDoubleChecker<double> ()) |
49 |
.AddAttribute ("LiIonEnergyLowBatteryThreshold", |
55 |
.AddAttribute ("LiIonEnergyLowBatteryThreshold", |
50 |
"Low battery threshold for LiIon energy source.", |
56 |
"Low battery threshold for LiIon energy source.", |
51 |
DoubleValue (0.10), // as a fraction of the initial energy |
57 |
DoubleValue (0.10), // as a fraction of the initial energy |
|
112 |
} |
118 |
} |
113 |
|
119 |
|
114 |
LiIonEnergySource::LiIonEnergySource () |
120 |
LiIonEnergySource::LiIonEnergySource () |
115 |
: m_drainedCapacity (0.0), |
121 |
: m_energyCapacityJ (0.0), |
|
|
122 |
m_drainedCapacity (0.0), |
116 |
m_lastUpdateTime (Seconds (0.0)) |
123 |
m_lastUpdateTime (Seconds (0.0)) |
117 |
{ |
124 |
{ |
118 |
NS_LOG_FUNCTION (this); |
125 |
NS_LOG_FUNCTION (this); |
|
128 |
{ |
135 |
{ |
129 |
NS_LOG_FUNCTION (this << initialEnergyJ); |
136 |
NS_LOG_FUNCTION (this << initialEnergyJ); |
130 |
NS_ASSERT (initialEnergyJ >= 0); |
137 |
NS_ASSERT (initialEnergyJ >= 0); |
|
|
138 |
NS_ASSERT (initialEnergyJ <= m_energyCapacityJ || m_energyCapacityJ == 0); |
131 |
m_initialEnergyJ = initialEnergyJ; |
139 |
m_initialEnergyJ = initialEnergyJ; |
132 |
// set remaining energy to be initial energy |
140 |
// set remaining energy to be initial energy |
133 |
m_remainingEnergyJ = m_initialEnergyJ; |
141 |
m_remainingEnergyJ = m_initialEnergyJ; |
|
|
142 |
if(m_energyCapacityJ == 0) |
143 |
{ |
144 |
m_energyCapacityJ = m_initialEnergyJ; |
145 |
} |
134 |
} |
146 |
} |
135 |
|
147 |
|
136 |
double |
148 |
double |
|
184 |
NS_LOG_FUNCTION (this); |
196 |
NS_LOG_FUNCTION (this); |
185 |
// update energy source to get the latest remaining energy. |
197 |
// update energy source to get the latest remaining energy. |
186 |
UpdateEnergySource (); |
198 |
UpdateEnergySource (); |
|
|
199 |
if(m_energyCapacityJ == 0) |
200 |
{ |
201 |
return 0; |
202 |
} |
187 |
return m_remainingEnergyJ / m_initialEnergyJ; |
203 |
return m_remainingEnergyJ / m_initialEnergyJ; |
188 |
} |
204 |
} |
189 |
|
205 |
|
|
223 |
} |
239 |
} |
224 |
|
240 |
|
225 |
m_energyUpdateEvent.Cancel (); |
241 |
m_energyUpdateEvent.Cancel (); |
|
|
242 |
|
243 |
if(m_energyCapacityJ == 0) |
244 |
{ |
245 |
m_energyCapacityJ = m_initialEnergyJ; |
246 |
} |
247 |
if(m_initialEnergyJ == 0) |
248 |
{ |
249 |
m_initialEnergyJ = m_energyCapacityJ; |
250 |
} |
226 |
|
251 |
|
227 |
CalculateRemainingEnergy (); |
252 |
CalculateRemainingEnergy (); |
228 |
|
253 |
|
|
239 |
this); |
264 |
this); |
240 |
} |
265 |
} |
241 |
|
266 |
|
|
|
267 |
void |
268 |
LiIonEnergySource::SetEnergyCapacity (double energyCapacityJ) |
269 |
{ |
270 |
NS_LOG_FUNCTION (this << energyCapacityJ); |
271 |
NS_ASSERT (energyCapacityJ >= 0); |
272 |
NS_ASSERT (energyCapacityJ >= m_initialEnergyJ || energyCapacityJ == 0); |
273 |
m_energyCapacityJ = energyCapacityJ; |
274 |
if(m_initialEnergyJ == 0) |
275 |
{ |
276 |
m_initialEnergyJ = m_energyCapacityJ; |
277 |
m_remainingEnergyJ = m_initialEnergyJ; |
278 |
} |
279 |
} |
280 |
|
281 |
double |
282 |
LiIonEnergySource::GetEnergyCapacity () const |
283 |
{ |
284 |
NS_LOG_FUNCTION (this); |
285 |
return m_energyCapacityJ; |
286 |
} |
287 |
|
242 |
/* |
288 |
/* |
243 |
* Private functions start here. |
289 |
* Private functions start here. |
244 |
*/ |
290 |
*/ |
|
277 |
// energy = current * voltage * time |
323 |
// energy = current * voltage * time |
278 |
double energyToDecreaseJ = totalCurrentA * m_supplyVoltageV * duration.GetSeconds (); |
324 |
double energyToDecreaseJ = totalCurrentA * m_supplyVoltageV * duration.GetSeconds (); |
279 |
|
325 |
|
280 |
if (m_remainingEnergyJ < energyToDecreaseJ) |
326 |
// handles consuming energy below the low battery threshold |
|
|
327 |
if (m_remainingEnergyJ <= m_energyCapacityJ * m_lowBatteryTh && energyToDecreaseJ > 0) |
281 |
{ |
328 |
{ |
282 |
m_remainingEnergyJ = 0; // energy never goes below 0 |
329 |
energyToDecreaseJ = 0; |
283 |
} |
330 |
} |
284 |
else |
331 |
// handles recharging above the energy capacity |
|
|
332 |
if (m_remainingEnergyJ >= m_energyCapacityJ && energyToDecreaseJ < 0) |
285 |
{ |
333 |
{ |
286 |
m_remainingEnergyJ -= energyToDecreaseJ; |
334 |
energyToDecreaseJ = 0; |
287 |
} |
335 |
} |
|
|
336 |
m_remainingEnergyJ -= energyToDecreaseJ; |
288 |
|
337 |
|
289 |
m_drainedCapacity += (totalCurrentA * duration.GetSeconds () / 3600); |
338 |
m_drainedCapacity += (totalCurrentA * duration.GetSeconds () / 3600); |
290 |
// update the supply voltage |
339 |
// update the supply voltage |