wifi_mgmt.h

Go to the documentation of this file.

/*
 * Copyright (c) 2017 Intel Corporation.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_NET_WIFI_MGMT_H_
#define ZEPHYR_INCLUDE_NET_WIFI_MGMT_H_
 
#include <zephyr/net/net_mgmt.h>
#include <zephyr/net/wifi.h>
#include <zephyr/net/ethernet.h>
#include <zephyr/net/offloaded_netdev.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* Management part definitions */
 
#define _NET_WIFI_LAYER NET_MGMT_LAYER_L2
#define _NET_WIFI_CODE  0x156
#define _NET_WIFI_BASE  (NET_MGMT_IFACE_BIT |                   \
                         NET_MGMT_LAYER(_NET_WIFI_LAYER) |      \
                         NET_MGMT_LAYER_CODE(_NET_WIFI_CODE))
#define _NET_WIFI_EVENT (_NET_WIFI_BASE | NET_MGMT_EVENT_BIT)
 
enum net_request_wifi_cmd {
        NET_REQUEST_WIFI_CMD_SCAN = 1,
        NET_REQUEST_WIFI_CMD_CONNECT,
        NET_REQUEST_WIFI_CMD_DISCONNECT,
        NET_REQUEST_WIFI_CMD_AP_ENABLE,
        NET_REQUEST_WIFI_CMD_AP_DISABLE,
        NET_REQUEST_WIFI_CMD_IFACE_STATUS,
        NET_REQUEST_WIFI_CMD_PS,
        NET_REQUEST_WIFI_CMD_PS_MODE,
        NET_REQUEST_WIFI_CMD_TWT,
        NET_REQUEST_WIFI_CMD_PS_CONFIG,
        NET_REQUEST_WIFI_CMD_REG_DOMAIN,
        NET_REQUEST_WIFI_CMD_PS_TIMEOUT,
        NET_REQUEST_WIFI_CMD_MAX
};
 
#define NET_REQUEST_WIFI_SCAN                                   \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_SCAN)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_SCAN);
 
#define NET_REQUEST_WIFI_CONNECT                                \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_CONNECT)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_CONNECT);
 
#define NET_REQUEST_WIFI_DISCONNECT                             \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_DISCONNECT)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_DISCONNECT);
 
#define NET_REQUEST_WIFI_AP_ENABLE                              \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_ENABLE)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_AP_ENABLE);
 
#define NET_REQUEST_WIFI_AP_DISABLE                             \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_AP_DISABLE)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_AP_DISABLE);
 
#define NET_REQUEST_WIFI_IFACE_STATUS                           \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_IFACE_STATUS)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_IFACE_STATUS);
 
#define NET_REQUEST_WIFI_PS                             \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PS)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_PS);
 
#define NET_REQUEST_WIFI_PS_MODE                        \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PS_MODE)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_PS_MODE);
 
#define NET_REQUEST_WIFI_TWT                    \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_TWT)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_TWT);
 
#define NET_REQUEST_WIFI_PS_CONFIG                              \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PS_CONFIG)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_PS_CONFIG);
#define NET_REQUEST_WIFI_REG_DOMAIN                             \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_REG_DOMAIN)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_REG_DOMAIN);
 
#define NET_REQUEST_WIFI_PS_TIMEOUT                     \
        (_NET_WIFI_BASE | NET_REQUEST_WIFI_CMD_PS_TIMEOUT)
 
NET_MGMT_DEFINE_REQUEST_HANDLER(NET_REQUEST_WIFI_PS_TIMEOUT);
 
enum net_event_wifi_cmd {
        NET_EVENT_WIFI_CMD_SCAN_RESULT = 1,
        NET_EVENT_WIFI_CMD_SCAN_DONE,
        NET_EVENT_WIFI_CMD_CONNECT_RESULT,
        NET_EVENT_WIFI_CMD_DISCONNECT_RESULT,
        NET_EVENT_WIFI_CMD_IFACE_STATUS,
        NET_EVENT_WIFI_CMD_TWT,
        NET_EVENT_WIFI_CMD_TWT_SLEEP_STATE,
        NET_EVENT_WIFI_CMD_RAW_SCAN_RESULT,
        NET_EVENT_WIFI_CMD_DISCONNECT_COMPLETE,
};
 
#define NET_EVENT_WIFI_SCAN_RESULT                              \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_SCAN_RESULT)
 
