xref: /openbmc/linux/include/uapi/linux/cyclades.h (revision 2f5947df)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /* $Revision: 3.0 $$Date: 1998/11/02 14:20:59 $
3  * linux/include/linux/cyclades.h
4  *
5  * This file was initially written by
6  * Randolph Bentson <bentson@grieg.seaslug.org> and is maintained by
7  * Ivan Passos <ivan@cyclades.com>.
8  *
9  * This file contains the general definitions for the cyclades.c driver
10  *$Log: cyclades.h,v $
11  *Revision 3.1  2002/01/29 11:36:16  henrique
12  *added throttle field on struct cyclades_port to indicate whether the
13  *port is throttled or not
14  *
15  *Revision 3.1  2000/04/19 18:52:52  ivan
16  *converted address fields to unsigned long and added fields for physical
17  *addresses on cyclades_card structure;
18  *
19  *Revision 3.0  1998/11/02 14:20:59  ivan
20  *added nports field on cyclades_card structure;
21  *
22  *Revision 2.5  1998/08/03 16:57:01  ivan
23  *added cyclades_idle_stats structure;
24  *
25  *Revision 2.4  1998/06/01 12:09:53  ivan
26  *removed closing_wait2 from cyclades_port structure;
27  *
28  *Revision 2.3  1998/03/16 18:01:12  ivan
29  *changes in the cyclades_port structure to get it closer to the
30  *standard serial port structure;
31  *added constants for new ioctls;
32  *
33  *Revision 2.2  1998/02/17 16:50:00  ivan
34  *changes in the cyclades_port structure (addition of shutdown_wait and
35  *chip_rev variables);
36  *added constants for new ioctls and for CD1400 rev. numbers.
37  *
38  *Revision 2.1	1997/10/24 16:03:00  ivan
39  *added rflow (which allows enabling the CD1400 special flow control
40  *feature) and rtsdtr_inv (which allows DTR/RTS pin inversion) to
41  *cyclades_port structure;
42  *added Alpha support
43  *
44  *Revision 2.0  1997/06/30 10:30:00  ivan
45  *added some new doorbell command constants related to IOCTLW and
46  *UART error signaling
47  *
48  *Revision 1.8  1997/06/03 15:30:00  ivan
49  *added constant ZFIRM_HLT
50  *added constant CyPCI_Ze_win ( = 2 * Cy_PCI_Zwin)
51  *
52  *Revision 1.7  1997/03/26 10:30:00  daniel
53  *new entries at the end of cyclades_port struct to reallocate
54  *variables illegally allocated within card memory.
55  *
56  *Revision 1.6  1996/09/09 18:35:30  bentson
57  *fold in changes for Cyclom-Z -- including structures for
58  *communicating with board as well modest changes to original
59  *structures to support new features.
60  *
61  *Revision 1.5  1995/11/13 21:13:31  bentson
62  *changes suggested by Michael Chastain <mec@duracef.shout.net>
63  *to support use of this file in non-kernel applications
64  *
65  *
66  */
67 
68 #ifndef _UAPI_LINUX_CYCLADES_H
69 #define _UAPI_LINUX_CYCLADES_H
70 
71 #include <linux/types.h>
72 
73 struct cyclades_monitor {
74         unsigned long           int_count;
75         unsigned long           char_count;
76         unsigned long           char_max;
77         unsigned long           char_last;
78 };
79 
80 /*
81  * These stats all reflect activity since the device was last initialized.
82  * (i.e., since the port was opened with no other processes already having it
83  * open)
84  */
85 struct cyclades_idle_stats {
86     __kernel_time_t in_use;	/* Time device has been in use (secs) */
87     __kernel_time_t recv_idle;	/* Time since last char received (secs) */
88     __kernel_time_t xmit_idle;	/* Time since last char transmitted (secs) */
89     unsigned long  recv_bytes;	/* Bytes received */
90     unsigned long  xmit_bytes;	/* Bytes transmitted */
91     unsigned long  overruns;	/* Input overruns */
92     unsigned long  frame_errs;	/* Input framing errors */
93     unsigned long  parity_errs;	/* Input parity errors */
94 };
95 
96 #define CYCLADES_MAGIC  0x4359
97 
98 #define CYGETMON                0x435901
99 #define CYGETTHRESH             0x435902
100 #define CYSETTHRESH             0x435903
101 #define CYGETDEFTHRESH          0x435904
102 #define CYSETDEFTHRESH          0x435905
103 #define CYGETTIMEOUT            0x435906
104 #define CYSETTIMEOUT            0x435907
105 #define CYGETDEFTIMEOUT         0x435908
106 #define CYSETDEFTIMEOUT         0x435909
107 #define CYSETRFLOW		0x43590a
108 #define CYGETRFLOW		0x43590b
109 #define CYSETRTSDTR_INV		0x43590c
110 #define CYGETRTSDTR_INV		0x43590d
111 #define CYZSETPOLLCYCLE		0x43590e
112 #define CYZGETPOLLCYCLE		0x43590f
113 #define CYGETCD1400VER		0x435910
114 #define	CYSETWAIT		0x435912
115 #define	CYGETWAIT		0x435913
116 
117 /*************** CYCLOM-Z ADDITIONS ***************/
118 
119 #define CZIOC           ('M' << 8)
120 #define CZ_NBOARDS      (CZIOC|0xfa)
121 #define CZ_BOOT_START   (CZIOC|0xfb)
122 #define CZ_BOOT_DATA    (CZIOC|0xfc)
123 #define CZ_BOOT_END     (CZIOC|0xfd)
124 #define CZ_TEST         (CZIOC|0xfe)
125 
126 #define CZ_DEF_POLL	(HZ/25)
127 
128 #define MAX_BOARD       4       /* Max number of boards */
129 #define MAX_DEV         256     /* Max number of ports total */
130 #define	CYZ_MAX_SPEED	921600
131 
132 #define	CYZ_FIFO_SIZE	16
133 
134 #define CYZ_BOOT_NWORDS 0x100
135 struct CYZ_BOOT_CTRL {
136         unsigned short  nboard;
137         int             status[MAX_BOARD];
138         int             nchannel[MAX_BOARD];
139         int             fw_rev[MAX_BOARD];
140         unsigned long   offset;
141         unsigned long   data[CYZ_BOOT_NWORDS];
142 };
143 
144 
145 #ifndef DP_WINDOW_SIZE
146 /*
147  *	Memory Window Sizes
148  */
149 
150 #define	DP_WINDOW_SIZE		(0x00080000)	/* window size 512 Kb */
151 #define	ZE_DP_WINDOW_SIZE	(0x00100000)	/* window size 1 Mb (Ze and
152 						  8Zo V.2 */
153 #define	CTRL_WINDOW_SIZE	(0x00000080)	/* runtime regs 128 bytes */
154 
155 /*
156  *	CUSTOM_REG - Cyclom-Z/PCI Custom Registers Set. The driver
157  *	normally will access only interested on the fpga_id, fpga_version,
158  *	start_cpu and stop_cpu.
159  */
160 
161 struct	CUSTOM_REG {
162 	__u32	fpga_id;		/* FPGA Identification Register */
163 	__u32	fpga_version;		/* FPGA Version Number Register */
164 	__u32	cpu_start;		/* CPU start Register (write) */
165 	__u32	cpu_stop;		/* CPU stop Register (write) */
166 	__u32	misc_reg;		/* Miscellaneous Register */
167 	__u32	idt_mode;		/* IDT mode Register */
168 	__u32	uart_irq_status;	/* UART IRQ status Register */
169 	__u32	clear_timer0_irq;	/* Clear timer interrupt Register */
170 	__u32	clear_timer1_irq;	/* Clear timer interrupt Register */
171 	__u32	clear_timer2_irq;	/* Clear timer interrupt Register */
172 	__u32	test_register;		/* Test Register */
173 	__u32	test_count;		/* Test Count Register */
174 	__u32	timer_select;		/* Timer select register */
175 	__u32	pr_uart_irq_status;	/* Prioritized UART IRQ stat Reg */
176 	__u32	ram_wait_state;		/* RAM wait-state Register */
177 	__u32	uart_wait_state;	/* UART wait-state Register */
178 	__u32	timer_wait_state;	/* timer wait-state Register */
179 	__u32	ack_wait_state;		/* ACK wait State Register */
180 };
181 
182 /*
183  *	RUNTIME_9060 - PLX PCI9060ES local configuration and shared runtime
184  *	registers. This structure can be used to access the 9060 registers
185  *	(memory mapped).
186  */
187 
188 struct RUNTIME_9060 {
189 	__u32	loc_addr_range;	/* 00h - Local Address Range */
190 	__u32	loc_addr_base;	/* 04h - Local Address Base */
191 	__u32	loc_arbitr;	/* 08h - Local Arbitration */
192 	__u32	endian_descr;	/* 0Ch - Big/Little Endian Descriptor */
193 	__u32	loc_rom_range;	/* 10h - Local ROM Range */
194 	__u32	loc_rom_base;	/* 14h - Local ROM Base */
195 	__u32	loc_bus_descr;	/* 18h - Local Bus descriptor */
196 	__u32	loc_range_mst;	/* 1Ch - Local Range for Master to PCI */
197 	__u32	loc_base_mst;	/* 20h - Local Base for Master PCI */
198 	__u32	loc_range_io;	/* 24h - Local Range for Master IO */
199 	__u32	pci_base_mst;	/* 28h - PCI Base for Master PCI */
200 	__u32	pci_conf_io;	/* 2Ch - PCI configuration for Master IO */
201 	__u32	filler1;	/* 30h */
202 	__u32	filler2;	/* 34h */
203 	__u32	filler3;	/* 38h */
204 	__u32	filler4;	/* 3Ch */
205 	__u32	mail_box_0;	/* 40h - Mail Box 0 */
206 	__u32	mail_box_1;	/* 44h - Mail Box 1 */
207 	__u32	mail_box_2;	/* 48h - Mail Box 2 */
208 	__u32	mail_box_3;	/* 4Ch - Mail Box 3 */
209 	__u32	filler5;	/* 50h */
210 	__u32	filler6;	/* 54h */
211 	__u32	filler7;	/* 58h */
212 	__u32	filler8;	/* 5Ch */
213 	__u32	pci_doorbell;	/* 60h - PCI to Local Doorbell */
214 	__u32	loc_doorbell;	/* 64h - Local to PCI Doorbell */
215 	__u32	intr_ctrl_stat;	/* 68h - Interrupt Control/Status */
216 	__u32	init_ctrl;	/* 6Ch - EEPROM control, Init Control, etc */
217 };
218 
219 /* Values for the Local Base Address re-map register */
220 
221 #define	WIN_RAM		0x00000001L	/* set the sliding window to RAM */
222 #define	WIN_CREG	0x14000001L	/* set the window to custom Registers */
223 
224 /* Values timer select registers */
225 
226 #define	TIMER_BY_1M	0x00		/* clock divided by 1M */
227 #define	TIMER_BY_256K	0x01		/* clock divided by 256k */
228 #define	TIMER_BY_128K	0x02		/* clock divided by 128k */
229 #define	TIMER_BY_32K	0x03		/* clock divided by 32k */
230 
231 /****************** ****************** *******************/
232 #endif
233 
234 #ifndef ZFIRM_ID
235 /* #include "zfwint.h" */
236 /****************** ****************** *******************/
237 /*
238  *	This file contains the definitions for interfacing with the
239  *	Cyclom-Z ZFIRM Firmware.
240  */
241 
242 /* General Constant definitions */
243 
244 #define	MAX_CHAN	64		/* max number of channels per board */
245 
246 /* firmware id structure (set after boot) */
247 
248 #define ID_ADDRESS	0x00000180L	/* signature/pointer address */
249 #define	ZFIRM_ID	0x5557465AL	/* ZFIRM/U signature */
250 #define	ZFIRM_HLT	0x59505B5CL	/* ZFIRM needs external power supply */
251 #define	ZFIRM_RST	0x56040674L	/* RST signal (due to FW reset) */
252 
253 #define	ZF_TINACT_DEF	1000		/* default inactivity timeout
254 					   (1000 ms) */
255 #define	ZF_TINACT	ZF_TINACT_DEF
256 
257 struct	FIRM_ID {
258 	__u32	signature;		/* ZFIRM/U signature */
259 	__u32	zfwctrl_addr;		/* pointer to ZFW_CTRL structure */
260 };
261 
262 /* Op. System id */
263 
264 #define	C_OS_LINUX	0x00000030	/* generic Linux system */
265 
266 /* channel op_mode */
267 
268 #define	C_CH_DISABLE	0x00000000	/* channel is disabled */
269 #define	C_CH_TXENABLE	0x00000001	/* channel Tx enabled */
270 #define	C_CH_RXENABLE	0x00000002	/* channel Rx enabled */
271 #define	C_CH_ENABLE	0x00000003	/* channel Tx/Rx enabled */
272 #define	C_CH_LOOPBACK	0x00000004	/* Loopback mode */
273 
274 /* comm_parity - parity */
275 
276 #define	C_PR_NONE	0x00000000	/* None */
277 #define	C_PR_ODD	0x00000001	/* Odd */
278 #define C_PR_EVEN	0x00000002	/* Even */
279 #define C_PR_MARK	0x00000004	/* Mark */
280 #define C_PR_SPACE	0x00000008	/* Space */
281 #define C_PR_PARITY	0x000000ff
282 
283 #define	C_PR_DISCARD	0x00000100	/* discard char with frame/par error */
284 #define C_PR_IGNORE	0x00000200	/* ignore frame/par error */
285 
286 /* comm_data_l - data length and stop bits */
287 
288 #define C_DL_CS5	0x00000001
289 #define C_DL_CS6	0x00000002
290 #define C_DL_CS7	0x00000004
291 #define C_DL_CS8	0x00000008
292 #define	C_DL_CS		0x0000000f
293 #define C_DL_1STOP	0x00000010
294 #define C_DL_15STOP	0x00000020
295 #define C_DL_2STOP	0x00000040
296 #define	C_DL_STOP	0x000000f0
297 
298 /* interrupt enabling/status */
299 
300 #define	C_IN_DISABLE	0x00000000	/* zero, disable interrupts */
301 #define	C_IN_TXBEMPTY	0x00000001	/* tx buffer empty */
302 #define	C_IN_TXLOWWM	0x00000002	/* tx buffer below LWM */
303 #define	C_IN_RXHIWM	0x00000010	/* rx buffer above HWM */
304 #define	C_IN_RXNNDT	0x00000020	/* rx no new data timeout */
305 #define	C_IN_MDCD	0x00000100	/* modem DCD change */
306 #define	C_IN_MDSR	0x00000200	/* modem DSR change */
307 #define	C_IN_MRI	0x00000400	/* modem RI change */
308 #define	C_IN_MCTS	0x00000800	/* modem CTS change */
309 #define	C_IN_RXBRK	0x00001000	/* Break received */
310 #define	C_IN_PR_ERROR	0x00002000	/* parity error */
311 #define	C_IN_FR_ERROR	0x00004000	/* frame error */
312 #define C_IN_OVR_ERROR  0x00008000      /* overrun error */
313 #define C_IN_RXOFL	0x00010000      /* RX buffer overflow */
314 #define C_IN_IOCTLW	0x00020000      /* I/O control w/ wait */
315 #define C_IN_MRTS	0x00040000	/* modem RTS drop */
316 #define C_IN_ICHAR	0x00080000
317 
318 /* flow control */
319 
320 #define	C_FL_OXX	0x00000001	/* output Xon/Xoff flow control */
321 #define	C_FL_IXX	0x00000002	/* output Xon/Xoff flow control */
322 #define C_FL_OIXANY	0x00000004	/* output Xon/Xoff (any xon) */
323 #define	C_FL_SWFLOW	0x0000000f
324 
325 /* flow status */
326 
327 #define	C_FS_TXIDLE	0x00000000	/* no Tx data in the buffer or UART */
328 #define	C_FS_SENDING	0x00000001	/* UART is sending data */
329 #define	C_FS_SWFLOW	0x00000002	/* Tx is stopped by received Xoff */
330 
331 /* rs_control/rs_status RS-232 signals */
332 
333 #define C_RS_PARAM	0x80000000	/* Indicates presence of parameter in
334 					   IOCTLM command */
335 #define	C_RS_RTS	0x00000001	/* RTS */
336 #define	C_RS_DTR	0x00000004	/* DTR */
337 #define	C_RS_DCD	0x00000100	/* CD */
338 #define	C_RS_DSR	0x00000200	/* DSR */
339 #define	C_RS_RI		0x00000400	/* RI */
340 #define	C_RS_CTS	0x00000800	/* CTS */
341 
342 /* commands Host <-> Board */
343 
344 #define	C_CM_RESET	0x01		/* reset/flush buffers */
345 #define	C_CM_IOCTL	0x02		/* re-read CH_CTRL */
346 #define	C_CM_IOCTLW	0x03		/* re-read CH_CTRL, intr when done */
347 #define	C_CM_IOCTLM	0x04		/* RS-232 outputs change */
348 #define	C_CM_SENDXOFF	0x10		/* send Xoff */
349 #define	C_CM_SENDXON	0x11		/* send Xon */
350 #define C_CM_CLFLOW	0x12		/* Clear flow control (resume) */
351 #define	C_CM_SENDBRK	0x41		/* send break */
352 #define	C_CM_INTBACK	0x42		/* Interrupt back */
353 #define	C_CM_SET_BREAK	0x43		/* Tx break on */
354 #define	C_CM_CLR_BREAK	0x44		/* Tx break off */
355 #define	C_CM_CMD_DONE	0x45		/* Previous command done */
356 #define C_CM_INTBACK2	0x46		/* Alternate Interrupt back */
357 #define	C_CM_TINACT	0x51		/* set inactivity detection */
358 #define	C_CM_IRQ_ENBL	0x52		/* enable generation of interrupts */
359 #define	C_CM_IRQ_DSBL	0x53		/* disable generation of interrupts */
360 #define	C_CM_ACK_ENBL	0x54		/* enable acknowledged interrupt mode */
361 #define	C_CM_ACK_DSBL	0x55		/* disable acknowledged intr mode */
362 #define	C_CM_FLUSH_RX	0x56		/* flushes Rx buffer */
363 #define	C_CM_FLUSH_TX	0x57		/* flushes Tx buffer */
364 #define C_CM_Q_ENABLE	0x58		/* enables queue access from the
365 					   driver */
366 #define C_CM_Q_DISABLE  0x59            /* disables queue access from the
367 					   driver */
368 
369 #define	C_CM_TXBEMPTY	0x60		/* Tx buffer is empty */
370 #define	C_CM_TXLOWWM	0x61		/* Tx buffer low water mark */
371 #define	C_CM_RXHIWM	0x62		/* Rx buffer high water mark */
372 #define	C_CM_RXNNDT	0x63		/* rx no new data timeout */
373 #define	C_CM_TXFEMPTY	0x64
374 #define	C_CM_ICHAR	0x65
375 #define	C_CM_MDCD	0x70		/* modem DCD change */
376 #define	C_CM_MDSR	0x71		/* modem DSR change */
377 #define	C_CM_MRI	0x72		/* modem RI change */
378 #define	C_CM_MCTS	0x73		/* modem CTS change */
379 #define C_CM_MRTS	0x74		/* modem RTS drop */
380 #define	C_CM_RXBRK	0x84		/* Break received */
381 #define	C_CM_PR_ERROR	0x85		/* Parity error */
382 #define	C_CM_FR_ERROR	0x86		/* Frame error */
383 #define C_CM_OVR_ERROR  0x87            /* Overrun error */
384 #define C_CM_RXOFL	0x88            /* RX buffer overflow */
385 #define	C_CM_CMDERROR	0x90		/* command error */
386 #define	C_CM_FATAL	0x91		/* fatal error */
387 #define	C_CM_HW_RESET	0x92		/* reset board */
388 
389 /*
390  *	CH_CTRL - This per port structure contains all parameters
391  *	that control an specific port. It can be seen as the
392  *	configuration registers of a "super-serial-controller".
393  */
394 
395 struct CH_CTRL {
396 	__u32	op_mode;	/* operation mode */
397 	__u32	intr_enable;	/* interrupt masking */
398 	__u32	sw_flow;	/* SW flow control */
399 	__u32	flow_status;	/* output flow status */
400 	__u32	comm_baud;	/* baud rate  - numerically specified */
401 	__u32	comm_parity;	/* parity */
402 	__u32	comm_data_l;	/* data length/stop */
403 	__u32	comm_flags;	/* other flags */
404 	__u32	hw_flow;	/* HW flow control */
405 	__u32	rs_control;	/* RS-232 outputs */
406 	__u32	rs_status;	/* RS-232 inputs */
407 	__u32	flow_xon;	/* xon char */
408 	__u32	flow_xoff;	/* xoff char */
409 	__u32	hw_overflow;	/* hw overflow counter */
410 	__u32	sw_overflow;	/* sw overflow counter */
411 	__u32	comm_error;	/* frame/parity error counter */
412 	__u32 ichar;
413 	__u32 filler[7];
414 };
415 
416 
417 /*
418  *	BUF_CTRL - This per channel structure contains
419  *	all Tx and Rx buffer control for a given channel.
420  */
421 
422 struct	BUF_CTRL	{
423 	__u32	flag_dma;	/* buffers are in Host memory */
424 	__u32	tx_bufaddr;	/* address of the tx buffer */
425 	__u32	tx_bufsize;	/* tx buffer size */
426 	__u32	tx_threshold;	/* tx low water mark */
427 	__u32	tx_get;		/* tail index tx buf */
428 	__u32	tx_put;		/* head index tx buf */
429 	__u32	rx_bufaddr;	/* address of the rx buffer */
430 	__u32	rx_bufsize;	/* rx buffer size */
431 	__u32	rx_threshold;	/* rx high water mark */
432 	__u32	rx_get;		/* tail index rx buf */
433 	__u32	rx_put;		/* head index rx buf */
434 	__u32	filler[5];	/* filler to align structures */
435 };
436 
437 /*
438  *	BOARD_CTRL - This per board structure contains all global
439  *	control fields related to the board.
440  */
441 
442 struct BOARD_CTRL {
443 
444 	/* static info provided by the on-board CPU */
445 	__u32	n_channel;	/* number of channels */
446 	__u32	fw_version;	/* firmware version */
447 
448 	/* static info provided by the driver */
449 	__u32	op_system;	/* op_system id */
450 	__u32	dr_version;	/* driver version */
451 
452 	/* board control area */
453 	__u32	inactivity;	/* inactivity control */
454 
455 	/* host to FW commands */
456 	__u32	hcmd_channel;	/* channel number */
457 	__u32	hcmd_param;	/* pointer to parameters */
458 
459 	/* FW to Host commands */
460 	__u32	fwcmd_channel;	/* channel number */
461 	__u32	fwcmd_param;	/* pointer to parameters */
462 	__u32	zf_int_queue_addr; /* offset for INT_QUEUE structure */
463 
464 	/* filler so the structures are aligned */
465 	__u32	filler[6];
466 };
467 
468 /* Host Interrupt Queue */
469 
470 #define QUEUE_SIZE	(10*MAX_CHAN)
471 
472 struct	INT_QUEUE {
473 	unsigned char	intr_code[QUEUE_SIZE];
474 	unsigned long	channel[QUEUE_SIZE];
475 	unsigned long	param[QUEUE_SIZE];
476 	unsigned long	put;
477 	unsigned long	get;
478 };
479 
480 /*
481  *	ZFW_CTRL - This is the data structure that includes all other
482  *	data structures used by the Firmware.
483  */
484 
485 struct ZFW_CTRL {
486 	struct BOARD_CTRL	board_ctrl;
487 	struct CH_CTRL		ch_ctrl[MAX_CHAN];
488 	struct BUF_CTRL		buf_ctrl[MAX_CHAN];
489 };
490 
491 /****************** ****************** *******************/
492 #endif
493 
494 #endif /* _UAPI_LINUX_CYCLADES_H */
495