2 * P2P - Internal definitions for P2P module
3 * Copyright (c) 2009-2010, Atheros Communications
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
12 #include "utils/list.h"
15 #define P2P_GO_NEG_CNF_MAX_RETRY_COUNT 1
17 enum p2p_role_indication;
26 * struct p2p_device - P2P Device data (internal to P2P module)
30 struct os_reltime last_seen;
33 enum p2p_wps_method wps_method;
36 struct p2p_peer_info info;
39 * If the peer was discovered based on an interface address (e.g., GO
40 * from Beacon/Probe Response), the interface address is stored here.
41 * p2p_device_addr must still be set in such a case to the unique
42 * identifier for the P2P Device.
44 u8 interface_addr[ETH_ALEN];
47 * P2P Device Address of the GO in whose group this P2P Device is a
50 u8 member_in_go_dev[ETH_ALEN];
53 * P2P Interface Address of the GO in whose group this P2P Device is a
56 u8 member_in_go_iface[ETH_ALEN];
59 enum p2p_go_state go_state;
62 u8 intended_addr[ETH_ALEN];
65 struct p2p_channels channels;
71 * req_config_methods - Pending provision discovery methods
73 u16 req_config_methods;
76 * wps_prov_info - Stored provisioning WPS config method
78 * This is used to store pending WPS config method between Provisioning
79 * Discovery and connection to a running group.
83 #define P2P_DEV_PROBE_REQ_ONLY BIT(0)
84 #define P2P_DEV_REPORTED BIT(1)
85 #define P2P_DEV_NOT_YET_READY BIT(2)
86 #define P2P_DEV_PD_PEER_DISPLAY BIT(5)
87 #define P2P_DEV_PD_PEER_KEYPAD BIT(6)
88 #define P2P_DEV_USER_REJECTED BIT(7)
89 #define P2P_DEV_PEER_WAITING_RESPONSE BIT(8)
90 #define P2P_DEV_PREFER_PERSISTENT_GROUP BIT(9)
91 #define P2P_DEV_WAIT_GO_NEG_RESPONSE BIT(10)
92 #define P2P_DEV_WAIT_GO_NEG_CONFIRM BIT(11)
93 #define P2P_DEV_GROUP_CLIENT_ONLY BIT(12)
94 #define P2P_DEV_FORCE_FREQ BIT(13)
95 #define P2P_DEV_PD_FOR_JOIN BIT(14)
96 #define P2P_DEV_REPORTED_ONCE BIT(15)
97 #define P2P_DEV_PREFER_PERSISTENT_RECONN BIT(16)
98 #define P2P_DEV_PD_BEFORE_GO_NEG BIT(17)
99 #define P2P_DEV_NO_PREF_CHAN BIT(18)
100 #define P2P_DEV_WAIT_INV_REQ_ACK BIT(19)
103 int status; /* enum p2p_status_code */
104 unsigned int wait_count;
105 unsigned int connect_reqs;
106 unsigned int invitation_reqs;
107 unsigned int sd_reqs;
109 u16 ext_listen_period;
110 u16 ext_listen_interval;
116 * go_neg_conf_sent - Number of GO Negotiation Confirmation retries
121 * freq - Frquency on which the GO Negotiation Confirmation is sent
123 int go_neg_conf_freq;
126 * go_neg_conf - GO Negotiation Confirmation frame
128 struct wpabuf *go_neg_conf;
130 int sd_pending_bcast_queries;
133 struct p2p_sd_query {
134 struct p2p_sd_query *next;
137 int wsd; /* Wi-Fi Display Service Discovery Request */
141 struct p2p_pending_action_tx {
147 unsigned int wait_time;
148 /* Followed by len octets of the frame */
152 * struct p2p_data - P2P module data (internal to P2P module)
156 * cfg - P2P module configuration
158 * This is included in the same memory allocation with the
159 * struct p2p_data and as such, must not be freed separately.
161 struct p2p_config *cfg;
164 * state - The current P2P state
173 * P2P_SEARCH - Search (Device Discovery)
178 * P2P_CONNECT - Trying to start GO Negotiation
183 * P2P_CONNECT_LISTEN - Listen during GO Negotiation start
188 * P2P_GO_NEG - In GO Negotiation
193 * P2P_LISTEN_ONLY - Listen only
198 * P2P_WAIT_PEER_CONNECT - Waiting peer in List for GO Neg
200 P2P_WAIT_PEER_CONNECT,
203 * P2P_WAIT_PEER_IDLE - Waiting peer idle for GO Neg
208 * P2P_SD_DURING_FIND - Service Discovery during find
213 * P2P_PROVISIONING - Provisioning (during group formation)
218 * P2P_PD_DURING_FIND - Provision Discovery during find
223 * P2P_INVITE - Trying to start Invite
228 * P2P_INVITE_LISTEN - Listen during Invite
234 * min_disc_int - minDiscoverableInterval
239 * max_disc_int - maxDiscoverableInterval
244 * max_disc_tu - Maximum number of TUs for discoverable interval
249 * devices - List of known P2P Device peers
251 struct dl_list devices;
254 * go_neg_peer - Pointer to GO Negotiation peer
256 struct p2p_device *go_neg_peer;
259 * invite_peer - Pointer to Invite peer
261 struct p2p_device *invite_peer;
264 * last_p2p_find_oper - Pointer to last pre-find operation peer
266 struct p2p_device *last_p2p_find_oper;
268 const u8 *invite_go_dev_addr;
269 u8 invite_go_dev_addr_buf[ETH_ALEN];
270 int invite_dev_pw_id;
272 unsigned int retry_invite_req;
275 * sd_peer - Pointer to Service Discovery peer
277 struct p2p_device *sd_peer;
280 * sd_query - Pointer to Service Discovery query
282 struct p2p_sd_query *sd_query;
285 * num_p2p_sd_queries - Total number of broadcast SD queries present in
288 int num_p2p_sd_queries;
290 /* GO Negotiation data */
293 * intended_addr - Local Intended P2P Interface Address
295 * This address is used during group owner negotiation as the Intended
296 * P2P Interface Address and the group interface will be created with
297 * address as the local address in case of successfully completed
300 u8 intended_addr[ETH_ALEN];
303 * go_intent - Local GO Intent to be used during GO Negotiation
308 * next_tie_breaker - Next tie-breaker value to use in GO Negotiation
313 * ssid - Selected SSID for GO Negotiation (if local end will be GO)
318 * ssid_len - ssid length in octets
323 * ssid_set - Whether SSID is already set for GO Negotiation
328 * Regulatory class for own operational channel
333 * op_channel - Own operational channel
338 * channels - Own supported regulatory classes and channels
340 * List of supposerted channels per regulatory class. The regulatory
341 * classes are defined in IEEE Std 802.11-2007 Annex J and the
342 * numbering of the clases depends on the configured country code.
344 struct p2p_channels channels;
346 struct wpa_freq_range_list no_go_freq;
348 enum p2p_pending_action_state {
349 P2P_NO_PENDING_ACTION,
350 P2P_PENDING_GO_NEG_REQUEST,
351 P2P_PENDING_GO_NEG_RESPONSE,
352 P2P_PENDING_GO_NEG_RESPONSE_FAILURE,
353 P2P_PENDING_GO_NEG_CONFIRM,
356 P2P_PENDING_INVITATION_REQUEST,
357 P2P_PENDING_INVITATION_RESPONSE,
358 P2P_PENDING_DEV_DISC_REQUEST,
359 P2P_PENDING_DEV_DISC_RESPONSE,
360 P2P_PENDING_GO_DISC_REQ
361 } pending_action_state;
363 unsigned int pending_listen_freq;
364 unsigned int pending_listen_sec;
365 unsigned int pending_listen_usec;
373 * sd_queries - Pending service discovery queries
375 struct p2p_sd_query *sd_queries;
378 * srv_update_indic - Service Update Indicator for local services
380 u16 srv_update_indic;
382 struct wpabuf *sd_resp; /* Fragmented SD response */
383 u8 sd_resp_addr[ETH_ALEN];
384 u8 sd_resp_dialog_token;
385 size_t sd_resp_pos; /* Offset in sd_resp */
388 struct wpabuf *sd_rx_resp; /* Reassembled SD response */
389 u16 sd_rx_update_indic;
391 /* P2P Invitation data */
392 enum p2p_invite_role inv_role;
393 u8 inv_bssid[ETH_ALEN];
398 u8 inv_group_bssid[ETH_ALEN];
399 u8 *inv_group_bssid_ptr;
400 u8 inv_go_dev_addr[ETH_ALEN];
405 enum p2p_discovery_type find_type;
406 unsigned int last_p2p_find_timeout;
407 u8 last_prog_scan_class;
408 u8 last_prog_scan_chan;
409 int p2p_scan_running;
410 enum p2p_after_scan {
411 P2P_AFTER_SCAN_NOTHING,
412 P2P_AFTER_SCAN_LISTEN,
413 P2P_AFTER_SCAN_CONNECT
415 u8 after_scan_peer[ETH_ALEN];
416 struct p2p_pending_action_tx *after_scan_tx;
417 unsigned int after_scan_tx_in_progress:1;
418 unsigned int send_action_in_progress:1;
420 /* Requested device types for find/search */
421 unsigned int num_req_dev_types;
424 u8 find_dev_id_buf[ETH_ALEN];
426 struct os_reltime find_start; /* time of last p2p_find start */
428 struct p2p_group **groups;
431 struct p2p_device *pending_client_disc_go;
432 u8 pending_client_disc_addr[ETH_ALEN];
433 u8 pending_dev_disc_dialog_token;
434 u8 pending_dev_disc_addr[ETH_ALEN];
435 int pending_dev_disc_freq;
436 unsigned int pending_client_disc_freq;
439 unsigned int ext_listen_period;
440 unsigned int ext_listen_interval;
441 unsigned int ext_listen_interval_sec;
442 unsigned int ext_listen_interval_usec;
444 u8 peer_filter[ETH_ALEN];
450 int best_freq_overall;
451 int own_freq_preference;
454 * wps_vendor_ext - WPS Vendor Extensions to add
456 struct wpabuf *wps_vendor_ext[P2P_MAX_WPS_VENDOR_EXT];
459 * user_initiated_pd - Whether a PD request is user initiated or not.
461 u8 user_initiated_pd;
464 * Keep track of which peer a given PD request was sent to.
465 * Used to raise a timeout alert in case there is no response.
467 u8 pending_pd_devaddr[ETH_ALEN];
470 * Retry counter for provision discovery requests when issued
476 * pd_force_freq - Forced frequency for PD retries or 0 to auto-select
478 * This is is used during PD retries for join-a-group case to use the
479 * correct operating frequency determined from a BSS entry for the GO.
486 /* Extra delay in milliseconds between search iterations */
487 unsigned int search_delay;
490 u8 pending_reg_class;
492 u8 pending_channel_forced;
494 #ifdef CONFIG_WIFI_DISPLAY
495 struct wpabuf *wfd_ie_beacon;
496 struct wpabuf *wfd_ie_probe_req;
497 struct wpabuf *wfd_ie_probe_resp;
498 struct wpabuf *wfd_ie_assoc_req;
499 struct wpabuf *wfd_ie_invitation;
500 struct wpabuf *wfd_ie_prov_disc_req;
501 struct wpabuf *wfd_ie_prov_disc_resp;
502 struct wpabuf *wfd_ie_go_neg;
503 struct wpabuf *wfd_dev_info;
504 struct wpabuf *wfd_assoc_bssid;
505 struct wpabuf *wfd_coupled_sink_info;
506 #endif /* CONFIG_WIFI_DISPLAY */
508 u16 authorized_oob_dev_pw_id;
510 struct wpabuf **vendor_elem;
514 * struct p2p_message - Parsed P2P message (or P2P IE)
517 struct wpabuf *p2p_attributes;
518 struct wpabuf *wps_attributes;
519 struct wpabuf *wfd_subelems;
523 const u8 *capability;
526 const u8 *listen_channel;
527 const u8 *operating_channel;
528 const u8 *channel_list;
530 const u8 *config_timeout;
531 const u8 *intended_addr;
532 const u8 *group_bssid;
533 const u8 *invitation_flags;
535 const u8 *group_info;
536 size_t group_info_len;
543 const u8 *manageability;
548 const u8 *ext_listen_timing;
550 const u8 *minor_reason_code;
552 const u8 *oob_go_neg_channel;
554 /* P2P Device Info */
555 const u8 *p2p_device_info;
556 size_t p2p_device_info_len;
557 const u8 *p2p_device_addr;
558 const u8 *pri_dev_type;
559 u8 num_sec_dev_types;
560 char device_name[33];
565 int dev_password_id_present;
566 u16 wps_config_methods;
567 const u8 *wps_pri_dev_type;
568 const u8 *wps_sec_dev_type_list;
569 size_t wps_sec_dev_type_list_len;
570 const u8 *wps_vendor_ext[P2P_MAX_WPS_VENDOR_EXT];
571 size_t wps_vendor_ext_len[P2P_MAX_WPS_VENDOR_EXT];
572 const u8 *manufacturer;
573 size_t manufacturer_len;
574 const u8 *model_name;
575 size_t model_name_len;
576 const u8 *model_number;
577 size_t model_number_len;
578 const u8 *serial_number;
579 size_t serial_number_len;
580 const u8 *oob_dev_password;
581 size_t oob_dev_password_len;
583 /* DS Parameter Set IE */
591 #define P2P_MAX_GROUP_ENTRIES 50
593 struct p2p_group_info {
594 unsigned int num_clients;
595 struct p2p_client_info {
596 const u8 *p2p_device_addr;
597 const u8 *p2p_interface_addr;
600 const u8 *pri_dev_type;
601 u8 num_sec_dev_types;
602 const u8 *sec_dev_types;
603 const char *dev_name;
605 } client[P2P_MAX_GROUP_ENTRIES];
610 int p2p_random(char *buf, size_t len);
611 int p2p_channel_to_freq(int op_class, int channel);
612 int p2p_freq_to_channel(unsigned int freq, u8 *op_class, u8 *channel);
613 void p2p_channels_intersect(const struct p2p_channels *a,
614 const struct p2p_channels *b,
615 struct p2p_channels *res);
616 void p2p_channels_union_inplace(struct p2p_channels *res,
617 const struct p2p_channels *b);
618 void p2p_channels_union(const struct p2p_channels *a,
619 const struct p2p_channels *b,
620 struct p2p_channels *res);
621 void p2p_channels_remove_freqs(struct p2p_channels *chan,
622 const struct wpa_freq_range_list *list);
623 int p2p_channels_includes(const struct p2p_channels *channels, u8 reg_class,
625 void p2p_channels_dump(struct p2p_data *p2p, const char *title,
626 const struct p2p_channels *chan);
627 int p2p_channel_select(struct p2p_channels *chans, const int *classes,
628 u8 *op_class, u8 *op_channel);
629 int p2p_channel_random_social(struct p2p_channels *chans, u8 *op_class,
633 int p2p_parse_p2p_ie(const struct wpabuf *buf, struct p2p_message *msg);
634 int p2p_parse_ies(const u8 *data, size_t len, struct p2p_message *msg);
635 int p2p_parse(const u8 *data, size_t len, struct p2p_message *msg);
636 int p2p_parse_ies_separate(const u8 *wsc, size_t wsc_len, const u8 *p2p,
637 size_t p2p_len, struct p2p_message *msg);
638 void p2p_parse_free(struct p2p_message *msg);
639 int p2p_attr_text(struct wpabuf *data, char *buf, char *end);
640 int p2p_group_info_parse(const u8 *gi, size_t gi_len,
641 struct p2p_group_info *info);
645 struct p2p_noa_desc {
653 const u8 * p2p_group_get_interface_addr(struct p2p_group *group);
654 u8 p2p_group_presence_req(struct p2p_group *group,
655 const u8 *client_interface_addr,
656 const u8 *noa, size_t noa_len);
657 int p2p_group_is_group_id_match(struct p2p_group *group, const u8 *group_id,
658 size_t group_id_len);
659 void p2p_group_update_ies(struct p2p_group *group);
660 void p2p_group_force_beacon_update_ies(struct p2p_group *group);
661 struct wpabuf * p2p_group_get_wfd_ie(struct p2p_group *g);
662 void p2p_buf_add_group_info(struct p2p_group *group, struct wpabuf *buf,
664 void p2p_group_buf_add_id(struct p2p_group *group, struct wpabuf *buf);
665 int p2p_group_get_freq(struct p2p_group *group);
668 void p2p_buf_add_action_hdr(struct wpabuf *buf, u8 subtype, u8 dialog_token);
669 void p2p_buf_add_public_action_hdr(struct wpabuf *buf, u8 subtype,
671 u8 * p2p_buf_add_ie_hdr(struct wpabuf *buf);
672 void p2p_buf_add_status(struct wpabuf *buf, u8 status);
673 void p2p_buf_add_device_info(struct wpabuf *buf, struct p2p_data *p2p,
674 struct p2p_device *peer);
675 void p2p_buf_add_device_id(struct wpabuf *buf, const u8 *dev_addr);
676 void p2p_buf_update_ie_hdr(struct wpabuf *buf, u8 *len);
677 void p2p_buf_add_capability(struct wpabuf *buf, u8 dev_capab, u8 group_capab);
678 void p2p_buf_add_go_intent(struct wpabuf *buf, u8 go_intent);
679 void p2p_buf_add_listen_channel(struct wpabuf *buf, const char *country,
680 u8 reg_class, u8 channel);
681 void p2p_buf_add_operating_channel(struct wpabuf *buf, const char *country,
682 u8 reg_class, u8 channel);
683 void p2p_buf_add_channel_list(struct wpabuf *buf, const char *country,
684 struct p2p_channels *chan);
685 void p2p_buf_add_config_timeout(struct wpabuf *buf, u8 go_timeout,
687 void p2p_buf_add_intended_addr(struct wpabuf *buf, const u8 *interface_addr);
688 void p2p_buf_add_group_bssid(struct wpabuf *buf, const u8 *bssid);
689 void p2p_buf_add_group_id(struct wpabuf *buf, const u8 *dev_addr,
690 const u8 *ssid, size_t ssid_len);
691 void p2p_buf_add_invitation_flags(struct wpabuf *buf, u8 flags);
692 void p2p_buf_add_noa(struct wpabuf *buf, u8 noa_index, u8 opp_ps, u8 ctwindow,
693 struct p2p_noa_desc *desc1, struct p2p_noa_desc *desc2);
694 void p2p_buf_add_ext_listen_timing(struct wpabuf *buf, u16 period,
696 void p2p_buf_add_p2p_interface(struct wpabuf *buf, struct p2p_data *p2p);
697 void p2p_buf_add_oob_go_neg_channel(struct wpabuf *buf, const char *country,
698 u8 oper_class, u8 channel,
699 enum p2p_role_indication role);
700 int p2p_build_wps_ie(struct p2p_data *p2p, struct wpabuf *buf, int pw_id,
704 struct p2p_sd_query * p2p_pending_sd_req(struct p2p_data *p2p,
705 struct p2p_device *dev);
706 void p2p_free_sd_queries(struct p2p_data *p2p);
707 void p2p_rx_gas_initial_req(struct p2p_data *p2p, const u8 *sa,
708 const u8 *data, size_t len, int rx_freq);
709 void p2p_rx_gas_initial_resp(struct p2p_data *p2p, const u8 *sa,
710 const u8 *data, size_t len, int rx_freq);
711 void p2p_rx_gas_comeback_req(struct p2p_data *p2p, const u8 *sa,
712 const u8 *data, size_t len, int rx_freq);
713 void p2p_rx_gas_comeback_resp(struct p2p_data *p2p, const u8 *sa,
714 const u8 *data, size_t len, int rx_freq);
715 int p2p_start_sd(struct p2p_data *p2p, struct p2p_device *dev);
718 int p2p_peer_channels_check(struct p2p_data *p2p, struct p2p_channels *own,
719 struct p2p_device *dev,
720 const u8 *channel_list, size_t channel_list_len);
721 void p2p_process_go_neg_req(struct p2p_data *p2p, const u8 *sa,
722 const u8 *data, size_t len, int rx_freq);
723 void p2p_process_go_neg_resp(struct p2p_data *p2p, const u8 *sa,
724 const u8 *data, size_t len, int rx_freq);
725 void p2p_process_go_neg_conf(struct p2p_data *p2p, const u8 *sa,
726 const u8 *data, size_t len);
727 int p2p_connect_send(struct p2p_data *p2p, struct p2p_device *dev);
728 u16 p2p_wps_method_pw_id(enum p2p_wps_method wps_method);
729 void p2p_reselect_channel(struct p2p_data *p2p,
730 struct p2p_channels *intersection);
733 void p2p_process_prov_disc_req(struct p2p_data *p2p, const u8 *sa,
734 const u8 *data, size_t len, int rx_freq);
735 void p2p_process_prov_disc_resp(struct p2p_data *p2p, const u8 *sa,
736 const u8 *data, size_t len);
737 int p2p_send_prov_disc_req(struct p2p_data *p2p, struct p2p_device *dev,
738 int join, int force_freq);
739 void p2p_reset_pending_pd(struct p2p_data *p2p);
741 /* p2p_invitation.c */
742 void p2p_process_invitation_req(struct p2p_data *p2p, const u8 *sa,
743 const u8 *data, size_t len, int rx_freq);
744 void p2p_process_invitation_resp(struct p2p_data *p2p, const u8 *sa,
745 const u8 *data, size_t len);
746 int p2p_invite_send(struct p2p_data *p2p, struct p2p_device *dev,
747 const u8 *go_dev_addr, int dev_pw_id);
748 void p2p_invitation_req_cb(struct p2p_data *p2p, int success);
749 void p2p_invitation_resp_cb(struct p2p_data *p2p, int success);
752 void p2p_process_dev_disc_req(struct p2p_data *p2p, const u8 *sa,
753 const u8 *data, size_t len, int rx_freq);
754 void p2p_dev_disc_req_cb(struct p2p_data *p2p, int success);
755 int p2p_send_dev_disc_req(struct p2p_data *p2p, struct p2p_device *dev);
756 void p2p_dev_disc_resp_cb(struct p2p_data *p2p, int success);
757 void p2p_process_dev_disc_resp(struct p2p_data *p2p, const u8 *sa,
758 const u8 *data, size_t len);
759 void p2p_go_disc_req_cb(struct p2p_data *p2p, int success);
760 void p2p_process_go_disc_req(struct p2p_data *p2p, const u8 *da, const u8 *sa,
761 const u8 *data, size_t len, int rx_freq);
764 void p2p_set_state(struct p2p_data *p2p, int new_state);
765 void p2p_set_timeout(struct p2p_data *p2p, unsigned int sec,
767 void p2p_clear_timeout(struct p2p_data *p2p);
768 void p2p_continue_find(struct p2p_data *p2p);
769 struct p2p_device * p2p_add_dev_from_go_neg_req(struct p2p_data *p2p,
771 struct p2p_message *msg);
772 void p2p_add_dev_info(struct p2p_data *p2p, const u8 *addr,
773 struct p2p_device *dev, struct p2p_message *msg);
774 int p2p_add_device(struct p2p_data *p2p, const u8 *addr, int freq,
775 struct os_reltime *rx_time, int level, const u8 *ies,
776 size_t ies_len, int scan_res);
777 struct p2p_device * p2p_get_device(struct p2p_data *p2p, const u8 *addr);
778 struct p2p_device * p2p_get_device_interface(struct p2p_data *p2p,
780 void p2p_go_neg_failed(struct p2p_data *p2p, int status);
781 void p2p_go_complete(struct p2p_data *p2p, struct p2p_device *peer);
782 int p2p_match_dev_type(struct p2p_data *p2p, struct wpabuf *wps);
783 int dev_type_list_match(const u8 *dev_type, const u8 *req_dev_type[],
784 size_t num_req_dev_type);
785 struct wpabuf * p2p_build_probe_resp_ies(struct p2p_data *p2p);
786 void p2p_build_ssid(struct p2p_data *p2p, u8 *ssid, size_t *ssid_len);
787 int p2p_send_action(struct p2p_data *p2p, unsigned int freq, const u8 *dst,
788 const u8 *src, const u8 *bssid, const u8 *buf,
789 size_t len, unsigned int wait_time);
790 void p2p_stop_listen_for_freq(struct p2p_data *p2p, int freq);
791 int p2p_prepare_channel(struct p2p_data *p2p, struct p2p_device *dev,
792 unsigned int force_freq, unsigned int pref_freq,
794 void p2p_go_neg_wait_timeout(void *eloop_ctx, void *timeout_ctx);
795 void p2p_dbg(struct p2p_data *p2p, const char *fmt, ...)
797 void p2p_info(struct p2p_data *p2p, const char *fmt, ...)
799 void p2p_err(struct p2p_data *p2p, const char *fmt, ...)