Detailed Description

Modules
	wlan configuration variables

Data Structures
struct	mmagic_core_wlan_connect_cmd_args
	Command arguments structure for wlan_connect. More...

struct	mmagic_core_wlan_scan_cmd_args
	Command arguments structure for wlan_scan. More...

struct	mmagic_core_wlan_scan_rsp_args
	Response arguments structure for wlan_scan. More...

struct	mmagic_core_wlan_get_rssi_rsp_args
	Response arguments structure for wlan_get_rssi. More...

struct	mmagic_core_wlan_get_mac_addr_rsp_args
	Response arguments structure for wlan_get_mac_addr. More...

struct	mmagic_core_wlan_wnm_sleep_cmd_args
	Command arguments structure for wlan_wnm_sleep. More...

struct	mmagic_core_wlan_beacon_monitor_enable_cmd_args
	Command arguments structure for wlan_beacon_monitor_enable. More...

struct	mmagic_core_wlan_get_sta_status_rsp_args
	Response arguments structure for wlan_get_sta_status. More...

struct	mmagic_wlan_beacon_rx_event_args
	Event arguments structure for wlan_beacon_rx. More...

struct	mmagic_wlan_sta_event_event_args
	Event arguments structure for wlan_sta_event. More...

Typedefs
typedef void(*	mmagic_wlan_beacon_rx_event_handler_t) (const struct mmagic_wlan_beacon_rx_event_args event_args, void arg)
	Handler for the wlan-beacon_rx event. More...

typedef void(*	mmagic_wlan_sta_event_event_handler_t) (const struct mmagic_wlan_sta_event_event_args event_args, void arg)
	Handler for the wlan-sta_event event. More...

Functions
static enum mmagic_status	mmagic_controller_wlan_connect (struct mmagic_controller controller, struct mmagic_core_wlan_connect_cmd_args cmd_args)
	Brings up the WLAN interface and connects to the AP with configured parameters. More...

static enum mmagic_status	mmagic_controller_wlan_disconnect (struct mmagic_controller *controller)
	Disconnects and brings down the WLAN interface. More...

static enum mmagic_status	mmagic_controller_wlan_scan (struct mmagic_controller controller, struct mmagic_core_wlan_scan_cmd_args cmd_args, struct mmagic_core_wlan_scan_rsp_args *rsp_args)
	Starts an undirected scan for available networks. More...

static enum mmagic_status	mmagic_controller_wlan_get_rssi (struct mmagic_controller controller, struct mmagic_core_wlan_get_rssi_rsp_args rsp_args)
	Retrieves the RSSI if the WLAN interface is up, else 0. More...

static enum mmagic_status	mmagic_controller_wlan_get_mac_addr (struct mmagic_controller controller, struct mmagic_core_wlan_get_mac_addr_rsp_args rsp_args)
	Retrieves the MAC address if the WLAN interface is up. More...

static enum mmagic_status	mmagic_controller_wlan_wnm_sleep (struct mmagic_controller controller, struct mmagic_core_wlan_wnm_sleep_cmd_args cmd_args)
	Requests entry or exit from extended sleep (wnm sleep) if the WLAN interface is up. More...

static enum mmagic_status	mmagic_controller_wlan_beacon_monitor_enable (struct mmagic_controller controller, struct mmagic_core_wlan_beacon_monitor_enable_cmd_args cmd_args)
	Enable beacon monitoring with the given filter settings. More...

static enum mmagic_status	mmagic_controller_wlan_beacon_monitor_disable (struct mmagic_controller *controller)
	Disable beacon monitoring. More...

static enum mmagic_status	mmagic_controller_wlan_get_sta_status (struct mmagic_controller controller, struct mmagic_core_wlan_get_sta_status_rsp_args rsp_args)
	Retrieves the STA status of the WLAN interface. More...

static enum mmagic_status	mmagic_controller_wlan_dpp_push_button_start (struct mmagic_controller *controller)
	Instructs the WLAN device to start the Device Provisioning Protocol (DPP) Push Button (PB) provisioning process. More...

static enum mmagic_status	mmagic_controller_wlan_dpp_stop (struct mmagic_controller *controller)
	Instructs the WLAN device to abort the ongoing DPP session. More...

void	mmagic_controller_register_wlan_beacon_rx_handler (struct mmagic_controller controller, mmagic_wlan_beacon_rx_event_handler_t handler, void arg)
	Register a handler for the wlan-beacon_rx event. More...

