Inheritance diagram for cdc::hal::BQ25895Power:

Public Member Functions
	BQ25895Power ()=default
IService implementation
bool	init () override
	Initializes charger hardware and applies safe boot defaults.
bool	start () override
	Starts power manager service state.
void	stop () override
	Stops power manager service state.
core::ServiceState	getState () const override
const char *	getName () const override
IPowerManager implementation
uint16_t	getBatteryVoltage () const override
	Returns measured battery voltage in millivolts.
uint8_t	getBatteryPercent () const override
	Estimates battery percentage from measured voltage.
bool	isUsbConnected () const override
	Returns cached USB power presence.
PowerSource	getPowerSource () const override
	Returns current active power source.
ChargeStatus	getChargeStatus () const override
	Returns cached charge-state machine value.
bool	isBatteryLow () const override
	Indicates low-battery threshold state.
bool	isBatteryCritical () const override
	Indicates critical-battery threshold state.
bool	isBatteryPresent () const override
	Returns whether a battery is considered present.
void	setChargingEnabled (bool enabled) override
	Enables or effectively disables charging current.
void	enterShipMode () override
	Requests battery ship mode via BATFET disconnect.
void	setPreShipModeCallback (PreShipModeCallback cb) override
void	update () override
	Periodic power-manager update handling watchdog and IRQ-driven refresh.
void	refresh () override
	Forces a synchronous re-read of charger status registers.
void	prepareForSleep () override
	Disables the charger IRQ before light sleep.
void	recoverFromSleep () override
	Restores charger IRQ handling and refreshes status after wakeup.
Public Member Functions inherited from cdc::hal::IPowerManager
virtual	~IPowerManager ()=default
Public Member Functions inherited from cdc::core::IService
virtual	~IService ()=default

Additional Inherited Members
Public Types inherited from cdc::hal::IPowerManager
using	PreShipModeCallback = void (*)()

Detailed Description

BQ25895 Power Manager Implementation

Definition at line 86 of file BQ25895Power.cpp.

Constructor & Destructor Documentation

◆ BQ25895Power()

cdc::hal::BQ25895Power::BQ25895Power ( )

default

Referenced by getBatteryVoltage().

Member Function Documentation

◆ enterShipMode()

void cdc::hal::BQ25895Power::enterShipMode ( )

overridevirtual

Requests battery ship mode via BATFET disconnect.

Implements cdc::hal::IPowerManager.

Definition at line 564 of file BQ25895Power.cpp.

References cdc::hal::BQ_REG_MISC, LOG_E, LOG_I, and TAG.

Referenced by update().

◆ getBatteryPercent()

uint8_t cdc::hal::BQ25895Power::getBatteryPercent ( ) const

overridevirtual

Estimates battery percentage from measured voltage.

Returns: Battery level in percent.

Implements cdc::hal::IPowerManager.

Definition at line 486 of file BQ25895Power.cpp.

References cdc::hal::BATTERY_EMPTY_MV, cdc::hal::BATTERY_FULL_MV, and getBatteryVoltage().

Referenced by isBatteryCritical(), and isBatteryLow().

◆ getBatteryVoltage()

uint16_t cdc::hal::BQ25895Power::getBatteryVoltage ( ) const

overridevirtual

Returns measured battery voltage in millivolts.

Returns: Battery voltage in mV, or 0 on read failure.

Implements cdc::hal::IPowerManager.

Definition at line 463 of file BQ25895Power.cpp.

References BQ25895Power(), cdc::hal::BQ_REG_ADC_CTRL, and cdc::hal::BQ_REG_BATV.

Referenced by getBatteryPercent().

◆ getChargeStatus()

ChargeStatus cdc::hal::BQ25895Power::getChargeStatus ( ) const

overridevirtual

Returns cached charge-state machine value.

Returns: Current charge status enum.

Implements cdc::hal::IPowerManager.

Definition at line 519 of file BQ25895Power.cpp.

◆ getName()

