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/freezer.h>
10 #include <linux/etherdevice.h>
11 #include <linux/netdevice.h>
12 #include <linux/if_arp.h>
13 #include <linux/kthread.h>
15 #include <net/iw_handler.h>
16 #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 cmd_ds_mesh_access mesh_access
;
221 memset(&mesh_access
, 0, sizeof(mesh_access
));
222 lbs_prepare_and_send_command(to_net_dev(dev
)->priv
,
224 CMD_ACT_MESH_GET_ANYCAST
,
225 CMD_OPTION_WAITFORRSP
, 0, (void *)&mesh_access
);
227 return snprintf(buf
, 12, "0x%X\n", le32_to_cpu(mesh_access
.data
[0]));
231 * @brief Set function for sysfs attribute anycast_mask
233 static ssize_t
lbs_anycast_set(struct device
*dev
,
234 struct device_attribute
*attr
, const char * buf
, size_t count
)
236 struct cmd_ds_mesh_access mesh_access
;
239 memset(&mesh_access
, 0, sizeof(mesh_access
));
240 sscanf(buf
, "%x", &datum
);
241 mesh_access
.data
[0] = cpu_to_le32(datum
);
243 lbs_prepare_and_send_command((to_net_dev(dev
))->priv
,
245 CMD_ACT_MESH_SET_ANYCAST
,
246 CMD_OPTION_WAITFORRSP
, 0, (void *)&mesh_access
);
250 int lbs_add_rtap(struct lbs_private
*priv
);
251 void lbs_remove_rtap(struct lbs_private
*priv
);
254 * Get function for sysfs attribute rtap
256 static ssize_t
lbs_rtap_get(struct device
*dev
,
257 struct device_attribute
*attr
, char * buf
)
259 struct lbs_private
*priv
= to_net_dev(dev
)->priv
;
260 return snprintf(buf
, 5, "0x%X\n", priv
->monitormode
);
264 * Set function for sysfs attribute rtap
266 static ssize_t
lbs_rtap_set(struct device
*dev
,
267 struct device_attribute
*attr
, const char * buf
, size_t count
)
270 struct lbs_private
*priv
= to_net_dev(dev
)->priv
;
272 sscanf(buf
, "%x", &monitor_mode
);
273 if (monitor_mode
!= LBS_MONITOR_OFF
) {
274 if(priv
->monitormode
== monitor_mode
)
276 if (priv
->monitormode
== LBS_MONITOR_OFF
) {
277 if (priv
->infra_open
|| priv
->mesh_open
)
279 if (priv
->mode
== IW_MODE_INFRA
)
280 lbs_send_deauthentication(priv
);
281 else if (priv
->mode
== IW_MODE_ADHOC
)
282 lbs_stop_adhoc_network(priv
);
285 priv
->monitormode
= monitor_mode
;
289 if (priv
->monitormode
== LBS_MONITOR_OFF
)
291 priv
->monitormode
= LBS_MONITOR_OFF
;
292 lbs_remove_rtap(priv
);
294 if (priv
->currenttxskb
) {
295 dev_kfree_skb_any(priv
->currenttxskb
);
296 priv
->currenttxskb
= NULL
;
299 /* Wake queues, command thread, etc. */
300 lbs_host_to_card_done(priv
);
303 lbs_prepare_and_send_command(priv
,
304 CMD_802_11_MONITOR_MODE
, CMD_ACT_SET
,
305 CMD_OPTION_WAITFORRSP
, 0, &priv
->monitormode
);
310 * lbs_rtap attribute to be exported per mshX interface
311 * through sysfs (/sys/class/net/mshX/libertas-rtap)
313 static DEVICE_ATTR(lbs_rtap
, 0644, lbs_rtap_get
,
317 * anycast_mask attribute to be exported per mshX interface
318 * through sysfs (/sys/class/net/mshX/anycast_mask)
320 static DEVICE_ATTR(anycast_mask
, 0644, lbs_anycast_get
, lbs_anycast_set
);
322 static ssize_t
lbs_autostart_enabled_get(struct device
*dev
,
323 struct device_attribute
*attr
, char * buf
)
325 struct cmd_ds_mesh_access mesh_access
;
327 memset(&mesh_access
, 0, sizeof(mesh_access
));
328 lbs_prepare_and_send_command(to_net_dev(dev
)->priv
,
330 CMD_ACT_MESH_GET_AUTOSTART_ENABLED
,
331 CMD_OPTION_WAITFORRSP
, 0, (void *)&mesh_access
);
333 return sprintf(buf
, "%d\n", le32_to_cpu(mesh_access
.data
[0]));
336 static ssize_t
lbs_autostart_enabled_set(struct device
*dev
,
337 struct device_attribute
*attr
, const char * buf
, size_t count
)
339 struct cmd_ds_mesh_access mesh_access
;
341 struct lbs_private
*priv
= (to_net_dev(dev
))->priv
;
344 memset(&mesh_access
, 0, sizeof(mesh_access
));
345 sscanf(buf
, "%d", &datum
);
346 mesh_access
.data
[0] = cpu_to_le32(datum
);
348 ret
= lbs_prepare_and_send_command(priv
,
350 CMD_ACT_MESH_SET_AUTOSTART_ENABLED
,
351 CMD_OPTION_WAITFORRSP
, 0, (void *)&mesh_access
);
353 priv
->mesh_autostart_enabled
= datum
? 1 : 0;
358 static DEVICE_ATTR(autostart_enabled
, 0644,
359 lbs_autostart_enabled_get
, lbs_autostart_enabled_set
);
361 static struct attribute
*lbs_mesh_sysfs_entries
[] = {
362 &dev_attr_anycast_mask
.attr
,
363 &dev_attr_autostart_enabled
.attr
,
367 static struct attribute_group lbs_mesh_attr_group
= {
368 .attrs
= lbs_mesh_sysfs_entries
,
372 * @brief This function opens the ethX or mshX interface
374 * @param dev A pointer to net_device structure
375 * @return 0 or -EBUSY if monitor mode active
377 static int lbs_dev_open(struct net_device
*dev
)
379 struct lbs_private
*priv
= (struct lbs_private
*) dev
->priv
;
382 spin_lock_irq(&priv
->driver_lock
);
384 if (priv
->monitormode
!= LBS_MONITOR_OFF
) {
389 if (dev
== priv
->mesh_dev
) {
391 priv
->mesh_connect_status
= LBS_CONNECTED
;
392 netif_carrier_on(dev
);
394 priv
->infra_open
= 1;
396 if (priv
->connect_status
== LBS_CONNECTED
)
397 netif_carrier_on(dev
);
399 netif_carrier_off(dev
);
402 if (!priv
->tx_pending_len
)
403 netif_wake_queue(dev
);
406 spin_unlock_irq(&priv
->driver_lock
);
411 * @brief This function closes the mshX interface
413 * @param dev A pointer to net_device structure
416 static int lbs_mesh_stop(struct net_device
*dev
)
418 struct lbs_private
*priv
= (struct lbs_private
*) (dev
->priv
);
420 spin_lock_irq(&priv
->driver_lock
);
423 priv
->mesh_connect_status
= LBS_DISCONNECTED
;
425 netif_stop_queue(dev
);
426 netif_carrier_off(dev
);
428 spin_unlock_irq(&priv
->driver_lock
);
433 * @brief This function closes the ethX interface
435 * @param dev A pointer to net_device structure
438 static int lbs_eth_stop(struct net_device
*dev
)
440 struct lbs_private
*priv
= (struct lbs_private
*) dev
->priv
;
442 spin_lock_irq(&priv
->driver_lock
);
444 priv
->infra_open
= 0;
446 netif_stop_queue(dev
);
448 spin_unlock_irq(&priv
->driver_lock
);
452 static void lbs_tx_timeout(struct net_device
*dev
)
454 struct lbs_private
*priv
= (struct lbs_private
*) dev
->priv
;
456 lbs_deb_enter(LBS_DEB_TX
);
458 lbs_pr_err("tx watch dog timeout\n");
460 dev
->trans_start
= jiffies
;
462 if (priv
->currenttxskb
) {
463 priv
->eventcause
= 0x01000000;
464 lbs_send_tx_feedback(priv
);
466 /* XX: Shouldn't we also call into the hw-specific driver
467 to kick it somehow? */
468 lbs_host_to_card_done(priv
);
470 lbs_deb_leave(LBS_DEB_TX
);
473 void lbs_host_to_card_done(struct lbs_private
*priv
)
477 spin_lock_irqsave(&priv
->driver_lock
, flags
);
479 priv
->dnld_sent
= DNLD_RES_RECEIVED
;
481 /* Wake main thread if commands are pending */
483 wake_up_interruptible(&priv
->waitq
);
485 /* Don't wake netif queues if we're in monitor mode and
486 a TX packet is already pending, or if there are commands
487 queued to be sent. */
488 if (!priv
->currenttxskb
&& list_empty(&priv
->cmdpendingq
)) {
489 if (priv
->dev
&& priv
->connect_status
== LBS_CONNECTED
)
490 netif_wake_queue(priv
->dev
);
492 if (priv
->mesh_dev
&& priv
->mesh_connect_status
== LBS_CONNECTED
)
493 netif_wake_queue(priv
->mesh_dev
);
495 spin_unlock_irqrestore(&priv
->driver_lock
, flags
);
497 EXPORT_SYMBOL_GPL(lbs_host_to_card_done
);
500 * @brief This function returns the network statistics
502 * @param dev A pointer to struct lbs_private structure
503 * @return A pointer to net_device_stats structure
505 static struct net_device_stats
*lbs_get_stats(struct net_device
*dev
)
507 struct lbs_private
*priv
= (struct lbs_private
*) dev
->priv
;
512 static int lbs_set_mac_address(struct net_device
*dev
, void *addr
)
515 struct lbs_private
*priv
= (struct lbs_private
*) dev
->priv
;
516 struct sockaddr
*phwaddr
= addr
;
518 lbs_deb_enter(LBS_DEB_NET
);
520 /* In case it was called from the mesh device */
523 memset(priv
->current_addr
, 0, ETH_ALEN
);
525 /* dev->dev_addr is 8 bytes */
526 lbs_deb_hex(LBS_DEB_NET
, "dev->dev_addr", dev
->dev_addr
, ETH_ALEN
);
528 lbs_deb_hex(LBS_DEB_NET
, "addr", phwaddr
->sa_data
, ETH_ALEN
);
529 memcpy(priv
->current_addr
, phwaddr
->sa_data
, ETH_ALEN
);
531 ret
= lbs_prepare_and_send_command(priv
, CMD_802_11_MAC_ADDRESS
,
533 CMD_OPTION_WAITFORRSP
, 0, NULL
);
536 lbs_deb_net("set MAC address failed\n");
541 lbs_deb_hex(LBS_DEB_NET
, "priv->macaddr", priv
->current_addr
, ETH_ALEN
);
542 memcpy(dev
->dev_addr
, priv
->current_addr
, ETH_ALEN
);
544 memcpy(priv
->mesh_dev
->dev_addr
, priv
->current_addr
, ETH_ALEN
);
547 lbs_deb_leave_args(LBS_DEB_NET
, "ret %d", ret
);
551 static int lbs_copy_multicast_address(struct lbs_private
*priv
,
552 struct net_device
*dev
)
555 struct dev_mc_list
*mcptr
= dev
->mc_list
;
557 for (i
= 0; i
< dev
->mc_count
; i
++) {
558 memcpy(&priv
->multicastlist
[i
], mcptr
->dmi_addr
, ETH_ALEN
);
566 static void lbs_set_multicast_list(struct net_device
*dev
)
568 struct lbs_private
*priv
= dev
->priv
;
570 DECLARE_MAC_BUF(mac
);
572 lbs_deb_enter(LBS_DEB_NET
);
574 oldpacketfilter
= priv
->currentpacketfilter
;
576 if (dev
->flags
& IFF_PROMISC
) {
577 lbs_deb_net("enable promiscuous mode\n");
578 priv
->currentpacketfilter
|=
579 CMD_ACT_MAC_PROMISCUOUS_ENABLE
;
580 priv
->currentpacketfilter
&=
581 ~(CMD_ACT_MAC_ALL_MULTICAST_ENABLE
|
582 CMD_ACT_MAC_MULTICAST_ENABLE
);
585 priv
->currentpacketfilter
&=
586 ~CMD_ACT_MAC_PROMISCUOUS_ENABLE
;
588 if (dev
->flags
& IFF_ALLMULTI
|| dev
->mc_count
>
589 MRVDRV_MAX_MULTICAST_LIST_SIZE
) {
590 lbs_deb_net( "enabling all multicast\n");
591 priv
->currentpacketfilter
|=
592 CMD_ACT_MAC_ALL_MULTICAST_ENABLE
;
593 priv
->currentpacketfilter
&=
594 ~CMD_ACT_MAC_MULTICAST_ENABLE
;
596 priv
->currentpacketfilter
&=
597 ~CMD_ACT_MAC_ALL_MULTICAST_ENABLE
;
599 if (!dev
->mc_count
) {
600 lbs_deb_net("no multicast addresses, "
601 "disabling multicast\n");
602 priv
->currentpacketfilter
&=
603 ~CMD_ACT_MAC_MULTICAST_ENABLE
;
607 priv
->currentpacketfilter
|=
608 CMD_ACT_MAC_MULTICAST_ENABLE
;
610 priv
->nr_of_multicastmacaddr
=
611 lbs_copy_multicast_address(priv
, dev
);
613 lbs_deb_net("multicast addresses: %d\n",
616 for (i
= 0; i
< dev
->mc_count
; i
++) {
617 lbs_deb_net("Multicast address %d:%s\n",
619 priv
->multicastlist
[i
]));
621 /* send multicast addresses to firmware */
622 lbs_prepare_and_send_command(priv
,
623 CMD_MAC_MULTICAST_ADR
,
630 if (priv
->currentpacketfilter
!= oldpacketfilter
) {
631 lbs_set_mac_packet_filter(priv
);
634 lbs_deb_leave(LBS_DEB_NET
);
638 * @brief This function handles the major jobs in the LBS driver.
639 * It handles all events generated by firmware, RX data received
640 * from firmware and TX data sent from kernel.
642 * @param data A pointer to lbs_thread structure
645 static int lbs_thread(void *data
)
647 struct net_device
*dev
= data
;
648 struct lbs_private
*priv
= dev
->priv
;
652 lbs_deb_enter(LBS_DEB_THREAD
);
654 init_waitqueue_entry(&wait
, current
);
661 lbs_deb_thread( "main-thread 111: intcounter=%d currenttxskb=%p dnld_sent=%d\n",
662 priv
->intcounter
, priv
->currenttxskb
, priv
->dnld_sent
);
664 add_wait_queue(&priv
->waitq
, &wait
);
665 set_current_state(TASK_INTERRUPTIBLE
);
666 spin_lock_irq(&priv
->driver_lock
);
668 if (priv
->surpriseremoved
)
669 shouldsleep
= 0; /* Bye */
670 else if (priv
->psstate
== PS_STATE_SLEEP
)
671 shouldsleep
= 1; /* Sleep mode. Nothing we can do till it wakes */
672 else if (priv
->intcounter
)
673 shouldsleep
= 0; /* Interrupt pending. Deal with it now */
674 else if (priv
->dnld_sent
)
675 shouldsleep
= 1; /* Something is en route to the device already */
676 else if (priv
->tx_pending_len
> 0)
677 shouldsleep
= 0; /* We've a packet to send */
678 else if (priv
->cur_cmd
)
679 shouldsleep
= 1; /* Can't send a command; one already running */
680 else if (!list_empty(&priv
->cmdpendingq
))
681 shouldsleep
= 0; /* We have a command to send */
683 shouldsleep
= 1; /* No command */
686 lbs_deb_thread("main-thread sleeping... Conn=%d IntC=%d PS_mode=%d PS_State=%d\n",
687 priv
->connect_status
, priv
->intcounter
,
688 priv
->psmode
, priv
->psstate
);
689 spin_unlock_irq(&priv
->driver_lock
);
692 spin_unlock_irq(&priv
->driver_lock
);
694 lbs_deb_thread("main-thread 222 (waking up): intcounter=%d currenttxskb=%p dnld_sent=%d\n",
695 priv
->intcounter
, priv
->currenttxskb
, priv
->dnld_sent
);
697 set_current_state(TASK_RUNNING
);
698 remove_wait_queue(&priv
->waitq
, &wait
);
701 lbs_deb_thread("main-thread 333: intcounter=%d currenttxskb=%p dnld_sent=%d\n",
702 priv
->intcounter
, priv
->currenttxskb
, priv
->dnld_sent
);
704 if (kthread_should_stop() || priv
->surpriseremoved
) {
705 lbs_deb_thread("main-thread: break from main thread: surpriseremoved=0x%x\n",
706 priv
->surpriseremoved
);
711 spin_lock_irq(&priv
->driver_lock
);
713 if (priv
->intcounter
) {
716 priv
->intcounter
= 0;
717 int_status
= priv
->hw_get_int_status(priv
, &ireg
);
720 lbs_deb_thread("main-thread: reading HOST_INT_STATUS_REG failed\n");
721 spin_unlock_irq(&priv
->driver_lock
);
724 priv
->hisregcpy
|= ireg
;
727 lbs_deb_thread("main-thread 444: intcounter=%d currenttxskb=%p dnld_sent=%d\n",
728 priv
->intcounter
, priv
->currenttxskb
, priv
->dnld_sent
);
730 /* command response? */
731 if (priv
->hisregcpy
& MRVDRV_CMD_UPLD_RDY
) {
732 lbs_deb_thread("main-thread: cmd response ready\n");
734 priv
->hisregcpy
&= ~MRVDRV_CMD_UPLD_RDY
;
735 spin_unlock_irq(&priv
->driver_lock
);
736 lbs_process_rx_command(priv
);
737 spin_lock_irq(&priv
->driver_lock
);
741 if (priv
->hisregcpy
& MRVDRV_CARDEVENT
) {
742 lbs_deb_thread("main-thread: Card Event Activity\n");
744 priv
->hisregcpy
&= ~MRVDRV_CARDEVENT
;
746 if (priv
->hw_read_event_cause(priv
)) {
747 lbs_pr_alert("main-thread: hw_read_event_cause failed\n");
748 spin_unlock_irq(&priv
->driver_lock
);
751 spin_unlock_irq(&priv
->driver_lock
);
752 lbs_process_event(priv
);
754 spin_unlock_irq(&priv
->driver_lock
);
756 /* Check if we need to confirm Sleep Request received previously */
757 if (priv
->psstate
== PS_STATE_PRE_SLEEP
&&
758 !priv
->dnld_sent
&& !priv
->cur_cmd
) {
759 if (priv
->connect_status
== LBS_CONNECTED
) {
760 lbs_deb_thread("main_thread: PRE_SLEEP--intcounter=%d currenttxskb=%p dnld_sent=%d cur_cmd=%p, confirm now\n",
761 priv
->intcounter
, priv
->currenttxskb
, priv
->dnld_sent
, priv
->cur_cmd
);
763 lbs_ps_confirm_sleep(priv
, (u16
) priv
->psmode
);
765 /* workaround for firmware sending
766 * deauth/linkloss event immediately
767 * after sleep request; remove this
768 * after firmware fixes it
770 priv
->psstate
= PS_STATE_AWAKE
;
771 lbs_pr_alert("main-thread: ignore PS_SleepConfirm in non-connected state\n");
775 /* The PS state is changed during processing of Sleep Request
778 if ((priv
->psstate
== PS_STATE_SLEEP
) ||
779 (priv
->psstate
== PS_STATE_PRE_SLEEP
))
782 /* Execute the next command */
783 if (!priv
->dnld_sent
&& !priv
->cur_cmd
)
784 lbs_execute_next_command(priv
);
786 /* Wake-up command waiters which can't sleep in
787 * lbs_prepare_and_send_command
789 if (!list_empty(&priv
->cmdpendingq
))
790 wake_up_all(&priv
->cmd_pending
);
792 spin_lock_irq(&priv
->driver_lock
);
793 if (!priv
->dnld_sent
&& priv
->tx_pending_len
> 0) {
794 int ret
= priv
->hw_host_to_card(priv
, MVMS_DAT
,
795 priv
->tx_pending_buf
,
796 priv
->tx_pending_len
);
798 lbs_deb_tx("host_to_card failed %d\n", ret
);
799 priv
->dnld_sent
= DNLD_RES_RECEIVED
;
801 priv
->tx_pending_len
= 0;
802 if (!priv
->currenttxskb
) {
803 /* We can wake the queues immediately if we aren't
804 waiting for TX feedback */
805 if (priv
->connect_status
== LBS_CONNECTED
)
806 netif_wake_queue(priv
->dev
);
807 if (priv
->mesh_dev
&&
808 priv
->mesh_connect_status
== LBS_CONNECTED
)
809 netif_wake_queue(priv
->mesh_dev
);
812 spin_unlock_irq(&priv
->driver_lock
);
815 del_timer(&priv
->command_timer
);
816 wake_up_all(&priv
->cmd_pending
);
818 lbs_deb_leave(LBS_DEB_THREAD
);
823 * @brief This function downloads firmware image, gets
824 * HW spec from firmware and set basic parameters to
827 * @param priv A pointer to struct lbs_private structure
830 static int lbs_setup_firmware(struct lbs_private
*priv
)
833 struct cmd_ds_mesh_access mesh_access
;
835 lbs_deb_enter(LBS_DEB_FW
);
838 * Read MAC address from HW
840 memset(priv
->current_addr
, 0xff, ETH_ALEN
);
842 ret
= lbs_prepare_and_send_command(priv
, CMD_GET_HW_SPEC
,
843 0, CMD_OPTION_WAITFORRSP
, 0, NULL
);
850 lbs_set_mac_packet_filter(priv
);
852 /* Get the supported Data rates */
853 ret
= lbs_prepare_and_send_command(priv
, CMD_802_11_DATA_RATE
,
855 CMD_OPTION_WAITFORRSP
, 0, NULL
);
862 /* Disable mesh autostart */
863 if (priv
->mesh_dev
) {
864 memset(&mesh_access
, 0, sizeof(mesh_access
));
865 mesh_access
.data
[0] = cpu_to_le32(0);
866 ret
= lbs_prepare_and_send_command(priv
,
868 CMD_ACT_MESH_SET_AUTOSTART_ENABLED
,
869 CMD_OPTION_WAITFORRSP
, 0, (void *)&mesh_access
);
874 priv
->mesh_autostart_enabled
= 0;
879 lbs_deb_leave_args(LBS_DEB_FW
, "ret %d", ret
);
884 * This function handles the timeout of command sending.
885 * It will re-send the same command again.
887 static void command_timer_fn(unsigned long data
)
889 struct lbs_private
*priv
= (struct lbs_private
*)data
;
890 struct cmd_ctrl_node
*ptempnode
;
891 struct cmd_ds_command
*cmd
;
894 ptempnode
= priv
->cur_cmd
;
895 if (ptempnode
== NULL
) {
896 lbs_deb_fw("ptempnode empty\n");
900 cmd
= (struct cmd_ds_command
*)ptempnode
->bufvirtualaddr
;
902 lbs_deb_fw("cmd is NULL\n");
906 lbs_deb_fw("command_timer_fn fired, cmd %x\n", cmd
->command
);
911 spin_lock_irqsave(&priv
->driver_lock
, flags
);
912 priv
->cur_cmd
= NULL
;
913 spin_unlock_irqrestore(&priv
->driver_lock
, flags
);
915 lbs_deb_fw("re-sending same command because of timeout\n");
916 lbs_queue_cmd(priv
, ptempnode
, 0);
918 wake_up_interruptible(&priv
->waitq
);
923 static int lbs_init_adapter(struct lbs_private
*priv
)
928 /* Allocate buffer to store the BSSID list */
929 bufsize
= MAX_NETWORK_COUNT
* sizeof(struct bss_descriptor
);
930 priv
->networks
= kzalloc(bufsize
, GFP_KERNEL
);
931 if (!priv
->networks
) {
932 lbs_pr_err("Out of memory allocating beacons\n");
937 /* Initialize scan result lists */
938 INIT_LIST_HEAD(&priv
->network_free_list
);
939 INIT_LIST_HEAD(&priv
->network_list
);
940 for (i
= 0; i
< MAX_NETWORK_COUNT
; i
++) {
941 list_add_tail(&priv
->networks
[i
].list
,
942 &priv
->network_free_list
);
945 priv
->lbs_ps_confirm_sleep
.seqnum
= cpu_to_le16(++priv
->seqnum
);
946 priv
->lbs_ps_confirm_sleep
.command
=
947 cpu_to_le16(CMD_802_11_PS_MODE
);
948 priv
->lbs_ps_confirm_sleep
.size
=
949 cpu_to_le16(sizeof(struct PS_CMD_ConfirmSleep
));
950 priv
->lbs_ps_confirm_sleep
.action
=
951 cpu_to_le16(CMD_SUBCMD_SLEEP_CONFIRMED
);
953 memset(priv
->current_addr
, 0xff, ETH_ALEN
);
955 priv
->connect_status
= LBS_DISCONNECTED
;
956 priv
->mesh_connect_status
= LBS_DISCONNECTED
;
957 priv
->secinfo
.auth_mode
= IW_AUTH_ALG_OPEN_SYSTEM
;
958 priv
->mode
= IW_MODE_INFRA
;
959 priv
->curbssparams
.channel
= DEFAULT_AD_HOC_CHANNEL
;
960 priv
->currentpacketfilter
= CMD_ACT_MAC_RX_ON
| CMD_ACT_MAC_TX_ON
;
961 priv
->radioon
= RADIO_ON
;
963 priv
->capability
= WLAN_CAPABILITY_SHORT_PREAMBLE
;
964 priv
->psmode
= LBS802_11POWERMODECAM
;
965 priv
->psstate
= PS_STATE_FULL_POWER
;
967 mutex_init(&priv
->lock
);
969 setup_timer(&priv
->command_timer
, command_timer_fn
,
970 (unsigned long)priv
);
972 INIT_LIST_HEAD(&priv
->cmdfreeq
);
973 INIT_LIST_HEAD(&priv
->cmdpendingq
);
975 spin_lock_init(&priv
->driver_lock
);
976 init_waitqueue_head(&priv
->cmd_pending
);
978 /* Allocate the command buffers */
979 if (lbs_allocate_cmd_buffer(priv
)) {
980 lbs_pr_err("Out of memory allocating command buffers\n");
988 static void lbs_free_adapter(struct lbs_private
*priv
)
990 lbs_deb_fw("free command buffer\n");
991 lbs_free_cmd_buffer(priv
);
993 lbs_deb_fw("free command_timer\n");
994 del_timer(&priv
->command_timer
);
996 lbs_deb_fw("free scan results table\n");
997 kfree(priv
->networks
);
998 priv
->networks
= NULL
;
1002 * @brief This function adds the card. it will probe the
1003 * card, allocate the lbs_priv and initialize the device.
1005 * @param card A pointer to card
1006 * @return A pointer to struct lbs_private structure
1008 struct lbs_private
*lbs_add_card(void *card
, struct device
*dmdev
)
1010 struct net_device
*dev
= NULL
;
1011 struct lbs_private
*priv
= NULL
;
1013 lbs_deb_enter(LBS_DEB_NET
);
1015 /* Allocate an Ethernet device and register it */
1016 dev
= alloc_etherdev(sizeof(struct lbs_private
));
1018 lbs_pr_err("init ethX device failed\n");
1023 if (lbs_init_adapter(priv
)) {
1024 lbs_pr_err("failed to initialize adapter structure.\n");
1025 goto err_init_adapter
;
1030 priv
->mesh_open
= 0;
1031 priv
->infra_open
= 0;
1033 /* Setup the OS Interface to our functions */
1034 dev
->open
= lbs_dev_open
;
1035 dev
->hard_start_xmit
= lbs_hard_start_xmit
;
1036 dev
->stop
= lbs_eth_stop
;
1037 dev
->set_mac_address
= lbs_set_mac_address
;
1038 dev
->tx_timeout
= lbs_tx_timeout
;
1039 dev
->get_stats
= lbs_get_stats
;
1040 dev
->watchdog_timeo
= 5 * HZ
;
1041 dev
->ethtool_ops
= &lbs_ethtool_ops
;
1043 dev
->wireless_handlers
= (struct iw_handler_def
*)&lbs_handler_def
;
1045 dev
->flags
|= IFF_BROADCAST
| IFF_MULTICAST
;
1046 dev
->set_multicast_list
= lbs_set_multicast_list
;
1048 SET_NETDEV_DEV(dev
, dmdev
);
1050 priv
->rtap_net_dev
= NULL
;
1052 lbs_deb_thread("Starting main thread...\n");
1053 init_waitqueue_head(&priv
->waitq
);
1054 priv
->main_thread
= kthread_run(lbs_thread
, dev
, "lbs_main");
1055 if (IS_ERR(priv
->main_thread
)) {
1056 lbs_deb_thread("Error creating main thread.\n");
1057 goto err_init_adapter
;
1060 priv
->work_thread
= create_singlethread_workqueue("lbs_worker");
1061 INIT_DELAYED_WORK(&priv
->assoc_work
, lbs_association_worker
);
1062 INIT_DELAYED_WORK(&priv
->scan_work
, lbs_scan_worker
);
1063 INIT_WORK(&priv
->sync_channel
, lbs_sync_channel
);
1068 lbs_free_adapter(priv
);
1073 lbs_deb_leave_args(LBS_DEB_NET
, "priv %p", priv
);
1076 EXPORT_SYMBOL_GPL(lbs_add_card
);
1079 int lbs_remove_card(struct lbs_private
*priv
)
1081 struct net_device
*dev
= priv
->dev
;
1082 union iwreq_data wrqu
;
1084 lbs_deb_enter(LBS_DEB_MAIN
);
1086 lbs_remove_rtap(priv
);
1089 device_remove_file(&dev
->dev
, &dev_attr_lbs_rtap
);
1091 cancel_delayed_work(&priv
->scan_work
);
1092 cancel_delayed_work(&priv
->assoc_work
);
1093 destroy_workqueue(priv
->work_thread
);
1095 if (priv
->psmode
== LBS802_11POWERMODEMAX_PSP
) {
1096 priv
->psmode
= LBS802_11POWERMODECAM
;
1097 lbs_ps_wakeup(priv
, CMD_OPTION_WAITFORRSP
);
1100 memset(wrqu
.ap_addr
.sa_data
, 0xaa, ETH_ALEN
);
1101 wrqu
.ap_addr
.sa_family
= ARPHRD_ETHER
;
1102 wireless_send_event(priv
->dev
, SIOCGIWAP
, &wrqu
, NULL
);
1104 /* Stop the thread servicing the interrupts */
1105 priv
->surpriseremoved
= 1;
1106 kthread_stop(priv
->main_thread
);
1108 lbs_free_adapter(priv
);
1113 lbs_deb_leave(LBS_DEB_MAIN
);
1116 EXPORT_SYMBOL_GPL(lbs_remove_card
);
1119 int lbs_start_card(struct lbs_private
*priv
)
1121 struct net_device
*dev
= priv
->dev
;
1124 lbs_deb_enter(LBS_DEB_MAIN
);
1126 /* poke the firmware */
1127 ret
= lbs_setup_firmware(priv
);
1134 if (register_netdev(dev
)) {
1135 lbs_pr_err("cannot register ethX device\n");
1138 if (device_create_file(&dev
->dev
, &dev_attr_lbs_rtap
))
1139 lbs_pr_err("cannot register lbs_rtap attribute\n");
1141 lbs_debugfs_init_one(priv
, dev
);
1143 lbs_pr_info("%s: Marvell WLAN 802.11 adapter\n", dev
->name
);
1148 lbs_deb_leave_args(LBS_DEB_MAIN
, "ret %d", ret
);
1151 EXPORT_SYMBOL_GPL(lbs_start_card
);
1154 int lbs_stop_card(struct lbs_private
*priv
)
1156 struct net_device
*dev
= priv
->dev
;
1158 struct cmd_ctrl_node
*cmdnode
;
1159 unsigned long flags
;
1161 lbs_deb_enter(LBS_DEB_MAIN
);
1163 netif_stop_queue(priv
->dev
);
1164 netif_carrier_off(priv
->dev
);
1166 lbs_debugfs_remove_one(priv
);
1168 /* Flush pending command nodes */
1169 spin_lock_irqsave(&priv
->driver_lock
, flags
);
1170 list_for_each_entry(cmdnode
, &priv
->cmdpendingq
, list
) {
1171 cmdnode
->cmdwaitqwoken
= 1;
1172 wake_up_interruptible(&cmdnode
->cmdwait_q
);
1174 spin_unlock_irqrestore(&priv
->driver_lock
, flags
);
1176 unregister_netdev(dev
);
1178 lbs_deb_leave_args(LBS_DEB_MAIN
, "ret %d", ret
);
1181 EXPORT_SYMBOL_GPL(lbs_stop_card
);
1185 * @brief This function adds mshX interface
1187 * @param priv A pointer to the struct lbs_private structure
1188 * @return 0 if successful, -X otherwise
1190 int lbs_add_mesh(struct lbs_private
*priv
, struct device
*dev
)
1192 struct net_device
*mesh_dev
= NULL
;
1195 lbs_deb_enter(LBS_DEB_MESH
);
1197 /* Allocate a virtual mesh device */
1198 if (!(mesh_dev
= alloc_netdev(0, "msh%d", ether_setup
))) {
1199 lbs_deb_mesh("init mshX device failed\n");
1203 mesh_dev
->priv
= priv
;
1204 priv
->mesh_dev
= mesh_dev
;
1206 mesh_dev
->open
= lbs_dev_open
;
1207 mesh_dev
->hard_start_xmit
= lbs_hard_start_xmit
;
1208 mesh_dev
->stop
= lbs_mesh_stop
;
1209 mesh_dev
->get_stats
= lbs_get_stats
;
1210 mesh_dev
->set_mac_address
= lbs_set_mac_address
;
1211 mesh_dev
->ethtool_ops
= &lbs_ethtool_ops
;
1212 memcpy(mesh_dev
->dev_addr
, priv
->dev
->dev_addr
,
1213 sizeof(priv
->dev
->dev_addr
));
1215 SET_NETDEV_DEV(priv
->mesh_dev
, dev
);
1218 mesh_dev
->wireless_handlers
= (struct iw_handler_def
*)&mesh_handler_def
;
1220 /* Register virtual mesh interface */
1221 ret
= register_netdev(mesh_dev
);
1223 lbs_pr_err("cannot register mshX virtual interface\n");
1227 ret
= sysfs_create_group(&(mesh_dev
->dev
.kobj
), &lbs_mesh_attr_group
);
1229 goto err_unregister
;
1231 /* Everything successful */
1236 unregister_netdev(mesh_dev
);
1239 free_netdev(mesh_dev
);
1242 lbs_deb_leave_args(LBS_DEB_MESH
, "ret %d", ret
);
1245 EXPORT_SYMBOL_GPL(lbs_add_mesh
);
1248 void lbs_remove_mesh(struct lbs_private
*priv
)
1250 struct net_device
*mesh_dev
;
1252 lbs_deb_enter(LBS_DEB_MAIN
);
1257 mesh_dev
= priv
->mesh_dev
;
1259 netif_stop_queue(mesh_dev
);
1260 netif_carrier_off(priv
->mesh_dev
);
1262 sysfs_remove_group(&(mesh_dev
->dev
.kobj
), &lbs_mesh_attr_group
);
1263 unregister_netdev(mesh_dev
);
1265 priv
->mesh_dev
= NULL
;
1266 free_netdev(mesh_dev
);
1269 lbs_deb_leave(LBS_DEB_MAIN
);
1271 EXPORT_SYMBOL_GPL(lbs_remove_mesh
);
1274 * @brief This function finds the CFP in
1275 * region_cfp_table based on region and band parameter.
1277 * @param region The region code
1278 * @param band The band
1279 * @param cfp_no A pointer to CFP number
1280 * @return A pointer to CFP
1282 struct chan_freq_power
*lbs_get_region_cfp_table(u8 region
, u8 band
, int *cfp_no
)
1286 lbs_deb_enter(LBS_DEB_MAIN
);
1288 end
= ARRAY_SIZE(region_cfp_table
);
1290 for (i
= 0; i
< end
; i
++) {
1291 lbs_deb_main("region_cfp_table[i].region=%d\n",
1292 region_cfp_table
[i
].region
);
1293 if (region_cfp_table
[i
].region
== region
) {
1294 *cfp_no
= region_cfp_table
[i
].cfp_no_BG
;
1295 lbs_deb_leave(LBS_DEB_MAIN
);
1296 return region_cfp_table
[i
].cfp_BG
;
1300 lbs_deb_leave_args(LBS_DEB_MAIN
, "ret NULL");
1304 int lbs_set_regiontable(struct lbs_private
*priv
, u8 region
, u8 band
)
1309 struct chan_freq_power
*cfp
;
1312 lbs_deb_enter(LBS_DEB_MAIN
);
1314 memset(priv
->region_channel
, 0, sizeof(priv
->region_channel
));
1317 cfp
= lbs_get_region_cfp_table(region
, band
, &cfp_no
);
1319 priv
->region_channel
[i
].nrcfp
= cfp_no
;
1320 priv
->region_channel
[i
].CFP
= cfp
;
1322 lbs_deb_main("wrong region code %#x in band B/G\n",
1327 priv
->region_channel
[i
].valid
= 1;
1328 priv
->region_channel
[i
].region
= region
;
1329 priv
->region_channel
[i
].band
= band
;
1333 lbs_deb_leave_args(LBS_DEB_MAIN
, "ret %d", ret
);
1338 * @brief This function handles the interrupt. it will change PS
1339 * state if applicable. it will wake up main_thread to handle
1340 * the interrupt event as well.
1342 * @param dev A pointer to net_device structure
1345 void lbs_interrupt(struct lbs_private
*priv
)
1347 lbs_deb_enter(LBS_DEB_THREAD
);
1349 lbs_deb_thread("lbs_interrupt: intcounter=%d\n", priv
->intcounter
);
1351 if (spin_trylock(&priv
->driver_lock
)) {
1352 spin_unlock(&priv
->driver_lock
);
1353 printk(KERN_CRIT
"%s called without driver_lock held\n", __func__
);
1359 if (priv
->psstate
== PS_STATE_SLEEP
)
1360 priv
->psstate
= PS_STATE_AWAKE
;
1362 wake_up_interruptible(&priv
->waitq
);
1364 lbs_deb_leave(LBS_DEB_THREAD
);
1366 EXPORT_SYMBOL_GPL(lbs_interrupt
);
1368 int lbs_reset_device(struct lbs_private
*priv
)
1372 lbs_deb_enter(LBS_DEB_MAIN
);
1373 ret
= lbs_prepare_and_send_command(priv
, CMD_802_11_RESET
,
1374 CMD_ACT_HALT
, 0, 0, NULL
);
1375 msleep_interruptible(10);
1377 lbs_deb_leave_args(LBS_DEB_MAIN
, "ret %d", ret
);
1380 EXPORT_SYMBOL_GPL(lbs_reset_device
);
1382 static int __init
lbs_init_module(void)
1384 lbs_deb_enter(LBS_DEB_MAIN
);
1386 lbs_deb_leave(LBS_DEB_MAIN
);
1390 static void __exit
lbs_exit_module(void)
1392 lbs_deb_enter(LBS_DEB_MAIN
);
1394 lbs_debugfs_remove();
1396 lbs_deb_leave(LBS_DEB_MAIN
);
1400 * rtap interface support fuctions
1403 static int lbs_rtap_open(struct net_device
*dev
)
1405 /* Yes, _stop_ the queue. Because we don't support injection */
1406 netif_carrier_off(dev
);
1407 netif_stop_queue(dev
);
1411 static int lbs_rtap_stop(struct net_device
*dev
)
1416 static int lbs_rtap_hard_start_xmit(struct sk_buff
*skb
, struct net_device
*dev
)
1418 netif_stop_queue(dev
);
1419 return NETDEV_TX_BUSY
;
1422 static struct net_device_stats
*lbs_rtap_get_stats(struct net_device
*dev
)
1424 struct lbs_private
*priv
= dev
->priv
;
1425 return &priv
->stats
;
1429 void lbs_remove_rtap(struct lbs_private
*priv
)
1431 if (priv
->rtap_net_dev
== NULL
)
1433 unregister_netdev(priv
->rtap_net_dev
);
1434 free_netdev(priv
->rtap_net_dev
);
1435 priv
->rtap_net_dev
= NULL
;
1438 int lbs_add_rtap(struct lbs_private
*priv
)
1441 struct net_device
*rtap_dev
;
1443 if (priv
->rtap_net_dev
)
1446 rtap_dev
= alloc_netdev(0, "rtap%d", ether_setup
);
1447 if (rtap_dev
== NULL
)
1450 memcpy(rtap_dev
->dev_addr
, priv
->current_addr
, ETH_ALEN
);
1451 rtap_dev
->type
= ARPHRD_IEEE80211_RADIOTAP
;
1452 rtap_dev
->open
= lbs_rtap_open
;
1453 rtap_dev
->stop
= lbs_rtap_stop
;
1454 rtap_dev
->get_stats
= lbs_rtap_get_stats
;
1455 rtap_dev
->hard_start_xmit
= lbs_rtap_hard_start_xmit
;
1456 rtap_dev
->set_multicast_list
= lbs_set_multicast_list
;
1457 rtap_dev
->priv
= priv
;
1459 rc
= register_netdev(rtap_dev
);
1461 free_netdev(rtap_dev
);
1464 priv
->rtap_net_dev
= rtap_dev
;
1470 module_init(lbs_init_module
);
1471 module_exit(lbs_exit_module
);
1473 MODULE_DESCRIPTION("Libertas WLAN Driver Library");
1474 MODULE_AUTHOR("Marvell International Ltd.");
1475 MODULE_LICENSE("GPL");