ios-core 0.1.7

High-level device API, pairing transport, and discovery for iOS devices
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

//! usbmuxd client for iOS device discovery and USB/network connection multiplexing.
//!
//! Provides [`MuxClient`] for connecting to usbmuxd and establishing TCP connections
//! to device services, plus [`MuxEvent`] for real-time device attach/detach notifications.

pub mod client;
pub mod connection;
pub mod listener;
pub mod protocol;

pub use client::MuxClient;
pub use listener::MuxEvent;

use crate::mux::protocol::DeviceEntryRaw;

/// A connected iOS device discovered via usbmuxd.
#[derive(Debug, Clone)]
pub struct MuxDevice {
    pub device_id: u32,
    pub serial_number: String, // UDID
    pub connection_type: String,
    pub product_id: u16,
}

impl MuxDevice {
    pub(crate) fn from_raw(raw: DeviceEntryRaw) -> Self {
        Self {
            device_id: raw.device_id,
            serial_number: raw.properties.serial_number,
            connection_type: raw.properties.connection_type,
            product_id: raw.properties.product_id.unwrap_or(0),
        }
    }
}

/// Errors from usbmuxd operations.
#[derive(Debug, thiserror::Error)]
pub enum MuxError {
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
    #[error("protocol error: {0}")]
    Protocol(String),
    #[error("device not found: {0}")]
    DeviceNotFound(String),
}