staging: comedi: pcmuio: fix possible NULL deref on detach
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / staging / comedi / drivers / s626.h
1 /*
2 comedi/drivers/s626.h
3 Sensoray s626 Comedi driver, header file
4
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 2000 David A. Schleef <ds@schleef.org>
7
8 Based on Sensoray Model 626 Linux driver Version 0.2
9 Copyright (C) 2002-2004 Sensoray Co., Inc.
10
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
15
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24
25 */
26
27 /*
28 Driver: s626.o (s626.ko)
29 Description: Sensoray 626 driver
30 Devices: Sensoray s626
31 Authors: Gianluca Palli <gpalli@deis.unibo.it>,
32 Updated: Thu, 12 Jul 2005
33 Status: experimental
34
35 Configuration Options:
36 analog input:
37 none
38
39 analog output:
40 none
41
42 digital channel:
43 s626 has 3 dio subdevices (2,3 and 4) each with 16 i/o channels
44 supported configuration options:
45 INSN_CONFIG_DIO_QUERY
46 COMEDI_INPUT
47 COMEDI_OUTPUT
48
49 encoder:
50 Every channel must be configured before reading.
51
52 Example code
53
54 insn.insn=INSN_CONFIG; // configuration instruction
55 insn.n=1; // number of operation (must be 1)
56 insn.data=&initialvalue; // initial value loaded into encoder
57 // during configuration
58 insn.subdev=5; // encoder subdevice
59 insn.chanspec=CR_PACK(encoder_channel,0,AREF_OTHER); // encoder_channel
60 // to configure
61
62 comedi_do_insn(cf,&insn); // executing configuration
63 */
64
65 #if !defined(TRUE)
66 #define TRUE (1)
67 #endif
68
69 #if !defined(FALSE)
70 #define FALSE (0)
71 #endif
72
73 #include <linux/slab.h>
74
75 #define S626_SIZE 0x0200
76 #define DMABUF_SIZE 4096 /* 4k pages */
77
78 #define S626_ADC_CHANNELS 16
79 #define S626_DAC_CHANNELS 4
80 #define S626_ENCODER_CHANNELS 6
81 #define S626_DIO_CHANNELS 48
82 #define S626_DIO_BANKS 3 /* Number of DIO groups. */
83 #define S626_DIO_EXTCHANS 40 /* Number of */
84 /* extended-capability */
85 /* DIO channels. */
86
87 #define NUM_TRIMDACS 12 /* Number of valid TrimDAC channels. */
88
89 /* PCI bus interface types. */
90 #define INTEL 1 /* Intel bus type. */
91 #define MOTOROLA 2 /* Motorola bus type. */
92
93 #define PLATFORM INTEL /* *** SELECT PLATFORM TYPE *** */
94
95 #define RANGE_5V 0x10 /* +/-5V range */
96 #define RANGE_10V 0x00 /* +/-10V range */
97
98 #define EOPL 0x80 /* End of ADC poll list marker. */
99 #define GSEL_BIPOLAR5V 0x00F0 /* LP_GSEL setting for 5V bipolar range. */
100 #define GSEL_BIPOLAR10V 0x00A0 /* LP_GSEL setting for 10V bipolar range. */
101
102 /* Error codes that must be visible to this base class. */
103 #define ERR_ILLEGAL_PARM 0x00010000 /* Illegal function parameter value was specified. */
104 #define ERR_I2C 0x00020000 /* I2C error. */
105 #define ERR_COUNTERSETUP 0x00200000 /* Illegal setup specified for counter channel. */
106 #define ERR_DEBI_TIMEOUT 0x00400000 /* DEBI transfer timed out. */
107
108 /* Organization (physical order) and size (in DWORDs) of logical DMA buffers contained by ANA_DMABUF. */
109 #define ADC_DMABUF_DWORDS 40 /* ADC DMA buffer must hold 16 samples, plus pre/post garbage samples. */
110 #define DAC_WDMABUF_DWORDS 1 /* DAC output DMA buffer holds a single sample. */
111
112 /* All remaining space in 4KB DMA buffer is available for the RPS1 program. */
113
114 /* Address offsets, in DWORDS, from base of DMA buffer. */
115 #define DAC_WDMABUF_OS ADC_DMABUF_DWORDS
116
117 /* Interrupt enab bit in ISR and IER. */
118 #define IRQ_GPIO3 0x00000040 /* IRQ enable for GPIO3. */
119 #define IRQ_RPS1 0x10000000
120 #define ISR_AFOU 0x00000800
121 /* Audio fifo under/overflow detected. */
122
123 #define IRQ_COINT1A 0x0400 /* conter 1A overflow interrupt mask */
124 #define IRQ_COINT1B 0x0800 /* conter 1B overflow interrupt mask */
125 #define IRQ_COINT2A 0x1000 /* conter 2A overflow interrupt mask */
126 #define IRQ_COINT2B 0x2000 /* conter 2B overflow interrupt mask */
127 #define IRQ_COINT3A 0x4000 /* conter 3A overflow interrupt mask */
128 #define IRQ_COINT3B 0x8000 /* conter 3B overflow interrupt mask */
129
130 /* RPS command codes. */
131 #define RPS_CLRSIGNAL 0x00000000 /* CLEAR SIGNAL */
132 #define RPS_SETSIGNAL 0x10000000 /* SET SIGNAL */
133 #define RPS_NOP 0x00000000 /* NOP */
134 #define RPS_PAUSE 0x20000000 /* PAUSE */
135 #define RPS_UPLOAD 0x40000000 /* UPLOAD */
136 #define RPS_JUMP 0x80000000 /* JUMP */
137 #define RPS_LDREG 0x90000100 /* LDREG (1 uint32_t only) */
138 #define RPS_STREG 0xA0000100 /* STREG (1 uint32_t only) */
139 #define RPS_STOP 0x50000000 /* STOP */
140 #define RPS_IRQ 0x60000000 /* IRQ */
141
142 #define RPS_LOGICAL_OR 0x08000000 /* Logical OR conditionals. */
143 #define RPS_INVERT 0x04000000 /* Test for negated semaphores. */
144 #define RPS_DEBI 0x00000002 /* DEBI done */
145
146 #define RPS_SIG0 0x00200000 /* RPS semaphore 0 (used by ADC). */
147 #define RPS_SIG1 0x00400000 /* RPS semaphore 1 (used by DAC). */
148 #define RPS_SIG2 0x00800000 /* RPS semaphore 2 (not used). */
149 #define RPS_GPIO2 0x00080000 /* RPS GPIO2 */
150 #define RPS_GPIO3 0x00100000 /* RPS GPIO3 */
151
152 #define RPS_SIGADC RPS_SIG0 /* Trigger/status for ADC's RPS program. */
153 #define RPS_SIGDAC RPS_SIG1 /* Trigger/status for DAC's RPS program. */
154
155 /* RPS clock parameters. */
156 #define RPSCLK_SCALAR 8 /* This is apparent ratio of PCI/RPS clks (undocumented!!). */
157 #define RPSCLK_PER_US (33 / RPSCLK_SCALAR) /* Number of RPS clocks in one microsecond. */
158
159 /* Event counter source addresses. */
160 #define SBA_RPS_A0 0x27 /* Time of RPS0 busy, in PCI clocks. */
161
162 /* GPIO constants. */
163 #define GPIO_BASE 0x10004000 /* GPIO 0,2,3 = inputs, GPIO3 = IRQ; GPIO1 = out. */
164 #define GPIO1_LO 0x00000000 /* GPIO1 set to LOW. */
165 #define GPIO1_HI 0x00001000 /* GPIO1 set to HIGH. */
166
167 /* Primary Status Register (PSR) constants. */
168 #define PSR_DEBI_E 0x00040000 /* DEBI event flag. */
169 #define PSR_DEBI_S 0x00080000 /* DEBI status flag. */
170 #define PSR_A2_IN 0x00008000 /* Audio output DMA2 protection address reached. */
171 #define PSR_AFOU 0x00000800 /* Audio FIFO under/overflow detected. */
172 #define PSR_GPIO2 0x00000020 /* GPIO2 input pin: 0=AdcBusy, 1=AdcIdle. */
173 #define PSR_EC0S 0x00000001 /* Event counter 0 threshold reached. */
174
175 /* Secondary Status Register (SSR) constants. */
176 #define SSR_AF2_OUT 0x00000200 /* Audio 2 output FIFO under/overflow detected. */
177
178 /* Master Control Register 1 (MC1) constants. */
179 #define MC1_SOFT_RESET 0x80000000 /* Invoke 7146 soft reset. */
180 #define MC1_SHUTDOWN 0x3FFF0000 /* Shut down all MC1-controlled enables. */
181
182 #define MC1_ERPS1 0x2000 /* enab/disable RPS task 1. */
183 #define MC1_ERPS0 0x1000 /* enab/disable RPS task 0. */
184 #define MC1_DEBI 0x0800 /* enab/disable DEBI pins. */
185 #define MC1_AUDIO 0x0200 /* enab/disable audio port pins. */
186 #define MC1_I2C 0x0100 /* enab/disable I2C interface. */
187 #define MC1_A2OUT 0x0008 /* enab/disable transfer on A2 out. */
188 #define MC1_A2IN 0x0004 /* enab/disable transfer on A2 in. */
189 #define MC1_A1IN 0x0001 /* enab/disable transfer on A1 in. */
190
191 /* Master Control Register 2 (MC2) constants. */
192 #define MC2_UPLD_DEBIq 0x00020002 /* Upload DEBI registers. */
193 #define MC2_UPLD_IICq 0x00010001 /* Upload I2C registers. */
194 #define MC2_RPSSIG2_ONq 0x20002000 /* Assert RPS_SIG2. */
195 #define MC2_RPSSIG1_ONq 0x10001000 /* Assert RPS_SIG1. */
196 #define MC2_RPSSIG0_ONq 0x08000800 /* Assert RPS_SIG0. */
197 #define MC2_UPLD_DEBI_MASKq 0x00000002 /* Upload DEBI mask. */
198 #define MC2_UPLD_IIC_MASKq 0x00000001 /* Upload I2C mask. */
199 #define MC2_RPSSIG2_MASKq 0x00002000 /* RPS_SIG2 bit mask. */
200 #define MC2_RPSSIG1_MASKq 0x00001000 /* RPS_SIG1 bit mask. */
201 #define MC2_RPSSIG0_MASKq 0x00000800 /* RPS_SIG0 bit mask. */
202
203 #define MC2_DELAYTRIG_4USq MC2_RPSSIG1_ON
204 #define MC2_DELAYBUSY_4USq MC2_RPSSIG1_MASK
205
206 #define MC2_DELAYTRIG_6USq MC2_RPSSIG2_ON
207 #define MC2_DELAYBUSY_6USq MC2_RPSSIG2_MASK
208
209 #define MC2_UPLD_DEBI 0x0002 /* Upload DEBI. */
210 #define MC2_UPLD_IIC 0x0001 /* Upload I2C. */
211 #define MC2_RPSSIG2 0x2000 /* RPS signal 2 (not used). */
212 #define MC2_RPSSIG1 0x1000 /* RPS signal 1 (DAC RPS busy). */
213 #define MC2_RPSSIG0 0x0800 /* RPS signal 0 (ADC RPS busy). */
214
215 #define MC2_ADC_RPS MC2_RPSSIG0 /* ADC RPS busy. */
216 #define MC2_DAC_RPS MC2_RPSSIG1 /* DAC RPS busy. */
217
218 /* ***** oldies ***** */
219 #define MC2_UPLD_DEBIQ 0x00020002 /* Upload DEBI registers. */
220 #define MC2_UPLD_IICQ 0x00010001 /* Upload I2C registers. */
221
222 /* PCI BUS (SAA7146) REGISTER ADDRESS OFFSETS */
223 #define P_PCI_BT_A 0x004C /* Audio DMA burst/threshold control. */
224 #define P_DEBICFG 0x007C /* DEBI configuration. */
225 #define P_DEBICMD 0x0080 /* DEBI command. */
226 #define P_DEBIPAGE 0x0084 /* DEBI page. */
227 #define P_DEBIAD 0x0088 /* DEBI target address. */
228 #define P_I2CCTRL 0x008C /* I2C control. */
229 #define P_I2CSTAT 0x0090 /* I2C status. */
230 #define P_BASEA2_IN 0x00AC /* Audio input 2 base physical DMAbuf
231 * address. */
232 #define P_PROTA2_IN 0x00B0 /* Audio input 2 physical DMAbuf
233 * protection address. */
234 #define P_PAGEA2_IN 0x00B4 /* Audio input 2 paging attributes. */
235 #define P_BASEA2_OUT 0x00B8 /* Audio output 2 base physical DMAbuf
236 * address. */
237 #define P_PROTA2_OUT 0x00BC /* Audio output 2 physical DMAbuf
238 * protection address. */
239 #define P_PAGEA2_OUT 0x00C0 /* Audio output 2 paging attributes. */
240 #define P_RPSPAGE0 0x00C4 /* RPS0 page. */
241 #define P_RPSPAGE1 0x00C8 /* RPS1 page. */
242 #define P_RPS0_TOUT 0x00D4 /* RPS0 time-out. */
243 #define P_RPS1_TOUT 0x00D8 /* RPS1 time-out. */
244 #define P_IER 0x00DC /* Interrupt enable. */
245 #define P_GPIO 0x00E0 /* General-purpose I/O. */
246 #define P_EC1SSR 0x00E4 /* Event counter set 1 source select. */
247 #define P_ECT1R 0x00EC /* Event counter threshold set 1. */
248 #define P_ACON1 0x00F4 /* Audio control 1. */
249 #define P_ACON2 0x00F8 /* Audio control 2. */
250 #define P_MC1 0x00FC /* Master control 1. */
251 #define P_MC2 0x0100 /* Master control 2. */
252 #define P_RPSADDR0 0x0104 /* RPS0 instruction pointer. */
253 #define P_RPSADDR1 0x0108 /* RPS1 instruction pointer. */
254 #define P_ISR 0x010C /* Interrupt status. */
255 #define P_PSR 0x0110 /* Primary status. */
256 #define P_SSR 0x0114 /* Secondary status. */
257 #define P_EC1R 0x0118 /* Event counter set 1. */
258 #define P_ADP4 0x0138 /* Logical audio DMA pointer of audio
259 * input FIFO A2_IN. */
260 #define P_FB_BUFFER1 0x0144 /* Audio feedback buffer 1. */
261 #define P_FB_BUFFER2 0x0148 /* Audio feedback buffer 2. */
262 #define P_TSL1 0x0180 /* Audio time slot list 1. */
263 #define P_TSL2 0x01C0 /* Audio time slot list 2. */
264
265 /* LOCAL BUS (GATE ARRAY) REGISTER ADDRESS OFFSETS */
266 /* Analog I/O registers: */
267 #define LP_DACPOL 0x0082 /* Write DAC polarity. */
268 #define LP_GSEL 0x0084 /* Write ADC gain. */
269 #define LP_ISEL 0x0086 /* Write ADC channel select. */
270
271 /* Digital I/O registers */
272 #define LP_RDDIN(x) (0x0040 + (x) * 0x10) /* R: digital input */
273 #define LP_WRINTSEL(x) (0x0042 + (x) * 0x10) /* W: int enable */
274 #define LP_WREDGSEL(x) (0x0044 + (x) * 0x10) /* W: edge selection */
275 #define LP_WRCAPSEL(x) (0x0046 + (x) * 0x10) /* W: capture enable */
276 #define LP_RDCAPFLG(x) (0x0048 + (x) * 0x10) /* R: edges captured */
277 #define LP_WRDOUT(x) (0x0048 + (x) * 0x10) /* W: digital output */
278 #define LP_RDINTSEL(x) (0x004a + (x) * 0x10) /* R: int enable */
279 #define LP_RDEDGSEL(x) (0x004c + (x) * 0x10) /* R: edge selection */
280 #define LP_RDCAPSEL(x) (0x004e + (x) * 0x10) /* R: capture enable */
281
282 /* Counter Registers (read/write): */
283 #define LP_CR0A 0x0000 /* 0A setup register. */
284 #define LP_CR0B 0x0002 /* 0B setup register. */
285 #define LP_CR1A 0x0004 /* 1A setup register. */
286 #define LP_CR1B 0x0006 /* 1B setup register. */
287 #define LP_CR2A 0x0008 /* 2A setup register. */
288 #define LP_CR2B 0x000A /* 2B setup register. */
289
290 /* Counter PreLoad (write) and Latch (read) Registers: */
291 #define LP_CNTR0ALSW 0x000C /* 0A lsw. */
292 #define LP_CNTR0AMSW 0x000E /* 0A msw. */
293 #define LP_CNTR0BLSW 0x0010 /* 0B lsw. */
294 #define LP_CNTR0BMSW 0x0012 /* 0B msw. */
295 #define LP_CNTR1ALSW 0x0014 /* 1A lsw. */
296 #define LP_CNTR1AMSW 0x0016 /* 1A msw. */
297 #define LP_CNTR1BLSW 0x0018 /* 1B lsw. */
298 #define LP_CNTR1BMSW 0x001A /* 1B msw. */
299 #define LP_CNTR2ALSW 0x001C /* 2A lsw. */
300 #define LP_CNTR2AMSW 0x001E /* 2A msw. */
301 #define LP_CNTR2BLSW 0x0020 /* 2B lsw. */
302 #define LP_CNTR2BMSW 0x0022 /* 2B msw. */
303
304 /* Miscellaneous Registers (read/write): */
305 #define LP_MISC1 0x0088 /* Read/write Misc1. */
306 #define LP_WRMISC2 0x0090 /* Write Misc2. */
307 #define LP_RDMISC2 0x0082 /* Read Misc2. */
308
309 /* Bit masks for MISC1 register that are the same for reads and writes. */
310 #define MISC1_WENABLE 0x8000 /* enab writes to MISC2 (except Clear
311 * Watchdog bit). */
312 #define MISC1_WDISABLE 0x0000 /* Disable writes to MISC2. */
313 #define MISC1_EDCAP 0x1000 /* enab edge capture on DIO chans
314 * specified by LP_WRCAPSELx. */
315 #define MISC1_NOEDCAP 0x0000 /* Disable edge capture on specified
316 * DIO chans. */
317
318 /* Bit masks for MISC1 register reads. */
319 #define RDMISC1_WDTIMEOUT 0x4000 /* Watchdog timer timed out. */
320
321 /* Bit masks for MISC2 register writes. */
322 #define WRMISC2_WDCLEAR 0x8000 /* Reset watchdog timer to zero. */
323 #define WRMISC2_CHARGE_ENABLE 0x4000 /* enab battery trickle charging. */
324
325 /* Bit masks for MISC2 register that are the same for reads and writes. */
326 #define MISC2_BATT_ENABLE 0x0008 /* Backup battery enable. */
327 #define MISC2_WDENABLE 0x0004 /* Watchdog timer enable. */
328 #define MISC2_WDPERIOD_MASK 0x0003 /* Watchdog interval */
329 /* select mask. */
330
331 /* Bit masks for ACON1 register. */
332 #define A2_RUN 0x40000000 /* Run A2 based on TSL2. */
333 #define A1_RUN 0x20000000 /* Run A1 based on TSL1. */
334 #define A1_SWAP 0x00200000 /* Use big-endian for A1. */
335 #define A2_SWAP 0x00100000 /* Use big-endian for A2. */
336 #define WS_MODES 0x00019999 /* WS0 = TSL1 trigger */
337 /* input, WS1-WS4 = */
338 /* CS* outputs. */
339
340 #if PLATFORM == INTEL /* Base ACON1 config: always run A1 based
341 * on TSL1. */
342 #define ACON1_BASE (WS_MODES | A1_RUN)
343 #elif PLATFORM == MOTOROLA
344 #define ACON1_BASE (WS_MODES | A1_RUN | A1_SWAP | A2_SWAP)
345 #endif
346
347 #define ACON1_ADCSTART ACON1_BASE /* Start ADC: run A1
348 * based on TSL1. */
349 #define ACON1_DACSTART (ACON1_BASE | A2_RUN)
350 /* Start transmit to DAC: run A2 based on TSL2. */
351 #define ACON1_DACSTOP ACON1_BASE /* Halt A2. */
352
353 /* Bit masks for ACON2 register. */
354 #define A1_CLKSRC_BCLK1 0x00000000 /* A1 bit rate = BCLK1 (ADC). */
355 #define A2_CLKSRC_X1 0x00800000 /* A2 bit rate = ACLK/1 (DACs). */
356 #define A2_CLKSRC_X2 0x00C00000 /* A2 bit rate = ACLK/2 (DACs). */
357 #define A2_CLKSRC_X4 0x01400000 /* A2 bit rate = ACLK/4 (DACs). */
358 #define INVERT_BCLK2 0x00100000 /* Invert BCLK2 (DACs). */
359 #define BCLK2_OE 0x00040000 /* enab BCLK2 (DACs). */
360 #define ACON2_XORMASK 0x000C0000 /* XOR mask for ACON2 */
361 /* active-low bits. */
362
363 #define ACON2_INIT (ACON2_XORMASK ^ (A1_CLKSRC_BCLK1 | A2_CLKSRC_X2 | INVERT_BCLK2 | BCLK2_OE))
364
365 /* Bit masks for timeslot records. */
366 #define WS1 0x40000000 /* WS output to assert. */
367 #define WS2 0x20000000
368 #define WS3 0x10000000
369 #define WS4 0x08000000
370 #define RSD1 0x01000000 /* Shift A1 data in on SD1. */
371 #define SDW_A1 0x00800000 /* Store rcv'd char at next
372 * char slot of DWORD1 buffer. */
373 #define SIB_A1 0x00400000 /* Store rcv'd char at next
374 * char slot of FB1 buffer. */
375 #define SF_A1 0x00200000 /* Write unsigned long
376 * buffer to input FIFO. */
377
378 /* Select parallel-to-serial converter's data source: */
379 #define XFIFO_0 0x00000000 /* Data fifo byte 0. */
380 #define XFIFO_1 0x00000010 /* Data fifo byte 1. */
381 #define XFIFO_2 0x00000020 /* Data fifo byte 2. */
382 #define XFIFO_3 0x00000030 /* Data fifo byte 3. */
383 #define XFB0 0x00000040 /* FB_BUFFER byte 0. */
384 #define XFB1 0x00000050 /* FB_BUFFER byte 1. */
385 #define XFB2 0x00000060 /* FB_BUFFER byte 2. */
386 #define XFB3 0x00000070 /* FB_BUFFER byte 3. */
387 #define SIB_A2 0x00000200 /* Store next dword from A2's
388 * input shifter to FB2 buffer. */
389 #define SF_A2 0x00000100 /* Store next dword from A2's
390 * input shifter to its input
391 * fifo. */
392 #define LF_A2 0x00000080 /* Load next dword from A2's
393 * output fifo into its
394 * output dword buffer. */
395 #define XSD2 0x00000008 /* Shift data out on SD2. */
396 #define RSD3 0x00001800 /* Shift data in on SD3. */
397 #define RSD2 0x00001000 /* Shift data in on SD2. */
398 #define LOW_A2 0x00000002 /* Drive last SD low */
399 /* for 7 clks, then */
400 /* tri-state. */
401 #define EOS 0x00000001 /* End of superframe. */
402
403 /* I2C configuration constants. */
404 #define I2C_CLKSEL 0x0400
405 /* I2C bit rate = PCIclk/480 = 68.75 KHz. */
406
407 #define I2C_BITRATE 68.75
408 /* I2C bus data bit rate (determined by I2C_CLKSEL) in KHz. */
409
410 #define I2C_WRTIME 15.0
411 /* Worst case time, in msec, for EEPROM internal write op. */
412
413 /* I2C manifest constants. */
414
415 /* Max retries to wait for EEPROM write. */
416 #define I2C_RETRIES (I2C_WRTIME * I2C_BITRATE / 9.0)
417 #define I2C_ERR 0x0002 /* I2C control/status */
418 /* flag ERROR. */
419 #define I2C_BUSY 0x0001 /* I2C control/status */
420 /* flag BUSY. */
421 #define I2C_ABORT 0x0080 /* I2C status flag ABORT. */
422 #define I2C_ATTRSTART 0x3 /* I2C attribute START. */
423 #define I2C_ATTRCONT 0x2 /* I2C attribute CONT. */
424 #define I2C_ATTRSTOP 0x1 /* I2C attribute STOP. */
425 #define I2C_ATTRNOP 0x0 /* I2C attribute NOP. */
426
427 /* I2C read command | EEPROM address. */
428 #define I2CR (devpriv->I2CAdrs | 1)
429
430 /* I2C write command | EEPROM address. */
431 #define I2CW (devpriv->I2CAdrs)
432
433 /* Code macros used for constructing I2C command bytes. */
434 #define I2C_B2(ATTR, VAL) (((ATTR) << 6) | ((VAL) << 24))
435 #define I2C_B1(ATTR, VAL) (((ATTR) << 4) | ((VAL) << 16))
436 #define I2C_B0(ATTR, VAL) (((ATTR) << 2) | ((VAL) << 8))
437
438 /* oldest */
439 #define P_DEBICFGq 0x007C /* DEBI configuration. */
440 #define P_DEBICMDq 0x0080 /* DEBI command. */
441 #define P_DEBIPAGEq 0x0084 /* DEBI page. */
442 #define P_DEBIADq 0x0088 /* DEBI target address. */
443
444 #define DEBI_CFG_TOQ 0x03C00000 /* timeout (15 PCI cycles) */
445 #define DEBI_CFG_FASTQ 0x10000000 /* fast mode enable */
446 #define DEBI_CFG_16Q 0x00080000 /* 16-bit access enable */
447 #define DEBI_CFG_INCQ 0x00040000 /* enable address increment */
448 #define DEBI_CFG_TIMEROFFQ 0x00010000 /* disable timer */
449 #define DEBI_CMD_RDQ 0x00050000 /* read immediate 2 bytes */
450 #define DEBI_CMD_WRQ 0x00040000 /* write immediate 2 bytes */
451 #define DEBI_PAGE_DISABLEQ 0x00000000 /* paging disable */
452
453 /* DEBI command constants. */
454 #define DEBI_CMD_SIZE16 (2 << 17) /* Transfer size is */
455 /* always 2 bytes. */
456 #define DEBI_CMD_READ 0x00010000 /* Read operation. */
457 #define DEBI_CMD_WRITE 0x00000000 /* Write operation. */
458
459 /* Read immediate 2 bytes. */
460 #define DEBI_CMD_RDWORD (DEBI_CMD_READ | DEBI_CMD_SIZE16)
461
462 /* Write immediate 2 bytes. */
463 #define DEBI_CMD_WRWORD (DEBI_CMD_WRITE | DEBI_CMD_SIZE16)
464
465 /* DEBI configuration constants. */
466 #define DEBI_CFG_XIRQ_EN 0x80000000 /* enab external */
467 /* interrupt on GPIO3. */
468 #define DEBI_CFG_XRESUME 0x40000000 /* Resume block */
469 /* transfer when XIRQ */
470 /* deasserted. */
471 #define DEBI_CFG_FAST 0x10000000 /* Fast mode enable. */
472
473 /* 4-bit field that specifies DEBI timeout value in PCI clock cycles: */
474 #define DEBI_CFG_TOUT_BIT 22 /* Finish DEBI cycle after */
475 /* this many clocks. */
476
477 /* 2-bit field that specifies Endian byte lane steering: */
478 #define DEBI_CFG_SWAP_NONE 0x00000000 /* Straight - don't */
479 /* swap any bytes */
480 /* (Intel). */
481 #define DEBI_CFG_SWAP_2 0x00100000 /* 2-byte swap (Motorola). */
482 #define DEBI_CFG_SWAP_4 0x00200000 /* 4-byte swap. */
483 #define DEBI_CFG_16 0x00080000 /* Slave is able to */
484 /* serve 16-bit */
485 /* cycles. */
486
487 #define DEBI_CFG_SLAVE16 0x00080000 /* Slave is able to */
488 /* serve 16-bit */
489 /* cycles. */
490 #define DEBI_CFG_INC 0x00040000 /* enab address */
491 /* increment for block */
492 /* transfers. */
493 #define DEBI_CFG_INTEL 0x00020000 /* Intel style local bus. */
494 #define DEBI_CFG_TIMEROFF 0x00010000 /* Disable timer. */
495
496 #if PLATFORM == INTEL
497
498 #define DEBI_TOUT 7 /* Wait 7 PCI clocks */
499 /* (212 ns) before */
500 /* polling RDY. */
501
502 /* Intel byte lane steering (pass through all byte lanes). */
503 #define DEBI_SWAP DEBI_CFG_SWAP_NONE
504
505 #elif PLATFORM == MOTOROLA
506
507 #define DEBI_TOUT 15 /* Wait 15 PCI clocks (454 ns) */
508 /* maximum before timing out. */
509 #define DEBI_SWAP DEBI_CFG_SWAP_2 /* Motorola byte lane steering. */
510
511 #endif
512
513 /* DEBI page table constants. */
514 #define DEBI_PAGE_DISABLE 0x00000000 /* Paging disable. */
515
516 /* ******* EXTRA FROM OTHER SANSORAY * .h ******* */
517
518 /* LoadSrc values: */
519 #define LOADSRC_INDX 0 /* Preload core in response to */
520 /* Index. */
521 #define LOADSRC_OVER 1 /* Preload core in response to */
522 /* Overflow. */
523 #define LOADSRCB_OVERA 2 /* Preload B core in response */
524 /* to A Overflow. */
525 #define LOADSRC_NONE 3 /* Never preload core. */
526
527 /* IntSrc values: */
528 #define INTSRC_NONE 0 /* Interrupts disabled. */
529 #define INTSRC_OVER 1 /* Interrupt on Overflow. */
530 #define INTSRC_INDX 2 /* Interrupt on Index. */
531 #define INTSRC_BOTH 3 /* Interrupt on Index or Overflow. */
532
533 /* LatchSrc values: */
534 #define LATCHSRC_AB_READ 0 /* Latch on read. */
535 #define LATCHSRC_A_INDXA 1 /* Latch A on A Index. */
536 #define LATCHSRC_B_INDXB 2 /* Latch B on B Index. */
537 #define LATCHSRC_B_OVERA 3 /* Latch B on A Overflow. */
538
539 /* IndxSrc values: */
540 #define INDXSRC_HARD 0 /* Hardware or software index. */
541 #define INDXSRC_SOFT 1 /* Software index only. */
542
543 /* IndxPol values: */
544 #define INDXPOL_POS 0 /* Index input is active high. */
545 #define INDXPOL_NEG 1 /* Index input is active low. */
546
547 /* ClkSrc values: */
548 #define CLKSRC_COUNTER 0 /* Counter mode. */
549 #define CLKSRC_TIMER 2 /* Timer mode. */
550 #define CLKSRC_EXTENDER 3 /* Extender mode. */
551
552 /* ClkPol values: */
553 #define CLKPOL_POS 0 /* Counter/Extender clock is */
554 /* active high. */
555 #define CLKPOL_NEG 1 /* Counter/Extender clock is */
556 /* active low. */
557 #define CNTDIR_UP 0 /* Timer counts up. */
558 #define CNTDIR_DOWN 1 /* Timer counts down. */
559
560 /* ClkEnab values: */
561 #define CLKENAB_ALWAYS 0 /* Clock always enabled. */
562 #define CLKENAB_INDEX 1 /* Clock is enabled by index. */
563
564 /* ClkMult values: */
565 #define CLKMULT_4X 0 /* 4x clock multiplier. */
566 #define CLKMULT_2X 1 /* 2x clock multiplier. */
567 #define CLKMULT_1X 2 /* 1x clock multiplier. */
568
569 /* Bit Field positions in COUNTER_SETUP structure: */
570 #define BF_LOADSRC 9 /* Preload trigger. */
571 #define BF_INDXSRC 7 /* Index source. */
572 #define BF_INDXPOL 6 /* Index polarity. */
573 #define BF_CLKSRC 4 /* Clock source. */
574 #define BF_CLKPOL 3 /* Clock polarity/count direction. */
575 #define BF_CLKMULT 1 /* Clock multiplier. */
576 #define BF_CLKENAB 0 /* Clock enable. */
577
578 /* Enumerated counter operating modes specified by ClkSrc bit field in */
579 /* a COUNTER_SETUP. */
580
581 #define CLKSRC_COUNTER 0 /* Counter: ENC_C clock, ENC_D */
582 /* direction. */
583 #define CLKSRC_TIMER 2 /* Timer: SYS_C clock, */
584 /* direction specified by */
585 /* ClkPol. */
586 #define CLKSRC_EXTENDER 3 /* Extender: OVR_A clock, */
587 /* ENC_D direction. */
588
589 /* Enumerated counter clock multipliers. */
590
591 #define MULT_X0 0x0003 /* Supports no multipliers; */
592 /* fixed physical multiplier = */
593 /* 3. */
594 #define MULT_X1 0x0002 /* Supports multiplier x1; */
595 /* fixed physical multiplier = */
596 /* 2. */
597 #define MULT_X2 0x0001 /* Supports multipliers x1, */
598 /* x2; physical multipliers = */
599 /* 1 or 2. */
600 #define MULT_X4 0x0000 /* Supports multipliers x1, */
601 /* x2, x4; physical */
602 /* multipliers = 0, 1 or 2. */
603
604 /* Sanity-check limits for parameters. */
605
606 #define NUM_COUNTERS 6 /* Maximum valid counter */
607 /* logical channel number. */
608 #define NUM_INTSOURCES 4
609 #define NUM_LATCHSOURCES 4
610 #define NUM_CLKMULTS 4
611 #define NUM_CLKSOURCES 4
612 #define NUM_CLKPOLS 2
613 #define NUM_INDEXPOLS 2
614 #define NUM_INDEXSOURCES 2
615 #define NUM_LOADTRIGS 4
616
617 /* Bit field positions in CRA and CRB counter control registers. */
618
619 /* Bit field positions in CRA: */
620 #define CRABIT_INDXSRC_B 14 /* B index source. */
621 #define CRABIT_CLKSRC_B 12 /* B clock source. */
622 #define CRABIT_INDXPOL_A 11 /* A index polarity. */
623 #define CRABIT_LOADSRC_A 9 /* A preload trigger. */
624 #define CRABIT_CLKMULT_A 7 /* A clock multiplier. */
625 #define CRABIT_INTSRC_A 5 /* A interrupt source. */
626 #define CRABIT_CLKPOL_A 4 /* A clock polarity. */
627 #define CRABIT_INDXSRC_A 2 /* A index source. */
628 #define CRABIT_CLKSRC_A 0 /* A clock source. */
629
630 /* Bit field positions in CRB: */
631 #define CRBBIT_INTRESETCMD 15 /* Interrupt reset command. */
632 #define CRBBIT_INTRESET_B 14 /* B interrupt reset enable. */
633 #define CRBBIT_INTRESET_A 13 /* A interrupt reset enable. */
634 #define CRBBIT_CLKENAB_A 12 /* A clock enable. */
635 #define CRBBIT_INTSRC_B 10 /* B interrupt source. */
636 #define CRBBIT_LATCHSRC 8 /* A/B latch source. */
637 #define CRBBIT_LOADSRC_B 6 /* B preload trigger. */
638 #define CRBBIT_CLKMULT_B 3 /* B clock multiplier. */
639 #define CRBBIT_CLKENAB_B 2 /* B clock enable. */
640 #define CRBBIT_INDXPOL_B 1 /* B index polarity. */
641 #define CRBBIT_CLKPOL_B 0 /* B clock polarity. */
642
643 /* Bit field masks for CRA and CRB. */
644
645 #define CRAMSK_INDXSRC_B (3 << CRABIT_INDXSRC_B)
646 #define CRAMSK_CLKSRC_B (3 << CRABIT_CLKSRC_B)
647 #define CRAMSK_INDXPOL_A (1 << CRABIT_INDXPOL_A)
648 #define CRAMSK_LOADSRC_A (3 << CRABIT_LOADSRC_A)
649 #define CRAMSK_CLKMULT_A (3 << CRABIT_CLKMULT_A)
650 #define CRAMSK_INTSRC_A (3 << CRABIT_INTSRC_A)
651 #define CRAMSK_CLKPOL_A (3 << CRABIT_CLKPOL_A)
652 #define CRAMSK_INDXSRC_A (3 << CRABIT_INDXSRC_A)
653 #define CRAMSK_CLKSRC_A (3 << CRABIT_CLKSRC_A)
654
655 #define CRBMSK_INTRESETCMD (1 << CRBBIT_INTRESETCMD)
656 #define CRBMSK_INTRESET_B (1 << CRBBIT_INTRESET_B)
657 #define CRBMSK_INTRESET_A (1 << CRBBIT_INTRESET_A)
658 #define CRBMSK_CLKENAB_A (1 << CRBBIT_CLKENAB_A)
659 #define CRBMSK_INTSRC_B (3 << CRBBIT_INTSRC_B)
660 #define CRBMSK_LATCHSRC (3 << CRBBIT_LATCHSRC)
661 #define CRBMSK_LOADSRC_B (3 << CRBBIT_LOADSRC_B)
662 #define CRBMSK_CLKMULT_B (3 << CRBBIT_CLKMULT_B)
663 #define CRBMSK_CLKENAB_B (1 << CRBBIT_CLKENAB_B)
664 #define CRBMSK_INDXPOL_B (1 << CRBBIT_INDXPOL_B)
665 #define CRBMSK_CLKPOL_B (1 << CRBBIT_CLKPOL_B)
666
667 #define CRBMSK_INTCTRL (CRBMSK_INTRESETCMD | CRBMSK_INTRESET_A | CRBMSK_INTRESET_B) /* Interrupt reset control bits. */
668
669 /* Bit field positions for standardized SETUP structure. */
670
671 #define STDBIT_INTSRC 13
672 #define STDBIT_LATCHSRC 11
673 #define STDBIT_LOADSRC 9
674 #define STDBIT_INDXSRC 7
675 #define STDBIT_INDXPOL 6
676 #define STDBIT_CLKSRC 4
677 #define STDBIT_CLKPOL 3
678 #define STDBIT_CLKMULT 1
679 #define STDBIT_CLKENAB 0
680
681 /* Bit field masks for standardized SETUP structure. */
682
683 #define STDMSK_INTSRC (3 << STDBIT_INTSRC)
684 #define STDMSK_LATCHSRC (3 << STDBIT_LATCHSRC)
685 #define STDMSK_LOADSRC (3 << STDBIT_LOADSRC)
686 #define STDMSK_INDXSRC (1 << STDBIT_INDXSRC)
687 #define STDMSK_INDXPOL (1 << STDBIT_INDXPOL)
688 #define STDMSK_CLKSRC (3 << STDBIT_CLKSRC)
689 #define STDMSK_CLKPOL (1 << STDBIT_CLKPOL)
690 #define STDMSK_CLKMULT (3 << STDBIT_CLKMULT)
691 #define STDMSK_CLKENAB (1 << STDBIT_CLKENAB)
692
693 struct bufferDMA {
694 dma_addr_t PhysicalBase;
695 void *LogicalBase;
696 uint32_t DMAHandle;
697 };