p2p.h

Go to the documentation of this file.

#ifndef P2P_H
#define P2P_H

#define P2P_MAX_REG_CLASSES 10

#define P2P_MAX_REG_CLASS_CHANNELS 20

struct p2p_channels {
        struct p2p_reg_class {
                u8 reg_class;

                u8 channel[P2P_MAX_REG_CLASS_CHANNELS];

                size_t channels;
        } reg_class[P2P_MAX_REG_CLASSES];

        size_t reg_classes;
};

enum p2p_wps_method {
        WPS_NOT_READY, WPS_PIN_DISPLAY, WPS_PIN_KEYPAD, WPS_PBC
};

struct p2p_go_neg_results {
        int status;

        int role_go;

        int freq;

        u8 ssid[32];

        size_t ssid_len;

        char passphrase[64];

        u8 peer_device_addr[ETH_ALEN];

        u8 peer_interface_addr[ETH_ALEN];

        enum p2p_wps_method wps_method;

#define P2P_MAX_CHANNELS 50

        int freq_list[P2P_MAX_CHANNELS];

        int persistent_group;

        unsigned int peer_config_timeout;
};

struct p2p_data;

enum p2p_scan_type {
        P2P_SCAN_SOCIAL,
        P2P_SCAN_FULL,
        P2P_SCAN_SPECIFIC,
        P2P_SCAN_SOCIAL_PLUS_ONE
};

#define P2P_MAX_WPS_VENDOR_EXT 10

struct p2p_peer_info {
        u8 p2p_device_addr[ETH_ALEN];

        u8 pri_dev_type[8];

        char device_name[33];

        char manufacturer[65];

        char model_name[33];

        char model_number[33];

        char serial_number[33];

        int level;

        u16 config_methods;

        u8 dev_capab;

        u8 group_capab;

        u8 wps_sec_dev_type_list[128];

        size_t wps_sec_dev_type_list_len;

        struct wpabuf *wps_vendor_ext[P2P_MAX_WPS_VENDOR_EXT];
};

enum p2p_prov_disc_status {
        P2P_PROV_DISC_SUCCESS,
        P2P_PROV_DISC_TIMEOUT,
        P2P_PROV_DISC_REJECTED,
};

struct p2p_channel {
        u8 op_class;
        u8 chan;
};

struct p2p_config {
        char country[3];

        u8 reg_class;

        u8 channel;

        u8 op_reg_class;

        u8 op_channel;

        u8 cfg_op_channel;

        struct p2p_channels channels;

        unsigned int num_pref_chan;

        struct p2p_channel *pref_chan;

        u8 pri_dev_type[8];

#define P2P_SEC_DEVICE_TYPES 5

        u8 sec_dev_type[P2P_SEC_DEVICE_TYPES][8];

        size_t num_sec_dev_types;

        u8 dev_addr[ETH_ALEN];

        char *dev_name;

        char *manufacturer;
        char *model_name;
        char *model_number;
        char *serial_number;

        u8 uuid[16];
        u16 config_methods;

        int concurrent_operations;

        size_t max_peers;

        int p2p_intra_bss;

        u8 ssid_postfix[32 - 9];

        size_t ssid_postfix_len;

        void *msg_ctx;

        void *cb_ctx;


        /* Callbacks to request lower layer driver operations */

        int (*p2p_scan)(void *ctx, enum p2p_scan_type type, int freq,
                        unsigned int num_req_dev_types,
                        const u8 *req_dev_types, const u8 *dev_id, u16 pw_id);

        int (*send_probe_resp)(void *ctx, const struct wpabuf *buf);

        int (*send_action)(void *ctx, unsigned int freq, const u8 *dst,
                           const u8 *src, const u8 *bssid, const u8 *buf,
                           size_t len, unsigned int wait_time);

        void (*send_action_done)(void *ctx);

        int (*start_listen)(void *ctx, unsigned int freq,
                            unsigned int duration,
                            const struct wpabuf *probe_resp_ie);
        void (*stop_listen)(void *ctx);

        int (*get_noa)(void *ctx, const u8 *interface_addr, u8 *buf,
                       size_t buf_len);

