Join an Access point.

Parameters

Obj	pointer to module handle
Ssid	the access point id.
Password	the Access point password.
SecType	Security type.

Return values

Operation

Status.< status code.

Disconnect from a network.

Parameters

Obj	pointer to module handle

Return values

Operation

Status.< status code.

Join an Access point with WPA-E.

Parameters

Obj	pointer to module handle
Ssid	the access point ID.
Identity	client identity.
Password	client password.
attr	extral attributes of EAP method. NULL for default mode EAP-PEAP.
ip	Station IP settings, NULL for DHCP mode.

Return values

Operation

Status.< status code.

wifi get scan result

Parameters

Obj	pointer to module handle
results	scan result buffer, contains mwifi_ap_info_t * number
number	max ap number to get, max 10

Return values

return

the real ap number got.

Note

must be called after

Get the local IPv6 address of the wifi module.

Parameters

Obj	pointer to module handle
ipaddr6	buf to the IPv6 address array(16 bytes).
addr_num	index of the IPv6 address (index: 0/1/2).
wifi_if	wifi mode(station or softap).

Return values

Operation

Status.< status code.

Get the local IPv6 address state of the wifi module.

Parameters

Obj	pointer to module handle
addr_num	index of the IPv6 address (index: 0/1/2).
wifi_if	wifi mode(station or softap).

Return values

IPV6	address State, error if < 0

Get the local IPv4 address of the wifi module.

Parameters

Obj	pointer to module handle
ipaddr	pointer to the IP address array(4 bytes).
wifi_if	wifi mode(station or softap).

Return values

Operation

Status.< status code.

Get the MAC address of the wifi module.

Parameters

Obj	pointer to module handle
mac	pointer to the MAC address array, size 6Bytes.

Return values

Operation

Status.< status code.

Get the firmware version string of the wifi module.

Parameters

Obj	pointer to module handle
version	buffer pointer to receive the version string.
size	length of the buffer, max size 24Bytes.

Return values

Operation

Status.< status code.

Check whether the module is connected to an access point.

Return values

link	status 1: connected, otherwise not connect.

Register wifi status changed callback.

Parameters

Obj	pointer to module handle
cb	wifi status callback function
arg	argument pass to callback

Return values

Operation

Status.< status code.

< status code.

Reset the module by Software.

Parameters

Obj	pointer to module handle

Return values

Operation

Status.< status code.

Reset To factory defaults.

Parameters

Obj	pointer to module handle

Note

NOT USED NOW

Return values

Operation

Status.< status code.

wifi block scan

Parameters

Obj	pointer to module handle
scan_mode	scan mode
ssid	ssid for active scan(scan specified AP), not used(set NULL) if do passive scan(scan all APs)
len	ssid len of the AP to scan, not used(set 0) if do passive scan

Note

This API just start scan, use to get the scan result.

1 Example:

2  Active scan:

3  MX_WIFI_Scan(pWifiObj, MC_SCAN_ACTIVE, "ssid_ap", 7);

4  Passive scan:

5  MX_WIFI_Scan(pWifiObj, MC_SCAN_PASSIVE, NULL, 0);

6 

7  Get scan result:

8  mwifi_ap_info_t mx_aps[MX_WIFI_MAX_DETECTED_AP]; ( array to store scan AP info )

9  int32_t ap_num;

10  ap_num = MX_WIFI_Get_scan_result(pWifiObj, (uint8_t*)&(mx_aps[0]), MX_WIFI_MAX_DETECTED_AP);

11  if(ap_num > 0)

12  {

13  for(int32_t i = 0; i < ap_num; i++)

14  {

15  ( mx_aps[i].ssid )

16  ( mx_aps[i].rssi )

17  }

18  }

Return values

Operation

Status.< status code.

UnRegister wifi status changed callback.

Parameters

Obj	pointer to module handle

Return values

Operation

Status.< status code.

< status code.

Join an Access point with WPS (PUSH-BUTTON) mode.

Return values

Operation

Status.< status code.

Stop WPS connect.

Parameters

Obj	pointer to module handle

Return values

Operation

Status.< status code.