Struct ShellyClient 

pub struct ShellyClient { /* private fields */ }

Stateless switchkit::SmartDevice adapter for Shelly devices. No per-device state is kept here; every call re-opens the device (a cheap HTTP probe) so the adapter always reflects the device’s current generation and identity.

Implementations

impl ShellyClient

pub fn new() -> Self

Build a client with a bounded request timeout and connect timeout, so a dead or unreachable device fails fast instead of hanging a caller indefinitely.

Trait Implementations

impl Default for ShellyClient

fn default() -> Self

Returns the “default value” for a type.

impl SmartDevice for ShellyClient

fn probe<'life0, 'life1, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, ) -> Pin<Box<dyn Future<Output = Result<Option<DeviceSnapshot>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Reachable-but-not-Shelly (probe_target returning Error::Parse) maps to Ok(None), never a guessed vendor. Any other error (offline, auth, …) propagates as Err.

fn set_power<'life0, 'life1, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, channel: Option<u8>, action: PowerAction, ) -> Pin<Box<dyn Future<Output = Result<Relay>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Issues the power action, then reads back the CONFIRMED post-change state via switch_status rather than trusting SwitchResult.was_on (the previous state for Gen2’s Switch.Set/Switch.Toggle, with inconsistent semantics across generations).

fn firmware_update<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, _ota_url: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Shelly’s stable-channel OTA update takes no URL parameter; ota_url is accepted for trait compatibility but unused in v1.

fn config_get<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, setting: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Shelly has no single-setting GET; config is one blob. setting == "" returns the whole config. A non-empty setting returns that top-level key’s value when present; an absent key is Err(Rejected), never a fabricated null/{} (absent is not a value).

fn config_set<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, setting: &'life2 str, value: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Returns the device’s actual response to the settings write, never a fabricated {"ok":true}.

fn backup<'life0, 'life1, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

A Shelly config backup is its settings JSON, pretty-printed.

fn console<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, command: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Gen2/3 only: command is "Method [json-params]", passed through verbatim to the device’s JSON-RPC endpoint. Gen1 has no RPC console, so it is genuinely Unsupported, not an empty/guessed response.

fn vendor(&self) -> Vendor

fn status<'life0, 'life1, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, ) -> Pin<Box<dyn Future<Output = Result<DeviceSnapshot>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

One refresh. Ok = reachable reading; Err = unreadable (the consumer renders offline).

fn firmware_version<'life0, 'life1, 'async_trait>( &'life0 self, target: &'life1 DeviceTarget, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,