        /* Callbacks to notify events to upper layer management entity */

        void (*dev_found)(void *ctx, const u8 *addr,
                          const struct p2p_peer_info *info,
                          int new_device);

        void (*dev_lost)(void *ctx, const u8 *dev_addr);

        void (*go_neg_req_rx)(void *ctx, const u8 *src, u16 dev_passwd_id);

        void (*go_neg_completed)(void *ctx, struct p2p_go_neg_results *res);

        void (*sd_request)(void *ctx, int freq, const u8 *sa, u8 dialog_token,
                           u16 update_indic, const u8 *tlvs, size_t tlvs_len);

        void (*sd_response)(void *ctx, const u8 *sa, u16 update_indic,
                            const u8 *tlvs, size_t tlvs_len);

        void (*prov_disc_req)(void *ctx, const u8 *peer, u16 config_methods,
                              const u8 *dev_addr, const u8 *pri_dev_type,
                              const char *dev_name, u16 supp_config_methods,
                              u8 dev_capab, u8 group_capab,
                              const u8 *group_id, size_t group_id_len);

        void (*prov_disc_resp)(void *ctx, const u8 *peer, u16 config_methods);

        void (*prov_disc_fail)(void *ctx, const u8 *peer,
                               enum p2p_prov_disc_status status);

        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);

        void (*invitation_received)(void *ctx, const u8 *sa, const u8 *bssid,
                                    const u8 *ssid, size_t ssid_len,
                                    const u8 *go_dev_addr, u8 status,
                                    int op_freq);

        void (*invitation_result)(void *ctx, int status, const u8 *bssid);

        int (*go_connected)(void *ctx, const u8 *dev_addr);
};


/* P2P module initialization/deinitialization */

struct p2p_data * p2p_init(const struct p2p_config *cfg);

void p2p_deinit(struct p2p_data *p2p);

void p2p_flush(struct p2p_data *p2p);

int p2p_unauthorize(struct p2p_data *p2p, const u8 *addr);

int p2p_set_dev_name(struct p2p_data *p2p, const char *dev_name);

int p2p_set_manufacturer(struct p2p_data *p2p, const char *manufacturer);
int p2p_set_model_name(struct p2p_data *p2p, const char *model_name);
int p2p_set_model_number(struct p2p_data *p2p, const char *model_number);
int p2p_set_serial_number(struct p2p_data *p2p, const char *serial_number);

void p2p_set_config_methods(struct p2p_data *p2p, u16 config_methods);
void p2p_set_uuid(struct p2p_data *p2p, const u8 *uuid);

int p2p_set_pri_dev_type(struct p2p_data *p2p, const u8 *pri_dev_type);

int p2p_set_sec_dev_types(struct p2p_data *p2p, const u8 dev_types[][8],
                          size_t num_dev_types);

int p2p_set_country(struct p2p_data *p2p, const char *country);


/* Commands from upper layer management entity */

enum p2p_discovery_type {
        P2P_FIND_START_WITH_FULL,
        P2P_FIND_ONLY_SOCIAL,
        P2P_FIND_PROGRESSIVE
};

int p2p_find(struct p2p_data *p2p, unsigned int timeout,
             enum p2p_discovery_type type,
             unsigned int num_req_dev_types, const u8 *req_dev_types,
             const u8 *dev_id);

void p2p_stop_find(struct p2p_data *p2p);

void p2p_stop_find_for_freq(struct p2p_data *p2p, int freq);

int p2p_listen(struct p2p_data *p2p, unsigned int timeout);

int p2p_connect(struct p2p_data *p2p, const u8 *peer_addr,
                enum p2p_wps_method wps_method,
                int go_intent, const u8 *own_interface_addr,
                unsigned int force_freq, int persistent_group);

int p2p_authorize(struct p2p_data *p2p, const u8 *peer_addr,
                  enum p2p_wps_method wps_method,
                  int go_intent, const u8 *own_interface_addr,
                  unsigned int force_freq, int persistent_group);

int p2p_reject(struct p2p_data *p2p, const u8 *peer_addr);

