projects / linux-2.6-block.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Freezer: make kernel threads nonfreezable by default
[linux-2.6-block.git] / drivers / net / wireless / libertas / main.c
CommitLineData
876c9d3a
MT		 1/**
2 * This file contains the major functions in WLAN
3 * driver. It includes init, exit, open, close and main
4 * thread etc..
5 */
6
a46c6410 7#include <linux/moduleparam.h>
876c9d3a
MT		 8#include <linux/delay.h>
9#include <linux/freezer.h>
10#include <linux/etherdevice.h>
11#include <linux/netdevice.h>
12#include <linux/if_arp.h>
13
14#include <net/iw_handler.h>
9012b28a 15#include <net/ieee80211.h>
876c9d3a
MT		 16
17#include "host.h"
876c9d3a
MT		 18#include "decl.h"
19#include "dev.h"
876c9d3a
MT		 20#include "wext.h"
21#include "debugfs.h"
22#include "assoc.h"
23
7d8d28b3 24#define DRIVER_RELEASE_VERSION "322.p0"
3ce40232
DW		 25const char libertas_driver_version[] = "COMM-USB8388-" DRIVER_RELEASE_VERSION
26#ifdef DEBUG
27 "-dbg"
28#endif
29 "";
30
a46c6410
HS		 31
32/* Module parameters */
33unsigned int libertas_debug = 0;
34module_param(libertas_debug, int, 0644);
084708b6 35EXPORT_SYMBOL_GPL(libertas_debug);
a46c6410
HS		 36
37
876c9d3a
MT		 38#define WLAN_TX_PWR_DEFAULT 20 /*100mW */
39#define WLAN_TX_PWR_US_DEFAULT 20 /*100mW */
40#define WLAN_TX_PWR_JP_DEFAULT 16 /*50mW */
41#define WLAN_TX_PWR_FR_DEFAULT 20 /*100mW */
42#define WLAN_TX_PWR_EMEA_DEFAULT 20 /*100mW */
43
44/* Format { channel, frequency (MHz), maxtxpower } */
45/* band: 'B/G', region: USA FCC/Canada IC */
46static struct chan_freq_power channel_freq_power_US_BG[] = {
47 {1, 2412, WLAN_TX_PWR_US_DEFAULT},
48 {2, 2417, WLAN_TX_PWR_US_DEFAULT},
49 {3, 2422, WLAN_TX_PWR_US_DEFAULT},
50 {4, 2427, WLAN_TX_PWR_US_DEFAULT},
51 {5, 2432, WLAN_TX_PWR_US_DEFAULT},
52 {6, 2437, WLAN_TX_PWR_US_DEFAULT},
53 {7, 2442, WLAN_TX_PWR_US_DEFAULT},
54 {8, 2447, WLAN_TX_PWR_US_DEFAULT},
55 {9, 2452, WLAN_TX_PWR_US_DEFAULT},
56 {10, 2457, WLAN_TX_PWR_US_DEFAULT},
57 {11, 2462, WLAN_TX_PWR_US_DEFAULT}
58};
59
60/* band: 'B/G', region: Europe ETSI */
61static struct chan_freq_power channel_freq_power_EU_BG[] = {
62 {1, 2412, WLAN_TX_PWR_EMEA_DEFAULT},
63 {2, 2417, WLAN_TX_PWR_EMEA_DEFAULT},
64 {3, 2422, WLAN_TX_PWR_EMEA_DEFAULT},
65 {4, 2427, WLAN_TX_PWR_EMEA_DEFAULT},
66 {5, 2432, WLAN_TX_PWR_EMEA_DEFAULT},
67 {6, 2437, WLAN_TX_PWR_EMEA_DEFAULT},
68 {7, 2442, WLAN_TX_PWR_EMEA_DEFAULT},
69 {8, 2447, WLAN_TX_PWR_EMEA_DEFAULT},
70 {9, 2452, WLAN_TX_PWR_EMEA_DEFAULT},
71 {10, 2457, WLAN_TX_PWR_EMEA_DEFAULT},
72 {11, 2462, WLAN_TX_PWR_EMEA_DEFAULT},
73 {12, 2467, WLAN_TX_PWR_EMEA_DEFAULT},
74 {13, 2472, WLAN_TX_PWR_EMEA_DEFAULT}
75};
76
77/* band: 'B/G', region: Spain */
78static struct chan_freq_power channel_freq_power_SPN_BG[] = {
79 {10, 2457, WLAN_TX_PWR_DEFAULT},
80 {11, 2462, WLAN_TX_PWR_DEFAULT}
81};
82
83/* band: 'B/G', region: France */
84static struct chan_freq_power channel_freq_power_FR_BG[] = {
85 {10, 2457, WLAN_TX_PWR_FR_DEFAULT},
86 {11, 2462, WLAN_TX_PWR_FR_DEFAULT},
87 {12, 2467, WLAN_TX_PWR_FR_DEFAULT},
88 {13, 2472, WLAN_TX_PWR_FR_DEFAULT}
89};
90
91/* band: 'B/G', region: Japan */
92static struct chan_freq_power channel_freq_power_JPN_BG[] = {
93 {1, 2412, WLAN_TX_PWR_JP_DEFAULT},
94 {2, 2417, WLAN_TX_PWR_JP_DEFAULT},
95 {3, 2422, WLAN_TX_PWR_JP_DEFAULT},
96 {4, 2427, WLAN_TX_PWR_JP_DEFAULT},
97 {5, 2432, WLAN_TX_PWR_JP_DEFAULT},
98 {6, 2437, WLAN_TX_PWR_JP_DEFAULT},
99 {7, 2442, WLAN_TX_PWR_JP_DEFAULT},
100 {8, 2447, WLAN_TX_PWR_JP_DEFAULT},
101 {9, 2452, WLAN_TX_PWR_JP_DEFAULT},
102 {10, 2457, WLAN_TX_PWR_JP_DEFAULT},
103 {11, 2462, WLAN_TX_PWR_JP_DEFAULT},
104 {12, 2467, WLAN_TX_PWR_JP_DEFAULT},
105 {13, 2472, WLAN_TX_PWR_JP_DEFAULT},
106 {14, 2484, WLAN_TX_PWR_JP_DEFAULT}
107};
108
109/**
110 * the structure for channel, frequency and power
111 */
112struct region_cfp_table {
113 u8 region;
114 struct chan_freq_power *cfp_BG;
115 int cfp_no_BG;
116};
117
118/**
119 * the structure for the mapping between region and CFP
120 */
121static struct region_cfp_table region_cfp_table[] = {
122 {0x10, /*US FCC */
123 channel_freq_power_US_BG,
124 sizeof(channel_freq_power_US_BG) / sizeof(struct chan_freq_power),
125 }
126 ,
127 {0x20, /*CANADA IC */
128 channel_freq_power_US_BG,
129 sizeof(channel_freq_power_US_BG) / sizeof(struct chan_freq_power),
130 }
131 ,
132 {0x30, /*EU*/ channel_freq_power_EU_BG,
133 sizeof(channel_freq_power_EU_BG) / sizeof(struct chan_freq_power),
134 }
135 ,
136 {0x31, /*SPAIN*/ channel_freq_power_SPN_BG,
137 sizeof(channel_freq_power_SPN_BG) / sizeof(struct chan_freq_power),
138 }
139 ,
140 {0x32, /*FRANCE*/ channel_freq_power_FR_BG,
141 sizeof(channel_freq_power_FR_BG) / sizeof(struct chan_freq_power),
142 }
143 ,
144 {0x40, /*JAPAN*/ channel_freq_power_JPN_BG,
145 sizeof(channel_freq_power_JPN_BG) / sizeof(struct chan_freq_power),
146 }
147 ,
148/*Add new region here */
149};
150
876c9d3a
MT		 151/**
152 * the rates supported
153 */
154u8 libertas_supported_rates[G_SUPPORTED_RATES] =
155 { 0x82, 0x84, 0x8b, 0x96, 0x0c, 0x12, 0x18, 0x24, 0x30, 0x48, 0x60, 0x6c,
1560 };
157
158/**
159 * the rates supported for ad-hoc G mode
160 */
161u8 libertas_adhoc_rates_g[G_SUPPORTED_RATES] =
162 { 0x82, 0x84, 0x8b, 0x96, 0x0c, 0x12, 0x18, 0x24, 0x30, 0x48, 0x60, 0x6c,
1630 };
164
165/**
166 * the rates supported for ad-hoc B mode
167 */
168u8 libertas_adhoc_rates_b[4] = { 0x82, 0x84, 0x8b, 0x96 };
169
876c9d3a
MT		 170/**
171 * the table to keep region code
172 */
173u16 libertas_region_code_to_index[MRVDRV_MAX_REGION_CODE] =
174 { 0x10, 0x20, 0x30, 0x31, 0x32, 0x40 };
175
876c9d3a
MT		 176/**
177 * Attributes exported through sysfs
178 */
876c9d3a
MT		 179
180/**
82fde74b 181 * @brief Get function for sysfs attribute anycast_mask
876c9d3a 182 */
82fde74b 183static ssize_t libertas_anycast_get(struct device * dev,
b59bb616
DW		 184 struct device_attribute *attr, char * buf)
185{
876c9d3a
MT		 186 struct cmd_ds_mesh_access mesh_access;
187
188 memset(&mesh_access, 0, sizeof(mesh_access));
189 libertas_prepare_and_send_command(to_net_dev(dev)->priv,
190 cmd_mesh_access,
82fde74b 191 cmd_act_mesh_get_anycast,
876c9d3a
MT		 192 cmd_option_waitforrsp, 0, (void *)&mesh_access);
193
82fde74b 194 return snprintf(buf, 12, "0x%X\n", le32_to_cpu(mesh_access.data[0]));
876c9d3a
MT		 195}
196
197/**
82fde74b 198 * @brief Set function for sysfs attribute anycast_mask
876c9d3a 199 */
82fde74b 200static ssize_t libertas_anycast_set(struct device * dev,
b59bb616
DW		 201 struct device_attribute *attr, const char * buf, size_t count)
202{
876c9d3a 203 struct cmd_ds_mesh_access mesh_access;
981f187b 204 uint32_t datum;
876c9d3a 205
876c9d3a 206 memset(&mesh_access, 0, sizeof(mesh_access));
82fde74b 207 sscanf(buf, "%x", &datum);
981f187b
DW		 208 mesh_access.data[0] = cpu_to_le32(datum);
209
876c9d3a
MT		 210 libertas_prepare_and_send_command((to_net_dev(dev))->priv,
211 cmd_mesh_access,
82fde74b 212 cmd_act_mesh_set_anycast,
876c9d3a
MT		 213 cmd_option_waitforrsp, 0, (void *)&mesh_access);
214 return strlen(buf);
215}
216
217/**
82fde74b
LC		 218 * anycast_mask attribute to be exported per mshX interface
219 * through sysfs (/sys/class/net/mshX/anycast_mask)
876c9d3a 220 */
82fde74b 221static DEVICE_ATTR(anycast_mask, 0644, libertas_anycast_get, libertas_anycast_set);
876c9d3a
MT		 222
223/**
224 * @brief Check if the device can be open and wait if necessary.
225 *
226 * @param dev A pointer to net_device structure
227 * @return 0
228 *
229 * For USB adapter, on some systems the device open handler will be
230 * called before FW ready. Use the following flag check and wait
231 * function to work around the issue.
232 *
233 */
9012b28a
HS		 234static int pre_open_check(struct net_device *dev)
235{
876c9d3a
MT		 236 wlan_private *priv = (wlan_private *) dev->priv;
237 wlan_adapter *adapter = priv->adapter;
238 int i = 0;
239
240 while (!adapter->fw_ready && i < 20) {
241 i++;
242 msleep_interruptible(100);
243 }
244 if (!adapter->fw_ready) {
9012b28a 245 lbs_pr_err("firmware not ready\n");
876c9d3a
MT		 246 return -1;
247 }
248
249 return 0;
250}
251
252/**
253 * @brief This function opens the device
254 *
255 * @param dev A pointer to net_device structure
256 * @return 0
257 */
258static int wlan_dev_open(struct net_device *dev)
259{
260 wlan_private *priv = (wlan_private *) dev->priv;
261 wlan_adapter *adapter = priv->adapter;
262
9012b28a 263 lbs_deb_enter(LBS_DEB_NET);
876c9d3a
MT		 264
265 priv->open = 1;
266
267 if (adapter->connect_status == libertas_connected) {
634b8f49 268 netif_carrier_on(priv->dev);
51d84f50
JC		 269 netif_carrier_on(priv->mesh_dev);
270 } else {
634b8f49 271 netif_carrier_off(priv->dev);
51d84f50
JC		 272 netif_carrier_off(priv->mesh_dev);
273 }
876c9d3a 274
9012b28a 275 lbs_deb_leave(LBS_DEB_NET);
876c9d3a
MT		 276 return 0;
277}
278/**
279 * @brief This function opens the mshX interface
280 *
281 * @param dev A pointer to net_device structure
282 * @return 0
283 */
284static int mesh_open(struct net_device *dev)
285{
286 wlan_private *priv = (wlan_private *) dev->priv ;
287
78523daa 288 if (pre_open_check(dev) == -1)
876c9d3a
MT		 289 return -1;
290 priv->mesh_open = 1 ;
51d84f50 291 netif_wake_queue(priv->mesh_dev);
876c9d3a 292 if (priv->infra_open == 0)
634b8f49 293 return wlan_dev_open(priv->dev) ;
876c9d3a
MT		 294 return 0;
295}
296
297/**
298 * @brief This function opens the ethX interface
299 *
300 * @param dev A pointer to net_device structure
301 * @return 0
302 */
303static int wlan_open(struct net_device *dev)
304{
305 wlan_private *priv = (wlan_private *) dev->priv ;
306
307 if(pre_open_check(dev) == -1)
308 return -1;
309 priv->infra_open = 1 ;
634b8f49 310 netif_wake_queue(priv->dev);
876c9d3a 311 if (priv->open == 0)
634b8f49 312 return wlan_dev_open(priv->dev) ;
876c9d3a
MT		 313 return 0;
314}
315
316static int wlan_dev_close(struct net_device *dev)
317{
318 wlan_private *priv = dev->priv;
319
9012b28a 320 lbs_deb_enter(LBS_DEB_NET);
876c9d3a 321
634b8f49 322 netif_carrier_off(priv->dev);
876c9d3a
MT		 323 priv->open = 0;
324
9012b28a 325 lbs_deb_leave(LBS_DEB_NET);
876c9d3a
MT		 326 return 0;
327}
328
329/**
330 * @brief This function closes the mshX interface
331 *
332 * @param dev A pointer to net_device structure
333 * @return 0
334 */
335static int mesh_close(struct net_device *dev)
336{
337 wlan_private *priv = (wlan_private *) (dev->priv);
338
339 priv->mesh_open = 0;
340 netif_stop_queue(priv->mesh_dev);
341 if (priv->infra_open == 0)
634b8f49 342 return wlan_dev_close(dev);
876c9d3a
MT		 343 else
344 return 0;
345}
346
347/**
348 * @brief This function closes the ethX interface
349 *
350 * @param dev A pointer to net_device structure
351 * @return 0
352 */
78523daa
HS		 353static int wlan_close(struct net_device *dev)
354{
876c9d3a
MT		 355 wlan_private *priv = (wlan_private *) dev->priv;
356
634b8f49 357 netif_stop_queue(dev);
876c9d3a
MT		 358 priv->infra_open = 0;
359 if (priv->mesh_open == 0)
634b8f49 360 return wlan_dev_close(dev);
876c9d3a
MT		 361 else
362 return 0;
363}
364
365
876c9d3a
MT		 366static int wlan_hard_start_xmit(struct sk_buff *skb, struct net_device *dev)
367{
368 int ret = 0;
369 wlan_private *priv = dev->priv;
370
9012b28a 371 lbs_deb_enter(LBS_DEB_NET);
876c9d3a 372
634b8f49 373 if (priv->dnld_sent || priv->adapter->TxLockFlag) {
876c9d3a
MT		 374 priv->stats.tx_dropped++;
375 goto done;
376 }
377
634b8f49 378 netif_stop_queue(priv->dev);
51d84f50 379 netif_stop_queue(priv->mesh_dev);
876c9d3a
MT		 380
381 if (libertas_process_tx(priv, skb) == 0)
382 dev->trans_start = jiffies;
383done:
9012b28a 384 lbs_deb_leave_args(LBS_DEB_NET, "ret %d", ret);
876c9d3a
MT		 385 return ret;
386}
387
388/**
389 * @brief Mark mesh packets and handover them to wlan_hard_start_xmit
390 *
391 */
392static int mesh_pre_start_xmit(struct sk_buff *skb, struct net_device *dev)
393{
394 wlan_private *priv = dev->priv;
9012b28a
HS		 395 int ret;
396
397 lbs_deb_enter(LBS_DEB_MESH);
398
876c9d3a 399 SET_MESH_FRAME(skb);
876c9d3a 400
634b8f49 401 ret = wlan_hard_start_xmit(skb, priv->dev);
9012b28a
HS		 402 lbs_deb_leave_args(LBS_DEB_MESH, "ret %d", ret);
403 return ret;
876c9d3a
MT		 404}
405
406/**
407 * @brief Mark non-mesh packets and handover them to wlan_hard_start_xmit
408 *
409 */
9012b28a
HS		 410static int wlan_pre_start_xmit(struct sk_buff *skb, struct net_device *dev)
411{
412 int ret;
413
414 lbs_deb_enter(LBS_DEB_NET);
415
876c9d3a 416 UNSET_MESH_FRAME(skb);
9012b28a
HS		 417
418 ret = wlan_hard_start_xmit(skb, dev);
419 lbs_deb_leave_args(LBS_DEB_NET, "ret %d", ret);
420 return ret;
876c9d3a
MT		 421}
422
423static void wlan_tx_timeout(struct net_device *dev)
424{
425 wlan_private *priv = (wlan_private *) dev->priv;
426
9012b28a 427 lbs_deb_enter(LBS_DEB_TX);
876c9d3a 428
9012b28a 429 lbs_pr_err("tx watch dog timeout\n");
876c9d3a 430
634b8f49 431 priv->dnld_sent = DNLD_RES_RECEIVED;
876c9d3a
MT		 432 dev->trans_start = jiffies;
433
434 if (priv->adapter->currenttxskb) {
435 if (priv->adapter->radiomode == WLAN_RADIOMODE_RADIOTAP) {
436 /* If we are here, we have not received feedback from
437 the previous packet. Assume TX_FAIL and move on. */
438 priv->adapter->eventcause = 0x01000000;
439 libertas_send_tx_feedback(priv);
440 } else
441 wake_up_interruptible(&priv->mainthread.waitq);
51d84f50 442 } else if (priv->adapter->connect_status == libertas_connected) {
634b8f49 443 netif_wake_queue(priv->dev);
51d84f50
JC		 444 netif_wake_queue(priv->mesh_dev);
445 }
876c9d3a 446
9012b28a 447 lbs_deb_leave(LBS_DEB_TX);
876c9d3a
MT		 448}
449
450/**
451 * @brief This function returns the network statistics
452 *
453 * @param dev A pointer to wlan_private structure
454 * @return A pointer to net_device_stats structure
455 */
456static struct net_device_stats *wlan_get_stats(struct net_device *dev)
457{
458 wlan_private *priv = (wlan_private *) dev->priv;
459
460 return &priv->stats;
461}
462
463static int wlan_set_mac_address(struct net_device *dev, void *addr)
464{
465 int ret = 0;
466 wlan_private *priv = (wlan_private *) dev->priv;
467 wlan_adapter *adapter = priv->adapter;
468 struct sockaddr *phwaddr = addr;
469
9012b28a 470 lbs_deb_enter(LBS_DEB_NET);
876c9d3a 471
0a0d08ac
LCCR		 472 /* In case it was called from the mesh device */
473 dev = priv->dev ;
474
876c9d3a
MT		 475 memset(adapter->current_addr, 0, ETH_ALEN);
476
477 /* dev->dev_addr is 8 bytes */
478 lbs_dbg_hex("dev->dev_addr:", dev->dev_addr, ETH_ALEN);
479
480 lbs_dbg_hex("addr:", phwaddr->sa_data, ETH_ALEN);
481 memcpy(adapter->current_addr, phwaddr->sa_data, ETH_ALEN);
482
483 ret = libertas_prepare_and_send_command(priv, cmd_802_11_mac_address,
484 cmd_act_set,
485 cmd_option_waitforrsp, 0, NULL);
486
487 if (ret) {
9012b28a 488 lbs_deb_net("set MAC address failed\n");
876c9d3a
MT		 489 ret = -1;
490 goto done;
491 }
492
493 lbs_dbg_hex("adapter->macaddr:", adapter->current_addr, ETH_ALEN);
494 memcpy(dev->dev_addr, adapter->current_addr, ETH_ALEN);
78523daa
HS		 495 if (priv->mesh_dev)
496 memcpy(priv->mesh_dev->dev_addr, adapter->current_addr, ETH_ALEN);
876c9d3a
MT		 497
498done:
9012b28a 499 lbs_deb_leave_args(LBS_DEB_NET, "ret %d", ret);
876c9d3a
MT		 500 return ret;
501}
502
503static int wlan_copy_multicast_address(wlan_adapter * adapter,
504 struct net_device *dev)
505{
506 int i = 0;
507 struct dev_mc_list *mcptr = dev->mc_list;
508
509 for (i = 0; i < dev->mc_count; i++) {
510 memcpy(&adapter->multicastlist[i], mcptr->dmi_addr, ETH_ALEN);
511 mcptr = mcptr->next;
512 }
513
514 return i;
515
516}
517
518static void wlan_set_multicast_list(struct net_device *dev)
519{
520 wlan_private *priv = dev->priv;
521 wlan_adapter *adapter = priv->adapter;
522 int oldpacketfilter;
523
9012b28a 524 lbs_deb_enter(LBS_DEB_NET);
876c9d3a
MT		 525
526 oldpacketfilter = adapter->currentpacketfilter;
527
528 if (dev->flags & IFF_PROMISC) {
9012b28a 529 lbs_deb_net("enable promiscuous mode\n");
876c9d3a
MT		 530 adapter->currentpacketfilter |=
531 cmd_act_mac_promiscuous_enable;
532 adapter->currentpacketfilter &=
533 ~(cmd_act_mac_all_multicast_enable |
534 cmd_act_mac_multicast_enable);
535 } else {
536 /* Multicast */
537 adapter->currentpacketfilter &=
538 ~cmd_act_mac_promiscuous_enable;
539
540 if (dev->flags & IFF_ALLMULTI || dev->mc_count >
541 MRVDRV_MAX_MULTICAST_LIST_SIZE) {
9012b28a 542 lbs_deb_net( "enabling all multicast\n");
876c9d3a
MT		 543 adapter->currentpacketfilter |=
544 cmd_act_mac_all_multicast_enable;
545 adapter->currentpacketfilter &=
546 ~cmd_act_mac_multicast_enable;
547 } else {
548 adapter->currentpacketfilter &=
549 ~cmd_act_mac_all_multicast_enable;
550
551 if (!dev->mc_count) {
9012b28a
HS		 552 lbs_deb_net("no multicast addresses, "
553 "disabling multicast\n");
876c9d3a
MT		 554 adapter->currentpacketfilter &=
555 ~cmd_act_mac_multicast_enable;
556 } else {
557 int i;
558
559 adapter->currentpacketfilter |=
560 cmd_act_mac_multicast_enable;
561
562 adapter->nr_of_multicastmacaddr =
563 wlan_copy_multicast_address(adapter, dev);
564
9012b28a 565 lbs_deb_net("multicast addresses: %d\n",
876c9d3a
MT		 566 dev->mc_count);
567
568 for (i = 0; i < dev->mc_count; i++) {
9012b28a
HS		 569 lbs_deb_net("Multicast address %d:"
570 MAC_FMT "\n", i,
876c9d3a
MT		 571 adapter->multicastlist[i][0],
572 adapter->multicastlist[i][1],
573 adapter->multicastlist[i][2],
574 adapter->multicastlist[i][3],
575 adapter->multicastlist[i][4],
576 adapter->multicastlist[i][5]);
577 }
9012b28a 578 /* send multicast addresses to firmware */
876c9d3a
MT		 579 libertas_prepare_and_send_command(priv,
580 cmd_mac_multicast_adr,
581 cmd_act_set, 0, 0,
582 NULL);
583 }
584 }
585 }
586
587 if (adapter->currentpacketfilter != oldpacketfilter) {
588 libertas_set_mac_packet_filter(priv);
589 }
590
9012b28a 591 lbs_deb_leave(LBS_DEB_NET);
876c9d3a
MT		 592}
593
594/**
9012b28a
HS		 595 * @brief This function handles the major jobs in the WLAN driver.
596 * It handles all events generated by firmware, RX data received
597 * from firmware and TX data sent from kernel.
876c9d3a
MT		 598 *
599 * @param data A pointer to wlan_thread structure
600 * @return 0
601 */
602static int wlan_service_main_thread(void *data)
603{
604 struct wlan_thread *thread = data;
605 wlan_private *priv = thread->priv;
606 wlan_adapter *adapter = priv->adapter;
607 wait_queue_t wait;
608 u8 ireg = 0;
609
9012b28a 610 lbs_deb_enter(LBS_DEB_THREAD);
876c9d3a
MT		 611
612 wlan_activate_thread(thread);
613
614 init_waitqueue_entry(&wait, current);
615
83144186 616 set_freezable();
876c9d3a 617 for (;;) {
9012b28a 618 lbs_deb_thread( "main-thread 111: intcounter=%d "
876c9d3a
MT		 619 "currenttxskb=%p dnld_sent=%d\n",
620 adapter->intcounter,
634b8f49 621 adapter->currenttxskb, priv->dnld_sent);
876c9d3a
MT		 622
623 add_wait_queue(&thread->waitq, &wait);
624 set_current_state(TASK_INTERRUPTIBLE);
625 spin_lock_irq(&adapter->driver_lock);
626 if ((adapter->psstate == PS_STATE_SLEEP) ||
627 (!adapter->intcounter
634b8f49 628 && (priv->dnld_sent || adapter->cur_cmd ||
876c9d3a 629 list_empty(&adapter->cmdpendingq)))) {
9012b28a 630 lbs_deb_thread(
876c9d3a
MT		 631 "main-thread sleeping... Conn=%d IntC=%d PS_mode=%d PS_State=%d\n",
632 adapter->connect_status, adapter->intcounter,
633 adapter->psmode, adapter->psstate);
634 spin_unlock_irq(&adapter->driver_lock);
635 schedule();
636 } else
637 spin_unlock_irq(&adapter->driver_lock);
638
639
9012b28a 640 lbs_deb_thread(
876c9d3a
MT		 641 "main-thread 222 (waking up): intcounter=%d currenttxskb=%p "
642 "dnld_sent=%d\n", adapter->intcounter,
634b8f49 643 adapter->currenttxskb, priv->dnld_sent);
876c9d3a
MT		 644
645 set_current_state(TASK_RUNNING);
646 remove_wait_queue(&thread->waitq, &wait);
647 try_to_freeze();
648
9012b28a 649 lbs_deb_thread("main-thread 333: intcounter=%d currenttxskb=%p "
876c9d3a
MT		 650 "dnld_sent=%d\n",
651 adapter->intcounter,
634b8f49 652 adapter->currenttxskb, priv->dnld_sent);
876c9d3a
MT		 653
654 if (kthread_should_stop()
655 || adapter->surpriseremoved) {
9012b28a 656 lbs_deb_thread(
876c9d3a
MT		 657 "main-thread: break from main thread: surpriseremoved=0x%x\n",
658 adapter->surpriseremoved);
659 break;
660 }
661
662
663 spin_lock_irq(&adapter->driver_lock);
664 if (adapter->intcounter) {
665 u8 int_status;
666 adapter->intcounter = 0;
208fdd2f 667 int_status = priv->hw_get_int_status(priv, &ireg);
876c9d3a
MT		 668
669 if (int_status) {
9012b28a 670 lbs_deb_thread(
876c9d3a
MT		 671 "main-thread: reading HOST_INT_STATUS_REG failed\n");
672 spin_unlock_irq(&adapter->driver_lock);
673 continue;
674 }
675 adapter->hisregcpy |= ireg;
676 }
677
9012b28a 678 lbs_deb_thread("main-thread 444: intcounter=%d currenttxskb=%p "
876c9d3a
MT		 679 "dnld_sent=%d\n",
680 adapter->intcounter,
634b8f49 681 adapter->currenttxskb, priv->dnld_sent);
876c9d3a
MT		 682
683 /* command response? */
684 if (adapter->hisregcpy & his_cmdupldrdy) {
9012b28a 685 lbs_deb_thread("main-thread: cmd response ready\n");
876c9d3a
MT		 686
687 adapter->hisregcpy &= ~his_cmdupldrdy;
688 spin_unlock_irq(&adapter->driver_lock);
689 libertas_process_rx_command(priv);
690 spin_lock_irq(&adapter->driver_lock);
691 }
692
693 /* Any Card Event */
694 if (adapter->hisregcpy & his_cardevent) {
9012b28a 695 lbs_deb_thread("main-thread: Card Event Activity\n");
876c9d3a
MT		 696
697 adapter->hisregcpy &= ~his_cardevent;
698
208fdd2f 699 if (priv->hw_read_event_cause(priv)) {
876c9d3a 700 lbs_pr_alert(
208fdd2f 701 "main-thread: hw_read_event_cause failed\n");
876c9d3a
MT		 702 spin_unlock_irq(&adapter->driver_lock);
703 continue;
704 }
705 spin_unlock_irq(&adapter->driver_lock);
706 libertas_process_event(priv);
707 } else
708 spin_unlock_irq(&adapter->driver_lock);
709
710 /* Check if we need to confirm Sleep Request received previously */
711 if (adapter->psstate == PS_STATE_PRE_SLEEP) {
634b8f49 712 if (!priv->dnld_sent && !adapter->cur_cmd) {
876c9d3a
MT		 713 if (adapter->connect_status ==
714 libertas_connected) {
9012b28a 715 lbs_deb_thread(
876c9d3a
MT		 716 "main_thread: PRE_SLEEP--intcounter=%d currenttxskb=%p "
717 "dnld_sent=%d cur_cmd=%p, confirm now\n",
718 adapter->intcounter,
719 adapter->currenttxskb,
634b8f49 720 priv->dnld_sent,
876c9d3a
MT		 721 adapter->cur_cmd);
722
723 libertas_ps_confirm_sleep(priv,
724 (u16) adapter->psmode);
725 } else {
726 /* workaround for firmware sending
727 * deauth/linkloss event immediately
728 * after sleep request, remove this
729 * after firmware fixes it
730 */
731 adapter->psstate = PS_STATE_AWAKE;
732 lbs_pr_alert(
733 "main-thread: ignore PS_SleepConfirm in non-connected state\n");
734 }
735 }
736 }
737
738 /* The PS state is changed during processing of Sleep Request
739 * event above
740 */
741 if ((priv->adapter->psstate == PS_STATE_SLEEP) ||
742 (priv->adapter->psstate == PS_STATE_PRE_SLEEP))
743 continue;
744
745 /* Execute the next command */
634b8f49 746 if (!priv->dnld_sent && !priv->adapter->cur_cmd)
876c9d3a
MT		 747 libertas_execute_next_command(priv);
748
749 /* Wake-up command waiters which can't sleep in
750 * libertas_prepare_and_send_command
751 */
752 if (!adapter->nr_cmd_pending)
753 wake_up_all(&adapter->cmd_pending);
754
755 libertas_tx_runqueue(priv);
756 }
757
758 del_timer(&adapter->command_timer);
759 adapter->nr_cmd_pending = 0;
760 wake_up_all(&adapter->cmd_pending);
761 wlan_deactivate_thread(thread);
762
9012b28a 763 lbs_deb_leave(LBS_DEB_THREAD);
876c9d3a
MT		 764 return 0;
765}
766
767/**
768 * @brief This function adds the card. it will probe the
769 * card, allocate the wlan_priv and initialize the device.
770 *
771 * @param card A pointer to card
772 * @return A pointer to wlan_private structure
773 */
7732ca45 774wlan_private *libertas_add_card(void *card, struct device *dmdev)
876c9d3a
MT		 775{
776 struct net_device *dev = NULL;
876c9d3a
MT		 777 wlan_private *priv = NULL;
778
9012b28a 779 lbs_deb_enter(LBS_DEB_NET);
876c9d3a
MT		 780
781 /* Allocate an Ethernet device and register it */
782 if (!(dev = alloc_etherdev(sizeof(wlan_private)))) {
9012b28a 783 lbs_pr_err("init ethX device failed\n");
876c9d3a
MT		 784 return NULL;
785 }
876c9d3a
MT		 786 priv = dev->priv;
787
788 /* allocate buffer for wlan_adapter */
fb3dddf2 789 if (!(priv->adapter = kzalloc(sizeof(wlan_adapter), GFP_KERNEL))) {
9012b28a 790 lbs_pr_err("allocate buffer for wlan_adapter failed\n");
fb3dddf2 791 goto err_kzalloc;
876c9d3a
MT		 792 }
793
634b8f49
HS		 794 priv->dev = dev;
795 priv->card = card;
876c9d3a
MT		 796 priv->mesh_open = 0;
797 priv->infra_open = 0;
876c9d3a
MT		 798
799 SET_MODULE_OWNER(dev);
876c9d3a
MT		 800
801 /* Setup the OS Interface to our functions */
802 dev->open = wlan_open;
803 dev->hard_start_xmit = wlan_pre_start_xmit;
804 dev->stop = wlan_close;
876c9d3a 805 dev->set_mac_address = wlan_set_mac_address;
876c9d3a
MT		 806 dev->tx_timeout = wlan_tx_timeout;
807 dev->get_stats = wlan_get_stats;
fb3dddf2 808 dev->watchdog_timeo = 5 * HZ;
876c9d3a 809 dev->ethtool_ops = &libertas_ethtool_ops;
876c9d3a
MT		 810#ifdef WIRELESS_EXT
811 dev->wireless_handlers = (struct iw_handler_def *)&libertas_handler_def;
876c9d3a
MT		 812#endif
813#define NETIF_F_DYNALLOC 16
814 dev->features |= NETIF_F_DYNALLOC;
815 dev->flags |= IFF_BROADCAST | IFF_MULTICAST;
816 dev->set_multicast_list = wlan_set_multicast_list;
817
7732ca45
DW		 818 SET_NETDEV_DEV(dev, dmdev);
819
876c9d3a
MT		 820 INIT_LIST_HEAD(&priv->adapter->cmdfreeq);
821 INIT_LIST_HEAD(&priv->adapter->cmdpendingq);
822
823 spin_lock_init(&priv->adapter->driver_lock);
824 init_waitqueue_head(&priv->adapter->cmd_pending);
825 priv->adapter->nr_cmd_pending = 0;
32a74b7c
HS		 826 goto done;
827
828err_kzalloc:
829 free_netdev(dev);
6a812157 830 priv = NULL;
32a74b7c
HS		 831done:
832 lbs_deb_leave_args(LBS_DEB_NET, "priv %p", priv);
833 return priv;
834}
084708b6 835EXPORT_SYMBOL_GPL(libertas_add_card);
32a74b7c 836
084708b6 837int libertas_activate_card(wlan_private *priv, char *fw_name)
32a74b7c 838{
634b8f49 839 struct net_device *dev = priv->dev;
32a74b7c
HS		 840 int ret = -1;
841
842 lbs_deb_enter(LBS_DEB_MAIN);
876c9d3a 843
9012b28a 844 lbs_deb_thread("Starting kthread...\n");
876c9d3a
MT		 845 priv->mainthread.priv = priv;
846 wlan_create_thread(wlan_service_main_thread,
847 &priv->mainthread, "wlan_main_service");
848
849 priv->assoc_thread =
850 create_singlethread_workqueue("libertas_assoc");
eb3ce631 851 INIT_DELAYED_WORK(&priv->assoc_work, libertas_association_worker);
b8bedefd 852 INIT_WORK(&priv->sync_channel, libertas_sync_channel);
876c9d3a
MT		 853
854 /*
855 * Register the device. Fillup the private data structure with
856 * relevant information from the card and request for the required
857 * IRQ.
858 */
208fdd2f 859 if (priv->hw_register_dev(priv) < 0) {
9012b28a 860 lbs_pr_err("failed to register WLAN device\n");
876c9d3a
MT		 861 goto err_registerdev;
862 }
863
864 /* init FW and HW */
084708b6 865 if (fw_name && libertas_init_fw(priv, fw_name)) {
9012b28a 866 lbs_pr_err("firmware init failed\n");
876c9d3a
MT		 867 goto err_registerdev;
868 }
869
870 if (register_netdev(dev)) {
9012b28a 871 lbs_pr_err("cannot register ethX device\n");
876c9d3a
MT		 872 goto err_init_fw;
873 }
874
9012b28a 875 lbs_pr_info("%s: Marvell WLAN 802.11 adapter\n", dev->name);
876c9d3a
MT		 876
877 libertas_debugfs_init_one(priv, dev);
878
32a74b7c
HS		 879 ret = 0;
880 goto done;
876c9d3a 881
876c9d3a 882err_init_fw:
208fdd2f 883 priv->hw_unregister_dev(priv);
876c9d3a
MT		 884err_registerdev:
885 destroy_workqueue(priv->assoc_thread);
886 /* Stop the thread servicing the interrupts */
887 wake_up_interruptible(&priv->mainthread.waitq);
888 wlan_terminate_thread(&priv->mainthread);
32a74b7c
HS		 889done:
890 lbs_deb_leave_args(LBS_DEB_NET, "ret %d", ret);
891 return ret;
876c9d3a 892}
084708b6
HS		 893EXPORT_SYMBOL_GPL(libertas_activate_card);
894
876c9d3a 895
78523daa
HS		 896/**
897 * @brief This function adds mshX interface
898 *
899 * @param priv A pointer to the wlan_private structure
900 * @return 0 if successful, -X otherwise
901 */
7732ca45 902int libertas_add_mesh(wlan_private *priv, struct device *dev)
78523daa
HS		 903{
904 struct net_device *mesh_dev = NULL;
905 int ret = 0;
906
907 lbs_deb_enter(LBS_DEB_MESH);
908
909 /* Allocate a virtual mesh device */
910 if (!(mesh_dev = alloc_netdev(0, "msh%d", ether_setup))) {
911 lbs_deb_mesh("init mshX device failed\n");
912 ret = -ENOMEM;
913 goto done;
914 }
915 mesh_dev->priv = priv;
916 priv->mesh_dev = mesh_dev;
917
918 SET_MODULE_OWNER(mesh_dev);
919
920 mesh_dev->open = mesh_open;
921 mesh_dev->hard_start_xmit = mesh_pre_start_xmit;
922 mesh_dev->stop = mesh_close;
78523daa 923 mesh_dev->get_stats = wlan_get_stats;
0a0d08ac 924 mesh_dev->set_mac_address = wlan_set_mac_address;
78523daa 925 mesh_dev->ethtool_ops = &libertas_ethtool_ops;
634b8f49
HS		 926 memcpy(mesh_dev->dev_addr, priv->dev->dev_addr,
927 sizeof(priv->dev->dev_addr));
78523daa 928
7732ca45
DW		 929 SET_NETDEV_DEV(priv->mesh_dev, dev);
930
78523daa 931#ifdef WIRELESS_EXT
f5e05b69 932 mesh_dev->wireless_handlers = (struct iw_handler_def *)&mesh_handler_def;
78523daa
HS		 933#endif
934#define NETIF_F_DYNALLOC 16
935
936 /* Register virtual mesh interface */
937 ret = register_netdev(mesh_dev);
938 if (ret) {
939 lbs_pr_err("cannot register mshX virtual interface\n");
940 goto err_free;
941 }
942
82fde74b 943 ret = device_create_file(&(mesh_dev->dev), &dev_attr_anycast_mask);
78523daa
HS		 944 if (ret)
945 goto err_unregister;
946
947 /* Everything successful */
948 ret = 0;
949 goto done;
950
951
952err_unregister:
953 unregister_netdev(mesh_dev);
954
955err_free:
956 free_netdev(mesh_dev);
957
958done:
959 lbs_deb_leave_args(LBS_DEB_MESH, "ret %d", ret);
960 return ret;
961}
084708b6 962EXPORT_SYMBOL_GPL(libertas_add_mesh);
78523daa 963
876c9d3a
MT		 964static void wake_pending_cmdnodes(wlan_private *priv)
965{
966 struct cmd_ctrl_node *cmdnode;
967 unsigned long flags;
968
9012b28a
HS		 969 lbs_deb_enter(LBS_DEB_CMD);
970
876c9d3a
MT		 971 spin_lock_irqsave(&priv->adapter->driver_lock, flags);
972 list_for_each_entry(cmdnode, &priv->adapter->cmdpendingq, list) {
973 cmdnode->cmdwaitqwoken = 1;
974 wake_up_interruptible(&cmdnode->cmdwait_q);
975 }
976 spin_unlock_irqrestore(&priv->adapter->driver_lock, flags);
977}
978
979
084708b6 980int libertas_remove_card(wlan_private *priv)
876c9d3a 981{
876c9d3a
MT		 982 wlan_adapter *adapter;
983 struct net_device *dev;
876c9d3a 984 union iwreq_data wrqu;
876c9d3a 985
9012b28a 986 lbs_deb_enter(LBS_DEB_NET);
876c9d3a 987
9012b28a
HS		 988 if (!priv)
989 goto out;
876c9d3a
MT		 990
991 adapter = priv->adapter;
992
9012b28a
HS		 993 if (!adapter)
994 goto out;
876c9d3a 995
634b8f49 996 dev = priv->dev;
876c9d3a 997
634b8f49
HS		 998 netif_stop_queue(priv->dev);
999 netif_carrier_off(priv->dev);
876c9d3a
MT		 1000
1001 wake_pending_cmdnodes(priv);
1002
876c9d3a
MT		 1003 unregister_netdev(dev);
1004
1005 cancel_delayed_work(&priv->assoc_work);
1006 destroy_workqueue(priv->assoc_thread);
1007
1008 if (adapter->psmode == wlan802_11powermodemax_psp) {
1009 adapter->psmode = wlan802_11powermodecam;
1010 libertas_ps_wakeup(priv, cmd_option_waitforrsp);
1011 }
1012
1013 memset(wrqu.ap_addr.sa_data, 0xaa, ETH_ALEN);
1014 wrqu.ap_addr.sa_family = ARPHRD_ETHER;
634b8f49 1015 wireless_send_event(priv->dev, SIOCGIWAP, &wrqu, NULL);
876c9d3a 1016
876c9d3a
MT		 1017 adapter->surpriseremoved = 1;
1018
1019 /* Stop the thread servicing the interrupts */
1020 wlan_terminate_thread(&priv->mainthread);
1021
1022 libertas_debugfs_remove_one(priv);
1023
9012b28a 1024 lbs_deb_net("free adapter\n");
876c9d3a
MT		 1025 libertas_free_adapter(priv);
1026
9012b28a 1027 lbs_deb_net("unregister finish\n");
876c9d3a 1028
634b8f49 1029 priv->dev = NULL;
876c9d3a 1030 free_netdev(dev);
876c9d3a 1031
9012b28a
HS		 1032out:
1033 lbs_deb_leave(LBS_DEB_NET);
876c9d3a
MT		 1034 return 0;
1035}
084708b6 1036EXPORT_SYMBOL_GPL(libertas_remove_card);
876c9d3a 1037
084708b6
HS		 1038
1039void libertas_remove_mesh(wlan_private *priv)
78523daa
HS		 1040{
1041 struct net_device *mesh_dev;
1042
1043 lbs_deb_enter(LBS_DEB_NET);
1044
1045 if (!priv)
1046 goto out;
1047
1048 mesh_dev = priv->mesh_dev;
1049
1050 netif_stop_queue(mesh_dev);
51d84f50 1051 netif_carrier_off(priv->mesh_dev);
78523daa 1052
82fde74b 1053 device_remove_file(&(mesh_dev->dev), &dev_attr_anycast_mask);
78523daa
HS		 1054 unregister_netdev(mesh_dev);
1055
1056 priv->mesh_dev = NULL ;
1057 free_netdev(mesh_dev);
1058
1059out:
1060 lbs_deb_leave(LBS_DEB_NET);
1061}
084708b6 1062EXPORT_SYMBOL_GPL(libertas_remove_mesh);
78523daa 1063
876c9d3a
MT		 1064/**
1065 * @brief This function finds the CFP in
1066 * region_cfp_table based on region and band parameter.
1067 *
1068 * @param region The region code
1069 * @param band The band
1070 * @param cfp_no A pointer to CFP number
1071 * @return A pointer to CFP
1072 */
1073struct chan_freq_power *libertas_get_region_cfp_table(u8 region, u8 band, int *cfp_no)
1074{
1075 int i, end;
1076
9012b28a 1077 lbs_deb_enter(LBS_DEB_MAIN);
876c9d3a
MT		 1078
1079 end = sizeof(region_cfp_table)/sizeof(struct region_cfp_table);
1080
1081 for (i = 0; i < end ; i++) {
9012b28a 1082 lbs_deb_main("region_cfp_table[i].region=%d\n",
876c9d3a
MT		 1083 region_cfp_table[i].region);
1084 if (region_cfp_table[i].region == region) {
1085 *cfp_no = region_cfp_table[i].cfp_no_BG;
9012b28a 1086 lbs_deb_leave(LBS_DEB_MAIN);
876c9d3a
MT		 1087 return region_cfp_table[i].cfp_BG;
1088 }
1089 }
1090
9012b28a 1091 lbs_deb_leave_args(LBS_DEB_MAIN, "ret NULL");
876c9d3a
MT		 1092 return NULL;
1093}
1094
1095int libertas_set_regiontable(wlan_private * priv, u8 region, u8 band)
1096{
1097 wlan_adapter *adapter = priv->adapter;
9012b28a 1098 int ret = 0;
876c9d3a
MT		 1099 int i = 0;
1100
1101 struct chan_freq_power *cfp;
1102 int cfp_no;
1103
9012b28a 1104 lbs_deb_enter(LBS_DEB_MAIN);
876c9d3a
MT		 1105
1106 memset(adapter->region_channel, 0, sizeof(adapter->region_channel));
1107
1108 {
1109 cfp = libertas_get_region_cfp_table(region, band, &cfp_no);
1110 if (cfp != NULL) {
1111 adapter->region_channel[i].nrcfp = cfp_no;
1112 adapter->region_channel[i].CFP = cfp;
1113 } else {
9012b28a 1114 lbs_deb_main("wrong region code %#x in band B/G\n",
876c9d3a 1115 region);
9012b28a
HS		 1116 ret = -1;
1117 goto out;
876c9d3a
MT		 1118 }
1119 adapter->region_channel[i].valid = 1;
1120 adapter->region_channel[i].region = region;
1121 adapter->region_channel[i].band = band;
1122 i++;
1123 }
9012b28a
HS		 1124out:
1125 lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
1126 return ret;
876c9d3a
MT		 1127}
1128
1129/**
1130 * @brief This function handles the interrupt. it will change PS
1131 * state if applicable. it will wake up main_thread to handle
1132 * the interrupt event as well.
1133 *
1134 * @param dev A pointer to net_device structure
1135 * @return n/a
1136 */
1137void libertas_interrupt(struct net_device *dev)
1138{
1139 wlan_private *priv = dev->priv;
1140
ed37b516 1141 lbs_deb_enter(LBS_DEB_THREAD);
876c9d3a 1142
ed37b516 1143 lbs_deb_thread("libertas_interrupt: intcounter=%d\n",
876c9d3a
MT		 1144 priv->adapter->intcounter);
1145
1146 priv->adapter->intcounter++;
1147
1148 if (priv->adapter->psstate == PS_STATE_SLEEP) {
1149 priv->adapter->psstate = PS_STATE_AWAKE;
1150 netif_wake_queue(dev);
51d84f50 1151 netif_wake_queue(priv->mesh_dev);
876c9d3a
MT		 1152 }
1153
1154 wake_up_interruptible(&priv->mainthread.waitq);
1155
ed37b516 1156 lbs_deb_leave(LBS_DEB_THREAD);
876c9d3a 1157}
084708b6 1158EXPORT_SYMBOL_GPL(libertas_interrupt);
876c9d3a 1159
084708b6 1160static int libertas_init_module(void)
876c9d3a 1161{
9012b28a 1162 lbs_deb_enter(LBS_DEB_MAIN);
876c9d3a 1163 libertas_debugfs_init();
084708b6
HS		 1164 lbs_deb_leave(LBS_DEB_MAIN);
1165 return 0;
876c9d3a
MT		 1166}
1167
084708b6 1168static void libertas_exit_module(void)
876c9d3a 1169{
9012b28a 1170 lbs_deb_enter(LBS_DEB_MAIN);
876c9d3a 1171
876c9d3a
MT		 1172 libertas_debugfs_remove();
1173
9012b28a 1174 lbs_deb_leave(LBS_DEB_MAIN);
876c9d3a
MT		 1175}
1176
084708b6
HS		 1177module_init(libertas_init_module);
1178module_exit(libertas_exit_module);
876c9d3a 1179
084708b6 1180MODULE_DESCRIPTION("Libertas WLAN Driver Library");
876c9d3a
MT		 1181MODULE_AUTHOR("Marvell International Ltd.");
1182MODULE_LICENSE("GPL");
Linux 6.x block layer and io_uring tree(s)