drivers/net/wireless/brcm80211/brcmfmac/fweh.c

   1 /*
   2  * Copyright (c) 2012 Broadcom Corporation
   3  *
   4  * Permission to use, copy, modify, and/or distribute this software for any
   5  * purpose with or without fee is hereby granted, provided that the above
   6  * copyright notice and this permission notice appear in all copies.
   7  *
   8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  11  * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  13  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  14  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15  */
  16 #include <linux/netdevice.h>
  17
  18 #include "brcmu_wifi.h"
  19 #include "brcmu_utils.h"
  20
  21 #include "dhd.h"
  22 #include "dhd_dbg.h"
  23 #include "fweh.h"
  24 #include "fwil.h"
  25
  26 /**
  27  * struct brcm_ethhdr - broadcom specific ether header.
  28  *
  29  * @subtype: subtype for this packet.
  30  * @length: TODO: length of appended data.
  31  * @version: version indication.
  32  * @oui: OUI of this packet.
  33  * @usr_subtype: subtype for this OUI.
  34  */
  35 struct brcm_ethhdr {
  36         __be16 subtype;
  37         __be16 length;
  38         u8 version;
  39         u8 oui[3];
  40         __be16 usr_subtype;
  41 } __packed;
  42
  43 struct brcmf_event_msg_be {
  44         __be16 version;
  45         __be16 flags;
  46         __be32 event_type;
  47         __be32 status;
  48         __be32 reason;
  49         __be32 auth_type;
  50         __be32 datalen;
  51         u8 addr[ETH_ALEN];
  52         char ifname[IFNAMSIZ];
  53         u8 ifidx;
  54         u8 bsscfgidx;
  55 } __packed;
  56
  57 /**
  58  * struct brcmf_event - contents of broadcom event packet.
  59  *
  60  * @eth: standard ether header.
  61  * @hdr: broadcom specific ether header.
  62  * @msg: common part of the actual event message.
  63  */
  64 struct brcmf_event {
  65         struct ethhdr eth;
  66         struct brcm_ethhdr hdr;
  67         struct brcmf_event_msg_be msg;
  68 } __packed;
  69
  70 /**
  71  * struct brcmf_fweh_queue_item - event item on event queue.
  72  *
  73  * @q: list element for queuing.
  74  * @code: event code.
  75  * @ifidx: interface index related to this event.
  76  * @ifaddr: ethernet address for interface.
  77  * @emsg: common parameters of the firmware event message.
  78  * @data: event specific data part of the firmware event.
  79  */
  80 struct brcmf_fweh_queue_item {
  81         struct list_head q;
  82         enum brcmf_fweh_event_code code;
  83         u8 ifidx;
  84         u8 ifaddr[ETH_ALEN];
  85         struct brcmf_event_msg_be emsg;
  86         u8 data[0];
  87 };
  88
  89 /**
  90  * struct brcmf_fweh_event_name - code, name mapping entry.
  91  */
  92 struct brcmf_fweh_event_name {
  93         enum brcmf_fweh_event_code code;
  94         const char *name;
  95 };
  96
  97 #ifdef DEBUG
  98 #define BRCMF_ENUM_DEF(id, val) \
  99         { val, #id },
 100
 101 /* array for mapping code to event name */
 102 static struct brcmf_fweh_event_name fweh_event_names[] = {
 103         BRCMF_FWEH_EVENT_ENUM_DEFLIST
 104 };
 105 #undef BRCMF_ENUM_DEF
 106
 107 /**
 108  * brcmf_fweh_event_name() - returns name for given event code.
 109  *
 110  * @code: code to lookup.
 111  */
 112 static const char *brcmf_fweh_event_name(enum brcmf_fweh_event_code code)
 113 {
 114         int i;
 115         for (i = 0; i < ARRAY_SIZE(fweh_event_names); i++) {
 116                 if (fweh_event_names[i].code == code)
 117                         return fweh_event_names[i].name;
 118         }
 119         return "unknown";
 120 }
 121 #else
 122 static const char *brcmf_fweh_event_name(enum brcmf_fweh_event_code code)
 123 {
 124         return "nodebug";
 125 }
 126 #endif
 127
 128 /**
 129  * brcmf_fweh_queue_event() - create and queue event.
 130  *
 131  * @fweh: firmware event handling info.
 132  * @event: event queue entry.
 133  */
 134 static void brcmf_fweh_queue_event(struct brcmf_fweh_info *fweh,
 135                                    struct brcmf_fweh_queue_item *event)
 136 {
 137         ulong flags;
 138
 139         spin_lock_irqsave(&fweh->evt_q_lock, flags);
 140         list_add_tail(&event->q, &fweh->event_q);
 141         spin_unlock_irqrestore(&fweh->evt_q_lock, flags);
 142         schedule_work(&fweh->event_work);
 143 }
 144
 145 static int brcmf_fweh_call_event_handler(struct brcmf_if *ifp,
 146                                          enum brcmf_fweh_event_code code,
 147                                          struct brcmf_event_msg *emsg,
 148                                          void *data)
 149 {
 150         struct brcmf_fweh_info *fweh;
 151         int err = -EINVAL;
 152
 153         if (ifp) {
 154                 fweh = &ifp->drvr->fweh;
 155
 156                 /* handle the event if valid interface and handler */
 157                 if (ifp->ndev && fweh->evt_handler[code])
 158                         err = fweh->evt_handler[code](ifp, emsg, data);
 159                 else
 160                         brcmf_err("unhandled event %d ignored\n", code);
 161         } else {
 162                 brcmf_err("no interface object\n");
 163         }
 164         return err;
 165 }
 166
 167 /**
 168  * brcmf_fweh_handle_if_event() - handle IF event.
 169  *
 170  * @drvr: driver information object.
 171  * @item: queue entry.
 172  * @ifpp: interface object (may change upon ADD action).
 173  */
 174 static void brcmf_fweh_handle_if_event(struct brcmf_pub *drvr,
 175                                        struct brcmf_event_msg *emsg,
 176                                        void *data)
 177 {
 178         struct brcmf_if_event *ifevent = data;
 179         struct brcmf_if *ifp;
 180         int err = 0;
 181
 182         brcmf_dbg(EVENT, "action: %u idx: %u bsscfg: %u flags: %u\n",
 183                   ifevent->action, ifevent->ifidx,
 184                   ifevent->bssidx, ifevent->flags);
 185
 186         if (ifevent->ifidx >= BRCMF_MAX_IFS) {
 187                 brcmf_err("invalid interface index: %u\n",
 188                           ifevent->ifidx);
 189                 return;
 190         }
 191
 192         ifp = drvr->iflist[ifevent->bssidx];
 193
 194         if (ifevent->action == BRCMF_E_IF_ADD) {
 195                 brcmf_dbg(EVENT, "adding %s (%pM)\n", emsg->ifname,
 196                           emsg->addr);
 197                 ifp = brcmf_add_if(drvr, ifevent->bssidx, ifevent->ifidx,
 198                                    emsg->ifname, emsg->addr);
 199                 if (IS_ERR(ifp))
 200                         return;
 201
 202                 if (!drvr->fweh.evt_handler[BRCMF_E_IF])
 203                         err = brcmf_net_attach(ifp, false);
 204         }
 205
 206         err = brcmf_fweh_call_event_handler(ifp, emsg->event_code, emsg, data);
 207
 208         if (ifevent->action == BRCMF_E_IF_DEL)
 209                 brcmf_del_if(drvr, ifevent->bssidx);
 210 }
 211
 212 /**
 213  * brcmf_fweh_dequeue_event() - get event from the queue.
 214  *
 215  * @fweh: firmware event handling info.
 216  */
 217 static struct brcmf_fweh_queue_item *
 218 brcmf_fweh_dequeue_event(struct brcmf_fweh_info *fweh)
 219 {
 220         struct brcmf_fweh_queue_item *event = NULL;
 221         ulong flags;
 222
 223         spin_lock_irqsave(&fweh->evt_q_lock, flags);
 224         if (!list_empty(&fweh->event_q)) {
 225                 event = list_first_entry(&fweh->event_q,
 226                                          struct brcmf_fweh_queue_item, q);
 227                 list_del(&event->q);
 228         }
 229         spin_unlock_irqrestore(&fweh->evt_q_lock, flags);
 230
 231         return event;
 232 }
 233
 234 /**
 235  * brcmf_fweh_event_worker() - firmware event worker.
 236  *
 237  * @work: worker object.
 238  */
 239 static void brcmf_fweh_event_worker(struct work_struct *work)
 240 {
 241         struct brcmf_pub *drvr;
 242         struct brcmf_if *ifp;
 243         struct brcmf_fweh_info *fweh;
 244         struct brcmf_fweh_queue_item *event;
 245         int err = 0;
 246         struct brcmf_event_msg_be *emsg_be;
 247         struct brcmf_event_msg emsg;
 248
 249         fweh = container_of(work, struct brcmf_fweh_info, event_work);
 250         drvr = container_of(fweh, struct brcmf_pub, fweh);
 251
 252         while ((event = brcmf_fweh_dequeue_event(fweh))) {
 253                 brcmf_dbg(EVENT, "event %s (%u) ifidx %u bsscfg %u addr %pM\n",
 254                           brcmf_fweh_event_name(event->code), event->code,
 255                           event->emsg.ifidx, event->emsg.bsscfgidx,
 256                           event->emsg.addr);
 257
 258                 /* convert event message */
 259                 emsg_be = &event->emsg;
 260                 emsg.version = be16_to_cpu(emsg_be->version);
 261                 emsg.flags = be16_to_cpu(emsg_be->flags);
 262                 emsg.event_code = event->code;
 263                 emsg.status = be32_to_cpu(emsg_be->status);
 264                 emsg.reason = be32_to_cpu(emsg_be->reason);
 265                 emsg.auth_type = be32_to_cpu(emsg_be->auth_type);
 266                 emsg.datalen = be32_to_cpu(emsg_be->datalen);
 267                 memcpy(emsg.addr, emsg_be->addr, ETH_ALEN);
 268                 memcpy(emsg.ifname, emsg_be->ifname, sizeof(emsg.ifname));
 269                 emsg.ifidx = emsg_be->ifidx;
 270                 emsg.bsscfgidx = emsg_be->bsscfgidx;
 271
 272                 brcmf_dbg(EVENT, "  version %u flags %u status %u reason %u\n",
 273                           emsg.version, emsg.flags, emsg.status, emsg.reason);
 274                 brcmf_dbg_hex_dump(BRCMF_EVENT_ON(), event->data,
 275                                    min_t(u32, emsg.datalen, 64),
 276                                    "event payload, len=%d\n", emsg.datalen);
 277
 278                 /* special handling of interface event */
 279                 if (event->code == BRCMF_E_IF) {
 280                         brcmf_fweh_handle_if_event(drvr, &emsg, event->data);
 281                         goto event_free;
 282                 }
 283
 284                 ifp = drvr->iflist[emsg.bsscfgidx];
 285                 err = brcmf_fweh_call_event_handler(ifp, event->code, &emsg,
 286                                                     event->data);
 287                 if (err) {
 288                         brcmf_err("event handler failed (%d)\n",
 289                                   event->code);
 290                         err = 0;
 291                 }
 292 event_free:
 293                 kfree(event);
 294         }
 295 }
 296
 297 /**
 298  * brcmf_fweh_attach() - initialize firmware event handling.
 299  *
 300  * @drvr: driver information object.
 301  */
 302 void brcmf_fweh_attach(struct brcmf_pub *drvr)
 303 {
 304         struct brcmf_fweh_info *fweh = &drvr->fweh;
 305         INIT_WORK(&fweh->event_work, brcmf_fweh_event_worker);
 306         spin_lock_init(&fweh->evt_q_lock);
 307         INIT_LIST_HEAD(&fweh->event_q);
 308 }
 309
 310 /**
 311  * brcmf_fweh_detach() - cleanup firmware event handling.
 312  *
 313  * @drvr: driver information object.
 314  */
 315 void brcmf_fweh_detach(struct brcmf_pub *drvr)
 316 {
 317         struct brcmf_fweh_info *fweh = &drvr->fweh;
 318         struct brcmf_if *ifp = drvr->iflist[0];
 319         s8 eventmask[BRCMF_EVENTING_MASK_LEN];
 320
 321         if (ifp) {
 322                 /* clear all events */
 323                 memset(eventmask, 0, BRCMF_EVENTING_MASK_LEN);
 324                 (void)brcmf_fil_iovar_data_set(ifp, "event_msgs",
 325                                                eventmask,
 326                                                BRCMF_EVENTING_MASK_LEN);
 327         }
 328         /* cancel the worker */
 329         cancel_work_sync(&fweh->event_work);
 330         WARN_ON(!list_empty(&fweh->event_q));
 331         memset(fweh->evt_handler, 0, sizeof(fweh->evt_handler));
 332 }
 333
 334 /**
 335  * brcmf_fweh_register() - register handler for given event code.
 336  *
 337  * @drvr: driver information object.
 338  * @code: event code.
 339  * @handler: handler for the given event code.
 340  */
 341 int brcmf_fweh_register(struct brcmf_pub *drvr, enum brcmf_fweh_event_code code,
 342                         brcmf_fweh_handler_t handler)
 343 {
 344         if (drvr->fweh.evt_handler[code]) {
 345                 brcmf_err("event code %d already registered\n", code);
 346                 return -ENOSPC;
 347         }
 348         drvr->fweh.evt_handler[code] = handler;
 349         brcmf_dbg(TRACE, "event handler registered for %s\n",
 350                   brcmf_fweh_event_name(code));
 351         return 0;
 352 }
 353
 354 /**
 355  * brcmf_fweh_unregister() - remove handler for given code.
 356  *
 357  * @drvr: driver information object.
 358  * @code: event code.
 359  */
 360 void brcmf_fweh_unregister(struct brcmf_pub *drvr,
 361                            enum brcmf_fweh_event_code code)
 362 {
 363         brcmf_dbg(TRACE, "event handler cleared for %s\n",
 364                   brcmf_fweh_event_name(code));
 365         drvr->fweh.evt_handler[code] = NULL;
 366 }
 367
 368 /**
 369  * brcmf_fweh_activate_events() - enables firmware events registered.
 370  *
 371  * @ifp: primary interface object.
 372  */
 373 int brcmf_fweh_activate_events(struct brcmf_if *ifp)
 374 {
 375         int i, err;
 376         s8 eventmask[BRCMF_EVENTING_MASK_LEN];
 377
 378         for (i = 0; i < BRCMF_E_LAST; i++) {
 379                 if (ifp->drvr->fweh.evt_handler[i]) {
 380                         brcmf_dbg(EVENT, "enable event %s\n",
 381                                   brcmf_fweh_event_name(i));
 382                         setbit(eventmask, i);
 383                 }
 384         }
 385
 386         /* want to handle IF event as well */
 387         brcmf_dbg(EVENT, "enable event IF\n");
 388         setbit(eventmask, BRCMF_E_IF);
 389
 390         err = brcmf_fil_iovar_data_set(ifp, "event_msgs",
 391                                        eventmask, BRCMF_EVENTING_MASK_LEN);
 392         if (err)
 393                 brcmf_err("Set event_msgs error (%d)\n", err);
 394
 395         return err;
 396 }
 397
 398 /**
 399  * brcmf_fweh_process_event() - process skb as firmware event.
 400  *
 401  * @drvr: driver information object.
 402  * @event_packet: event packet to process.
 403  * @ifidx: index of the firmware interface (may change).
 404  *
 405  * If the packet buffer contains a firmware event message it will
 406  * dispatch the event to a registered handler (using worker).
 407  */
 408 void brcmf_fweh_process_event(struct brcmf_pub *drvr,
 409                               struct brcmf_event *event_packet, u8 *ifidx)
 410 {
 411         enum brcmf_fweh_event_code code;
 412         struct brcmf_fweh_info *fweh = &drvr->fweh;
 413         struct brcmf_fweh_queue_item *event;
 414         gfp_t alloc_flag = GFP_KERNEL;
 415         void *data;
 416         u32 datalen;
 417
 418         /* get event info */
 419         code = get_unaligned_be32(&event_packet->msg.event_type);
 420         datalen = get_unaligned_be32(&event_packet->msg.datalen);
 421         *ifidx = event_packet->msg.ifidx;
 422         data = &event_packet[1];
 423
 424         if (code >= BRCMF_E_LAST)
 425                 return;
 426
 427         if (code != BRCMF_E_IF && !fweh->evt_handler[code])
 428                 return;
 429
 430         if (in_interrupt())
 431                 alloc_flag = GFP_ATOMIC;
 432
 433         event = kzalloc(sizeof(*event) + datalen, alloc_flag);
 434         if (!event)
 435                 return;
 436
 437         event->code = code;
 438         event->ifidx = *ifidx;
 439
 440         /* use memcpy to get aligned event message */
 441         memcpy(&event->emsg, &event_packet->msg, sizeof(event->emsg));
 442         memcpy(event->data, data, datalen);
 443         memcpy(event->ifaddr, event_packet->eth.h_dest, ETH_ALEN);
 444
 445         brcmf_fweh_queue_event(fweh, event);
 446 }