Struct HubHandler 

pub struct HubHandler { /* private fields */ }

Handler for the H100 devices.

Implementations

impl HubHandler

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

Refreshes the authentication session.

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

Returns device info as DeviceInfoHubResult. 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 [HubHandler::get_device_info_json].

impl HubHandler

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 HubHandler

Hub handler methods.

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

Returns child device list as ChildDeviceHubResult. It is not guaranteed to contain all the properties returned from the Tapo API or to support all the possible devices connected to the hub. If the deserialization fails, or if a property that you care about it’s not present, try [HubHandler::get_child_device_list_json].

pub async fn play_alarm( &self, ringtone: AlarmRingtone, volume: AlarmVolume, duration: AlarmDuration, ) -> Result<(), Error>

Start playing the hub alarm.

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

Stop playing the hub alarm, if it’s currently playing.

impl HubHandler

Child device handler builders.

pub async fn ke100(&self, identifier: HubDevice) -> Result<KE100Handler, Error>

Returns a KE100Handler for the given HubDevice.

Arguments

• identifier - a hub device identifier

Example

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

pub async fn s200(&self, identifier: HubDevice) -> Result<S200Handler, Error>

Returns a S200Handler for the given HubDevice.

Arguments

• identifier - a hub device identifier

Example

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

pub async fn t100(&self, identifier: HubDevice) -> Result<T100Handler, Error>

Returns a T100Handler for the given HubDevice.

Arguments

• identifier - a hub device identifier

Example

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

pub async fn t110(&self, identifier: HubDevice) -> Result<T110Handler, Error>

Returns a T110Handler for the given HubDevice.

Arguments

• identifier - a hub device identifier

Example

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

pub async fn t300(&self, identifier: HubDevice) -> Result<T300Handler, Error>

Returns a T300Handler for the given HubDevice.

Arguments

• identifier - a hub device identifier

Example

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

pub async fn t31x(&self, identifier: HubDevice) -> Result<T31XHandler, Error>

Returns a T31XHandler for the given HubDevice.

Arguments

• identifier - a hub device identifier

Example

// Connect to the hub
let hub = ApiClient::new("tapo-username@example.com", "tapo-password")
    .h100("192.168.1.100")
    .await?;
// Get a handler for the child device
let device_id = "0000000000000000000000000000000000000000".to_string();
let device = hub.t31x(HubDevice::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 HubHandler

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

Formats the value using the given formatter.

impl From<GenericDeviceHandler> for HubHandler

fn from(value: GenericDeviceHandler) -> Self

Converts to this type from the input type.

impl HandlerExt for HubHandler

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.