#define NET_EVENT_WIFI_SCAN_DONE                                \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_SCAN_DONE)
 
#define NET_EVENT_WIFI_CONNECT_RESULT                           \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_CONNECT_RESULT)
 
#define NET_EVENT_WIFI_DISCONNECT_RESULT                        \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_DISCONNECT_RESULT)
 
#define NET_EVENT_WIFI_IFACE_STATUS                                             \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_IFACE_STATUS)
 
#define NET_EVENT_WIFI_TWT                                      \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_TWT)
 
#define NET_EVENT_WIFI_TWT_SLEEP_STATE                          \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_TWT_SLEEP_STATE)
 
#define NET_EVENT_WIFI_RAW_SCAN_RESULT                          \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_RAW_SCAN_RESULT)
 
#define NET_EVENT_WIFI_DISCONNECT_COMPLETE                      \
        (_NET_WIFI_EVENT | NET_EVENT_WIFI_CMD_DISCONNECT_COMPLETE)
/* Each result is provided to the net_mgmt_event_callback
 * via its info attribute (see net_mgmt.h)
 */
struct wifi_scan_result {
        uint8_t ssid[WIFI_SSID_MAX_LEN];
        uint8_t ssid_length;
 
        uint8_t band;
        uint8_t channel;
        enum wifi_security_type security;
        enum wifi_mfp_options mfp;
        int8_t rssi;
 
        uint8_t mac[WIFI_MAC_ADDR_LEN];
        uint8_t mac_length;
};
 
struct wifi_connect_req_params {
        const uint8_t *ssid;
        uint8_t ssid_length; /* Max 32 */
 
        uint8_t *psk;
        uint8_t psk_length; /* Min 8 - Max 64 */
 
        uint8_t *sae_password; /* Optional with fallback to psk */
        uint8_t sae_password_length; /* No length restrictions */
 
        uint8_t band;
        uint8_t channel;
        enum wifi_security_type security;
        enum wifi_mfp_options mfp;
        int timeout; /* SYS_FOREVER_MS for no timeout */
};
 
struct wifi_status {
        int status;
};
 
struct wifi_iface_status {
        int state; /* enum wifi_iface_state */
        unsigned int ssid_len;
        char ssid[WIFI_SSID_MAX_LEN];
        char bssid[WIFI_MAC_ADDR_LEN];
        enum wifi_frequency_bands band;
        unsigned int channel;
        enum wifi_iface_mode iface_mode;
        enum wifi_link_mode link_mode;
        enum wifi_security_type security;
        enum wifi_mfp_options mfp;
        int rssi;
        unsigned char dtim_period;
        unsigned short beacon_interval;
        bool twt_capable;
};
 
struct wifi_ps_params {
        enum wifi_ps enabled;
        unsigned short listen_interval;
        enum wifi_ps_wakeup_mode wakeup_mode;
        enum wifi_ps_mode mode;
        int timeout_ms;
        enum ps_param_type type;
        enum wifi_config_ps_param_fail_reason fail_reason;
};
 
struct wifi_twt_params {
        enum wifi_twt_operation operation;
        enum wifi_twt_negotiation_type negotiation_type;
        enum wifi_twt_setup_cmd setup_cmd;
        enum wifi_twt_setup_resp_status resp_status;
        /* Map requests to responses */
        uint8_t dialog_token;
        /* Map setup with teardown */
        uint8_t flow_id;
        union {
                struct {
                        /* Interval = Wake up time + Sleeping time */
                        uint64_t twt_interval;
                        bool responder;
                        bool trigger;
                        bool implicit;
                        bool announce;
                        /* Wake up time */
                        uint32_t twt_wake_interval;
                } setup;
                struct {
                        /* Only for Teardown */
                        bool teardown_all;
                } teardown;
        };
        enum wifi_twt_fail_reason fail_reason;
};
 
/* Flow ID is only 3 bits */
#define WIFI_MAX_TWT_FLOWS 8
#define WIFI_MAX_TWT_INTERVAL_US (LONG_MAX - 1)
/* 256 (u8) * 1TU */
#define WIFI_MAX_TWT_WAKE_INTERVAL_US 262144
struct wifi_twt_flow_info {
        /* Interval = Wake up time + Sleeping time */
        uint64_t  twt_interval;
        /* Map requests to responses */
        uint8_t dialog_token;
        /* Map setup with teardown */
        uint8_t flow_id;
        enum wifi_twt_negotiation_type negotiation_type;
        bool responder;
        bool trigger;
        bool implicit;
        bool announce;
        /* Wake up time */
        uint32_t twt_wake_interval;
};
 
