2 * Copyright (c) 2012 Broadcom Corporation
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.
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.
16 #include <linux/netdevice.h>
18 #include "brcmu_wifi.h"
19 #include "brcmu_utils.h"
23 #include "tracepoint.h"
29 * struct brcm_ethhdr - broadcom specific ether header.
31 * @subtype: subtype for this packet.
32 * @length: TODO: length of appended data.
33 * @version: version indication.
34 * @oui: OUI of this packet.
35 * @usr_subtype: subtype for this OUI.
45 struct brcmf_event_msg_be {
54 char ifname[IFNAMSIZ];
60 * struct brcmf_event - contents of broadcom event packet.
62 * @eth: standard ether header.
63 * @hdr: broadcom specific ether header.
64 * @msg: common part of the actual event message.
68 struct brcm_ethhdr hdr;
69 struct brcmf_event_msg_be msg;
73 * struct brcmf_fweh_queue_item - event item on event queue.
75 * @q: list element for queuing.
77 * @ifidx: interface index related to this event.
78 * @ifaddr: ethernet address for interface.
79 * @emsg: common parameters of the firmware event message.
80 * @data: event specific data part of the firmware event.
82 struct brcmf_fweh_queue_item {
84 enum brcmf_fweh_event_code code;
87 struct brcmf_event_msg_be emsg;
92 * struct brcmf_fweh_event_name - code, name mapping entry.
94 struct brcmf_fweh_event_name {
95 enum brcmf_fweh_event_code code;
100 #define BRCMF_ENUM_DEF(id, val) \
103 /* array for mapping code to event name */
104 static struct brcmf_fweh_event_name fweh_event_names[] = {
105 BRCMF_FWEH_EVENT_ENUM_DEFLIST
107 #undef BRCMF_ENUM_DEF
110 * brcmf_fweh_event_name() - returns name for given event code.
112 * @code: code to lookup.
114 static const char *brcmf_fweh_event_name(enum brcmf_fweh_event_code code)
117 for (i = 0; i < ARRAY_SIZE(fweh_event_names); i++) {
118 if (fweh_event_names[i].code == code)
119 return fweh_event_names[i].name;
124 static const char *brcmf_fweh_event_name(enum brcmf_fweh_event_code code)
131 * brcmf_fweh_queue_event() - create and queue event.
133 * @fweh: firmware event handling info.
134 * @event: event queue entry.
136 static void brcmf_fweh_queue_event(struct brcmf_fweh_info *fweh,
137 struct brcmf_fweh_queue_item *event)
141 spin_lock_irqsave(&fweh->evt_q_lock, flags);
142 list_add_tail(&event->q, &fweh->event_q);
143 spin_unlock_irqrestore(&fweh->evt_q_lock, flags);
144 schedule_work(&fweh->event_work);
147 static int brcmf_fweh_call_event_handler(struct brcmf_if *ifp,
148 enum brcmf_fweh_event_code code,
149 struct brcmf_event_msg *emsg,
152 struct brcmf_fweh_info *fweh;
156 fweh = &ifp->drvr->fweh;
158 /* handle the event if valid interface and handler */
159 if (fweh->evt_handler[code])
160 err = fweh->evt_handler[code](ifp, emsg, data);
162 brcmf_err("unhandled event %d ignored\n", code);
164 brcmf_err("no interface object\n");
170 * brcmf_fweh_handle_if_event() - handle IF event.
172 * @drvr: driver information object.
173 * @item: queue entry.
174 * @ifpp: interface object (may change upon ADD action).
176 static void brcmf_fweh_handle_if_event(struct brcmf_pub *drvr,
177 struct brcmf_event_msg *emsg,
180 struct brcmf_if_event *ifevent = data;
181 struct brcmf_if *ifp;
185 brcmf_dbg(EVENT, "action: %u ifidx: %u bsscfgidx: %u flags: %u role: %u\n",
186 ifevent->action, ifevent->ifidx, ifevent->bsscfgidx,
187 ifevent->flags, ifevent->role);
189 /* The P2P Device interface event must not be ignored contrary to what
190 * firmware tells us. Older firmware uses p2p noif, with sta role.
191 * This should be accepted when p2pdev_setup is ongoing. TDLS setup will
192 * use the same ifevent and should be ignored.
194 is_p2pdev = ((ifevent->flags & BRCMF_E_IF_FLAG_NOIF) &&
195 (ifevent->role == BRCMF_E_IF_ROLE_P2P_CLIENT ||
196 ((ifevent->role == BRCMF_E_IF_ROLE_STA) &&
197 (drvr->fweh.p2pdev_setup_ongoing))));
198 if (!is_p2pdev && (ifevent->flags & BRCMF_E_IF_FLAG_NOIF)) {
199 brcmf_dbg(EVENT, "event can be ignored\n");
202 if (ifevent->ifidx >= BRCMF_MAX_IFS) {
203 brcmf_err("invalid interface index: %u\n", ifevent->ifidx);
207 ifp = drvr->iflist[ifevent->bsscfgidx];
209 if (ifevent->action == BRCMF_E_IF_ADD) {
210 brcmf_dbg(EVENT, "adding %s (%pM)\n", emsg->ifname,
212 ifp = brcmf_add_if(drvr, ifevent->bsscfgidx, ifevent->ifidx,
213 is_p2pdev, emsg->ifname, emsg->addr);
217 brcmf_fws_add_interface(ifp);
218 if (!drvr->fweh.evt_handler[BRCMF_E_IF])
219 if (brcmf_net_attach(ifp, false) < 0)
223 if (ifp && ifevent->action == BRCMF_E_IF_CHANGE)
224 brcmf_fws_reset_interface(ifp);
226 err = brcmf_fweh_call_event_handler(ifp, emsg->event_code, emsg, data);
228 if (ifp && ifevent->action == BRCMF_E_IF_DEL)
229 brcmf_remove_interface(ifp);
233 * brcmf_fweh_dequeue_event() - get event from the queue.
235 * @fweh: firmware event handling info.
237 static struct brcmf_fweh_queue_item *
238 brcmf_fweh_dequeue_event(struct brcmf_fweh_info *fweh)
240 struct brcmf_fweh_queue_item *event = NULL;
243 spin_lock_irqsave(&fweh->evt_q_lock, flags);
244 if (!list_empty(&fweh->event_q)) {
245 event = list_first_entry(&fweh->event_q,
246 struct brcmf_fweh_queue_item, q);
249 spin_unlock_irqrestore(&fweh->evt_q_lock, flags);
255 * brcmf_fweh_event_worker() - firmware event worker.
257 * @work: worker object.
259 static void brcmf_fweh_event_worker(struct work_struct *work)
261 struct brcmf_pub *drvr;
262 struct brcmf_if *ifp;
263 struct brcmf_fweh_info *fweh;
264 struct brcmf_fweh_queue_item *event;
266 struct brcmf_event_msg_be *emsg_be;
267 struct brcmf_event_msg emsg;
269 fweh = container_of(work, struct brcmf_fweh_info, event_work);
270 drvr = container_of(fweh, struct brcmf_pub, fweh);
272 while ((event = brcmf_fweh_dequeue_event(fweh))) {
273 brcmf_dbg(EVENT, "event %s (%u) ifidx %u bsscfg %u addr %pM\n",
274 brcmf_fweh_event_name(event->code), event->code,
275 event->emsg.ifidx, event->emsg.bsscfgidx,
278 /* convert event message */
279 emsg_be = &event->emsg;
280 emsg.version = be16_to_cpu(emsg_be->version);
281 emsg.flags = be16_to_cpu(emsg_be->flags);
282 emsg.event_code = event->code;
283 emsg.status = be32_to_cpu(emsg_be->status);
284 emsg.reason = be32_to_cpu(emsg_be->reason);
285 emsg.auth_type = be32_to_cpu(emsg_be->auth_type);
286 emsg.datalen = be32_to_cpu(emsg_be->datalen);
287 memcpy(emsg.addr, emsg_be->addr, ETH_ALEN);
288 memcpy(emsg.ifname, emsg_be->ifname, sizeof(emsg.ifname));
289 emsg.ifidx = emsg_be->ifidx;
290 emsg.bsscfgidx = emsg_be->bsscfgidx;
292 brcmf_dbg(EVENT, " version %u flags %u status %u reason %u\n",
293 emsg.version, emsg.flags, emsg.status, emsg.reason);
294 brcmf_dbg_hex_dump(BRCMF_EVENT_ON(), event->data,
295 min_t(u32, emsg.datalen, 64),
296 "event payload, len=%d\n", emsg.datalen);
298 /* special handling of interface event */
299 if (event->code == BRCMF_E_IF) {
300 brcmf_fweh_handle_if_event(drvr, &emsg, event->data);
304 if (event->code == BRCMF_E_TDLS_PEER_EVENT)
305 ifp = drvr->iflist[0];
307 ifp = drvr->iflist[emsg.bsscfgidx];
308 err = brcmf_fweh_call_event_handler(ifp, event->code, &emsg,
311 brcmf_err("event handler failed (%d)\n",
321 * brcmf_fweh_p2pdev_setup() - P2P device setup ongoing (or not).
323 * @ifp: ifp on which setup is taking place or finished.
324 * @ongoing: p2p device setup in progress (or not).
326 void brcmf_fweh_p2pdev_setup(struct brcmf_if *ifp, bool ongoing)
328 ifp->drvr->fweh.p2pdev_setup_ongoing = ongoing;
332 * brcmf_fweh_attach() - initialize firmware event handling.
334 * @drvr: driver information object.
336 void brcmf_fweh_attach(struct brcmf_pub *drvr)
338 struct brcmf_fweh_info *fweh = &drvr->fweh;
339 INIT_WORK(&fweh->event_work, brcmf_fweh_event_worker);
340 spin_lock_init(&fweh->evt_q_lock);
341 INIT_LIST_HEAD(&fweh->event_q);
345 * brcmf_fweh_detach() - cleanup firmware event handling.
347 * @drvr: driver information object.
349 void brcmf_fweh_detach(struct brcmf_pub *drvr)
351 struct brcmf_fweh_info *fweh = &drvr->fweh;
352 struct brcmf_if *ifp = brcmf_get_ifp(drvr, 0);
353 s8 eventmask[BRCMF_EVENTING_MASK_LEN];
356 /* clear all events */
357 memset(eventmask, 0, BRCMF_EVENTING_MASK_LEN);
358 (void)brcmf_fil_iovar_data_set(ifp, "event_msgs",
360 BRCMF_EVENTING_MASK_LEN);
362 /* cancel the worker */
363 cancel_work_sync(&fweh->event_work);
364 WARN_ON(!list_empty(&fweh->event_q));
365 memset(fweh->evt_handler, 0, sizeof(fweh->evt_handler));
369 * brcmf_fweh_register() - register handler for given event code.
371 * @drvr: driver information object.
373 * @handler: handler for the given event code.
375 int brcmf_fweh_register(struct brcmf_pub *drvr, enum brcmf_fweh_event_code code,
376 brcmf_fweh_handler_t handler)
378 if (drvr->fweh.evt_handler[code]) {
379 brcmf_err("event code %d already registered\n", code);
382 drvr->fweh.evt_handler[code] = handler;
383 brcmf_dbg(TRACE, "event handler registered for %s\n",
384 brcmf_fweh_event_name(code));
389 * brcmf_fweh_unregister() - remove handler for given code.
391 * @drvr: driver information object.
394 void brcmf_fweh_unregister(struct brcmf_pub *drvr,
395 enum brcmf_fweh_event_code code)
397 brcmf_dbg(TRACE, "event handler cleared for %s\n",
398 brcmf_fweh_event_name(code));
399 drvr->fweh.evt_handler[code] = NULL;
403 * brcmf_fweh_activate_events() - enables firmware events registered.
405 * @ifp: primary interface object.
407 int brcmf_fweh_activate_events(struct brcmf_if *ifp)
410 s8 eventmask[BRCMF_EVENTING_MASK_LEN];
412 for (i = 0; i < BRCMF_E_LAST; i++) {
413 if (ifp->drvr->fweh.evt_handler[i]) {
414 brcmf_dbg(EVENT, "enable event %s\n",
415 brcmf_fweh_event_name(i));
416 setbit(eventmask, i);
420 /* want to handle IF event as well */
421 brcmf_dbg(EVENT, "enable event IF\n");
422 setbit(eventmask, BRCMF_E_IF);
424 err = brcmf_fil_iovar_data_set(ifp, "event_msgs",
425 eventmask, BRCMF_EVENTING_MASK_LEN);
427 brcmf_err("Set event_msgs error (%d)\n", err);
433 * brcmf_fweh_process_event() - process skb as firmware event.
435 * @drvr: driver information object.
436 * @event_packet: event packet to process.
438 * If the packet buffer contains a firmware event message it will
439 * dispatch the event to a registered handler (using worker).
441 void brcmf_fweh_process_event(struct brcmf_pub *drvr,
442 struct brcmf_event *event_packet)
444 enum brcmf_fweh_event_code code;
445 struct brcmf_fweh_info *fweh = &drvr->fweh;
446 struct brcmf_fweh_queue_item *event;
447 gfp_t alloc_flag = GFP_KERNEL;
452 code = get_unaligned_be32(&event_packet->msg.event_type);
453 datalen = get_unaligned_be32(&event_packet->msg.datalen);
454 data = &event_packet[1];
456 if (code >= BRCMF_E_LAST)
459 if (code != BRCMF_E_IF && !fweh->evt_handler[code])
463 alloc_flag = GFP_ATOMIC;
465 event = kzalloc(sizeof(*event) + datalen, alloc_flag);
470 event->ifidx = event_packet->msg.ifidx;
472 /* use memcpy to get aligned event message */
473 memcpy(&event->emsg, &event_packet->msg, sizeof(event->emsg));
474 memcpy(event->data, data, datalen);
475 memcpy(event->ifaddr, event_packet->eth.h_dest, ETH_ALEN);
477 brcmf_fweh_queue_event(fweh, event);