P2P NFC: Build connection handover messages
[mech_eap.git] / src / p2p / p2p.h
index 4d40a9f..1dc71fa 100644 (file)
@@ -50,7 +50,7 @@ struct p2p_channels {
 };
 
 enum p2p_wps_method {
-       WPS_NOT_READY, WPS_PIN_DISPLAY, WPS_PIN_KEYPAD, WPS_PBC
+       WPS_NOT_READY, WPS_PIN_DISPLAY, WPS_PIN_KEYPAD, WPS_PBC, WPS_NFC
 };
 
 /**
@@ -77,6 +77,8 @@ struct p2p_go_neg_results {
 
        int ht40;
 
+       int vht;
+
        /**
         * ssid - SSID of the group
         */
@@ -88,6 +90,16 @@ struct p2p_go_neg_results {
        size_t ssid_len;
 
        /**
+        * psk - WPA pre-shared key (256 bits) (GO only)
+        */
+       u8 psk[32];
+
+       /**
+        * psk_set - Whether PSK field is configured (GO only)
+        */
+       int psk_set;
+
+       /**
         * passphrase - WPA2-Personal passphrase for the group (GO only)
         */
        char passphrase[64];
@@ -222,6 +234,7 @@ enum p2p_prov_disc_status {
        P2P_PROV_DISC_SUCCESS,
        P2P_PROV_DISC_TIMEOUT,
        P2P_PROV_DISC_REJECTED,
+       P2P_PROV_DISC_TIMEOUT_JOIN,
 };
 
 struct p2p_channel {
@@ -276,6 +289,20 @@ struct p2p_config {
        struct p2p_channels channels;
 
        /**
+        * cli_channels - Additional client channels
+        *
+        * This list of channels (if any) will be used when advertising local
+        * channels during GO Negotiation or Invitation for the cases where the
+        * local end may become the client. This may allow the peer to become a
+        * GO on additional channels if it supports these options. The main use
+        * case for this is to include passive-scan channels on devices that may
+        * not know their current location and have configured most channels to
+        * not allow initiation of radition (i.e., another device needs to take
+        * master responsibilities).
+        */
+       struct p2p_channels cli_channels;
+
+       /**
         * num_pref_chan - Number of pref_chan entries
         */
        unsigned int num_pref_chan;
@@ -360,14 +387,17 @@ struct p2p_config {
        unsigned int max_listen;
 
        /**
-        * msg_ctx - Context to use with wpa_msg() calls
+        * cb_ctx - Context to use with callback functions
         */
-       void *msg_ctx;
+       void *cb_ctx;
 
        /**
-        * cb_ctx - Context to use with callback functions
+        * debug_print - Debug print
+        * @ctx: Callback context from cb_ctx
+        * @level: Debug verbosity level (MSG_*)
+        * @msg: Debug message
         */
-       void *cb_ctx;
+       void (*debug_print)(void *ctx, int level, const char *msg);
 
 
        /* Callbacks to request lower layer driver operations */
@@ -534,6 +564,12 @@ struct p2p_config {
        void (*dev_lost)(void *ctx, const u8 *dev_addr);
 
        /**
+        * find_stopped - Notification of a p2p_find operation stopping
+        * @ctx: Callback context from cb_ctx
+        */
+       void (*find_stopped)(void *ctx);
+
+       /**
         * go_neg_req_rx - Notification of a receive GO Negotiation Request
         * @ctx: Callback context from cb_ctx
         * @src: Source address of the message triggering this notification
@@ -669,6 +705,7 @@ struct p2p_config {
         * @persistent_group: Whether this is an invitation to reinvoke a
         *      persistent group (instead of invitation to join an active
         *      group)
+        * @channels: Available operating channels for the group
         * Returns: Status code (P2P_SC_*)
         *
         * This optional callback can be used to implement persistent reconnect
@@ -689,7 +726,8 @@ struct p2p_config {
        u8 (*invitation_process)(void *ctx, const u8 *sa, const u8 *bssid,
                                 const u8 *go_dev_addr, const u8 *ssid,
                                 size_t ssid_len, int *go, u8 *group_bssid,
-                                int *force_freq, int persistent_group);
+                                int *force_freq, int persistent_group,
+                                const struct p2p_channels *channels);
 
        /**
         * invitation_received - Callback on Invitation Request RX
@@ -718,6 +756,9 @@ struct p2p_config {
         * @ctx: Callback context from cb_ctx
         * @status: Negotiation result (Status Code)
         * @bssid: P2P Group BSSID or %NULL if not received
+        * @channels: Available operating channels for the group
+        * @addr: Peer address
+        * @freq: Frequency (in MHz) indicated during invitation or 0
         *
         * This callback is used to indicate result of an Invitation procedure
         * started with a call to p2p_invite(). The indicated status code is
@@ -725,7 +766,9 @@ struct p2p_config {
         * (P2P_SC_SUCCESS) indicating success or -1 to indicate a timeout or a
         * local failure in transmitting the Invitation Request.
         */
-       void (*invitation_result)(void *ctx, int status, const u8 *bssid);
+       void (*invitation_result)(void *ctx, int status, const u8 *bssid,
+                                 const struct p2p_channels *channels,
+                                 const u8 *addr, int freq);
 
        /**
         * go_connected - Check whether we are connected to a GO
@@ -735,6 +778,26 @@ struct p2p_config {
         * or 0 if not.
         */
        int (*go_connected)(void *ctx, const u8 *dev_addr);
+
+       /**
+        * presence_resp - Callback on Presence Response
+        * @ctx: Callback context from cb_ctx
+        * @src: Source address (GO's P2P Interface Address)
+        * @status: Result of the request (P2P_SC_*)
+        * @noa: Returned NoA value
+        * @noa_len: Length of the NoA buffer in octets
+        */
+       void (*presence_resp)(void *ctx, const u8 *src, u8 status,
+                             const u8 *noa, size_t noa_len);
+
+       /**
+        * is_concurrent_session_active - Check whether concurrent session is
+        * active on other virtual interfaces
+        * @ctx: Callback context from cb_ctx
+        * Returns: 1 if concurrent session is active on other virtual interface
+        * or 0 if not.
+        */
+       int (*is_concurrent_session_active)(void *ctx);
 };
 
 
@@ -878,6 +941,12 @@ void p2p_stop_find_for_freq(struct p2p_data *p2p, int freq);
 int p2p_listen(struct p2p_data *p2p, unsigned int timeout);
 
 /**
+ * p2p_stop_listen - Stop P2P Listen
+ * @p2p: P2P module context from p2p_init()
+ */
+void p2p_stop_listen(struct p2p_data *p2p);
+
+/**
  * p2p_connect - Start P2P group formation (GO negotiation)
  * @p2p: P2P module context from p2p_init()
  * @peer_addr: MAC address of the peer P2P client
@@ -903,7 +972,7 @@ int p2p_connect(struct p2p_data *p2p, const u8 *peer_addr,
                int go_intent, const u8 *own_interface_addr,
                unsigned int force_freq, int persistent_group,
                const u8 *force_ssid, size_t force_ssid_len,
-               int pd_before_go_neg, unsigned int pref_freq);
+               int pd_before_go_neg, unsigned int pref_freq, u16 oob_pw_id);
 
 /**
  * p2p_authorize - Authorize P2P group formation (GO negotiation)
@@ -931,7 +1000,7 @@ int p2p_authorize(struct p2p_data *p2p, const u8 *peer_addr,
                  int go_intent, const u8 *own_interface_addr,
                  unsigned int force_freq, int persistent_group,
                  const u8 *force_ssid, size_t force_ssid_len,
-                 unsigned int pref_freq);
+                 unsigned int pref_freq, u16 oob_pw_id);
 
 /**
  * p2p_reject - Reject peer device (explicitly block connection attempts)
@@ -948,6 +1017,7 @@ int p2p_reject(struct p2p_data *p2p, const u8 *peer_addr);
  * @config_methods: WPS Config Methods value (only one bit set)
  * @join: Whether this is used by a client joining an active group
  * @force_freq: Forced TX frequency for the frame (mainly for the join case)
+ * @user_initiated_pd: Flag to indicate if initiated by user or not
  * Returns: 0 on success, -1 on failure
  *
  * This function can be used to request a discovered P2P peer to display a PIN
@@ -959,7 +1029,8 @@ int p2p_reject(struct p2p_data *p2p, const u8 *peer_addr);
  * indicated with the p2p_config::prov_disc_resp() callback.
  */
 int p2p_prov_disc_req(struct p2p_data *p2p, const u8 *peer_addr,
-                     u16 config_methods, int join, int force_freq);
+                     u16 config_methods, int join, int force_freq,
+                     int user_initiated_pd);
 
 /**
  * p2p_sd_request - Schedule a service discovery query
@@ -1029,12 +1100,14 @@ enum p2p_invite_role {
  * @force_freq: The only allowed channel frequency in MHz or 0
  * @go_dev_addr: Forced GO Device Address or %NULL if none
  * @persistent_group: Whether this is to reinvoke a persistent group
+ * @pref_freq: Preferred operating frequency in MHz or 0 (this is only used if
+ *     force_freq == 0)
  * Returns: 0 on success, -1 on failure
  */
 int p2p_invite(struct p2p_data *p2p, const u8 *peer, enum p2p_invite_role role,
               const u8 *bssid, const u8 *ssid, size_t ssid_len,
               unsigned int force_freq, const u8 *go_dev_addr,
-              int persistent_group);
+              int persistent_group, unsigned int pref_freq);
 
 /**
  * p2p_presence_req - Request GO presence
@@ -1170,6 +1243,7 @@ void p2p_rx_action(struct p2p_data *p2p, const u8 *da, const u8 *sa,
  * @p2p: P2P module context from p2p_init()
  * @bssid: BSSID of the scan result
  * @freq: Frequency of the channel on which the device was found in MHz
+ * @rx_time: Time when the result was received
  * @level: Signal level (signal strength of the received Beacon/Probe Response
  *     frame)
  * @ies: Pointer to IEs from the scan result
@@ -1191,7 +1265,8 @@ void p2p_rx_action(struct p2p_data *p2p, const u8 *da, const u8 *sa,
  * start of a pending operation, e.g., to start a pending GO negotiation.
  */
 int p2p_scan_res_handler(struct p2p_data *p2p, const u8 *bssid, int freq,
-                        int level, const u8 *ies, size_t ies_len);
+                        struct os_reltime *rx_time, int level, const u8 *ies,
+                        size_t ies_len);
 
 /**
  * p2p_scan_res_handled - Indicate end of scan results
@@ -1297,6 +1372,11 @@ struct p2p_group_config {
        size_t ssid_len;
 
        /**
+        * freq - Operating channel of the group
+        */
+       int freq;
+
+       /**
         * cb_ctx - Context to use with callback functions
         */
        void *cb_ctx;
@@ -1599,6 +1679,9 @@ int p2p_get_oper_freq(struct p2p_data *p2p, const u8 *iface_addr);
  */
 void p2p_set_intra_bss_dist(struct p2p_data *p2p, int enabled);
 
+int p2p_channels_includes_freq(const struct p2p_channels *channels,
+                              unsigned int freq);
+
 /**
  * p2p_supported_freq - Check whether channel is supported for P2P
  * @p2p: P2P module context from p2p_init()
@@ -1607,7 +1690,34 @@ void p2p_set_intra_bss_dist(struct p2p_data *p2p, int enabled);
  */
 int p2p_supported_freq(struct p2p_data *p2p, unsigned int freq);
 
-void p2p_update_channel_list(struct p2p_data *p2p, struct p2p_channels *chan);
+/**
+ * p2p_supported_freq_go - Check whether channel is supported for P2P GO operation
+ * @p2p: P2P module context from p2p_init()
+ * @freq: Channel frequency in MHz
+ * Returns: 0 if channel not usable for P2P, 1 if usable for P2P
+ */
+int p2p_supported_freq_go(struct p2p_data *p2p, unsigned int freq);
+
+/**
+ * p2p_supported_freq_cli - Check whether channel is supported for P2P client operation
+ * @p2p: P2P module context from p2p_init()
+ * @freq: Channel frequency in MHz
+ * Returns: 0 if channel not usable for P2P, 1 if usable for P2P
+ */
+int p2p_supported_freq_cli(struct p2p_data *p2p, unsigned int freq);
+
+/**
+ * p2p_get_pref_freq - Get channel from preferred channel list
+ * @p2p: P2P module context from p2p_init()
+ * @channels: List of channels
+ * Returns: Preferred channel
+ */
+unsigned int p2p_get_pref_freq(struct p2p_data *p2p,
+                              const struct p2p_channels *channels);
+
+void p2p_update_channel_list(struct p2p_data *p2p,
+                            const struct p2p_channels *chan,
+                            const struct p2p_channels *cli_chan);
 
 /**
  * p2p_set_best_channels - Update best channel information
@@ -1619,6 +1729,17 @@ void p2p_update_channel_list(struct p2p_data *p2p, struct p2p_channels *chan);
 void p2p_set_best_channels(struct p2p_data *p2p, int freq_24, int freq_5,
                           int freq_overall);
 
+/**
+ * p2p_set_own_freq_preference - Set own preference for channel
+ * @p2p: P2P module context from p2p_init()
+ * @freq: Frequency (MHz) of the preferred channel or 0 if no preference
+ *
+ * This function can be used to set a preference on the operating channel based
+ * on frequencies used on the other virtual interfaces that share the same
+ * radio. If non-zero, this is used to try to avoid multi-channel concurrency.
+ */
+void p2p_set_own_freq_preference(struct p2p_data *p2p, int freq);
+
 const u8 * p2p_get_go_neg_peer(struct p2p_data *p2p);
 
 /**
@@ -1704,18 +1825,20 @@ int p2p_set_pref_chan(struct p2p_data *p2p, unsigned int num_pref_chan,
                      const struct p2p_channel *pref_chan);
 
 /**
- * p2p_in_progress - Check whether a P2P operation is progress
+ * p2p_set_no_go_freq - Set no GO channel ranges
  * @p2p: P2P module context from p2p_init()
- * Returns: 0 if P2P module is idle or 1 if an operation is in progress
+ * @list: Channel ranges or %NULL to remove restriction
+ * Returns: 0 on success, -1 on failure
  */
-int p2p_in_progress(struct p2p_data *p2p);
+int p2p_set_no_go_freq(struct p2p_data *p2p,
+                      const struct wpa_freq_range_list *list);
 
 /**
- * p2p_other_scan_completed - Notify completion of non-P2P scan
+ * p2p_in_progress - Check whether a P2P operation is progress
  * @p2p: P2P module context from p2p_init()
- * Returns: 0 if P2P module is idle or 1 if an operation was started
+ * Returns: 0 if P2P module is idle or 1 if an operation is in progress
  */
-int p2p_other_scan_completed(struct p2p_data *p2p);
+int p2p_in_progress(struct p2p_data *p2p);
 
 const char * p2p_wps_method_text(enum p2p_wps_method method);
 
@@ -1728,8 +1851,6 @@ const char * p2p_wps_method_text(enum p2p_wps_method method);
 void p2p_set_config_timeout(struct p2p_data *p2p, u8 go_timeout,
                            u8 client_timeout);
 
-void p2p_increase_search_delay(struct p2p_data *p2p, unsigned int delay);
-
 int p2p_set_wfd_ie_beacon(struct p2p_data *p2p, struct wpabuf *ie);
 int p2p_set_wfd_ie_probe_req(struct p2p_data *p2p, struct wpabuf *ie);
 int p2p_set_wfd_ie_probe_resp(struct p2p_data *p2p, struct wpabuf *ie);
@@ -1765,4 +1886,18 @@ struct wpabuf * wifi_display_encaps(struct wpabuf *subelems);
 int p2p_set_disc_int(struct p2p_data *p2p, int min_disc_int, int max_disc_int,
                     int max_disc_tu);
 
+/**
+ * p2p_get_state_txt - Get current P2P state for debug purposes
+ * @p2p: P2P module context from p2p_init()
+ * Returns: Name of the current P2P module state
+ *
+ * It should be noted that the P2P module state names are internal information
+ * and subject to change at any point, i.e., this information should be used
+ * mainly for debugging purposes.
+ */
+const char * p2p_get_state_txt(struct p2p_data *p2p);
+
+struct wpabuf * p2p_build_nfc_handover_req(struct p2p_data *p2p);
+struct wpabuf * p2p_build_nfc_handover_sel(struct p2p_data *p2p);
+
 #endif /* P2P_H */