LAN Provisioning

LAN provisioning applies to a device already discovered on the local network. The unified API connects, sends Wi-Fi credentials, and waits for cloud registration.

Start provisioning

import { GizDeviceRegistrationInfo, GizProvisionEvent } from '@gizwits/smart-sdk';
import { hilog } from '@kit.PerformanceAnalysisKit';
 
const registration: GizDeviceRegistrationInfo | undefined =
  await device.lanCapability.provideWiFiCredentials(
    device,
    'wifi-ssid',
    'wifi-password',
    60,
    (event: GizProvisionEvent): void => {
      hilog.info(
        0x0000,
        'GizwitsSample',
        'LAN provisioning: %{public}s',
        event.stage
      );
    }
  );

Success returns GizDeviceRegistrationInfo. A timeout, send failure, or network change rejects the Promise.

Cancel provisioning

device.lanCapability.stopProvideWiFiCredentials(device);

The callback receives CONFIG_CANCELLED. Stop the loading state and allow the user to retry.

⚠️

Confirm that the target SSID is available. Never include the Wi-Fi password in hilog output, error reports, or user feedback.

Bluetooth Provisioning Device Registration