1 /*
2  *  Copyright (c) 1997-1998  Mark Lord
3  *  Copyright (c) 2007       MontaVista Software, Inc. <source@mvista.com>
4  *
5  *  May be copied or modified under the terms of the GNU General Public License
6  *
7  *  June 22, 2004 - get rid of check_region
8  *                   - Jesper Juhl
9  *
10  */
11 
12 /*
13  * This module provides support for the bus-master IDE DMA function
14  * of the Tekram TRM290 chip, used on a variety of PCI IDE add-on boards,
15  * including a "Precision Instruments" board.  The TRM290 pre-dates
16  * the sff-8038 standard (ide-dma.c) by a few months, and differs
17  * significantly enough to warrant separate routines for some functions,
18  * while re-using others from ide-dma.c.
19  *
20  * EXPERIMENTAL!  It works for me (a sample of one).
21  *
22  * Works reliably for me in DMA mode (READs only),
23  * DMA WRITEs are disabled by default (see #define below);
24  *
25  * DMA is not enabled automatically for this chipset,
26  * but can be turned on manually (with "hdparm -d1") at run time.
27  *
28  * I need volunteers with "spare" drives for further testing
29  * and development, and maybe to help figure out the peculiarities.
30  * Even knowing the registers (below), some things behave strangely.
31  */
32 
33 #define TRM290_NO_DMA_WRITES	/* DMA writes seem unreliable sometimes */
34 
35 /*
36  * TRM-290 PCI-IDE2 Bus Master Chip
37  * ================================
38  * The configuration registers are addressed in normal I/O port space
39  * and are used as follows:
40  *
41  * trm290_base depends on jumper settings, and is probed for by ide-dma.c
42  *
43  * trm290_base+2 when WRITTEN: chiptest register (byte, write-only)
44  *	bit7 must always be written as "1"
45  *	bits6-2 undefined
46  *	bit1 1=legacy_compatible_mode, 0=native_pci_mode
47  *	bit0 1=test_mode, 0=normal(default)
48  *
49  * trm290_base+2 when READ: status register (byte, read-only)
50  *	bits7-2 undefined
51  *	bit1 channel0 busmaster interrupt status 0=none, 1=asserted
52  *	bit0 channel0 interrupt status 0=none, 1=asserted
53  *
54  * trm290_base+3 Interrupt mask register
55  *	bits7-5 undefined
56  *	bit4 legacy_header: 1=present, 0=absent
57  *	bit3 channel1 busmaster interrupt status 0=none, 1=asserted (read only)
58  *	bit2 channel1 interrupt status 0=none, 1=asserted (read only)
59  *	bit1 channel1 interrupt mask: 1=masked, 0=unmasked(default)
60  *	bit0 channel0 interrupt mask: 1=masked, 0=unmasked(default)
61  *
62  * trm290_base+1 "CPR" Config Pointer Register (byte)
63  *	bit7 1=autoincrement CPR bits 2-0 after each access of CDR
64  *	bit6 1=min. 1 wait-state posted write cycle (default), 0=0 wait-state
65  *	bit5 0=enabled master burst access (default), 1=disable  (write only)
66  *	bit4 PCI DEVSEL# timing select: 1=medium(default), 0=fast
67  *	bit3 0=primary IDE channel, 1=secondary IDE channel
68  *	bits2-0 register index for accesses through CDR port
69  *
70  * trm290_base+0 "CDR" Config Data Register (word)
71  *	two sets of seven config registers,
72  *	selected by CPR bit 3 (channel) and CPR bits 2-0 (index 0 to 6),
73  *	each index defined below:
74  *
75  * Index-0 Base address register for command block (word)
76  *	defaults: 0x1f0 for primary, 0x170 for secondary
77  *
78  * Index-1 general config register (byte)
79  *	bit7 1=DMA enable, 0=DMA disable
80  *	bit6 1=activate IDE_RESET, 0=no action (default)
81  *	bit5 1=enable IORDY, 0=disable IORDY (default)
82  *	bit4 0=16-bit data port(default), 1=8-bit (XT) data port
83  *	bit3 interrupt polarity: 1=active_low, 0=active_high(default)
84  *	bit2 power-saving-mode(?): 1=enable, 0=disable(default) (write only)
85  *	bit1 bus_master_mode(?): 1=enable, 0=disable(default)
86  *	bit0 enable_io_ports: 1=enable(default), 0=disable
87  *
88  * Index-2 read-ahead counter preload bits 0-7 (byte, write only)
89  *	bits7-0 bits7-0 of readahead count
90  *
91  * Index-3 read-ahead config register (byte, write only)
92  *	bit7 1=enable_readahead, 0=disable_readahead(default)
93  *	bit6 1=clear_FIFO, 0=no_action
94  *	bit5 undefined
95  *	bit4 mode4 timing control: 1=enable, 0=disable(default)
96  *	bit3 undefined
97  *	bit2 undefined
98  *	bits1-0 bits9-8 of read-ahead count
99  *
100  * Index-4 base address register for control block (word)
101  *	defaults: 0x3f6 for primary, 0x376 for secondary
102  *
103  * Index-5 data port timings (shared by both drives) (byte)
104  *	standard PCI "clk" (clock) counts, default value = 0xf5
105  *
106  *	bits7-6 setup time:  00=1clk, 01=2clk, 10=3clk, 11=4clk
107  *	bits5-3 hold time:	000=1clk, 001=2clk, 010=3clk,
108  *				011=4clk, 100=5clk, 101=6clk,
109  *				110=8clk, 111=12clk
110  *	bits2-0 active time:	000=2clk, 001=3clk, 010=4clk,
111  *				011=5clk, 100=6clk, 101=8clk,
112  *				110=12clk, 111=16clk
113  *
114  * Index-6 command/control port timings (shared by both drives) (byte)
115  *	same layout as Index-5, default value = 0xde
116  *
117  * Suggested CDR programming for PIO mode0 (600ns):
118  *	0x01f0,0x21,0xff,0x80,0x03f6,0xf5,0xde	; primary
119  *	0x0170,0x21,0xff,0x80,0x0376,0xf5,0xde	; secondary
120  *
121  * Suggested CDR programming for PIO mode3 (180ns):
122  *	0x01f0,0x21,0xff,0x80,0x03f6,0x09,0xde	; primary
123  *	0x0170,0x21,0xff,0x80,0x0376,0x09,0xde	; secondary
124  *
125  * Suggested CDR programming for PIO mode4 (120ns):
126  *	0x01f0,0x21,0xff,0x80,0x03f6,0x00,0xde	; primary
127  *	0x0170,0x21,0xff,0x80,0x0376,0x00,0xde	; secondary
128  *
129  */
130 
131 #include <linux/types.h>
132 #include <linux/module.h>
133 #include <linux/kernel.h>
134 #include <linux/ioport.h>
135 #include <linux/interrupt.h>
136 #include <linux/blkdev.h>
137 #include <linux/init.h>
138 #include <linux/pci.h>
139 #include <linux/ide.h>
140 
141 #include <asm/io.h>
142 
143 #define DRV_NAME "trm290"
144 
trm290_prepare_drive(ide_drive_t * drive,unsigned int use_dma)145 static void trm290_prepare_drive (ide_drive_t *drive, unsigned int use_dma)
146 {
147 	ide_hwif_t *hwif = drive->hwif;
148 	u16 reg = 0;
149 	unsigned long flags;
150 
151 	/* select PIO or DMA */
152 	reg = use_dma ? (0x21 | 0x82) : (0x21 & ~0x82);
153 
154 	local_irq_save(flags);
155 
156 	if (reg != hwif->select_data) {
157 		hwif->select_data = reg;
158 		/* set PIO/DMA */
159 		outb(0x51 | (hwif->channel << 3), hwif->config_data + 1);
160 		outw(reg & 0xff, hwif->config_data);
161 	}
162 
163 	/* enable IRQ if not probing */
164 	if (drive->dev_flags & IDE_DFLAG_PRESENT) {
165 		reg = inw(hwif->config_data + 3);
166 		reg &= 0x13;
167 		reg &= ~(1 << hwif->channel);
168 		outw(reg, hwif->config_data + 3);
169 	}
170 
171 	local_irq_restore(flags);
172 }
173 
trm290_dev_select(ide_drive_t * drive)174 static void trm290_dev_select(ide_drive_t *drive)
175 {
176 	trm290_prepare_drive(drive, !!(drive->dev_flags & IDE_DFLAG_USING_DMA));
177 
178 	outb(drive->select | ATA_DEVICE_OBS, drive->hwif->io_ports.device_addr);
179 }
180 
trm290_dma_check(ide_drive_t * drive,struct ide_cmd * cmd)181 static int trm290_dma_check(ide_drive_t *drive, struct ide_cmd *cmd)
182 {
183 	if (cmd->tf_flags & IDE_TFLAG_WRITE) {
184 #ifdef TRM290_NO_DMA_WRITES
185 		/* always use PIO for writes */
186 		return 1;
187 #endif
188 	}
189 	return 0;
190 }
191 
trm290_dma_setup(ide_drive_t * drive,struct ide_cmd * cmd)192 static int trm290_dma_setup(ide_drive_t *drive, struct ide_cmd *cmd)
193 {
194 	ide_hwif_t *hwif = drive->hwif;
195 	unsigned int count, rw = (cmd->tf_flags & IDE_TFLAG_WRITE) ? 1 : 2;
196 
197 	count = ide_build_dmatable(drive, cmd);
198 	if (count == 0)
199 		/* try PIO instead of DMA */
200 		return 1;
201 
202 	outl(hwif->dmatable_dma | rw, hwif->dma_base);
203 	/* start DMA */
204 	outw(count * 2 - 1, hwif->dma_base + 2);
205 
206 	return 0;
207 }
208 
trm290_dma_start(ide_drive_t * drive)209 static void trm290_dma_start(ide_drive_t *drive)
210 {
211 	trm290_prepare_drive(drive, 1);
212 }
213 
trm290_dma_end(ide_drive_t * drive)214 static int trm290_dma_end(ide_drive_t *drive)
215 {
216 	u16 status = inw(drive->hwif->dma_base + 2);
217 
218 	trm290_prepare_drive(drive, 0);
219 
220 	return status != 0x00ff;
221 }
222 
trm290_dma_test_irq(ide_drive_t * drive)223 static int trm290_dma_test_irq(ide_drive_t *drive)
224 {
225 	u16 status = inw(drive->hwif->dma_base + 2);
226 
227 	return status == 0x00ff;
228 }
229 
trm290_dma_host_set(ide_drive_t * drive,int on)230 static void trm290_dma_host_set(ide_drive_t *drive, int on)
231 {
232 }
233 
init_hwif_trm290(ide_hwif_t * hwif)234 static void init_hwif_trm290(ide_hwif_t *hwif)
235 {
236 	struct pci_dev *dev	= to_pci_dev(hwif->dev);
237 	unsigned int  cfg_base	= pci_resource_start(dev, 4);
238 	unsigned long flags;
239 	u8 reg = 0;
240 
241 	if ((dev->class & 5) && cfg_base)
242 		printk(KERN_INFO DRV_NAME " %s: chip", pci_name(dev));
243 	else {
244 		cfg_base = 0x3df0;
245 		printk(KERN_INFO DRV_NAME " %s: using default", pci_name(dev));
246 	}
247 	printk(KERN_CONT " config base at 0x%04x\n", cfg_base);
248 	hwif->config_data = cfg_base;
249 	hwif->dma_base = (cfg_base + 4) ^ (hwif->channel ? 0x80 : 0);
250 
251 	printk(KERN_INFO "    %s: BM-DMA at 0x%04lx-0x%04lx\n",
252 	       hwif->name, hwif->dma_base, hwif->dma_base + 3);
253 
254 	if (ide_allocate_dma_engine(hwif))
255 		return;
256 
257 	local_irq_save(flags);
258 	/* put config reg into first byte of hwif->select_data */
259 	outb(0x51 | (hwif->channel << 3), hwif->config_data + 1);
260 	/* select PIO as default */
261 	hwif->select_data = 0x21;
262 	outb(hwif->select_data, hwif->config_data);
263 	/* get IRQ info */
264 	reg = inb(hwif->config_data + 3);
265 	/* mask IRQs for both ports */
266 	reg = (reg & 0x10) | 0x03;
267 	outb(reg, hwif->config_data + 3);
268 	local_irq_restore(flags);
269 
270 	if (reg & 0x10)
271 		/* legacy mode */
272 		hwif->irq = hwif->channel ? 15 : 14;
273 
274 #if 1
275 	{
276 	/*
277 	 * My trm290-based card doesn't seem to work with all possible values
278 	 * for the control basereg, so this kludge ensures that we use only
279 	 * values that are known to work.  Ugh.		-ml
280 	 */
281 		u16 new, old, compat = hwif->channel ? 0x374 : 0x3f4;
282 		static u16 next_offset = 0;
283 		u8 old_mask;
284 
285 		outb(0x54 | (hwif->channel << 3), hwif->config_data + 1);
286 		old = inw(hwif->config_data);
287 		old &= ~1;
288 		old_mask = inb(old + 2);
289 		if (old != compat && old_mask == 0xff) {
290 			/* leave lower 10 bits untouched */
291 			compat += (next_offset += 0x400);
292 			hwif->io_ports.ctl_addr = compat + 2;
293 			outw(compat | 1, hwif->config_data);
294 			new = inw(hwif->config_data);
295 			printk(KERN_INFO "%s: control basereg workaround: "
296 				"old=0x%04x, new=0x%04x\n",
297 				hwif->name, old, new & ~1);
298 		}
299 	}
300 #endif
301 }
302 
303 static const struct ide_tp_ops trm290_tp_ops = {
304 	.exec_command		= ide_exec_command,
305 	.read_status		= ide_read_status,
306 	.read_altstatus		= ide_read_altstatus,
307 	.write_devctl		= ide_write_devctl,
308 
309 	.dev_select		= trm290_dev_select,
310 	.tf_load		= ide_tf_load,
311 	.tf_read		= ide_tf_read,
312 
313 	.input_data		= ide_input_data,
314 	.output_data		= ide_output_data,
315 };
316 
317 static const struct ide_dma_ops trm290_dma_ops = {
318 	.dma_host_set		= trm290_dma_host_set,
319 	.dma_setup 		= trm290_dma_setup,
320 	.dma_start 		= trm290_dma_start,
321 	.dma_end		= trm290_dma_end,
322 	.dma_test_irq		= trm290_dma_test_irq,
323 	.dma_lost_irq		= ide_dma_lost_irq,
324 	.dma_check		= trm290_dma_check,
325 };
326 
327 static const struct ide_port_info trm290_chipset = {
328 	.name		= DRV_NAME,
329 	.init_hwif	= init_hwif_trm290,
330 	.tp_ops 	= &trm290_tp_ops,
331 	.dma_ops	= &trm290_dma_ops,
332 	.host_flags	= IDE_HFLAG_TRM290 |
333 			  IDE_HFLAG_NO_ATAPI_DMA |
334 #if 0 /* play it safe for now */
335 			  IDE_HFLAG_TRUST_BIOS_FOR_DMA |
336 #endif
337 			  IDE_HFLAG_NO_AUTODMA |
338 			  IDE_HFLAG_NO_LBA48,
339 };
340 
trm290_init_one(struct pci_dev * dev,const struct pci_device_id * id)341 static int trm290_init_one(struct pci_dev *dev, const struct pci_device_id *id)
342 {
343 	return ide_pci_init_one(dev, &trm290_chipset, NULL);
344 }
345 
346 static const struct pci_device_id trm290_pci_tbl[] = {
347 	{ PCI_VDEVICE(TEKRAM, PCI_DEVICE_ID_TEKRAM_DC290), 0 },
348 	{ 0, },
349 };
350 MODULE_DEVICE_TABLE(pci, trm290_pci_tbl);
351 
352 static struct pci_driver trm290_pci_driver = {
353 	.name		= "TRM290_IDE",
354 	.id_table	= trm290_pci_tbl,
355 	.probe		= trm290_init_one,
356 	.remove		= ide_pci_remove,
357 };
358 
trm290_ide_init(void)359 static int __init trm290_ide_init(void)
360 {
361 	return ide_pci_register_driver(&trm290_pci_driver);
362 }
363 
trm290_ide_exit(void)364 static void __exit trm290_ide_exit(void)
365 {
366 	pci_unregister_driver(&trm290_pci_driver);
367 }
368 
369 module_init(trm290_ide_init);
370 module_exit(trm290_ide_exit);
371 
372 MODULE_AUTHOR("Mark Lord");
373 MODULE_DESCRIPTION("PCI driver module for Tekram TRM290 IDE");
374 MODULE_LICENSE("GPL");
375