Struct WakeAlarmsProxy

pub struct WakeAlarmsProxy { /* private fields */ }

Implementations

impl WakeAlarmsProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.time.alarms/WakeAlarms.

pub fn take_event_stream(&self) -> WakeAlarmsEventStream

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

Panics

Panics if the event stream was already taken.

pub fn set_and_wait( &self, deadline: BootInstant, mode: SetMode, alarm_id: &str, ) -> QueryResponseFut<WakeAlarmsSetAndWaitResult, DefaultFuchsiaResourceDialect>

Sets a wake alarm with the provided parameters, and waits for the alarm to fire.

The caller may request multiple alarms concurrently. Re-requesting an alarm that has the same alarm_id as an already scheduled alarm causes that scheduled alarm to be canceled before the new alarm is scheduled.

Return value

• keep_alive: A handle that prevents the system from suspending as long as it is held.

The call to SetAndWait returns when the alarm fires, an error occurs, or the alarm is canceled. This return style is required for some clients, such as Starnix, which rely on FIDL response tallying to guide their power management strategy.

As an example, under Starnix, a response to this request will cause a Starnix container to be unsuspended (“woken up”). This is a critical behavior for suspend correctness under Starnix. Using the [Notifier] approach would side-step this mechanism and result in incorrect wake behavior under Starnix.

Protocol Errors

• DROPPED: The alarm was canceled by a call to Cancel.
• UNSPECIFIED: A new failure mode has been observed that has not yet been assigned an error code. This indicates that the API version may need to be updated.
• INTERNAL is a server-side bug: an internal fallible call (which is expected to be unlikely to fail) has failed somehow. Please report this for investigation.
• [INVALID_ARGS]: a parameter provided by the user is not valid, such as an empty alarm_id.

pub fn cancel(&self, alarm_id: &str) -> Result<(), Error>

Cancels the alarm specified by alarm_id.

Providing an alarm_id for an alarm that is not scheduled is a no-op.

pub fn set( &self, notifier: ClientEnd<NotifierMarker>, deadline: BootInstant, mode: SetMode, alarm_id: &str, ) -> QueryResponseFut<WakeAlarmsSetResult, DefaultFuchsiaResourceDialect>

Sets a wake alarm with the provided parameters.

The caller may request multiple alarms concurrently. Re-requesting an alarm that has the same alarm_id as an already scheduled alarm causes that scheduled alarm to be canceled before the same alarm is scheduled again.

Return value

This method will return when the alarm is scheduled.

Protocol Errors

• [UNSPECIFIED] you are observing a new failure mode which has not been assigned an error code yet. Expect this failure mode to be assigned a more specific error code in future versions of this API. This is not a bug, but an indication that you may need to update the API version.
• [INTERNAL] is a bug: an internal fallible call (which is expected to be unlikely to fail) has failed somehow. Please report this for investigation.
• [INVALID_ARGS]: a parameter provided by the user is not valid, such as an empty alarm_id.

pub fn set_and_wait_utc( &self, deadline: &InstantUtc, mode: SetMode, alarm_id: &str, ) -> QueryResponseFut<WakeAlarmsSetAndWaitUtcResult, DefaultFuchsiaResourceDialect>

Similar to [SetAndWait], except the alarm is scheduled on the UTC timeline.

Refer to [SetAndWait] documentation for the functionality details, and especially see the section “Return value” for the return value subtleties.

Trait Implementations

impl Clone for WakeAlarmsProxy

fn clone(&self) -> WakeAlarmsProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WakeAlarmsProxy

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

Formats the value using the given formatter.

impl Proxy for WakeAlarmsProxy

type Protocol = WakeAlarmsMarker

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<'_, Handle>>

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

impl WakeAlarmsProxyInterface for WakeAlarmsProxy

type SetAndWaitResponseFut = QueryResponseFut<Result<EventPair, WakeAlarmsError>>

type SetResponseFut = QueryResponseFut<Result<(), WakeAlarmsError>>

type SetAndWaitUtcResponseFut = QueryResponseFut<Result<EventPair, WakeAlarmsError>>

fn set_and_wait( &self, deadline: BootInstant, mode: SetMode, alarm_id: &str, ) -> Self::SetAndWaitResponseFut

fn cancel(&self, alarm_id: &str) -> Result<(), Error>

fn set( &self, notifier: ClientEnd<NotifierMarker>, deadline: BootInstant, mode: SetMode, alarm_id: &str, ) -> Self::SetResponseFut

fn set_and_wait_utc( &self, deadline: &InstantUtc, mode: SetMode, alarm_id: &str, ) -> Self::SetAndWaitUtcResponseFut