xref: /openbmc/linux/drivers/net/wireless/broadcom/brcm80211/brcmfmac/fweh.c (revision 7ae9fb1b7ecbb5d85d07857943f677fd1a559b18)
1  // SPDX-License-Identifier: ISC
2  /*
3   * Copyright (c) 2012 Broadcom Corporation
4   */
5  #include <linux/netdevice.h>
6  
7  #include "brcmu_wifi.h"
8  #include "brcmu_utils.h"
9  
10  #include "cfg80211.h"
11  #include "core.h"
12  #include "debug.h"
13  #include "tracepoint.h"
14  #include "fweh.h"
15  #include "fwil.h"
16  #include "proto.h"
17  
18  /**
19   * struct brcmf_fweh_queue_item - event item on event queue.
20   *
21   * @q: list element for queuing.
22   * @code: event code.
23   * @ifidx: interface index related to this event.
24   * @ifaddr: ethernet address for interface.
25   * @emsg: common parameters of the firmware event message.
26   * @datalen: length of the data array
27   * @data: event specific data part of the firmware event.
28   */
29  struct brcmf_fweh_queue_item {
30  	struct list_head q;
31  	enum brcmf_fweh_event_code code;
32  	u8 ifidx;
33  	u8 ifaddr[ETH_ALEN];
34  	struct brcmf_event_msg_be emsg;
35  	u32 datalen;
36  	u8 data[];
37  };
38  
39  /*
40   * struct brcmf_fweh_event_name - code, name mapping entry.
41   */
42  struct brcmf_fweh_event_name {
43  	enum brcmf_fweh_event_code code;
44  	const char *name;
45  };
46  
47  #ifdef DEBUG
48  #define BRCMF_ENUM_DEF(id, val) \
49  	{ val, #id },
50  
51  /* array for mapping code to event name */
52  static struct brcmf_fweh_event_name fweh_event_names[] = {
53  	BRCMF_FWEH_EVENT_ENUM_DEFLIST
54  };
55  #undef BRCMF_ENUM_DEF
56  
57  /**
58   * brcmf_fweh_event_name() - returns name for given event code.
59   *
60   * @code: code to lookup.
61   */
brcmf_fweh_event_name(enum brcmf_fweh_event_code code)62  const char *brcmf_fweh_event_name(enum brcmf_fweh_event_code code)
63  {
64  	int i;
65  	for (i = 0; i < ARRAY_SIZE(fweh_event_names); i++) {
66  		if (fweh_event_names[i].code == code)
67  			return fweh_event_names[i].name;
68  	}
69  	return "unknown";
70  }
71  #else
brcmf_fweh_event_name(enum brcmf_fweh_event_code code)72  const char *brcmf_fweh_event_name(enum brcmf_fweh_event_code code)
73  {
74  	return "nodebug";
75  }
76  #endif
77  
78  /**
79   * brcmf_fweh_queue_event() - create and queue event.
80   *
81   * @fweh: firmware event handling info.
82   * @event: event queue entry.
83   */
brcmf_fweh_queue_event(struct brcmf_fweh_info * fweh,struct brcmf_fweh_queue_item * event)84  static void brcmf_fweh_queue_event(struct brcmf_fweh_info *fweh,
85  				   struct brcmf_fweh_queue_item *event)
86  {
87  	ulong flags;
88  
89  	spin_lock_irqsave(&fweh->evt_q_lock, flags);
90  	list_add_tail(&event->q, &fweh->event_q);
91  	spin_unlock_irqrestore(&fweh->evt_q_lock, flags);
92  	schedule_work(&fweh->event_work);
93  }
94  
brcmf_fweh_call_event_handler(struct brcmf_pub * drvr,struct brcmf_if * ifp,enum brcmf_fweh_event_code code,struct brcmf_event_msg * emsg,void * data)95  static int brcmf_fweh_call_event_handler(struct brcmf_pub *drvr,
96  					 struct brcmf_if *ifp,
97  					 enum brcmf_fweh_event_code code,
98  					 struct brcmf_event_msg *emsg,
99  					 void *data)
100  {
101  	struct brcmf_fweh_info *fweh;
102  	int err = -EINVAL;
103  
104  	if (ifp) {
105  		fweh = &ifp->drvr->fweh;
106  
107  		/* handle the event if valid interface and handler */
108  		if (fweh->evt_handler[code])
109  			err = fweh->evt_handler[code](ifp, emsg, data);
110  		else
111  			bphy_err(drvr, "unhandled event %d ignored\n", code);
112  	} else {
113  		bphy_err(drvr, "no interface object\n");
114  	}
115  	return err;
116  }
117  
118  /**
119   * brcmf_fweh_handle_if_event() - handle IF event.
120   *
121   * @drvr: driver information object.
122   * @emsg: event message object.
123   * @data: event object.
124   */
brcmf_fweh_handle_if_event(struct brcmf_pub * drvr,struct brcmf_event_msg * emsg,void * data)125  static void brcmf_fweh_handle_if_event(struct brcmf_pub *drvr,
126  				       struct brcmf_event_msg *emsg,
127  				       void *data)
128  {
129  	struct brcmf_if_event *ifevent = data;
130  	struct brcmf_if *ifp;
131  	bool is_p2pdev;
132  
133  	brcmf_dbg(EVENT, "action: %u ifidx: %u bsscfgidx: %u flags: %u role: %u\n",
134  		  ifevent->action, ifevent->ifidx, ifevent->bsscfgidx,
135  		  ifevent->flags, ifevent->role);
136  
137  	/* The P2P Device interface event must not be ignored contrary to what
138  	 * firmware tells us. Older firmware uses p2p noif, with sta role.
139  	 * This should be accepted when p2pdev_setup is ongoing. TDLS setup will
140  	 * use the same ifevent and should be ignored.
141  	 */
142  	is_p2pdev = ((ifevent->flags & BRCMF_E_IF_FLAG_NOIF) &&
143  		     (ifevent->role == BRCMF_E_IF_ROLE_P2P_CLIENT ||
144  		      ((ifevent->role == BRCMF_E_IF_ROLE_STA) &&
145  		       (drvr->fweh.p2pdev_setup_ongoing))));
146  	if (!is_p2pdev && (ifevent->flags & BRCMF_E_IF_FLAG_NOIF)) {
147  		brcmf_dbg(EVENT, "event can be ignored\n");
148  		return;
149  	}
150  	if (ifevent->ifidx >= BRCMF_MAX_IFS) {
151  		bphy_err(drvr, "invalid interface index: %u\n", ifevent->ifidx);
152  		return;
153  	}
154  
155  	ifp = drvr->iflist[ifevent->bsscfgidx];
156  
157  	if (ifevent->action == BRCMF_E_IF_ADD) {
158  		brcmf_dbg(EVENT, "adding %s (%pM)\n", emsg->ifname,
159  			  emsg->addr);
160  		ifp = brcmf_add_if(drvr, ifevent->bsscfgidx, ifevent->ifidx,
161  				   is_p2pdev, emsg->ifname, emsg->addr);
162  		if (IS_ERR(ifp))
163  			return;
164  		if (!is_p2pdev)
165  			brcmf_proto_add_if(drvr, ifp);
166  		if (!drvr->fweh.evt_handler[BRCMF_E_IF])
167  			if (brcmf_net_attach(ifp, false) < 0)
168  				return;
169  	}
170  
171  	if (ifp && ifevent->action == BRCMF_E_IF_CHANGE)
172  		brcmf_proto_reset_if(drvr, ifp);
173  
174  	brcmf_fweh_call_event_handler(drvr, ifp, emsg->event_code, emsg,
175  				      data);
176  
177  	if (ifp && ifevent->action == BRCMF_E_IF_DEL) {
178  		bool armed = brcmf_cfg80211_vif_event_armed(drvr->config);
179  
180  		/* Default handling in case no-one waits for this event */
181  		if (!armed)
182  			brcmf_remove_interface(ifp, false);
183  	}
184  }
185  
186  /**
187   * brcmf_fweh_dequeue_event() - get event from the queue.
188   *
189   * @fweh: firmware event handling info.
190   */
191  static struct brcmf_fweh_queue_item *
brcmf_fweh_dequeue_event(struct brcmf_fweh_info * fweh)192  brcmf_fweh_dequeue_event(struct brcmf_fweh_info *fweh)
193  {
194  	struct brcmf_fweh_queue_item *event = NULL;
195  	ulong flags;
196  
197  	spin_lock_irqsave(&fweh->evt_q_lock, flags);
198  	if (!list_empty(&fweh->event_q)) {
199  		event = list_first_entry(&fweh->event_q,
200  					 struct brcmf_fweh_queue_item, q);
201  		list_del(&event->q);
202  	}
203  	spin_unlock_irqrestore(&fweh->evt_q_lock, flags);
204  
205  	return event;
206  }
207  
208  /**
209   * brcmf_fweh_event_worker() - firmware event worker.
210   *
211   * @work: worker object.
212   */
brcmf_fweh_event_worker(struct work_struct * work)213  static void brcmf_fweh_event_worker(struct work_struct *work)
214  {
215  	struct brcmf_pub *drvr;
216  	struct brcmf_if *ifp;
217  	struct brcmf_fweh_info *fweh;
218  	struct brcmf_fweh_queue_item *event;
219  	int err = 0;
220  	struct brcmf_event_msg_be *emsg_be;
221  	struct brcmf_event_msg emsg;
222  
223  	fweh = container_of(work, struct brcmf_fweh_info, event_work);
224  	drvr = container_of(fweh, struct brcmf_pub, fweh);
225  
226  	while ((event = brcmf_fweh_dequeue_event(fweh))) {
227  		brcmf_dbg(EVENT, "event %s (%u) ifidx %u bsscfg %u addr %pM\n",
228  			  brcmf_fweh_event_name(event->code), event->code,
229  			  event->emsg.ifidx, event->emsg.bsscfgidx,
230  			  event->emsg.addr);
231  		if (event->emsg.bsscfgidx >= BRCMF_MAX_IFS) {
232  			bphy_err(drvr, "invalid bsscfg index: %u\n", event->emsg.bsscfgidx);
233  			goto event_free;
234  		}
235  
236  		/* convert event message */
237  		emsg_be = &event->emsg;
238  		emsg.version = be16_to_cpu(emsg_be->version);
239  		emsg.flags = be16_to_cpu(emsg_be->flags);
240  		emsg.event_code = event->code;
241  		emsg.status = be32_to_cpu(emsg_be->status);
242  		emsg.reason = be32_to_cpu(emsg_be->reason);
243  		emsg.auth_type = be32_to_cpu(emsg_be->auth_type);
244  		emsg.datalen = be32_to_cpu(emsg_be->datalen);
245  		memcpy(emsg.addr, emsg_be->addr, ETH_ALEN);
246  		memcpy(emsg.ifname, emsg_be->ifname, sizeof(emsg.ifname));
247  		emsg.ifidx = emsg_be->ifidx;
248  		emsg.bsscfgidx = emsg_be->bsscfgidx;
249  
250  		brcmf_dbg(EVENT, "  version %u flags %u status %u reason %u\n",
251  			  emsg.version, emsg.flags, emsg.status, emsg.reason);
252  		brcmf_dbg_hex_dump(BRCMF_EVENT_ON(), event->data,
253  				   min_t(u32, emsg.datalen, 64),
254  				   "event payload, len=%d\n", emsg.datalen);
255  
256  		/* special handling of interface event */
257  		if (event->code == BRCMF_E_IF) {
258  			brcmf_fweh_handle_if_event(drvr, &emsg, event->data);
259  			goto event_free;
260  		}
261  
262  		if (event->code == BRCMF_E_TDLS_PEER_EVENT)
263  			ifp = drvr->iflist[0];
264  		else
265  			ifp = drvr->iflist[emsg.bsscfgidx];
266  		err = brcmf_fweh_call_event_handler(drvr, ifp, event->code,
267  						    &emsg, event->data);
268  		if (err) {
269  			bphy_err(drvr, "event handler failed (%d)\n",
270  				 event->code);
271  			err = 0;
272  		}
273  event_free:
274  		kfree(event);
275  	}
276  }
277  
278  /**
279   * brcmf_fweh_p2pdev_setup() - P2P device setup ongoing (or not).
280   *
281   * @ifp: ifp on which setup is taking place or finished.
282   * @ongoing: p2p device setup in progress (or not).
283   */
brcmf_fweh_p2pdev_setup(struct brcmf_if * ifp,bool ongoing)284  void brcmf_fweh_p2pdev_setup(struct brcmf_if *ifp, bool ongoing)
285  {
286  	ifp->drvr->fweh.p2pdev_setup_ongoing = ongoing;
287  }
288  
289  /**
290   * brcmf_fweh_attach() - initialize firmware event handling.
291   *
292   * @drvr: driver information object.
293   */
brcmf_fweh_attach(struct brcmf_pub * drvr)294  void brcmf_fweh_attach(struct brcmf_pub *drvr)
295  {
296  	struct brcmf_fweh_info *fweh = &drvr->fweh;
297  	INIT_WORK(&fweh->event_work, brcmf_fweh_event_worker);
298  	spin_lock_init(&fweh->evt_q_lock);
299  	INIT_LIST_HEAD(&fweh->event_q);
300  }
301  
302  /**
303   * brcmf_fweh_detach() - cleanup firmware event handling.
304   *
305   * @drvr: driver information object.
306   */
brcmf_fweh_detach(struct brcmf_pub * drvr)307  void brcmf_fweh_detach(struct brcmf_pub *drvr)
308  {
309  	struct brcmf_fweh_info *fweh = &drvr->fweh;
310  
311  	/* cancel the worker if initialized */
312  	if (fweh->event_work.func) {
313  		cancel_work_sync(&fweh->event_work);
314  		WARN_ON(!list_empty(&fweh->event_q));
315  		memset(fweh->evt_handler, 0, sizeof(fweh->evt_handler));
316  	}
317  }
318  
319  /**
320   * brcmf_fweh_register() - register handler for given event code.
321   *
322   * @drvr: driver information object.
323   * @code: event code.
324   * @handler: handler for the given event code.
325   */
brcmf_fweh_register(struct brcmf_pub * drvr,enum brcmf_fweh_event_code code,brcmf_fweh_handler_t handler)326  int brcmf_fweh_register(struct brcmf_pub *drvr, enum brcmf_fweh_event_code code,
327  			brcmf_fweh_handler_t handler)
328  {
329  	if (drvr->fweh.evt_handler[code]) {
330  		bphy_err(drvr, "event code %d already registered\n", code);
331  		return -ENOSPC;
332  	}
333  	drvr->fweh.evt_handler[code] = handler;
334  	brcmf_dbg(TRACE, "event handler registered for %s\n",
335  		  brcmf_fweh_event_name(code));
336  	return 0;
337  }
338  
339  /**
340   * brcmf_fweh_unregister() - remove handler for given code.
341   *
342   * @drvr: driver information object.
343   * @code: event code.
344   */
brcmf_fweh_unregister(struct brcmf_pub * drvr,enum brcmf_fweh_event_code code)345  void brcmf_fweh_unregister(struct brcmf_pub *drvr,
346  			   enum brcmf_fweh_event_code code)
347  {
348  	brcmf_dbg(TRACE, "event handler cleared for %s\n",
349  		  brcmf_fweh_event_name(code));
350  	drvr->fweh.evt_handler[code] = NULL;
351  }
352  
353  /**
354   * brcmf_fweh_activate_events() - enables firmware events registered.
355   *
356   * @ifp: primary interface object.
357   */
brcmf_fweh_activate_events(struct brcmf_if * ifp)358  int brcmf_fweh_activate_events(struct brcmf_if *ifp)
359  {
360  	struct brcmf_pub *drvr = ifp->drvr;
361  	int i, err;
362  	s8 eventmask[BRCMF_EVENTING_MASK_LEN];
363  
364  	memset(eventmask, 0, sizeof(eventmask));
365  	for (i = 0; i < BRCMF_E_LAST; i++) {
366  		if (ifp->drvr->fweh.evt_handler[i]) {
367  			brcmf_dbg(EVENT, "enable event %s\n",
368  				  brcmf_fweh_event_name(i));
369  			setbit(eventmask, i);
370  		}
371  	}
372  
373  	/* want to handle IF event as well */
374  	brcmf_dbg(EVENT, "enable event IF\n");
375  	setbit(eventmask, BRCMF_E_IF);
376  
377  	err = brcmf_fil_iovar_data_set(ifp, "event_msgs",
378  				       eventmask, BRCMF_EVENTING_MASK_LEN);
379  	if (err)
380  		bphy_err(drvr, "Set event_msgs error (%d)\n", err);
381  
382  	return err;
383  }
384  
385  /**
386   * brcmf_fweh_process_event() - process skb as firmware event.
387   *
388   * @drvr: driver information object.
389   * @event_packet: event packet to process.
390   * @packet_len: length of the packet
391   * @gfp: memory allocation flags.
392   *
393   * If the packet buffer contains a firmware event message it will
394   * dispatch the event to a registered handler (using worker).
395   */
brcmf_fweh_process_event(struct brcmf_pub * drvr,struct brcmf_event * event_packet,u32 packet_len,gfp_t gfp)396  void brcmf_fweh_process_event(struct brcmf_pub *drvr,
397  			      struct brcmf_event *event_packet,
398  			      u32 packet_len, gfp_t gfp)
399  {
400  	enum brcmf_fweh_event_code code;
401  	struct brcmf_fweh_info *fweh = &drvr->fweh;
402  	struct brcmf_fweh_queue_item *event;
403  	void *data;
404  	u32 datalen;
405  
406  	/* get event info */
407  	code = get_unaligned_be32(&event_packet->msg.event_type);
408  	datalen = get_unaligned_be32(&event_packet->msg.datalen);
409  	data = &event_packet[1];
410  
411  	if (code >= BRCMF_E_LAST)
412  		return;
413  
414  	if (code != BRCMF_E_IF && !fweh->evt_handler[code])
415  		return;
416  
417  	if (datalen > BRCMF_DCMD_MAXLEN ||
418  	    datalen + sizeof(*event_packet) > packet_len)
419  		return;
420  
421  	event = kzalloc(sizeof(*event) + datalen, gfp);
422  	if (!event)
423  		return;
424  
425  	event->code = code;
426  	event->ifidx = event_packet->msg.ifidx;
427  
428  	/* use memcpy to get aligned event message */
429  	memcpy(&event->emsg, &event_packet->msg, sizeof(event->emsg));
430  	memcpy(event->data, data, datalen);
431  	event->datalen = datalen;
432  	memcpy(event->ifaddr, event_packet->eth.h_dest, ETH_ALEN);
433  
434  	brcmf_fweh_queue_event(fweh, event);
435  }
436