int p2p_prov_disc_req(struct p2p_data *p2p, const u8 *peer_addr,
                      u16 config_methods, int join, int force_freq);

void * p2p_sd_request(struct p2p_data *p2p, const u8 *dst,
                      const struct wpabuf *tlvs);

int p2p_sd_cancel_request(struct p2p_data *p2p, void *req);

void p2p_sd_response(struct p2p_data *p2p, int freq, const u8 *dst,
                     u8 dialog_token, const struct wpabuf *resp_tlvs);

void p2p_sd_service_update(struct p2p_data *p2p);


enum p2p_invite_role {
        P2P_INVITE_ROLE_GO,
        P2P_INVITE_ROLE_ACTIVE_GO,
        P2P_INVITE_ROLE_CLIENT
};

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 p2p_presence_req(struct p2p_data *p2p, const u8 *go_interface_addr,
                     const u8 *own_interface_addr, unsigned int freq,
                     u32 duration1, u32 interval1, u32 duration2,
                     u32 interval2);

int p2p_ext_listen(struct p2p_data *p2p, unsigned int period,
                   unsigned int interval);

/* Event notifications from upper layer management operations */

void p2p_wps_success_cb(struct p2p_data *p2p, const u8 *mac_addr);

void p2p_group_formation_failed(struct p2p_data *p2p);

u16 p2p_get_provisioning_info(struct p2p_data *p2p, const u8 *addr);

void p2p_clear_provisioning_info(struct p2p_data *p2p, const u8 *addr);


/* Event notifications from lower layer driver operations */

enum p2p_probe_req_status {
        P2P_PREQ_MALFORMED,
        P2P_PREQ_NOT_LISTEN,
        P2P_PREQ_NOT_P2P,
        P2P_PREQ_NOT_PROCESSED,
        P2P_PREQ_PROCESSED
};

enum p2p_probe_req_status
p2p_probe_req_rx(struct p2p_data *p2p, const u8 *addr, const u8 *dst,
                 const u8 *bssid, const u8 *ie, size_t ie_len);

void p2p_rx_action(struct p2p_data *p2p, const u8 *da, const u8 *sa,
                   const u8 *bssid, u8 category,
                   const u8 *data, size_t len, int freq);

int p2p_scan_res_handler(struct p2p_data *p2p, const u8 *bssid, int freq,
                         int level, const u8 *ies, size_t ies_len);

void p2p_scan_res_handled(struct p2p_data *p2p);

enum p2p_send_action_result {
        P2P_SEND_ACTION_SUCCESS /* Frame was send and acknowledged */,
        P2P_SEND_ACTION_NO_ACK /* Frame was sent, but not acknowledged */,
        P2P_SEND_ACTION_FAILED /* Frame was not sent due to a failure */
};

void p2p_send_action_cb(struct p2p_data *p2p, unsigned int freq, const u8 *dst,
                        const u8 *src, const u8 *bssid,
                        enum p2p_send_action_result result);

void p2p_listen_cb(struct p2p_data *p2p, unsigned int freq,
                   unsigned int duration);

int p2p_listen_end(struct p2p_data *p2p, unsigned int freq);

void p2p_deauth_notif(struct p2p_data *p2p, const u8 *bssid, u16 reason_code,
                      const u8 *ie, size_t ie_len);

void p2p_disassoc_notif(struct p2p_data *p2p, const u8 *bssid, u16 reason_code,
                        const u8 *ie, size_t ie_len);


/* Per-group P2P state for GO */

struct p2p_group;

struct p2p_group_config {
        int persistent_group;

        u8 interface_addr[ETH_ALEN];

        unsigned int max_clients;

        void *cb_ctx;

        void (*ie_update)(void *ctx, struct wpabuf *beacon_ies,
                          struct wpabuf *proberesp_ies);

        void (*idle_update)(void *ctx, int idle);
};

struct p2p_group * p2p_group_init(struct p2p_data *p2p,
                                  struct p2p_group_config *config);

void p2p_group_deinit(struct p2p_group *group);

int p2p_group_notif_assoc(struct p2p_group *group, const u8 *addr,
                          const u8 *ie, size_t len);

