Struct BatteryProxy 

pub struct BatteryProxy { /* private fields */ }

Implementations

impl BatteryProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.power.battery/Battery.

pub fn take_event_stream(&self) -> BatteryEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn get_spec( &self, ) -> QueryResponseFut<BatteryGetSpecResult, DefaultFuchsiaResourceDialect>

Retrieves the static specification of the battery.

Returns:

• spec: Static hardware characteristics and driver capabilities of the battery.

Errors:

• NOT_SUPPORTED: Hardware does not supply a static specification.
• IO: Communication failure with the fuel gauge hardware (e.g. I2C transfer failure).
• INTERNAL: Internal driver error.

pub fn get_status( &self, ) -> QueryResponseFut<BatteryGetStatusResult, DefaultFuchsiaResourceDialect>

Retrieves an instantaneous snapshot of the battery status.

Returns:

• status: Complete current telemetry snapshot of battery metrics.

Errors:

• IO: Communication failure with the fuel gauge hardware (e.g. I2C transfer failure).
• INTERNAL: Internal driver error.

pub fn configure_watch( &self, options: &WatchOptions, ) -> QueryResponseFut<BatteryConfigureWatchResult, DefaultFuchsiaResourceDialect>

Configures the fields of interest and wake triggers for this client connection.

The driver filters the requested masks against hardware capabilities and returns the effective configuration in effective_options.

• Partially supported options: If some requested fields are supported and others are not (e.g., requesting passive fields like voltage_uv or current_ua that do not support active interrupt notifications), the driver enables the supported fields and returns the active subset in effective_options. The call succeeds (Ok).
• Fully unsupported options: If non-empty masks were specified but NONE of the requested fields are supported, the driver returns NOT_SUPPORTED.

If ConfigureWatch is never called, Watch defaults to returning on ANY supported field change. The driver aggregates constraints across all clients to determine hardware reporting rates.

ConfigureWatch may be called at any time, including while a Watch is pending. The new masks take effect immediately and apply to that pending call. Change detection continues to compare against the status last delivered on this connection, so a field that changed before the reconfiguration can still resolve the pending Watch.

Parameters:

• options: Requested watch options. Both interest and wake_on are optional.

Returns:

• effective_options: The subset of requested options supported and enabled by the driver.

Errors:

• NOT_SUPPORTED: Non-empty options were requested, but none of the requested interest/wake fields or periodic sampling are supported by the driver.

On error the connection’s configuration is left unchanged; a failed call never partially applies.

pub fn watch( &self, lease: Option<EventPair>, ) -> QueryResponseFut<BatteryWatchResult, DefaultFuchsiaResourceDialect>

Change notification for battery state using a hanging-get pattern.

The first call returns the full current hardware state immediately. Subsequent calls block until a state change matches the masks in [ConfigureWatch] or the interval in max_interval has elapsed. Each return contains a complete telemetry snapshot of all current battery fields, not a sparse delta.

At most one Watch call may be outstanding per connection; concurrent calls fail with ALREADY_WATCHING.

Parameters:

• lease: An optional power lease token that keeps the system awake while the server processes the call. If the call is answered immediately, as the first call always is, the server hands it back as wake_lease unless it returns a wake lease of its own. If the call is parked, the server drops it.

Returns:

• status: Complete current telemetry snapshot of the battery.
• wake_lease: An optional lease token that the client should hold while it handles status: the client’s lease handed back on an immediate reply, or a wake lease provided if the change triggered a wake_on condition or a max_interval sample woke the system for a client that set wake_on_max_interval. Omitted otherwise.

Errors:

• ALREADY_WATCHING: A Watch call is already pending on this connection.
• IO: Communication failure with the fuel gauge hardware (e.g. I2C transfer failure).
• INTERNAL: Internal driver error.

Trait Implementations

impl BatteryProxyInterface for BatteryProxy

type GetSpecResponseFut = QueryResponseFut<Result<Spec, Error>>

type GetStatusResponseFut = QueryResponseFut<Result<Status, Error>>

type ConfigureWatchResponseFut = QueryResponseFut<Result<WatchOptions, Error>>

type WatchResponseFut = QueryResponseFut<Result<(Status, Option<EventPair>), Error>>

fn get_spec(&self) -> Self::GetSpecResponseFut

fn get_status(&self) -> Self::GetStatusResponseFut

fn configure_watch( &self, options: &WatchOptions, ) -> Self::ConfigureWatchResponseFut

fn watch(&self, lease: Option<EventPair>) -> Self::WatchResponseFut

impl Clone for BatteryProxy

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BatteryProxy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Proxy for BatteryProxy

type Protocol = BatteryMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, NullableHandle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.