Model a generic Lithium Ion Battery basing on [1][2]. More...
#include <li-ion-energy-source.h>
Public Member Functions | |
virtual void | DecreaseRemainingEnergy (double energyJ) |
virtual double | GetEnergyFraction (void) |
Time | GetEnergyUpdateInterval (void) const |
virtual double | GetInitialEnergy (void) const |
virtual double | GetRemainingEnergy (void) |
virtual double | GetSupplyVoltage (void) const |
virtual void | IncreaseRemainingEnergy (double energyJ) |
void | SetEnergyUpdateInterval (Time interval) |
void | SetInitialEnergy (double initialEnergyJ) |
void | SetInitialSupplyVoltage (double supplyVoltageV) |
virtual void | UpdateEnergySource (void) |
Public Member Functions inherited from ns3::EnergySource | |
void | AppendDeviceEnergyModel (Ptr< DeviceEnergyModel > deviceEnergyModelPtr) |
void | DisposeDeviceModels (void) |
DeviceEnergyModelContainer | FindDeviceEnergyModels (TypeId tid) |
DeviceEnergyModelContainer | FindDeviceEnergyModels (std::string name) |
Ptr< Node > | GetNode (void) const |
void | InitializeDeviceModels (void) |
void | SetNode (Ptr< Node > node) |
Sets pointer to node containing this EnergySource. More... | |
Public Member Functions inherited from ns3::Object | |
void | AggregateObject (Ptr< Object > other) |
void | Dispose (void) |
AggregateIterator | GetAggregateIterator (void) const |
virtual TypeId | GetInstanceTypeId (void) const |
template<typename T > | |
Ptr< T > | GetObject (void) const |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
void | Initialize (void) |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount (const SimpleRefCount &o) | |
uint32_t | GetReferenceCount (void) const |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
void | Ref (void) const |
void | Unref (void) const |
Public Member Functions inherited from ns3::ObjectBase | |
void | GetAttribute (std::string name, AttributeValue &value) const |
bool | GetAttributeFailSafe (std::string name, AttributeValue &attribute) const |
void | SetAttribute (std::string name, const AttributeValue &value) |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Static Public Member Functions | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::EnergySource | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
static void | Cleanup (void) |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Private Member Functions | |
void | CalculateRemainingEnergy (void) |
void | DoDispose (void) |
void | DoInitialize (void) |
double | GetVoltage (double current) const |
void | HandleEnergyDrainedEvent (void) |
Private Attributes | |
double | m_drainedCapacity |
double | m_eExp |
double | m_eFull |
EventId | m_energyUpdateEvent |
Time | m_energyUpdateInterval |
double | m_eNom |
double | m_initialEnergyJ |
double | m_internalResistance |
Time | m_lastUpdateTime |
double | m_minVoltTh |
double | m_qExp |
double | m_qNom |
double | m_qRated |
TracedValue< double > | m_remainingEnergyJ |
double | m_supplyVoltageV |
double | m_typCurrent |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::EnergySource | |
void | BreakDeviceEnergyModelRefCycle (void) |
double | CalculateTotalCurrent (void) |
void | NotifyEnergyDrained (void) |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
virtual void | NotifyNewAggregate (void) |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
virtual void | NotifyConstructionCompleted (void) |
Model a generic Lithium Ion Battery basing on [1][2].
The model can be fitted to any type of Li-Ion Battery, simply changing the model parameters. The default values are fitted for the Panasonic CGR18650DA Li-Ion Battery [3].
The energy is drained as defined from the EnergySource interface but, this class consider the non-linear behaviour of Li-Ion cell. Each time energy is drained from the cell, the class evaluates the discharge curve to get the actual cell's voltage, accordingly to State of Charge (SOC) and current's drain.
If the actual voltage of the cell goes below the minimum threshold voltage, the cell is considered depleted and the energy drained event fired up.
The model requires several parameters to approximates the discharge curves:
For a complete reference of the energy source model and model's fitting please refer to UAN Framework page and Li-Ion model fitting page.
References: [1] C. M. Shepherd, "Design of Primary and Secondary Cells - Part 3. Battery discharge equation," U.S. Naval Research Laboratory, 1963 [2] Tremblay, O.; Dessaint, L.-A.; Dekkiche, A.-I., "A Generic Battery Model for the Dynamic Simulation of Hybrid Electric Vehicles," Ecole de Technologie Superieure, Universite du Quebec, 2007 [3] http://www.panasonic.com/industrial/includes/pdf/Panasonic_LiIon_CGR18650DA.pdf
Doxygen introspection did not find any typical Config paths.
Definition at line 72 of file li-ion-energy-source.h.
|
private |
Calculates remaining energy. This function uses the total current from all device models to calculate the amount of energy to decrease. The energy to decrease is given by: energy to decrease = total current * supply voltage * time duration This function subtracts the calculated energy to decrease from remaining energy.
Definition at line 267 of file li-ion-energy-source.cc.
References ns3::EnergySource::CalculateTotalCurrent(), ns3::Time::GetSeconds(), GetVoltage(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by DoDispose(), and UpdateEnergySource().
|
virtual |
energyJ | Amount of energy (in Joules) to decrease from energy source. |
Implements DecreaseRemainingEnergy.
Definition at line 184 of file li-ion-energy-source.cc.
References HandleEnergyDrainedEvent(), NS_ASSERT, and NS_LOG_FUNCTION.
|
privatevirtual |
All child's implementation must call BreakDeviceEnergyModelRefCycle to ensure reference cycles to DeviceEnergyModel objects are broken.
Defined in ns3::Object
Reimplemented from ns3::EnergySource.
Definition at line 246 of file li-ion-energy-source.cc.
References ns3::EnergySource::BreakDeviceEnergyModelRefCycle(), CalculateRemainingEnergy(), and NS_LOG_FUNCTION.
|
privatevirtual |
This method is called only once by Object::Initialize. If the user calls Object::Initialize multiple times, DoInitialize is called only the first time.
Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject and AggregateObject from within this method.
Reimplemented from ns3::Object.
Definition at line 239 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION, and UpdateEnergySource().
|
virtual |
Implements GetEnergyFraction.
Implements ns3::EnergySource.
Definition at line 175 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION, and UpdateEnergySource().
Time ns3::LiIonEnergySource::GetEnergyUpdateInterval | ( | void | ) | const |
Definition at line 159 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION.
|
virtual |
Implements GetInitialEnergy.
Implements ns3::EnergySource.
Definition at line 130 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION.
|
virtual |
Implements GetRemainingEnergy.
Implements ns3::EnergySource.
Definition at line 166 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION, and UpdateEnergySource().
|
virtual |
Implements GetSupplyVoltage.
Implements ns3::EnergySource.
Definition at line 145 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION.
|
private |
current | the actual discharge current value. |
Get the cell voltage in function of the discharge current. It consider different discharge curves for different discharge currents and the remaining energy of the cell.
Definition at line 283 of file li-ion-energy-source.cc.
References NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by CalculateRemainingEnergy().
|
private |
Handles the remaining energy going to zero event. This function notifies all the energy models aggregated to the node about the energy being depleted. Each energy model is then responsible for its own handler.
Definition at line 256 of file li-ion-energy-source.cc.
References ns3::EnergySource::GetNode(), ns3::EnergySource::NotifyEnergyDrained(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by DecreaseRemainingEnergy(), and UpdateEnergySource().
|
virtual |
energyJ | Amount of energy (in Joules) to increase from energy source. |
Implements IncreaseRemainingEnergy.
Definition at line 198 of file li-ion-energy-source.cc.
References NS_ASSERT, and NS_LOG_FUNCTION.
void ns3::LiIonEnergySource::SetEnergyUpdateInterval | ( | Time | interval | ) |
interval | Energy update interval. |
This function sets the interval between each energy update.
Definition at line 152 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION.
void ns3::LiIonEnergySource::SetInitialEnergy | ( | double | initialEnergyJ | ) |
initialEnergyJ | Initial energy, in Joules |
Implements SetInitialEnergy. Note that initial energy is assumed to be set before simulation starts and is set only once per simulation.
Definition at line 120 of file li-ion-energy-source.cc.
References NS_ASSERT, and NS_LOG_FUNCTION.
void ns3::LiIonEnergySource::SetInitialSupplyVoltage | ( | double | supplyVoltageV | ) |
supplyVoltageV | Initial Supply voltage at the energy source, in Volts. |
Sets the initial supply voltage of the energy source. To be called only once.
Definition at line 137 of file li-ion-energy-source.cc.
References NS_LOG_FUNCTION.
|
virtual |
Implements UpdateEnergySource.
Implements ns3::EnergySource.
Definition at line 206 of file li-ion-energy-source.cc.
References CalculateRemainingEnergy(), ns3::EventId::Cancel(), ns3::EnergySource::GetNode(), HandleEnergyDrainedEvent(), ns3::Simulator::IsFinished(), ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Simulator::Schedule().
Referenced by DoInitialize(), GetEnergyFraction(), and GetRemainingEnergy().