xref: /linux/drivers/scsi/sym53c8xx_2/sym_nvram.h (revision e7d759f31ca295d589f7420719c311870bb3166f)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * Device driver for the SYMBIOS/LSILOGIC 53C8XX and 53C1010 family
4  * of PCI-SCSI IO processors.
5  *
6  * Copyright (C) 1999-2001  Gerard Roudier <groudier@free.fr>
7  *
8  * This driver is derived from the Linux sym53c8xx driver.
9  * Copyright (C) 1998-2000  Gerard Roudier
10  *
11  * The sym53c8xx driver is derived from the ncr53c8xx driver that had been
12  * a port of the FreeBSD ncr driver to Linux-1.2.13.
13  *
14  * The original ncr driver has been written for 386bsd and FreeBSD by
15  *         Wolfgang Stanglmeier        <wolf@cologne.de>
16  *         Stefan Esser                <se@mi.Uni-Koeln.de>
17  * Copyright (C) 1994  Wolfgang Stanglmeier
18  *
19  * Other major contributions:
20  *
21  * NVRAM detection and reading.
22  * Copyright (C) 1997 Richard Waltham <dormouse@farsrobt.demon.co.uk>
23  *
24  *-----------------------------------------------------------------------------
25  */
26 
27 #ifndef SYM_NVRAM_H
28 #define SYM_NVRAM_H
29 
30 #include "sym53c8xx.h"
31 
32 /*
33  *	Symbios NVRAM data format
34  */
35 #define SYMBIOS_NVRAM_SIZE 368
36 #define SYMBIOS_NVRAM_ADDRESS 0x100
37 
38 struct Symbios_nvram {
39 /* Header 6 bytes */
40 	u_short type;		/* 0x0000 */
41 	u_short byte_count;	/* excluding header/trailer */
42 	u_short checksum;
43 
44 /* Controller set up 20 bytes */
45 	u_char	v_major;	/* 0x00 */
46 	u_char	v_minor;	/* 0x30 */
47 	u32	boot_crc;
48 	u_short	flags;
49 #define SYMBIOS_SCAM_ENABLE	(1)
50 #define SYMBIOS_PARITY_ENABLE	(1<<1)
51 #define SYMBIOS_VERBOSE_MSGS	(1<<2)
52 #define SYMBIOS_CHS_MAPPING	(1<<3)
53 #define SYMBIOS_NO_NVRAM	(1<<3)	/* ??? */
54 	u_short	flags1;
55 #define SYMBIOS_SCAN_HI_LO	(1)
56 	u_short	term_state;
57 #define SYMBIOS_TERM_CANT_PROGRAM	(0)
58 #define SYMBIOS_TERM_ENABLED		(1)
59 #define SYMBIOS_TERM_DISABLED		(2)
60 	u_short	rmvbl_flags;
61 #define SYMBIOS_RMVBL_NO_SUPPORT	(0)
62 #define SYMBIOS_RMVBL_BOOT_DEVICE	(1)
63 #define SYMBIOS_RMVBL_MEDIA_INSTALLED	(2)
64 	u_char	host_id;
65 	u_char	num_hba;	/* 0x04 */
66 	u_char	num_devices;	/* 0x10 */
67 	u_char	max_scam_devices;	/* 0x04 */
68 	u_char	num_valid_scam_devices;	/* 0x00 */
69 	u_char	flags2;
70 #define SYMBIOS_AVOID_BUS_RESET		(1<<2)
71 
72 /* Boot order 14 bytes * 4 */
73 	struct Symbios_host{
74 		u_short	type;		/* 4:8xx / 0:nok */
75 		u_short	device_id;	/* PCI device id */
76 		u_short	vendor_id;	/* PCI vendor id */
77 		u_char	bus_nr;		/* PCI bus number */
78 		u_char	device_fn;	/* PCI device/function number << 3*/
79 		u_short	word8;
80 		u_short	flags;
81 #define	SYMBIOS_INIT_SCAN_AT_BOOT	(1)
82 		u_short	io_port;	/* PCI io_port address */
83 	} host[4];
84 
85 /* Targets 8 bytes * 16 */
86 	struct Symbios_target {
87 		u_char	flags;
88 #define SYMBIOS_DISCONNECT_ENABLE	(1)
89 #define SYMBIOS_SCAN_AT_BOOT_TIME	(1<<1)
90 #define SYMBIOS_SCAN_LUNS		(1<<2)
91 #define SYMBIOS_QUEUE_TAGS_ENABLED	(1<<3)
92 		u_char	rsvd;
93 		u_char	bus_width;	/* 0x08/0x10 */
94 		u_char	sync_offset;
95 		u_short	sync_period;	/* 4*period factor */
96 		u_short	timeout;
97 	} target[16];
98 /* Scam table 8 bytes * 4 */
99 	struct Symbios_scam {
100 		u_short	id;
101 		u_short	method;
102 #define SYMBIOS_SCAM_DEFAULT_METHOD	(0)
103 #define SYMBIOS_SCAM_DONT_ASSIGN	(1)
104 #define SYMBIOS_SCAM_SET_SPECIFIC_ID	(2)
105 #define SYMBIOS_SCAM_USE_ORDER_GIVEN	(3)
106 		u_short status;
107 #define SYMBIOS_SCAM_UNKNOWN		(0)
108 #define SYMBIOS_SCAM_DEVICE_NOT_FOUND	(1)
109 #define SYMBIOS_SCAM_ID_NOT_SET		(2)
110 #define SYMBIOS_SCAM_ID_VALID		(3)
111 		u_char	target_id;
112 		u_char	rsvd;
113 	} scam[4];
114 
115 	u_char	spare_devices[15*8];
116 	u_char	trailer[6];		/* 0xfe 0xfe 0x00 0x00 0x00 0x00 */
117 };
118 typedef struct Symbios_nvram	Symbios_nvram;
119 typedef struct Symbios_host	Symbios_host;
120 typedef struct Symbios_target	Symbios_target;
121 typedef struct Symbios_scam	Symbios_scam;
122 
123 /*
124  *	Tekram NvRAM data format.
125  */
126 #define TEKRAM_NVRAM_SIZE 64
127 #define TEKRAM_93C46_NVRAM_ADDRESS 0
128 #define TEKRAM_24C16_NVRAM_ADDRESS 0x40
129 
130 struct Tekram_nvram {
131 	struct Tekram_target {
132 		u_char	flags;
133 #define	TEKRAM_PARITY_CHECK		(1)
134 #define TEKRAM_SYNC_NEGO		(1<<1)
135 #define TEKRAM_DISCONNECT_ENABLE	(1<<2)
136 #define	TEKRAM_START_CMD		(1<<3)
137 #define TEKRAM_TAGGED_COMMANDS		(1<<4)
138 #define TEKRAM_WIDE_NEGO		(1<<5)
139 		u_char	sync_index;
140 		u_short	word2;
141 	} target[16];
142 	u_char	host_id;
143 	u_char	flags;
144 #define TEKRAM_MORE_THAN_2_DRIVES	(1)
145 #define TEKRAM_DRIVES_SUP_1GB		(1<<1)
146 #define	TEKRAM_RESET_ON_POWER_ON	(1<<2)
147 #define TEKRAM_ACTIVE_NEGATION		(1<<3)
148 #define TEKRAM_IMMEDIATE_SEEK		(1<<4)
149 #define	TEKRAM_SCAN_LUNS		(1<<5)
150 #define	TEKRAM_REMOVABLE_FLAGS		(3<<6)	/* 0: disable; */
151 						/* 1: boot device; 2:all */
152 	u_char	boot_delay_index;
153 	u_char	max_tags_index;
154 	u_short	flags1;
155 #define TEKRAM_F2_F6_ENABLED		(1)
156 	u_short	spare[29];
157 };
158 typedef struct Tekram_nvram	Tekram_nvram;
159 typedef struct Tekram_target	Tekram_target;
160 
161 #ifndef CONFIG_PARISC
162 struct pdc_initiator { int dummy; };
163 #endif
164 
165 /*
166  *  Union of supported NVRAM formats.
167  */
168 struct sym_nvram {
169 	int type;
170 #define	SYM_SYMBIOS_NVRAM	(1)
171 #define	SYM_TEKRAM_NVRAM	(2)
172 #define SYM_PARISC_PDC		(3)
173 #if SYM_CONF_NVRAM_SUPPORT
174 	union {
175 		Symbios_nvram Symbios;
176 		Tekram_nvram Tekram;
177 		struct pdc_initiator parisc;
178 	} data;
179 #endif
180 };
181 
182 #if SYM_CONF_NVRAM_SUPPORT
183 void sym_nvram_setup_host(struct Scsi_Host *shost, struct sym_hcb *np, struct sym_nvram *nvram);
184 void sym_nvram_setup_target (struct sym_tcb *tp, int target, struct sym_nvram *nvp);
185 int sym_read_nvram (struct sym_device *np, struct sym_nvram *nvp);
186 char *sym_nvram_type(struct sym_nvram *nvp);
187 #else
188 static inline void sym_nvram_setup_host(struct Scsi_Host *shost, struct sym_hcb *np, struct sym_nvram *nvram) { }
189 static inline void sym_nvram_setup_target(struct sym_tcb *tp, struct sym_nvram *nvram) { }
190 static inline int sym_read_nvram(struct sym_device *np, struct sym_nvram *nvp)
191 {
192 	nvp->type = 0;
193 	return 0;
194 }
195 static inline char *sym_nvram_type(struct sym_nvram *nvp)
196 {
197 	return "No NVRAM";
198 }
199 #endif
200 
201 #endif /* SYM_NVRAM_H */
202