void	mmagic_controller_register_wlan_sta_event_handler (struct mmagic_controller controller, mmagic_wlan_sta_event_event_handler_t handler, void arg)
	Register a handler for the wlan-sta_event event. More...

Typedef Documentation

◆ mmagic_wlan_beacon_rx_event_handler_t

typedef void(* mmagic_wlan_beacon_rx_event_handler_t) (const struct mmagic_wlan_beacon_rx_event_args *event_args, void *arg)

Handler for the wlan-beacon_rx event.

Triggered when a beacon matching the configured beacon monitor filter(s) is received.

Note: This function will be invoked in the context of the controller data link thread and should perform minimal processing.

Warning: This function must not invoke any mmagic API functions.

Parameters

event_args	Notification arguments received from the agent.
arg	Opaque argument that was provided when the callback was registered.

Definition at line 3833 of file mmagic_controller.h.

◆ mmagic_wlan_sta_event_event_handler_t

typedef void(* mmagic_wlan_sta_event_event_handler_t) (const struct mmagic_wlan_sta_event_event_args *event_args, void *arg)

Handler for the wlan-sta_event event.

Triggered when STA event occurs when in STA mode.

Note: This function will be invoked in the context of the controller data link thread and should perform minimal processing.

Warning: This function must not invoke any mmagic API functions.

Parameters

event_args	Notification arguments received from the agent.
arg	Opaque argument that was provided when the callback was registered.

Definition at line 3876 of file mmagic_controller.h.

Function Documentation

◆ mmagic_controller_register_wlan_beacon_rx_handler()

void mmagic_controller_register_wlan_beacon_rx_handler	(	struct mmagic_controller *	controller,
		mmagic_wlan_beacon_rx_event_handler_t	handler,
		void *	arg
	)

Register a handler for the wlan-beacon_rx event.

Triggered when a beacon matching the configured beacon monitor filter(s) is received.

Note: The handler callbacks will be invoked in the context of the controller data link thread. The handler should perform minimal processing.

Warning: The handler callback must not invoke any mmagic API functions.

Parameters

controller	Reference to the the controller handle.
handler	The handler function to register.
arg	Opaque argument to be passed to the handler when it is invoked.

◆ mmagic_controller_register_wlan_sta_event_handler()

void mmagic_controller_register_wlan_sta_event_handler	(	struct mmagic_controller *	controller,
		mmagic_wlan_sta_event_event_handler_t	handler,
		void *	arg
	)

Register a handler for the wlan-sta_event event.

Triggered when STA event occurs when in STA mode.

Note: The handler callbacks will be invoked in the context of the controller data link thread. The handler should perform minimal processing.

Warning: The handler callback must not invoke any mmagic API functions.

Parameters

controller	Reference to the the controller handle.
handler	The handler function to register.
arg	Opaque argument to be passed to the handler when it is invoked.

◆ mmagic_controller_wlan_beacon_monitor_disable()

static enum mmagic_status mmagic_controller_wlan_beacon_monitor_disable ( struct mmagic_controller * controller )

inlinestatic

Disable beacon monitoring.

If beacon monitor is not enabled then this has no effect.

Parameters

controller Reference to the controller handle.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3659 of file mmagic_controller.h.

◆ mmagic_controller_wlan_beacon_monitor_enable()

static enum mmagic_status mmagic_controller_wlan_beacon_monitor_enable	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_beacon_monitor_enable_cmd_args *	cmd_args
	)

inlinestatic

Enable beacon monitoring with the given filter settings.

If beacon monitoring is already enabled it will be reconfigured with the given arguments.

Parameters

	controller	Reference to the controller handle.
[in]	cmd_args	Command arguments

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3622 of file mmagic_controller.h.

◆ mmagic_controller_wlan_connect()

static enum mmagic_status mmagic_controller_wlan_connect	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_connect_cmd_args *	cmd_args
	)

inlinestatic

Brings up the WLAN interface and connects to the AP with configured parameters.

Parameters

	controller	Reference to the controller handle.
[in]	cmd_args	Command arguments

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3322 of file mmagic_controller.h.

◆ mmagic_controller_wlan_disconnect()

static enum mmagic_status mmagic_controller_wlan_disconnect ( struct mmagic_controller * controller )

inlinestatic

Disconnects and brings down the WLAN interface.

Parameters

controller Reference to the controller handle.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3369 of file mmagic_controller.h.

◆ mmagic_controller_wlan_dpp_push_button_start()

