mtd803.c revision 1.24 1 1.24 joerg /* $NetBSD: mtd803.c,v 1.24 2010/04/05 07:19:35 joerg Exp $ */
2 1.1 martin
3 1.1 martin /*-
4 1.1 martin *
5 1.1 martin * Copyright (c) 2002 The NetBSD Foundation, Inc.
6 1.1 martin * All rights reserved.
7 1.1 martin *
8 1.1 martin * This code is derived from software contributed to The NetBSD Foundation
9 1.1 martin * by Peter Bex <Peter.Bex (at) student.kun.nl>.
10 1.1 martin *
11 1.1 martin * Redistribution and use in source and binary forms, with or without
12 1.1 martin * modification, are permitted provided that the following conditions
13 1.1 martin * are met:
14 1.1 martin * 1. Redistributions of source code must retain the above copyright
15 1.1 martin * notice, this list of conditions and the following disclaimer.
16 1.1 martin * 2. Redistributions in binary form must reproduce the above copyright
17 1.1 martin * notice, this list of conditions and the following disclaimer in the
18 1.1 martin * documentation and/or other materials provided with the distribution.
19 1.1 martin *
20 1.1 martin * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 1.1 martin * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 1.1 martin * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 1.1 martin * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 1.1 martin * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 1.1 martin * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 1.1 martin * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 1.1 martin * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 1.1 martin * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 1.1 martin * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 1.1 martin * POSSIBILITY OF SUCH DAMAGE.
31 1.1 martin */
32 1.1 martin
33 1.1 martin /*
34 1.1 martin * TODO:
35 1.1 martin * - Most importantly, get some bus_dmamap_syncs in the correct places.
36 1.1 martin * I don't have access to a computer with PCI other than i386, and i386
37 1.1 martin * is just such a machine where dmamap_syncs don't do anything.
38 1.1 martin * - Powerhook for when resuming after standby.
39 1.16 ad * - Watchdog stuff doesn't work yet, the system crashes.
40 1.1 martin * - There seems to be a CardBus version of the card. (see datasheet)
41 1.1 martin * Perhaps a detach function is necessary then? (free buffs, stop rx/tx etc)
42 1.1 martin * - When you enable the TXBUN (Tx buffer unavailable) interrupt, it gets
43 1.1 martin * raised every time a packet is sent. Strange, since everything works anyway
44 1.1 martin */
45 1.3 lukem
46 1.3 lukem #include <sys/cdefs.h>
47 1.24 joerg __KERNEL_RCSID(0, "$NetBSD: mtd803.c,v 1.24 2010/04/05 07:19:35 joerg Exp $");
48 1.1 martin
49 1.1 martin
50 1.1 martin #include <sys/param.h>
51 1.1 martin #include <sys/mbuf.h>
52 1.1 martin #include <sys/systm.h>
53 1.1 martin #include <sys/device.h>
54 1.1 martin #include <sys/socket.h>
55 1.1 martin #include <sys/ioctl.h>
56 1.1 martin #include <sys/syslog.h>
57 1.1 martin
58 1.1 martin #include <net/if.h>
59 1.1 martin #include <net/if_ether.h>
60 1.1 martin #include <net/if_media.h>
61 1.1 martin
62 1.1 martin #ifdef INET
63 1.1 martin #include <netinet/in.h>
64 1.1 martin #include <netinet/if_inarp.h>
65 1.1 martin #include <netinet/in_systm.h>
66 1.1 martin #include <netinet/in_var.h>
67 1.1 martin #include <netinet/ip.h>
68 1.1 martin #endif
69 1.1 martin
70 1.1 martin #include <net/bpf.h>
71 1.1 martin #include <net/bpfdesc.h>
72 1.1 martin
73 1.15 ad #include <sys/bus.h>
74 1.1 martin
75 1.1 martin #include <dev/ic/mtd803reg.h>
76 1.1 martin #include <dev/ic/mtd803var.h>
77 1.1 martin #include <dev/mii/mii.h>
78 1.1 martin #include <dev/mii/miivar.h>
79 1.1 martin
80 1.1 martin /*
81 1.1 martin * Device driver for the MTD803 3-in-1 Fast Ethernet Controller
82 1.1 martin * Written by Peter Bex (peter.bex (at) student.kun.nl)
83 1.1 martin *
84 1.1 martin * Datasheet at: http://www.myson.com.tw or http://www.century-semi.com
85 1.1 martin */
86 1.1 martin
87 1.1 martin #define MTD_READ_1(sc, reg) \
88 1.1 martin bus_space_read_1((sc)->bus_tag, (sc)->bus_handle, (reg))
89 1.1 martin #define MTD_WRITE_1(sc, reg, data) \
90 1.1 martin bus_space_write_1((sc)->bus_tag, (sc)->bus_handle, (reg), (data))
91 1.1 martin
92 1.1 martin #define MTD_READ_2(sc, reg) \
93 1.1 martin bus_space_read_2((sc)->bus_tag, (sc)->bus_handle, (reg))
94 1.1 martin #define MTD_WRITE_2(sc, reg, data) \
95 1.1 martin bus_space_write_2((sc)->bus_tag, (sc)->bus_handle, (reg), (data))
96 1.1 martin
97 1.1 martin #define MTD_READ_4(sc, reg) \
98 1.1 martin bus_space_read_4((sc)->bus_tag, (sc)->bus_handle, (reg))
99 1.1 martin #define MTD_WRITE_4(sc, reg, data) \
100 1.1 martin bus_space_write_4((sc)->bus_tag, (sc)->bus_handle, (reg), (data))
101 1.1 martin
102 1.1 martin #define MTD_SETBIT(sc, reg, x) \
103 1.1 martin MTD_WRITE_4((sc), (reg), MTD_READ_4((sc), (reg)) | (x))
104 1.1 martin #define MTD_CLRBIT(sc, reg, x) \
105 1.1 martin MTD_WRITE_4((sc), (reg), MTD_READ_4((sc), (reg)) & ~(x))
106 1.1 martin
107 1.1 martin #define ETHER_CRC32(buf, len) (ether_crc32_be((buf), (len)))
108 1.1 martin
109 1.22 cegger int mtd_mii_readreg(device_t, int, int);
110 1.22 cegger void mtd_mii_writereg(device_t, int, int, int);
111 1.22 cegger void mtd_mii_statchg(device_t);
112 1.7 perry
113 1.7 perry void mtd_start(struct ifnet *);
114 1.7 perry void mtd_stop(struct ifnet *, int);
115 1.13 christos int mtd_ioctl(struct ifnet *, u_long, void *);
116 1.7 perry void mtd_setmulti(struct mtd_softc *);
117 1.7 perry void mtd_watchdog(struct ifnet *);
118 1.7 perry
119 1.7 perry int mtd_init(struct ifnet *);
120 1.7 perry void mtd_reset(struct mtd_softc *);
121 1.7 perry void mtd_shutdown(void *);
122 1.7 perry int mtd_init_desc(struct mtd_softc *);
123 1.7 perry int mtd_put(struct mtd_softc *, int, struct mbuf *);
124 1.7 perry struct mbuf *mtd_get(struct mtd_softc *, int, int);
125 1.7 perry
126 1.7 perry int mtd_rxirq(struct mtd_softc *);
127 1.7 perry int mtd_txirq(struct mtd_softc *);
128 1.7 perry int mtd_bufirq(struct mtd_softc *);
129 1.1 martin
130 1.1 martin
131 1.1 martin int
132 1.18 dyoung mtd_config(struct mtd_softc *sc)
133 1.1 martin {
134 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
135 1.1 martin int i;
136 1.1 martin
137 1.1 martin /* Read station address */
138 1.1 martin for (i = 0; i < ETHER_ADDR_LEN; ++i)
139 1.1 martin sc->eaddr[i] = MTD_READ_1(sc, MTD_PAR0 + i);
140 1.1 martin
141 1.1 martin /* Initialize ifnet structure */
142 1.19 cegger memcpy(ifp->if_xname, device_xname(&sc->dev), IFNAMSIZ);
143 1.1 martin ifp->if_softc = sc;
144 1.1 martin ifp->if_init = mtd_init;
145 1.1 martin ifp->if_start = mtd_start;
146 1.1 martin ifp->if_stop = mtd_stop;
147 1.1 martin ifp->if_ioctl = mtd_ioctl;
148 1.1 martin ifp->if_watchdog = mtd_watchdog;
149 1.1 martin ifp->if_flags = IFF_BROADCAST | IFF_SIMPLEX | IFF_MULTICAST;
150 1.1 martin IFQ_SET_READY(&ifp->if_snd);
151 1.1 martin
152 1.1 martin /* Setup MII interface */
153 1.1 martin sc->mii.mii_ifp = ifp;
154 1.1 martin sc->mii.mii_readreg = mtd_mii_readreg;
155 1.1 martin sc->mii.mii_writereg = mtd_mii_writereg;
156 1.1 martin sc->mii.mii_statchg = mtd_mii_statchg;
157 1.1 martin
158 1.17 dyoung sc->ethercom.ec_mii = &sc->mii;
159 1.17 dyoung ifmedia_init(&sc->mii.mii_media, 0, ether_mediachange,
160 1.17 dyoung ether_mediastatus);
161 1.1 martin
162 1.1 martin mii_attach(&sc->dev, &sc->mii, 0xffffffff, MII_PHY_ANY, 0, 0);
163 1.1 martin
164 1.1 martin if (LIST_FIRST(&sc->mii.mii_phys) == NULL) {
165 1.19 cegger aprint_error_dev(&sc->dev, "Unable to configure MII\n");
166 1.1 martin return 1;
167 1.1 martin } else {
168 1.1 martin ifmedia_set(&sc->mii.mii_media, IFM_ETHER | IFM_AUTO);
169 1.1 martin }
170 1.1 martin
171 1.1 martin if (mtd_init_desc(sc))
172 1.1 martin return 1;
173 1.1 martin
174 1.1 martin /* Attach interface */
175 1.1 martin if_attach(ifp);
176 1.1 martin ether_ifattach(ifp, sc->eaddr);
177 1.1 martin
178 1.1 martin #if NRND > 0
179 1.1 martin /* Initialise random source */
180 1.19 cegger rnd_attach_source(&sc->rnd_src, device_xname(&sc->dev), RND_TYPE_NET, 0);
181 1.1 martin #endif
182 1.1 martin
183 1.1 martin /* Add shutdown hook to reset card when we reboot */
184 1.1 martin sc->sd_hook = shutdownhook_establish(mtd_shutdown, sc);
185 1.1 martin
186 1.1 martin return 0;
187 1.1 martin }
188 1.1 martin
189 1.1 martin
190 1.1 martin /*
191 1.1 martin * mtd_init
192 1.1 martin * Must be called at splnet()
193 1.1 martin */
194 1.1 martin int
195 1.18 dyoung mtd_init(struct ifnet *ifp)
196 1.1 martin {
197 1.1 martin struct mtd_softc *sc = ifp->if_softc;
198 1.1 martin
199 1.1 martin mtd_reset(sc);
200 1.1 martin
201 1.1 martin /*
202 1.1 martin * Set cache alignment and burst length. Don't really know what these
203 1.1 martin * mean, so their values are probably suboptimal.
204 1.1 martin */
205 1.1 martin MTD_WRITE_4(sc, MTD_BCR, MTD_BCR_BLEN16);
206 1.1 martin
207 1.4 martin MTD_WRITE_4(sc, MTD_RXTXR, MTD_TX_STFWD | MTD_TX_FDPLX);
208 1.1 martin
209 1.1 martin /* Promiscuous mode? */
210 1.1 martin if (ifp->if_flags & IFF_PROMISC)
211 1.1 martin MTD_SETBIT(sc, MTD_RXTXR, MTD_RX_PROM);
212 1.1 martin else
213 1.1 martin MTD_CLRBIT(sc, MTD_RXTXR, MTD_RX_PROM);
214 1.1 martin
215 1.1 martin /* Broadcast mode? */
216 1.1 martin if (ifp->if_flags & IFF_BROADCAST)
217 1.1 martin MTD_SETBIT(sc, MTD_RXTXR, MTD_RX_ABROAD);
218 1.1 martin else
219 1.1 martin MTD_CLRBIT(sc, MTD_RXTXR, MTD_RX_ABROAD);
220 1.1 martin
221 1.1 martin mtd_setmulti(sc);
222 1.1 martin
223 1.1 martin /* Enable interrupts */
224 1.1 martin MTD_WRITE_4(sc, MTD_IMR, MTD_IMR_MASK);
225 1.1 martin MTD_WRITE_4(sc, MTD_ISR, MTD_ISR_ENABLE);
226 1.1 martin
227 1.1 martin /* Set descriptor base addresses */
228 1.1 martin MTD_WRITE_4(sc, MTD_TXLBA, htole32(sc->desc_dma_map->dm_segs[0].ds_addr
229 1.1 martin + sizeof(struct mtd_desc) * MTD_NUM_RXD));
230 1.1 martin MTD_WRITE_4(sc, MTD_RXLBA,
231 1.1 martin htole32(sc->desc_dma_map->dm_segs[0].ds_addr));
232 1.1 martin
233 1.1 martin /* Enable receiver and transmitter */
234 1.1 martin MTD_SETBIT(sc, MTD_RXTXR, MTD_RX_ENABLE);
235 1.1 martin MTD_SETBIT(sc, MTD_RXTXR, MTD_TX_ENABLE);
236 1.1 martin
237 1.1 martin /* Interface is running */
238 1.1 martin ifp->if_flags |= IFF_RUNNING;
239 1.1 martin ifp->if_flags &= ~IFF_OACTIVE;
240 1.1 martin
241 1.1 martin return 0;
242 1.1 martin }
243 1.1 martin
244 1.1 martin
245 1.1 martin int
246 1.18 dyoung mtd_init_desc(struct mtd_softc *sc)
247 1.1 martin {
248 1.1 martin int rseg, err, i;
249 1.1 martin bus_dma_segment_t seg;
250 1.1 martin bus_size_t size;
251 1.1 martin
252 1.1 martin /* Allocate memory for descriptors */
253 1.1 martin size = (MTD_NUM_RXD + MTD_NUM_TXD) * sizeof(struct mtd_desc);
254 1.1 martin
255 1.1 martin /* Allocate DMA-safe memory */
256 1.1 martin if ((err = bus_dmamem_alloc(sc->dma_tag, size, MTD_DMA_ALIGN,
257 1.1 martin 0, &seg, 1, &rseg, BUS_DMA_NOWAIT)) != 0) {
258 1.19 cegger aprint_error_dev(&sc->dev, "unable to allocate DMA buffer, error = %d\n", err);
259 1.1 martin return 1;
260 1.1 martin }
261 1.1 martin
262 1.1 martin /* Map memory to kernel addressable space */
263 1.1 martin if ((err = bus_dmamem_map(sc->dma_tag, &seg, 1, size,
264 1.13 christos (void **)&sc->desc, BUS_DMA_NOWAIT | BUS_DMA_COHERENT)) != 0) {
265 1.19 cegger aprint_error_dev(&sc->dev, "unable to map DMA buffer, error = %d\n", err);
266 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
267 1.1 martin return 1;
268 1.1 martin }
269 1.1 martin
270 1.1 martin /* Create a DMA map */
271 1.1 martin if ((err = bus_dmamap_create(sc->dma_tag, size, 1,
272 1.1 martin size, 0, BUS_DMA_NOWAIT, &sc->desc_dma_map)) != 0) {
273 1.19 cegger aprint_error_dev(&sc->dev, "unable to create DMA map, error = %d\n", err);
274 1.13 christos bus_dmamem_unmap(sc->dma_tag, (void *)sc->desc, size);
275 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
276 1.1 martin return 1;
277 1.1 martin }
278 1.1 martin
279 1.1 martin /* Load the DMA map */
280 1.1 martin if ((err = bus_dmamap_load(sc->dma_tag, sc->desc_dma_map, sc->desc,
281 1.1 martin size, NULL, BUS_DMA_NOWAIT)) != 0) {
282 1.19 cegger aprint_error_dev(&sc->dev, "unable to load DMA map, error = %d\n",
283 1.19 cegger err);
284 1.1 martin bus_dmamap_destroy(sc->dma_tag, sc->desc_dma_map);
285 1.13 christos bus_dmamem_unmap(sc->dma_tag, (void *)sc->desc, size);
286 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
287 1.1 martin return 1;
288 1.1 martin }
289 1.1 martin
290 1.1 martin /* Allocate memory for the buffers */
291 1.1 martin size = MTD_NUM_RXD * MTD_RXBUF_SIZE + MTD_NUM_TXD * MTD_TXBUF_SIZE;
292 1.1 martin
293 1.1 martin /* Allocate DMA-safe memory */
294 1.1 martin if ((err = bus_dmamem_alloc(sc->dma_tag, size, MTD_DMA_ALIGN,
295 1.1 martin 0, &seg, 1, &rseg, BUS_DMA_NOWAIT)) != 0) {
296 1.19 cegger aprint_error_dev(&sc->dev, "unable to allocate DMA buffer, error = %d\n",
297 1.19 cegger err);
298 1.1 martin
299 1.1 martin /* Undo DMA map for descriptors */
300 1.1 martin bus_dmamap_unload(sc->dma_tag, sc->desc_dma_map);
301 1.1 martin bus_dmamap_destroy(sc->dma_tag, sc->desc_dma_map);
302 1.13 christos bus_dmamem_unmap(sc->dma_tag, (void *)sc->desc, size);
303 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
304 1.1 martin return 1;
305 1.1 martin }
306 1.1 martin
307 1.1 martin /* Map memory to kernel addressable space */
308 1.1 martin if ((err = bus_dmamem_map(sc->dma_tag, &seg, 1, size,
309 1.1 martin &sc->buf, BUS_DMA_NOWAIT | BUS_DMA_COHERENT)) != 0) {
310 1.19 cegger aprint_error_dev(&sc->dev, "unable to map DMA buffer, error = %d\n",
311 1.19 cegger err);
312 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
313 1.1 martin
314 1.1 martin /* Undo DMA map for descriptors */
315 1.1 martin bus_dmamap_unload(sc->dma_tag, sc->desc_dma_map);
316 1.1 martin bus_dmamap_destroy(sc->dma_tag, sc->desc_dma_map);
317 1.13 christos bus_dmamem_unmap(sc->dma_tag, (void *)sc->desc, size);
318 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
319 1.1 martin return 1;
320 1.1 martin }
321 1.1 martin
322 1.1 martin /* Create a DMA map */
323 1.1 martin if ((err = bus_dmamap_create(sc->dma_tag, size, 1,
324 1.1 martin size, 0, BUS_DMA_NOWAIT, &sc->buf_dma_map)) != 0) {
325 1.19 cegger aprint_error_dev(&sc->dev, "unable to create DMA map, error = %d\n",
326 1.19 cegger err);
327 1.1 martin bus_dmamem_unmap(sc->dma_tag, sc->buf, size);
328 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
329 1.1 martin
330 1.1 martin /* Undo DMA map for descriptors */
331 1.1 martin bus_dmamap_unload(sc->dma_tag, sc->desc_dma_map);
332 1.1 martin bus_dmamap_destroy(sc->dma_tag, sc->desc_dma_map);
333 1.13 christos bus_dmamem_unmap(sc->dma_tag, (void *)sc->desc, size);
334 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
335 1.1 martin return 1;
336 1.1 martin }
337 1.1 martin
338 1.1 martin /* Load the DMA map */
339 1.1 martin if ((err = bus_dmamap_load(sc->dma_tag, sc->buf_dma_map, sc->buf,
340 1.1 martin size, NULL, BUS_DMA_NOWAIT)) != 0) {
341 1.19 cegger aprint_error_dev(&sc->dev, "unable to load DMA map, error = %d\n",
342 1.19 cegger err);
343 1.1 martin bus_dmamap_destroy(sc->dma_tag, sc->buf_dma_map);
344 1.1 martin bus_dmamem_unmap(sc->dma_tag, sc->buf, size);
345 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
346 1.1 martin
347 1.1 martin /* Undo DMA map for descriptors */
348 1.1 martin bus_dmamap_unload(sc->dma_tag, sc->desc_dma_map);
349 1.1 martin bus_dmamap_destroy(sc->dma_tag, sc->desc_dma_map);
350 1.13 christos bus_dmamem_unmap(sc->dma_tag, (void *)sc->desc, size);
351 1.1 martin bus_dmamem_free(sc->dma_tag, &seg, rseg);
352 1.1 martin return 1;
353 1.1 martin }
354 1.1 martin
355 1.1 martin /* Descriptors are stored as a circular linked list */
356 1.1 martin /* Fill in rx descriptors */
357 1.1 martin for (i = 0; i < MTD_NUM_RXD; ++i) {
358 1.1 martin sc->desc[i].stat = MTD_RXD_OWNER;
359 1.2 wiz if (i == MTD_NUM_RXD - 1) { /* Last descriptor */
360 1.1 martin /* Link back to first rx descriptor */
361 1.1 martin sc->desc[i].next =
362 1.1 martin htole32(sc->desc_dma_map->dm_segs[0].ds_addr);
363 1.1 martin } else {
364 1.1 martin /* Link forward to next rx descriptor */
365 1.1 martin sc->desc[i].next =
366 1.1 martin htole32(sc->desc_dma_map->dm_segs[0].ds_addr
367 1.1 martin + (i + 1) * sizeof(struct mtd_desc));
368 1.1 martin }
369 1.1 martin sc->desc[i].conf = MTD_RXBUF_SIZE & MTD_RXD_CONF_BUFS;
370 1.1 martin /* Set buffer's address */
371 1.1 martin sc->desc[i].data = htole32(sc->buf_dma_map->dm_segs[0].ds_addr
372 1.1 martin + i * MTD_RXBUF_SIZE);
373 1.1 martin }
374 1.1 martin
375 1.1 martin /* Fill in tx descriptors */
376 1.1 martin for (/* i = MTD_NUM_RXD */; i < (MTD_NUM_TXD + MTD_NUM_RXD); ++i) {
377 1.1 martin sc->desc[i].stat = 0; /* At least, NOT MTD_TXD_OWNER! */
378 1.1 martin if (i == (MTD_NUM_RXD + MTD_NUM_TXD - 1)) { /* Last descr */
379 1.1 martin /* Link back to first tx descriptor */
380 1.1 martin sc->desc[i].next =
381 1.1 martin htole32(sc->desc_dma_map->dm_segs[0].ds_addr
382 1.1 martin +MTD_NUM_RXD * sizeof(struct mtd_desc));
383 1.1 martin } else {
384 1.1 martin /* Link forward to next tx descriptor */
385 1.1 martin sc->desc[i].next =
386 1.1 martin htole32(sc->desc_dma_map->dm_segs[0].ds_addr
387 1.1 martin + (i + 1) * sizeof(struct mtd_desc));
388 1.1 martin }
389 1.1 martin /* sc->desc[i].conf = MTD_TXBUF_SIZE & MTD_TXD_CONF_BUFS; */
390 1.1 martin /* Set buffer's address */
391 1.1 martin sc->desc[i].data = htole32(sc->buf_dma_map->dm_segs[0].ds_addr
392 1.1 martin + MTD_NUM_RXD * MTD_RXBUF_SIZE
393 1.1 martin + (i - MTD_NUM_RXD) * MTD_TXBUF_SIZE);
394 1.1 martin }
395 1.1 martin
396 1.1 martin return 0;
397 1.1 martin }
398 1.1 martin
399 1.1 martin
400 1.1 martin void
401 1.18 dyoung mtd_mii_statchg(device_t self)
402 1.1 martin {
403 1.1 martin /* Should we do something here? :) */
404 1.1 martin }
405 1.1 martin
406 1.1 martin
407 1.1 martin int
408 1.18 dyoung mtd_mii_readreg(device_t self, int phy, int reg)
409 1.1 martin {
410 1.18 dyoung struct mtd_softc *sc = device_private(self);
411 1.1 martin
412 1.1 martin return (MTD_READ_2(sc, MTD_PHYBASE + reg * 2));
413 1.1 martin }
414 1.1 martin
415 1.1 martin
416 1.1 martin void
417 1.18 dyoung mtd_mii_writereg(device_t self, int phy, int reg, int val)
418 1.1 martin {
419 1.18 dyoung struct mtd_softc *sc = device_private(self);
420 1.1 martin
421 1.1 martin MTD_WRITE_2(sc, MTD_PHYBASE + reg * 2, val);
422 1.1 martin }
423 1.1 martin
424 1.1 martin
425 1.1 martin int
426 1.18 dyoung mtd_put(struct mtd_softc *sc, int index, struct mbuf *m)
427 1.1 martin {
428 1.1 martin int len, tlen;
429 1.13 christos char *buf = (char *)sc->buf + MTD_NUM_RXD * MTD_RXBUF_SIZE
430 1.1 martin + index * MTD_TXBUF_SIZE;
431 1.1 martin struct mbuf *n;
432 1.1 martin
433 1.1 martin for (tlen = 0; m != NULL; m = n) {
434 1.1 martin len = m->m_len;
435 1.1 martin if (len == 0) {
436 1.1 martin MFREE(m, n);
437 1.1 martin continue;
438 1.1 martin } else if (tlen > MTD_TXBUF_SIZE) {
439 1.1 martin /* XXX FIXME: No idea what to do here. */
440 1.19 cegger aprint_error_dev(&sc->dev, "packet too large! Size = %i\n",
441 1.19 cegger tlen);
442 1.1 martin MFREE(m, n);
443 1.1 martin continue;
444 1.1 martin }
445 1.13 christos memcpy(buf, mtod(m, void *), len);
446 1.1 martin buf += len;
447 1.1 martin tlen += len;
448 1.1 martin MFREE(m, n);
449 1.1 martin }
450 1.1 martin sc->desc[MTD_NUM_RXD + index].conf = MTD_TXD_CONF_PAD | MTD_TXD_CONF_CRC
451 1.1 martin | MTD_TXD_CONF_IRQC
452 1.1 martin | ((tlen << MTD_TXD_PKTS_SHIFT) & MTD_TXD_CONF_PKTS)
453 1.1 martin | (tlen & MTD_TXD_CONF_BUFS);
454 1.1 martin
455 1.1 martin return tlen;
456 1.1 martin }
457 1.1 martin
458 1.1 martin
459 1.1 martin void
460 1.18 dyoung mtd_start(struct ifnet *ifp)
461 1.1 martin {
462 1.1 martin struct mtd_softc *sc = ifp->if_softc;
463 1.1 martin struct mbuf *m;
464 1.1 martin int len;
465 1.1 martin int first_tx = sc->cur_tx;
466 1.1 martin
467 1.1 martin /* Don't transmit when the interface is busy or inactive */
468 1.1 martin if ((ifp->if_flags & (IFF_RUNNING | IFF_OACTIVE)) != IFF_RUNNING)
469 1.1 martin return;
470 1.1 martin
471 1.1 martin for (;;) {
472 1.1 martin IF_DEQUEUE(&ifp->if_snd, m);
473 1.1 martin
474 1.1 martin if (m == NULL)
475 1.1 martin break;
476 1.1 martin
477 1.24 joerg bpf_mtap(ifp, m);
478 1.1 martin
479 1.1 martin /* Copy mbuf chain into tx buffer */
480 1.1 martin len = mtd_put(sc, sc->cur_tx, m);
481 1.1 martin
482 1.1 martin if (sc->cur_tx != first_tx)
483 1.1 martin sc->desc[MTD_NUM_RXD + sc->cur_tx].stat = MTD_TXD_OWNER;
484 1.1 martin
485 1.1 martin if (++sc->cur_tx >= MTD_NUM_TXD)
486 1.1 martin sc->cur_tx = 0;
487 1.1 martin }
488 1.1 martin /* Mark first & last descriptor */
489 1.1 martin sc->desc[MTD_NUM_RXD + first_tx].conf |= MTD_TXD_CONF_FSD;
490 1.1 martin
491 1.1 martin if (sc->cur_tx == 0) {
492 1.1 martin sc->desc[MTD_NUM_RXD + MTD_NUM_TXD - 1].conf |=MTD_TXD_CONF_LSD;
493 1.1 martin } else {
494 1.1 martin sc->desc[MTD_NUM_RXD + sc->cur_tx - 1].conf |= MTD_TXD_CONF_LSD;
495 1.1 martin }
496 1.1 martin
497 1.1 martin /* Give first descriptor to chip to complete transaction */
498 1.1 martin sc->desc[MTD_NUM_RXD + first_tx].stat = MTD_TXD_OWNER;
499 1.1 martin
500 1.1 martin /* Transmit polling demand */
501 1.1 martin MTD_WRITE_4(sc, MTD_TXPDR, MTD_TXPDR_DEMAND);
502 1.1 martin
503 1.1 martin /* XXX FIXME: Set up a watchdog timer */
504 1.1 martin /* ifp->if_timer = 5; */
505 1.1 martin }
506 1.1 martin
507 1.1 martin
508 1.1 martin void
509 1.18 dyoung mtd_stop(struct ifnet *ifp, int disable)
510 1.1 martin {
511 1.1 martin struct mtd_softc *sc = ifp->if_softc;
512 1.1 martin
513 1.1 martin /* Disable transmitter and receiver */
514 1.1 martin MTD_CLRBIT(sc, MTD_RXTXR, MTD_TX_ENABLE);
515 1.1 martin MTD_CLRBIT(sc, MTD_RXTXR, MTD_RX_ENABLE);
516 1.1 martin
517 1.1 martin /* Disable interrupts */
518 1.1 martin MTD_WRITE_4(sc, MTD_IMR, 0x00000000);
519 1.1 martin
520 1.1 martin /* Must do more at disable??... */
521 1.1 martin if (disable) {
522 1.5 wiz /* Delete tx and rx descriptor base addresses */
523 1.1 martin MTD_WRITE_4(sc, MTD_RXLBA, 0x00000000);
524 1.1 martin MTD_WRITE_4(sc, MTD_TXLBA, 0x00000000);
525 1.1 martin }
526 1.1 martin
527 1.1 martin ifp->if_timer = 0;
528 1.1 martin ifp->if_flags &= ~(IFF_RUNNING | IFF_OACTIVE);
529 1.1 martin }
530 1.1 martin
531 1.1 martin
532 1.1 martin void
533 1.18 dyoung mtd_watchdog(struct ifnet *ifp)
534 1.1 martin {
535 1.1 martin struct mtd_softc *sc = ifp->if_softc;
536 1.1 martin int s;
537 1.1 martin
538 1.19 cegger log(LOG_ERR, "%s: device timeout\n", device_xname(&sc->dev));
539 1.1 martin ++sc->ethercom.ec_if.if_oerrors;
540 1.1 martin
541 1.1 martin mtd_stop(ifp, 0);
542 1.1 martin
543 1.1 martin s = splnet();
544 1.1 martin mtd_init(ifp);
545 1.1 martin splx(s);
546 1.1 martin
547 1.1 martin return;
548 1.1 martin }
549 1.1 martin
550 1.1 martin
551 1.1 martin int
552 1.18 dyoung mtd_ioctl(struct ifnet *ifp, u_long cmd, void *data)
553 1.1 martin {
554 1.1 martin struct mtd_softc *sc = ifp->if_softc;
555 1.1 martin int s, error = 0;
556 1.1 martin
557 1.1 martin s = splnet();
558 1.1 martin
559 1.17 dyoung if ((error = ether_ioctl(ifp, cmd, data)) == ENETRESET) {
560 1.17 dyoung /*
561 1.17 dyoung * Multicast list has changed; set the hardware
562 1.17 dyoung * filter accordingly.
563 1.17 dyoung */
564 1.17 dyoung if (ifp->if_flags & IFF_RUNNING)
565 1.17 dyoung mtd_setmulti(sc);
566 1.17 dyoung error = 0;
567 1.1 martin }
568 1.1 martin
569 1.1 martin splx(s);
570 1.1 martin return error;
571 1.1 martin }
572 1.1 martin
573 1.1 martin
574 1.1 martin struct mbuf *
575 1.18 dyoung mtd_get(struct mtd_softc *sc, int index, int totlen)
576 1.1 martin {
577 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
578 1.1 martin struct mbuf *m, *m0, *newm;
579 1.1 martin int len;
580 1.13 christos char *buf = (char *)sc->buf + index * MTD_RXBUF_SIZE;
581 1.1 martin
582 1.1 martin MGETHDR(m0, M_DONTWAIT, MT_DATA);
583 1.1 martin if (m0 == NULL)
584 1.1 martin return NULL;
585 1.1 martin
586 1.1 martin m0->m_pkthdr.rcvif = ifp;
587 1.1 martin m0->m_pkthdr.len = totlen;
588 1.1 martin m = m0;
589 1.1 martin len = MHLEN;
590 1.1 martin
591 1.1 martin while (totlen > 0) {
592 1.1 martin if (totlen >= MINCLSIZE) {
593 1.1 martin MCLGET(m, M_DONTWAIT);
594 1.1 martin if (!(m->m_flags & M_EXT)) {
595 1.1 martin m_freem(m0);
596 1.1 martin return NULL;
597 1.1 martin }
598 1.1 martin len = MCLBYTES;
599 1.1 martin }
600 1.1 martin
601 1.1 martin if (m == m0) {
602 1.13 christos char *newdata = (char *)
603 1.1 martin ALIGN(m->m_data + sizeof(struct ether_header)) -
604 1.1 martin sizeof(struct ether_header);
605 1.1 martin len -= newdata - m->m_data;
606 1.1 martin m->m_data = newdata;
607 1.1 martin }
608 1.1 martin
609 1.1 martin m->m_len = len = min(totlen, len);
610 1.13 christos memcpy(mtod(m, void *), buf, len);
611 1.1 martin buf += len;
612 1.1 martin
613 1.1 martin totlen -= len;
614 1.1 martin if (totlen > 0) {
615 1.1 martin MGET(newm, M_DONTWAIT, MT_DATA);
616 1.1 martin if (newm == NULL) {
617 1.1 martin m_freem(m0);
618 1.1 martin return NULL;
619 1.1 martin }
620 1.1 martin len = MLEN;
621 1.1 martin m = m->m_next = newm;
622 1.1 martin }
623 1.1 martin }
624 1.1 martin
625 1.1 martin return m0;
626 1.1 martin }
627 1.1 martin
628 1.1 martin
629 1.1 martin int
630 1.18 dyoung mtd_rxirq(struct mtd_softc *sc)
631 1.1 martin {
632 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
633 1.1 martin int len;
634 1.1 martin struct mbuf *m;
635 1.1 martin
636 1.1 martin for (; !(sc->desc[sc->cur_rx].stat & MTD_RXD_OWNER);) {
637 1.1 martin /* Error summary set? */
638 1.1 martin if (sc->desc[sc->cur_rx].stat & MTD_RXD_ERRSUM) {
639 1.19 cegger aprint_error_dev(&sc->dev, "received packet with errors\n");
640 1.1 martin /* Give up packet, since an error occurred */
641 1.1 martin sc->desc[sc->cur_rx].stat = MTD_RXD_OWNER;
642 1.1 martin sc->desc[sc->cur_rx].conf = MTD_RXBUF_SIZE &
643 1.1 martin MTD_RXD_CONF_BUFS;
644 1.1 martin ++ifp->if_ierrors;
645 1.1 martin if (++sc->cur_rx >= MTD_NUM_RXD)
646 1.1 martin sc->cur_rx = 0;
647 1.1 martin continue;
648 1.1 martin }
649 1.1 martin /* Get buffer length */
650 1.1 martin len = (sc->desc[sc->cur_rx].stat & MTD_RXD_FLEN)
651 1.1 martin >> MTD_RXD_FLEN_SHIFT;
652 1.1 martin len -= ETHER_CRC_LEN;
653 1.1 martin
654 1.1 martin /* Check packet size */
655 1.8 perry if (len <= sizeof(struct ether_header)) {
656 1.19 cegger aprint_error_dev(&sc->dev, "invalid packet size %d; dropping\n",
657 1.19 cegger len);
658 1.1 martin sc->desc[sc->cur_rx].stat = MTD_RXD_OWNER;
659 1.1 martin sc->desc[sc->cur_rx].conf = MTD_RXBUF_SIZE &
660 1.1 martin MTD_RXD_CONF_BUFS;
661 1.1 martin ++ifp->if_ierrors;
662 1.1 martin if (++sc->cur_rx >= MTD_NUM_RXD)
663 1.1 martin sc->cur_rx = 0;
664 1.1 martin continue;
665 1.1 martin }
666 1.1 martin
667 1.1 martin m = mtd_get(sc, (sc->cur_rx), len);
668 1.1 martin
669 1.1 martin /* Give descriptor back to card */
670 1.1 martin sc->desc[sc->cur_rx].conf = MTD_RXBUF_SIZE & MTD_RXD_CONF_BUFS;
671 1.1 martin sc->desc[sc->cur_rx].stat = MTD_RXD_OWNER;
672 1.1 martin
673 1.1 martin if (++sc->cur_rx >= MTD_NUM_RXD)
674 1.1 martin sc->cur_rx = 0;
675 1.1 martin
676 1.1 martin if (m == NULL) {
677 1.19 cegger aprint_error_dev(&sc->dev, "error pulling packet off interface\n");
678 1.1 martin ++ifp->if_ierrors;
679 1.1 martin continue;
680 1.1 martin }
681 1.1 martin
682 1.1 martin ++ifp->if_ipackets;
683 1.1 martin
684 1.24 joerg bpf_mtap(ifp, m);
685 1.1 martin /* Pass the packet up */
686 1.1 martin (*ifp->if_input)(ifp, m);
687 1.1 martin }
688 1.1 martin
689 1.1 martin return 1;
690 1.1 martin }
691 1.1 martin
692 1.1 martin
693 1.1 martin int
694 1.18 dyoung mtd_txirq(struct mtd_softc *sc)
695 1.1 martin {
696 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
697 1.1 martin
698 1.1 martin /* Clear timeout */
699 1.1 martin ifp->if_timer = 0;
700 1.1 martin
701 1.1 martin ifp->if_flags &= ~IFF_OACTIVE;
702 1.1 martin ++ifp->if_opackets;
703 1.1 martin
704 1.1 martin /* XXX FIXME If there is some queued, do an mtd_start? */
705 1.1 martin
706 1.1 martin return 1;
707 1.1 martin }
708 1.1 martin
709 1.1 martin
710 1.1 martin int
711 1.18 dyoung mtd_bufirq(struct mtd_softc *sc)
712 1.1 martin {
713 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
714 1.8 perry
715 1.1 martin /* Clear timeout */
716 1.1 martin ifp->if_timer = 0;
717 1.1 martin
718 1.1 martin /* XXX FIXME: Do something here to make sure we get some buffers! */
719 1.1 martin
720 1.1 martin return 1;
721 1.1 martin }
722 1.1 martin
723 1.1 martin
724 1.1 martin int
725 1.18 dyoung mtd_irq_h(void *args)
726 1.1 martin {
727 1.1 martin struct mtd_softc *sc = args;
728 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
729 1.1 martin u_int32_t status;
730 1.1 martin int r = 0;
731 1.1 martin
732 1.10 thorpej if (!(ifp->if_flags & IFF_RUNNING) || !device_is_active(&sc->dev))
733 1.1 martin return 0;
734 1.1 martin
735 1.1 martin /* Disable interrupts */
736 1.1 martin MTD_WRITE_4(sc, MTD_IMR, 0x00000000);
737 1.1 martin
738 1.1 martin for(;;) {
739 1.1 martin status = MTD_READ_4(sc, MTD_ISR);
740 1.1 martin #if NRND > 0
741 1.1 martin /* Add random seed before masking out bits */
742 1.1 martin if (status)
743 1.1 martin rnd_add_uint32(&sc->rnd_src, status);
744 1.1 martin #endif
745 1.1 martin status &= MTD_ISR_MASK;
746 1.1 martin if (!status) /* We didn't ask for this */
747 1.1 martin break;
748 1.1 martin
749 1.1 martin MTD_WRITE_4(sc, MTD_ISR, status);
750 1.1 martin
751 1.1 martin /* NOTE: Perhaps we should reset with some of these errors? */
752 1.1 martin
753 1.1 martin if (status & MTD_ISR_RXBUN) {
754 1.19 cegger aprint_error_dev(&sc->dev, "receive buffer unavailable\n");
755 1.1 martin ++ifp->if_ierrors;
756 1.1 martin }
757 1.1 martin
758 1.1 martin if (status & MTD_ISR_RXERR) {
759 1.19 cegger aprint_error_dev(&sc->dev, "receive error\n");
760 1.1 martin ++ifp->if_ierrors;
761 1.1 martin }
762 1.1 martin
763 1.1 martin if (status & MTD_ISR_TXBUN) {
764 1.19 cegger aprint_error_dev(&sc->dev, "transmit buffer unavailable\n");
765 1.1 martin ++ifp->if_ierrors;
766 1.1 martin }
767 1.1 martin
768 1.1 martin if ((status & MTD_ISR_PDF)) {
769 1.19 cegger aprint_error_dev(&sc->dev, "parallel detection fault\n");
770 1.1 martin ++ifp->if_ierrors;
771 1.1 martin }
772 1.1 martin
773 1.1 martin if (status & MTD_ISR_FBUSERR) {
774 1.19 cegger aprint_error_dev(&sc->dev, "fatal bus error\n");
775 1.1 martin ++ifp->if_ierrors;
776 1.1 martin }
777 1.1 martin
778 1.1 martin if (status & MTD_ISR_TARERR) {
779 1.19 cegger aprint_error_dev(&sc->dev, "target error\n");
780 1.1 martin ++ifp->if_ierrors;
781 1.1 martin }
782 1.1 martin
783 1.1 martin if (status & MTD_ISR_MASTERR) {
784 1.19 cegger aprint_error_dev(&sc->dev, "master error\n");
785 1.1 martin ++ifp->if_ierrors;
786 1.1 martin }
787 1.1 martin
788 1.1 martin if (status & MTD_ISR_PARERR) {
789 1.19 cegger aprint_error_dev(&sc->dev, "parity error\n");
790 1.1 martin ++ifp->if_ierrors;
791 1.1 martin }
792 1.1 martin
793 1.1 martin if (status & MTD_ISR_RXIRQ) /* Receive interrupt */
794 1.1 martin r |= mtd_rxirq(sc);
795 1.1 martin
796 1.1 martin if (status & MTD_ISR_TXIRQ) /* Transmit interrupt */
797 1.1 martin r |= mtd_txirq(sc);
798 1.1 martin
799 1.1 martin if (status & MTD_ISR_TXEARLY) /* Transmit early */
800 1.1 martin r |= mtd_txirq(sc);
801 1.1 martin
802 1.1 martin if (status & MTD_ISR_TXBUN) /* Transmit buffer n/a */
803 1.1 martin r |= mtd_bufirq(sc);
804 1.1 martin
805 1.1 martin }
806 1.1 martin
807 1.1 martin /* Enable interrupts */
808 1.1 martin MTD_WRITE_4(sc, MTD_IMR, MTD_IMR_MASK);
809 1.1 martin
810 1.1 martin return r;
811 1.1 martin }
812 1.1 martin
813 1.1 martin
814 1.1 martin void
815 1.18 dyoung mtd_setmulti(struct mtd_softc *sc)
816 1.1 martin {
817 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
818 1.1 martin u_int32_t rxtx_stat;
819 1.1 martin u_int32_t hash[2] = {0, 0};
820 1.1 martin u_int32_t crc;
821 1.1 martin struct ether_multi *enm;
822 1.1 martin struct ether_multistep step;
823 1.1 martin int mcnt = 0;
824 1.1 martin
825 1.1 martin /* Get old status */
826 1.1 martin rxtx_stat = MTD_READ_4(sc, MTD_RXTXR);
827 1.1 martin
828 1.1 martin if ((ifp->if_flags & IFF_ALLMULTI) || (ifp->if_flags & IFF_PROMISC)) {
829 1.1 martin rxtx_stat |= MTD_RX_AMULTI;
830 1.1 martin MTD_WRITE_4(sc, MTD_RXTXR, rxtx_stat);
831 1.1 martin MTD_WRITE_4(sc, MTD_MAR0, MTD_ALL_ADDR);
832 1.1 martin MTD_WRITE_4(sc, MTD_MAR1, MTD_ALL_ADDR);
833 1.1 martin return;
834 1.1 martin }
835 1.1 martin
836 1.1 martin ETHER_FIRST_MULTI(step, &sc->ethercom, enm);
837 1.1 martin while (enm != NULL) {
838 1.1 martin /* We need the 6 most significant bits of the CRC */
839 1.1 martin crc = ETHER_CRC32(enm->enm_addrlo, ETHER_ADDR_LEN) >> 26;
840 1.1 martin
841 1.1 martin hash[crc >> 5] |= 1 << (crc & 0xf);
842 1.1 martin
843 1.1 martin ++mcnt;
844 1.1 martin ETHER_NEXT_MULTI(step, enm);
845 1.1 martin }
846 1.1 martin
847 1.1 martin /* Accept multicast bit needs to be on? */
848 1.1 martin if (mcnt)
849 1.1 martin rxtx_stat |= MTD_RX_AMULTI;
850 1.1 martin else
851 1.1 martin rxtx_stat &= ~MTD_RX_AMULTI;
852 1.1 martin
853 1.1 martin /* Write out the hash */
854 1.1 martin MTD_WRITE_4(sc, MTD_MAR0, hash[0]);
855 1.1 martin MTD_WRITE_4(sc, MTD_MAR1, hash[1]);
856 1.1 martin MTD_WRITE_4(sc, MTD_RXTXR, rxtx_stat);
857 1.1 martin }
858 1.1 martin
859 1.1 martin
860 1.1 martin void
861 1.18 dyoung mtd_reset(struct mtd_softc *sc)
862 1.1 martin {
863 1.1 martin int i;
864 1.1 martin
865 1.1 martin MTD_SETBIT(sc, MTD_BCR, MTD_BCR_RESET);
866 1.1 martin
867 1.1 martin /* Reset descriptor status */
868 1.1 martin sc->cur_tx = 0;
869 1.1 martin sc->cur_rx = 0;
870 1.1 martin
871 1.1 martin /* Wait until done with reset */
872 1.1 martin for (i = 0; i < MTD_TIMEOUT; ++i) {
873 1.1 martin DELAY(10);
874 1.1 martin if (!(MTD_READ_4(sc, MTD_BCR) & MTD_BCR_RESET))
875 1.1 martin break;
876 1.1 martin }
877 1.1 martin
878 1.1 martin if (i == MTD_TIMEOUT) {
879 1.19 cegger aprint_error_dev(&sc->dev, "reset timed out\n");
880 1.1 martin }
881 1.1 martin
882 1.1 martin /* Wait a little so chip can stabilize */
883 1.1 martin DELAY(1000);
884 1.1 martin }
885 1.1 martin
886 1.1 martin
887 1.1 martin void
888 1.21 dsl mtd_shutdown (void *arg)
889 1.1 martin {
890 1.1 martin struct mtd_softc *sc = arg;
891 1.1 martin struct ifnet *ifp = &sc->ethercom.ec_if;
892 1.1 martin
893 1.1 martin #if NRND > 0
894 1.1 martin rnd_detach_source(&sc->rnd_src);
895 1.1 martin #endif
896 1.1 martin mtd_stop(ifp, 1);
897 1.1 martin }
898