AddConfig

Datalogic .NET SDK

AddConfig (Method)

Syntax

public static void AddConfig(StandardWiFiConfig cfg)

Class : WiFi

Namespace : Datalogic.API

Assembly : Datalogic.API.DLL

Description

Adds a new WiFi profile

Throws

WiFiException on error.

Parameters Table

	Type	Parameter	Description
[in]	StandardWiFiConfig	cfg	A StandardWiFiConfig, (or derived) object containing required values for a new standard or EAP Wi-Fi profile to be added to the system.

To add EAP profiles, use the following specific classes, which derive from StandardWifiConfig that correspond to specific EAP types:

Examples

Example: Adding a WPA2-PSK network

StandardWiFiConfig cfg = new StandardWiFiConfig();

cfg.Base.ConfigName = "myNetwork";

cfg.Base.SSID = "mySSID";

cfg.Base.AuthType = Authentication.Wpa2Psk;

cfg.Base.Encr = Encryption.Aes;

cfg.Base.Broadcast = true;

cfg.Base.PSK.Buffer = "myPassword";

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

outputWriteLine("Error adding " + ex.ErrorCode);

}

Example: Adding an open network

StandardWiFiConfig cfg = new StandardWiFiConfig();

cfg.Base.ConfigName = "myNetwork";

cfg.Base.SSID = "mySSID";

cfg.Base.AuthType = Authentication.Open;

cfg.Base.Encr = Encryption.None;

cfg.Base.Broadcast = true;

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

outputWriteLine("Error adding " + ex.ErrorCode);

}

Example: Adding an EAP-PEAP network

PEAPConfig cfg = new PEAPConfig();

cfg.Base.ConfigName = "peap";

cfg.Base.SSID = "myPeapNetwork";

cfg.EAP.Cred.Type = CredentialsType.Password;

cfg.EAP.Cred.Source = CredentialsSource.FromProfile;

cfg.EAP.InnerMethod = EapInnerMethod.EapMschapV2;

cfg.EAP.Cred.UserName = "myUser";

cfg.EAP.Cred.Password = "myPassword";

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Example: Adding an EAP-TLS network

// Will use "eaptls" certificate, which has been added to Control Panel

// > Certificates > My Certificates list already. Make sure the

// device's date is in certificate's set start and end date range!

EAPTLSConfig cfg = new EAPTLSConfig();

cfg.Base.ConfigName = "eaptls";

cfg.Base.SSID = "myEAPTLSNetwork";

cfg.EAP.Conn.ValidateServer = false;

cfg.EAP.Conn.FastReconnect = true;

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Example: Adding an EAP-TTLS network

EAPTTLSConfig cfg = new EAPTTLSConfig();

cfg.Base.ConfigName = "eapttls";

cfg.Base.SSID = "myEAPTTLSNetwork";

cfg.EAP.Conn.ValidateServer = false;

cfg.EAP.Cred.Type = CredentialsType.Password;

cfg.EAP.Cred.Source = CredentialsSource.FromProfile;

cfg.EAP.Cred.UserName = "myUser";

cfg.EAP.Cred.Password = "myPassword";

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Example: Adding an EAP-LEAP network

LEAPConfig cfg = new LEAPConfig();

cfg.Base.ConfigName = "leap";

cfg.Base.SSID = "myLeapNetwork";

cfg.EAP.Cred.Type = CredentialsType.Password;

cfg.EAP.Cred.Source = CredentialsSource.FromProfile;

cfg.Base.Cckm = true;

cfg.EAP.Cred.UserName = "myUser";

cfg.EAP.Cred.Password = "myPassword";

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Example: Adding an EAP-FAST network

EAPFASTConfig cfg = new EAPFASTConfig();

cfg.Base.ConfigName = "eapfast";

cfg.Base.SSID = "myEAPFASTNetwork";

cfg.EAP.Cred.Type = CredentialsType.Password;

cfg.EAP.Cred.Source = CredentialsSource.FromProfile;

cfg.EAP.InnerMethod = EapInnerMethod.EapMschapV2;

cfg.Base.Cckm = true;

cfg.EAP.Cred.UserName = "myUser";

cfg.EAP.Cred.Password = "myPassword";

try {

WiFi.AddConfig(cfg);

}

catch (WiFiException ex) {

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

DEPRECATED EXAMPLES

The following examples are no longer valid. SDK version 2.1.0.54 was the last version in which these were supported. Please refer to the above examples instead.

Deprecated Example: Adding a WPA2-PSK network

StandardWiFiConfig cfg = new StandardWiFiConfig();

cfg.ConfigName = "myNetwork";

cfg.SSID = "mySSID";

cfg.AuthType = Authentication.Wpa2Psk;

cfg.Encr = Encryption.Aes;

cfg.Broadcast = true;

cfg.PSK = "myPassword";

try

{

WiFi.AddConfig(cfg);

}

catch (WiFiException ex)

{

outputWriteLine("Error adding " + ex.ErrorCode);

}

Deprecated Example: Adding an open network

StandardWiFiConfig cfg = new StandardWiFiConfig();

cfg.ConfigName = "myNetwork";

cfg.SSID = "mySSID";

cfg.AuthType = Authentication.Open;

cfg.Encr = Encryption.None;

cfg.Broadcast = true;

try

{

WiFi.AddConfig(cfg);

}

catch (WiFiException ex)

{

outputWriteLine("Error adding " + ex.ErrorCode);

}

Deprecated Example: Adding an EAP-PEAP network

EapWiFiConfig cfg = new EapWiFiConfig();

cfg.SSID = "myPeapNetwork";

cfg.AuthType = Authentication.Wpa2;

cfg.EapType = EapTypes.PppEapPeap;

cfg.CredType = CredentialsType.Password;

cfg.CredSource = CredentialsSource.FromProfile;

cfg.InnerMethod = EapInnerMethod.EapMschapV2;

cfg.UserName = "myUser";

cfg.Password = "myPassword";

try

{

WiFi.AddConfig(cfg);

}

catch (WiFiException ex)

{

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Deprecated Example: Adding an LEAP network

EapWiFiConfig cfg = new EapWiFiConfig();

cfg.SSID = "myLeapNetwork";

cfg.AuthType = Authentication.Wpa2;

cfg.EapType = EapTypes.DlEapLeap;

cfg.Cckm = true;

cfg.CredType = CredentialsType.Password;

cfg.CredSource = CredentialsSource.FromProfile;

cfg.InnerMethod = EapInnerMethod.EapMschapV2;

cfg.UserName = "myUser";

cfg.Password = "myPass";

try

{

WiFi.AddConfig(cfg);

}

catch (WiFiException ex)

{

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Deprecated Example: Adding an EAP-FAST network

EapWiFiConfig cfg = new EapWiFiConfig();

cfg.SSID = "myEapFastNetwork";

cfg.AuthType = Authentication.Wpa2;

cfg.EapType = EapTypes.DlEapFast;

cfg.Cckm = true;

cfg.CredType = CredentialsType.Password;

cfg.CredSource = CredentialsSource.FromProfile;

cfg.InnerMethod = EapInnerMethod.EapMschapV2;

cfg.UserName = "myUser";

cfg.Password = "myPass";

try

{

WiFi.AddConfig(cfg);

}

catch (WiFiException ex)

{

Debug.WriteLine("Error adding EAP profile, err " + ex.ErrorCode);

}

Remarks

Supported devices: Skorpio X4, Falcon X4

See Also

WiFi (Class), Example #43.