Struct DeviceProxy 

pub struct DeviceProxy { /* private fields */ }

Implementations

impl DeviceProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.cpu.ctrl/Device.

pub fn take_event_stream(&self) -> DeviceEventStream

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

Panics

Panics if the event stream was already taken.

pub fn get_operating_point_info( &self, opp: u32, ) -> QueryResponseFut<DeviceGetOperatingPointInfoResult, DefaultFuchsiaResourceDialect>

Returns information about a given operating point for this performance domain.

pub fn get_current_operating_point( &self, ) -> QueryResponseFut<u32, DefaultFuchsiaResourceDialect>

Gets the current operating point of the device.

pub fn set_current_operating_point( &self, requested_opp: u32, ) -> QueryResponseFut<DeviceSetCurrentOperatingPointResult, DefaultFuchsiaResourceDialect>

Set the operating point of this device to the requested operating point.

Operating points are in numeric P-state order, such that the maximum operating performance point is 0 and the minimum is n-1, where n is the number of operating points returned by GetOperatingPointCount().

The requested operating point may be clamped to the range [min, max] when operating point limits are supported. See SetOperatingPointLimits for details.

Returns ZX_OK, if the device is in a working state and the operating point is changed to requested_opp successfully. out_opp will be same as requested_opp.

Returns ZX_ERR_OUT_OF_RANGE if the minimum_opp is outside of the range [n-1, 0], where n is the number of operating points returned by GetOperatingPointCount().

Returns error status, if switching to the requested_opp was unsuccessful. out_opp is the operating performance point (OPP) that the device is currently in.

pub fn set_minimum_operating_point_limit( &self, minimum_opp: u32, ) -> QueryResponseFut<DeviceSetMinimumOperatingPointLimitResult, DefaultFuchsiaResourceDialect>

Sets the minimum operating point to use, particularly when the kernel automatically controls the operating points of this device.

See SetOperatingPointLimits for details on the semantics of operating point limits.

Returns ZX_OK on success.

Returns ZX_ERR_OUT_OF_RANGE if the minimum_opp is outside of the range [n-1, 0], where n is the number of operating points returned by GetOperatingPointCount().

Returns ZX_ERR_NOT_SUPPORTED if the device does not support limits.

pub fn set_maximum_operating_point_limit( &self, maximum_opp: u32, ) -> QueryResponseFut<DeviceSetMaximumOperatingPointLimitResult, DefaultFuchsiaResourceDialect>

Sets the maximum operating point to use, particularly when the kernel automatically controls the operating points of this device.

See SetOperatingPointLimits for details on the semantics of operating point limits.

Returns ZX_OK on success.

Returns ZX_ERR_OUT_OF_RANGE if the maximum_opp is outside of the range [n-1, 0], where n is the number of operating points returned by GetOperatingPointCount().

Returns ZX_ERR_NOT_SUPPORTED if the device does not support limits.

pub fn set_operating_point_limits( &self, minimum_opp: u32, maximum_opp: u32, ) -> QueryResponseFut<DeviceSetOperatingPointLimitsResult, DefaultFuchsiaResourceDialect>

Sets the operational boundaries (minimum and maximum operating points) for the device, when supported.

Limits define the allowable performance range for the performance domain. They are primarily used for:

• Thermal Mitigation: Progressively lowering the maximum operating point (moving from 0 toward n-1) to reduce power dissipation.
• Performance Boosting: Raising the minimum operating point (moving from n-1 toward 0) when automatic performance matching is insufficient for the current workload.

Limits are useful on platforms where ether hardware or the kernel automatically manages performance. By setting boundaries, userspace can enforce power and performance policies while allowing the underlying system to react to high-fidelity signals in real-time.

When limits are applied, the active operating point is clamped to the range: [max(minimum_opp, maximim_opp), maximum_opp].

Note that maximim_opp and minimum_opp reside in the P-state range [n-1, 0]. This logic ensures that the minimum_opp can be adjusted independently while always respecting the ceiling imposed by the maximim_opp.

Set the operating point limits to (n-1, 0) to effectively remove the limits.

Returns ZX_OK on success.

Returns ZX_ERR_OUT_OF_RANGE if the minimum_opp or maximum_opp is outside of the range [n-1, 0], where n is the number of operating points returned by GetOperatingPointCount().

Returns ZX_ERR_NOT_SUPPORTED if the device does not support limits.

