pcmcia: pcmcia_request_window() doesn't need a pointer to a pointer
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / drivers / net / pcmcia / xirc2ps_cs.c
blob265852ab1a2daffcb3532eb2f4490efd751fe893
1 /* [xirc2ps_cs.c wk 03.11.99] (1.40 1999/11/18 00:06:03)
2 * Xircom CreditCard Ethernet Adapter IIps driver
3 * Xircom Realport 10/100 (RE-100) driver
5 * This driver supports various Xircom CreditCard Ethernet adapters
6 * including the CE2, CE IIps, RE-10, CEM28, CEM33, CE33, CEM56,
7 * CE3-100, CE3B, RE-100, REM10BT, and REM56G-100.
9 * 2000-09-24 <psheer@icon.co.za> The Xircom CE3B-100 may not
10 * autodetect the media properly. In this case use the
11 * if_port=1 (for 10BaseT) or if_port=4 (for 100BaseT) options
12 * to force the media type.
14 * Written originally by Werner Koch based on David Hinds' skeleton of the
15 * PCMCIA driver.
17 * Copyright (c) 1997,1998 Werner Koch (dd9jn)
19 * This driver is free software; you can redistribute it and/or modify
20 * it under the terms of the GNU General Public License as published by
21 * the Free Software Foundation; either version 2 of the License, or
22 * (at your option) any later version.
24 * It is distributed in the hope that it will be useful,
25 * but WITHOUT ANY WARRANTY; without even the implied warranty of
26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
27 * GNU General Public License for more details.
29 * You should have received a copy of the GNU General Public License
30 * along with this program; if not, write to the Free Software
31 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
34 * ALTERNATIVELY, this driver may be distributed under the terms of
35 * the following license, in which case the provisions of this license
36 * are required INSTEAD OF the GNU General Public License. (This clause
37 * is necessary due to a potential bad interaction between the GPL and
38 * the restrictions contained in a BSD-style copyright.)
40 * Redistribution and use in source and binary forms, with or without
41 * modification, are permitted provided that the following conditions
42 * are met:
43 * 1. Redistributions of source code must retain the above copyright
44 * notice, and the entire permission notice in its entirety,
45 * including the disclaimer of warranties.
46 * 2. Redistributions in binary form must reproduce the above copyright
47 * notice, this list of conditions and the following disclaimer in the
48 * documentation and/or other materials provided with the distribution.
49 * 3. The name of the author may not be used to endorse or promote
50 * products derived from this software without specific prior
51 * written permission.
53 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
54 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
55 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
56 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
57 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
58 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
59 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
60 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
61 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
62 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
63 * OF THE POSSIBILITY OF SUCH DAMAGE.
66 #include <linux/module.h>
67 #include <linux/kernel.h>
68 #include <linux/init.h>
69 #include <linux/ptrace.h>
70 #include <linux/slab.h>
71 #include <linux/string.h>
72 #include <linux/timer.h>
73 #include <linux/interrupt.h>
74 #include <linux/in.h>
75 #include <linux/delay.h>
76 #include <linux/ethtool.h>
77 #include <linux/netdevice.h>
78 #include <linux/etherdevice.h>
79 #include <linux/skbuff.h>
80 #include <linux/if_arp.h>
81 #include <linux/ioport.h>
82 #include <linux/bitops.h>
83 #include <linux/mii.h>
85 #include <pcmcia/cs_types.h>
86 #include <pcmcia/cs.h>
87 #include <pcmcia/cistpl.h>
88 #include <pcmcia/cisreg.h>
89 #include <pcmcia/ciscode.h>
91 #include <asm/io.h>
92 #include <asm/system.h>
93 #include <asm/uaccess.h>
95 #ifndef MANFID_COMPAQ
96 #define MANFID_COMPAQ 0x0138
97 #define MANFID_COMPAQ2 0x0183 /* is this correct? */
98 #endif
100 #include <pcmcia/ds.h>
102 /* Time in jiffies before concluding Tx hung */
103 #define TX_TIMEOUT ((400*HZ)/1000)
105 /****************
106 * Some constants used to access the hardware
109 /* Register offsets and value constans */
110 #define XIRCREG_CR 0 /* Command register (wr) */
111 enum xirc_cr {
112 TransmitPacket = 0x01,
113 SoftReset = 0x02,
114 EnableIntr = 0x04,
115 ForceIntr = 0x08,
116 ClearTxFIFO = 0x10,
117 ClearRxOvrun = 0x20,
118 RestartTx = 0x40
120 #define XIRCREG_ESR 0 /* Ethernet status register (rd) */
121 enum xirc_esr {
122 FullPktRcvd = 0x01, /* full packet in receive buffer */
123 PktRejected = 0x04, /* a packet has been rejected */
124 TxPktPend = 0x08, /* TX Packet Pending */
125 IncorPolarity = 0x10,
126 MediaSelect = 0x20 /* set if TP, clear if AUI */
128 #define XIRCREG_PR 1 /* Page Register select */
129 #define XIRCREG_EDP 4 /* Ethernet Data Port Register */
130 #define XIRCREG_ISR 6 /* Ethernet Interrupt Status Register */
131 enum xirc_isr {
132 TxBufOvr = 0x01, /* TX Buffer Overflow */
133 PktTxed = 0x02, /* Packet Transmitted */
134 MACIntr = 0x04, /* MAC Interrupt occurred */
135 TxResGrant = 0x08, /* Tx Reservation Granted */
136 RxFullPkt = 0x20, /* Rx Full Packet */
137 RxPktRej = 0x40, /* Rx Packet Rejected */
138 ForcedIntr= 0x80 /* Forced Interrupt */
140 #define XIRCREG1_IMR0 12 /* Ethernet Interrupt Mask Register (on page 1)*/
141 #define XIRCREG1_IMR1 13
142 #define XIRCREG0_TSO 8 /* Transmit Space Open Register (on page 0)*/
143 #define XIRCREG0_TRS 10 /* Transmit reservation Size Register (page 0)*/
144 #define XIRCREG0_DO 12 /* Data Offset Register (page 0) (wr) */
145 #define XIRCREG0_RSR 12 /* Receive Status Register (page 0) (rd) */
146 enum xirc_rsr {
147 PhyPkt = 0x01, /* set:physical packet, clear: multicast packet */
148 BrdcstPkt = 0x02, /* set if it is a broadcast packet */
149 PktTooLong = 0x04, /* set if packet length > 1518 */
150 AlignErr = 0x10, /* incorrect CRC and last octet not complete */
151 CRCErr = 0x20, /* incorrect CRC and last octet is complete */
152 PktRxOk = 0x80 /* received ok */
154 #define XIRCREG0_PTR 13 /* packets transmitted register (rd) */
155 #define XIRCREG0_RBC 14 /* receive byte count regsister (rd) */
156 #define XIRCREG1_ECR 14 /* ethernet configurationn register */
157 enum xirc_ecr {
158 FullDuplex = 0x04, /* enable full duplex mode */
159 LongTPMode = 0x08, /* adjust for longer lengths of TP cable */
160 DisablePolCor = 0x10,/* disable auto polarity correction */
161 DisableLinkPulse = 0x20, /* disable link pulse generation */
162 DisableAutoTx = 0x40, /* disable auto-transmit */
164 #define XIRCREG2_RBS 8 /* receive buffer start register */
165 #define XIRCREG2_LED 10 /* LED Configuration register */
166 /* values for the leds: Bits 2-0 for led 1
167 * 0 disabled Bits 5-3 for led 2
168 * 1 collision
169 * 2 noncollision
170 * 3 link_detected
171 * 4 incor_polarity
172 * 5 jabber
173 * 6 auto_assertion
174 * 7 rx_tx_activity
176 #define XIRCREG2_MSR 12 /* Mohawk specific register */
178 #define XIRCREG4_GPR0 8 /* General Purpose Register 0 */
179 #define XIRCREG4_GPR1 9 /* General Purpose Register 1 */
180 #define XIRCREG2_GPR2 13 /* General Purpose Register 2 (page2!)*/
181 #define XIRCREG4_BOV 10 /* Bonding Version Register */
182 #define XIRCREG4_LMA 12 /* Local Memory Address Register */
183 #define XIRCREG4_LMD 14 /* Local Memory Data Port */
184 /* MAC register can only by accessed with 8 bit operations */
185 #define XIRCREG40_CMD0 8 /* Command Register (wr) */
186 enum xirc_cmd { /* Commands */
187 Transmit = 0x01,
188 EnableRecv = 0x04,
189 DisableRecv = 0x08,
190 Abort = 0x10,
191 Online = 0x20,
192 IntrAck = 0x40,
193 Offline = 0x80
195 #define XIRCREG5_RHSA0 10 /* Rx Host Start Address */
196 #define XIRCREG40_RXST0 9 /* Receive Status Register */
197 #define XIRCREG40_TXST0 11 /* Transmit Status Register 0 */
198 #define XIRCREG40_TXST1 12 /* Transmit Status Register 10 */
199 #define XIRCREG40_RMASK0 13 /* Receive Mask Register */
200 #define XIRCREG40_TMASK0 14 /* Transmit Mask Register 0 */
201 #define XIRCREG40_TMASK1 15 /* Transmit Mask Register 0 */
202 #define XIRCREG42_SWC0 8 /* Software Configuration 0 */
203 #define XIRCREG42_SWC1 9 /* Software Configuration 1 */
204 #define XIRCREG42_BOC 10 /* Back-Off Configuration */
205 #define XIRCREG44_TDR0 8 /* Time Domain Reflectometry 0 */
206 #define XIRCREG44_TDR1 9 /* Time Domain Reflectometry 1 */
207 #define XIRCREG44_RXBC_LO 10 /* Rx Byte Count 0 (rd) */
208 #define XIRCREG44_RXBC_HI 11 /* Rx Byte Count 1 (rd) */
209 #define XIRCREG45_REV 15 /* Revision Register (rd) */
210 #define XIRCREG50_IA 8 /* Individual Address (8-13) */
212 static const char *if_names[] = { "Auto", "10BaseT", "10Base2", "AUI", "100BaseT" };
215 #define KDBG_XIRC KERN_DEBUG "xirc2ps_cs: "
216 #define KERR_XIRC KERN_ERR "xirc2ps_cs: "
217 #define KWRN_XIRC KERN_WARNING "xirc2ps_cs: "
218 #define KNOT_XIRC KERN_NOTICE "xirc2ps_cs: "
219 #define KINF_XIRC KERN_INFO "xirc2ps_cs: "
221 /* card types */
222 #define XIR_UNKNOWN 0 /* unknown: not supported */
223 #define XIR_CE 1 /* (prodid 1) different hardware: not supported */
224 #define XIR_CE2 2 /* (prodid 2) */
225 #define XIR_CE3 3 /* (prodid 3) */
226 #define XIR_CEM 4 /* (prodid 1) different hardware: not supported */
227 #define XIR_CEM2 5 /* (prodid 2) */
228 #define XIR_CEM3 6 /* (prodid 3) */
229 #define XIR_CEM33 7 /* (prodid 4) */
230 #define XIR_CEM56M 8 /* (prodid 5) */
231 #define XIR_CEM56 9 /* (prodid 6) */
232 #define XIR_CM28 10 /* (prodid 3) modem only: not supported here */
233 #define XIR_CM33 11 /* (prodid 4) modem only: not supported here */
234 #define XIR_CM56 12 /* (prodid 5) modem only: not supported here */
235 #define XIR_CG 13 /* (prodid 1) GSM modem only: not supported */
236 #define XIR_CBE 14 /* (prodid 1) cardbus ethernet: not supported */
237 /*====================================================================*/
239 /* Module parameters */
241 MODULE_DESCRIPTION("Xircom PCMCIA ethernet driver");
242 MODULE_LICENSE("Dual MPL/GPL");
244 #define INT_MODULE_PARM(n, v) static int n = v; module_param(n, int, 0)
246 INT_MODULE_PARM(if_port, 0);
247 INT_MODULE_PARM(full_duplex, 0);
248 INT_MODULE_PARM(do_sound, 1);
249 INT_MODULE_PARM(lockup_hack, 0); /* anti lockup hack */
251 /*====================================================================*/
253 /* We do not process more than these number of bytes during one
254 * interrupt. (Of course we receive complete packets, so this is not
255 * an exact value).
256 * Something between 2000..22000; first value gives best interrupt latency,
257 * the second enables the usage of the complete on-chip buffer. We use the
258 * high value as the initial value.
260 static unsigned maxrx_bytes = 22000;
262 /* MII management prototypes */
263 static void mii_idle(unsigned int ioaddr);
264 static void mii_putbit(unsigned int ioaddr, unsigned data);
265 static int mii_getbit(unsigned int ioaddr);
266 static void mii_wbits(unsigned int ioaddr, unsigned data, int len);
267 static unsigned mii_rd(unsigned int ioaddr, u_char phyaddr, u_char phyreg);
268 static void mii_wr(unsigned int ioaddr, u_char phyaddr, u_char phyreg,
269 unsigned data, int len);
272 * The event() function is this driver's Card Services event handler.
273 * It will be called by Card Services when an appropriate card status
274 * event is received. The config() and release() entry points are
275 * used to configure or release a socket, in response to card insertion
276 * and ejection events. They are invoked from the event handler.
279 static int has_ce2_string(struct pcmcia_device * link);
280 static int xirc2ps_config(struct pcmcia_device * link);
281 static void xirc2ps_release(struct pcmcia_device * link);
283 /****************
284 * The attach() and detach() entry points are used to create and destroy
285 * "instances" of the driver, where each instance represents everything
286 * needed to manage one actual PCMCIA card.
289 static void xirc2ps_detach(struct pcmcia_device *p_dev);
291 /****************
292 * You'll also need to prototype all the functions that will actually
293 * be used to talk to your device. See 'pcmem_cs' for a good example
294 * of a fully self-sufficient driver; the other drivers rely more or
295 * less on other parts of the kernel.
298 static irqreturn_t xirc2ps_interrupt(int irq, void *dev_id);
300 /****************
301 * A linked list of "instances" of the device. Each actual
302 * PCMCIA card corresponds to one device instance, and is described
303 * by one struct pcmcia_device structure (defined in ds.h).
305 * You may not want to use a linked list for this -- for example, the
306 * memory card driver uses an array of struct pcmcia_device pointers, where minor
307 * device numbers are used to derive the corresponding array index.
310 /****************
311 * A driver needs to provide a dev_node_t structure for each device
312 * on a card. In some cases, there is only one device per card (for
313 * example, ethernet cards, modems). In other cases, there may be
314 * many actual or logical devices (SCSI adapters, memory cards with
315 * multiple partitions). The dev_node_t structures need to be kept
316 * in a linked list starting at the 'dev' field of a struct pcmcia_device
317 * structure. We allocate them in the card's private data structure,
318 * because they generally can't be allocated dynamically.
321 typedef struct local_info_t {
322 struct net_device *dev;
323 struct pcmcia_device *p_dev;
324 dev_node_t node;
326 int card_type;
327 int probe_port;
328 int silicon; /* silicon revision. 0=old CE2, 1=Scipper, 4=Mohawk */
329 int mohawk; /* a CE3 type card */
330 int dingo; /* a CEM56 type card */
331 int new_mii; /* has full 10baseT/100baseT MII */
332 int modem; /* is a multi function card (i.e with a modem) */
333 void __iomem *dingo_ccr; /* only used for CEM56 cards */
334 unsigned last_ptr_value; /* last packets transmitted value */
335 const char *manf_str;
336 struct work_struct tx_timeout_task;
337 } local_info_t;
339 /****************
340 * Some more prototypes
342 static netdev_tx_t do_start_xmit(struct sk_buff *skb,
343 struct net_device *dev);
344 static void xirc_tx_timeout(struct net_device *dev);
345 static void xirc2ps_tx_timeout_task(struct work_struct *work);
346 static void set_addresses(struct net_device *dev);
347 static void set_multicast_list(struct net_device *dev);
348 static int set_card_type(struct pcmcia_device *link);
349 static int do_config(struct net_device *dev, struct ifmap *map);
350 static int do_open(struct net_device *dev);
351 static int do_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
352 static const struct ethtool_ops netdev_ethtool_ops;
353 static void hardreset(struct net_device *dev);
354 static void do_reset(struct net_device *dev, int full);
355 static int init_mii(struct net_device *dev);
356 static void do_powerdown(struct net_device *dev);
357 static int do_stop(struct net_device *dev);
359 /*=============== Helper functions =========================*/
360 #define SelectPage(pgnr) outb((pgnr), ioaddr + XIRCREG_PR)
361 #define GetByte(reg) ((unsigned)inb(ioaddr + (reg)))
362 #define GetWord(reg) ((unsigned)inw(ioaddr + (reg)))
363 #define PutByte(reg,value) outb((value), ioaddr+(reg))
364 #define PutWord(reg,value) outw((value), ioaddr+(reg))
366 /*====== Functions used for debugging =================================*/
367 #if 0 /* reading regs may change system status */
368 static void
369 PrintRegisters(struct net_device *dev)
371 unsigned int ioaddr = dev->base_addr;
373 if (pc_debug > 1) {
374 int i, page;
376 printk(KDBG_XIRC "Register common: ");
377 for (i = 0; i < 8; i++)
378 printk(" %2.2x", GetByte(i));
379 printk("\n");
380 for (page = 0; page <= 8; page++) {
381 printk(KDBG_XIRC "Register page %2x: ", page);
382 SelectPage(page);
383 for (i = 8; i < 16; i++)
384 printk(" %2.2x", GetByte(i));
385 printk("\n");
387 for (page=0x40 ; page <= 0x5f; page++) {
388 if (page == 0x43 || (page >= 0x46 && page <= 0x4f)
389 || (page >= 0x51 && page <=0x5e))
390 continue;
391 printk(KDBG_XIRC "Register page %2x: ", page);
392 SelectPage(page);
393 for (i = 8; i < 16; i++)
394 printk(" %2.2x", GetByte(i));
395 printk("\n");
399 #endif /* 0 */
401 /*============== MII Management functions ===============*/
403 /****************
404 * Turn around for read
406 static void
407 mii_idle(unsigned int ioaddr)
409 PutByte(XIRCREG2_GPR2, 0x04|0); /* drive MDCK low */
410 udelay(1);
411 PutByte(XIRCREG2_GPR2, 0x04|1); /* and drive MDCK high */
412 udelay(1);
415 /****************
416 * Write a bit to MDI/O
418 static void
419 mii_putbit(unsigned int ioaddr, unsigned data)
421 #if 1
422 if (data) {
423 PutByte(XIRCREG2_GPR2, 0x0c|2|0); /* set MDIO */
424 udelay(1);
425 PutByte(XIRCREG2_GPR2, 0x0c|2|1); /* and drive MDCK high */
426 udelay(1);
427 } else {
428 PutByte(XIRCREG2_GPR2, 0x0c|0|0); /* clear MDIO */
429 udelay(1);
430 PutByte(XIRCREG2_GPR2, 0x0c|0|1); /* and drive MDCK high */
431 udelay(1);
433 #else
434 if (data) {
435 PutWord(XIRCREG2_GPR2-1, 0x0e0e);
436 udelay(1);
437 PutWord(XIRCREG2_GPR2-1, 0x0f0f);
438 udelay(1);
439 } else {
440 PutWord(XIRCREG2_GPR2-1, 0x0c0c);
441 udelay(1);
442 PutWord(XIRCREG2_GPR2-1, 0x0d0d);
443 udelay(1);
445 #endif
448 /****************
449 * Get a bit from MDI/O
451 static int
452 mii_getbit(unsigned int ioaddr)
454 unsigned d;
456 PutByte(XIRCREG2_GPR2, 4|0); /* drive MDCK low */
457 udelay(1);
458 d = GetByte(XIRCREG2_GPR2); /* read MDIO */
459 PutByte(XIRCREG2_GPR2, 4|1); /* drive MDCK high again */
460 udelay(1);
461 return d & 0x20; /* read MDIO */
464 static void
465 mii_wbits(unsigned int ioaddr, unsigned data, int len)
467 unsigned m = 1 << (len-1);
468 for (; m; m >>= 1)
469 mii_putbit(ioaddr, data & m);
472 static unsigned
473 mii_rd(unsigned int ioaddr, u_char phyaddr, u_char phyreg)
475 int i;
476 unsigned data=0, m;
478 SelectPage(2);
479 for (i=0; i < 32; i++) /* 32 bit preamble */
480 mii_putbit(ioaddr, 1);
481 mii_wbits(ioaddr, 0x06, 4); /* Start and opcode for read */
482 mii_wbits(ioaddr, phyaddr, 5); /* PHY address to be accessed */
483 mii_wbits(ioaddr, phyreg, 5); /* PHY register to read */
484 mii_idle(ioaddr); /* turn around */
485 mii_getbit(ioaddr);
487 for (m = 1<<15; m; m >>= 1)
488 if (mii_getbit(ioaddr))
489 data |= m;
490 mii_idle(ioaddr);
491 return data;
494 static void
495 mii_wr(unsigned int ioaddr, u_char phyaddr, u_char phyreg, unsigned data,
496 int len)
498 int i;
500 SelectPage(2);
501 for (i=0; i < 32; i++) /* 32 bit preamble */
502 mii_putbit(ioaddr, 1);
503 mii_wbits(ioaddr, 0x05, 4); /* Start and opcode for write */
504 mii_wbits(ioaddr, phyaddr, 5); /* PHY address to be accessed */
505 mii_wbits(ioaddr, phyreg, 5); /* PHY Register to write */
506 mii_putbit(ioaddr, 1); /* turn around */
507 mii_putbit(ioaddr, 0);
508 mii_wbits(ioaddr, data, len); /* And write the data */
509 mii_idle(ioaddr);
512 /*============= Main bulk of functions =========================*/
514 static const struct net_device_ops netdev_ops = {
515 .ndo_open = do_open,
516 .ndo_stop = do_stop,
517 .ndo_start_xmit = do_start_xmit,
518 .ndo_tx_timeout = xirc_tx_timeout,
519 .ndo_set_config = do_config,
520 .ndo_do_ioctl = do_ioctl,
521 .ndo_set_multicast_list = set_multicast_list,
522 .ndo_change_mtu = eth_change_mtu,
523 .ndo_set_mac_address = eth_mac_addr,
524 .ndo_validate_addr = eth_validate_addr,
527 /****************
528 * xirc2ps_attach() creates an "instance" of the driver, allocating
529 * local data structures for one device. The device is registered
530 * with Card Services.
532 * The dev_link structure is initialized, but we don't actually
533 * configure the card at this point -- we wait until we receive a
534 * card insertion event.
537 static int
538 xirc2ps_probe(struct pcmcia_device *link)
540 struct net_device *dev;
541 local_info_t *local;
543 dev_dbg(&link->dev, "attach()\n");
545 /* Allocate the device structure */
546 dev = alloc_etherdev(sizeof(local_info_t));
547 if (!dev)
548 return -ENOMEM;
549 local = netdev_priv(dev);
550 local->dev = dev;
551 local->p_dev = link;
552 link->priv = dev;
554 /* General socket configuration */
555 link->conf.Attributes = CONF_ENABLE_IRQ;
556 link->conf.IntType = INT_MEMORY_AND_IO;
557 link->conf.ConfigIndex = 1;
558 link->irq.Handler = xirc2ps_interrupt;
559 link->irq.Instance = dev;
561 /* Fill in card specific entries */
562 dev->netdev_ops = &netdev_ops;
563 dev->ethtool_ops = &netdev_ethtool_ops;
564 dev->watchdog_timeo = TX_TIMEOUT;
565 INIT_WORK(&local->tx_timeout_task, xirc2ps_tx_timeout_task);
567 return xirc2ps_config(link);
568 } /* xirc2ps_attach */
570 /****************
571 * This deletes a driver "instance". The device is de-registered
572 * with Card Services. If it has been released, all local data
573 * structures are freed. Otherwise, the structures will be freed
574 * when the device is released.
577 static void
578 xirc2ps_detach(struct pcmcia_device *link)
580 struct net_device *dev = link->priv;
582 dev_dbg(&link->dev, "detach\n");
584 if (link->dev_node)
585 unregister_netdev(dev);
587 xirc2ps_release(link);
589 free_netdev(dev);
590 } /* xirc2ps_detach */
592 /****************
593 * Detect the type of the card. s is the buffer with the data of tuple 0x20
594 * Returns: 0 := not supported
595 * mediaid=11 and prodid=47
596 * Media-Id bits:
597 * Ethernet 0x01
598 * Tokenring 0x02
599 * Arcnet 0x04
600 * Wireless 0x08
601 * Modem 0x10
602 * GSM only 0x20
603 * Prod-Id bits:
604 * Pocket 0x10
605 * External 0x20
606 * Creditcard 0x40
607 * Cardbus 0x80
610 static int
611 set_card_type(struct pcmcia_device *link)
613 struct net_device *dev = link->priv;
614 local_info_t *local = netdev_priv(dev);
615 u8 *buf;
616 unsigned int cisrev, mediaid, prodid;
617 size_t len;
619 len = pcmcia_get_tuple(link, CISTPL_MANFID, &buf);
620 if (len < 5) {
621 dev_err(&link->dev, "invalid CIS -- sorry\n");
622 return 0;
625 cisrev = buf[2];
626 mediaid = buf[3];
627 prodid = buf[4];
629 dev_dbg(&link->dev, "cisrev=%02x mediaid=%02x prodid=%02x\n",
630 cisrev, mediaid, prodid);
632 local->mohawk = 0;
633 local->dingo = 0;
634 local->modem = 0;
635 local->card_type = XIR_UNKNOWN;
636 if (!(prodid & 0x40)) {
637 printk(KNOT_XIRC "Ooops: Not a creditcard\n");
638 return 0;
640 if (!(mediaid & 0x01)) {
641 printk(KNOT_XIRC "Not an Ethernet card\n");
642 return 0;
644 if (mediaid & 0x10) {
645 local->modem = 1;
646 switch(prodid & 15) {
647 case 1: local->card_type = XIR_CEM ; break;
648 case 2: local->card_type = XIR_CEM2 ; break;
649 case 3: local->card_type = XIR_CEM3 ; break;
650 case 4: local->card_type = XIR_CEM33 ; break;
651 case 5: local->card_type = XIR_CEM56M;
652 local->mohawk = 1;
653 break;
654 case 6:
655 case 7: /* 7 is the RealPort 10/56 */
656 local->card_type = XIR_CEM56 ;
657 local->mohawk = 1;
658 local->dingo = 1;
659 break;
661 } else {
662 switch(prodid & 15) {
663 case 1: local->card_type = has_ce2_string(link)? XIR_CE2 : XIR_CE ;
664 break;
665 case 2: local->card_type = XIR_CE2; break;
666 case 3: local->card_type = XIR_CE3;
667 local->mohawk = 1;
668 break;
671 if (local->card_type == XIR_CE || local->card_type == XIR_CEM) {
672 printk(KNOT_XIRC "Sorry, this is an old CE card\n");
673 return 0;
675 if (local->card_type == XIR_UNKNOWN)
676 printk(KNOT_XIRC "unknown card (mediaid=%02x prodid=%02x)\n",
677 mediaid, prodid);
679 return 1;
682 /****************
683 * There are some CE2 cards out which claim to be a CE card.
684 * This function looks for a "CE2" in the 3rd version field.
685 * Returns: true if this is a CE2
687 static int
688 has_ce2_string(struct pcmcia_device * p_dev)
690 if (p_dev->prod_id[2] && strstr(p_dev->prod_id[2], "CE2"))
691 return 1;
692 return 0;
695 static int
696 xirc2ps_config_modem(struct pcmcia_device *p_dev,
697 cistpl_cftable_entry_t *cf,
698 cistpl_cftable_entry_t *dflt,
699 unsigned int vcc,
700 void *priv_data)
702 unsigned int ioaddr;
704 if (cf->io.nwin > 0 && (cf->io.win[0].base & 0xf) == 8) {
705 for (ioaddr = 0x300; ioaddr < 0x400; ioaddr += 0x10) {
706 p_dev->io.BasePort2 = cf->io.win[0].base;
707 p_dev->io.BasePort1 = ioaddr;
708 if (!pcmcia_request_io(p_dev, &p_dev->io))
709 return 0;
712 return -ENODEV;
715 static int
716 xirc2ps_config_check(struct pcmcia_device *p_dev,
717 cistpl_cftable_entry_t *cf,
718 cistpl_cftable_entry_t *dflt,
719 unsigned int vcc,
720 void *priv_data)
722 int *pass = priv_data;
724 if (cf->io.nwin > 0 && (cf->io.win[0].base & 0xf) == 8) {
725 p_dev->io.BasePort2 = cf->io.win[0].base;
726 p_dev->io.BasePort1 = p_dev->io.BasePort2
727 + (*pass ? (cf->index & 0x20 ? -24:8)
728 : (cf->index & 0x20 ? 8:-24));
729 if (!pcmcia_request_io(p_dev, &p_dev->io))
730 return 0;
732 return -ENODEV;
737 static int pcmcia_get_mac_ce(struct pcmcia_device *p_dev,
738 tuple_t *tuple,
739 void *priv)
741 struct net_device *dev = priv;
742 int i;
744 if (tuple->TupleDataLen != 13)
745 return -EINVAL;
746 if ((tuple->TupleData[0] != 2) || (tuple->TupleData[1] != 1) ||
747 (tuple->TupleData[2] != 6))
748 return -EINVAL;
749 /* another try (James Lehmer's CE2 version 4.1)*/
750 for (i = 2; i < 6; i++)
751 dev->dev_addr[i] = tuple->TupleData[i+2];
752 return 0;
756 /****************
757 * xirc2ps_config() is scheduled to run after a CARD_INSERTION event
758 * is received, to configure the PCMCIA socket, and to make the
759 * ethernet device available to the system.
761 static int
762 xirc2ps_config(struct pcmcia_device * link)
764 struct net_device *dev = link->priv;
765 local_info_t *local = netdev_priv(dev);
766 unsigned int ioaddr;
767 int err;
768 u8 *buf;
769 size_t len;
771 local->dingo_ccr = NULL;
773 dev_dbg(&link->dev, "config\n");
775 /* Is this a valid card */
776 if (link->has_manf_id == 0) {
777 printk(KNOT_XIRC "manfid not found in CIS\n");
778 goto failure;
781 switch (link->manf_id) {
782 case MANFID_XIRCOM:
783 local->manf_str = "Xircom";
784 break;
785 case MANFID_ACCTON:
786 local->manf_str = "Accton";
787 break;
788 case MANFID_COMPAQ:
789 case MANFID_COMPAQ2:
790 local->manf_str = "Compaq";
791 break;
792 case MANFID_INTEL:
793 local->manf_str = "Intel";
794 break;
795 case MANFID_TOSHIBA:
796 local->manf_str = "Toshiba";
797 break;
798 default:
799 printk(KNOT_XIRC "Unknown Card Manufacturer ID: 0x%04x\n",
800 (unsigned)link->manf_id);
801 goto failure;
803 dev_dbg(&link->dev, "found %s card\n", local->manf_str);
805 if (!set_card_type(link)) {
806 printk(KNOT_XIRC "this card is not supported\n");
807 goto failure;
810 /* get the ethernet address from the CIS */
811 err = pcmcia_get_mac_from_cis(link, dev);
813 /* not found: try to get the node-id from tuple 0x89 */
814 if (err) {
815 len = pcmcia_get_tuple(link, 0x89, &buf);
816 /* data layout looks like tuple 0x22 */
817 if (buf && len == 8) {
818 if (*buf == CISTPL_FUNCE_LAN_NODE_ID) {
819 int i;
820 for (i = 2; i < 6; i++)
821 dev->dev_addr[i] = buf[i+2];
822 } else
823 err = -1;
825 kfree(buf);
828 if (err)
829 err = pcmcia_loop_tuple(link, CISTPL_FUNCE, pcmcia_get_mac_ce, dev);
831 if (err) {
832 printk(KNOT_XIRC "node-id not found in CIS\n");
833 goto failure;
836 link->io.IOAddrLines =10;
837 link->io.Attributes1 = IO_DATA_PATH_WIDTH_16;
838 link->irq.Attributes = IRQ_HANDLE_PRESENT;
839 link->irq.IRQInfo1 = IRQ_LEVEL_ID;
840 if (local->modem) {
841 int pass;
843 if (do_sound) {
844 link->conf.Attributes |= CONF_ENABLE_SPKR;
845 link->conf.Status |= CCSR_AUDIO_ENA;
847 link->irq.Attributes |= IRQ_TYPE_DYNAMIC_SHARING|IRQ_FIRST_SHARED ;
848 link->io.NumPorts2 = 8;
849 link->io.Attributes2 = IO_DATA_PATH_WIDTH_8;
850 if (local->dingo) {
851 /* Take the Modem IO port from the CIS and scan for a free
852 * Ethernet port */
853 link->io.NumPorts1 = 16; /* no Mako stuff anymore */
854 if (!pcmcia_loop_config(link, xirc2ps_config_modem, NULL))
855 goto port_found;
856 } else {
857 link->io.NumPorts1 = 18;
858 /* We do 2 passes here: The first one uses the regular mapping and
859 * the second tries again, thereby considering that the 32 ports are
860 * mirrored every 32 bytes. Actually we use a mirrored port for
861 * the Mako if (on the first pass) the COR bit 5 is set.
863 for (pass=0; pass < 2; pass++)
864 if (!pcmcia_loop_config(link, xirc2ps_config_check, &pass))
865 goto port_found;
866 /* if special option:
867 * try to configure as Ethernet only.
868 * .... */
870 printk(KNOT_XIRC "no ports available\n");
871 } else {
872 link->irq.Attributes |= IRQ_TYPE_DYNAMIC_SHARING;
873 link->io.NumPorts1 = 16;
874 for (ioaddr = 0x300; ioaddr < 0x400; ioaddr += 0x10) {
875 link->io.BasePort1 = ioaddr;
876 if (!(err=pcmcia_request_io(link, &link->io)))
877 goto port_found;
879 link->io.BasePort1 = 0; /* let CS decide */
880 if ((err=pcmcia_request_io(link, &link->io)))
881 goto config_error;
883 port_found:
884 if (err)
885 goto config_error;
887 /****************
888 * Now allocate an interrupt line. Note that this does not
889 * actually assign a handler to the interrupt.
891 if ((err=pcmcia_request_irq(link, &link->irq)))
892 goto config_error;
894 /****************
895 * This actually configures the PCMCIA socket -- setting up
896 * the I/O windows and the interrupt mapping.
898 if ((err=pcmcia_request_configuration(link, &link->conf)))
899 goto config_error;
901 if (local->dingo) {
902 conf_reg_t reg;
903 win_req_t req;
904 memreq_t mem;
906 /* Reset the modem's BAR to the correct value
907 * This is necessary because in the RequestConfiguration call,
908 * the base address of the ethernet port (BasePort1) is written
909 * to the BAR registers of the modem.
911 reg.Action = CS_WRITE;
912 reg.Offset = CISREG_IOBASE_0;
913 reg.Value = link->io.BasePort2 & 0xff;
914 if ((err = pcmcia_access_configuration_register(link, &reg)))
915 goto config_error;
916 reg.Action = CS_WRITE;
917 reg.Offset = CISREG_IOBASE_1;
918 reg.Value = (link->io.BasePort2 >> 8) & 0xff;
919 if ((err = pcmcia_access_configuration_register(link, &reg)))
920 goto config_error;
922 /* There is no config entry for the Ethernet part which
923 * is at 0x0800. So we allocate a window into the attribute
924 * memory and write direct to the CIS registers
926 req.Attributes = WIN_DATA_WIDTH_8|WIN_MEMORY_TYPE_AM|WIN_ENABLE;
927 req.Base = req.Size = 0;
928 req.AccessSpeed = 0;
929 if ((err = pcmcia_request_window(link, &req, &link->win)))
930 goto config_error;
932 local->dingo_ccr = ioremap(req.Base,0x1000) + 0x0800;
933 mem.CardOffset = 0x0;
934 mem.Page = 0;
935 if ((err = pcmcia_map_mem_page(link, link->win, &mem)))
936 goto config_error;
938 /* Setup the CCRs; there are no infos in the CIS about the Ethernet
939 * part.
941 writeb(0x47, local->dingo_ccr + CISREG_COR);
942 ioaddr = link->io.BasePort1;
943 writeb(ioaddr & 0xff , local->dingo_ccr + CISREG_IOBASE_0);
944 writeb((ioaddr >> 8)&0xff , local->dingo_ccr + CISREG_IOBASE_1);
946 #if 0
948 u_char tmp;
949 printk(KERN_INFO "ECOR:");
950 for (i=0; i < 7; i++) {
951 tmp = readb(local->dingo_ccr + i*2);
952 printk(" %02x", tmp);
954 printk("\n");
955 printk(KERN_INFO "DCOR:");
956 for (i=0; i < 4; i++) {
957 tmp = readb(local->dingo_ccr + 0x20 + i*2);
958 printk(" %02x", tmp);
960 printk("\n");
961 printk(KERN_INFO "SCOR:");
962 for (i=0; i < 10; i++) {
963 tmp = readb(local->dingo_ccr + 0x40 + i*2);
964 printk(" %02x", tmp);
966 printk("\n");
968 #endif
970 writeb(0x01, local->dingo_ccr + 0x20);
971 writeb(0x0c, local->dingo_ccr + 0x22);
972 writeb(0x00, local->dingo_ccr + 0x24);
973 writeb(0x00, local->dingo_ccr + 0x26);
974 writeb(0x00, local->dingo_ccr + 0x28);
977 /* The if_port symbol can be set when the module is loaded */
978 local->probe_port=0;
979 if (!if_port) {
980 local->probe_port = dev->if_port = 1;
981 } else if ((if_port >= 1 && if_port <= 2) ||
982 (local->mohawk && if_port==4))
983 dev->if_port = if_port;
984 else
985 printk(KNOT_XIRC "invalid if_port requested\n");
987 /* we can now register the device with the net subsystem */
988 dev->irq = link->irq.AssignedIRQ;
989 dev->base_addr = link->io.BasePort1;
991 if (local->dingo)
992 do_reset(dev, 1); /* a kludge to make the cem56 work */
994 link->dev_node = &local->node;
995 SET_NETDEV_DEV(dev, &handle_to_dev(link));
997 if ((err=register_netdev(dev))) {
998 printk(KNOT_XIRC "register_netdev() failed\n");
999 link->dev_node = NULL;
1000 goto config_error;
1003 strcpy(local->node.dev_name, dev->name);
1005 /* give some infos about the hardware */
1006 printk(KERN_INFO "%s: %s: port %#3lx, irq %d, hwaddr %pM\n",
1007 dev->name, local->manf_str,(u_long)dev->base_addr, (int)dev->irq,
1008 dev->dev_addr);
1010 return 0;
1012 config_error:
1013 xirc2ps_release(link);
1014 return -ENODEV;
1016 failure:
1017 return -ENODEV;
1018 } /* xirc2ps_config */
1020 /****************
1021 * After a card is removed, xirc2ps_release() will unregister the net
1022 * device, and release the PCMCIA configuration. If the device is
1023 * still open, this will be postponed until it is closed.
1025 static void
1026 xirc2ps_release(struct pcmcia_device *link)
1028 dev_dbg(&link->dev, "release\n");
1030 if (link->win) {
1031 struct net_device *dev = link->priv;
1032 local_info_t *local = netdev_priv(dev);
1033 if (local->dingo)
1034 iounmap(local->dingo_ccr - 0x0800);
1036 pcmcia_disable_device(link);
1037 } /* xirc2ps_release */
1039 /*====================================================================*/
1042 static int xirc2ps_suspend(struct pcmcia_device *link)
1044 struct net_device *dev = link->priv;
1046 if (link->open) {
1047 netif_device_detach(dev);
1048 do_powerdown(dev);
1051 return 0;
1054 static int xirc2ps_resume(struct pcmcia_device *link)
1056 struct net_device *dev = link->priv;
1058 if (link->open) {
1059 do_reset(dev,1);
1060 netif_device_attach(dev);
1063 return 0;
1067 /*====================================================================*/
1069 /****************
1070 * This is the Interrupt service route.
1072 static irqreturn_t
1073 xirc2ps_interrupt(int irq, void *dev_id)
1075 struct net_device *dev = (struct net_device *)dev_id;
1076 local_info_t *lp = netdev_priv(dev);
1077 unsigned int ioaddr;
1078 u_char saved_page;
1079 unsigned bytes_rcvd;
1080 unsigned int_status, eth_status, rx_status, tx_status;
1081 unsigned rsr, pktlen;
1082 ulong start_ticks = jiffies; /* fixme: jiffies rollover every 497 days
1083 * is this something to worry about?
1084 * -- on a laptop?
1087 if (!netif_device_present(dev))
1088 return IRQ_HANDLED;
1090 ioaddr = dev->base_addr;
1091 if (lp->mohawk) { /* must disable the interrupt */
1092 PutByte(XIRCREG_CR, 0);
1095 pr_debug("%s: interrupt %d at %#x.\n", dev->name, irq, ioaddr);
1097 saved_page = GetByte(XIRCREG_PR);
1098 /* Read the ISR to see whats the cause for the interrupt.
1099 * This also clears the interrupt flags on CE2 cards
1101 int_status = GetByte(XIRCREG_ISR);
1102 bytes_rcvd = 0;
1103 loop_entry:
1104 if (int_status == 0xff) { /* card may be ejected */
1105 pr_debug("%s: interrupt %d for dead card\n", dev->name, irq);
1106 goto leave;
1108 eth_status = GetByte(XIRCREG_ESR);
1110 SelectPage(0x40);
1111 rx_status = GetByte(XIRCREG40_RXST0);
1112 PutByte(XIRCREG40_RXST0, (~rx_status & 0xff));
1113 tx_status = GetByte(XIRCREG40_TXST0);
1114 tx_status |= GetByte(XIRCREG40_TXST1) << 8;
1115 PutByte(XIRCREG40_TXST0, 0);
1116 PutByte(XIRCREG40_TXST1, 0);
1118 pr_debug("%s: ISR=%#2.2x ESR=%#2.2x RSR=%#2.2x TSR=%#4.4x\n",
1119 dev->name, int_status, eth_status, rx_status, tx_status);
1121 /***** receive section ******/
1122 SelectPage(0);
1123 while (eth_status & FullPktRcvd) {
1124 rsr = GetByte(XIRCREG0_RSR);
1125 if (bytes_rcvd > maxrx_bytes && (rsr & PktRxOk)) {
1126 /* too many bytes received during this int, drop the rest of the
1127 * packets */
1128 dev->stats.rx_dropped++;
1129 pr_debug("%s: RX drop, too much done\n", dev->name);
1130 } else if (rsr & PktRxOk) {
1131 struct sk_buff *skb;
1133 pktlen = GetWord(XIRCREG0_RBC);
1134 bytes_rcvd += pktlen;
1136 pr_debug("rsr=%#02x packet_length=%u\n", rsr, pktlen);
1138 skb = dev_alloc_skb(pktlen+3); /* 1 extra so we can use insw */
1139 if (!skb) {
1140 printk(KNOT_XIRC "low memory, packet dropped (size=%u)\n",
1141 pktlen);
1142 dev->stats.rx_dropped++;
1143 } else { /* okay get the packet */
1144 skb_reserve(skb, 2);
1145 if (lp->silicon == 0 ) { /* work around a hardware bug */
1146 unsigned rhsa; /* receive start address */
1148 SelectPage(5);
1149 rhsa = GetWord(XIRCREG5_RHSA0);
1150 SelectPage(0);
1151 rhsa += 3; /* skip control infos */
1152 if (rhsa >= 0x8000)
1153 rhsa = 0;
1154 if (rhsa + pktlen > 0x8000) {
1155 unsigned i;
1156 u_char *buf = skb_put(skb, pktlen);
1157 for (i=0; i < pktlen ; i++, rhsa++) {
1158 buf[i] = GetByte(XIRCREG_EDP);
1159 if (rhsa == 0x8000) {
1160 rhsa = 0;
1161 i--;
1164 } else {
1165 insw(ioaddr+XIRCREG_EDP,
1166 skb_put(skb, pktlen), (pktlen+1)>>1);
1169 #if 0
1170 else if (lp->mohawk) {
1171 /* To use this 32 bit access we should use
1172 * a manual optimized loop
1173 * Also the words are swapped, we can get more
1174 * performance by using 32 bit access and swapping
1175 * the words in a register. Will need this for cardbus
1177 * Note: don't forget to change the ALLOC_SKB to .. +3
1179 unsigned i;
1180 u_long *p = skb_put(skb, pktlen);
1181 register u_long a;
1182 unsigned int edpreg = ioaddr+XIRCREG_EDP-2;
1183 for (i=0; i < len ; i += 4, p++) {
1184 a = inl(edpreg);
1185 __asm__("rorl $16,%0\n\t"
1186 :"=q" (a)
1187 : "0" (a));
1188 *p = a;
1191 #endif
1192 else {
1193 insw(ioaddr+XIRCREG_EDP, skb_put(skb, pktlen),
1194 (pktlen+1)>>1);
1196 skb->protocol = eth_type_trans(skb, dev);
1197 netif_rx(skb);
1198 dev->stats.rx_packets++;
1199 dev->stats.rx_bytes += pktlen;
1200 if (!(rsr & PhyPkt))
1201 dev->stats.multicast++;
1203 } else { /* bad packet */
1204 pr_debug("rsr=%#02x\n", rsr);
1206 if (rsr & PktTooLong) {
1207 dev->stats.rx_frame_errors++;
1208 pr_debug("%s: Packet too long\n", dev->name);
1210 if (rsr & CRCErr) {
1211 dev->stats.rx_crc_errors++;
1212 pr_debug("%s: CRC error\n", dev->name);
1214 if (rsr & AlignErr) {
1215 dev->stats.rx_fifo_errors++; /* okay ? */
1216 pr_debug("%s: Alignment error\n", dev->name);
1219 /* clear the received/dropped/error packet */
1220 PutWord(XIRCREG0_DO, 0x8000); /* issue cmd: skip_rx_packet */
1222 /* get the new ethernet status */
1223 eth_status = GetByte(XIRCREG_ESR);
1225 if (rx_status & 0x10) { /* Receive overrun */
1226 dev->stats.rx_over_errors++;
1227 PutByte(XIRCREG_CR, ClearRxOvrun);
1228 pr_debug("receive overrun cleared\n");
1231 /***** transmit section ******/
1232 if (int_status & PktTxed) {
1233 unsigned n, nn;
1235 n = lp->last_ptr_value;
1236 nn = GetByte(XIRCREG0_PTR);
1237 lp->last_ptr_value = nn;
1238 if (nn < n) /* rollover */
1239 dev->stats.tx_packets += 256 - n;
1240 else if (n == nn) { /* happens sometimes - don't know why */
1241 pr_debug("PTR not changed?\n");
1242 } else
1243 dev->stats.tx_packets += lp->last_ptr_value - n;
1244 netif_wake_queue(dev);
1246 if (tx_status & 0x0002) { /* Execessive collissions */
1247 pr_debug("tx restarted due to execssive collissions\n");
1248 PutByte(XIRCREG_CR, RestartTx); /* restart transmitter process */
1250 if (tx_status & 0x0040)
1251 dev->stats.tx_aborted_errors++;
1253 /* recalculate our work chunk so that we limit the duration of this
1254 * ISR to about 1/10 of a second.
1255 * Calculate only if we received a reasonable amount of bytes.
1257 if (bytes_rcvd > 1000) {
1258 u_long duration = jiffies - start_ticks;
1260 if (duration >= HZ/10) { /* if more than about 1/10 second */
1261 maxrx_bytes = (bytes_rcvd * (HZ/10)) / duration;
1262 if (maxrx_bytes < 2000)
1263 maxrx_bytes = 2000;
1264 else if (maxrx_bytes > 22000)
1265 maxrx_bytes = 22000;
1266 pr_debug("set maxrx=%u (rcvd=%u ticks=%lu)\n",
1267 maxrx_bytes, bytes_rcvd, duration);
1268 } else if (!duration && maxrx_bytes < 22000) {
1269 /* now much faster */
1270 maxrx_bytes += 2000;
1271 if (maxrx_bytes > 22000)
1272 maxrx_bytes = 22000;
1273 pr_debug("set maxrx=%u\n", maxrx_bytes);
1277 leave:
1278 if (lockup_hack) {
1279 if (int_status != 0xff && (int_status = GetByte(XIRCREG_ISR)) != 0)
1280 goto loop_entry;
1282 SelectPage(saved_page);
1283 PutByte(XIRCREG_CR, EnableIntr); /* re-enable interrupts */
1284 /* Instead of dropping packets during a receive, we could
1285 * force an interrupt with this command:
1286 * PutByte(XIRCREG_CR, EnableIntr|ForceIntr);
1288 return IRQ_HANDLED;
1289 } /* xirc2ps_interrupt */
1291 /*====================================================================*/
1293 static void
1294 xirc2ps_tx_timeout_task(struct work_struct *work)
1296 local_info_t *local =
1297 container_of(work, local_info_t, tx_timeout_task);
1298 struct net_device *dev = local->dev;
1299 /* reset the card */
1300 do_reset(dev,1);
1301 dev->trans_start = jiffies;
1302 netif_wake_queue(dev);
1305 static void
1306 xirc_tx_timeout(struct net_device *dev)
1308 local_info_t *lp = netdev_priv(dev);
1309 dev->stats.tx_errors++;
1310 printk(KERN_NOTICE "%s: transmit timed out\n", dev->name);
1311 schedule_work(&lp->tx_timeout_task);
1314 static netdev_tx_t
1315 do_start_xmit(struct sk_buff *skb, struct net_device *dev)
1317 local_info_t *lp = netdev_priv(dev);
1318 unsigned int ioaddr = dev->base_addr;
1319 int okay;
1320 unsigned freespace;
1321 unsigned pktlen = skb->len;
1323 pr_debug("do_start_xmit(skb=%p, dev=%p) len=%u\n",
1324 skb, dev, pktlen);
1327 /* adjust the packet length to min. required
1328 * and hope that the buffer is large enough
1329 * to provide some random data.
1330 * fixme: For Mohawk we can change this by sending
1331 * a larger packetlen than we actually have; the chip will
1332 * pad this in his buffer with random bytes
1334 if (pktlen < ETH_ZLEN)
1336 if (skb_padto(skb, ETH_ZLEN))
1337 return NETDEV_TX_OK;
1338 pktlen = ETH_ZLEN;
1341 netif_stop_queue(dev);
1342 SelectPage(0);
1343 PutWord(XIRCREG0_TRS, (u_short)pktlen+2);
1344 freespace = GetWord(XIRCREG0_TSO);
1345 okay = freespace & 0x8000;
1346 freespace &= 0x7fff;
1347 /* TRS doesn't work - (indeed it is eliminated with sil-rev 1) */
1348 okay = pktlen +2 < freespace;
1349 pr_debug("%s: avail. tx space=%u%s\n",
1350 dev->name, freespace, okay ? " (okay)":" (not enough)");
1351 if (!okay) { /* not enough space */
1352 return NETDEV_TX_BUSY; /* upper layer may decide to requeue this packet */
1354 /* send the packet */
1355 PutWord(XIRCREG_EDP, (u_short)pktlen);
1356 outsw(ioaddr+XIRCREG_EDP, skb->data, pktlen>>1);
1357 if (pktlen & 1)
1358 PutByte(XIRCREG_EDP, skb->data[pktlen-1]);
1360 if (lp->mohawk)
1361 PutByte(XIRCREG_CR, TransmitPacket|EnableIntr);
1363 dev_kfree_skb (skb);
1364 dev->trans_start = jiffies;
1365 dev->stats.tx_bytes += pktlen;
1366 netif_start_queue(dev);
1367 return NETDEV_TX_OK;
1370 /****************
1371 * Set all addresses: This first one is the individual address,
1372 * the next 9 addresses are taken from the multicast list and
1373 * the rest is filled with the individual address.
1375 static void
1376 set_addresses(struct net_device *dev)
1378 unsigned int ioaddr = dev->base_addr;
1379 local_info_t *lp = netdev_priv(dev);
1380 struct dev_mc_list *dmi = dev->mc_list;
1381 unsigned char *addr;
1382 int i,j,k,n;
1384 SelectPage(k=0x50);
1385 for (i=0,j=8,n=0; ; i++, j++) {
1386 if (i > 5) {
1387 if (++n > 9)
1388 break;
1389 i = 0;
1390 if (n > 1 && n <= dev->mc_count && dmi) {
1391 dmi = dmi->next;
1394 if (j > 15) {
1395 j = 8;
1396 k++;
1397 SelectPage(k);
1400 if (n && n <= dev->mc_count && dmi)
1401 addr = dmi->dmi_addr;
1402 else
1403 addr = dev->dev_addr;
1405 if (lp->mohawk)
1406 PutByte(j, addr[5-i]);
1407 else
1408 PutByte(j, addr[i]);
1410 SelectPage(0);
1413 /****************
1414 * Set or clear the multicast filter for this adaptor.
1415 * We can filter up to 9 addresses, if more are requested we set
1416 * multicast promiscuous mode.
1419 static void
1420 set_multicast_list(struct net_device *dev)
1422 unsigned int ioaddr = dev->base_addr;
1423 unsigned value;
1425 SelectPage(0x42);
1426 value = GetByte(XIRCREG42_SWC1) & 0xC0;
1428 if (dev->flags & IFF_PROMISC) { /* snoop */
1429 PutByte(XIRCREG42_SWC1, value | 0x06); /* set MPE and PME */
1430 } else if (dev->mc_count > 9 || (dev->flags & IFF_ALLMULTI)) {
1431 PutByte(XIRCREG42_SWC1, value | 0x02); /* set MPE */
1432 } else if (dev->mc_count) {
1433 /* the chip can filter 9 addresses perfectly */
1434 PutByte(XIRCREG42_SWC1, value | 0x01);
1435 SelectPage(0x40);
1436 PutByte(XIRCREG40_CMD0, Offline);
1437 set_addresses(dev);
1438 SelectPage(0x40);
1439 PutByte(XIRCREG40_CMD0, EnableRecv | Online);
1440 } else { /* standard usage */
1441 PutByte(XIRCREG42_SWC1, value | 0x00);
1443 SelectPage(0);
1446 static int
1447 do_config(struct net_device *dev, struct ifmap *map)
1449 local_info_t *local = netdev_priv(dev);
1451 pr_debug("do_config(%p)\n", dev);
1452 if (map->port != 255 && map->port != dev->if_port) {
1453 if (map->port > 4)
1454 return -EINVAL;
1455 if (!map->port) {
1456 local->probe_port = 1;
1457 dev->if_port = 1;
1458 } else {
1459 local->probe_port = 0;
1460 dev->if_port = map->port;
1462 printk(KERN_INFO "%s: switching to %s port\n",
1463 dev->name, if_names[dev->if_port]);
1464 do_reset(dev,1); /* not the fine way :-) */
1466 return 0;
1469 /****************
1470 * Open the driver
1472 static int
1473 do_open(struct net_device *dev)
1475 local_info_t *lp = netdev_priv(dev);
1476 struct pcmcia_device *link = lp->p_dev;
1478 dev_dbg(&link->dev, "do_open(%p)\n", dev);
1480 /* Check that the PCMCIA card is still here. */
1481 /* Physical device present signature. */
1482 if (!pcmcia_dev_present(link))
1483 return -ENODEV;
1485 /* okay */
1486 link->open++;
1488 netif_start_queue(dev);
1489 do_reset(dev,1);
1491 return 0;
1494 static void netdev_get_drvinfo(struct net_device *dev,
1495 struct ethtool_drvinfo *info)
1497 strcpy(info->driver, "xirc2ps_cs");
1498 sprintf(info->bus_info, "PCMCIA 0x%lx", dev->base_addr);
1501 static const struct ethtool_ops netdev_ethtool_ops = {
1502 .get_drvinfo = netdev_get_drvinfo,
1505 static int
1506 do_ioctl(struct net_device *dev, struct ifreq *rq, int cmd)
1508 local_info_t *local = netdev_priv(dev);
1509 unsigned int ioaddr = dev->base_addr;
1510 struct mii_ioctl_data *data = if_mii(rq);
1512 pr_debug("%s: ioctl(%-.6s, %#04x) %04x %04x %04x %04x\n",
1513 dev->name, rq->ifr_ifrn.ifrn_name, cmd,
1514 data->phy_id, data->reg_num, data->val_in, data->val_out);
1516 if (!local->mohawk)
1517 return -EOPNOTSUPP;
1519 switch(cmd) {
1520 case SIOCGMIIPHY: /* Get the address of the PHY in use. */
1521 data->phy_id = 0; /* we have only this address */
1522 /* fall through */
1523 case SIOCGMIIREG: /* Read the specified MII register. */
1524 data->val_out = mii_rd(ioaddr, data->phy_id & 0x1f,
1525 data->reg_num & 0x1f);
1526 break;
1527 case SIOCSMIIREG: /* Write the specified MII register */
1528 mii_wr(ioaddr, data->phy_id & 0x1f, data->reg_num & 0x1f, data->val_in,
1529 16);
1530 break;
1531 default:
1532 return -EOPNOTSUPP;
1534 return 0;
1537 static void
1538 hardreset(struct net_device *dev)
1540 local_info_t *local = netdev_priv(dev);
1541 unsigned int ioaddr = dev->base_addr;
1543 SelectPage(4);
1544 udelay(1);
1545 PutByte(XIRCREG4_GPR1, 0); /* clear bit 0: power down */
1546 msleep(40); /* wait 40 msec */
1547 if (local->mohawk)
1548 PutByte(XIRCREG4_GPR1, 1); /* set bit 0: power up */
1549 else
1550 PutByte(XIRCREG4_GPR1, 1 | 4); /* set bit 0: power up, bit 2: AIC */
1551 msleep(20); /* wait 20 msec */
1554 static void
1555 do_reset(struct net_device *dev, int full)
1557 local_info_t *local = netdev_priv(dev);
1558 unsigned int ioaddr = dev->base_addr;
1559 unsigned value;
1561 pr_debug("%s: do_reset(%p,%d)\n", dev? dev->name:"eth?", dev, full);
1563 hardreset(dev);
1564 PutByte(XIRCREG_CR, SoftReset); /* set */
1565 msleep(20); /* wait 20 msec */
1566 PutByte(XIRCREG_CR, 0); /* clear */
1567 msleep(40); /* wait 40 msec */
1568 if (local->mohawk) {
1569 SelectPage(4);
1570 /* set pin GP1 and GP2 to output (0x0c)
1571 * set GP1 to low to power up the ML6692 (0x00)
1572 * set GP2 to high to power up the 10Mhz chip (0x02)
1574 PutByte(XIRCREG4_GPR0, 0x0e);
1577 /* give the circuits some time to power up */
1578 msleep(500); /* about 500ms */
1580 local->last_ptr_value = 0;
1581 local->silicon = local->mohawk ? (GetByte(XIRCREG4_BOV) & 0x70) >> 4
1582 : (GetByte(XIRCREG4_BOV) & 0x30) >> 4;
1584 if (local->probe_port) {
1585 if (!local->mohawk) {
1586 SelectPage(4);
1587 PutByte(XIRCREG4_GPR0, 4);
1588 local->probe_port = 0;
1590 } else if (dev->if_port == 2) { /* enable 10Base2 */
1591 SelectPage(0x42);
1592 PutByte(XIRCREG42_SWC1, 0xC0);
1593 } else { /* enable 10BaseT */
1594 SelectPage(0x42);
1595 PutByte(XIRCREG42_SWC1, 0x80);
1597 msleep(40); /* wait 40 msec to let it complete */
1599 #if 0
1601 SelectPage(0);
1602 value = GetByte(XIRCREG_ESR); /* read the ESR */
1603 printk(KERN_DEBUG "%s: ESR is: %#02x\n", dev->name, value);
1605 #endif
1607 /* setup the ECR */
1608 SelectPage(1);
1609 PutByte(XIRCREG1_IMR0, 0xff); /* allow all ints */
1610 PutByte(XIRCREG1_IMR1, 1 ); /* and Set TxUnderrunDetect */
1611 value = GetByte(XIRCREG1_ECR);
1612 #if 0
1613 if (local->mohawk)
1614 value |= DisableLinkPulse;
1615 PutByte(XIRCREG1_ECR, value);
1616 #endif
1617 pr_debug("%s: ECR is: %#02x\n", dev->name, value);
1619 SelectPage(0x42);
1620 PutByte(XIRCREG42_SWC0, 0x20); /* disable source insertion */
1622 if (local->silicon != 1) {
1623 /* set the local memory dividing line.
1624 * The comments in the sample code say that this is only
1625 * settable with the scipper version 2 which is revision 0.
1626 * Always for CE3 cards
1628 SelectPage(2);
1629 PutWord(XIRCREG2_RBS, 0x2000);
1632 if (full)
1633 set_addresses(dev);
1635 /* Hardware workaround:
1636 * The receive byte pointer after reset is off by 1 so we need
1637 * to move the offset pointer back to 0.
1639 SelectPage(0);
1640 PutWord(XIRCREG0_DO, 0x2000); /* change offset command, off=0 */
1642 /* setup MAC IMRs and clear status registers */
1643 SelectPage(0x40); /* Bit 7 ... bit 0 */
1644 PutByte(XIRCREG40_RMASK0, 0xff); /* ROK, RAB, rsv, RO, CRC, AE, PTL, MP */
1645 PutByte(XIRCREG40_TMASK0, 0xff); /* TOK, TAB, SQE, LL, TU, JAB, EXC, CRS */
1646 PutByte(XIRCREG40_TMASK1, 0xb0); /* rsv, rsv, PTD, EXT, rsv,rsv,rsv, rsv*/
1647 PutByte(XIRCREG40_RXST0, 0x00); /* ROK, RAB, REN, RO, CRC, AE, PTL, MP */
1648 PutByte(XIRCREG40_TXST0, 0x00); /* TOK, TAB, SQE, LL, TU, JAB, EXC, CRS */
1649 PutByte(XIRCREG40_TXST1, 0x00); /* TEN, rsv, PTD, EXT, retry_counter:4 */
1651 if (full && local->mohawk && init_mii(dev)) {
1652 if (dev->if_port == 4 || local->dingo || local->new_mii) {
1653 printk(KERN_INFO "%s: MII selected\n", dev->name);
1654 SelectPage(2);
1655 PutByte(XIRCREG2_MSR, GetByte(XIRCREG2_MSR) | 0x08);
1656 msleep(20);
1657 } else {
1658 printk(KERN_INFO "%s: MII detected; using 10mbs\n",
1659 dev->name);
1660 SelectPage(0x42);
1661 if (dev->if_port == 2) /* enable 10Base2 */
1662 PutByte(XIRCREG42_SWC1, 0xC0);
1663 else /* enable 10BaseT */
1664 PutByte(XIRCREG42_SWC1, 0x80);
1665 msleep(40); /* wait 40 msec to let it complete */
1667 if (full_duplex)
1668 PutByte(XIRCREG1_ECR, GetByte(XIRCREG1_ECR | FullDuplex));
1669 } else { /* No MII */
1670 SelectPage(0);
1671 value = GetByte(XIRCREG_ESR); /* read the ESR */
1672 dev->if_port = (value & MediaSelect) ? 1 : 2;
1675 /* configure the LEDs */
1676 SelectPage(2);
1677 if (dev->if_port == 1 || dev->if_port == 4) /* TP: Link and Activity */
1678 PutByte(XIRCREG2_LED, 0x3b);
1679 else /* Coax: Not-Collision and Activity */
1680 PutByte(XIRCREG2_LED, 0x3a);
1682 if (local->dingo)
1683 PutByte(0x0b, 0x04); /* 100 Mbit LED */
1685 /* enable receiver and put the mac online */
1686 if (full) {
1687 set_multicast_list(dev);
1688 SelectPage(0x40);
1689 PutByte(XIRCREG40_CMD0, EnableRecv | Online);
1692 /* setup Ethernet IMR and enable interrupts */
1693 SelectPage(1);
1694 PutByte(XIRCREG1_IMR0, 0xff);
1695 udelay(1);
1696 SelectPage(0);
1697 PutByte(XIRCREG_CR, EnableIntr);
1698 if (local->modem && !local->dingo) { /* do some magic */
1699 if (!(GetByte(0x10) & 0x01))
1700 PutByte(0x10, 0x11); /* unmask master-int bit */
1703 if (full)
1704 printk(KERN_INFO "%s: media %s, silicon revision %d\n",
1705 dev->name, if_names[dev->if_port], local->silicon);
1706 /* We should switch back to page 0 to avoid a bug in revision 0
1707 * where regs with offset below 8 can't be read after an access
1708 * to the MAC registers */
1709 SelectPage(0);
1712 /****************
1713 * Initialize the Media-Independent-Interface
1714 * Returns: True if we have a good MII
1716 static int
1717 init_mii(struct net_device *dev)
1719 local_info_t *local = netdev_priv(dev);
1720 unsigned int ioaddr = dev->base_addr;
1721 unsigned control, status, linkpartner;
1722 int i;
1724 if (if_port == 4 || if_port == 1) { /* force 100BaseT or 10BaseT */
1725 dev->if_port = if_port;
1726 local->probe_port = 0;
1727 return 1;
1730 status = mii_rd(ioaddr, 0, 1);
1731 if ((status & 0xff00) != 0x7800)
1732 return 0; /* No MII */
1734 local->new_mii = (mii_rd(ioaddr, 0, 2) != 0xffff);
1736 if (local->probe_port)
1737 control = 0x1000; /* auto neg */
1738 else if (dev->if_port == 4)
1739 control = 0x2000; /* no auto neg, 100mbs mode */
1740 else
1741 control = 0x0000; /* no auto neg, 10mbs mode */
1742 mii_wr(ioaddr, 0, 0, control, 16);
1743 udelay(100);
1744 control = mii_rd(ioaddr, 0, 0);
1746 if (control & 0x0400) {
1747 printk(KERN_NOTICE "%s can't take PHY out of isolation mode\n",
1748 dev->name);
1749 local->probe_port = 0;
1750 return 0;
1753 if (local->probe_port) {
1754 /* according to the DP83840A specs the auto negotiation process
1755 * may take up to 3.5 sec, so we use this also for our ML6692
1756 * Fixme: Better to use a timer here!
1758 for (i=0; i < 35; i++) {
1759 msleep(100); /* wait 100 msec */
1760 status = mii_rd(ioaddr, 0, 1);
1761 if ((status & 0x0020) && (status & 0x0004))
1762 break;
1765 if (!(status & 0x0020)) {
1766 printk(KERN_INFO "%s: autonegotiation failed;"
1767 " using 10mbs\n", dev->name);
1768 if (!local->new_mii) {
1769 control = 0x0000;
1770 mii_wr(ioaddr, 0, 0, control, 16);
1771 udelay(100);
1772 SelectPage(0);
1773 dev->if_port = (GetByte(XIRCREG_ESR) & MediaSelect) ? 1 : 2;
1775 } else {
1776 linkpartner = mii_rd(ioaddr, 0, 5);
1777 printk(KERN_INFO "%s: MII link partner: %04x\n",
1778 dev->name, linkpartner);
1779 if (linkpartner & 0x0080) {
1780 dev->if_port = 4;
1781 } else
1782 dev->if_port = 1;
1786 return 1;
1789 static void
1790 do_powerdown(struct net_device *dev)
1793 unsigned int ioaddr = dev->base_addr;
1795 pr_debug("do_powerdown(%p)\n", dev);
1797 SelectPage(4);
1798 PutByte(XIRCREG4_GPR1, 0); /* clear bit 0: power down */
1799 SelectPage(0);
1802 static int
1803 do_stop(struct net_device *dev)
1805 unsigned int ioaddr = dev->base_addr;
1806 local_info_t *lp = netdev_priv(dev);
1807 struct pcmcia_device *link = lp->p_dev;
1809 dev_dbg(&link->dev, "do_stop(%p)\n", dev);
1811 if (!link)
1812 return -ENODEV;
1814 netif_stop_queue(dev);
1816 SelectPage(0);
1817 PutByte(XIRCREG_CR, 0); /* disable interrupts */
1818 SelectPage(0x01);
1819 PutByte(XIRCREG1_IMR0, 0x00); /* forbid all ints */
1820 SelectPage(4);
1821 PutByte(XIRCREG4_GPR1, 0); /* clear bit 0: power down */
1822 SelectPage(0);
1824 link->open--;
1825 return 0;
1828 static struct pcmcia_device_id xirc2ps_ids[] = {
1829 PCMCIA_PFC_DEVICE_MANF_CARD(0, 0x0089, 0x110a),
1830 PCMCIA_PFC_DEVICE_MANF_CARD(0, 0x0138, 0x110a),
1831 PCMCIA_PFC_DEVICE_PROD_ID13(0, "Xircom", "CEM28", 0x2e3ee845, 0x0ea978ea),
1832 PCMCIA_PFC_DEVICE_PROD_ID13(0, "Xircom", "CEM33", 0x2e3ee845, 0x80609023),
1833 PCMCIA_PFC_DEVICE_PROD_ID13(0, "Xircom", "CEM56", 0x2e3ee845, 0xa650c32a),
1834 PCMCIA_PFC_DEVICE_PROD_ID13(0, "Xircom", "REM10", 0x2e3ee845, 0x76df1d29),
1835 PCMCIA_PFC_DEVICE_PROD_ID13(0, "Xircom", "XEM5600", 0x2e3ee845, 0xf1403719),
1836 PCMCIA_PFC_DEVICE_PROD_ID12(0, "Xircom", "CreditCard Ethernet+Modem II", 0x2e3ee845, 0xeca401bf),
1837 PCMCIA_DEVICE_MANF_CARD(0x01bf, 0x010a),
1838 PCMCIA_DEVICE_PROD_ID13("Toshiba Information Systems", "TPCENET", 0x1b3b94fe, 0xf381c1a2),
1839 PCMCIA_DEVICE_PROD_ID13("Xircom", "CE3-10/100", 0x2e3ee845, 0x0ec0ac37),
1840 PCMCIA_DEVICE_PROD_ID13("Xircom", "PS-CE2-10", 0x2e3ee845, 0x947d9073),
1841 PCMCIA_DEVICE_PROD_ID13("Xircom", "R2E-100BTX", 0x2e3ee845, 0x2464a6e3),
1842 PCMCIA_DEVICE_PROD_ID13("Xircom", "RE-10", 0x2e3ee845, 0x3e08d609),
1843 PCMCIA_DEVICE_PROD_ID13("Xircom", "XE2000", 0x2e3ee845, 0xf7188e46),
1844 PCMCIA_DEVICE_PROD_ID12("Compaq", "Ethernet LAN Card", 0x54f7c49c, 0x9fd2f0a2),
1845 PCMCIA_DEVICE_PROD_ID12("Compaq", "Netelligent 10/100 PC Card", 0x54f7c49c, 0xefe96769),
1846 PCMCIA_DEVICE_PROD_ID12("Intel", "EtherExpress(TM) PRO/100 PC Card Mobile Adapter16", 0x816cc815, 0x174397db),
1847 PCMCIA_DEVICE_PROD_ID12("Toshiba", "10/100 Ethernet PC Card", 0x44a09d9c, 0xb44deecf),
1848 /* also matches CFE-10 cards! */
1849 /* PCMCIA_DEVICE_MANF_CARD(0x0105, 0x010a), */
1850 PCMCIA_DEVICE_NULL,
1852 MODULE_DEVICE_TABLE(pcmcia, xirc2ps_ids);
1855 static struct pcmcia_driver xirc2ps_cs_driver = {
1856 .owner = THIS_MODULE,
1857 .drv = {
1858 .name = "xirc2ps_cs",
1860 .probe = xirc2ps_probe,
1861 .remove = xirc2ps_detach,
1862 .id_table = xirc2ps_ids,
1863 .suspend = xirc2ps_suspend,
1864 .resume = xirc2ps_resume,
1867 static int __init
1868 init_xirc2ps_cs(void)
1870 return pcmcia_register_driver(&xirc2ps_cs_driver);
1873 static void __exit
1874 exit_xirc2ps_cs(void)
1876 pcmcia_unregister_driver(&xirc2ps_cs_driver);
1879 module_init(init_xirc2ps_cs);
1880 module_exit(exit_xirc2ps_cs);
1882 #ifndef MODULE
1883 static int __init setup_xirc2ps_cs(char *str)
1885 /* if_port, full_duplex, do_sound, lockup_hack
1887 int ints[10] = { -1 };
1889 str = get_options(str, 9, ints);
1891 #define MAYBE_SET(X,Y) if (ints[0] >= Y && ints[Y] != -1) { X = ints[Y]; }
1892 MAYBE_SET(if_port, 3);
1893 MAYBE_SET(full_duplex, 4);
1894 MAYBE_SET(do_sound, 5);
1895 MAYBE_SET(lockup_hack, 6);
1896 #undef MAYBE_SET
1898 return 1;
1901 __setup("xirc2ps_cs=", setup_xirc2ps_cs);
1902 #endif