Wi-Fi Setup

Overview

Wi-Fi Setup is the first step to config the device. We supply 2 ways to do this, you should choose based on the hardware you're using:

• BLE Wi-Fi Setup

• SoftAP Wi-Fi Setup

SDK requires location privilege after iOS13 to get the phone's connected SSID.

BLE Wi-Fi Setup

App setup device's Wi-Fi network through BLE connection.

• LP_CONNECT_AP_STATE

Wi-Fi setup response

Phone BLE Status

• Sample Code

    [LPBLEManager shareInstance].delegate = self;
  
     #pragma mark —————LPBLEManagerDelegate —————
  
    - (void)BLEManger:(LPBLEManager *)BLEManger BLEPoweredOff:(BOOL)isPoweredOff {
        NSLog(@"BLE state change: %d", isPoweredOff ? 0 : 1);
    }
  
    - (void)BLEMangerDidDisconnectPeripheral {
        NSLog(@"BLE didDisconnect");
    }
  
    - (void)BLEManger:(LPBLEManager *)BLEManger BLEState:(CBCentralManagerState)state {
        NSLog(@"BLE state");
    }
  

Start Scan BLE Devices

• Description

  Start scanning for BLE devices

    - (void)startScan:(void (^)(LPPeripheral *peripheral))callback;
  

• Parameter

• Response

  N/A

• Sample Code

    if ([LPBLEManager shareInstance].state == CBManagerStatePoweredOn) {
        [[LPBLEManager shareInstance] startScan:^(LPPeripheral * _Nonnull peripheral) {
            [self.deviceArray addObject:peripheral];
        }];
    }
  

Stop Scan BLE Devices

• Description

  When scan finished or not required, use this function to stop BLE scan so that lower the power consumption.

    - (void)stopScan;
  

• Parameter

  N/A

• Response

  N/A

Connect BLE Device

• Description

  Establish BLE connection with device.

    - (void)connectBLE:(LPPeripheral *)peripheral callback:(void (^)(LP_BLE_CONNECT_RESULT state))callback;
  

• Parameter

• Response

  N/A

• Sample Code

    [[LPBLEManager shareInstance] connectBLE:peripheral callback:^(LP_BLE_CONNECT_RESULT state) {
        if (state == LP_BLE_CONNECT_SUCCESS) {
            NSLog(@"BLE connection successful");
        }else {
          NSLog(@"BLE connection failed");
        }
    }];
  

Disconnect BLE Connection

• Description

  Disconnect BLE connection with device

    - (void)disconnectBLE;
  

• Parameter

  N/A

• Response

  N/A

Get AP List from Device

• Description

  Get AP list around from device through BLE

    - (void)getWLANListWithCallback:(void(^)(id _Nullable apList))callback;
  

• Parameter

• Response

  N/A

• Sample Code

    [[LPBLEManager shareInstance] getWLANList:NO callback:^(id  _Nullable apList) {
        NSLog(@"Wi-Fi List = %@", apList);
    }];
  

Send Wi-Fi Connect Command

• Description

  Send Wi-Fi connect command.

    - (void)connectWLAN:(NSString *)ssid password:(NSString *)password auth:(NSString *)auth encry:(NSString *)encry
               callback:(void(^)(LP_CONNECT_AP_STATE code, id _Nullable responseObj))callback;
  

• Parameter

• Response

  N/A