pub fn get_current_operating_point_limits( &self, ) -> QueryResponseFut<DeviceGetCurrentOperatingPointLimitsResult, DefaultFuchsiaResourceDialect>

Returns the current minimum and maximum operating point limits.

Returns ZX_OK on success.

Returns ZX_ERR_NOT_SUPPORTED if the device does not support limits.

pub fn get_operating_point_count( &self, ) -> QueryResponseFut<DeviceGetOperatingPointCountResult, DefaultFuchsiaResourceDialect>

Returns the number of operating points within this performance domain.

pub fn get_num_logical_cores( &self, ) -> QueryResponseFut<u64, DefaultFuchsiaResourceDialect>

Returns the number of logical cores contained within this performance domain.

pub fn get_logical_core_id( &self, index: u64, ) -> QueryResponseFut<u64, DefaultFuchsiaResourceDialect>

Returns a global system-wide core ID for the nth core in this performance domain. index must be a value in the range [0, n) where n is the value returned by GetNumLogicalCores().

pub fn get_domain_id( &self, ) -> QueryResponseFut<u32, DefaultFuchsiaResourceDialect>

Returns the id of this performance domain within its package. This number should be stable across boots, but clients should prefer to use GetRelativePerformance to differentiate cores if possible.

pub fn get_relative_performance( &self, ) -> QueryResponseFut<DeviceGetRelativePerformanceResult, DefaultFuchsiaResourceDialect>

The relative performance of this domain as configured by the platform, if known. The highest performance domain should return 255, while others should return N/255 fractional values relative to that domain. Returns ZX_ERR_NOT_SUPPORTED if the performance level is unknown.

Trait Implementations

impl Clone for DeviceProxy

fn clone(&self) -> DeviceProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceProxy

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

Formats the value using the given formatter.

impl DeviceProxyInterface for DeviceProxy

type GetOperatingPointInfoResponseFut = QueryResponseFut<Result<CpuOperatingPointInfo, i32>>

type GetCurrentOperatingPointResponseFut = QueryResponseFut<u32>

type SetCurrentOperatingPointResponseFut = QueryResponseFut<Result<u32, i32>>

type SetMinimumOperatingPointLimitResponseFut = QueryResponseFut<Result<(), i32>>

type SetMaximumOperatingPointLimitResponseFut = QueryResponseFut<Result<(), i32>>

type SetOperatingPointLimitsResponseFut = QueryResponseFut<Result<(), i32>>

type GetCurrentOperatingPointLimitsResponseFut = QueryResponseFut<Result<(u32, u32), i32>>

type GetOperatingPointCountResponseFut = QueryResponseFut<Result<u32, i32>>

type GetNumLogicalCoresResponseFut = QueryResponseFut<u64>

type GetLogicalCoreIdResponseFut = QueryResponseFut<u64>

type GetDomainIdResponseFut = QueryResponseFut<u32>

type GetRelativePerformanceResponseFut = QueryResponseFut<Result<u8, i32>>

fn get_operating_point_info( &self, opp: u32, ) -> Self::GetOperatingPointInfoResponseFut

fn get_current_operating_point( &self, ) -> Self::GetCurrentOperatingPointResponseFut

fn set_current_operating_point( &self, requested_opp: u32, ) -> Self::SetCurrentOperatingPointResponseFut

fn set_minimum_operating_point_limit( &self, minimum_opp: u32, ) -> Self::SetMinimumOperatingPointLimitResponseFut

fn set_maximum_operating_point_limit( &self, maximum_opp: u32, ) -> Self::SetMaximumOperatingPointLimitResponseFut

fn set_operating_point_limits( &self, minimum_opp: u32, maximum_opp: u32, ) -> Self::SetOperatingPointLimitsResponseFut

fn get_current_operating_point_limits( &self, ) -> Self::GetCurrentOperatingPointLimitsResponseFut

fn get_operating_point_count(&self) -> Self::GetOperatingPointCountResponseFut

fn get_num_logical_cores(&self) -> Self::GetNumLogicalCoresResponseFut

fn get_logical_core_id(&self, index: u64) -> Self::GetLogicalCoreIdResponseFut

fn get_domain_id(&self) -> Self::GetDomainIdResponseFut

fn get_relative_performance(&self) -> Self::GetRelativePerformanceResponseFut

impl Proxy for DeviceProxy

type Protocol = DeviceMarker

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.