2 * Linux ARCnet driver - "RIM I" (entirely mem-mapped) cards
4 * Written 1994-1999 by Avery Pennarun.
5 * Written 1999-2000 by Martin Mares <mj@ucw.cz>.
6 * Derived from skeleton.c by Donald Becker.
8 * Special thanks to Contemporary Controls, Inc. (www.ccontrols.com)
9 * for sponsoring the further development of this driver.
11 * **********************
13 * The original copyright of skeleton.c was as follows:
15 * skeleton.c Written 1993 by Donald Becker.
16 * Copyright 1993 United States Government as represented by the
17 * Director, National Security Agency. This software may only be used
18 * and distributed according to the terms of the GNU General Public License as
19 * modified by SRC, incorporated herein by reference.
21 * **********************
23 * For more details, see drivers/net/arcnet.c
25 * **********************
28 #define pr_fmt(fmt) "arcnet:" KBUILD_MODNAME ": " fmt
30 #include <linux/kernel.h>
31 #include <linux/module.h>
32 #include <linux/moduleparam.h>
33 #include <linux/ioport.h>
34 #include <linux/delay.h>
35 #include <linux/netdevice.h>
36 #include <linux/bootmem.h>
37 #include <linux/init.h>
38 #include <linux/interrupt.h>
41 #include "arcdevice.h"
43 /* Internal function declarations */
45 static int arcrimi_probe(struct net_device *dev);
46 static int arcrimi_found(struct net_device *dev);
47 static void arcrimi_command(struct net_device *dev, int command);
48 static int arcrimi_status(struct net_device *dev);
49 static void arcrimi_setmask(struct net_device *dev, int mask);
50 static int arcrimi_reset(struct net_device *dev, int really_reset);
51 static void arcrimi_copy_to_card(struct net_device *dev, int bufnum, int offset,
52 void *buf, int count);
53 static void arcrimi_copy_from_card(struct net_device *dev, int bufnum,
54 int offset, void *buf, int count);
56 /* Handy defines for ARCnet specific stuff */
58 /* Amount of I/O memory used by the card */
59 #define BUFFER_SIZE (512)
60 #define MIRROR_SIZE (BUFFER_SIZE * 4)
62 /* COM 9026 controller chip --> ARCnet register addresses */
63 #define COM9026_REG_W_INTMASK 0 /* writable */
64 #define COM9026_REG_R_STATUS 0 /* readable */
65 #define COM9026_REG_W_COMMAND 1 /* writable, returns random vals on read (?) */
66 #define COM9026_REG_RW_CONFIG 2 /* Configuration register */
67 #define COM9026_REG_R_RESET 8 /* software reset (on read) */
68 #define COM9026_REG_RW_MEMDATA 12 /* Data port for IO-mapped memory */
69 #define COM9026_REG_W_ADDR_LO 14 /* Control registers for said */
70 #define COM9026_REG_W_ADDR_HI 15
72 #define COM9026_REG_R_STATION 1 /* Station ID */
74 /* We cannot probe for a RIM I card; one reason is I don't know how to reset
75 * them. In fact, we can't even get their node ID automatically. So, we
76 * need to be passed a specific shmem address, IRQ, and node ID.
78 static int __init arcrimi_probe(struct net_device *dev)
80 if (BUGLVL(D_NORMAL)) {
81 pr_info("%s\n", "RIM I (entirely mem-mapped) support");
82 pr_info("E-mail me if you actually test the RIM I driver, please!\n");
83 pr_info("Given: node %02Xh, shmem %lXh, irq %d\n",
84 dev->dev_addr[0], dev->mem_start, dev->irq);
87 if (dev->mem_start <= 0 || dev->irq <= 0) {
89 pr_err("No autoprobe for RIM I; you must specify the shmem and irq!\n");
92 if (dev->dev_addr[0] == 0) {
94 pr_err("You need to specify your card's station ID!\n");
97 /* Grab the memory region at mem_start for MIRROR_SIZE bytes.
98 * Later in arcrimi_found() the real size will be determined
99 * and this reserve will be released and the correct size
102 if (!request_mem_region(dev->mem_start, MIRROR_SIZE, "arcnet (90xx)")) {
103 if (BUGLVL(D_NORMAL))
104 pr_notice("Card memory already allocated\n");
107 return arcrimi_found(dev);
110 static int check_mirror(unsigned long addr, size_t size)
115 if (!request_mem_region(addr, size, "arcnet (90xx)"))
118 p = ioremap(addr, size);
120 if (arcnet_readb(p, COM9026_REG_R_STATUS) == TESTvalue)
127 release_mem_region(addr, size);
131 /* Set up the struct net_device associated with this card.
132 * Called after probing succeeds.
134 static int __init arcrimi_found(struct net_device *dev)
136 struct arcnet_local *lp;
137 unsigned long first_mirror, last_mirror, shmem;
142 p = ioremap(dev->mem_start, MIRROR_SIZE);
144 release_mem_region(dev->mem_start, MIRROR_SIZE);
145 arc_printk(D_NORMAL, dev, "Can't ioremap\n");
149 /* reserve the irq */
150 if (request_irq(dev->irq, arcnet_interrupt, 0, "arcnet (RIM I)", dev)) {
152 release_mem_region(dev->mem_start, MIRROR_SIZE);
153 arc_printk(D_NORMAL, dev, "Can't get IRQ %d!\n", dev->irq);
157 shmem = dev->mem_start;
158 arcnet_writeb(TESTvalue, p, COM9026_REG_W_INTMASK);
159 arcnet_writeb(TESTvalue, p, COM9026_REG_W_COMMAND);
160 /* actually the station/node ID */
162 /* find the real shared memory start/end points, including mirrors */
164 /* guess the actual size of one "memory mirror" - the number of
165 * bytes between copies of the shared memory. On most cards, it's
166 * 2k (or there are no mirrors at all) but on some, it's 4k.
168 mirror_size = MIRROR_SIZE;
169 if (arcnet_readb(p, COM9026_REG_R_STATUS) == TESTvalue &&
170 check_mirror(shmem - MIRROR_SIZE, MIRROR_SIZE) == 0 &&
171 check_mirror(shmem - 2 * MIRROR_SIZE, MIRROR_SIZE) == 1)
172 mirror_size = 2 * MIRROR_SIZE;
174 first_mirror = shmem - mirror_size;
175 while (check_mirror(first_mirror, mirror_size) == 1)
176 first_mirror -= mirror_size;
177 first_mirror += mirror_size;
179 last_mirror = shmem + mirror_size;
180 while (check_mirror(last_mirror, mirror_size) == 1)
181 last_mirror += mirror_size;
182 last_mirror -= mirror_size;
184 dev->mem_start = first_mirror;
185 dev->mem_end = last_mirror + MIRROR_SIZE - 1;
187 /* initialize the rest of the device structure. */
189 lp = netdev_priv(dev);
190 lp->card_name = "RIM I";
191 lp->hw.command = arcrimi_command;
192 lp->hw.status = arcrimi_status;
193 lp->hw.intmask = arcrimi_setmask;
194 lp->hw.reset = arcrimi_reset;
195 lp->hw.owner = THIS_MODULE;
196 lp->hw.copy_to_card = arcrimi_copy_to_card;
197 lp->hw.copy_from_card = arcrimi_copy_from_card;
199 /* re-reserve the memory region - arcrimi_probe() alloced this reqion
200 * but didn't know the real size. Free that region and then re-get
201 * with the correct size. There is a VERY slim chance this could
205 release_mem_region(shmem, MIRROR_SIZE);
206 if (!request_mem_region(dev->mem_start,
207 dev->mem_end - dev->mem_start + 1,
209 arc_printk(D_NORMAL, dev, "Card memory already allocated\n");
213 lp->mem_start = ioremap(dev->mem_start,
214 dev->mem_end - dev->mem_start + 1);
215 if (!lp->mem_start) {
216 arc_printk(D_NORMAL, dev, "Can't remap device memory!\n");
217 goto err_release_mem;
220 /* get and check the station ID from offset 1 in shmem */
221 dev->dev_addr[0] = arcnet_readb(lp->mem_start, COM9026_REG_R_STATION);
223 arc_printk(D_NORMAL, dev, "ARCnet RIM I: station %02Xh found at IRQ %d, ShMem %lXh (%ld*%d bytes)\n",
225 dev->irq, dev->mem_start,
226 (dev->mem_end - dev->mem_start + 1) / mirror_size,
229 err = register_netdev(dev);
236 iounmap(lp->mem_start);
238 release_mem_region(dev->mem_start, dev->mem_end - dev->mem_start + 1);
240 free_irq(dev->irq, dev);
244 /* Do a hardware reset on the card, and set up necessary registers.
246 * This should be called as little as possible, because it disrupts the
247 * token on the network (causes a RECON) and requires a significant delay.
249 * However, it does make sure the card is in a defined state.
251 static int arcrimi_reset(struct net_device *dev, int really_reset)
253 struct arcnet_local *lp = netdev_priv(dev);
254 void __iomem *ioaddr = lp->mem_start + 0x800;
256 arc_printk(D_INIT, dev, "Resetting %s (status=%02Xh)\n",
257 dev->name, arcnet_readb(ioaddr, COM9026_REG_R_STATUS));
260 arcnet_writeb(TESTvalue, ioaddr, -0x800); /* fake reset */
263 /* clear flags & end reset */
264 arcnet_writeb(CFLAGScmd | RESETclear, ioaddr, COM9026_REG_W_COMMAND);
265 arcnet_writeb(CFLAGScmd | CONFIGclear, ioaddr, COM9026_REG_W_COMMAND);
267 /* enable extended (512-byte) packets */
268 arcnet_writeb(CONFIGcmd | EXTconf, ioaddr, COM9026_REG_W_COMMAND);
270 /* done! return success. */
274 static void arcrimi_setmask(struct net_device *dev, int mask)
276 struct arcnet_local *lp = netdev_priv(dev);
277 void __iomem *ioaddr = lp->mem_start + 0x800;
279 arcnet_writeb(mask, ioaddr, COM9026_REG_W_INTMASK);
282 static int arcrimi_status(struct net_device *dev)
284 struct arcnet_local *lp = netdev_priv(dev);
285 void __iomem *ioaddr = lp->mem_start + 0x800;
287 return arcnet_readb(ioaddr, COM9026_REG_R_STATUS);
290 static void arcrimi_command(struct net_device *dev, int cmd)
292 struct arcnet_local *lp = netdev_priv(dev);
293 void __iomem *ioaddr = lp->mem_start + 0x800;
295 arcnet_writeb(cmd, ioaddr, COM9026_REG_W_COMMAND);
298 static void arcrimi_copy_to_card(struct net_device *dev, int bufnum, int offset,
299 void *buf, int count)
301 struct arcnet_local *lp = netdev_priv(dev);
302 void __iomem *memaddr = lp->mem_start + 0x800 + bufnum * 512 + offset;
304 TIME(dev, "memcpy_toio", count, memcpy_toio(memaddr, buf, count));
307 static void arcrimi_copy_from_card(struct net_device *dev, int bufnum,
308 int offset, void *buf, int count)
310 struct arcnet_local *lp = netdev_priv(dev);
311 void __iomem *memaddr = lp->mem_start + 0x800 + bufnum * 512 + offset;
313 TIME(dev, "memcpy_fromio", count, memcpy_fromio(buf, memaddr, count));
317 static int io; /* use the insmod io= irq= node= options */
319 static char device[9]; /* use eg. device=arc1 to change name */
321 module_param(node, int, 0);
322 module_param(io, int, 0);
323 module_param(irq, int, 0);
324 module_param_string(device, device, sizeof(device), 0);
325 MODULE_LICENSE("GPL");
327 static struct net_device *my_dev;
329 static int __init arc_rimi_init(void)
331 struct net_device *dev;
333 dev = alloc_arcdev(device);
337 if (node && node != 0xff)
338 dev->dev_addr[0] = node;
345 if (arcrimi_probe(dev)) {
354 static void __exit arc_rimi_exit(void)
356 struct net_device *dev = my_dev;
357 struct arcnet_local *lp = netdev_priv(dev);
359 unregister_netdev(dev);
360 iounmap(lp->mem_start);
361 release_mem_region(dev->mem_start, dev->mem_end - dev->mem_start + 1);
362 free_irq(dev->irq, dev);
367 static int __init arcrimi_setup(char *s)
371 s = get_options(s, 8, ints);
376 pr_err("Too many arguments\n");
377 case 3: /* Node ID */
381 case 1: /* IO address */
385 snprintf(device, sizeof(device), "%s", s);
388 __setup("arcrimi=", arcrimi_setup);
391 module_init(arc_rimi_init)
392 module_exit(arc_rimi_exit)