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"
22 * struct p2p_device - P2P Device data (internal to P2P module)
26 struct os_time last_seen;
28 enum p2p_wps_method wps_method;
30 struct p2p_peer_info info;
33 * If the peer was discovered based on an interface address (e.g., GO
34 * from Beacon/Probe Response), the interface address is stored here.
35 * p2p_device_addr must still be set in such a case to the unique
36 * identifier for the P2P Device.
38 u8 interface_addr[ETH_ALEN];
41 * P2P Device Address of the GO in whose group this P2P Device is a
44 u8 member_in_go_dev[ETH_ALEN];
47 * P2P Interface Address of the GO in whose group this P2P Device is a
50 u8 member_in_go_iface[ETH_ALEN];
53 enum p2p_go_state go_state;
55 u8 intended_addr[ETH_ALEN];
58 struct p2p_channels channels;
64 * req_config_methods - Pending provision discovery methods
66 u16 req_config_methods;
69 * wps_prov_info - Stored provisioning WPS config method
71 * This is used to store pending WPS config method between Provisioning
72 * Discovery and connection to a running group.
76 #define P2P_DEV_PROBE_REQ_ONLY BIT(0)
77 #define P2P_DEV_REPORTED BIT(1)
78 #define P2P_DEV_NOT_YET_READY BIT(2)
79 #define P2P_DEV_SD_INFO BIT(3)
80 #define P2P_DEV_SD_SCHEDULE BIT(4)
81 #define P2P_DEV_PD_PEER_DISPLAY BIT(5)
82 #define P2P_DEV_PD_PEER_KEYPAD BIT(6)
83 #define P2P_DEV_USER_REJECTED BIT(7)
84 #define P2P_DEV_PEER_WAITING_RESPONSE BIT(8)
85 #define P2P_DEV_PREFER_PERSISTENT_GROUP BIT(9)
86 #define P2P_DEV_WAIT_GO_NEG_RESPONSE BIT(10)
87 #define P2P_DEV_WAIT_GO_NEG_CONFIRM BIT(11)
88 #define P2P_DEV_GROUP_CLIENT_ONLY BIT(12)
89 #define P2P_DEV_FORCE_FREQ BIT(13)
90 #define P2P_DEV_PD_FOR_JOIN BIT(14)
91 #define P2P_DEV_REPORTED_ONCE BIT(15)
92 #define P2P_DEV_PREFER_PERSISTENT_RECONN BIT(16)
93 #define P2P_DEV_PD_BEFORE_GO_NEG BIT(17)
96 int status; /* enum p2p_status_code */
97 unsigned int wait_count;
98 unsigned int connect_reqs;
99 unsigned int invitation_reqs;
101 u16 ext_listen_period;
102 u16 ext_listen_interval;
108 struct p2p_sd_query {
109 struct p2p_sd_query *next;
115 struct p2p_pending_action_tx {
121 unsigned int wait_time;
122 /* Followed by len octets of the frame */
126 * struct p2p_data - P2P module data (internal to P2P module)
130 * cfg - P2P module configuration
132 * This is included in the same memory allocation with the
133 * struct p2p_data and as such, must not be freed separately.
135 struct p2p_config *cfg;
138 * state - The current P2P state
147 * P2P_SEARCH - Search (Device Discovery)
152 * P2P_CONNECT - Trying to start GO Negotiation
157 * P2P_CONNECT_LISTEN - Listen during GO Negotiation start
162 * P2P_GO_NEG - In GO Negotiation
167 * P2P_LISTEN_ONLY - Listen only
172 * P2P_WAIT_PEER_CONNECT - Waiting peer in List for GO Neg
174 P2P_WAIT_PEER_CONNECT,
177 * P2P_WAIT_PEER_IDLE - Waiting peer idle for GO Neg
182 * P2P_SD_DURING_FIND - Service Discovery during find
187 * P2P_PROVISIONING - Provisioning (during group formation)
192 * P2P_PD_DURING_FIND - Provision Discovery during find
197 * P2P_INVITE - Trying to start Invite
202 * P2P_INVITE_LISTEN - Listen during Invite
207 * P2P_SEARCH_WHEN_READY - Waiting to start Search
209 P2P_SEARCH_WHEN_READY,
213 * min_disc_int - minDiscoverableInterval
218 * max_disc_int - maxDiscoverableInterval
223 * devices - List of known P2P Device peers
225 struct dl_list devices;
228 * go_neg_peer - Pointer to GO Negotiation peer
230 struct p2p_device *go_neg_peer;
233 * invite_peer - Pointer to Invite peer
235 struct p2p_device *invite_peer;
237 const u8 *invite_go_dev_addr;
238 u8 invite_go_dev_addr_buf[ETH_ALEN];
241 * sd_peer - Pointer to Service Discovery peer
243 struct p2p_device *sd_peer;
246 * sd_query - Pointer to Service Discovery query
248 struct p2p_sd_query *sd_query;
250 /* GO Negotiation data */
253 * intended_addr - Local Intended P2P Interface Address
255 * This address is used during group owner negotiation as the Intended
256 * P2P Interface Address and the group interface will be created with
257 * address as the local address in case of successfully completed
260 u8 intended_addr[ETH_ALEN];
263 * go_intent - Local GO Intent to be used during GO Negotiation
268 * next_tie_breaker - Next tie-breaker value to use in GO Negotiation
273 * ssid - Selected SSID for GO Negotiation (if local end will be GO)
278 * ssid_len - ssid length in octets
283 * ssid_set - Whether SSID is already set for GO Negotiation
288 * Regulatory class for own operational channel
293 * op_channel - Own operational channel
298 * channels - Own supported regulatory classes and channels
300 * List of supposerted channels per regulatory class. The regulatory
301 * classes are defined in IEEE Std 802.11-2007 Annex J and the
302 * numbering of the clases depends on the configured country code.
304 struct p2p_channels channels;
306 enum p2p_pending_action_state {
307 P2P_NO_PENDING_ACTION,
308 P2P_PENDING_GO_NEG_REQUEST,
309 P2P_PENDING_GO_NEG_RESPONSE,
310 P2P_PENDING_GO_NEG_RESPONSE_FAILURE,
311 P2P_PENDING_GO_NEG_CONFIRM,
314 P2P_PENDING_INVITATION_REQUEST,
315 P2P_PENDING_INVITATION_RESPONSE,
316 P2P_PENDING_DEV_DISC_REQUEST,
317 P2P_PENDING_DEV_DISC_RESPONSE,
318 P2P_PENDING_GO_DISC_REQ
319 } pending_action_state;
321 unsigned int pending_listen_freq;
322 unsigned int pending_listen_sec;
323 unsigned int pending_listen_usec;
331 * sd_queries - Pending service discovery queries
333 struct p2p_sd_query *sd_queries;
336 * srv_update_indic - Service Update Indicator for local services
338 u16 srv_update_indic;
340 struct wpabuf *sd_resp; /* Fragmented SD response */
341 u8 sd_resp_addr[ETH_ALEN];
342 u8 sd_resp_dialog_token;
343 size_t sd_resp_pos; /* Offset in sd_resp */
346 struct wpabuf *sd_rx_resp; /* Reassembled SD response */
347 u16 sd_rx_update_indic;
349 /* P2P Invitation data */
350 enum p2p_invite_role inv_role;
351 u8 inv_bssid[ETH_ALEN];
356 u8 inv_group_bssid[ETH_ALEN];
357 u8 *inv_group_bssid_ptr;
358 u8 inv_go_dev_addr[ETH_ALEN];
363 enum p2p_discovery_type find_type;
364 unsigned int last_p2p_find_timeout;
365 u8 last_prog_scan_class;
366 u8 last_prog_scan_chan;
367 int p2p_scan_running;
368 enum p2p_after_scan {
369 P2P_AFTER_SCAN_NOTHING,
370 P2P_AFTER_SCAN_LISTEN,
371 P2P_AFTER_SCAN_CONNECT
373 u8 after_scan_peer[ETH_ALEN];
374 struct p2p_pending_action_tx *after_scan_tx;
376 /* Requested device types for find/search */
377 unsigned int num_req_dev_types;
380 u8 find_dev_id_buf[ETH_ALEN];
382 struct p2p_group **groups;
385 struct p2p_device *pending_client_disc_go;
386 u8 pending_client_disc_addr[ETH_ALEN];
387 u8 pending_dev_disc_dialog_token;
388 u8 pending_dev_disc_addr[ETH_ALEN];
389 int pending_dev_disc_freq;
390 unsigned int pending_client_disc_freq;
393 unsigned int ext_listen_period;
394 unsigned int ext_listen_interval;
395 unsigned int ext_listen_interval_sec;
396 unsigned int ext_listen_interval_usec;
398 u8 peer_filter[ETH_ALEN];
404 int best_freq_overall;
407 * wps_vendor_ext - WPS Vendor Extensions to add
409 struct wpabuf *wps_vendor_ext[P2P_MAX_WPS_VENDOR_EXT];
412 * user_initiated_pd - Whether a PD request is user initiated or not.
414 u8 user_initiated_pd;
417 * Keep track of which peer a given PD request was sent to.
418 * Used to raise a timeout alert in case there is no response.
420 u8 pending_pd_devaddr[ETH_ALEN];
423 * Retry counter for provision discovery requests when issued
433 * struct p2p_message - Parsed P2P message (or P2P IE)
436 struct wpabuf *p2p_attributes;
437 struct wpabuf *wps_attributes;
441 const u8 *capability;
444 const u8 *listen_channel;
445 const u8 *operating_channel;
446 const u8 *channel_list;
448 const u8 *config_timeout;
449 const u8 *intended_addr;
450 const u8 *group_bssid;
451 const u8 *invitation_flags;
453 const u8 *group_info;
454 size_t group_info_len;
461 const u8 *manageability;
466 const u8 *ext_listen_timing;
468 const u8 *minor_reason_code;
470 /* P2P Device Info */
471 const u8 *p2p_device_info;
472 size_t p2p_device_info_len;
473 const u8 *p2p_device_addr;
474 const u8 *pri_dev_type;
475 u8 num_sec_dev_types;
476 char device_name[33];
481 u16 wps_config_methods;
482 const u8 *wps_pri_dev_type;
483 const u8 *wps_sec_dev_type_list;
484 size_t wps_sec_dev_type_list_len;
485 const u8 *wps_vendor_ext[P2P_MAX_WPS_VENDOR_EXT];
486 size_t wps_vendor_ext_len[P2P_MAX_WPS_VENDOR_EXT];
487 const u8 *manufacturer;
488 size_t manufacturer_len;
489 const u8 *model_name;
490 size_t model_name_len;
491 const u8 *model_number;
492 size_t model_number_len;
493 const u8 *serial_number;
494 size_t serial_number_len;
496 /* DS Parameter Set IE */
504 #define P2P_MAX_GROUP_ENTRIES 50
506 struct p2p_group_info {
507 unsigned int num_clients;
508 struct p2p_client_info {
509 const u8 *p2p_device_addr;
510 const u8 *p2p_interface_addr;
513 const u8 *pri_dev_type;
514 u8 num_sec_dev_types;
515 const u8 *sec_dev_types;
516 const char *dev_name;
518 } client[P2P_MAX_GROUP_ENTRIES];
523 int p2p_random(char *buf, size_t len);
524 int p2p_channel_to_freq(const char *country, int reg_class, int channel);
525 int p2p_freq_to_channel(const char *country, unsigned int freq, u8 *reg_class,
527 void p2p_channels_intersect(const struct p2p_channels *a,
528 const struct p2p_channels *b,
529 struct p2p_channels *res);
530 int p2p_channels_includes(const struct p2p_channels *channels, u8 reg_class,
534 int p2p_parse_p2p_ie(const struct wpabuf *buf, struct p2p_message *msg);
535 int p2p_parse_ies(const u8 *data, size_t len, struct p2p_message *msg);
536 int p2p_parse(const u8 *data, size_t len, struct p2p_message *msg);
537 void p2p_parse_free(struct p2p_message *msg);
538 int p2p_attr_text(struct wpabuf *data, char *buf, char *end);
539 int p2p_group_info_parse(const u8 *gi, size_t gi_len,
540 struct p2p_group_info *info);
544 struct p2p_noa_desc {
552 const u8 * p2p_group_get_interface_addr(struct p2p_group *group);
553 u8 p2p_group_presence_req(struct p2p_group *group,
554 const u8 *client_interface_addr,
555 const u8 *noa, size_t noa_len);
556 int p2p_group_is_group_id_match(struct p2p_group *group, const u8 *group_id,
557 size_t group_id_len);
560 void p2p_buf_add_action_hdr(struct wpabuf *buf, u8 subtype, u8 dialog_token);
561 void p2p_buf_add_public_action_hdr(struct wpabuf *buf, u8 subtype,
563 u8 * p2p_buf_add_ie_hdr(struct wpabuf *buf);
564 void p2p_buf_add_status(struct wpabuf *buf, u8 status);
565 void p2p_buf_add_device_info(struct wpabuf *buf, struct p2p_data *p2p,
566 struct p2p_device *peer);
567 void p2p_buf_add_device_id(struct wpabuf *buf, const u8 *dev_addr);
568 void p2p_buf_update_ie_hdr(struct wpabuf *buf, u8 *len);
569 void p2p_buf_add_capability(struct wpabuf *buf, u8 dev_capab, u8 group_capab);
570 void p2p_buf_add_go_intent(struct wpabuf *buf, u8 go_intent);
571 void p2p_buf_add_listen_channel(struct wpabuf *buf, const char *country,
572 u8 reg_class, u8 channel);
573 void p2p_buf_add_operating_channel(struct wpabuf *buf, const char *country,
574 u8 reg_class, u8 channel);
575 void p2p_buf_add_channel_list(struct wpabuf *buf, const char *country,
576 struct p2p_channels *chan);
577 void p2p_buf_add_config_timeout(struct wpabuf *buf, u8 go_timeout,
579 void p2p_buf_add_intended_addr(struct wpabuf *buf, const u8 *interface_addr);
580 void p2p_buf_add_group_bssid(struct wpabuf *buf, const u8 *bssid);
581 void p2p_buf_add_group_id(struct wpabuf *buf, const u8 *dev_addr,
582 const u8 *ssid, size_t ssid_len);
583 void p2p_buf_add_invitation_flags(struct wpabuf *buf, u8 flags);
584 void p2p_buf_add_noa(struct wpabuf *buf, u8 noa_index, u8 opp_ps, u8 ctwindow,
585 struct p2p_noa_desc *desc1, struct p2p_noa_desc *desc2);
586 void p2p_buf_add_ext_listen_timing(struct wpabuf *buf, u16 period,
588 void p2p_buf_add_p2p_interface(struct wpabuf *buf, struct p2p_data *p2p);
589 void p2p_build_wps_ie(struct p2p_data *p2p, struct wpabuf *buf, int pw_id,
593 struct p2p_sd_query * p2p_pending_sd_req(struct p2p_data *p2p,
594 struct p2p_device *dev);
595 void p2p_free_sd_queries(struct p2p_data *p2p);
596 void p2p_rx_gas_initial_req(struct p2p_data *p2p, const u8 *sa,
597 const u8 *data, size_t len, int rx_freq);
598 void p2p_rx_gas_initial_resp(struct p2p_data *p2p, const u8 *sa,
599 const u8 *data, size_t len, int rx_freq);
600 void p2p_rx_gas_comeback_req(struct p2p_data *p2p, const u8 *sa,
601 const u8 *data, size_t len, int rx_freq);
602 void p2p_rx_gas_comeback_resp(struct p2p_data *p2p, const u8 *sa,
603 const u8 *data, size_t len, int rx_freq);
604 int p2p_start_sd(struct p2p_data *p2p, struct p2p_device *dev);
607 int p2p_peer_channels_check(struct p2p_data *p2p, struct p2p_channels *own,
608 struct p2p_device *dev,
609 const u8 *channel_list, size_t channel_list_len);
610 void p2p_process_go_neg_req(struct p2p_data *p2p, const u8 *sa,
611 const u8 *data, size_t len, int rx_freq);
612 void p2p_process_go_neg_resp(struct p2p_data *p2p, const u8 *sa,
613 const u8 *data, size_t len, int rx_freq);
614 void p2p_process_go_neg_conf(struct p2p_data *p2p, const u8 *sa,
615 const u8 *data, size_t len);
616 int p2p_connect_send(struct p2p_data *p2p, struct p2p_device *dev);
617 u16 p2p_wps_method_pw_id(enum p2p_wps_method wps_method);
620 void p2p_process_prov_disc_req(struct p2p_data *p2p, const u8 *sa,
621 const u8 *data, size_t len, int rx_freq);
622 void p2p_process_prov_disc_resp(struct p2p_data *p2p, const u8 *sa,
623 const u8 *data, size_t len);
624 int p2p_send_prov_disc_req(struct p2p_data *p2p, struct p2p_device *dev,
625 int join, int force_freq);
626 void p2p_reset_pending_pd(struct p2p_data *p2p);
628 /* p2p_invitation.c */
629 void p2p_process_invitation_req(struct p2p_data *p2p, const u8 *sa,
630 const u8 *data, size_t len, int rx_freq);
631 void p2p_process_invitation_resp(struct p2p_data *p2p, const u8 *sa,
632 const u8 *data, size_t len);
633 int p2p_invite_send(struct p2p_data *p2p, struct p2p_device *dev,
634 const u8 *go_dev_addr);
635 void p2p_invitation_req_cb(struct p2p_data *p2p, int success);
636 void p2p_invitation_resp_cb(struct p2p_data *p2p, int success);
639 void p2p_process_dev_disc_req(struct p2p_data *p2p, const u8 *sa,
640 const u8 *data, size_t len, int rx_freq);
641 void p2p_dev_disc_req_cb(struct p2p_data *p2p, int success);
642 int p2p_send_dev_disc_req(struct p2p_data *p2p, struct p2p_device *dev);
643 void p2p_dev_disc_resp_cb(struct p2p_data *p2p, int success);
644 void p2p_process_dev_disc_resp(struct p2p_data *p2p, const u8 *sa,
645 const u8 *data, size_t len);
646 void p2p_go_disc_req_cb(struct p2p_data *p2p, int success);
647 void p2p_process_go_disc_req(struct p2p_data *p2p, const u8 *da, const u8 *sa,
648 const u8 *data, size_t len, int rx_freq);
651 void p2p_set_state(struct p2p_data *p2p, int new_state);
652 void p2p_set_timeout(struct p2p_data *p2p, unsigned int sec,
654 void p2p_clear_timeout(struct p2p_data *p2p);
655 void p2p_continue_find(struct p2p_data *p2p);
656 struct p2p_device * p2p_add_dev_from_go_neg_req(struct p2p_data *p2p,
658 struct p2p_message *msg);
659 void p2p_add_dev_info(struct p2p_data *p2p, const u8 *addr,
660 struct p2p_device *dev, struct p2p_message *msg);
661 int p2p_add_device(struct p2p_data *p2p, const u8 *addr, int freq, int level,
662 const u8 *ies, size_t ies_len, int scan_res);
663 struct p2p_device * p2p_get_device(struct p2p_data *p2p, const u8 *addr);
664 struct p2p_device * p2p_get_device_interface(struct p2p_data *p2p,
666 void p2p_go_neg_failed(struct p2p_data *p2p, struct p2p_device *peer,
668 void p2p_go_complete(struct p2p_data *p2p, struct p2p_device *peer);
669 int p2p_match_dev_type(struct p2p_data *p2p, struct wpabuf *wps);
670 int dev_type_list_match(const u8 *dev_type, const u8 *req_dev_type[],
671 size_t num_req_dev_type);
672 struct wpabuf * p2p_build_probe_resp_ies(struct p2p_data *p2p);
673 void p2p_build_ssid(struct p2p_data *p2p, u8 *ssid, size_t *ssid_len);
674 int p2p_send_action(struct p2p_data *p2p, unsigned int freq, const u8 *dst,
675 const u8 *src, const u8 *bssid, const u8 *buf,
676 size_t len, unsigned int wait_time);
677 void p2p_stop_listen_for_freq(struct p2p_data *p2p, int freq);