const char * cdc::hal::BQ25895Power::getName ( ) const

inlineoverridevirtual

Get service name (for logging/debugging)

Implements cdc::core::IService.

Definition at line 98 of file BQ25895Power.cpp.

◆ getPowerSource()

PowerSource cdc::hal::BQ25895Power::getPowerSource ( ) const

overridevirtual

Returns current active power source.

Returns: PowerSource::USB or PowerSource::BATTERY.

Implements cdc::hal::IPowerManager.

Definition at line 511 of file BQ25895Power.cpp.

References cdc::hal::BATTERY, and cdc::hal::USB.

◆ getState()

core::ServiceState cdc::hal::BQ25895Power::getState ( ) const

inlineoverridevirtual

Get current service state

Implements cdc::core::IService.

Definition at line 97 of file BQ25895Power.cpp.

◆ init()

bool cdc::hal::BQ25895Power::init ( )

overridevirtual

Initializes charger hardware and applies safe boot defaults.

Returns: true if initialization succeeded.

Implements cdc::core::IService.

Definition at line 221 of file BQ25895Power.cpp.

References BQ25895_ADDR, cdc::hal::BQ_REG_ADC_CTRL, cdc::hal::BQ_REG_CHG_CTRL, cdc::hal::BQ_REG_INPUT_CTRL, cdc::hal::BQ_REG_VENDOR, cdc::hal::BQ_SYS_MIN_MV, cdc::hal::CHARGE_CURRENT_SLOW, cdc::hal::charger_isr(), CHG_IRQ_PIN, cdc::core::ERROR, FLASH_BTN_PIN, cdc::hal::getI2cBus0(), cdc::core::INITIALIZED, LOG_E, LOG_I, cdc::core::STARTED, TAG, and cdc::core::UNINITIALIZED.

◆ isBatteryCritical()

bool cdc::hal::BQ25895Power::isBatteryCritical ( ) const

overridevirtual

Indicates critical-battery threshold state.

Returns: true if battery level is below 5%.

Implements cdc::hal::IPowerManager.

Definition at line 535 of file BQ25895Power.cpp.

References getBatteryPercent().

◆ isBatteryLow()

bool cdc::hal::BQ25895Power::isBatteryLow ( ) const

overridevirtual

Indicates low-battery threshold state.

Returns: true if battery level is below 20%.

Implements cdc::hal::IPowerManager.

Definition at line 527 of file BQ25895Power.cpp.

References getBatteryPercent().

◆ isBatteryPresent()

bool cdc::hal::BQ25895Power::isBatteryPresent ( ) const

overridevirtual

Returns whether a battery is considered present.

Returns: true if battery presence is detected.

Implements cdc::hal::IPowerManager.

Definition at line 543 of file BQ25895Power.cpp.

◆ isUsbConnected()

bool cdc::hal::BQ25895Power::isUsbConnected ( ) const

overridevirtual

Returns cached USB power presence.

Returns: true when USB input is detected.

Implements cdc::hal::IPowerManager.

Definition at line 502 of file BQ25895Power.cpp.

◆ prepareForSleep()

void cdc::hal::BQ25895Power::prepareForSleep ( )

overridevirtual

Disables the charger IRQ before light sleep.

The sleep controller arms a level-triggered wakeup on the same pin; the edge-triggered active-mode interrupt is disabled here to mirror the keypad.

Implements cdc::hal::IPowerManager.

Definition at line 644 of file BQ25895Power.cpp.

References CHG_IRQ_PIN.

◆ recoverFromSleep()

void cdc::hal::BQ25895Power::recoverFromSleep ( )

overridevirtual

Restores charger IRQ handling and refreshes status after wakeup.

Drops any stale IRQ flag, re-reads charger status (so cached USB presence is current and an expired watchdog gets kicked), and re-arms the edge trigger.

Implements cdc::hal::IPowerManager.

Definition at line 654 of file BQ25895Power.cpp.

References cdc::hal::charger_irq_pending, and CHG_IRQ_PIN.