xref: /linux/drivers/net/wireless/silabs/wfx/main.c (revision dd093fb0)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Device probe and register.
4  *
5  * Copyright (c) 2017-2020, Silicon Laboratories, Inc.
6  * Copyright (c) 2010, ST-Ericsson
7  * Copyright (c) 2008, Johannes Berg <johannes@sipsolutions.net>
8  * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
9  * Copyright (c) 2007-2009, Christian Lamparter <chunkeey@web.de>
10  * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>
11  * Copyright (c) 2004-2006 Jean-Baptiste Note <jbnote@gmail.com>, et al.
12  */
13 #include <linux/module.h>
14 #include <linux/of.h>
15 #include <linux/of_net.h>
16 #include <linux/gpio/consumer.h>
17 #include <linux/mmc/sdio_func.h>
18 #include <linux/spi/spi.h>
19 #include <linux/etherdevice.h>
20 #include <linux/firmware.h>
21 
22 #include "main.h"
23 #include "wfx.h"
24 #include "fwio.h"
25 #include "hwio.h"
26 #include "bus.h"
27 #include "bh.h"
28 #include "sta.h"
29 #include "key.h"
30 #include "scan.h"
31 #include "debug.h"
32 #include "data_tx.h"
33 #include "hif_tx_mib.h"
34 #include "hif_api_cmd.h"
35 
36 #define WFX_PDS_TLV_TYPE 0x4450 // "PD" (Platform Data) in ascii little-endian
37 #define WFX_PDS_MAX_CHUNK_SIZE 1500
38 
39 MODULE_DESCRIPTION("Silicon Labs 802.11 Wireless LAN driver for WF200");
40 MODULE_AUTHOR("Jérôme Pouiller <jerome.pouiller@silabs.com>");
41 MODULE_LICENSE("GPL");
42 
43 #define RATETAB_ENT(_rate, _rateid, _flags) { \
44 	.bitrate  = (_rate),   \
45 	.hw_value = (_rateid), \
46 	.flags    = (_flags),  \
47 }
48 
49 static struct ieee80211_rate wfx_rates[] = {
50 	RATETAB_ENT(10,  0,  0),
51 	RATETAB_ENT(20,  1,  IEEE80211_RATE_SHORT_PREAMBLE),
52 	RATETAB_ENT(55,  2,  IEEE80211_RATE_SHORT_PREAMBLE),
53 	RATETAB_ENT(110, 3,  IEEE80211_RATE_SHORT_PREAMBLE),
54 	RATETAB_ENT(60,  6,  0),
55 	RATETAB_ENT(90,  7,  0),
56 	RATETAB_ENT(120, 8,  0),
57 	RATETAB_ENT(180, 9,  0),
58 	RATETAB_ENT(240, 10, 0),
59 	RATETAB_ENT(360, 11, 0),
60 	RATETAB_ENT(480, 12, 0),
61 	RATETAB_ENT(540, 13, 0),
62 };
63 
64 #define CHAN2G(_channel, _freq, _flags) { \
65 	.band = NL80211_BAND_2GHZ, \
66 	.center_freq = (_freq),    \
67 	.hw_value = (_channel),    \
68 	.flags = (_flags),         \
69 	.max_antenna_gain = 0,     \
70 	.max_power = 30,           \
71 }
72 
73 static struct ieee80211_channel wfx_2ghz_chantable[] = {
74 	CHAN2G(1,  2412, 0),
75 	CHAN2G(2,  2417, 0),
76 	CHAN2G(3,  2422, 0),
77 	CHAN2G(4,  2427, 0),
78 	CHAN2G(5,  2432, 0),
79 	CHAN2G(6,  2437, 0),
80 	CHAN2G(7,  2442, 0),
81 	CHAN2G(8,  2447, 0),
82 	CHAN2G(9,  2452, 0),
83 	CHAN2G(10, 2457, 0),
84 	CHAN2G(11, 2462, 0),
85 	CHAN2G(12, 2467, 0),
86 	CHAN2G(13, 2472, 0),
87 	CHAN2G(14, 2484, 0),
88 };
89 
90 static const struct ieee80211_supported_band wfx_band_2ghz = {
91 	.channels = wfx_2ghz_chantable,
92 	.n_channels = ARRAY_SIZE(wfx_2ghz_chantable),
93 	.bitrates = wfx_rates,
94 	.n_bitrates = ARRAY_SIZE(wfx_rates),
95 	.ht_cap = {
96 		/* Receive caps */
97 		.cap = IEEE80211_HT_CAP_GRN_FLD | IEEE80211_HT_CAP_SGI_20 |
98 		       IEEE80211_HT_CAP_MAX_AMSDU | (1 << IEEE80211_HT_CAP_RX_STBC_SHIFT),
99 		.ht_supported = 1,
100 		.ampdu_factor = IEEE80211_HT_MAX_AMPDU_16K,
101 		.ampdu_density = IEEE80211_HT_MPDU_DENSITY_NONE,
102 		.mcs = {
103 			.rx_mask = { 0xFF }, /* MCS0 to MCS7 */
104 			.rx_highest = cpu_to_le16(72),
105 			.tx_params = IEEE80211_HT_MCS_TX_DEFINED,
106 		},
107 	},
108 };
109 
110 static const struct ieee80211_iface_limit wdev_iface_limits[] = {
111 	{ .max = 1, .types = BIT(NL80211_IFTYPE_STATION) },
112 	{ .max = 1, .types = BIT(NL80211_IFTYPE_AP) },
113 };
114 
115 static const struct ieee80211_iface_combination wfx_iface_combinations[] = {
116 	{
117 		.num_different_channels = 2,
118 		.max_interfaces = 2,
119 		.limits = wdev_iface_limits,
120 		.n_limits = ARRAY_SIZE(wdev_iface_limits),
121 	}
122 };
123 
124 static const struct ieee80211_ops wfx_ops = {
125 	.start                   = wfx_start,
126 	.stop                    = wfx_stop,
127 	.add_interface           = wfx_add_interface,
128 	.remove_interface        = wfx_remove_interface,
129 	.config                  = wfx_config,
130 	.tx                      = wfx_tx,
131 	.wake_tx_queue           = ieee80211_handle_wake_tx_queue,
132 	.join_ibss               = wfx_join_ibss,
133 	.leave_ibss              = wfx_leave_ibss,
134 	.conf_tx                 = wfx_conf_tx,
135 	.hw_scan                 = wfx_hw_scan,
136 	.cancel_hw_scan          = wfx_cancel_hw_scan,
137 	.start_ap                = wfx_start_ap,
138 	.stop_ap                 = wfx_stop_ap,
139 	.sta_add                 = wfx_sta_add,
140 	.sta_remove              = wfx_sta_remove,
141 	.set_tim                 = wfx_set_tim,
142 	.set_key                 = wfx_set_key,
143 	.set_rts_threshold       = wfx_set_rts_threshold,
144 	.set_default_unicast_key = wfx_set_default_unicast_key,
145 	.bss_info_changed        = wfx_bss_info_changed,
146 	.configure_filter        = wfx_configure_filter,
147 	.ampdu_action            = wfx_ampdu_action,
148 	.flush                   = wfx_flush,
149 	.add_chanctx             = wfx_add_chanctx,
150 	.remove_chanctx          = wfx_remove_chanctx,
151 	.change_chanctx          = wfx_change_chanctx,
152 	.assign_vif_chanctx      = wfx_assign_vif_chanctx,
153 	.unassign_vif_chanctx    = wfx_unassign_vif_chanctx,
154 };
155 
156 bool wfx_api_older_than(struct wfx_dev *wdev, int major, int minor)
157 {
158 	if (wdev->hw_caps.api_version_major < major)
159 		return true;
160 	if (wdev->hw_caps.api_version_major > major)
161 		return false;
162 	if (wdev->hw_caps.api_version_minor < minor)
163 		return true;
164 	return false;
165 }
166 
167 /* The device needs data about the antenna configuration. This information in provided by PDS
168  * (Platform Data Set, this is the wording used in WF200 documentation) files. For hardware
169  * integrators, the full process to create PDS files is described here:
170  *   https://github.com/SiliconLabs/wfx-firmware/blob/master/PDS/README.md
171  *
172  * The PDS file is an array of Time-Length-Value structs.
173  */
174 int wfx_send_pds(struct wfx_dev *wdev, u8 *buf, size_t len)
175 {
176 	int ret, chunk_type, chunk_len, chunk_num = 0;
177 
178 	if (*buf == '{') {
179 		dev_err(wdev->dev, "PDS: malformed file (legacy format?)\n");
180 		return -EINVAL;
181 	}
182 	while (len > 0) {
183 		chunk_type = get_unaligned_le16(buf + 0);
184 		chunk_len = get_unaligned_le16(buf + 2);
185 		if (chunk_len < 4 || chunk_len > len) {
186 			dev_err(wdev->dev, "PDS:%d: corrupted file\n", chunk_num);
187 			return -EINVAL;
188 		}
189 		if (chunk_type != WFX_PDS_TLV_TYPE) {
190 			dev_info(wdev->dev, "PDS:%d: skip unknown data\n", chunk_num);
191 			goto next;
192 		}
193 		if (chunk_len > WFX_PDS_MAX_CHUNK_SIZE)
194 			dev_warn(wdev->dev, "PDS:%d: unexpectedly large chunk\n", chunk_num);
195 		if (buf[4] != '{' || buf[chunk_len - 1] != '}')
196 			dev_warn(wdev->dev, "PDS:%d: unexpected content\n", chunk_num);
197 
198 		ret = wfx_hif_configuration(wdev, buf + 4, chunk_len - 4);
199 		if (ret > 0) {
200 			dev_err(wdev->dev, "PDS:%d: invalid data (unsupported options?)\n", chunk_num);
201 			return -EINVAL;
202 		}
203 		if (ret == -ETIMEDOUT) {
204 			dev_err(wdev->dev, "PDS:%d: chip didn't reply (corrupted file?)\n", chunk_num);
205 			return ret;
206 		}
207 		if (ret) {
208 			dev_err(wdev->dev, "PDS:%d: chip returned an unknown error\n", chunk_num);
209 			return -EIO;
210 		}
211 next:
212 		chunk_num++;
213 		len -= chunk_len;
214 		buf += chunk_len;
215 	}
216 	return 0;
217 }
218 
219 static int wfx_send_pdata_pds(struct wfx_dev *wdev)
220 {
221 	int ret = 0;
222 	const struct firmware *pds;
223 	u8 *tmp_buf;
224 
225 	ret = request_firmware(&pds, wdev->pdata.file_pds, wdev->dev);
226 	if (ret) {
227 		dev_err(wdev->dev, "can't load antenna parameters (PDS file %s). The device may be unstable.\n",
228 			wdev->pdata.file_pds);
229 		return ret;
230 	}
231 	tmp_buf = kmemdup(pds->data, pds->size, GFP_KERNEL);
232 	if (!tmp_buf) {
233 		ret = -ENOMEM;
234 		goto release_fw;
235 	}
236 	ret = wfx_send_pds(wdev, tmp_buf, pds->size);
237 	kfree(tmp_buf);
238 release_fw:
239 	release_firmware(pds);
240 	return ret;
241 }
242 
243 static void wfx_free_common(void *data)
244 {
245 	struct wfx_dev *wdev = data;
246 
247 	mutex_destroy(&wdev->tx_power_loop_info_lock);
248 	mutex_destroy(&wdev->rx_stats_lock);
249 	mutex_destroy(&wdev->conf_mutex);
250 	ieee80211_free_hw(wdev->hw);
251 }
252 
253 struct wfx_dev *wfx_init_common(struct device *dev, const struct wfx_platform_data *pdata,
254 				const struct wfx_hwbus_ops *hwbus_ops, void *hwbus_priv)
255 {
256 	struct ieee80211_hw *hw;
257 	struct wfx_dev *wdev;
258 
259 	hw = ieee80211_alloc_hw(sizeof(struct wfx_dev), &wfx_ops);
260 	if (!hw)
261 		return NULL;
262 
263 	SET_IEEE80211_DEV(hw, dev);
264 
265 	ieee80211_hw_set(hw, TX_AMPDU_SETUP_IN_HW);
266 	ieee80211_hw_set(hw, AMPDU_AGGREGATION);
267 	ieee80211_hw_set(hw, CONNECTION_MONITOR);
268 	ieee80211_hw_set(hw, REPORTS_TX_ACK_STATUS);
269 	ieee80211_hw_set(hw, SUPPORTS_DYNAMIC_PS);
270 	ieee80211_hw_set(hw, SIGNAL_DBM);
271 	ieee80211_hw_set(hw, SUPPORTS_PS);
272 	ieee80211_hw_set(hw, MFP_CAPABLE);
273 
274 	hw->vif_data_size = sizeof(struct wfx_vif);
275 	hw->sta_data_size = sizeof(struct wfx_sta_priv);
276 	hw->queues = 4;
277 	hw->max_rates = 8;
278 	hw->max_rate_tries = 8;
279 	hw->extra_tx_headroom = sizeof(struct wfx_hif_msg) + sizeof(struct wfx_hif_req_tx) +
280 				4 /* alignment */ + 8 /* TKIP IV */;
281 	hw->wiphy->interface_modes = BIT(NL80211_IFTYPE_STATION) |
282 				     BIT(NL80211_IFTYPE_ADHOC) |
283 				     BIT(NL80211_IFTYPE_AP);
284 	hw->wiphy->probe_resp_offload = NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS |
285 					NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS2 |
286 					NL80211_PROBE_RESP_OFFLOAD_SUPPORT_P2P |
287 					NL80211_PROBE_RESP_OFFLOAD_SUPPORT_80211U;
288 	hw->wiphy->features |= NL80211_FEATURE_AP_SCAN;
289 	hw->wiphy->flags |= WIPHY_FLAG_AP_PROBE_RESP_OFFLOAD;
290 	hw->wiphy->flags |= WIPHY_FLAG_AP_UAPSD;
291 	hw->wiphy->max_ap_assoc_sta = HIF_LINK_ID_MAX;
292 	hw->wiphy->max_scan_ssids = 2;
293 	hw->wiphy->max_scan_ie_len = IEEE80211_MAX_DATA_LEN;
294 	hw->wiphy->n_iface_combinations = ARRAY_SIZE(wfx_iface_combinations);
295 	hw->wiphy->iface_combinations = wfx_iface_combinations;
296 	hw->wiphy->bands[NL80211_BAND_2GHZ] = devm_kmalloc(dev, sizeof(wfx_band_2ghz), GFP_KERNEL);
297 	if (!hw->wiphy->bands[NL80211_BAND_2GHZ])
298 		goto err;
299 
300 	/* FIXME: also copy wfx_rates and wfx_2ghz_chantable */
301 	memcpy(hw->wiphy->bands[NL80211_BAND_2GHZ], &wfx_band_2ghz, sizeof(wfx_band_2ghz));
302 
303 	wdev = hw->priv;
304 	wdev->hw = hw;
305 	wdev->dev = dev;
306 	wdev->hwbus_ops = hwbus_ops;
307 	wdev->hwbus_priv = hwbus_priv;
308 	memcpy(&wdev->pdata, pdata, sizeof(*pdata));
309 	of_property_read_string(dev->of_node, "silabs,antenna-config-file", &wdev->pdata.file_pds);
310 	wdev->pdata.gpio_wakeup = devm_gpiod_get_optional(dev, "wakeup", GPIOD_OUT_LOW);
311 	if (IS_ERR(wdev->pdata.gpio_wakeup))
312 		goto err;
313 
314 	if (wdev->pdata.gpio_wakeup)
315 		gpiod_set_consumer_name(wdev->pdata.gpio_wakeup, "wfx wakeup");
316 
317 	mutex_init(&wdev->conf_mutex);
318 	mutex_init(&wdev->rx_stats_lock);
319 	mutex_init(&wdev->tx_power_loop_info_lock);
320 	init_completion(&wdev->firmware_ready);
321 	INIT_DELAYED_WORK(&wdev->cooling_timeout_work, wfx_cooling_timeout_work);
322 	skb_queue_head_init(&wdev->tx_pending);
323 	init_waitqueue_head(&wdev->tx_dequeue);
324 	wfx_init_hif_cmd(&wdev->hif_cmd);
325 
326 	if (devm_add_action_or_reset(dev, wfx_free_common, wdev))
327 		return NULL;
328 
329 	return wdev;
330 
331 err:
332 	ieee80211_free_hw(hw);
333 	return NULL;
334 }
335 
336 int wfx_probe(struct wfx_dev *wdev)
337 {
338 	int i;
339 	int err;
340 	struct gpio_desc *gpio_saved;
341 
342 	/* During first part of boot, gpio_wakeup cannot yet been used. So prevent bh() to touch
343 	 * it.
344 	 */
345 	gpio_saved = wdev->pdata.gpio_wakeup;
346 	wdev->pdata.gpio_wakeup = NULL;
347 	wdev->poll_irq = true;
348 
349 	wdev->bh_wq = alloc_workqueue("wfx_bh_wq", WQ_HIGHPRI, 0);
350 	if (!wdev->bh_wq)
351 		return -ENOMEM;
352 
353 	wfx_bh_register(wdev);
354 
355 	err = wfx_init_device(wdev);
356 	if (err)
357 		goto bh_unregister;
358 
359 	wfx_bh_poll_irq(wdev);
360 	err = wait_for_completion_timeout(&wdev->firmware_ready, 1 * HZ);
361 	if (err <= 0) {
362 		if (err == 0) {
363 			dev_err(wdev->dev, "timeout while waiting for startup indication\n");
364 			err = -ETIMEDOUT;
365 		} else if (err == -ERESTARTSYS) {
366 			dev_info(wdev->dev, "probe interrupted by user\n");
367 		}
368 		goto bh_unregister;
369 	}
370 
371 	/* FIXME: fill wiphy::hw_version */
372 	dev_info(wdev->dev, "started firmware %d.%d.%d \"%s\" (API: %d.%d, keyset: %02X, caps: 0x%.8X)\n",
373 		 wdev->hw_caps.firmware_major, wdev->hw_caps.firmware_minor,
374 		 wdev->hw_caps.firmware_build, wdev->hw_caps.firmware_label,
375 		 wdev->hw_caps.api_version_major, wdev->hw_caps.api_version_minor,
376 		 wdev->keyset, wdev->hw_caps.link_mode);
377 	snprintf(wdev->hw->wiphy->fw_version,
378 		 sizeof(wdev->hw->wiphy->fw_version),
379 		 "%d.%d.%d",
380 		 wdev->hw_caps.firmware_major,
381 		 wdev->hw_caps.firmware_minor,
382 		 wdev->hw_caps.firmware_build);
383 
384 	if (wfx_api_older_than(wdev, 1, 0)) {
385 		dev_err(wdev->dev, "unsupported firmware API version (expect 1 while firmware returns %d)\n",
386 			wdev->hw_caps.api_version_major);
387 		err = -EOPNOTSUPP;
388 		goto bh_unregister;
389 	}
390 
391 	if (wdev->hw_caps.link_mode == SEC_LINK_ENFORCED) {
392 		dev_err(wdev->dev, "chip require secure_link, but can't negotiate it\n");
393 		goto bh_unregister;
394 	}
395 
396 	if (wdev->hw_caps.region_sel_mode) {
397 		wdev->hw->wiphy->regulatory_flags |= REGULATORY_DISABLE_BEACON_HINTS;
398 		wdev->hw->wiphy->bands[NL80211_BAND_2GHZ]->channels[11].flags |=
399 			IEEE80211_CHAN_NO_IR;
400 		wdev->hw->wiphy->bands[NL80211_BAND_2GHZ]->channels[12].flags |=
401 			IEEE80211_CHAN_NO_IR;
402 		wdev->hw->wiphy->bands[NL80211_BAND_2GHZ]->channels[13].flags |=
403 			IEEE80211_CHAN_DISABLED;
404 	}
405 
406 	dev_dbg(wdev->dev, "sending configuration file %s\n", wdev->pdata.file_pds);
407 	err = wfx_send_pdata_pds(wdev);
408 	if (err < 0 && err != -ENOENT)
409 		goto bh_unregister;
410 
411 	wdev->poll_irq = false;
412 	err = wdev->hwbus_ops->irq_subscribe(wdev->hwbus_priv);
413 	if (err)
414 		goto bh_unregister;
415 
416 	err = wfx_hif_use_multi_tx_conf(wdev, true);
417 	if (err)
418 		dev_err(wdev->dev, "misconfigured IRQ?\n");
419 
420 	wdev->pdata.gpio_wakeup = gpio_saved;
421 	if (wdev->pdata.gpio_wakeup) {
422 		dev_dbg(wdev->dev, "enable 'quiescent' power mode with wakeup GPIO and PDS file %s\n",
423 			wdev->pdata.file_pds);
424 		gpiod_set_value_cansleep(wdev->pdata.gpio_wakeup, 1);
425 		wfx_control_reg_write(wdev, 0);
426 		wfx_hif_set_operational_mode(wdev, HIF_OP_POWER_MODE_QUIESCENT);
427 	} else {
428 		wfx_hif_set_operational_mode(wdev, HIF_OP_POWER_MODE_DOZE);
429 	}
430 
431 	for (i = 0; i < ARRAY_SIZE(wdev->addresses); i++) {
432 		eth_zero_addr(wdev->addresses[i].addr);
433 		err = of_get_mac_address(wdev->dev->of_node, wdev->addresses[i].addr);
434 		if (!err)
435 			wdev->addresses[i].addr[ETH_ALEN - 1] += i;
436 		else
437 			ether_addr_copy(wdev->addresses[i].addr, wdev->hw_caps.mac_addr[i]);
438 		if (!is_valid_ether_addr(wdev->addresses[i].addr)) {
439 			dev_warn(wdev->dev, "using random MAC address\n");
440 			eth_random_addr(wdev->addresses[i].addr);
441 		}
442 		dev_info(wdev->dev, "MAC address %d: %pM\n", i, wdev->addresses[i].addr);
443 	}
444 	wdev->hw->wiphy->n_addresses = ARRAY_SIZE(wdev->addresses);
445 	wdev->hw->wiphy->addresses = wdev->addresses;
446 
447 	if (!wfx_api_older_than(wdev, 3, 8))
448 		wdev->hw->wiphy->flags |= WIPHY_FLAG_SUPPORTS_TDLS;
449 
450 	err = ieee80211_register_hw(wdev->hw);
451 	if (err)
452 		goto irq_unsubscribe;
453 
454 	err = wfx_debug_init(wdev);
455 	if (err)
456 		goto ieee80211_unregister;
457 
458 	return 0;
459 
460 ieee80211_unregister:
461 	ieee80211_unregister_hw(wdev->hw);
462 irq_unsubscribe:
463 	wdev->hwbus_ops->irq_unsubscribe(wdev->hwbus_priv);
464 bh_unregister:
465 	wfx_bh_unregister(wdev);
466 	destroy_workqueue(wdev->bh_wq);
467 	return err;
468 }
469 
470 void wfx_release(struct wfx_dev *wdev)
471 {
472 	ieee80211_unregister_hw(wdev->hw);
473 	wfx_hif_shutdown(wdev);
474 	wdev->hwbus_ops->irq_unsubscribe(wdev->hwbus_priv);
475 	wfx_bh_unregister(wdev);
476 	destroy_workqueue(wdev->bh_wq);
477 }
478 
479 static int __init wfx_core_init(void)
480 {
481 	int ret = 0;
482 
483 	if (IS_ENABLED(CONFIG_SPI))
484 		ret = spi_register_driver(&wfx_spi_driver);
485 	if (IS_ENABLED(CONFIG_MMC) && !ret)
486 		ret = sdio_register_driver(&wfx_sdio_driver);
487 	return ret;
488 }
489 module_init(wfx_core_init);
490 
491 static void __exit wfx_core_exit(void)
492 {
493 	if (IS_ENABLED(CONFIG_MMC))
494 		sdio_unregister_driver(&wfx_sdio_driver);
495 	if (IS_ENABLED(CONFIG_SPI))
496 		spi_unregister_driver(&wfx_spi_driver);
497 }
498 module_exit(wfx_core_exit);
499