• Sample Code

    __block NSDictionary *infoDict = @{};
    [[LPBLEManager shareInstance] getWLANListWithCallback:^(id  _Nullable apList) {
        infoDict = apList[indexPath.row];
        [[LPBLEManager shareInstance] connectWLAN:infoDict[@"ssid"] password:password auth:infoDict[@"auth"] encry:infoDict[@"encry"] callback:^(LP_CONNECT_AP_STATE code, id  _Nullable responseObj) {
            if (code == LP_CONNECT_AP_SUCCESS && responseObj) {
                     NSLog(@"[BLE] success = %@", responseObj);
                     NSDictionary * infoDic = responseObj;
                     self.UUID = infoDic[@"UUID"];
                     LPDevice *device = [[LPDeviceManager sharedInstance] deviceForID:infoDic[@"UUID"]];
                     if (device) {
                         [self success];
                     }else {
                         if (!self->searchTimer) {
                             self->checkDate = [NSDate date];
                             self->searchTimer = [NSTimer timerWithTimeInterval:2 target:self selector:@selector(waitForDeivceOnline) userInfo:nil repeats:YES];
                             [[NSRunLoop mainRunLoop] addTimer:self->searchTimer forMode:NSDefaultRunLoopMode];
                             [self->searchTimer fire];
                         }
                     }
                 }else if (code == LP_CONNECT_AP_START) {
                     NSLog(@"[BLE] connectWLAN start");
                 }else {
                     NSLog(@"[BLE] setup Failed = %@", responseObj);
                     [self setupFailed];
                 }
        }];
    }];
  

SoftAP Wi-Fi Setup

LPWiFiSetupManager implements the softAP Wi-Fi setup.

• LPApItem

  Response object from getAPList

• LPWiFiSetupFailed errorCode

Check if Phone Connected to Device's AP

• Description

  SoftAP requires phone connected to device's hotspot, so you need a function to check this.

    - (void)isLinkplayHotspotWithCheckTime:(int)time block:(void(^)(BOOL isDirect))block;
  

• Parameter

• Response

  BOOL

• Sample Code

    [[LPWiFiSetupManager sharedInstance] isLinkplayHotspotWithCheckTime:10 block:^(BOOL isDirect) {
        if (!isDirect) {
            NSLog(@"The WiFi connected to the phone is not a hotspot from the device");
        }else {
            NSLog(@"The WiFi connected to the phone is a hotspot from the device");
        }
    }];
  

Get AP List from Device

• Description

  After connected to device's hotspot, call this function to get AP list around from device.

    - (void)getApList:(LPApListBlock)block;
  

• Parameter

  N/A

• Response

  N/A

• Sample Code

    __weak __typeof(self)weakSelf = self;
    [[LPWiFiSetupManager sharedInstance] getApList:^(NSMutableArray * _Nonnull LPApList) {
        weakSelf.wlanDetailsArray = LPApList;
    }];
  

Send Wi-Fi Connect Command

• Description

    - (void)connectToWiFi:(LPApItem *)apItem pass:(NSString *)pass success:(LPWiFiSetupSuccess)success failed:(LPWiFiSetupFailed)failed;
  

• Parameter

• Response

  N/A

• Sample Code

    LPApItem *apItem = [_wlanDetailsArray objectAtIndex:indexPath.row];
    [[LPWiFiSetupManager sharedInstance] connectToWiFi:apItem pass:passwordText.text success:^(LPDevice * _Nonnull device) {
        NSLog(@"LPWiFiConnect success");
    } failed:^(int errorCode) {
        NSLog(@"LPWiFiConnect failed");
    }];
  

Recheck SoftAP Wi-Fi Setup Result

• Description

  If SoftAP Wi-Fi setup failed and phone connected to different AP from destination AP, you could call this function to recheck the result

    - (void)retryCheckWithTime:(int)time success:(LPWiFiSetupSuccess)success failed:(LPWiFiSetupFailed)failed;
  

• Parameter

• Response

  N/A

• Sample Code

    LPApItem *apItem = [_wlanDetailsArray objectAtIndex:indexPath.row];
    [[LPWiFiSetupManager sharedInstance] connectToWiFi:apItem pass:passwordText.text success:^(LPDevice * _Nonnull device) {
        NSLog(@"LPWiFiConnect success");
    } failed:^(int errorCode) {
        NSLog(@"LPWiFiConnect failed");
        if (errorCode == 1001) {
  
            [[LPWiFiSetupManager sharedInstance] retryCheckWithTime:30 success:^(LPDevice * _Nonnull device) {
                NSLog(@"LPWiFiConnect success");
            } failed:^(int errorCode) {
                NSLog(@"LPWiFiConnect failed");
            }];
        }
    }];