WLAN Profiles

Applicable Devices : RFD40 Premium, RFD40 Premium Plus, RFD90

Overview

Adds, removes, saves, connects and disconnects WLAN profiles on an RFID reader, and sets the Wi-Fi channel bands it uses, with srfidAddWlanProfile, srfidRemoveWlanProfile, srfidWlanSaveProfile, srfidConnectWlanProfile, srfidWlanDisConnectProfile, enableWifiChannelBand.

Add WLAN Profile

The addWlanProfile method adds a WLAN profile to an RFID reader using the Zebra RFID SDK. It logs success, handles response errors, and logs failures or timeouts. It returns the result of the operation.


/// Add wlan profile
/// @param readerID The reader id
/// @param profileConfig The WLAN profile configuration
/// @param statusMessage The status message
-(SRFID_RESULT)addWlanProfile:(int)readerID srfidProfileConfig:(sRfidAddProfileConfig*)profileConfig aStatusMessage:(NSString**)statusMessage {

    SRFID_RESULT srfid_result = SRFID_RESULT_FAILURE;

    srfid_result = [apiInstance srfidAddWlanProfile:readerID srfidProfileConfig:profileConfig aStatusMessage:statusMessage];

    if (srfid_result == SRFID_RESULT_SUCCESS){
        NSLog(@"Add profile success");
    }
    else if(srfid_result == SRFID_RESULT_RESPONSE_ERROR){

        NSLog(@"Add profile SRFID_RESULT_RESPONSE_ERROR");

    }
    else if(srfid_result == SRFID_RESULT_FAILURE || srfid_result == SRFID_RESULT_RESPONSE_TIMEOUT){

        NSLog(@"Timeout or Failure");
    }

    return srfid_result;

}

Remove WLAN Profile

The removeWlanProfile method removes a WLAN profile from an RFID reader using the Zebra RFID SDK. The method logs success, handles response errors, and logs failures or timeouts. It returns the result of the operation.


/// Remove wlan profile
/// @param readerID The reader id
/// @param ssidWlan The ssid
/// @param statusMessage The status message
-(SRFID_RESULT)removeWlanProfile:(int)readerID ssidWlan:(NSString*)ssidWlan  aStatusMessage:(NSString**)statusMessage {

    SRFID_RESULT srfid_result = SRFID_RESULT_FAILURE;


    for(int i = 0; i < 3; i++)
    {
        srfid_result = [apiInstance srfidRemoveWlanProfile:readerID ssidWlan:ssidWlan aStatusMessage:statusMessage];
        if ((srfid_result != SRFID_RESULT_RESPONSE_TIMEOUT) && (srfid_result != SRFID_RESULT_FAILURE))
        {
            break;
        }
    }

    if (srfid_result == SRFID_RESULT_SUCCESS)
    {
        NSLog(@"Remove profile success");
    }
    else if(srfid_result == SRFID_RESULT_RESPONSE_ERROR)
    {

        NSLog(@"Remove profile SRFID_RESULT_RESPONSE_ERROR");

    }
    else if(srfid_result == SRFID_RESULT_FAILURE || srfid_result == SRFID_RESULT_RESPONSE_TIMEOUT)
    {

        NSLog(@"Timeout or Failure");

    }
    return srfid_result;

}

Save WLAN Profile

The saveWlanProfile method saves a WLAN profile for a specified RFID reader. As of now we can save maximum 10 profiles in reader. The method interacts with an RFID SDK API to perform the save action and returns a result indicating success or specific failure types. It logs messages based on the outcome.


/// Save wlan profile
/// @param readerID The reader id
/// @param statusMessage The status message
-(SRFID_RESULT)saveWlanProfile:(int)readerID aStatusMessage:(NSString**)statusMessage {

    SRFID_RESULT srfid_result = SRFID_RESULT_FAILURE;

    srfid_result = [apiInstance srfidWlanSaveProfile:readerID aStatusMessage:statusMessage];

    if (srfid_result == SRFID_RESULT_SUCCESS){
        NSLog(@"Save profile success");
    }
    else if(srfid_result == SRFID_RESULT_RESPONSE_ERROR){

        NSLog(@"Save profile SRFID_RESULT_RESPONSE_ERROR");

    }
    else if(srfid_result == SRFID_RESULT_FAILURE || srfid_result == SRFID_RESULT_RESPONSE_TIMEOUT){

        NSLog(@"Timeout or Failure");
    }

    return srfid_result;

}

