1 // SPDX-License-Identifier: GPL-2.0-only
3 * Device probe and register.
5 * Copyright (c) 2017-2019, Silicon Laboratories, Inc.
6 * Copyright (c) 2010, ST-Ericsson
8 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
13 #include <linux/module.h>
15 #include <linux/of_net.h>
16 #include <linux/gpio.h>
17 #include <linux/gpio/consumer.h>
18 #include <linux/mmc/sdio_func.h>
19 #include <linux/spi/spi.h>
20 #include <linux/etherdevice.h>
21 #include <linux/firmware.h>
33 #include "secure_link.h"
34 #include "hif_tx_mib.h"
35 #include "hif_api_cmd.h"
37 #define WFX_PDS_MAX_SIZE 1500
39 MODULE_DESCRIPTION("Silicon Labs 802.11 Wireless LAN driver for WFx");
41 MODULE_LICENSE("GPL");
43 static int gpio_wakeup = -2;
44 module_param(gpio_wakeup, int, 0644);
45 MODULE_PARM_DESC(gpio_wakeup, "gpio number for wakeup. -1 for none.");
47 #define RATETAB_ENT(_rate, _rateid, _flags) { \
49 .hw_value = (_rateid), \
53 static struct ieee80211_rate wfx_rates[] = {
54 RATETAB_ENT(10, 0, 0),
55 RATETAB_ENT(20, 1, IEEE80211_RATE_SHORT_PREAMBLE),
56 RATETAB_ENT(55, 2, IEEE80211_RATE_SHORT_PREAMBLE),
57 RATETAB_ENT(110, 3, IEEE80211_RATE_SHORT_PREAMBLE),
58 RATETAB_ENT(60, 6, 0),
59 RATETAB_ENT(90, 7, 0),
60 RATETAB_ENT(120, 8, 0),
61 RATETAB_ENT(180, 9, 0),
62 RATETAB_ENT(240, 10, 0),
63 RATETAB_ENT(360, 11, 0),
64 RATETAB_ENT(480, 12, 0),
65 RATETAB_ENT(540, 13, 0),
68 #define CHAN2G(_channel, _freq, _flags) { \
69 .band = NL80211_BAND_2GHZ, \
70 .center_freq = (_freq), \
71 .hw_value = (_channel), \
73 .max_antenna_gain = 0, \
77 static struct ieee80211_channel wfx_2ghz_chantable[] = {
94 static const struct ieee80211_supported_band wfx_band_2ghz = {
95 .channels = wfx_2ghz_chantable,
96 .n_channels = ARRAY_SIZE(wfx_2ghz_chantable),
97 .bitrates = wfx_rates,
98 .n_bitrates = ARRAY_SIZE(wfx_rates),
101 .cap = IEEE80211_HT_CAP_GRN_FLD | IEEE80211_HT_CAP_SGI_20 |
102 IEEE80211_HT_CAP_MAX_AMSDU |
103 (1 << IEEE80211_HT_CAP_RX_STBC_SHIFT),
105 .ampdu_factor = IEEE80211_HT_MAX_AMPDU_16K,
106 .ampdu_density = IEEE80211_HT_MPDU_DENSITY_NONE,
108 .rx_mask = { 0xFF }, // MCS0 to MCS7
110 .tx_params = IEEE80211_HT_MCS_TX_DEFINED,
115 static const struct ieee80211_iface_limit wdev_iface_limits[] = {
116 { .max = 1, .types = BIT(NL80211_IFTYPE_STATION) },
117 { .max = 1, .types = BIT(NL80211_IFTYPE_AP) },
120 static const struct ieee80211_iface_combination wfx_iface_combinations[] = {
122 .num_different_channels = 2,
124 .limits = wdev_iface_limits,
125 .n_limits = ARRAY_SIZE(wdev_iface_limits),
129 static const struct ieee80211_ops wfx_ops = {
132 .add_interface = wfx_add_interface,
133 .remove_interface = wfx_remove_interface,
134 .config = wfx_config,
136 .conf_tx = wfx_conf_tx,
137 .hw_scan = wfx_hw_scan,
138 .cancel_hw_scan = wfx_cancel_hw_scan,
139 .sta_add = wfx_sta_add,
140 .sta_remove = wfx_sta_remove,
141 .sta_notify = wfx_sta_notify,
142 .set_tim = wfx_set_tim,
143 .set_key = wfx_set_key,
144 .set_rts_threshold = wfx_set_rts_threshold,
145 .bss_info_changed = wfx_bss_info_changed,
146 .prepare_multicast = wfx_prepare_multicast,
147 .configure_filter = wfx_configure_filter,
148 .ampdu_action = wfx_ampdu_action,
150 .add_chanctx = wfx_add_chanctx,
151 .remove_chanctx = wfx_remove_chanctx,
152 .change_chanctx = wfx_change_chanctx,
153 .assign_vif_chanctx = wfx_assign_vif_chanctx,
154 .unassign_vif_chanctx = wfx_unassign_vif_chanctx,
157 bool wfx_api_older_than(struct wfx_dev *wdev, int major, int minor)
159 if (wdev->hw_caps.api_version_major < major)
161 if (wdev->hw_caps.api_version_major > major)
163 if (wdev->hw_caps.api_version_minor < minor)
168 struct gpio_desc *wfx_get_gpio(struct device *dev, int override,
171 struct gpio_desc *ret;
175 snprintf(label_buf, sizeof(label_buf), "wfx_%s", label);
176 ret = ERR_PTR(devm_gpio_request_one(dev, override,
180 ret = gpio_to_desc(override);
181 } else if (override == -1) {
184 ret = devm_gpiod_get(dev, label, GPIOD_OUT_LOW);
186 if (IS_ERR_OR_NULL(ret)) {
187 if (!ret || PTR_ERR(ret) == -ENOENT)
188 dev_warn(dev, "gpio %s is not defined\n", label);
191 "error while requesting gpio %s\n", label);
195 "using gpio %d for %s\n", desc_to_gpio(ret), label);
200 /* NOTE: wfx_send_pds() destroy buf */
201 int wfx_send_pds(struct wfx_dev *wdev, unsigned char *buf, size_t len)
204 int start, brace_level, i;
209 dev_err(wdev->dev, "valid PDS start with '{'. Did you forget to compress it?\n");
212 for (i = 1; i < len - 1; i++) {
217 if (buf[i] == '}' && !brace_level) {
219 if (i - start + 1 > WFX_PDS_MAX_SIZE)
223 dev_dbg(wdev->dev, "send PDS '%s}'\n", buf + start);
225 ret = hif_configuration(wdev, buf + start,
227 if (ret == HIF_STATUS_FAILURE) {
228 dev_err(wdev->dev, "PDS bytes %d to %d: invalid data (unsupported options?)\n", start, i);
231 if (ret == -ETIMEDOUT) {
232 dev_err(wdev->dev, "PDS bytes %d to %d: chip didn't reply (corrupted file?)\n", start, i);
236 dev_err(wdev->dev, "PDS bytes %d to %d: chip returned an unknown error\n", start, i);
246 static int wfx_send_pdata_pds(struct wfx_dev *wdev)
249 const struct firmware *pds;
250 unsigned char *tmp_buf;
252 ret = request_firmware(&pds, wdev->pdata.file_pds, wdev->dev);
254 dev_err(wdev->dev, "can't load PDS file %s\n",
255 wdev->pdata.file_pds);
258 tmp_buf = kmemdup(pds->data, pds->size, GFP_KERNEL);
259 ret = wfx_send_pds(wdev, tmp_buf, pds->size);
261 release_firmware(pds);
265 struct wfx_dev *wfx_init_common(struct device *dev,
266 const struct wfx_platform_data *pdata,
267 const struct hwbus_ops *hwbus_ops,
270 struct ieee80211_hw *hw;
271 struct wfx_dev *wdev;
273 hw = ieee80211_alloc_hw(sizeof(struct wfx_dev), &wfx_ops);
277 SET_IEEE80211_DEV(hw, dev);
279 ieee80211_hw_set(hw, NEED_DTIM_BEFORE_ASSOC);
280 ieee80211_hw_set(hw, TX_AMPDU_SETUP_IN_HW);
281 ieee80211_hw_set(hw, AMPDU_AGGREGATION);
282 ieee80211_hw_set(hw, CONNECTION_MONITOR);
283 ieee80211_hw_set(hw, REPORTS_TX_ACK_STATUS);
284 ieee80211_hw_set(hw, SUPPORTS_DYNAMIC_PS);
285 ieee80211_hw_set(hw, SIGNAL_DBM);
286 ieee80211_hw_set(hw, SUPPORTS_PS);
287 ieee80211_hw_set(hw, MFP_CAPABLE);
289 hw->vif_data_size = sizeof(struct wfx_vif);
290 hw->sta_data_size = sizeof(struct wfx_sta_priv);
293 hw->max_rate_tries = 8;
294 hw->extra_tx_headroom = sizeof(struct hif_sl_msg_hdr) +
295 sizeof(struct hif_msg)
296 + sizeof(struct hif_req_tx)
297 + 4 /* alignment */ + 8 /* TKIP IV */;
298 hw->wiphy->interface_modes = BIT(NL80211_IFTYPE_STATION) |
299 BIT(NL80211_IFTYPE_ADHOC) |
300 BIT(NL80211_IFTYPE_AP);
301 hw->wiphy->probe_resp_offload = NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS |
302 NL80211_PROBE_RESP_OFFLOAD_SUPPORT_WPS2 |
303 NL80211_PROBE_RESP_OFFLOAD_SUPPORT_P2P |
304 NL80211_PROBE_RESP_OFFLOAD_SUPPORT_80211U;
305 hw->wiphy->flags |= WIPHY_FLAG_AP_PROBE_RESP_OFFLOAD;
306 hw->wiphy->flags |= WIPHY_FLAG_AP_UAPSD;
307 hw->wiphy->flags &= ~WIPHY_FLAG_PS_ON_BY_DEFAULT;
308 hw->wiphy->max_ap_assoc_sta = WFX_MAX_STA_IN_AP_MODE;
309 hw->wiphy->max_scan_ssids = 2;
310 hw->wiphy->max_scan_ie_len = IEEE80211_MAX_DATA_LEN;
311 hw->wiphy->n_iface_combinations = ARRAY_SIZE(wfx_iface_combinations);
312 hw->wiphy->iface_combinations = wfx_iface_combinations;
313 hw->wiphy->bands[NL80211_BAND_2GHZ] = devm_kmalloc(dev, sizeof(wfx_band_2ghz), GFP_KERNEL);
314 // FIXME: also copy wfx_rates and wfx_2ghz_chantable
315 memcpy(hw->wiphy->bands[NL80211_BAND_2GHZ], &wfx_band_2ghz,
316 sizeof(wfx_band_2ghz));
321 wdev->hwbus_ops = hwbus_ops;
322 wdev->hwbus_priv = hwbus_priv;
323 memcpy(&wdev->pdata, pdata, sizeof(*pdata));
324 of_property_read_string(dev->of_node, "config-file",
325 &wdev->pdata.file_pds);
326 wdev->pdata.gpio_wakeup = wfx_get_gpio(dev, gpio_wakeup, "wakeup");
327 wfx_sl_fill_pdata(dev, &wdev->pdata);
329 mutex_init(&wdev->conf_mutex);
330 mutex_init(&wdev->rx_stats_lock);
331 init_completion(&wdev->firmware_ready);
332 wfx_init_hif_cmd(&wdev->hif_cmd);
333 wfx_tx_queues_init(wdev);
338 void wfx_free_common(struct wfx_dev *wdev)
340 mutex_destroy(&wdev->rx_stats_lock);
341 mutex_destroy(&wdev->conf_mutex);
342 wfx_tx_queues_deinit(wdev);
343 ieee80211_free_hw(wdev->hw);
346 int wfx_probe(struct wfx_dev *wdev)
351 struct gpio_desc *gpio_saved;
353 // During first part of boot, gpio_wakeup cannot yet been used. So
354 // prevent bh() to touch it.
355 gpio_saved = wdev->pdata.gpio_wakeup;
356 wdev->pdata.gpio_wakeup = NULL;
358 wfx_bh_register(wdev);
360 err = wfx_init_device(wdev);
364 err = wait_for_completion_interruptible_timeout(&wdev->firmware_ready,
368 dev_err(wdev->dev, "timeout while waiting for startup indication. IRQ configuration error?\n");
370 } else if (err == -ERESTARTSYS) {
371 dev_info(wdev->dev, "probe interrupted by user\n");
376 // FIXME: fill wiphy::hw_version
377 dev_info(wdev->dev, "started firmware %d.%d.%d \"%s\" (API: %d.%d, keyset: %02X, caps: 0x%.8X)\n",
378 wdev->hw_caps.firmware_major, wdev->hw_caps.firmware_minor,
379 wdev->hw_caps.firmware_build, wdev->hw_caps.firmware_label,
380 wdev->hw_caps.api_version_major,
381 wdev->hw_caps.api_version_minor,
382 wdev->keyset, *((u32 *) &wdev->hw_caps.capabilities));
383 snprintf(wdev->hw->wiphy->fw_version,
384 sizeof(wdev->hw->wiphy->fw_version),
386 wdev->hw_caps.firmware_major,
387 wdev->hw_caps.firmware_minor,
388 wdev->hw_caps.firmware_build);
390 if (wfx_api_older_than(wdev, 1, 0)) {
392 "unsupported firmware API version (expect 1 while firmware returns %d)\n",
393 wdev->hw_caps.api_version_major);
398 err = wfx_sl_init(wdev);
399 if (err && wdev->hw_caps.capabilities.link_mode == SEC_LINK_ENFORCED) {
401 "chip require secure_link, but can't negociate it\n");
405 if (wdev->hw_caps.regul_sel_mode_info.region_sel_mode) {
406 wdev->hw->wiphy->bands[NL80211_BAND_2GHZ]->channels[11].flags |= IEEE80211_CHAN_NO_IR;
407 wdev->hw->wiphy->bands[NL80211_BAND_2GHZ]->channels[12].flags |= IEEE80211_CHAN_NO_IR;
408 wdev->hw->wiphy->bands[NL80211_BAND_2GHZ]->channels[13].flags |= IEEE80211_CHAN_DISABLED;
411 dev_dbg(wdev->dev, "sending configuration file %s\n",
412 wdev->pdata.file_pds);
413 err = wfx_send_pdata_pds(wdev);
417 wdev->pdata.gpio_wakeup = gpio_saved;
418 if (wdev->pdata.gpio_wakeup) {
420 "enable 'quiescent' power mode with gpio %d and PDS file %s\n",
421 desc_to_gpio(wdev->pdata.gpio_wakeup),
422 wdev->pdata.file_pds);
423 gpiod_set_value(wdev->pdata.gpio_wakeup, 1);
424 control_reg_write(wdev, 0);
425 hif_set_operational_mode(wdev, HIF_OP_POWER_MODE_QUIESCENT);
427 hif_set_operational_mode(wdev, HIF_OP_POWER_MODE_DOZE);
430 hif_use_multi_tx_conf(wdev, true);
432 for (i = 0; i < ARRAY_SIZE(wdev->addresses); i++) {
433 eth_zero_addr(wdev->addresses[i].addr);
434 macaddr = of_get_mac_address(wdev->dev->of_node);
435 if (!IS_ERR_OR_NULL(macaddr)) {
436 ether_addr_copy(wdev->addresses[i].addr, macaddr);
437 wdev->addresses[i].addr[ETH_ALEN - 1] += i;
439 ether_addr_copy(wdev->addresses[i].addr,
440 wdev->hw_caps.mac_addr[i]);
442 if (!is_valid_ether_addr(wdev->addresses[i].addr)) {
443 dev_warn(wdev->dev, "using random MAC address\n");
444 eth_random_addr(wdev->addresses[i].addr);
446 dev_info(wdev->dev, "MAC address %d: %pM\n", i,
447 wdev->addresses[i].addr);
449 wdev->hw->wiphy->n_addresses = ARRAY_SIZE(wdev->addresses);
450 wdev->hw->wiphy->addresses = wdev->addresses;
452 err = ieee80211_register_hw(wdev->hw);
456 err = wfx_debug_init(wdev);
463 ieee80211_unregister_hw(wdev->hw);
464 ieee80211_free_hw(wdev->hw);
466 wfx_bh_unregister(wdev);
470 void wfx_release(struct wfx_dev *wdev)
472 ieee80211_unregister_hw(wdev->hw);
474 wfx_bh_unregister(wdev);
478 static int __init wfx_core_init(void)
482 if (IS_ENABLED(CONFIG_SPI))
483 ret = spi_register_driver(&wfx_spi_driver);
484 if (IS_ENABLED(CONFIG_MMC) && !ret)
485 ret = sdio_register_driver(&wfx_sdio_driver);
488 module_init(wfx_core_init);
490 static void __exit wfx_core_exit(void)
492 if (IS_ENABLED(CONFIG_MMC))
493 sdio_unregister_driver(&wfx_sdio_driver);
494 if (IS_ENABLED(CONFIG_SPI))
495 spi_unregister_driver(&wfx_spi_driver);
497 module_exit(wfx_core_exit);