2 * This file contains the major functions in WLAN
3 * driver. It includes init, exit, open, close and main
7 #include <linux/moduleparam.h>
8 #include <linux/delay.h>
9 #include <linux/etherdevice.h>
10 #include <linux/netdevice.h>
11 #include <linux/if_arp.h>
12 #include <linux/kthread.h>
14 #include <net/iw_handler.h>
15 #include <net/ieee80211.h>
26 #define DRIVER_RELEASE_VERSION "323.p0"
27 const char lbs_driver_version[] = "COMM-USB8388-" DRIVER_RELEASE_VERSION
34 /* Module parameters */
35 unsigned int lbs_debug;
36 EXPORT_SYMBOL_GPL(lbs_debug);
37 module_param_named(libertas_debug, lbs_debug, int, 0644);
40 #define LBS_TX_PWR_DEFAULT 20 /*100mW */
41 #define LBS_TX_PWR_US_DEFAULT 20 /*100mW */
42 #define LBS_TX_PWR_JP_DEFAULT 16 /*50mW */
43 #define LBS_TX_PWR_FR_DEFAULT 20 /*100mW */
44 #define LBS_TX_PWR_EMEA_DEFAULT 20 /*100mW */
46 /* Format { channel, frequency (MHz), maxtxpower } */
47 /* band: 'B/G', region: USA FCC/Canada IC */
48 static struct chan_freq_power channel_freq_power_US_BG[] = {
49 {1, 2412, LBS_TX_PWR_US_DEFAULT},
50 {2, 2417, LBS_TX_PWR_US_DEFAULT},
51 {3, 2422, LBS_TX_PWR_US_DEFAULT},
52 {4, 2427, LBS_TX_PWR_US_DEFAULT},
53 {5, 2432, LBS_TX_PWR_US_DEFAULT},
54 {6, 2437, LBS_TX_PWR_US_DEFAULT},
55 {7, 2442, LBS_TX_PWR_US_DEFAULT},
56 {8, 2447, LBS_TX_PWR_US_DEFAULT},
57 {9, 2452, LBS_TX_PWR_US_DEFAULT},
58 {10, 2457, LBS_TX_PWR_US_DEFAULT},
59 {11, 2462, LBS_TX_PWR_US_DEFAULT}
62 /* band: 'B/G', region: Europe ETSI */
63 static struct chan_freq_power channel_freq_power_EU_BG[] = {
64 {1, 2412, LBS_TX_PWR_EMEA_DEFAULT},
65 {2, 2417, LBS_TX_PWR_EMEA_DEFAULT},
66 {3, 2422, LBS_TX_PWR_EMEA_DEFAULT},
67 {4, 2427, LBS_TX_PWR_EMEA_DEFAULT},
68 {5, 2432, LBS_TX_PWR_EMEA_DEFAULT},
69 {6, 2437, LBS_TX_PWR_EMEA_DEFAULT},
70 {7, 2442, LBS_TX_PWR_EMEA_DEFAULT},
71 {8, 2447, LBS_TX_PWR_EMEA_DEFAULT},
72 {9, 2452, LBS_TX_PWR_EMEA_DEFAULT},
73 {10, 2457, LBS_TX_PWR_EMEA_DEFAULT},
74 {11, 2462, LBS_TX_PWR_EMEA_DEFAULT},
75 {12, 2467, LBS_TX_PWR_EMEA_DEFAULT},
76 {13, 2472, LBS_TX_PWR_EMEA_DEFAULT}
79 /* band: 'B/G', region: Spain */
80 static struct chan_freq_power channel_freq_power_SPN_BG[] = {
81 {10, 2457, LBS_TX_PWR_DEFAULT},
82 {11, 2462, LBS_TX_PWR_DEFAULT}
85 /* band: 'B/G', region: France */
86 static struct chan_freq_power channel_freq_power_FR_BG[] = {
87 {10, 2457, LBS_TX_PWR_FR_DEFAULT},
88 {11, 2462, LBS_TX_PWR_FR_DEFAULT},
89 {12, 2467, LBS_TX_PWR_FR_DEFAULT},
90 {13, 2472, LBS_TX_PWR_FR_DEFAULT}
93 /* band: 'B/G', region: Japan */
94 static struct chan_freq_power channel_freq_power_JPN_BG[] = {
95 {1, 2412, LBS_TX_PWR_JP_DEFAULT},
96 {2, 2417, LBS_TX_PWR_JP_DEFAULT},
97 {3, 2422, LBS_TX_PWR_JP_DEFAULT},
98 {4, 2427, LBS_TX_PWR_JP_DEFAULT},
99 {5, 2432, LBS_TX_PWR_JP_DEFAULT},
100 {6, 2437, LBS_TX_PWR_JP_DEFAULT},
101 {7, 2442, LBS_TX_PWR_JP_DEFAULT},
102 {8, 2447, LBS_TX_PWR_JP_DEFAULT},
103 {9, 2452, LBS_TX_PWR_JP_DEFAULT},
104 {10, 2457, LBS_TX_PWR_JP_DEFAULT},
105 {11, 2462, LBS_TX_PWR_JP_DEFAULT},
106 {12, 2467, LBS_TX_PWR_JP_DEFAULT},
107 {13, 2472, LBS_TX_PWR_JP_DEFAULT},
108 {14, 2484, LBS_TX_PWR_JP_DEFAULT}
112 * the structure for channel, frequency and power
114 struct region_cfp_table {
116 struct chan_freq_power *cfp_BG;
121 * the structure for the mapping between region and CFP
123 static struct region_cfp_table region_cfp_table[] = {
125 channel_freq_power_US_BG,
126 ARRAY_SIZE(channel_freq_power_US_BG),
129 {0x20, /*CANADA IC */
130 channel_freq_power_US_BG,
131 ARRAY_SIZE(channel_freq_power_US_BG),
134 {0x30, /*EU*/ channel_freq_power_EU_BG,
135 ARRAY_SIZE(channel_freq_power_EU_BG),
138 {0x31, /*SPAIN*/ channel_freq_power_SPN_BG,
139 ARRAY_SIZE(channel_freq_power_SPN_BG),
142 {0x32, /*FRANCE*/ channel_freq_power_FR_BG,
143 ARRAY_SIZE(channel_freq_power_FR_BG),
146 {0x40, /*JAPAN*/ channel_freq_power_JPN_BG,
147 ARRAY_SIZE(channel_freq_power_JPN_BG),
150 /*Add new region here */
154 * the table to keep region code
156 u16 lbs_region_code_to_index[MRVDRV_MAX_REGION_CODE] =
157 { 0x10, 0x20, 0x30, 0x31, 0x32, 0x40 };
160 * 802.11b/g supported bitrates (in 500Kb/s units)
162 u8 lbs_bg_rates[MAX_RATES] =
163 { 0x02, 0x04, 0x0b, 0x16, 0x0c, 0x12, 0x18, 0x24, 0x30, 0x48, 0x60, 0x6c,
167 * FW rate table. FW refers to rates by their index in this table, not by the
168 * rate value itself. Values of 0x00 are
169 * reserved positions.
171 static u8 fw_data_rates[MAX_RATES] =
172 { 0x02, 0x04, 0x0B, 0x16, 0x00, 0x0C, 0x12,
173 0x18, 0x24, 0x30, 0x48, 0x60, 0x6C, 0x00
177 * @brief use index to get the data rate
179 * @param idx The index of data rate
180 * @return data rate or 0
182 u32 lbs_fw_index_to_data_rate(u8 idx)
184 if (idx >= sizeof(fw_data_rates))
186 return fw_data_rates[idx];
190 * @brief use rate to get the index
192 * @param rate data rate
195 u8 lbs_data_rate_to_fw_index(u32 rate)
202 for (i = 0; i < sizeof(fw_data_rates); i++) {
203 if (rate == fw_data_rates[i])
210 * Attributes exported through sysfs
214 * @brief Get function for sysfs attribute anycast_mask
216 static ssize_t lbs_anycast_get(struct device *dev,
217 struct device_attribute *attr, char * buf)
219 struct lbs_private *priv = to_net_dev(dev)->priv;
220 struct cmd_ds_mesh_access mesh_access;
223 memset(&mesh_access, 0, sizeof(mesh_access));
225 ret = lbs_mesh_access(priv, CMD_ACT_MESH_GET_ANYCAST, &mesh_access);
229 return snprintf(buf, 12, "0x%X\n", le32_to_cpu(mesh_access.data[0]));
233 * @brief Set function for sysfs attribute anycast_mask
235 static ssize_t lbs_anycast_set(struct device *dev,
236 struct device_attribute *attr, const char * buf, size_t count)
238 struct lbs_private *priv = to_net_dev(dev)->priv;
239 struct cmd_ds_mesh_access mesh_access;
243 memset(&mesh_access, 0, sizeof(mesh_access));
244 sscanf(buf, "%x", &datum);
245 mesh_access.data[0] = cpu_to_le32(datum);
247 ret = lbs_mesh_access(priv, CMD_ACT_MESH_SET_ANYCAST, &mesh_access);
254 static int lbs_add_rtap(struct lbs_private *priv);
255 static void lbs_remove_rtap(struct lbs_private *priv);
256 static int lbs_add_mesh(struct lbs_private *priv);
257 static void lbs_remove_mesh(struct lbs_private *priv);
261 * Get function for sysfs attribute rtap
263 static ssize_t lbs_rtap_get(struct device *dev,
264 struct device_attribute *attr, char * buf)
266 struct lbs_private *priv = to_net_dev(dev)->priv;
267 return snprintf(buf, 5, "0x%X\n", priv->monitormode);
271 * Set function for sysfs attribute rtap
273 static ssize_t lbs_rtap_set(struct device *dev,
274 struct device_attribute *attr, const char * buf, size_t count)
277 struct lbs_private *priv = to_net_dev(dev)->priv;
279 sscanf(buf, "%x", &monitor_mode);
281 if (priv->monitormode == monitor_mode)
283 if (!priv->monitormode) {
284 if (priv->infra_open || priv->mesh_open)
286 if (priv->mode == IW_MODE_INFRA)
287 lbs_send_deauthentication(priv);
288 else if (priv->mode == IW_MODE_ADHOC)
289 lbs_stop_adhoc_network(priv);
292 priv->monitormode = monitor_mode;
296 if (!priv->monitormode)
298 priv->monitormode = 0;
299 lbs_remove_rtap(priv);
301 if (priv->currenttxskb) {
302 dev_kfree_skb_any(priv->currenttxskb);
303 priv->currenttxskb = NULL;
306 /* Wake queues, command thread, etc. */
307 lbs_host_to_card_done(priv);
310 lbs_prepare_and_send_command(priv,
311 CMD_802_11_MONITOR_MODE, CMD_ACT_SET,
312 CMD_OPTION_WAITFORRSP, 0, &priv->monitormode);
317 * lbs_rtap attribute to be exported per ethX interface
318 * through sysfs (/sys/class/net/ethX/lbs_rtap)
320 static DEVICE_ATTR(lbs_rtap, 0644, lbs_rtap_get, lbs_rtap_set );
323 * Get function for sysfs attribute mesh
325 static ssize_t lbs_mesh_get(struct device *dev,
326 struct device_attribute *attr, char * buf)
328 struct lbs_private *priv = to_net_dev(dev)->priv;
329 return snprintf(buf, 5, "0x%X\n", !!priv->mesh_dev);
333 * Set function for sysfs attribute mesh
335 static ssize_t lbs_mesh_set(struct device *dev,
336 struct device_attribute *attr, const char * buf, size_t count)
338 struct lbs_private *priv = to_net_dev(dev)->priv;
342 sscanf(buf, "%x", &enable);
344 if (enable == !!priv->mesh_dev)
347 ret = lbs_mesh_config(priv, enable, priv->curbssparams.channel);
354 lbs_remove_mesh(priv);
360 * lbs_mesh attribute to be exported per ethX interface
361 * through sysfs (/sys/class/net/ethX/lbs_mesh)
363 static DEVICE_ATTR(lbs_mesh, 0644, lbs_mesh_get, lbs_mesh_set);
366 * anycast_mask attribute to be exported per mshX interface
367 * through sysfs (/sys/class/net/mshX/anycast_mask)
369 static DEVICE_ATTR(anycast_mask, 0644, lbs_anycast_get, lbs_anycast_set);
371 static struct attribute *lbs_mesh_sysfs_entries[] = {
372 &dev_attr_anycast_mask.attr,
376 static struct attribute_group lbs_mesh_attr_group = {
377 .attrs = lbs_mesh_sysfs_entries,
381 * @brief This function opens the ethX or mshX interface
383 * @param dev A pointer to net_device structure
384 * @return 0 or -EBUSY if monitor mode active
386 static int lbs_dev_open(struct net_device *dev)
388 struct lbs_private *priv = (struct lbs_private *) dev->priv ;
391 lbs_deb_enter(LBS_DEB_NET);
393 spin_lock_irq(&priv->driver_lock);
395 if (priv->monitormode) {
400 if (dev == priv->mesh_dev) {
402 priv->mesh_connect_status = LBS_CONNECTED;
403 netif_carrier_on(dev);
405 priv->infra_open = 1;
407 if (priv->connect_status == LBS_CONNECTED)
408 netif_carrier_on(dev);
410 netif_carrier_off(dev);
413 if (!priv->tx_pending_len)
414 netif_wake_queue(dev);
417 spin_unlock_irq(&priv->driver_lock);
418 lbs_deb_leave_args(LBS_DEB_NET, "ret %d", ret);
423 * @brief This function closes the mshX interface
425 * @param dev A pointer to net_device structure
428 static int lbs_mesh_stop(struct net_device *dev)
430 struct lbs_private *priv = (struct lbs_private *) (dev->priv);
432 lbs_deb_enter(LBS_DEB_MESH);
433 spin_lock_irq(&priv->driver_lock);
436 priv->mesh_connect_status = LBS_DISCONNECTED;
438 netif_stop_queue(dev);
439 netif_carrier_off(dev);
441 spin_unlock_irq(&priv->driver_lock);
443 lbs_deb_leave(LBS_DEB_MESH);
448 * @brief This function closes the ethX interface
450 * @param dev A pointer to net_device structure
453 static int lbs_eth_stop(struct net_device *dev)
455 struct lbs_private *priv = (struct lbs_private *) dev->priv;
457 lbs_deb_enter(LBS_DEB_NET);
459 spin_lock_irq(&priv->driver_lock);
460 priv->infra_open = 0;
461 netif_stop_queue(dev);
462 spin_unlock_irq(&priv->driver_lock);
464 lbs_deb_leave(LBS_DEB_NET);
468 static void lbs_tx_timeout(struct net_device *dev)
470 struct lbs_private *priv = (struct lbs_private *) dev->priv;
472 lbs_deb_enter(LBS_DEB_TX);
474 lbs_pr_err("tx watch dog timeout\n");
476 dev->trans_start = jiffies;
478 if (priv->currenttxskb) {
479 priv->eventcause = 0x01000000;
480 lbs_send_tx_feedback(priv);
482 /* XX: Shouldn't we also call into the hw-specific driver
483 to kick it somehow? */
484 lbs_host_to_card_done(priv);
486 /* More often than not, this actually happens because the
487 firmware has crapped itself -- rather than just a very
488 busy medium. So send a harmless command, and if/when
489 _that_ times out, we'll kick it in the head. */
490 lbs_prepare_and_send_command(priv, CMD_802_11_RSSI, 0,
493 lbs_deb_leave(LBS_DEB_TX);
496 void lbs_host_to_card_done(struct lbs_private *priv)
500 lbs_deb_enter(LBS_DEB_THREAD);
502 spin_lock_irqsave(&priv->driver_lock, flags);
504 priv->dnld_sent = DNLD_RES_RECEIVED;
506 /* Wake main thread if commands are pending */
507 if (!priv->cur_cmd || priv->tx_pending_len > 0)
508 wake_up_interruptible(&priv->waitq);
510 spin_unlock_irqrestore(&priv->driver_lock, flags);
511 lbs_deb_leave(LBS_DEB_THREAD);
513 EXPORT_SYMBOL_GPL(lbs_host_to_card_done);
516 * @brief This function returns the network statistics
518 * @param dev A pointer to struct lbs_private structure
519 * @return A pointer to net_device_stats structure
521 static struct net_device_stats *lbs_get_stats(struct net_device *dev)
523 struct lbs_private *priv = (struct lbs_private *) dev->priv;
525 lbs_deb_enter(LBS_DEB_NET);
529 static int lbs_set_mac_address(struct net_device *dev, void *addr)
532 struct lbs_private *priv = (struct lbs_private *) dev->priv;
533 struct sockaddr *phwaddr = addr;
535 lbs_deb_enter(LBS_DEB_NET);
537 /* In case it was called from the mesh device */
540 memset(priv->current_addr, 0, ETH_ALEN);
542 /* dev->dev_addr is 8 bytes */
543 lbs_deb_hex(LBS_DEB_NET, "dev->dev_addr", dev->dev_addr, ETH_ALEN);
545 lbs_deb_hex(LBS_DEB_NET, "addr", phwaddr->sa_data, ETH_ALEN);
546 memcpy(priv->current_addr, phwaddr->sa_data, ETH_ALEN);
548 ret = lbs_prepare_and_send_command(priv, CMD_802_11_MAC_ADDRESS,
550 CMD_OPTION_WAITFORRSP, 0, NULL);
553 lbs_deb_net("set MAC address failed\n");
558 lbs_deb_hex(LBS_DEB_NET, "priv->macaddr", priv->current_addr, ETH_ALEN);
559 memcpy(dev->dev_addr, priv->current_addr, ETH_ALEN);
561 memcpy(priv->mesh_dev->dev_addr, priv->current_addr, ETH_ALEN);
564 lbs_deb_leave_args(LBS_DEB_NET, "ret %d", ret);
568 static int lbs_copy_multicast_address(struct lbs_private *priv,
569 struct net_device *dev)
572 struct dev_mc_list *mcptr = dev->mc_list;
574 for (i = 0; i < dev->mc_count; i++) {
575 memcpy(&priv->multicastlist[i], mcptr->dmi_addr, ETH_ALEN);
581 static void lbs_set_multicast_list(struct net_device *dev)
583 struct lbs_private *priv = dev->priv;
585 DECLARE_MAC_BUF(mac);
587 lbs_deb_enter(LBS_DEB_NET);
589 old_mac_control = priv->mac_control;
591 if (dev->flags & IFF_PROMISC) {
592 lbs_deb_net("enable promiscuous mode\n");
594 CMD_ACT_MAC_PROMISCUOUS_ENABLE;
596 ~(CMD_ACT_MAC_ALL_MULTICAST_ENABLE |
597 CMD_ACT_MAC_MULTICAST_ENABLE);
601 ~CMD_ACT_MAC_PROMISCUOUS_ENABLE;
603 if (dev->flags & IFF_ALLMULTI || dev->mc_count >
604 MRVDRV_MAX_MULTICAST_LIST_SIZE) {
605 lbs_deb_net( "enabling all multicast\n");
607 CMD_ACT_MAC_ALL_MULTICAST_ENABLE;
609 ~CMD_ACT_MAC_MULTICAST_ENABLE;
612 ~CMD_ACT_MAC_ALL_MULTICAST_ENABLE;
614 if (!dev->mc_count) {
615 lbs_deb_net("no multicast addresses, "
616 "disabling multicast\n");
618 ~CMD_ACT_MAC_MULTICAST_ENABLE;
623 CMD_ACT_MAC_MULTICAST_ENABLE;
625 priv->nr_of_multicastmacaddr =
626 lbs_copy_multicast_address(priv, dev);
628 lbs_deb_net("multicast addresses: %d\n",
631 for (i = 0; i < dev->mc_count; i++) {
632 lbs_deb_net("Multicast address %d: %s\n",
634 priv->multicastlist[i]));
636 /* send multicast addresses to firmware */
637 lbs_prepare_and_send_command(priv,
638 CMD_MAC_MULTICAST_ADR,
645 if (priv->mac_control != old_mac_control)
646 lbs_set_mac_control(priv);
648 lbs_deb_leave(LBS_DEB_NET);
652 * @brief This function handles the major jobs in the LBS driver.
653 * It handles all events generated by firmware, RX data received
654 * from firmware and TX data sent from kernel.
656 * @param data A pointer to lbs_thread structure
659 static int lbs_thread(void *data)
661 struct net_device *dev = data;
662 struct lbs_private *priv = dev->priv;
666 lbs_deb_enter(LBS_DEB_THREAD);
668 init_waitqueue_entry(&wait, current);
673 lbs_deb_thread( "main-thread 111: intcounter=%d currenttxskb=%p dnld_sent=%d\n",
674 priv->intcounter, priv->currenttxskb, priv->dnld_sent);
676 add_wait_queue(&priv->waitq, &wait);
677 set_current_state(TASK_INTERRUPTIBLE);
678 spin_lock_irq(&priv->driver_lock);
680 if (kthread_should_stop())
681 shouldsleep = 0; /* Bye */
682 else if (priv->surpriseremoved)
683 shouldsleep = 1; /* We need to wait until we're _told_ to die */
684 else if (priv->psstate == PS_STATE_SLEEP)
685 shouldsleep = 1; /* Sleep mode. Nothing we can do till it wakes */
686 else if (priv->intcounter)
687 shouldsleep = 0; /* Interrupt pending. Deal with it now */
688 else if (priv->cmd_timed_out)
689 shouldsleep = 0; /* Command timed out. Recover */
690 else if (!priv->fw_ready)
691 shouldsleep = 1; /* Firmware not ready. We're waiting for it */
692 else if (priv->dnld_sent)
693 shouldsleep = 1; /* Something is en route to the device already */
694 else if (priv->tx_pending_len > 0)
695 shouldsleep = 0; /* We've a packet to send */
696 else if (priv->cur_cmd)
697 shouldsleep = 1; /* Can't send a command; one already running */
698 else if (!list_empty(&priv->cmdpendingq))
699 shouldsleep = 0; /* We have a command to send */
701 shouldsleep = 1; /* No command */
704 lbs_deb_thread("main-thread sleeping... Conn=%d IntC=%d PS_mode=%d PS_State=%d\n",
705 priv->connect_status, priv->intcounter,
706 priv->psmode, priv->psstate);
707 spin_unlock_irq(&priv->driver_lock);
710 spin_unlock_irq(&priv->driver_lock);
712 lbs_deb_thread("main-thread 222 (waking up): intcounter=%d currenttxskb=%p dnld_sent=%d\n",
713 priv->intcounter, priv->currenttxskb, priv->dnld_sent);
715 set_current_state(TASK_RUNNING);
716 remove_wait_queue(&priv->waitq, &wait);
718 lbs_deb_thread("main-thread 333: intcounter=%d currenttxskb=%p dnld_sent=%d\n",
719 priv->intcounter, priv->currenttxskb, priv->dnld_sent);
721 if (kthread_should_stop()) {
722 lbs_deb_thread("main-thread: break from main thread\n");
726 if (priv->surpriseremoved) {
727 lbs_deb_thread("adapter removed; waiting to die...\n");
731 spin_lock_irq(&priv->driver_lock);
733 if (priv->intcounter) {
736 priv->intcounter = 0;
737 int_status = priv->hw_get_int_status(priv, &ireg);
740 lbs_deb_thread("main-thread: reading HOST_INT_STATUS_REG failed\n");
741 spin_unlock_irq(&priv->driver_lock);
744 priv->hisregcpy |= ireg;
747 lbs_deb_thread("main-thread 444: intcounter=%d currenttxskb=%p dnld_sent=%d\n",
748 priv->intcounter, priv->currenttxskb, priv->dnld_sent);
750 /* command response? */
751 if (priv->hisregcpy & MRVDRV_CMD_UPLD_RDY) {
752 lbs_deb_thread("main-thread: cmd response ready\n");
754 priv->hisregcpy &= ~MRVDRV_CMD_UPLD_RDY;
755 spin_unlock_irq(&priv->driver_lock);
756 lbs_process_rx_command(priv);
757 spin_lock_irq(&priv->driver_lock);
760 if (priv->cmd_timed_out && priv->cur_cmd) {
761 struct cmd_ctrl_node *cmdnode = priv->cur_cmd;
763 if (++priv->nr_retries > 10) {
764 lbs_pr_info("Excessive timeouts submitting command %x\n",
765 le16_to_cpu(cmdnode->cmdbuf->command));
766 lbs_complete_command(priv, cmdnode, -ETIMEDOUT);
767 priv->nr_retries = 0;
769 priv->cur_cmd = NULL;
770 lbs_pr_info("requeueing command %x due to timeout (#%d)\n",
771 le16_to_cpu(cmdnode->cmdbuf->command), priv->nr_retries);
773 /* Stick it back at the _top_ of the pending queue
774 for immediate resubmission */
775 list_add(&cmdnode->list, &priv->cmdpendingq);
778 priv->cmd_timed_out = 0;
781 if (priv->hisregcpy & MRVDRV_CARDEVENT) {
782 lbs_deb_thread("main-thread: Card Event Activity\n");
784 priv->hisregcpy &= ~MRVDRV_CARDEVENT;
786 if (priv->hw_read_event_cause(priv)) {
787 lbs_pr_alert("main-thread: hw_read_event_cause failed\n");
788 spin_unlock_irq(&priv->driver_lock);
791 spin_unlock_irq(&priv->driver_lock);
792 lbs_process_event(priv);
794 spin_unlock_irq(&priv->driver_lock);
799 /* Check if we need to confirm Sleep Request received previously */
800 if (priv->psstate == PS_STATE_PRE_SLEEP &&
801 !priv->dnld_sent && !priv->cur_cmd) {
802 if (priv->connect_status == LBS_CONNECTED) {
803 lbs_deb_thread("main_thread: PRE_SLEEP--intcounter=%d currenttxskb=%p dnld_sent=%d cur_cmd=%p, confirm now\n",
804 priv->intcounter, priv->currenttxskb, priv->dnld_sent, priv->cur_cmd);
806 lbs_ps_confirm_sleep(priv);
808 /* workaround for firmware sending
809 * deauth/linkloss event immediately
810 * after sleep request; remove this
811 * after firmware fixes it
813 priv->psstate = PS_STATE_AWAKE;
814 lbs_pr_alert("main-thread: ignore PS_SleepConfirm in non-connected state\n");
818 /* The PS state is changed during processing of Sleep Request
821 if ((priv->psstate == PS_STATE_SLEEP) ||
822 (priv->psstate == PS_STATE_PRE_SLEEP))
825 /* Execute the next command */
826 if (!priv->dnld_sent && !priv->cur_cmd)
827 lbs_execute_next_command(priv);
829 /* Wake-up command waiters which can't sleep in
830 * lbs_prepare_and_send_command
832 if (!list_empty(&priv->cmdpendingq))
833 wake_up_all(&priv->cmd_pending);
835 spin_lock_irq(&priv->driver_lock);
836 if (!priv->dnld_sent && priv->tx_pending_len > 0) {
837 int ret = priv->hw_host_to_card(priv, MVMS_DAT,
838 priv->tx_pending_buf,
839 priv->tx_pending_len);
841 lbs_deb_tx("host_to_card failed %d\n", ret);
842 priv->dnld_sent = DNLD_RES_RECEIVED;
844 priv->tx_pending_len = 0;
845 if (!priv->currenttxskb) {
846 /* We can wake the queues immediately if we aren't
847 waiting for TX feedback */
848 if (priv->connect_status == LBS_CONNECTED)
849 netif_wake_queue(priv->dev);
850 if (priv->mesh_dev &&
851 priv->mesh_connect_status == LBS_CONNECTED)
852 netif_wake_queue(priv->mesh_dev);
855 spin_unlock_irq(&priv->driver_lock);
858 del_timer(&priv->command_timer);
859 wake_up_all(&priv->cmd_pending);
861 lbs_deb_leave(LBS_DEB_THREAD);
865 static int lbs_suspend_callback(struct lbs_private *priv, unsigned long dummy,
866 struct cmd_header *cmd)
868 lbs_deb_enter(LBS_DEB_FW);
870 netif_device_detach(priv->dev);
872 netif_device_detach(priv->mesh_dev);
875 lbs_deb_leave(LBS_DEB_FW);
879 int lbs_suspend(struct lbs_private *priv)
881 struct cmd_header cmd;
884 lbs_deb_enter(LBS_DEB_FW);
886 if (priv->wol_criteria == 0xffffffff) {
887 lbs_pr_info("Suspend attempt without configuring wake params!\n");
891 memset(&cmd, 0, sizeof(cmd));
893 ret = __lbs_cmd(priv, CMD_802_11_HOST_SLEEP_ACTIVATE, &cmd,
894 sizeof(cmd), lbs_suspend_callback, 0);
896 lbs_pr_info("HOST_SLEEP_ACTIVATE failed: %d\n", ret);
898 lbs_deb_leave_args(LBS_DEB_FW, "ret %d", ret);
901 EXPORT_SYMBOL_GPL(lbs_suspend);
903 int lbs_resume(struct lbs_private *priv)
905 lbs_deb_enter(LBS_DEB_FW);
909 /* Firmware doesn't seem to give us RX packets any more
910 until we send it some command. Might as well update */
911 lbs_prepare_and_send_command(priv, CMD_802_11_RSSI, 0,
914 netif_device_attach(priv->dev);
916 netif_device_attach(priv->mesh_dev);
918 lbs_deb_leave(LBS_DEB_FW);
921 EXPORT_SYMBOL_GPL(lbs_resume);
924 * @brief This function downloads firmware image, gets
925 * HW spec from firmware and set basic parameters to
928 * @param priv A pointer to struct lbs_private structure
931 static int lbs_setup_firmware(struct lbs_private *priv)
935 lbs_deb_enter(LBS_DEB_FW);
938 * Read MAC address from HW
940 memset(priv->current_addr, 0xff, ETH_ALEN);
941 ret = lbs_update_hw_spec(priv);
947 lbs_set_mac_control(priv);
949 ret = lbs_get_data_rate(priv);
957 lbs_deb_leave_args(LBS_DEB_FW, "ret %d", ret);
962 * This function handles the timeout of command sending.
963 * It will re-send the same command again.
965 static void command_timer_fn(unsigned long data)
967 struct lbs_private *priv = (struct lbs_private *)data;
970 lbs_deb_enter(LBS_DEB_CMD);
971 spin_lock_irqsave(&priv->driver_lock, flags);
973 if (!priv->cur_cmd) {
974 lbs_pr_info("Command timer expired; no pending command\n");
978 lbs_pr_info("Command %x timed out\n", le16_to_cpu(priv->cur_cmd->cmdbuf->command));
980 priv->cmd_timed_out = 1;
981 wake_up_interruptible(&priv->waitq);
983 spin_unlock_irqrestore(&priv->driver_lock, flags);
984 lbs_deb_leave(LBS_DEB_CMD);
987 static void lbs_sync_channel_worker(struct work_struct *work)
989 struct lbs_private *priv = container_of(work, struct lbs_private,
992 lbs_deb_enter(LBS_DEB_MAIN);
993 if (lbs_update_channel(priv))
994 lbs_pr_info("Channel synchronization failed.");
995 lbs_deb_leave(LBS_DEB_MAIN);
999 static int lbs_init_adapter(struct lbs_private *priv)
1004 lbs_deb_enter(LBS_DEB_MAIN);
1006 /* Allocate buffer to store the BSSID list */
1007 bufsize = MAX_NETWORK_COUNT * sizeof(struct bss_descriptor);
1008 priv->networks = kzalloc(bufsize, GFP_KERNEL);
1009 if (!priv->networks) {
1010 lbs_pr_err("Out of memory allocating beacons\n");
1015 /* Initialize scan result lists */
1016 INIT_LIST_HEAD(&priv->network_free_list);
1017 INIT_LIST_HEAD(&priv->network_list);
1018 for (i = 0; i < MAX_NETWORK_COUNT; i++) {
1019 list_add_tail(&priv->networks[i].list,
1020 &priv->network_free_list);
1023 priv->lbs_ps_confirm_sleep.seqnum = cpu_to_le16(++priv->seqnum);
1024 priv->lbs_ps_confirm_sleep.command =
1025 cpu_to_le16(CMD_802_11_PS_MODE);
1026 priv->lbs_ps_confirm_sleep.size =
1027 cpu_to_le16(sizeof(struct PS_CMD_ConfirmSleep));
1028 priv->lbs_ps_confirm_sleep.action =
1029 cpu_to_le16(CMD_SUBCMD_SLEEP_CONFIRMED);
1031 memset(priv->current_addr, 0xff, ETH_ALEN);
1033 priv->connect_status = LBS_DISCONNECTED;
1034 priv->mesh_connect_status = LBS_DISCONNECTED;
1035 priv->secinfo.auth_mode = IW_AUTH_ALG_OPEN_SYSTEM;
1036 priv->mode = IW_MODE_INFRA;
1037 priv->curbssparams.channel = DEFAULT_AD_HOC_CHANNEL;
1038 priv->mac_control = CMD_ACT_MAC_RX_ON | CMD_ACT_MAC_TX_ON;
1039 priv->radioon = RADIO_ON;
1040 priv->auto_rate = 1;
1041 priv->capability = WLAN_CAPABILITY_SHORT_PREAMBLE;
1042 priv->psmode = LBS802_11POWERMODECAM;
1043 priv->psstate = PS_STATE_FULL_POWER;
1045 mutex_init(&priv->lock);
1047 setup_timer(&priv->command_timer, command_timer_fn,
1048 (unsigned long)priv);
1050 INIT_LIST_HEAD(&priv->cmdfreeq);
1051 INIT_LIST_HEAD(&priv->cmdpendingq);
1053 spin_lock_init(&priv->driver_lock);
1054 init_waitqueue_head(&priv->cmd_pending);
1056 /* Allocate the command buffers */
1057 if (lbs_allocate_cmd_buffer(priv)) {
1058 lbs_pr_err("Out of memory allocating command buffers\n");
1063 lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
1068 static void lbs_free_adapter(struct lbs_private *priv)
1070 lbs_deb_enter(LBS_DEB_MAIN);
1072 lbs_free_cmd_buffer(priv);
1073 del_timer(&priv->command_timer);
1074 kfree(priv->networks);
1075 priv->networks = NULL;
1077 lbs_deb_leave(LBS_DEB_MAIN);
1081 * @brief This function adds the card. it will probe the
1082 * card, allocate the lbs_priv and initialize the device.
1084 * @param card A pointer to card
1085 * @return A pointer to struct lbs_private structure
1087 struct lbs_private *lbs_add_card(void *card, struct device *dmdev)
1089 struct net_device *dev = NULL;
1090 struct lbs_private *priv = NULL;
1092 lbs_deb_enter(LBS_DEB_MAIN);
1094 /* Allocate an Ethernet device and register it */
1095 dev = alloc_etherdev(sizeof(struct lbs_private));
1097 lbs_pr_err("init ethX device failed\n");
1102 if (lbs_init_adapter(priv)) {
1103 lbs_pr_err("failed to initialize adapter structure.\n");
1104 goto err_init_adapter;
1109 priv->mesh_open = 0;
1110 priv->infra_open = 0;
1112 /* Setup the OS Interface to our functions */
1113 dev->open = lbs_dev_open;
1114 dev->hard_start_xmit = lbs_hard_start_xmit;
1115 dev->stop = lbs_eth_stop;
1116 dev->set_mac_address = lbs_set_mac_address;
1117 dev->tx_timeout = lbs_tx_timeout;
1118 dev->get_stats = lbs_get_stats;
1119 dev->watchdog_timeo = 5 * HZ;
1120 dev->ethtool_ops = &lbs_ethtool_ops;
1122 dev->wireless_handlers = (struct iw_handler_def *)&lbs_handler_def;
1124 dev->flags |= IFF_BROADCAST | IFF_MULTICAST;
1125 dev->set_multicast_list = lbs_set_multicast_list;
1127 SET_NETDEV_DEV(dev, dmdev);
1129 priv->rtap_net_dev = NULL;
1131 lbs_deb_thread("Starting main thread...\n");
1132 init_waitqueue_head(&priv->waitq);
1133 priv->main_thread = kthread_run(lbs_thread, dev, "lbs_main");
1134 if (IS_ERR(priv->main_thread)) {
1135 lbs_deb_thread("Error creating main thread.\n");
1136 goto err_init_adapter;
1139 priv->work_thread = create_singlethread_workqueue("lbs_worker");
1140 INIT_DELAYED_WORK(&priv->assoc_work, lbs_association_worker);
1141 INIT_DELAYED_WORK(&priv->scan_work, lbs_scan_worker);
1142 INIT_WORK(&priv->sync_channel, lbs_sync_channel_worker);
1144 sprintf(priv->mesh_ssid, "mesh");
1145 priv->mesh_ssid_len = 4;
1147 priv->wol_criteria = 0xffffffff;
1148 priv->wol_gpio = 0xff;
1153 lbs_free_adapter(priv);
1158 lbs_deb_leave_args(LBS_DEB_MAIN, "priv %p", priv);
1161 EXPORT_SYMBOL_GPL(lbs_add_card);
1164 int lbs_remove_card(struct lbs_private *priv)
1166 struct net_device *dev = priv->dev;
1167 union iwreq_data wrqu;
1169 lbs_deb_enter(LBS_DEB_MAIN);
1171 lbs_remove_mesh(priv);
1172 lbs_remove_rtap(priv);
1176 cancel_delayed_work(&priv->scan_work);
1177 cancel_delayed_work(&priv->assoc_work);
1178 destroy_workqueue(priv->work_thread);
1180 if (priv->psmode == LBS802_11POWERMODEMAX_PSP) {
1181 priv->psmode = LBS802_11POWERMODECAM;
1182 lbs_ps_wakeup(priv, CMD_OPTION_WAITFORRSP);
1185 memset(wrqu.ap_addr.sa_data, 0xaa, ETH_ALEN);
1186 wrqu.ap_addr.sa_family = ARPHRD_ETHER;
1187 wireless_send_event(priv->dev, SIOCGIWAP, &wrqu, NULL);
1189 /* Stop the thread servicing the interrupts */
1190 priv->surpriseremoved = 1;
1191 kthread_stop(priv->main_thread);
1193 lbs_free_adapter(priv);
1198 lbs_deb_leave(LBS_DEB_MAIN);
1201 EXPORT_SYMBOL_GPL(lbs_remove_card);
1204 int lbs_start_card(struct lbs_private *priv)
1206 struct net_device *dev = priv->dev;
1209 lbs_deb_enter(LBS_DEB_MAIN);
1211 /* poke the firmware */
1212 ret = lbs_setup_firmware(priv);
1219 if (register_netdev(dev)) {
1220 lbs_pr_err("cannot register ethX device\n");
1223 if (device_create_file(&dev->dev, &dev_attr_lbs_rtap))
1224 lbs_pr_err("cannot register lbs_rtap attribute\n");
1226 lbs_update_channel(priv);
1228 /* 5.0.16p0 is known to NOT support any mesh */
1229 if (priv->fwrelease > 0x05001000) {
1230 /* Enable mesh, if supported, and work out which TLV it uses.
1231 0x100 + 291 is an unofficial value used in 5.110.20.pXX
1232 0x100 + 37 is the official value used in 5.110.21.pXX
1233 but we check them in that order because 20.pXX doesn't
1234 give an error -- it just silently fails. */
1236 /* 5.110.20.pXX firmware will fail the command if the channel
1237 doesn't match the existing channel. But only if the TLV
1238 is correct. If the channel is wrong, _BOTH_ versions will
1239 give an error to 0x100+291, and allow 0x100+37 to succeed.
1240 It's just that 5.110.20.pXX will not have done anything
1243 priv->mesh_tlv = 0x100 + 291;
1244 if (lbs_mesh_config(priv, 1, priv->curbssparams.channel)) {
1245 priv->mesh_tlv = 0x100 + 37;
1246 if (lbs_mesh_config(priv, 1, priv->curbssparams.channel))
1249 if (priv->mesh_tlv) {
1252 if (device_create_file(&dev->dev, &dev_attr_lbs_mesh))
1253 lbs_pr_err("cannot register lbs_mesh attribute\n");
1257 lbs_debugfs_init_one(priv, dev);
1259 lbs_pr_info("%s: Marvell WLAN 802.11 adapter\n", dev->name);
1264 lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
1267 EXPORT_SYMBOL_GPL(lbs_start_card);
1270 int lbs_stop_card(struct lbs_private *priv)
1272 struct net_device *dev = priv->dev;
1274 struct cmd_ctrl_node *cmdnode;
1275 unsigned long flags;
1277 lbs_deb_enter(LBS_DEB_MAIN);
1279 netif_stop_queue(priv->dev);
1280 netif_carrier_off(priv->dev);
1282 lbs_debugfs_remove_one(priv);
1283 device_remove_file(&dev->dev, &dev_attr_lbs_rtap);
1285 device_remove_file(&dev->dev, &dev_attr_lbs_mesh);
1287 /* Flush pending command nodes */
1288 spin_lock_irqsave(&priv->driver_lock, flags);
1289 list_for_each_entry(cmdnode, &priv->cmdpendingq, list) {
1290 cmdnode->result = -ENOENT;
1291 cmdnode->cmdwaitqwoken = 1;
1292 wake_up_interruptible(&cmdnode->cmdwait_q);
1294 spin_unlock_irqrestore(&priv->driver_lock, flags);
1296 unregister_netdev(dev);
1298 lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
1301 EXPORT_SYMBOL_GPL(lbs_stop_card);
1305 * @brief This function adds mshX interface
1307 * @param priv A pointer to the struct lbs_private structure
1308 * @return 0 if successful, -X otherwise
1310 static int lbs_add_mesh(struct lbs_private *priv)
1312 struct net_device *mesh_dev = NULL;
1315 lbs_deb_enter(LBS_DEB_MESH);
1317 /* Allocate a virtual mesh device */
1318 if (!(mesh_dev = alloc_netdev(0, "msh%d", ether_setup))) {
1319 lbs_deb_mesh("init mshX device failed\n");
1323 mesh_dev->priv = priv;
1324 priv->mesh_dev = mesh_dev;
1326 mesh_dev->open = lbs_dev_open;
1327 mesh_dev->hard_start_xmit = lbs_hard_start_xmit;
1328 mesh_dev->stop = lbs_mesh_stop;
1329 mesh_dev->get_stats = lbs_get_stats;
1330 mesh_dev->set_mac_address = lbs_set_mac_address;
1331 mesh_dev->ethtool_ops = &lbs_ethtool_ops;
1332 memcpy(mesh_dev->dev_addr, priv->dev->dev_addr,
1333 sizeof(priv->dev->dev_addr));
1335 SET_NETDEV_DEV(priv->mesh_dev, priv->dev->dev.parent);
1338 mesh_dev->wireless_handlers = (struct iw_handler_def *)&mesh_handler_def;
1340 /* Register virtual mesh interface */
1341 ret = register_netdev(mesh_dev);
1343 lbs_pr_err("cannot register mshX virtual interface\n");
1347 ret = sysfs_create_group(&(mesh_dev->dev.kobj), &lbs_mesh_attr_group);
1349 goto err_unregister;
1351 /* Everything successful */
1356 unregister_netdev(mesh_dev);
1359 free_netdev(mesh_dev);
1362 lbs_deb_leave_args(LBS_DEB_MESH, "ret %d", ret);
1366 static void lbs_remove_mesh(struct lbs_private *priv)
1368 struct net_device *mesh_dev;
1371 mesh_dev = priv->mesh_dev;
1375 lbs_deb_enter(LBS_DEB_MESH);
1376 netif_stop_queue(mesh_dev);
1377 netif_carrier_off(priv->mesh_dev);
1378 sysfs_remove_group(&(mesh_dev->dev.kobj), &lbs_mesh_attr_group);
1379 unregister_netdev(mesh_dev);
1380 priv->mesh_dev = NULL;
1381 free_netdev(mesh_dev);
1382 lbs_deb_leave(LBS_DEB_MESH);
1386 * @brief This function finds the CFP in
1387 * region_cfp_table based on region and band parameter.
1389 * @param region The region code
1390 * @param band The band
1391 * @param cfp_no A pointer to CFP number
1392 * @return A pointer to CFP
1394 struct chan_freq_power *lbs_get_region_cfp_table(u8 region, int *cfp_no)
1398 lbs_deb_enter(LBS_DEB_MAIN);
1400 end = ARRAY_SIZE(region_cfp_table);
1402 for (i = 0; i < end ; i++) {
1403 lbs_deb_main("region_cfp_table[i].region=%d\n",
1404 region_cfp_table[i].region);
1405 if (region_cfp_table[i].region == region) {
1406 *cfp_no = region_cfp_table[i].cfp_no_BG;
1407 lbs_deb_leave(LBS_DEB_MAIN);
1408 return region_cfp_table[i].cfp_BG;
1412 lbs_deb_leave_args(LBS_DEB_MAIN, "ret NULL");
1416 int lbs_set_regiontable(struct lbs_private *priv, u8 region, u8 band)
1421 struct chan_freq_power *cfp;
1424 lbs_deb_enter(LBS_DEB_MAIN);
1426 memset(priv->region_channel, 0, sizeof(priv->region_channel));
1428 cfp = lbs_get_region_cfp_table(region, &cfp_no);
1430 priv->region_channel[i].nrcfp = cfp_no;
1431 priv->region_channel[i].CFP = cfp;
1433 lbs_deb_main("wrong region code %#x in band B/G\n",
1438 priv->region_channel[i].valid = 1;
1439 priv->region_channel[i].region = region;
1440 priv->region_channel[i].band = band;
1443 lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
1448 * @brief This function handles the interrupt. it will change PS
1449 * state if applicable. it will wake up main_thread to handle
1450 * the interrupt event as well.
1452 * @param dev A pointer to net_device structure
1455 void lbs_interrupt(struct lbs_private *priv)
1457 lbs_deb_enter(LBS_DEB_THREAD);
1459 lbs_deb_thread("lbs_interrupt: intcounter=%d\n", priv->intcounter);
1461 if (priv->psstate == PS_STATE_SLEEP)
1462 priv->psstate = PS_STATE_AWAKE;
1463 wake_up_interruptible(&priv->waitq);
1465 lbs_deb_leave(LBS_DEB_THREAD);
1467 EXPORT_SYMBOL_GPL(lbs_interrupt);
1469 static int __init lbs_init_module(void)
1471 lbs_deb_enter(LBS_DEB_MAIN);
1473 lbs_deb_leave(LBS_DEB_MAIN);
1477 static void __exit lbs_exit_module(void)
1479 lbs_deb_enter(LBS_DEB_MAIN);
1480 lbs_debugfs_remove();
1481 lbs_deb_leave(LBS_DEB_MAIN);
1485 * rtap interface support fuctions
1488 static int lbs_rtap_open(struct net_device *dev)
1490 /* Yes, _stop_ the queue. Because we don't support injection */
1491 lbs_deb_enter(LBS_DEB_MAIN);
1492 netif_carrier_off(dev);
1493 netif_stop_queue(dev);
1494 lbs_deb_leave(LBS_DEB_LEAVE);
1498 static int lbs_rtap_stop(struct net_device *dev)
1500 lbs_deb_enter(LBS_DEB_MAIN);
1501 lbs_deb_leave(LBS_DEB_MAIN);
1505 static int lbs_rtap_hard_start_xmit(struct sk_buff *skb, struct net_device *dev)
1507 netif_stop_queue(dev);
1508 return NETDEV_TX_BUSY;
1511 static struct net_device_stats *lbs_rtap_get_stats(struct net_device *dev)
1513 struct lbs_private *priv = dev->priv;
1514 lbs_deb_enter(LBS_DEB_NET);
1515 return &priv->stats;
1519 static void lbs_remove_rtap(struct lbs_private *priv)
1521 lbs_deb_enter(LBS_DEB_MAIN);
1522 if (priv->rtap_net_dev == NULL)
1524 unregister_netdev(priv->rtap_net_dev);
1525 free_netdev(priv->rtap_net_dev);
1526 priv->rtap_net_dev = NULL;
1527 lbs_deb_leave(LBS_DEB_MAIN);
1530 static int lbs_add_rtap(struct lbs_private *priv)
1533 struct net_device *rtap_dev;
1535 lbs_deb_enter(LBS_DEB_MAIN);
1536 if (priv->rtap_net_dev) {
1541 rtap_dev = alloc_netdev(0, "rtap%d", ether_setup);
1542 if (rtap_dev == NULL) {
1547 memcpy(rtap_dev->dev_addr, priv->current_addr, ETH_ALEN);
1548 rtap_dev->type = ARPHRD_IEEE80211_RADIOTAP;
1549 rtap_dev->open = lbs_rtap_open;
1550 rtap_dev->stop = lbs_rtap_stop;
1551 rtap_dev->get_stats = lbs_rtap_get_stats;
1552 rtap_dev->hard_start_xmit = lbs_rtap_hard_start_xmit;
1553 rtap_dev->set_multicast_list = lbs_set_multicast_list;
1554 rtap_dev->priv = priv;
1556 ret = register_netdev(rtap_dev);
1558 free_netdev(rtap_dev);
1561 priv->rtap_net_dev = rtap_dev;
1564 lbs_deb_leave_args(LBS_DEB_MAIN, "ret %d", ret);
1569 module_init(lbs_init_module);
1570 module_exit(lbs_exit_module);
1572 MODULE_DESCRIPTION("Libertas WLAN Driver Library");
1573 MODULE_AUTHOR("Marvell International Ltd.");
1574 MODULE_LICENSE("GPL");