Connect WLAN Profile

The connectWlanProfile method connects an RFID reader to a WLAN profile using the Zebra RFID SDK. It returns the operation’s result, indicating success or failure.


/// Connect to the wlan profile.
/// @param readerID The reader id.
/// @param ssidWlan Profile name.
/// @param statusMessage The status message.
-(SRFID_RESULT)connectWlanProfile:(int)readerID ssidWlan:(NSString*)ssidWlan  aStatusMessage:(NSString**)statusMessage
{
    SRFID_RESULT srfid_result = SRFID_RESULT_FAILURE;
    for(int i = 0; i < 3; i++)
    {
        srfid_result = [apiInstance srfidConnectWlanProfile:readerID ssidWlan:ssidWlan aStatusMessage:statusMessage];

        if ((srfid_result != SRFID_RESULT_RESPONSE_TIMEOUT) && (srfid_result != SRFID_RESULT_FAILURE))
        {
            break;
        }
    }

    if (srfid_result == SRFID_RESULT_SUCCESS)
    {
        NSLog(@"Connect profile success");
    }
    else if(srfid_result == SRFID_RESULT_RESPONSE_ERROR)
    {
        NSLog(@"Connect profile SRFID_RESULT_RESPONSE_ERROR");
    }
    else if(srfid_result == SRFID_RESULT_FAILURE || srfid_result == SRFID_RESULT_RESPONSE_TIMEOUT)
    {

        NSLog(@"Timeout or Failure");

    }
    return srfid_result;
}

Disconnect WLAN Profile

The disconnectWlanProfile method disconnects an RFID reader from a WLAN profile using the Zebra RFID SDK. It returns the operation’s result, indicating success or failure.


/// Disconnect WLAN profile.
/// @param readerID The reader id.
/// @param statusMessage The status message.
-(SRFID_RESULT)disconnectWlanProfile:(int)readerID aStatusMessage:(NSString**)statusMessage
{
    SRFID_RESULT srfid_result = SRFID_RESULT_FAILURE;
    for(int i = 0; i < 3; i++)
    {
        srfid_result = [apiInstance srfidWlanDisConnectProfile:readerID aStatusMessage:statusMessage];

        if ((srfid_result != SRFID_RESULT_RESPONSE_TIMEOUT) && (srfid_result != SRFID_RESULT_FAILURE))
        {
            break;
        }
    }

    if (srfid_result == SRFID_RESULT_SUCCESS)
    {
        NSLog(@"Disconnect profile success");
    }
    else if(srfid_result == SRFID_RESULT_RESPONSE_ERROR)
    {
        NSLog(@"Disconnect profile SRFID_RESULT_RESPONSE_ERROR");
    }
    else if(srfid_result == SRFID_RESULT_FAILURE || srfid_result == SRFID_RESULT_RESPONSE_TIMEOUT)
    {
        NSLog(@"Timeout or Failure");
    }
    return srfid_result;

}

Enable Channel List

The enableWifiChannelBand method configures the active RFID reader's Wi-Fi operation by applying a channel band mask defined by ENUM_WIFI_CHANNELBAND_TYPE (e.g., enabling 2.4GHz, 5GHz non-DFS, or 5GHz DFS bands individually or in combination).


-(SRFID_RESULT)enableChannelListMask:(ENUM_WIFI_CHANNELBAND_TYPE)wifiChannel aStatusMessage:(NSString**)statusMessage {

    SRFID_RESULT srfid_result = SRFID_RESULT_FAILURE;
    srfid_result = [apiInstance enableWifiChannelBand:readerID channelValue:wifiChannel aStatusMessage:statusMessage];

    if (srfid_result == SRFID_RESULT_SUCCESS) {
        NSLog(@"[WiFi Status] Enable Channel List Mask Success");

    }else {
        NSLog(@"[WiFi Status] Enable Channel List Mask Failure");
    }

    return srfid_result;

}

The channel band is passed as a value of the ENUM_WIFI_CHANNELBAND_TYPE type, which the SDK defines. The values are:

  • WIFI_WPA2_4GZ (1): 2.4 GHz
  • WIFI_WPA5GZ_NODFS (2): 5 GHz, non-DFS channels
  • WIFI_WPA5GZ_DFS (4): 5 GHz, DFS channels