Struct SourceProxy 

pub struct SourceProxy { /* private fields */ }

Implementations

impl SourceProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.power.source/Source.

pub fn take_event_stream(&self) -> SourceEventStream

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

Returns static hardware characteristics that do not change during operation.

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

Returns dynamic status of the source immediately.

pub fn set_role( &self, role: &Role, ) -> QueryResponseFut<SourceSetRoleResult, DefaultFuchsiaResourceDialect>

Set the role of this specific node.

Errors:

• INVALID_ARGS: If the provided role is invalid.
• NOT_SUPPORTED: If the requested role is not supported by the hardware.
• INTERNAL: If an unexpected error occurred.

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

Change notification for power source state using a “hanging-get” pattern.

The first call to this method returns the current hardware state immediately. Subsequent calls block until a change occurs that matches the provided masks.

At most one Watch call may be outstanding at a time per connection. Completing a call acknowledges that the client has received the previous update.

Power Management and Suspend

To prevent lost wakeups, the server (driver) must ensure that the Watch call remains active (and hardware interrupts armed) while the system is suspended.

• Interest Triggers: If a change in the interest mask occurs while the system is suspended, the server MUST NOT complete the Watch call until the system wakes for another reason (e.g., a wake_on event or external trigger). This ensures the CPU remains asleep for non-critical updates.
• Wake-On Triggers: If a change in the wake_on mask occurs, the server MUST wake the system and complete the call immediately with a wake_lease.

As a result of this queuing behavior, if multiple changes occur while the system is suspended, they may be merged into a single returned status table, and intermediate state transitions may be lost.

• interest: The client wants to be notified if any of the fields present in this table change. If any field in interest changes, the method returns.
• wake_on: Similar to interest, but if a change occurs in these fields, the server will attempt to keep the system awake using the provided lease (or by returning a wake_lease) until the client acknowledges the update.
• lease: A power lease token used to coordinate handoff between the server and client, ensuring the system does not suspend before the client can process a critical power event.

Returns:

• status: The updated status table containing the fields that changed.
• wake_lease: An optional lease token provided if the change triggered a wake_on condition and the server is maintaining system state.

Trait Implementations

impl Clone for SourceProxy

fn clone(&self) -> SourceProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceProxy

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

Formats the value using the given formatter.

impl Proxy for SourceProxy

type Protocol = SourceMarker

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.

impl SourceProxyInterface for SourceProxy

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

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

type SetRoleResponseFut = QueryResponseFut<Result<(), Error>>

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

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

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

fn set_role(&self, role: &Role) -> Self::SetRoleResponseFut

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