batteryChargingAdminState
BATTERY-MIB ·
.1.3.6.1.2.1.233.1.1.1.14
Object
column
r/w
Enumeration
The value of this object indicates the desired
charging state of the battery. The real state is
indicated by object batteryChargingOperState. See the
definition of object batteryChargingOperState for a
description of the values.
When this object is initialized by an implementation of the
BATTERY-MIB module, its value is set to notSet(1). In this
case, the charging controller is free to choose which
operational state is suitable.
When the batteryChargingAdminState object is set, then the
BATTERY-MIB implementation must try to set the battery
to the indicated state. The result will be indicated by
object batteryChargingOperState.
Setting object batteryChargingAdminState to value notSet(1)
is a request to the charging controller to operate
autonomously and choose the operational state that is
suitable.
Setting object batteryChargingAdminState to value charge(2)
is a request to enter the operational state charging(2) until
the battery is fully charged. When the battery is fully
charged, or if the battery was already fully charged or
almost fully charged at the time of the request, the
operational state will change to maintainingCharge(3) if the
charging controller and the battery support the functionality
of maintaining the charge, or it will change to noCharging(4)
otherwise.
Setting object batteryChargingAdminState to value
doNotCharge(3) is a request for entering operational
state noCharging(4).
Setting object batteryChargingAdminState to value
discharge(4) is a request for entering operational
state discharging(5). Discharging can be accomplished
by ordinary use, applying a dedicated load, or any other
means. An example for applying this state is battery
maintenance. If the battery is empty or almost empty, the
operational state will change to noCharging(4).
The charging controller will decide which charge condition
will be considered empty dependent on the battery
technology used. This is done to avoid damage on the
battery due to deep discharge.
Due to operational conditions and limitations of the
implementation of the BATTERY-MIB module, changing the
battery status according to a set value of object
batteryChargingAdminState may not be possible.
Setting the value of object batteryChargingAdminState
may result in not changing the state of the battery
to this value or even in setting the charging state
to another value than the requested one. For example,
the charging controller might at any time decide to
enter state discharging(5), if there is an operational need
to use the battery for supplying power.
Context
- MIB
- BATTERY-MIB
- OID
.1.3.6.1.2.1.233.1.1.1.14- Type
- column
- Access
- readwrite
- Status
- current
- Parent
- batteryEntry
- Table
- batteryTable
- Siblings
- 24
Syntax
Enumeration
Values & Constraints
Enumerated Values
1 | notSet |
2 | charge |
3 | doNotCharge |
4 | discharge |
Related Objects
Sibling Objects
| Object | Type | Syntax | OID |
|---|---|---|---|
| batteryIdentifier This object contains an identifier for the battery.
Many manufacturers deliver not only simple batteries but
battery packages including additional hardware and firm… | column | SNMP-FRAMEWORK-MIBSnmpAdminString | .1.3.6.1.2.1.233.1.1.1.1 |
| batteryActualCapacity This object provides the actual capacity of the
battery in units of mAh.
Typically, the actual capacity of a battery decreases
with time and with usage of the batte… | column | milliampere hours SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.10 |
| batteryChargingCycleCount This object indicates the number of completed charging
cycles that the battery underwent. In line with the
Smart Battery Data Specification Revision 1.1, a charging
cycle is defi… | column | SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.11 |
| batteryLastChargingCycleTime The date and time of the last charging cycle. The value
'0000000000000000'H is returned if the battery has not been
charged yet or if the last charging time cannot be
determined.… | column | SNMPv2-TCDateAndTime | .1.3.6.1.2.1.233.1.1.1.12 |
| batteryChargingOperState This object indicates the current charging state of the
battery.
Value unknown(1) indicates that the charging state of the
battery cannot be determined.
… | column | Enumeration | .1.3.6.1.2.1.233.1.1.1.13 |
| batteryActualCharge This object provides the actual charge of the battery
in units of mAh.
Note that the actual charge needs to be measured and is
typically an estimate based on observ… | column | milliampere hours SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.15 |
| batteryActualVoltage This object provides the actual voltage of the battery
in units of mV.
A value of 'ffffffff'H indicates that the actual voltage
cannot be determined. | column | millivolt SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.16 |
| batteryActualCurrent This object provides the actual charging or discharging
current of the battery in units of mA.
The charging current is represented by positive values,
and the discharging current … | column | milliampere SNMPv2-SMIInteger32 | .1.3.6.1.2.1.233.1.1.1.17 |
| batteryTemperature The ambient temperature at or within close proximity
of the battery.
A value of '7fffffff'H indicates that the temperature
cannot be determined. | column | deci-degrees Celsius SNMPv2-SMIInteger32 | .1.3.6.1.2.1.233.1.1.1.18 |
| batteryAlarmLowCharge This object provides the lower-threshold value for object
batteryActualCharge. If the value of object
batteryActualCharge falls below this threshold,
a low-battery alarm will be … | column | milliampere hours SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.19 |
| batteryFirmwareVersion This object indicates the version number of the firmware
that is included in a battery module.
Many manufacturers deliver not pure batteries but battery
packages in… | column | SNMP-FRAMEWORK-MIBSnmpAdminString | .1.3.6.1.2.1.233.1.1.1.2 |
| batteryAlarmLowVoltage This object provides the lower-threshold value for object
batteryActualVoltage. If the value of object
batteryActualVoltage falls below this threshold,
a low-battery alarm will b… | column | millivolt SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.20 |
| batteryAlarmLowCapacity This object provides the lower-threshold value for object
batteryActualCapacity. If the value of object
batteryActualCapacity falls below this threshold,
a battery aging alarm wi… | column | milliampere hours SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.21 |
| batteryAlarmHighCycleCount This object provides the upper-threshold value for object
batteryChargingCycleCount. If the value of object
batteryChargingCycleCount rises above this threshold,
a battery aging … | column | SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.22 |
| batteryAlarmHighTemperature This object provides the upper-threshold value for object
batteryTemperature. If the value of object
batteryTemperature rises above this threshold, a battery
high temperature ala… | column | deci-degrees Celsius SNMPv2-SMIInteger32 | .1.3.6.1.2.1.233.1.1.1.23 |
| batteryAlarmLowTemperature This object provides the lower-threshold value for object
batteryTemperature. If the value of object
batteryTemperature falls below this threshold, a battery
low temperature alar… | column | deci-degrees Celsius SNMPv2-SMIInteger32 | .1.3.6.1.2.1.233.1.1.1.24 |
| batteryCellIdentifier The value of this object identifies one or more cells of a
battery. The format of the cell identifier may vary between
different implementations. It should uniquely identify one… | column | SNMP-FRAMEWORK-MIBSnmpAdminString | .1.3.6.1.2.1.233.1.1.1.25 |
| batteryType This object indicates the type of battery.
It distinguishes between primary (not rechargeable)
batteries, rechargeable (secondary) batteries, and
capacitors. Capac… | column | Enumeration | .1.3.6.1.2.1.233.1.1.1.3 |
| batteryTechnology This object indicates the technology used by the battery.
Numbers identifying battery technologies are registered at
IANA. A current list of assignments can be found at
<http://w… | column | SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.4 |
| batteryDesignVoltage This object provides the design (or nominal) voltage of the
battery in units of millivolt (mV).
Note that the design voltage is a constant value and
typically diffe… | column | millivolt SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.5 |
| batteryNumberOfCells This object indicates the number of cells contained in the
battery.
A value of 0 indicates that the number of cells is unknown. | column | SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.6 |
| batteryDesignCapacity This object provides the design (or nominal) capacity of
the battery in units of milliampere hours (mAh).
Note that the design capacity is a constant value and
typi… | column | milliampere hours SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.7 |
| batteryMaxChargingCurrent This object provides the maximum current to be used for
charging the battery in units of milliampere (mA).
Note that the maximum charging current may not lead to
op… | column | milliampere SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.8 |
| batteryTrickleChargingCurrent This object provides the recommended average current
to be used for trickle charging the battery in units of
mA.
Typically, this is a value recommended by the manuf… | column | milliampere SNMPv2-SMIUnsigned32 | .1.3.6.1.2.1.233.1.1.1.9 |