Struct PowerStripHandler 

pub struct PowerStripHandler { /* private fields */ }

Handler for the P300 and P306 devices.

Implementations

impl PowerStripHandler

pub async fn refresh_session(&mut self) -> Result<&mut Self, Error>

Refreshes the authentication session.

pub async fn get_device_info(&self) -> Result<DeviceInfoPowerStripResult, Error>

Returns device info as DeviceInfoPowerStripResult. It is not guaranteed to contain all the properties returned from the Tapo API. If the deserialization fails, or if a property that you care about it’s not present, try [PowerStripHandler::get_device_info_json].

impl PowerStripHandler

pub async fn device_reboot(&self, delay_s: u16) -> Result<(), Error>

Reboots the device.

Notes:

• Using a very small delay (e.g. 0 seconds) may cause a ConnectionReset or TimedOut error as the device reboots immediately.
• Using a larger delay (e.g. 2-3 seconds) allows the device to respond before rebooting, reducing the chance of errors.
• With larger delays, the method completes successfully before the device reboots. However, subsequent commands may fail if sent during the reboot process or before the device reconnects to the network.

Arguments

• delay_s - The delay in seconds before the device is rebooted.

pub async fn device_reset(&self) -> Result<(), Error>

Hardware resets the device.

Warning: This action will reset the device to its factory settings. The connection to the Wi-Fi network and the Tapo app will be lost, and the device will need to be reconfigured.

This feature is especially useful when the device is difficult to access and requires reconfiguration.

impl PowerStripHandler

pub async fn get_child_device_list( &self, ) -> Result<Vec<PowerStripPlugResult>, Error>

Returns child device list as Vec<PowerStripPlugResult>. It is not guaranteed to contain all the properties returned from the Tapo API. If the deserialization fails, or if a property that you care about it’s not present, try [PowerStripHandler::get_child_device_list_json].

impl PowerStripHandler

Child device handler builders.

pub async fn plug( &self, identifier: Plug, ) -> Result<PowerStripPlugHandler, Error>

Returns a PowerStripPlugHandler for the given Plug.

Arguments

• identifier - a PowerStrip plug identifier.

Example

// Connect to the hub
let power_strip = ApiClient::new("tapo-username@example.com", "tapo-password")
    .p300("192.168.1.100")
    .await?;
// Get a handler for the child device
let device_id = "0000000000000000000000000000000000000000".to_string();
let device = power_strip.plug(Plug::ByDeviceId(device_id)).await?;
// Get the device info of the child device
let device_info = device.get_device_info().await?;

Trait Implementations

impl Debug for PowerStripHandler

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

Formats the value using the given formatter.

impl From<GenericDeviceHandler> for PowerStripHandler

fn from(value: GenericDeviceHandler) -> Self

Converts to this type from the input type.

impl HandlerExt for PowerStripHandler

fn get_client<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = RwLockReadGuard<'_, dyn ApiClientExt>> + Send + 'async_trait>>

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

Returns the client used by this handler.