Battery

Introduction

The battery class is derived from the brain base class and provides access to the V5 Brain’s battery, allowing your robot to monitor capacity, voltage, current draw, power usage, temperature, and efficiency.

Access

Brain.Battery

Member Functions

The battery class includes the following member functions:

• voltage — Returns the battery voltage.

• current — Returns the battery current draw.

• capacity — Returns the remaining battery capacity.

• temperature — Returns the battery temperature.

Before calling any battery member functions, a brain instance must be created, as shown below:

// Create the V5 Brain
brain Brain = brain();

voltage

Returns the voltage of the V5 Brain battery.

Available Functions

double voltage( voltageUnits units = voltageUnits::volt );

Parameters

Parameter	Type	Description
units	voltageUnits	Optional. The unit used to represent voltage: volt (default) — volts mV — millivolts

Return Values

Returns a double representing the battery voltage in the specified units.

current

Returns the electrical current drawn from the V5 Brain battery.

Available Functions

double current( currentUnits units = currentUnits::amp );

Parameters

Parameter	Type	Description
units	voltageUnits	Optional. The unit used to represent current: amp (default) — amperes

Return Values

Returns a double representing the electrical current drawn from the V5 Brain battery in amperes.

capacity

Returns the remaining capacity of the V5 Brain battery.

Available Functions

uint32_t capacity( percentUnits units = percentUnits::pct );

Parameters

Parameter	Type	Description
units	percentUnits	Optional. The unit used to represent battery capacity: pct / percent — percent

Return Values

Returns a uint32_t representing the remaining battery capacity as a percentage from 0 to 100.

temperature

Returns the temperature of the V5 Brain battery.

Available Functions

1 — Returns the battery temperature as a percentage.

double temperature(
    percentUnits units = percentUnits::pct );

2 — Returns the battery temperature in the specified temperature units.

double temperature(
    temperatureUnits units );

Parameters

Parameter	Type	Description
units	percentUnits	Optional. The unit used to represent battery temperature: pct / percent (default) — percent
units	temperatureUnits	Returns the battery temperature in specific units: celsius — degrees Celsius fahrenheit — degrees Fahrenheit

Return Values

Returns a double representing the remaining battery temperature in the specified units.

Notes

• The operating temperature range for the battery is approximately 20°C (68°F) to 70°C (158°F).