1 /* 2 * Device driver for the SYMBIOS/LSILOGIC 53C8XX and 53C1010 family 3 * of PCI-SCSI IO processors. 4 * 5 * Copyright (C) 1999-2001 Gerard Roudier <groudier@free.fr> 6 * 7 * This driver is derived from the Linux sym53c8xx driver. 8 * Copyright (C) 1998-2000 Gerard Roudier 9 * 10 * The sym53c8xx driver is derived from the ncr53c8xx driver that had been 11 * a port of the FreeBSD ncr driver to Linux-1.2.13. 12 * 13 * The original ncr driver has been written for 386bsd and FreeBSD by 14 * Wolfgang Stanglmeier <wolf@cologne.de> 15 * Stefan Esser <se@mi.Uni-Koeln.de> 16 * Copyright (C) 1994 Wolfgang Stanglmeier 17 * 18 * Other major contributions: 19 * 20 * NVRAM detection and reading. 21 * Copyright (C) 1997 Richard Waltham <dormouse@farsrobt.demon.co.uk> 22 * 23 *----------------------------------------------------------------------------- 24 * 25 * This program is free software; you can redistribute it and/or modify 26 * it under the terms of the GNU General Public License as published by 27 * the Free Software Foundation; either version 2 of the License, or 28 * (at your option) any later version. 29 * 30 * This program is distributed in the hope that it will be useful, 31 * but WITHOUT ANY WARRANTY; without even the implied warranty of 32 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 33 * GNU General Public License for more details. 34 * 35 * You should have received a copy of the GNU General Public License 36 * along with this program; if not, write to the Free Software 37 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 38 */ 39 40 #ifndef SYM_FW_H 41 #define SYM_FW_H 42 /* 43 * Macro used to generate interfaces for script A. 44 */ 45 #define SYM_GEN_FW_A(s) \ 46 SYM_GEN_A(s, start) SYM_GEN_A(s, getjob_begin) \ 47 SYM_GEN_A(s, getjob_end) \ 48 SYM_GEN_A(s, select) SYM_GEN_A(s, wf_sel_done) \ 49 SYM_GEN_A(s, send_ident) \ 50 SYM_GEN_A(s, dispatch) SYM_GEN_A(s, init) \ 51 SYM_GEN_A(s, clrack) SYM_GEN_A(s, complete_error) \ 52 SYM_GEN_A(s, done) SYM_GEN_A(s, done_end) \ 53 SYM_GEN_A(s, idle) SYM_GEN_A(s, ungetjob) \ 54 SYM_GEN_A(s, reselect) \ 55 SYM_GEN_A(s, resel_tag) SYM_GEN_A(s, resel_dsa) \ 56 SYM_GEN_A(s, resel_no_tag) \ 57 SYM_GEN_A(s, data_in) SYM_GEN_A(s, data_in2) \ 58 SYM_GEN_A(s, data_out) SYM_GEN_A(s, data_out2) \ 59 SYM_GEN_A(s, pm0_data) SYM_GEN_A(s, pm1_data) 60 61 /* 62 * Macro used to generate interfaces for script B. 63 */ 64 #define SYM_GEN_FW_B(s) \ 65 SYM_GEN_B(s, no_data) \ 66 SYM_GEN_B(s, sel_for_abort) SYM_GEN_B(s, sel_for_abort_1) \ 67 SYM_GEN_B(s, msg_bad) SYM_GEN_B(s, msg_weird) \ 68 SYM_GEN_B(s, wdtr_resp) SYM_GEN_B(s, send_wdtr) \ 69 SYM_GEN_B(s, sdtr_resp) SYM_GEN_B(s, send_sdtr) \ 70 SYM_GEN_B(s, ppr_resp) SYM_GEN_B(s, send_ppr) \ 71 SYM_GEN_B(s, nego_bad_phase) \ 72 SYM_GEN_B(s, ident_break) SYM_GEN_B(s, ident_break_atn) \ 73 SYM_GEN_B(s, sdata_in) SYM_GEN_B(s, resel_bad_lun) \ 74 SYM_GEN_B(s, bad_i_t_l) SYM_GEN_B(s, bad_i_t_l_q) \ 75 SYM_GEN_B(s, wsr_ma_helper) 76 77 /* 78 * Macro used to generate interfaces for script Z. 79 */ 80 #define SYM_GEN_FW_Z(s) \ 81 SYM_GEN_Z(s, snooptest) SYM_GEN_Z(s, snoopend) 82 83 /* 84 * Generates structure interface that contains 85 * offsets within script A, B and Z. 86 */ 87 #define SYM_GEN_A(s, label) s label; 88 #define SYM_GEN_B(s, label) s label; 89 #define SYM_GEN_Z(s, label) s label; 90 struct sym_fwa_ofs { 91 SYM_GEN_FW_A(u_short) 92 }; 93 struct sym_fwb_ofs { 94 SYM_GEN_FW_B(u_short) 95 SYM_GEN_B(u_short, start64) 96 SYM_GEN_B(u_short, pm_handle) 97 }; 98 struct sym_fwz_ofs { 99 SYM_GEN_FW_Z(u_short) 100 }; 101 102 /* 103 * Generates structure interface that contains 104 * bus addresses within script A, B and Z. 105 */ 106 struct sym_fwa_ba { 107 SYM_GEN_FW_A(u32) 108 }; 109 struct sym_fwb_ba { 110 SYM_GEN_FW_B(u32) 111 SYM_GEN_B(u32, start64); 112 SYM_GEN_B(u32, pm_handle); 113 }; 114 struct sym_fwz_ba { 115 SYM_GEN_FW_Z(u32) 116 }; 117 #undef SYM_GEN_A 118 #undef SYM_GEN_B 119 #undef SYM_GEN_Z 120 121 /* 122 * Let cc know about the name of the controller data structure. 123 * We need this for function prototype declarations just below. 124 */ 125 struct sym_hcb; 126 127 /* 128 * Generic structure that defines a firmware. 129 */ 130 struct sym_fw { 131 char *name; /* Name we want to print out */ 132 u32 *a_base; /* Pointer to script A template */ 133 int a_size; /* Size of script A */ 134 struct sym_fwa_ofs 135 *a_ofs; /* Useful offsets in script A */ 136 u32 *b_base; /* Pointer to script B template */ 137 int b_size; /* Size of script B */ 138 struct sym_fwb_ofs 139 *b_ofs; /* Useful offsets in script B */ 140 u32 *z_base; /* Pointer to script Z template */ 141 int z_size; /* Size of script Z */ 142 struct sym_fwz_ofs 143 *z_ofs; /* Useful offsets in script Z */ 144 /* Setup and patch methods for this firmware */ 145 void (*setup)(struct sym_hcb *, struct sym_fw *); 146 void (*patch)(struct Scsi_Host *); 147 }; 148 149 /* 150 * Macro used to declare a firmware. 151 */ 152 #define SYM_FW_ENTRY(fw, name) \ 153 { \ 154 name, \ 155 (u32 *) &fw##a_scr, sizeof(fw##a_scr), &fw##a_ofs, \ 156 (u32 *) &fw##b_scr, sizeof(fw##b_scr), &fw##b_ofs, \ 157 (u32 *) &fw##z_scr, sizeof(fw##z_scr), &fw##z_ofs, \ 158 fw##_setup, fw##_patch \ 159 } 160 161 /* 162 * Macros used from the C code to get useful 163 * SCRIPTS bus addresses. 164 */ 165 #define SCRIPTA_BA(np, label) (np->fwa_bas.label) 166 #define SCRIPTB_BA(np, label) (np->fwb_bas.label) 167 #define SCRIPTZ_BA(np, label) (np->fwz_bas.label) 168 169 /* 170 * Macros used by scripts definitions. 171 * 172 * HADDR_1 generates a reference to a field of the controller data. 173 * HADDR_2 generates a reference to a field of the controller data 174 * with offset. 175 * RADDR_1 generates a reference to a script processor register. 176 * RADDR_2 generates a reference to a script processor register 177 * with offset. 178 * PADDR_A generates a reference to another part of script A. 179 * PADDR_B generates a reference to another part of script B. 180 * 181 * SYM_GEN_PADDR_A and SYM_GEN_PADDR_B are used to define respectively 182 * the PADDR_A and PADDR_B macros for each firmware by setting argument 183 * `s' to the name of the corresponding structure. 184 * 185 * SCR_DATA_ZERO is used to allocate a DWORD of data in scripts areas. 186 */ 187 188 #define RELOC_SOFTC 0x40000000 189 #define RELOC_LABEL_A 0x50000000 190 #define RELOC_REGISTER 0x60000000 191 #define RELOC_LABEL_B 0x80000000 192 #define RELOC_MASK 0xf0000000 193 194 #define HADDR_1(label) (RELOC_SOFTC | offsetof(struct sym_hcb, label)) 195 #define HADDR_2(label,ofs) (RELOC_SOFTC | \ 196 (offsetof(struct sym_hcb, label)+(ofs))) 197 #define RADDR_1(label) (RELOC_REGISTER | REG(label)) 198 #define RADDR_2(label,ofs) (RELOC_REGISTER | ((REG(label))+(ofs))) 199 200 #define SYM_GEN_PADDR_A(s, label) (RELOC_LABEL_A | offsetof(s, label)) 201 #define SYM_GEN_PADDR_B(s, label) (RELOC_LABEL_B | offsetof(s, label)) 202 203 #define SCR_DATA_ZERO 0xf00ff00f 204 205 #endif /* SYM_FW_H */ 206