Link Search Menu Expand Document

Client - Association APIs

This interface provides information about the current association with a peer device.

Available APIs are listed below

WDRV_PIC32MZW_STATUS WDRV_PIC32MZW_AssocPeerAddressGet
(
	WDRV_PIC32MZW_ASSOC_HANDLE assocHandle, 
	WDRV_PIC32MZW_MAC_ADDR *const pPeerAddress
)

Description:

Attempts to retrieve the network address of the peer device in the current association.

Preconditions:

WDRV_PIC32MZW_Initialize must have been called.

WDRV_PIC32MZW_Open must have been called to obtain a valid handle.

A peer device needs to be connected and associated, the association handle should be obtained from the WDRV_PIC32MZW_BSSCON_NOTIFY_CALLBACK callback

Parameters:

Parameter Description
assocHandle Association handle.
pPeerAddress Pointer to structure to receive the network address.
   

Returns:

WDRV_PIC32MZW_STATUS_OK The request was accepted.
WDRV_PIC32MZW_STATUS_NOT_OPEN The driver instance is not open.
WDRV_PIC32MZW_STATUS_INVALID_ARG The parameters were incorrect.
WDRV_PIC32MZW_STATUS_REQUEST_ERROR The PIC32MZW1 was unable to accept this request.
WDRV_PIC32MZW_STATUS_RETRY_REQUEST The network address is not available, but it will be requested from the PIC32MZW1.
WDRV_PIC32MZW_STATUS_NOT_CONNECTED Not currently connected.

WDRV_PIC32MZW_STATUS WDRV_PIC32MZW_AssocRSSIGet
(
	WDRV_PIC32MZW_ASSOC_HANDLE assocHandle, 
	int8_t *const pRSSI, 
	WDRV_PIC32MZW_ASSOC_RSSI_CALLBACK const pfAssociationRSSICB
)

Description:

Attempts to retrieve the RSSI of the current association.

Preconditions:

WDRV_PIC32MZW_Initialize must have been called.

WDRV_PIC32MZW_Open must have been called to obtain a valid handle.

A peer device needs to be connected and associated.

Parameters:

Parameter Description
assocHandle Association handle.
pRSSI Pointer to variable to receive RSSI if available.
pfAssociationRSSICB Pointer to callback function to be used when RSSI value is available.
   

Returns:

WDRV_PIC32MZW_STATUS_OK - The request was accepted.
WDRV_PIC32MZW_STATUS_NOT_OPEN - The driver instance is not open.
WDRV_PIC32MZW_STATUS_INVALID_ARG - The parameters were incorrect.
WDRV_PIC32MZW_STATUS_REQUEST_ERROR - PIC32MZW1 was unable to accept request.
WDRV_PIC32MZW_STATUS_RETRY_REQUEST - Network address unavailable.
WDRV_PIC32MZW_STATUS_NOT_CONNECTED - Not currently connected.



Copyright © 2020 Microchip Technology.