struct wpabuf * p2p_group_assoc_resp_ie(struct p2p_group *group, u8 status);

void p2p_group_notif_disassoc(struct p2p_group *group, const u8 *addr);

void p2p_group_notif_formation_done(struct p2p_group *group);

int p2p_group_notif_noa(struct p2p_group *group, const u8 *noa,
                        size_t noa_len);

int p2p_group_match_dev_type(struct p2p_group *group, struct wpabuf *wps);

int p2p_group_match_dev_id(struct p2p_group *group, struct wpabuf *p2p);

int p2p_group_go_discover(struct p2p_group *group, const u8 *dev_id,
                          const u8 *searching_dev, int rx_freq);


/* Generic helper functions */

int p2p_ie_text(struct wpabuf *p2p_ie, char *buf, char *end);

int p2p_scan_result_text(const u8 *ies, size_t ies_len, char *buf, char *end);

int p2p_parse_dev_addr(const u8 *ies, size_t ies_len, u8 *dev_addr);

int p2p_assoc_req_ie(struct p2p_data *p2p, const u8 *bssid, u8 *buf,
                     size_t len, int p2p_group, struct wpabuf *p2p_ie);

void p2p_scan_ie(struct p2p_data *p2p, struct wpabuf *ies, const u8 *dev_id);

size_t p2p_scan_ie_buf_len(struct p2p_data *p2p);

int p2p_go_params(struct p2p_data *p2p, struct p2p_go_neg_results *params);

u8 p2p_get_group_capab(const struct wpabuf *p2p_ie);

int p2p_get_cross_connect_disallowed(const struct wpabuf *p2p_ie);

const u8 * p2p_get_go_dev_addr(const struct wpabuf *p2p_ie);

const struct p2p_peer_info * p2p_get_peer_info(struct p2p_data *p2p,
                                               const u8 *addr, int next);

int p2p_get_peer_info_txt(const struct p2p_peer_info *info,
                          char *buf, size_t buflen);

int p2p_peer_known(struct p2p_data *p2p, const u8 *addr);

void p2p_set_client_discoverability(struct p2p_data *p2p, int enabled);

void p2p_set_managed_oper(struct p2p_data *p2p, int enabled);

int p2p_set_listen_channel(struct p2p_data *p2p, u8 reg_class, u8 channel);

int p2p_set_ssid_postfix(struct p2p_data *p2p, const u8 *postfix, size_t len);

int p2p_get_interface_addr(struct p2p_data *p2p, const u8 *dev_addr,
                           u8 *iface_addr);
int p2p_get_dev_addr(struct p2p_data *p2p, const u8 *iface_addr,
                           u8 *dev_addr);

void p2p_set_peer_filter(struct p2p_data *p2p, const u8 *addr);

void p2p_set_cross_connect(struct p2p_data *p2p, int enabled);

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_supported_freq(struct p2p_data *p2p, unsigned int freq);

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);

const u8 * p2p_get_go_neg_peer(struct p2p_data *p2p);

unsigned int p2p_get_group_num_members(struct p2p_group *group);

const u8 * p2p_iterate_group_members(struct p2p_group *group, void **next);

const u8 * p2p_group_get_dev_addr(struct p2p_group *group, const u8 *addr);

int p2p_group_is_client_connected(struct p2p_group *group, const u8 *dev_addr);

const struct p2p_peer_info *
p2p_get_peer_found(struct p2p_data *p2p, const u8 *addr, int next);

void p2p_remove_wps_vendor_extensions(struct p2p_data *p2p);

int p2p_add_wps_vendor_extension(struct p2p_data *p2p,
                                 const struct wpabuf *vendor_ext);

int p2p_set_oper_channel(struct p2p_data *p2p, u8 op_reg_class, u8 op_channel,
                         int cfg_op_channel);

int p2p_set_pref_chan(struct p2p_data *p2p, unsigned int num_pref_chan,
                      const struct p2p_channel *pref_chan);

int p2p_in_progress(struct p2p_data *p2p);

int p2p_other_scan_completed(struct p2p_data *p2p);

const char * p2p_wps_method_text(enum p2p_wps_method method);

#endif /* P2P_H */