Struct UsbFunctionInterfaceProxy 

pub struct UsbFunctionInterfaceProxy { /* private fields */ }

Implementations

impl UsbFunctionInterfaceProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.hardware.usb.function/UsbFunctionInterface.

pub fn take_event_stream(&self) -> UsbFunctionInterfaceEventStream

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

Panics

Panics if the event stream was already taken.

pub fn control( &self, setup: &UsbSetup, write: &[u8], ) -> QueryResponseFut<UsbFunctionInterfaceControlResult, DefaultFuchsiaResourceDialect>

Callback for handling EP0 class/vendor-specific control requests targeting the interface(s) owned by this function.

This is called when the host sends a control request to the device. The protocol server (of [UsbFunctionInterface]) should process the request and return the result.

The host expects a response within a strict timeout period defined by the USB specification Section 9.2.6 (50ms for requests without data, and 500ms for read data stages). Because of these hardware-enforced limits, the implementation must reply as quickly as possible and avoid blocking the dispatcher.

setup is the control request metadata (setup packet). write contains the raw bytes sent by the host in the Data Stage of a host-to-device (OUT) control transfer. It is empty for device-to-host (IN) transfers. read in the response payload contains the raw bytes returned to the host in the Data Stage of a device-to-host (IN) control transfer. It must be empty for host-to-device (OUT) transfers.

Any error returned by this method (including ZX_ERR_NOT_SUPPORTED) causes the peripheral controller to stall Endpoint 0, signaling a “Request Error” to the host.

• error:
  • ZX_ERR_NOT_SUPPORTED if the request is not supported by the protocol server.
  • ZX_ERR_INVALID_ARGS if the setup packet or data is invalid.
  • ZX_ERR_IO_NOT_PRESENT if the device was disconnected while processing the request.

pub fn set_configured( &self, configured: bool, speed: UsbSpeed, ) -> QueryResponseFut<UsbFunctionInterfaceSetConfiguredResult, DefaultFuchsiaResourceDialect>

Inform the protocol server (of [UsbFunctionInterface]) when the USB device configured state changes.

Called with configured == true in response to a SET_CONFIGURATION control request that selects a configuration that contains this function. In this case, the protocol server should use [UsbFunction.ConfigureEndpoint] to configure its endpoints.

Per USB 2.0 Specification Section 9.4.7, receiving a SET_CONFIGURATION request when the function is already configured is valid and should reset/re-initialize the function state rather than returning an error.

Called with configured == false when configuration is disabled or USB is disconnected. The protocol server should then use [UsbFunction.DisableEndpoint] to disable its endpoints.

The protocol server must perform all endpoint configuration/disabling and wait for those calls to complete before replying to this method. This ensures that the protocol client can report success/failure back to the host (by ACK’ing or STALL’ing the SET_CONFIGURATION request).

Any error returned by this method causes the peripheral controller to stall Control Endpoint 0, signaling a failure to the host (rejecting the SET_CONFIGURATION request).

• error:
  • ZX_ERR_BAD_STATE if the device or function is in an uninitialized state where configuration transitions are invalid (excluding re-configuring an active state).
  • ZX_ERR_INVALID_ARGS if the speed or configuration parameters are invalid.
  • ZX_ERR_NOT_SUPPORTED if the requested speed or configuration is unsupported.
  • ZX_ERR_NO_RESOURCES if endpoint allocation or hardware configuration fails.

pub fn set_interface( &self, interface: u8, alt_setting: u8, ) -> QueryResponseFut<UsbFunctionInterfaceSetInterfaceResult, DefaultFuchsiaResourceDialect>

Called to set an alternate setting for an interface due to a SET_INTERFACE control request.

The protocol server (of [UsbFunctionInterface]) must use [UsbFunction.ConfigureEndpoint] and [UsbFunction.DisableEndpoint] to configure or disable the interface’s endpoints as appropriate for the new alternate setting.

Depending on the alternate setting definition, this transition may require configuring new endpoints (via ConfigureEndpoint), disabling existing endpoints (via DisableEndpoint), or doing both. If an alternate setting does not use any endpoints, no endpoint configuration calls are required.

The protocol server must perform all endpoint configuration/disabling and wait for those calls to complete before replying to this method. This ensures that the protocol client can report success/failure back to the host (by ACK’ing or STALL’ing the SET_INTERFACE request).

Any error returned by this method causes the peripheral controller to stall Control Endpoint 0, signaling a failure to the host (rejecting the SET_INTERFACE request).

• error:
  • ZX_ERR_NOT_SUPPORTED if the alternate setting is not supported.
  • ZX_ERR_INVALID_ARGS if the interface or alt_setting is invalid.
  • Other errors if the function driver fails to configure or disable endpoints for the new setting.

Trait Implementations

impl Clone for UsbFunctionInterfaceProxy

fn clone(&self) -> UsbFunctionInterfaceProxy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsbFunctionInterfaceProxy

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

Formats the value using the given formatter.

impl Proxy for UsbFunctionInterfaceProxy

type Protocol = UsbFunctionInterfaceMarker

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 UsbFunctionInterfaceProxyInterface for UsbFunctionInterfaceProxy

type ControlResponseFut = QueryResponseFut<Result<Vec<u8>, i32>>

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

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

fn control(&self, setup: &UsbSetup, write: &[u8]) -> Self::ControlResponseFut

fn set_configured( &self, configured: bool, speed: UsbSpeed, ) -> Self::SetConfiguredResponseFut

fn set_interface( &self, interface: u8, alt_setting: u8, ) -> Self::SetInterfaceResponseFut