1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __LINUX_PARPORT_PC_H
3 #define __LINUX_PARPORT_PC_H
4 
5 #include <asm/io.h>
6 
7 /* --- register definitions ------------------------------- */
8 
9 #define ECONTROL(p) ((p)->base_hi + 0x2)
10 #define CONFIGB(p)  ((p)->base_hi + 0x1)
11 #define CONFIGA(p)  ((p)->base_hi + 0x0)
12 #define FIFO(p)     ((p)->base_hi + 0x0)
13 #define EPPDATA(p)  ((p)->base    + 0x4)
14 #define EPPADDR(p)  ((p)->base    + 0x3)
15 #define CONTROL(p)  ((p)->base    + 0x2)
16 #define STATUS(p)   ((p)->base    + 0x1)
17 #define DATA(p)     ((p)->base    + 0x0)
18 
19 struct parport_pc_private {
20 	/* Contents of CTR. */
21 	unsigned char ctr;
22 
23 	/* Bitmask of writable CTR bits. */
24 	unsigned char ctr_writable;
25 
26 	/* Whether or not there's an ECR. */
27 	int ecr;
28 
29 	/* Number of PWords that FIFO will hold. */
30 	int fifo_depth;
31 
32 	/* Number of bytes per portword. */
33 	int pword;
34 
35 	/* Not used yet. */
36 	int readIntrThreshold;
37 	int writeIntrThreshold;
38 
39 	/* buffer suitable for DMA, if DMA enabled */
40 	char *dma_buf;
41 	dma_addr_t dma_handle;
42 	struct list_head list;
43 	struct parport *port;
44 };
45 
46 struct parport_pc_via_data
47 {
48 	/* ISA PnP IRQ routing register 1 */
49 	u8 via_pci_parport_irq_reg;
50 	/* ISA PnP DMA request routing register */
51 	u8 via_pci_parport_dma_reg;
52 	/* Register and value to enable SuperIO configuration access */
53 	u8 via_pci_superio_config_reg;
54 	u8 via_pci_superio_config_data;
55 	/* SuperIO function register number */
56 	u8 viacfg_function;
57 	/* parallel port control register number */
58 	u8 viacfg_parport_control;
59 	/* Parallel port base address register */
60 	u8 viacfg_parport_base;
61 };
62 
parport_pc_write_data(struct parport * p,unsigned char d)63 static __inline__ void parport_pc_write_data(struct parport *p, unsigned char d)
64 {
65 #ifdef DEBUG_PARPORT
66 	printk (KERN_DEBUG "parport_pc_write_data(%p,0x%02x)\n", p, d);
67 #endif
68 	outb(d, DATA(p));
69 }
70 
parport_pc_read_data(struct parport * p)71 static __inline__ unsigned char parport_pc_read_data(struct parport *p)
72 {
73 	unsigned char val = inb (DATA (p));
74 #ifdef DEBUG_PARPORT
75 	printk (KERN_DEBUG "parport_pc_read_data(%p) = 0x%02x\n",
76 		p, val);
77 #endif
78 	return val;
79 }
80 
81 #ifdef DEBUG_PARPORT
dump_parport_state(char * str,struct parport * p)82 static inline void dump_parport_state (char *str, struct parport *p)
83 {
84 	/* here's hoping that reading these ports won't side-effect anything underneath */
85 	unsigned char ecr = inb (ECONTROL (p));
86 	unsigned char dcr = inb (CONTROL (p));
87 	unsigned char dsr = inb (STATUS (p));
88 	static const char *const ecr_modes[] = {"SPP", "PS2", "PPFIFO", "ECP", "xXx", "yYy", "TST", "CFG"};
89 	const struct parport_pc_private *priv = p->physport->private_data;
90 	int i;
91 
92 	printk (KERN_DEBUG "*** parport state (%s): ecr=[%s", str, ecr_modes[(ecr & 0xe0) >> 5]);
93 	if (ecr & 0x10) printk (",nErrIntrEn");
94 	if (ecr & 0x08) printk (",dmaEn");
95 	if (ecr & 0x04) printk (",serviceIntr");
96 	if (ecr & 0x02) printk (",f_full");
97 	if (ecr & 0x01) printk (",f_empty");
98 	for (i=0; i<2; i++) {
99 		printk ("]  dcr(%s)=[", i ? "soft" : "hard");
100 		dcr = i ? priv->ctr : inb (CONTROL (p));
101 
102 		if (dcr & 0x20) {
103 			printk ("rev");
104 		} else {
105 			printk ("fwd");
106 		}
107 		if (dcr & 0x10) printk (",ackIntEn");
108 		if (!(dcr & 0x08)) printk (",N-SELECT-IN");
109 		if (dcr & 0x04) printk (",N-INIT");
110 		if (!(dcr & 0x02)) printk (",N-AUTOFD");
111 		if (!(dcr & 0x01)) printk (",N-STROBE");
112 	}
113 	printk ("]  dsr=[");
114 	if (!(dsr & 0x80)) printk ("BUSY");
115 	if (dsr & 0x40) printk (",N-ACK");
116 	if (dsr & 0x20) printk (",PERROR");
117 	if (dsr & 0x10) printk (",SELECT");
118 	if (dsr & 0x08) printk (",N-FAULT");
119 	printk ("]\n");
120 	return;
121 }
122 #else	/* !DEBUG_PARPORT */
123 #define dump_parport_state(args...)
124 #endif	/* !DEBUG_PARPORT */
125 
126 /* __parport_pc_frob_control differs from parport_pc_frob_control in that
127  * it doesn't do any extra masking. */
__parport_pc_frob_control(struct parport * p,unsigned char mask,unsigned char val)128 static __inline__ unsigned char __parport_pc_frob_control (struct parport *p,
129 							   unsigned char mask,
130 							   unsigned char val)
131 {
132 	struct parport_pc_private *priv = p->physport->private_data;
133 	unsigned char ctr = priv->ctr;
134 #ifdef DEBUG_PARPORT
135 	printk (KERN_DEBUG
136 		"__parport_pc_frob_control(%02x,%02x): %02x -> %02x\n",
137 		mask, val, ctr, ((ctr & ~mask) ^ val) & priv->ctr_writable);
138 #endif
139 	ctr = (ctr & ~mask) ^ val;
140 	ctr &= priv->ctr_writable; /* only write writable bits. */
141 	outb (ctr, CONTROL (p));
142 	priv->ctr = ctr;	/* Update soft copy */
143 	return ctr;
144 }
145 
parport_pc_data_reverse(struct parport * p)146 static __inline__ void parport_pc_data_reverse (struct parport *p)
147 {
148 	__parport_pc_frob_control (p, 0x20, 0x20);
149 }
150 
parport_pc_data_forward(struct parport * p)151 static __inline__ void parport_pc_data_forward (struct parport *p)
152 {
153 	__parport_pc_frob_control (p, 0x20, 0x00);
154 }
155 
parport_pc_write_control(struct parport * p,unsigned char d)156 static __inline__ void parport_pc_write_control (struct parport *p,
157 						 unsigned char d)
158 {
159 	const unsigned char wm = (PARPORT_CONTROL_STROBE |
160 				  PARPORT_CONTROL_AUTOFD |
161 				  PARPORT_CONTROL_INIT |
162 				  PARPORT_CONTROL_SELECT);
163 
164 	/* Take this out when drivers have adapted to newer interface. */
165 	if (d & 0x20) {
166 		printk (KERN_DEBUG "%s (%s): use data_reverse for this!\n",
167 			p->name, p->cad->name);
168 		parport_pc_data_reverse (p);
169 	}
170 
171 	__parport_pc_frob_control (p, wm, d & wm);
172 }
173 
parport_pc_read_control(struct parport * p)174 static __inline__ unsigned char parport_pc_read_control(struct parport *p)
175 {
176 	const unsigned char rm = (PARPORT_CONTROL_STROBE |
177 				  PARPORT_CONTROL_AUTOFD |
178 				  PARPORT_CONTROL_INIT |
179 				  PARPORT_CONTROL_SELECT);
180 	const struct parport_pc_private *priv = p->physport->private_data;
181 	return priv->ctr & rm; /* Use soft copy */
182 }
183 
parport_pc_frob_control(struct parport * p,unsigned char mask,unsigned char val)184 static __inline__ unsigned char parport_pc_frob_control (struct parport *p,
185 							 unsigned char mask,
186 							 unsigned char val)
187 {
188 	const unsigned char wm = (PARPORT_CONTROL_STROBE |
189 				  PARPORT_CONTROL_AUTOFD |
190 				  PARPORT_CONTROL_INIT |
191 				  PARPORT_CONTROL_SELECT);
192 
193 	/* Take this out when drivers have adapted to newer interface. */
194 	if (mask & 0x20) {
195 		printk (KERN_DEBUG "%s (%s): use data_%s for this!\n",
196 			p->name, p->cad->name,
197 			(val & 0x20) ? "reverse" : "forward");
198 		if (val & 0x20)
199 			parport_pc_data_reverse (p);
200 		else
201 			parport_pc_data_forward (p);
202 	}
203 
204 	/* Restrict mask and val to control lines. */
205 	mask &= wm;
206 	val &= wm;
207 
208 	return __parport_pc_frob_control (p, mask, val);
209 }
210 
parport_pc_read_status(struct parport * p)211 static __inline__ unsigned char parport_pc_read_status(struct parport *p)
212 {
213 	return inb(STATUS(p));
214 }
215 
216 
parport_pc_disable_irq(struct parport * p)217 static __inline__ void parport_pc_disable_irq(struct parport *p)
218 {
219 	__parport_pc_frob_control (p, 0x10, 0x00);
220 }
221 
parport_pc_enable_irq(struct parport * p)222 static __inline__ void parport_pc_enable_irq(struct parport *p)
223 {
224 	__parport_pc_frob_control (p, 0x10, 0x10);
225 }
226 
227 extern void parport_pc_release_resources(struct parport *p);
228 
229 extern int parport_pc_claim_resources(struct parport *p);
230 
231 /* PCMCIA code will want to get us to look at a port.  Provide a mechanism. */
232 extern struct parport *parport_pc_probe_port(unsigned long base,
233 					     unsigned long base_hi,
234 					     int irq, int dma,
235 					     struct device *dev,
236 					     int irqflags);
237 extern void parport_pc_unregister_port(struct parport *p);
238 
239 #endif
240