1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Comtrol SV11 card driver
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * This is a slightly odd Z85230 synchronous driver. All you need to
6*4882a593Smuzhiyun * know basically is
7*4882a593Smuzhiyun *
8*4882a593Smuzhiyun * Its a genuine Z85230
9*4882a593Smuzhiyun *
10*4882a593Smuzhiyun * It supports DMA using two DMA channels in SYNC mode. The driver doesn't
11*4882a593Smuzhiyun * use these facilities
12*4882a593Smuzhiyun *
13*4882a593Smuzhiyun * The control port is at io+1, the data at io+3 and turning off the DMA
14*4882a593Smuzhiyun * is done by writing 0 to io+4
15*4882a593Smuzhiyun *
16*4882a593Smuzhiyun * The hardware does the bus handling to avoid the need for delays between
17*4882a593Smuzhiyun * touching control registers.
18*4882a593Smuzhiyun *
19*4882a593Smuzhiyun * Port B isn't wired (why - beats me)
20*4882a593Smuzhiyun *
21*4882a593Smuzhiyun * Generic HDLC port Copyright (C) 2008 Krzysztof Halasa <khc@pm.waw.pl>
22*4882a593Smuzhiyun */
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun #include <linux/module.h>
27*4882a593Smuzhiyun #include <linux/kernel.h>
28*4882a593Smuzhiyun #include <linux/mm.h>
29*4882a593Smuzhiyun #include <linux/net.h>
30*4882a593Smuzhiyun #include <linux/skbuff.h>
31*4882a593Smuzhiyun #include <linux/netdevice.h>
32*4882a593Smuzhiyun #include <linux/if_arp.h>
33*4882a593Smuzhiyun #include <linux/delay.h>
34*4882a593Smuzhiyun #include <linux/hdlc.h>
35*4882a593Smuzhiyun #include <linux/ioport.h>
36*4882a593Smuzhiyun #include <linux/slab.h>
37*4882a593Smuzhiyun #include <net/arp.h>
38*4882a593Smuzhiyun
39*4882a593Smuzhiyun #include <asm/irq.h>
40*4882a593Smuzhiyun #include <asm/io.h>
41*4882a593Smuzhiyun #include <asm/dma.h>
42*4882a593Smuzhiyun #include <asm/byteorder.h>
43*4882a593Smuzhiyun #include "z85230.h"
44*4882a593Smuzhiyun
45*4882a593Smuzhiyun static int dma;
46*4882a593Smuzhiyun
47*4882a593Smuzhiyun /*
48*4882a593Smuzhiyun * Network driver support routines
49*4882a593Smuzhiyun */
50*4882a593Smuzhiyun
dev_to_sv(struct net_device * dev)51*4882a593Smuzhiyun static inline struct z8530_dev* dev_to_sv(struct net_device *dev)
52*4882a593Smuzhiyun {
53*4882a593Smuzhiyun return (struct z8530_dev *)dev_to_hdlc(dev)->priv;
54*4882a593Smuzhiyun }
55*4882a593Smuzhiyun
56*4882a593Smuzhiyun /*
57*4882a593Smuzhiyun * Frame receive. Simple for our card as we do HDLC and there
58*4882a593Smuzhiyun * is no funny garbage involved
59*4882a593Smuzhiyun */
60*4882a593Smuzhiyun
hostess_input(struct z8530_channel * c,struct sk_buff * skb)61*4882a593Smuzhiyun static void hostess_input(struct z8530_channel *c, struct sk_buff *skb)
62*4882a593Smuzhiyun {
63*4882a593Smuzhiyun /* Drop the CRC - it's not a good idea to try and negotiate it ;) */
64*4882a593Smuzhiyun skb_trim(skb, skb->len - 2);
65*4882a593Smuzhiyun skb->protocol = hdlc_type_trans(skb, c->netdevice);
66*4882a593Smuzhiyun skb_reset_mac_header(skb);
67*4882a593Smuzhiyun skb->dev = c->netdevice;
68*4882a593Smuzhiyun /*
69*4882a593Smuzhiyun * Send it to the PPP layer. We don't have time to process
70*4882a593Smuzhiyun * it right now.
71*4882a593Smuzhiyun */
72*4882a593Smuzhiyun netif_rx(skb);
73*4882a593Smuzhiyun }
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun /*
76*4882a593Smuzhiyun * We've been placed in the UP state
77*4882a593Smuzhiyun */
78*4882a593Smuzhiyun
hostess_open(struct net_device * d)79*4882a593Smuzhiyun static int hostess_open(struct net_device *d)
80*4882a593Smuzhiyun {
81*4882a593Smuzhiyun struct z8530_dev *sv11 = dev_to_sv(d);
82*4882a593Smuzhiyun int err = -1;
83*4882a593Smuzhiyun
84*4882a593Smuzhiyun /*
85*4882a593Smuzhiyun * Link layer up
86*4882a593Smuzhiyun */
87*4882a593Smuzhiyun switch (dma) {
88*4882a593Smuzhiyun case 0:
89*4882a593Smuzhiyun err = z8530_sync_open(d, &sv11->chanA);
90*4882a593Smuzhiyun break;
91*4882a593Smuzhiyun case 1:
92*4882a593Smuzhiyun err = z8530_sync_dma_open(d, &sv11->chanA);
93*4882a593Smuzhiyun break;
94*4882a593Smuzhiyun case 2:
95*4882a593Smuzhiyun err = z8530_sync_txdma_open(d, &sv11->chanA);
96*4882a593Smuzhiyun break;
97*4882a593Smuzhiyun }
98*4882a593Smuzhiyun
99*4882a593Smuzhiyun if (err)
100*4882a593Smuzhiyun return err;
101*4882a593Smuzhiyun
102*4882a593Smuzhiyun err = hdlc_open(d);
103*4882a593Smuzhiyun if (err) {
104*4882a593Smuzhiyun switch (dma) {
105*4882a593Smuzhiyun case 0:
106*4882a593Smuzhiyun z8530_sync_close(d, &sv11->chanA);
107*4882a593Smuzhiyun break;
108*4882a593Smuzhiyun case 1:
109*4882a593Smuzhiyun z8530_sync_dma_close(d, &sv11->chanA);
110*4882a593Smuzhiyun break;
111*4882a593Smuzhiyun case 2:
112*4882a593Smuzhiyun z8530_sync_txdma_close(d, &sv11->chanA);
113*4882a593Smuzhiyun break;
114*4882a593Smuzhiyun }
115*4882a593Smuzhiyun return err;
116*4882a593Smuzhiyun }
117*4882a593Smuzhiyun sv11->chanA.rx_function = hostess_input;
118*4882a593Smuzhiyun
119*4882a593Smuzhiyun /*
120*4882a593Smuzhiyun * Go go go
121*4882a593Smuzhiyun */
122*4882a593Smuzhiyun
123*4882a593Smuzhiyun netif_start_queue(d);
124*4882a593Smuzhiyun return 0;
125*4882a593Smuzhiyun }
126*4882a593Smuzhiyun
hostess_close(struct net_device * d)127*4882a593Smuzhiyun static int hostess_close(struct net_device *d)
128*4882a593Smuzhiyun {
129*4882a593Smuzhiyun struct z8530_dev *sv11 = dev_to_sv(d);
130*4882a593Smuzhiyun /*
131*4882a593Smuzhiyun * Discard new frames
132*4882a593Smuzhiyun */
133*4882a593Smuzhiyun sv11->chanA.rx_function = z8530_null_rx;
134*4882a593Smuzhiyun
135*4882a593Smuzhiyun hdlc_close(d);
136*4882a593Smuzhiyun netif_stop_queue(d);
137*4882a593Smuzhiyun
138*4882a593Smuzhiyun switch (dma) {
139*4882a593Smuzhiyun case 0:
140*4882a593Smuzhiyun z8530_sync_close(d, &sv11->chanA);
141*4882a593Smuzhiyun break;
142*4882a593Smuzhiyun case 1:
143*4882a593Smuzhiyun z8530_sync_dma_close(d, &sv11->chanA);
144*4882a593Smuzhiyun break;
145*4882a593Smuzhiyun case 2:
146*4882a593Smuzhiyun z8530_sync_txdma_close(d, &sv11->chanA);
147*4882a593Smuzhiyun break;
148*4882a593Smuzhiyun }
149*4882a593Smuzhiyun return 0;
150*4882a593Smuzhiyun }
151*4882a593Smuzhiyun
hostess_ioctl(struct net_device * d,struct ifreq * ifr,int cmd)152*4882a593Smuzhiyun static int hostess_ioctl(struct net_device *d, struct ifreq *ifr, int cmd)
153*4882a593Smuzhiyun {
154*4882a593Smuzhiyun /* struct z8530_dev *sv11=dev_to_sv(d);
155*4882a593Smuzhiyun z8530_ioctl(d,&sv11->chanA,ifr,cmd) */
156*4882a593Smuzhiyun return hdlc_ioctl(d, ifr, cmd);
157*4882a593Smuzhiyun }
158*4882a593Smuzhiyun
159*4882a593Smuzhiyun /*
160*4882a593Smuzhiyun * Passed network frames, fire them downwind.
161*4882a593Smuzhiyun */
162*4882a593Smuzhiyun
hostess_queue_xmit(struct sk_buff * skb,struct net_device * d)163*4882a593Smuzhiyun static netdev_tx_t hostess_queue_xmit(struct sk_buff *skb,
164*4882a593Smuzhiyun struct net_device *d)
165*4882a593Smuzhiyun {
166*4882a593Smuzhiyun return z8530_queue_xmit(&dev_to_sv(d)->chanA, skb);
167*4882a593Smuzhiyun }
168*4882a593Smuzhiyun
hostess_attach(struct net_device * dev,unsigned short encoding,unsigned short parity)169*4882a593Smuzhiyun static int hostess_attach(struct net_device *dev, unsigned short encoding,
170*4882a593Smuzhiyun unsigned short parity)
171*4882a593Smuzhiyun {
172*4882a593Smuzhiyun if (encoding == ENCODING_NRZ && parity == PARITY_CRC16_PR1_CCITT)
173*4882a593Smuzhiyun return 0;
174*4882a593Smuzhiyun return -EINVAL;
175*4882a593Smuzhiyun }
176*4882a593Smuzhiyun
177*4882a593Smuzhiyun /*
178*4882a593Smuzhiyun * Description block for a Comtrol Hostess SV11 card
179*4882a593Smuzhiyun */
180*4882a593Smuzhiyun
181*4882a593Smuzhiyun static const struct net_device_ops hostess_ops = {
182*4882a593Smuzhiyun .ndo_open = hostess_open,
183*4882a593Smuzhiyun .ndo_stop = hostess_close,
184*4882a593Smuzhiyun .ndo_start_xmit = hdlc_start_xmit,
185*4882a593Smuzhiyun .ndo_do_ioctl = hostess_ioctl,
186*4882a593Smuzhiyun };
187*4882a593Smuzhiyun
sv11_init(int iobase,int irq)188*4882a593Smuzhiyun static struct z8530_dev *sv11_init(int iobase, int irq)
189*4882a593Smuzhiyun {
190*4882a593Smuzhiyun struct z8530_dev *sv;
191*4882a593Smuzhiyun struct net_device *netdev;
192*4882a593Smuzhiyun /*
193*4882a593Smuzhiyun * Get the needed I/O space
194*4882a593Smuzhiyun */
195*4882a593Smuzhiyun
196*4882a593Smuzhiyun if (!request_region(iobase, 8, "Comtrol SV11")) {
197*4882a593Smuzhiyun pr_warn("I/O 0x%X already in use\n", iobase);
198*4882a593Smuzhiyun return NULL;
199*4882a593Smuzhiyun }
200*4882a593Smuzhiyun
201*4882a593Smuzhiyun sv = kzalloc(sizeof(struct z8530_dev), GFP_KERNEL);
202*4882a593Smuzhiyun if (!sv)
203*4882a593Smuzhiyun goto err_kzalloc;
204*4882a593Smuzhiyun
205*4882a593Smuzhiyun /*
206*4882a593Smuzhiyun * Stuff in the I/O addressing
207*4882a593Smuzhiyun */
208*4882a593Smuzhiyun
209*4882a593Smuzhiyun sv->active = 0;
210*4882a593Smuzhiyun
211*4882a593Smuzhiyun sv->chanA.ctrlio = iobase + 1;
212*4882a593Smuzhiyun sv->chanA.dataio = iobase + 3;
213*4882a593Smuzhiyun sv->chanB.ctrlio = -1;
214*4882a593Smuzhiyun sv->chanB.dataio = -1;
215*4882a593Smuzhiyun sv->chanA.irqs = &z8530_nop;
216*4882a593Smuzhiyun sv->chanB.irqs = &z8530_nop;
217*4882a593Smuzhiyun
218*4882a593Smuzhiyun outb(0, iobase + 4); /* DMA off */
219*4882a593Smuzhiyun
220*4882a593Smuzhiyun /* We want a fast IRQ for this device. Actually we'd like an even faster
221*4882a593Smuzhiyun IRQ ;) - This is one driver RtLinux is made for */
222*4882a593Smuzhiyun
223*4882a593Smuzhiyun if (request_irq(irq, z8530_interrupt, 0,
224*4882a593Smuzhiyun "Hostess SV11", sv) < 0) {
225*4882a593Smuzhiyun pr_warn("IRQ %d already in use\n", irq);
226*4882a593Smuzhiyun goto err_irq;
227*4882a593Smuzhiyun }
228*4882a593Smuzhiyun
229*4882a593Smuzhiyun sv->irq = irq;
230*4882a593Smuzhiyun sv->chanA.private = sv;
231*4882a593Smuzhiyun sv->chanA.dev = sv;
232*4882a593Smuzhiyun sv->chanB.dev = sv;
233*4882a593Smuzhiyun
234*4882a593Smuzhiyun if (dma) {
235*4882a593Smuzhiyun /*
236*4882a593Smuzhiyun * You can have DMA off or 1 and 3 thats the lot
237*4882a593Smuzhiyun * on the Comtrol.
238*4882a593Smuzhiyun */
239*4882a593Smuzhiyun sv->chanA.txdma = 3;
240*4882a593Smuzhiyun sv->chanA.rxdma = 1;
241*4882a593Smuzhiyun outb(0x03 | 0x08, iobase + 4); /* DMA on */
242*4882a593Smuzhiyun if (request_dma(sv->chanA.txdma, "Hostess SV/11 (TX)"))
243*4882a593Smuzhiyun goto err_txdma;
244*4882a593Smuzhiyun
245*4882a593Smuzhiyun if (dma == 1)
246*4882a593Smuzhiyun if (request_dma(sv->chanA.rxdma, "Hostess SV/11 (RX)"))
247*4882a593Smuzhiyun goto err_rxdma;
248*4882a593Smuzhiyun }
249*4882a593Smuzhiyun
250*4882a593Smuzhiyun /* Kill our private IRQ line the hostess can end up chattering
251*4882a593Smuzhiyun until the configuration is set */
252*4882a593Smuzhiyun disable_irq(irq);
253*4882a593Smuzhiyun
254*4882a593Smuzhiyun /*
255*4882a593Smuzhiyun * Begin normal initialise
256*4882a593Smuzhiyun */
257*4882a593Smuzhiyun
258*4882a593Smuzhiyun if (z8530_init(sv)) {
259*4882a593Smuzhiyun pr_err("Z8530 series device not found\n");
260*4882a593Smuzhiyun enable_irq(irq);
261*4882a593Smuzhiyun goto free_dma;
262*4882a593Smuzhiyun }
263*4882a593Smuzhiyun z8530_channel_load(&sv->chanB, z8530_dead_port);
264*4882a593Smuzhiyun if (sv->type == Z85C30)
265*4882a593Smuzhiyun z8530_channel_load(&sv->chanA, z8530_hdlc_kilostream);
266*4882a593Smuzhiyun else
267*4882a593Smuzhiyun z8530_channel_load(&sv->chanA, z8530_hdlc_kilostream_85230);
268*4882a593Smuzhiyun
269*4882a593Smuzhiyun enable_irq(irq);
270*4882a593Smuzhiyun
271*4882a593Smuzhiyun /*
272*4882a593Smuzhiyun * Now we can take the IRQ
273*4882a593Smuzhiyun */
274*4882a593Smuzhiyun
275*4882a593Smuzhiyun sv->chanA.netdevice = netdev = alloc_hdlcdev(sv);
276*4882a593Smuzhiyun if (!netdev)
277*4882a593Smuzhiyun goto free_dma;
278*4882a593Smuzhiyun
279*4882a593Smuzhiyun dev_to_hdlc(netdev)->attach = hostess_attach;
280*4882a593Smuzhiyun dev_to_hdlc(netdev)->xmit = hostess_queue_xmit;
281*4882a593Smuzhiyun netdev->netdev_ops = &hostess_ops;
282*4882a593Smuzhiyun netdev->base_addr = iobase;
283*4882a593Smuzhiyun netdev->irq = irq;
284*4882a593Smuzhiyun
285*4882a593Smuzhiyun if (register_hdlc_device(netdev)) {
286*4882a593Smuzhiyun pr_err("unable to register HDLC device\n");
287*4882a593Smuzhiyun free_netdev(netdev);
288*4882a593Smuzhiyun goto free_dma;
289*4882a593Smuzhiyun }
290*4882a593Smuzhiyun
291*4882a593Smuzhiyun z8530_describe(sv, "I/O", iobase);
292*4882a593Smuzhiyun sv->active = 1;
293*4882a593Smuzhiyun return sv;
294*4882a593Smuzhiyun
295*4882a593Smuzhiyun free_dma:
296*4882a593Smuzhiyun if (dma == 1)
297*4882a593Smuzhiyun free_dma(sv->chanA.rxdma);
298*4882a593Smuzhiyun err_rxdma:
299*4882a593Smuzhiyun if (dma)
300*4882a593Smuzhiyun free_dma(sv->chanA.txdma);
301*4882a593Smuzhiyun err_txdma:
302*4882a593Smuzhiyun free_irq(irq, sv);
303*4882a593Smuzhiyun err_irq:
304*4882a593Smuzhiyun kfree(sv);
305*4882a593Smuzhiyun err_kzalloc:
306*4882a593Smuzhiyun release_region(iobase, 8);
307*4882a593Smuzhiyun return NULL;
308*4882a593Smuzhiyun }
309*4882a593Smuzhiyun
sv11_shutdown(struct z8530_dev * dev)310*4882a593Smuzhiyun static void sv11_shutdown(struct z8530_dev *dev)
311*4882a593Smuzhiyun {
312*4882a593Smuzhiyun unregister_hdlc_device(dev->chanA.netdevice);
313*4882a593Smuzhiyun z8530_shutdown(dev);
314*4882a593Smuzhiyun free_irq(dev->irq, dev);
315*4882a593Smuzhiyun if (dma) {
316*4882a593Smuzhiyun if (dma == 1)
317*4882a593Smuzhiyun free_dma(dev->chanA.rxdma);
318*4882a593Smuzhiyun free_dma(dev->chanA.txdma);
319*4882a593Smuzhiyun }
320*4882a593Smuzhiyun release_region(dev->chanA.ctrlio - 1, 8);
321*4882a593Smuzhiyun free_netdev(dev->chanA.netdevice);
322*4882a593Smuzhiyun kfree(dev);
323*4882a593Smuzhiyun }
324*4882a593Smuzhiyun
325*4882a593Smuzhiyun static int io = 0x200;
326*4882a593Smuzhiyun static int irq = 9;
327*4882a593Smuzhiyun
328*4882a593Smuzhiyun module_param_hw(io, int, ioport, 0);
329*4882a593Smuzhiyun MODULE_PARM_DESC(io, "The I/O base of the Comtrol Hostess SV11 card");
330*4882a593Smuzhiyun module_param_hw(dma, int, dma, 0);
331*4882a593Smuzhiyun MODULE_PARM_DESC(dma, "Set this to 1 to use DMA1/DMA3 for TX/RX");
332*4882a593Smuzhiyun module_param_hw(irq, int, irq, 0);
333*4882a593Smuzhiyun MODULE_PARM_DESC(irq, "The interrupt line setting for the Comtrol Hostess SV11 card");
334*4882a593Smuzhiyun
335*4882a593Smuzhiyun MODULE_AUTHOR("Alan Cox");
336*4882a593Smuzhiyun MODULE_LICENSE("GPL");
337*4882a593Smuzhiyun MODULE_DESCRIPTION("Modular driver for the Comtrol Hostess SV11");
338*4882a593Smuzhiyun
339*4882a593Smuzhiyun static struct z8530_dev *sv11_unit;
340*4882a593Smuzhiyun
init_module(void)341*4882a593Smuzhiyun int init_module(void)
342*4882a593Smuzhiyun {
343*4882a593Smuzhiyun if ((sv11_unit = sv11_init(io, irq)) == NULL)
344*4882a593Smuzhiyun return -ENODEV;
345*4882a593Smuzhiyun return 0;
346*4882a593Smuzhiyun }
347*4882a593Smuzhiyun
cleanup_module(void)348*4882a593Smuzhiyun void cleanup_module(void)
349*4882a593Smuzhiyun {
350*4882a593Smuzhiyun if (sv11_unit)
351*4882a593Smuzhiyun sv11_shutdown(sv11_unit);
352*4882a593Smuzhiyun }
353