Struct ChargerProxy 

pub struct ChargerProxy { /* private fields */ }

Implementations

impl ChargerProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.power.charger/Charger.

pub fn take_event_stream(&self) -> ChargerEventStream

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<ChargerGetSpecResult, DefaultFuchsiaResourceDialect>

Retrieves the static specification of the charger.

Returns:

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

Errors:

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

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

Retrieves an instantaneous snapshot of the charger status.

Returns:

• status: Complete current telemetry snapshot of the charging regulator and its inputs.

Errors:

• IO: Communication failure with the charger hardware (e.g. SPMI transfer failure).
• INTERNAL: Internal driver error.

pub fn configure_watch( &self, options: &WatchOptions, ) -> QueryResponseFut<ChargerConfigureWatchResult, 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 input_voltage_uv or input_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.

Calling ConfigureWatch while a Watch call is already pending takes effect immediately: if the current hardware state already differs from the last-delivered snapshot on a newly enabled field, the pending Watch resolves immediately; otherwise it remains pending under the updated mask.

If ConfigureWatch returns an error, the connection’s prior watch configuration remains unchanged.

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 are supported by the driver.

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

Watches for changes in charger 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]. Each return contains a complete telemetry snapshot of all current charger 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 used to coordinate handoff between client and server, preventing the system from suspending before critical charger events are handled. If omitted, or if the driver does not support any wake_on fields, no lease coordination is performed and any provided token is dropped without returning a wake_lease.

Returns:

• status: Complete current telemetry snapshot of the charger.
• wake_lease: An optional lease token provided if the change triggered a wake_on condition. Omitted if the change did not trigger a wake condition or if suspend coordination is inactive.

Errors:

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

Trait Implementations

impl ChargerProxyInterface for ChargerProxy

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 ChargerProxy

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 ChargerProxy

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

Formats the value using the given formatter.

impl Proxy for ChargerProxy

type Protocol = ChargerMarker

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.