xref: /linux/drivers/net/wireless/rsi/rsi_91x_main.c (revision a5d9265e017f081f0dc133c0e2f45103d027b874)
1 /**
2  * Copyright (c) 2014 Redpine Signals Inc.
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
11  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15  */
16 
17 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
18 
19 #include <linux/module.h>
20 #include <linux/firmware.h>
21 #include <net/rsi_91x.h>
22 #include "rsi_mgmt.h"
23 #include "rsi_common.h"
24 #include "rsi_coex.h"
25 #include "rsi_hal.h"
26 
27 u32 rsi_zone_enabled = /* INFO_ZONE |
28 			INIT_ZONE |
29 			MGMT_TX_ZONE |
30 			MGMT_RX_ZONE |
31 			DATA_TX_ZONE |
32 			DATA_RX_ZONE |
33 			FSM_ZONE |
34 			ISR_ZONE | */
35 			ERR_ZONE |
36 			0;
37 EXPORT_SYMBOL_GPL(rsi_zone_enabled);
38 
39 #ifdef CONFIG_RSI_COEX
40 static struct rsi_proto_ops g_proto_ops = {
41 	.coex_send_pkt = rsi_coex_send_pkt,
42 	.get_host_intf = rsi_get_host_intf,
43 	.set_bt_context = rsi_set_bt_context,
44 };
45 #endif
46 
47 /**
48  * rsi_dbg() - This function outputs informational messages.
49  * @zone: Zone of interest for output message.
50  * @fmt: printf-style format for output message.
51  *
52  * Return: none
53  */
54 void rsi_dbg(u32 zone, const char *fmt, ...)
55 {
56 	struct va_format vaf;
57 	va_list args;
58 
59 	va_start(args, fmt);
60 
61 	vaf.fmt = fmt;
62 	vaf.va = &args;
63 
64 	if (zone & rsi_zone_enabled)
65 		pr_info("%pV", &vaf);
66 	va_end(args);
67 }
68 EXPORT_SYMBOL_GPL(rsi_dbg);
69 
70 static char *opmode_str(int oper_mode)
71 {
72 	switch (oper_mode) {
73 	case DEV_OPMODE_WIFI_ALONE:
74 		return "Wi-Fi alone";
75 	case DEV_OPMODE_BT_ALONE:
76 		return "BT EDR alone";
77 	case DEV_OPMODE_BT_LE_ALONE:
78 		return "BT LE alone";
79 	case DEV_OPMODE_BT_DUAL:
80 		return "BT Dual";
81 	case DEV_OPMODE_STA_BT:
82 		return "Wi-Fi STA + BT EDR";
83 	case DEV_OPMODE_STA_BT_LE:
84 		return "Wi-Fi STA + BT LE";
85 	case DEV_OPMODE_STA_BT_DUAL:
86 		return "Wi-Fi STA + BT DUAL";
87 	case DEV_OPMODE_AP_BT:
88 		return "Wi-Fi AP + BT EDR";
89 	case DEV_OPMODE_AP_BT_DUAL:
90 		return "Wi-Fi AP + BT DUAL";
91 	}
92 
93 	return "Unknown";
94 }
95 
96 void rsi_print_version(struct rsi_common *common)
97 {
98 	rsi_dbg(ERR_ZONE, "================================================\n");
99 	rsi_dbg(ERR_ZONE, "================ RSI Version Info ==============\n");
100 	rsi_dbg(ERR_ZONE, "================================================\n");
101 	rsi_dbg(ERR_ZONE, "FW Version\t: %d.%d.%d\n",
102 		common->lmac_ver.major, common->lmac_ver.minor,
103 		common->lmac_ver.release_num);
104 	rsi_dbg(ERR_ZONE, "Operating mode\t: %d [%s]",
105 		common->oper_mode, opmode_str(common->oper_mode));
106 	rsi_dbg(ERR_ZONE, "Firmware file\t: %s", common->priv->fw_file_name);
107 	rsi_dbg(ERR_ZONE, "================================================\n");
108 }
109 
110 /**
111  * rsi_prepare_skb() - This function prepares the skb.
112  * @common: Pointer to the driver private structure.
113  * @buffer: Pointer to the packet data.
114  * @pkt_len: Length of the packet.
115  * @extended_desc: Extended descriptor.
116  *
117  * Return: Successfully skb.
118  */
119 static struct sk_buff *rsi_prepare_skb(struct rsi_common *common,
120 				       u8 *buffer,
121 				       u32 pkt_len,
122 				       u8 extended_desc)
123 {
124 	struct ieee80211_tx_info *info;
125 	struct sk_buff *skb = NULL;
126 	u8 payload_offset;
127 	struct ieee80211_vif *vif;
128 	struct ieee80211_hdr *wh;
129 
130 	if (WARN(!pkt_len, "%s: Dummy pkt received", __func__))
131 		return NULL;
132 
133 	if (pkt_len > (RSI_RCV_BUFFER_LEN * 4)) {
134 		rsi_dbg(ERR_ZONE, "%s: Pkt size > max rx buf size %d\n",
135 			__func__, pkt_len);
136 		pkt_len = RSI_RCV_BUFFER_LEN * 4;
137 	}
138 
139 	pkt_len -= extended_desc;
140 	skb = dev_alloc_skb(pkt_len + FRAME_DESC_SZ);
141 	if (skb == NULL)
142 		return NULL;
143 
144 	payload_offset = (extended_desc + FRAME_DESC_SZ);
145 	skb_put(skb, pkt_len);
146 	memcpy((skb->data), (buffer + payload_offset), skb->len);
147 	wh = (struct ieee80211_hdr *)skb->data;
148 	vif = rsi_get_vif(common->priv, wh->addr1);
149 
150 	info = IEEE80211_SKB_CB(skb);
151 	return skb;
152 }
153 
154 /**
155  * rsi_read_pkt() - This function reads frames from the card.
156  * @common: Pointer to the driver private structure.
157  * @rcv_pkt_len: Received pkt length. In case of USB it is 0.
158  *
159  * Return: 0 on success, -1 on failure.
160  */
161 int rsi_read_pkt(struct rsi_common *common, u8 *rx_pkt, s32 rcv_pkt_len)
162 {
163 	u8 *frame_desc = NULL, extended_desc = 0;
164 	u32 index, length = 0, queueno = 0;
165 	u16 actual_length = 0, offset;
166 	struct sk_buff *skb = NULL;
167 #ifdef CONFIG_RSI_COEX
168 	u8 bt_pkt_type;
169 #endif
170 
171 	index = 0;
172 	do {
173 		frame_desc = &rx_pkt[index];
174 		actual_length = *(u16 *)&frame_desc[0];
175 		offset = *(u16 *)&frame_desc[2];
176 
177 		queueno = rsi_get_queueno(frame_desc, offset);
178 		length = rsi_get_length(frame_desc, offset);
179 
180 		/* Extended descriptor is valid for WLAN queues only */
181 		if (queueno == RSI_WIFI_DATA_Q || queueno == RSI_WIFI_MGMT_Q)
182 			extended_desc = rsi_get_extended_desc(frame_desc,
183 							      offset);
184 
185 		switch (queueno) {
186 		case RSI_COEX_Q:
187 #ifdef CONFIG_RSI_COEX
188 			if (common->coex_mode > 1)
189 				rsi_coex_recv_pkt(common, frame_desc + offset);
190 			else
191 #endif
192 				rsi_mgmt_pkt_recv(common,
193 						  (frame_desc + offset));
194 			break;
195 
196 		case RSI_WIFI_DATA_Q:
197 			skb = rsi_prepare_skb(common,
198 					      (frame_desc + offset),
199 					      length,
200 					      extended_desc);
201 			if (skb == NULL)
202 				goto fail;
203 
204 			rsi_indicate_pkt_to_os(common, skb);
205 			break;
206 
207 		case RSI_WIFI_MGMT_Q:
208 			rsi_mgmt_pkt_recv(common, (frame_desc + offset));
209 			break;
210 
211 #ifdef CONFIG_RSI_COEX
212 		case RSI_BT_MGMT_Q:
213 		case RSI_BT_DATA_Q:
214 #define BT_RX_PKT_TYPE_OFST	14
215 #define BT_CARD_READY_IND	0x89
216 			bt_pkt_type = frame_desc[offset + BT_RX_PKT_TYPE_OFST];
217 			if (bt_pkt_type == BT_CARD_READY_IND) {
218 				rsi_dbg(INFO_ZONE, "BT Card ready recvd\n");
219 				if (rsi_bt_ops.attach(common, &g_proto_ops))
220 					rsi_dbg(ERR_ZONE,
221 						"Failed to attach BT module\n");
222 			} else {
223 				if (common->bt_adapter)
224 					rsi_bt_ops.recv_pkt(common->bt_adapter,
225 							frame_desc + offset);
226 			}
227 			break;
228 #endif
229 
230 		default:
231 			rsi_dbg(ERR_ZONE, "%s: pkt from invalid queue: %d\n",
232 				__func__,   queueno);
233 			goto fail;
234 		}
235 
236 		index  += actual_length;
237 		rcv_pkt_len -= actual_length;
238 	} while (rcv_pkt_len > 0);
239 
240 	return 0;
241 fail:
242 	return -EINVAL;
243 }
244 EXPORT_SYMBOL_GPL(rsi_read_pkt);
245 
246 /**
247  * rsi_tx_scheduler_thread() - This function is a kernel thread to send the
248  *			       packets to the device.
249  * @common: Pointer to the driver private structure.
250  *
251  * Return: None.
252  */
253 static void rsi_tx_scheduler_thread(struct rsi_common *common)
254 {
255 	struct rsi_hw *adapter = common->priv;
256 	u32 timeout = EVENT_WAIT_FOREVER;
257 
258 	do {
259 		if (adapter->determine_event_timeout)
260 			timeout = adapter->determine_event_timeout(adapter);
261 		rsi_wait_event(&common->tx_thread.event, timeout);
262 		rsi_reset_event(&common->tx_thread.event);
263 
264 		if (common->init_done)
265 			rsi_core_qos_processor(common);
266 	} while (atomic_read(&common->tx_thread.thread_done) == 0);
267 	complete_and_exit(&common->tx_thread.completion, 0);
268 }
269 
270 #ifdef CONFIG_RSI_COEX
271 enum rsi_host_intf rsi_get_host_intf(void *priv)
272 {
273 	struct rsi_common *common = (struct rsi_common *)priv;
274 
275 	return common->priv->rsi_host_intf;
276 }
277 
278 void rsi_set_bt_context(void *priv, void *bt_context)
279 {
280 	struct rsi_common *common = (struct rsi_common *)priv;
281 
282 	common->bt_adapter = bt_context;
283 }
284 #endif
285 
286 /**
287  * rsi_91x_init() - This function initializes os interface operations.
288  * @void: Void.
289  *
290  * Return: Pointer to the adapter structure on success, NULL on failure .
291  */
292 struct rsi_hw *rsi_91x_init(u16 oper_mode)
293 {
294 	struct rsi_hw *adapter = NULL;
295 	struct rsi_common *common = NULL;
296 	u8 ii = 0;
297 
298 	adapter = kzalloc(sizeof(*adapter), GFP_KERNEL);
299 	if (!adapter)
300 		return NULL;
301 
302 	adapter->priv = kzalloc(sizeof(*common), GFP_KERNEL);
303 	if (adapter->priv == NULL) {
304 		rsi_dbg(ERR_ZONE, "%s: Failed in allocation of memory\n",
305 			__func__);
306 		kfree(adapter);
307 		return NULL;
308 	} else {
309 		common = adapter->priv;
310 		common->priv = adapter;
311 	}
312 
313 	for (ii = 0; ii < NUM_SOFT_QUEUES; ii++)
314 		skb_queue_head_init(&common->tx_queue[ii]);
315 
316 	rsi_init_event(&common->tx_thread.event);
317 	mutex_init(&common->mutex);
318 	mutex_init(&common->tx_lock);
319 	mutex_init(&common->rx_lock);
320 	mutex_init(&common->tx_bus_mutex);
321 
322 	if (rsi_create_kthread(common,
323 			       &common->tx_thread,
324 			       rsi_tx_scheduler_thread,
325 			       "Tx-Thread")) {
326 		rsi_dbg(ERR_ZONE, "%s: Unable to init tx thrd\n", __func__);
327 		goto err;
328 	}
329 
330 	rsi_default_ps_params(adapter);
331 	init_bgscan_params(common);
332 	spin_lock_init(&adapter->ps_lock);
333 	timer_setup(&common->roc_timer, rsi_roc_timeout, 0);
334 	init_completion(&common->wlan_init_completion);
335 	adapter->device_model = RSI_DEV_9113;
336 	common->oper_mode = oper_mode;
337 
338 	/* Determine coex mode */
339 	switch (common->oper_mode) {
340 	case DEV_OPMODE_STA_BT_DUAL:
341 	case DEV_OPMODE_STA_BT:
342 	case DEV_OPMODE_STA_BT_LE:
343 	case DEV_OPMODE_BT_ALONE:
344 	case DEV_OPMODE_BT_LE_ALONE:
345 	case DEV_OPMODE_BT_DUAL:
346 		common->coex_mode = 2;
347 		break;
348 	case DEV_OPMODE_AP_BT_DUAL:
349 	case DEV_OPMODE_AP_BT:
350 		common->coex_mode = 4;
351 		break;
352 	case DEV_OPMODE_WIFI_ALONE:
353 		common->coex_mode = 1;
354 		break;
355 	default:
356 		common->oper_mode = 1;
357 		common->coex_mode = 1;
358 	}
359 	rsi_dbg(INFO_ZONE, "%s: oper_mode = %d, coex_mode = %d\n",
360 		__func__, common->oper_mode, common->coex_mode);
361 
362 	adapter->device_model = RSI_DEV_9113;
363 #ifdef CONFIG_RSI_COEX
364 	if (common->coex_mode > 1) {
365 		if (rsi_coex_attach(common)) {
366 			rsi_dbg(ERR_ZONE, "Failed to init coex module\n");
367 			goto err;
368 		}
369 	}
370 #endif
371 
372 	common->init_done = true;
373 	return adapter;
374 
375 err:
376 	kfree(common);
377 	kfree(adapter);
378 	return NULL;
379 }
380 EXPORT_SYMBOL_GPL(rsi_91x_init);
381 
382 /**
383  * rsi_91x_deinit() - This function de-intializes os intf operations.
384  * @adapter: Pointer to the adapter structure.
385  *
386  * Return: None.
387  */
388 void rsi_91x_deinit(struct rsi_hw *adapter)
389 {
390 	struct rsi_common *common = adapter->priv;
391 	u8 ii;
392 
393 	rsi_dbg(INFO_ZONE, "%s: Performing deinit os ops\n", __func__);
394 
395 	rsi_kill_thread(&common->tx_thread);
396 
397 	for (ii = 0; ii < NUM_SOFT_QUEUES; ii++)
398 		skb_queue_purge(&common->tx_queue[ii]);
399 
400 #ifdef CONFIG_RSI_COEX
401 	if (common->coex_mode > 1) {
402 		if (common->bt_adapter) {
403 			rsi_bt_ops.detach(common->bt_adapter);
404 			common->bt_adapter = NULL;
405 		}
406 		rsi_coex_detach(common);
407 	}
408 #endif
409 
410 	common->init_done = false;
411 
412 	kfree(common);
413 	kfree(adapter->rsi_dev);
414 	kfree(adapter);
415 }
416 EXPORT_SYMBOL_GPL(rsi_91x_deinit);
417 
418 /**
419  * rsi_91x_hal_module_init() - This function is invoked when the module is
420  *			       loaded into the kernel.
421  *			       It registers the client driver.
422  * @void: Void.
423  *
424  * Return: 0 on success, -1 on failure.
425  */
426 static int rsi_91x_hal_module_init(void)
427 {
428 	rsi_dbg(INIT_ZONE, "%s: Module init called\n", __func__);
429 	return 0;
430 }
431 
432 /**
433  * rsi_91x_hal_module_exit() - This function is called at the time of
434  *			       removing/unloading the module.
435  *			       It unregisters the client driver.
436  * @void: Void.
437  *
438  * Return: None.
439  */
440 static void rsi_91x_hal_module_exit(void)
441 {
442 	rsi_dbg(INIT_ZONE, "%s: Module exit called\n", __func__);
443 }
444 
445 module_init(rsi_91x_hal_module_init);
446 module_exit(rsi_91x_hal_module_exit);
447 MODULE_AUTHOR("Redpine Signals Inc");
448 MODULE_DESCRIPTION("Station driver for RSI 91x devices");
449 MODULE_SUPPORTED_DEVICE("RSI-91x");
450 MODULE_VERSION("0.1");
451 MODULE_LICENSE("Dual BSD/GPL");
452