static enum mmagic_status mmagic_controller_wlan_dpp_push_button_start ( struct mmagic_controller * controller )

inlinestatic

Instructs the WLAN device to start the Device Provisioning Protocol (DPP) Push Button (PB) provisioning process.

SSID and password will be automatically copied to wlan.ssid and wlan.password and saved in the persistent config store.

Parameters

controller Reference to the controller handle.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3744 of file mmagic_controller.h.

◆ mmagic_controller_wlan_dpp_stop()

static enum mmagic_status mmagic_controller_wlan_dpp_stop ( struct mmagic_controller * controller )

inlinestatic

Instructs the WLAN device to abort the ongoing DPP session.

Parameters

controller Reference to the controller handle.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3780 of file mmagic_controller.h.

◆ mmagic_controller_wlan_get_mac_addr()

static enum mmagic_status mmagic_controller_wlan_get_mac_addr	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_get_mac_addr_rsp_args *	rsp_args
	)

inlinestatic

Retrieves the MAC address if the WLAN interface is up.

Parameters

	controller	Reference to the controller handle.
[out]	rsp_args	Pointer to the data structure to be filled out with the result. If the return code is not `MMAGIC_STATUS_OK` then the contents of this structure will be undefined.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3531 of file mmagic_controller.h.

◆ mmagic_controller_wlan_get_rssi()

static enum mmagic_status mmagic_controller_wlan_get_rssi	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_get_rssi_rsp_args *	rsp_args
	)

inlinestatic

Retrieves the RSSI if the WLAN interface is up, else 0.

Parameters

	controller	Reference to the controller handle.
[out]	rsp_args	Pointer to the data structure to be filled out with the result. If the return code is not `MMAGIC_STATUS_OK` then the contents of this structure will be undefined.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3484 of file mmagic_controller.h.

◆ mmagic_controller_wlan_get_sta_status()

static enum mmagic_status mmagic_controller_wlan_get_sta_status	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_get_sta_status_rsp_args *	rsp_args
	)

inlinestatic

Retrieves the STA status of the WLAN interface.

Parameters

	controller	Reference to the controller handle.
[out]	rsp_args	Pointer to the data structure to be filled out with the result. If the return code is not `MMAGIC_STATUS_OK` then the contents of this structure will be undefined.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3705 of file mmagic_controller.h.

◆ mmagic_controller_wlan_scan()

static enum mmagic_status mmagic_controller_wlan_scan	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_scan_cmd_args *	cmd_args,
		struct mmagic_core_wlan_scan_rsp_args *	rsp_args
	)

inlinestatic

Starts an undirected scan for available networks.

Parameters

	controller	Reference to the controller handle.
[in]	cmd_args	Command arguments
[out]	rsp_args	Pointer to the data structure to be filled out with the result. If the return code is not `MMAGIC_STATUS_OK` then the contents of this structure will be undefined.

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3426 of file mmagic_controller.h.

◆ mmagic_controller_wlan_wnm_sleep()

static enum mmagic_status mmagic_controller_wlan_wnm_sleep	(	struct mmagic_controller *	controller,
		struct mmagic_core_wlan_wnm_sleep_cmd_args *	cmd_args
	)

inlinestatic

Requests entry or exit from extended sleep (wnm sleep) if the WLAN interface is up.

Parameters

	controller	Reference to the controller handle.
[in]	cmd_args	Command arguments

Returns: MMAGIC_STATUS_OK else an appropriate error code.

Definition at line 3576 of file mmagic_controller.h.

Detailed Description

Modules

Data Structures

Typedefs

Functions

Typedef Documentation

◆ mmagic_wlan_beacon_rx_event_handler_t

◆ mmagic_wlan_sta_event_event_handler_t

Function Documentation

◆ mmagic_controller_register_wlan_beacon_rx_handler()

◆ mmagic_controller_register_wlan_sta_event_handler()

◆ mmagic_controller_wlan_beacon_monitor_disable()

◆ mmagic_controller_wlan_beacon_monitor_enable()

◆ mmagic_controller_wlan_connect()

◆ mmagic_controller_wlan_disconnect()

◆ mmagic_controller_wlan_dpp_push_button_start()

◆ mmagic_controller_wlan_dpp_stop()

◆ mmagic_controller_wlan_get_mac_addr()

◆ mmagic_controller_wlan_get_rssi()

◆ mmagic_controller_wlan_get_sta_status()

◆ mmagic_controller_wlan_scan()

◆ mmagic_controller_wlan_wnm_sleep()