电池#

介绍#

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.

使用权#

Brain.Battery

成员功能#

The battery class includes the following member functions:

voltage — Returns the battery voltage.
current — Returns the battery current draw.
capacity — Returns the brain’s 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();

电压#

Returns the voltage of the V5 Brain battery. Voltage is the electrical pressure supplied to the battery, which can help you check whether the battery is charged enough for the robot to run reliably.

Available Functions

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

Parameters

范围	类型	描述
`units`	`voltageUnits`	Optional. The unit used to represent voltage: `volt` (default) — volts, or `mV` — millivolts

Return Values

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

当前的#

Returns the electrical current drawn from the V5 Brain battery. Current is how much electrical flow the robot is using from the battery, which can help you see how hard the robot is working or whether motors may be under extra load, ranging from 0.0 to 20.0 Amps.

Available Functions

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

Parameters

范围	类型	描述
`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.

容量#

Returns the remaining battery level of the V5 Brain battery.

Available Functions

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

Parameters

范围	类型	描述
`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%.

温度#

返回 V5 大脑电池的温度。

Available Functions

1 — 返回电池温度的百分比。
double temperature(
    percentUnits units = percentUnits::pct );

2 — 返回指定温度单位的电池温度。
double temperature(
    temperatureUnits units );

Parameters

范围	类型	描述
`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, or `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).