1 /*********************************************************************
5 * Description: Driver for the Toshiba OBOE (or type-O or 701)
6 * FIR Chipset, also supports the DONAUOBOE (type-DO
7 * or d01) FIR chipset which as far as I know is
9 * Status: Experimental.
10 * Author: James McKenzie <james@fishsoup.dhs.org>
11 * Created at: Sat May 8 12:35:27 1999
12 * Modified: 2.16 Martin Lucina <mato@kotelna.sk>
13 * Modified: 2.16 Sat Jun 22 18:54:29 2002 (sync headers)
14 * Modified: 2.17 Christian Gennerat <christian.gennerat@polytechnique.org>
15 * Modified: 2.17 jeu sep 12 08:50:20 2002 (add lock to be used by spinlocks)
17 * Copyright (c) 1999 James McKenzie, All Rights Reserved.
19 * This program is free software; you can redistribute it and/or
20 * modify it under the terms of the GNU General Public License as
21 * published by the Free Software Foundation; either version 2 of
22 * the License, or (at your option) any later version.
24 * Neither James McKenzie nor Cambridge University admit liability nor
25 * provide warranty for any of this software. This material is
26 * provided "AS-IS" and at no charge.
28 * Applicable Models : Libretto 100/110CT and many more.
29 * Toshiba refers to this chip as the type-O IR port,
30 * or the type-DO IR port.
32 * IrDA chip set list from Toshiba Computer Engineering Corp.
33 * model method maker controler Version
34 * Portege 320CT FIR,SIR Toshiba Oboe(Triangle)
35 * Portege 3010CT FIR,SIR Toshiba Oboe(Sydney)
36 * Portege 3015CT FIR,SIR Toshiba Oboe(Sydney)
37 * Portege 3020CT FIR,SIR Toshiba Oboe(Sydney)
38 * Portege 7020CT FIR,SIR ? ?
40 * Satell. 4090XCDT FIR,SIR ? ?
42 * Libretto 100CT FIR,SIR Toshiba Oboe
43 * Libretto 1000CT FIR,SIR Toshiba Oboe
45 * TECRA750DVD FIR,SIR Toshiba Oboe(Triangle) REV ID=14h
46 * TECRA780 FIR,SIR Toshiba Oboe(Sandlot) REV ID=32h,33h
47 * TECRA750CDT FIR,SIR Toshiba Oboe(Triangle) REV ID=13h,14h
48 * TECRA8000 FIR,SIR Toshiba Oboe(ISKUR) REV ID=23h
50 ********************************************************************/
52 /* The documentation for this chip is allegedly released */
53 /* However I have not seen it, not have I managed to contact */
54 /* anyone who has. HOWEVER the chip bears a striking resemblence */
55 /* to the IrDA controller in the Toshiba RISC TMPR3922 chip */
56 /* the documentation for this is freely available at */
57 /* http://www.toshiba.com/taec/components/Generic/TMPR3922.shtml */
58 /* The mapping between the registers in that document and the */
59 /* Registers in the 701 oboe chip are as follows */
62 /* 3922 reg 701 regs, by bit numbers */
63 /* 7- 0 15- 8 24-16 31-25 */
67 /* $34 0x8 0x9 SEE NOTE 2 */
69 /* $3C 0xe SEE NOTE 3 */
76 /* FIXME: could be 0x1b 0x1a here */
79 /* $5C 0xf SEE NOTE 4 */
84 /* 1. The pointer to ring is packed in most unceremoniusly */
85 /* 701 Register Address bits (A9-A0 must be zero) */
86 /* 0x4: A17 A16 A15 A14 A13 A12 A11 A10 */
87 /* 0x5: A25 A24 A23 A22 A21 A20 A19 A18 */
88 /* 0x2: 0 0 A31 A30 A29 A28 A27 A26 */
90 /* 2. The M$ drivers do a write 0x1 to 0x9, however the 3922 */
91 /* documentation would suggest that a write of 0x1 to 0x8 */
92 /* would be more appropriate. */
94 /* 3. This assignment is tenuous at best, register 0xe seems to */
95 /* have bits arranged 0 0 0 R/W R/W R/W R/W R/W */
96 /* if either of the lower two bits are set the chip seems to */
99 /* 4. Bits 7-4 seem to be different 4 seems just to be generic */
100 /* receiver busy flag */
102 /* 5. and 6. The IER and ISR have a different bit assignment */
103 /* The lower three bits of both read back as ones */
104 /* ISR is register 0xc, IER is register 0xd */
105 /* 7 6 5 4 3 2 1 0 */
106 /* 0xc: TxDone RxDone TxUndr RxOver SipRcv 1 1 1 */
107 /* 0xd: TxDone RxDone TxUndr RxOver SipRcv 1 1 1 */
108 /* TxDone xmitt done (generated only if generate interrupt bit */
109 /* is set in the ring) */
110 /* RxDone recv completed (or other recv condition if you set it */
112 /* TxUnder underflow in Transmit FIFO */
113 /* RxOver overflow in Recv FIFO */
114 /* SipRcv received serial gap (or other condition you set) */
115 /* Interrupts are enabled by writing a one to the IER register */
116 /* Interrupts are cleared by writing a one to the ISR register */
118 /* 6. The remaining registers: 0x6 and 0x3 appear to be */
119 /* reserved parts of 16 or 32 bit registersthe remainder */
120 /* 0xa 0xb 0x1e 0x1f could possibly be (by their behaviour) */
121 /* the Unicast Filter register at $58. */
123 /* 7. While the core obviously expects 32 bit accesses all the */
124 /* M$ drivers do 8 bit accesses, infact the Miniport ones */
125 /* write and read back the byte serveral times (why?) */
133 #define OBOE_IO_EXTENT 0x1f
135 /*Receive and transmit slot pointers */
136 #define OBOE_REG(i) (i+(self->base))
137 #define OBOE_RXSLOT OBOE_REG(0x0)
138 #define OBOE_TXSLOT OBOE_REG(0x1)
139 #define OBOE_SLOT_MASK 0x3f
141 #define OBOE_TXRING_OFFSET 0x200
142 #define OBOE_TXRING_OFFSET_IN_SLOTS 0x40
144 /*pointer to the ring */
145 #define OBOE_RING_BASE0 OBOE_REG(0x4)
146 #define OBOE_RING_BASE1 OBOE_REG(0x5)
147 #define OBOE_RING_BASE2 OBOE_REG(0x2)
148 #define OBOE_RING_BASE3 OBOE_REG(0x3)
150 /*Number of slots in the ring */
151 #define OBOE_RING_SIZE OBOE_REG(0x7)
152 #define OBOE_RING_SIZE_RX4 0x00
153 #define OBOE_RING_SIZE_RX8 0x01
154 #define OBOE_RING_SIZE_RX16 0x03
155 #define OBOE_RING_SIZE_RX32 0x07
156 #define OBOE_RING_SIZE_RX64 0x0f
157 #define OBOE_RING_SIZE_TX4 0x00
158 #define OBOE_RING_SIZE_TX8 0x10
159 #define OBOE_RING_SIZE_TX16 0x30
160 #define OBOE_RING_SIZE_TX32 0x70
161 #define OBOE_RING_SIZE_TX64 0xf0
163 #define OBOE_RING_MAX_SIZE 64
165 /*Causes the gubbins to re-examine the ring */
166 #define OBOE_PROMPT OBOE_REG(0x9)
167 #define OBOE_PROMPT_BIT 0x1
169 /* Interrupt Status Register */
170 #define OBOE_ISR OBOE_REG(0xc)
171 /* Interrupt Enable Register */
172 #define OBOE_IER OBOE_REG(0xd)
173 /* Interrupt bits for IER and ISR */
174 #define OBOE_INT_TXDONE 0x80
175 #define OBOE_INT_RXDONE 0x40
176 #define OBOE_INT_TXUNDER 0x20
177 #define OBOE_INT_RXOVER 0x10
178 #define OBOE_INT_SIP 0x08
179 #define OBOE_INT_MASK 0xf8
182 #define OBOE_CONFIG1 OBOE_REG(0xe)
183 #define OBOE_CONFIG1_RST 0x01
184 #define OBOE_CONFIG1_DISABLE 0x02
185 #define OBOE_CONFIG1_4 0x08
186 #define OBOE_CONFIG1_8 0x08
188 #define OBOE_CONFIG1_ON 0x8
189 #define OBOE_CONFIG1_RESET 0xf
190 #define OBOE_CONFIG1_OFF 0xe
192 #define OBOE_STATUS OBOE_REG(0xf)
193 #define OBOE_STATUS_RXBUSY 0x10
194 #define OBOE_STATUS_FIRRX 0x04
195 #define OBOE_STATUS_MIRRX 0x02
196 #define OBOE_STATUS_SIRRX 0x01
199 /*Speed control registers */
200 #define OBOE_CONFIG0L OBOE_REG(0x10)
201 #define OBOE_CONFIG0H OBOE_REG(0x11)
203 #define OBOE_CONFIG0H_TXONLOOP 0x80 /*Transmit when looping (dangerous) */
204 #define OBOE_CONFIG0H_LOOP 0x40 /*Loopback Tx->Rx */
205 #define OBOE_CONFIG0H_ENTX 0x10 /*Enable Tx */
206 #define OBOE_CONFIG0H_ENRX 0x08 /*Enable Rx */
207 #define OBOE_CONFIG0H_ENDMAC 0x04 /*Enable/reset* the DMA controller */
208 #define OBOE_CONFIG0H_RCVANY 0x02 /*DMA mode 1=bytes, 0=dwords */
210 #define OBOE_CONFIG0L_CRC16 0x80 /*CRC 1=16 bit 0=32 bit */
211 #define OBOE_CONFIG0L_ENFIR 0x40 /*Enable FIR */
212 #define OBOE_CONFIG0L_ENMIR 0x20 /*Enable MIR */
213 #define OBOE_CONFIG0L_ENSIR 0x10 /*Enable SIR */
214 #define OBOE_CONFIG0L_ENSIRF 0x08 /*Enable SIR framer */
215 #define OBOE_CONFIG0L_SIRTEST 0x04 /*Enable SIR framer in MIR and FIR */
216 #define OBOE_CONFIG0L_INVERTTX 0x02 /*Invert Tx Line */
217 #define OBOE_CONFIG0L_INVERTRX 0x01 /*Invert Rx Line */
219 #define OBOE_BOF OBOE_REG(0x12)
220 #define OBOE_EOF OBOE_REG(0x13)
222 #define OBOE_ENABLEL OBOE_REG(0x14)
223 #define OBOE_ENABLEH OBOE_REG(0x15)
225 #define OBOE_ENABLEH_PHYANDCLOCK 0x80 /*Toggle low to copy config in */
226 #define OBOE_ENABLEH_CONFIGERR 0x40
227 #define OBOE_ENABLEH_FIRON 0x20
228 #define OBOE_ENABLEH_MIRON 0x10
229 #define OBOE_ENABLEH_SIRON 0x08
230 #define OBOE_ENABLEH_ENTX 0x04
231 #define OBOE_ENABLEH_ENRX 0x02
232 #define OBOE_ENABLEH_CRC16 0x01
234 #define OBOE_ENABLEL_BROADCAST 0x01
236 #define OBOE_CURR_PCONFIGL OBOE_REG(0x16) /*Current config */
237 #define OBOE_CURR_PCONFIGH OBOE_REG(0x17)
239 #define OBOE_NEW_PCONFIGL OBOE_REG(0x18)
240 #define OBOE_NEW_PCONFIGH OBOE_REG(0x19)
242 #define OBOE_PCONFIGH_BAUDMASK 0xfc
243 #define OBOE_PCONFIGH_WIDTHMASK 0x04
244 #define OBOE_PCONFIGL_WIDTHMASK 0xe0
245 #define OBOE_PCONFIGL_PREAMBLEMASK 0x1f
247 #define OBOE_PCONFIG_BAUDMASK 0xfc00
248 #define OBOE_PCONFIG_BAUDSHIFT 10
249 #define OBOE_PCONFIG_WIDTHMASK 0x04e0
250 #define OBOE_PCONFIG_WIDTHSHIFT 5
251 #define OBOE_PCONFIG_PREAMBLEMASK 0x001f
252 #define OBOE_PCONFIG_PREAMBLESHIFT 0
254 #define OBOE_MAXLENL OBOE_REG(0x1a)
255 #define OBOE_MAXLENH OBOE_REG(0x1b)
257 #define OBOE_RXCOUNTH OBOE_REG(0x1c) /*Reset on recipt */
258 #define OBOE_RXCOUNTL OBOE_REG(0x1d) /*of whole packet */
260 /* The PCI ID of the OBOE chip */
261 #ifndef PCI_DEVICE_ID_FIR701
262 #define PCI_DEVICE_ID_FIR701 0x0701
265 #ifndef PCI_DEVICE_ID_FIRD01
266 #define PCI_DEVICE_ID_FIRD01 0x0d01
271 __u16 len
; /*Tweleve bits of packet length */
273 __u8 control
; /*Slot control/status see below */
274 __u32 address
; /*Slot buffer address */
276 __attribute__ ((packed
));
278 #define OBOE_NTASKS OBOE_TXRING_OFFSET_IN_SLOTS
282 struct OboeSlot rx
[OBOE_NTASKS
];
283 struct OboeSlot tx
[OBOE_NTASKS
];
286 #define OBOE_RING_LEN (sizeof(struct OboeRing))
289 #define OBOE_CTL_TX_HW_OWNS 0x80 /*W/R This slot owned by the hardware */
290 #define OBOE_CTL_TX_DISTX_CRC 0x40 /*W Disable CRC generation for [FM]IR */
291 #define OBOE_CTL_TX_BAD_CRC 0x20 /*W Generate bad CRC */
292 #define OBOE_CTL_TX_SIP 0x10 /*W Generate an SIP after xmittion */
293 #define OBOE_CTL_TX_MKUNDER 0x08 /*W Generate an underrun error */
294 #define OBOE_CTL_TX_RTCENTX 0x04 /*W Enable receiver and generate TXdone */
295 /* After this slot is processed */
296 #define OBOE_CTL_TX_UNDER 0x01 /*R Set by hardware to indicate underrun */
299 #define OBOE_CTL_RX_HW_OWNS 0x80 /*W/R This slot owned by hardware */
300 #define OBOE_CTL_RX_PHYERR 0x40 /*R Decoder error on receiption */
301 #define OBOE_CTL_RX_CRCERR 0x20 /*R CRC error only set for [FM]IR */
302 #define OBOE_CTL_RX_LENGTH 0x10 /*R Packet > max Rx length */
303 #define OBOE_CTL_RX_OVER 0x08 /*R set to indicate an overflow */
304 #define OBOE_CTL_RX_SIRBAD 0x04 /*R SIR had BOF in packet or ABORT sequence */
305 #define OBOE_CTL_RX_RXEOF 0x02 /*R Finished receiving on this slot */
310 struct net_device
*netdev
; /* Yes! we are some kind of netdevice */
311 struct tty_driver ttydev
;
313 struct irlap_cb
*irlap
; /* The link layer we are binded to */
315 chipio_t io
; /* IrDA controller information */
316 struct qos_info qos
; /* QoS capabilities for this device */
318 __u32 flags
; /* Interface flags */
320 struct pci_dev
*pdev
; /*PCI device */
321 int base
; /*IO base */
324 int txpending
; /*how many tx's are pending */
325 int txs
, rxs
; /*Which slots are we at */
327 int irdad
; /*Driver under control of netdev end */
328 int async
; /*Driver under control of async end */
331 int stopped
; /*Stopped by some or other APM stuff */
333 int filter
; /*In SIR mode do we want to receive
334 frames or byte ranges */
336 void *ringbuf
; /*The ring buffer */
337 struct OboeRing
*ring
; /*The ring */
339 void *tx_bufs
[OBOE_RING_MAX_SIZE
]; /*The buffers */
340 void *rx_bufs
[OBOE_RING_MAX_SIZE
];
343 int speed
; /*Current setting of the speed */
344 int new_speed
; /*Set to request a speed change */
346 /* The spinlock protect critical parts of the driver.
347 * Locking is done like this :
348 * spin_lock_irqsave(&self->spinlock, flags);
349 * Releasing the lock :
350 * spin_unlock_irqrestore(&self->spinlock, flags);
353 /* Used for the probe and diagnostics code */
This page took 0.048703 seconds and 5 git commands to generate.