struct wifi_ps_config {
        char num_twt_flows;
        struct wifi_twt_flow_info twt_flows[WIFI_MAX_TWT_FLOWS];
        struct wifi_ps_params ps_params;
};
 
/* Generic get/set operation for any command*/
enum wifi_mgmt_op {
        WIFI_MGMT_GET = 0,
        WIFI_MGMT_SET = 1,
};
 
struct wifi_reg_domain {
        enum wifi_mgmt_op oper;
        /* Ignore all other regulatory hints */
        bool force;
        uint8_t country_code[WIFI_COUNTRY_CODE_LEN];
};
 
enum wifi_twt_sleep_state {
        WIFI_TWT_STATE_SLEEP = 0,
        WIFI_TWT_STATE_AWAKE = 1,
};
 
#ifdef CONFIG_WIFI_MGMT_RAW_SCAN_RESULTS
struct wifi_raw_scan_result {
        int8_t rssi;
        int frame_length;
        unsigned short frequency;
        uint8_t data[CONFIG_WIFI_MGMT_RAW_SCAN_RESULT_LENGTH];
};
#endif /* CONFIG_WIFI_MGMT_RAW_SCAN_RESULTS */
#include <zephyr/net/net_if.h>
 
typedef void (*scan_result_cb_t)(struct net_if *iface, int status,
                                 struct wifi_scan_result *entry);
 
#ifdef CONFIG_WIFI_MGMT_RAW_SCAN_RESULTS
typedef void (*raw_scan_result_cb_t)(struct net_if *iface, int status,
                                     struct wifi_raw_scan_result *entry);
#endif /* CONFIG_WIFI_MGMT_RAW_SCAN_RESULTS */
struct net_wifi_mgmt_offload {
#ifdef CONFIG_WIFI_USE_NATIVE_NETWORKING
        struct ethernet_api wifi_iface;
#else
        struct offloaded_if_api wifi_iface;
#endif
 
        /* cb parameter is the cb that should be called for each
         * result by the driver. The wifi mgmt part will take care of
         * raising the necessary event etc...
         */
        int (*scan)(const struct device *dev, scan_result_cb_t cb);
        int (*connect)(const struct device *dev,
                       struct wifi_connect_req_params *params);
        int (*disconnect)(const struct device *dev);
        int (*ap_enable)(const struct device *dev,
                         struct wifi_connect_req_params *params);
        int (*ap_disable)(const struct device *dev);
        int (*iface_status)(const struct device *dev, struct wifi_iface_status *status);
#ifdef CONFIG_NET_STATISTICS_WIFI
        int (*get_stats)(const struct device *dev, struct net_stats_wifi *stats);
#endif /* CONFIG_NET_STATISTICS_WIFI */
        int (*set_power_save)(const struct device *dev, struct wifi_ps_params *params);
        int (*set_twt)(const struct device *dev, struct wifi_twt_params *params);
        int (*get_power_save_config)(const struct device *dev, struct wifi_ps_config *config);
        int (*reg_domain)(const struct device *dev, struct wifi_reg_domain *reg_domain);
};
 
/* Make sure that the network interface API is properly setup inside
 * Wifi mgmt offload API struct (it is the first one).
 */
BUILD_ASSERT(offsetof(struct net_wifi_mgmt_offload, wifi_iface) == 0);
 
void wifi_mgmt_raise_connect_result_event(struct net_if *iface, int status);
void wifi_mgmt_raise_disconnect_result_event(struct net_if *iface, int status);
void wifi_mgmt_raise_iface_status_event(struct net_if *iface,
                struct wifi_iface_status *iface_status);
void wifi_mgmt_raise_twt_event(struct net_if *iface,
                struct wifi_twt_params *twt_params);
void wifi_mgmt_raise_twt_sleep_state(struct net_if *iface, int twt_sleep_state);
#ifdef CONFIG_WIFI_MGMT_RAW_SCAN_RESULTS
void wifi_mgmt_raise_raw_scan_result_event(struct net_if *iface,
                struct wifi_raw_scan_result *raw_scan_info);
#endif /* CONFIG_WIFI_MGMT_RAW_SCAN_RESULTS */
void wifi_mgmt_raise_disconnect_complete_event(struct net_if *iface, int status);
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_NET_WIFI_MGMT_H_ */