2 * P2P - Internal definitions for P2P module
3 * Copyright (c) 2009-2010, Atheros Communications
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation.
9 * Alternatively, this software may be distributed under the terms of BSD
12 * See README and COPYING for more details.
18 #include "utils/list.h"
21 /* TODO: add removal of expired P2P device entries */
30 * struct p2p_device - P2P Device data (internal to P2P module)
34 struct os_time last_seen;
37 enum p2p_wps_method wps_method;
39 u8 p2p_device_addr[ETH_ALEN]; /* P2P Device Address of the peer */
47 * If the peer was discovered based on an interface address (e.g., GO
48 * from Beacon/Probe Response), the interface address is stored here.
49 * p2p_device_addr must still be set in such a case to the unique
50 * identifier for the P2P Device.
52 u8 interface_addr[ETH_ALEN];
55 * P2P Device Address of the GO in whose group this P2P Device is a
58 u8 member_in_go_dev[ETH_ALEN];
61 * P2P Interface Address of the GO in whose group this P2P Device is a
64 u8 member_in_go_iface[ETH_ALEN];
67 enum p2p_go_state go_state;
69 u8 intended_addr[ETH_ALEN];
72 struct p2p_channels channels;
78 * req_config_methods - Pending provisioning discovery methods
80 u16 req_config_methods;
82 #define P2P_DEV_PROBE_REQ_ONLY BIT(0)
83 #define P2P_DEV_REPORTED BIT(1)
84 #define P2P_DEV_NOT_YET_READY BIT(2)
85 #define P2P_DEV_SD_INFO BIT(3)
86 #define P2P_DEV_SD_SCHEDULE BIT(4)
87 #define P2P_DEV_PD_PEER_DISPLAY BIT(5)
88 #define P2P_DEV_PD_PEER_KEYPAD BIT(6)
89 #define P2P_DEV_USER_REJECTED BIT(7)
90 #define P2P_DEV_PEER_WAITING_RESPONSE BIT(8)
91 #define P2P_DEV_PREFER_PERSISTENT_GROUP BIT(9)
92 #define P2P_DEV_WAIT_GO_NEG_RESPONSE BIT(10)
93 #define P2P_DEV_WAIT_GO_NEG_CONFIRM BIT(11)
94 #define P2P_DEV_GROUP_CLIENT_ONLY BIT(12)
95 #define P2P_DEV_FORCE_FREQ BIT(13)
96 #define P2P_DEV_PD_FOR_JOIN BIT(14)
99 int status; /* enum p2p_status_code */
100 unsigned int wait_count;
101 unsigned int invitation_reqs;
103 u16 ext_listen_period;
104 u16 ext_listen_interval;
110 struct p2p_sd_query {
111 struct p2p_sd_query *next;
117 struct p2p_pending_action_tx {
123 unsigned int wait_time;
124 /* Followed by len octets of the frame */
128 * struct p2p_data - P2P module data (internal to P2P module)
132 * cfg - P2P module configuration
134 * This is included in the same memory allocation with the
135 * struct p2p_data and as such, must not be freed separately.
137 struct p2p_config *cfg;
140 * state - The current P2P state
149 * P2P_SEARCH - Search (Device Discovery)
154 * P2P_CONNECT - Trying to start GO Negotiation
159 * P2P_CONNECT_LISTEN - Listen during GO Negotiation start
164 * P2P_GO_NEG - In GO Negotiation
169 * P2P_LISTEN_ONLY - Listen only
174 * P2P_WAIT_PEER_CONNECT - Waiting peer in List for GO Neg
176 P2P_WAIT_PEER_CONNECT,
179 * P2P_WAIT_PEER_IDLE - Waiting peer idle for GO Neg
184 * P2P_SD_DURING_FIND - Service Discovery during find
189 * P2P_PROVISIONING - Provisioning (during group formation)
194 * P2P_PD_DURING_FIND - Provision Discovery during find
199 * P2P_INVITE - Trying to start Invite
204 * P2P_INVITE_LISTEN - Listen during Invite
210 * min_disc_int - minDiscoverableInterval
215 * max_disc_int - maxDiscoverableInterval
220 * devices - List of known P2P Device peers
222 struct dl_list devices;
225 * go_neg_peer - Pointer to GO Negotiation peer
227 struct p2p_device *go_neg_peer;
230 * invite_peer - Pointer to Invite peer
232 struct p2p_device *invite_peer;
234 const u8 *invite_go_dev_addr;
235 u8 invite_go_dev_addr_buf[ETH_ALEN];
238 * sd_peer - Pointer to Service Discovery peer
240 struct p2p_device *sd_peer;
243 * sd_query - Pointer to Service Discovery query
245 struct p2p_sd_query *sd_query;
247 /* GO Negotiation data */
250 * intended_addr - Local Intended P2P Interface Address
252 * This address is used during group owner negotiation as the Intended
253 * P2P Interface Address and the group interface will be created with
254 * address as the local address in case of successfully completed
257 u8 intended_addr[ETH_ALEN];
260 * go_intent - Local GO Intent to be used during GO Negotiation
265 * next_tie_breaker - Next tie-breaker value to use in GO Negotiation
270 * ssid - Selected SSID for GO Negotiation (if local end will be GO)
275 * ssid_len - ssid length in octets
280 * Regulatory class for own operational channel
285 * op_channel - Own operational channel
290 * channels - Own supported regulatory classes and channels
292 * List of supposerted channels per regulatory class. The regulatory
293 * classes are defined in IEEE Std 802.11-2007 Annex J and the
294 * numbering of the clases depends on the configured country code.
296 struct p2p_channels channels;
298 enum p2p_pending_action_state {
299 P2P_NO_PENDING_ACTION,
300 P2P_PENDING_GO_NEG_REQUEST,
301 P2P_PENDING_GO_NEG_RESPONSE,
302 P2P_PENDING_GO_NEG_RESPONSE_FAILURE,
303 P2P_PENDING_GO_NEG_CONFIRM,
306 P2P_PENDING_INVITATION_REQUEST,
307 P2P_PENDING_INVITATION_RESPONSE,
308 P2P_PENDING_DEV_DISC_REQUEST,
309 P2P_PENDING_DEV_DISC_RESPONSE,
310 P2P_PENDING_GO_DISC_REQ
311 } pending_action_state;
313 unsigned int pending_listen_freq;
314 unsigned int pending_listen_sec;
315 unsigned int pending_listen_usec;
323 * sd_queries - Pending service discovery queries
325 struct p2p_sd_query *sd_queries;
328 * srv_update_indic - Service Update Indicator for local services
330 u16 srv_update_indic;
332 struct wpabuf *sd_resp; /* Fragmented SD response */
333 u8 sd_resp_addr[ETH_ALEN];
334 u8 sd_resp_dialog_token;
335 size_t sd_resp_pos; /* Offset in sd_resp */
338 struct wpabuf *sd_rx_resp; /* Reassembled SD response */
339 u16 sd_rx_update_indic;
341 /* P2P Invitation data */
342 enum p2p_invite_role inv_role;
343 u8 inv_bssid[ETH_ALEN];
348 u8 inv_group_bssid[ETH_ALEN];
349 u8 *inv_group_bssid_ptr;
350 u8 inv_go_dev_addr[ETH_ALEN];
355 enum p2p_discovery_type find_type;
356 u8 last_prog_scan_class;
357 u8 last_prog_scan_chan;
358 int p2p_scan_running;
359 enum p2p_after_scan {
360 P2P_AFTER_SCAN_NOTHING,
361 P2P_AFTER_SCAN_LISTEN,
362 P2P_AFTER_SCAN_CONNECT
364 u8 after_scan_peer[ETH_ALEN];
365 struct p2p_pending_action_tx *after_scan_tx;
367 struct p2p_group **groups;
370 struct p2p_device *pending_client_disc_go;
371 u8 pending_client_disc_addr[ETH_ALEN];
372 u8 pending_dev_disc_dialog_token;
373 u8 pending_dev_disc_addr[ETH_ALEN];
374 int pending_dev_disc_freq;
375 unsigned int pending_client_disc_freq;
378 unsigned int ext_listen_period;
379 unsigned int ext_listen_interval;
380 unsigned int ext_listen_interval_sec;
381 unsigned int ext_listen_interval_usec;
383 u8 peer_filter[ETH_ALEN];
389 * struct p2p_message - Parsed P2P message (or P2P IE)
392 struct wpabuf *p2p_attributes;
393 struct wpabuf *wps_attributes;
397 const u8 *capability;
400 const u8 *listen_channel;
401 const u8 *operating_channel;
402 const u8 *channel_list;
404 const u8 *config_timeout;
405 const u8 *intended_addr;
406 const u8 *group_bssid;
407 const u8 *invitation_flags;
409 const u8 *group_info;
410 size_t group_info_len;
417 const u8 *manageability;
422 const u8 *ext_listen_timing;
424 const u8 *minor_reason_code;
426 /* P2P Device Info */
427 const u8 *p2p_device_info;
428 size_t p2p_device_info_len;
429 const u8 *p2p_device_addr;
430 const u8 *pri_dev_type;
431 u8 num_sec_dev_types;
432 char device_name[33];
437 u16 wps_config_methods;
438 const u8 *wps_pri_dev_type;
440 /* DS Parameter Set IE */
448 #define P2P_MAX_GROUP_ENTRIES 50
450 struct p2p_group_info {
451 unsigned int num_clients;
452 struct p2p_client_info {
453 const u8 *p2p_device_addr;
454 const u8 *p2p_interface_addr;
457 const u8 *pri_dev_type;
458 u8 num_sec_dev_types;
459 const u8 *sec_dev_types;
460 const char *dev_name;
462 } client[P2P_MAX_GROUP_ENTRIES];
467 int p2p_random(char *buf, size_t len);
468 int p2p_channel_to_freq(const char *country, int reg_class, int channel);
469 int p2p_freq_to_channel(const char *country, unsigned int freq, u8 *reg_class,
471 void p2p_channels_intersect(const struct p2p_channels *a,
472 const struct p2p_channels *b,
473 struct p2p_channels *res);
474 int p2p_channels_includes(const struct p2p_channels *channels, u8 reg_class,
478 int p2p_parse_p2p_ie(const struct wpabuf *buf, struct p2p_message *msg);
479 int p2p_parse_ies(const u8 *data, size_t len, struct p2p_message *msg);
480 int p2p_parse(const u8 *data, size_t len, struct p2p_message *msg);
481 void p2p_parse_free(struct p2p_message *msg);
482 int p2p_attr_text(struct wpabuf *data, char *buf, char *end);
483 int p2p_group_info_parse(const u8 *gi, size_t gi_len,
484 struct p2p_group_info *info);
488 struct p2p_noa_desc {
496 const u8 * p2p_group_get_interface_addr(struct p2p_group *group);
497 u8 p2p_group_presence_req(struct p2p_group *group,
498 const u8 *client_interface_addr,
499 const u8 *noa, size_t noa_len);
502 void p2p_buf_add_action_hdr(struct wpabuf *buf, u8 subtype, u8 dialog_token);
503 void p2p_buf_add_public_action_hdr(struct wpabuf *buf, u8 subtype,
505 u8 * p2p_buf_add_ie_hdr(struct wpabuf *buf);
506 void p2p_buf_add_status(struct wpabuf *buf, u8 status);
507 void p2p_buf_add_device_info(struct wpabuf *buf, struct p2p_data *p2p,
508 struct p2p_device *peer);
509 void p2p_buf_add_device_id(struct wpabuf *buf, const u8 *dev_addr);
510 void p2p_buf_update_ie_hdr(struct wpabuf *buf, u8 *len);
511 void p2p_buf_add_capability(struct wpabuf *buf, u8 dev_capab, u8 group_capab);
512 void p2p_buf_add_go_intent(struct wpabuf *buf, u8 go_intent);
513 void p2p_buf_add_listen_channel(struct wpabuf *buf, const char *country,
514 u8 reg_class, u8 channel);
515 void p2p_buf_add_operating_channel(struct wpabuf *buf, const char *country,
516 u8 reg_class, u8 channel);
517 void p2p_buf_add_channel_list(struct wpabuf *buf, const char *country,
518 struct p2p_channels *chan);
519 void p2p_buf_add_config_timeout(struct wpabuf *buf, u8 go_timeout,
521 void p2p_buf_add_intended_addr(struct wpabuf *buf, const u8 *interface_addr);
522 void p2p_buf_add_group_bssid(struct wpabuf *buf, const u8 *bssid);
523 void p2p_buf_add_group_id(struct wpabuf *buf, const u8 *dev_addr,
524 const u8 *ssid, size_t ssid_len);
525 void p2p_buf_add_invitation_flags(struct wpabuf *buf, u8 flags);
526 void p2p_buf_add_noa(struct wpabuf *buf, u8 noa_index, u8 opp_ps, u8 ctwindow,
527 struct p2p_noa_desc *desc1, struct p2p_noa_desc *desc2);
528 void p2p_buf_add_ext_listen_timing(struct wpabuf *buf, u16 period,
530 void p2p_buf_add_p2p_interface(struct wpabuf *buf, struct p2p_data *p2p);
531 void p2p_build_wps_ie(struct p2p_data *p2p, struct wpabuf *buf, u16 pw_id,
535 struct p2p_sd_query * p2p_pending_sd_req(struct p2p_data *p2p,
536 struct p2p_device *dev);
537 void p2p_free_sd_queries(struct p2p_data *p2p);
538 void p2p_rx_gas_initial_req(struct p2p_data *p2p, const u8 *sa,
539 const u8 *data, size_t len, int rx_freq);
540 void p2p_rx_gas_initial_resp(struct p2p_data *p2p, const u8 *sa,
541 const u8 *data, size_t len, int rx_freq);
542 void p2p_rx_gas_comeback_req(struct p2p_data *p2p, const u8 *sa,
543 const u8 *data, size_t len, int rx_freq);
544 void p2p_rx_gas_comeback_resp(struct p2p_data *p2p, const u8 *sa,
545 const u8 *data, size_t len, int rx_freq);
546 int p2p_start_sd(struct p2p_data *p2p, struct p2p_device *dev);
549 int p2p_peer_channels_check(struct p2p_data *p2p, struct p2p_channels *own,
550 struct p2p_device *dev,
551 const u8 *channel_list, size_t channel_list_len);
552 void p2p_process_go_neg_req(struct p2p_data *p2p, const u8 *sa,
553 const u8 *data, size_t len, int rx_freq);
554 void p2p_process_go_neg_resp(struct p2p_data *p2p, const u8 *sa,
555 const u8 *data, size_t len, int rx_freq);
556 void p2p_process_go_neg_conf(struct p2p_data *p2p, const u8 *sa,
557 const u8 *data, size_t len);
558 int p2p_connect_send(struct p2p_data *p2p, struct p2p_device *dev);
561 void p2p_process_prov_disc_req(struct p2p_data *p2p, const u8 *sa,
562 const u8 *data, size_t len, int rx_freq);
563 void p2p_process_prov_disc_resp(struct p2p_data *p2p, const u8 *sa,
564 const u8 *data, size_t len);
565 int p2p_send_prov_disc_req(struct p2p_data *p2p, struct p2p_device *dev,
568 /* p2p_invitation.c */
569 void p2p_process_invitation_req(struct p2p_data *p2p, const u8 *sa,
570 const u8 *data, size_t len, int rx_freq);
571 void p2p_process_invitation_resp(struct p2p_data *p2p, const u8 *sa,
572 const u8 *data, size_t len);
573 int p2p_invite_send(struct p2p_data *p2p, struct p2p_device *dev,
574 const u8 *go_dev_addr);
575 void p2p_invitation_req_cb(struct p2p_data *p2p, int success);
576 void p2p_invitation_resp_cb(struct p2p_data *p2p, int success);
579 void p2p_process_dev_disc_req(struct p2p_data *p2p, const u8 *sa,
580 const u8 *data, size_t len, int rx_freq);
581 void p2p_dev_disc_req_cb(struct p2p_data *p2p, int success);
582 int p2p_send_dev_disc_req(struct p2p_data *p2p, struct p2p_device *dev);
583 void p2p_dev_disc_resp_cb(struct p2p_data *p2p, int success);
584 void p2p_process_dev_disc_resp(struct p2p_data *p2p, const u8 *sa,
585 const u8 *data, size_t len);
586 void p2p_go_disc_req_cb(struct p2p_data *p2p, int success);
587 void p2p_process_go_disc_req(struct p2p_data *p2p, const u8 *da, const u8 *sa,
588 const u8 *data, size_t len, int rx_freq);
591 void p2p_set_state(struct p2p_data *p2p, int new_state);
592 void p2p_set_timeout(struct p2p_data *p2p, unsigned int sec,
594 void p2p_clear_timeout(struct p2p_data *p2p);
595 void p2p_continue_find(struct p2p_data *p2p);
596 struct p2p_device * p2p_add_dev_from_go_neg_req(struct p2p_data *p2p,
598 struct p2p_message *msg);
599 void p2p_add_dev_info(struct p2p_data *p2p, const u8 *addr,
600 struct p2p_device *dev, struct p2p_message *msg);
601 struct p2p_device * p2p_get_device(struct p2p_data *p2p, const u8 *addr);
602 struct p2p_device * p2p_get_device_interface(struct p2p_data *p2p,
604 void p2p_go_neg_failed(struct p2p_data *p2p, struct p2p_device *peer,
606 void p2p_go_complete(struct p2p_data *p2p, struct p2p_device *peer);
607 int p2p_match_dev_type(struct p2p_data *p2p, struct wpabuf *wps);
608 int dev_type_list_match(const u8 *dev_type, const u8 *req_dev_type[],
609 size_t num_req_dev_type);
610 struct wpabuf * p2p_build_probe_resp_ies(struct p2p_data *p2p);
611 void p2p_build_ssid(struct p2p_data *p2p, u8 *ssid, size_t *ssid_len);
612 int p2p_send_action(struct p2p_data *p2p, unsigned int freq, const u8 *dst,
613 const u8 *src, const u8 *bssid, const u8 *buf,
614 size_t len, unsigned int wait_time);