1 /*- 2 * Copyright (c) 2000 Michael Smith 3 * Copyright (c) 2000 BSDi 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25 * SUCH DAMAGE. 26 * 27 * $FreeBSD: src/sys/dev/twe/twereg.h,v 1.1.2.4 2002/03/07 09:57:02 msmith Exp $ 28 * $DragonFly: src/sys/dev/raid/twe/twereg.h,v 1.2 2003/06/17 04:28:32 dillon Exp $ 29 */ 30 31 /* 32 * Register names, bit definitions, structure names and members are 33 * identical with those in the Linux driver where possible and sane 34 * for simplicity's sake. (The TW_ prefix has become TWE_) 35 * Some defines that are clearly irrelevant to FreeBSD have been 36 * removed. 37 */ 38 39 /* control register bit definitions */ 40 #define TWE_CONTROL_CLEAR_HOST_INTERRUPT 0x00080000 41 #define TWE_CONTROL_CLEAR_ATTENTION_INTERRUPT 0x00040000 42 #define TWE_CONTROL_MASK_COMMAND_INTERRUPT 0x00020000 43 #define TWE_CONTROL_MASK_RESPONSE_INTERRUPT 0x00010000 44 #define TWE_CONTROL_UNMASK_COMMAND_INTERRUPT 0x00008000 45 #define TWE_CONTROL_UNMASK_RESPONSE_INTERRUPT 0x00004000 46 #define TWE_CONTROL_CLEAR_ERROR_STATUS 0x00000200 47 #define TWE_CONTROL_ISSUE_SOFT_RESET 0x00000100 48 #define TWE_CONTROL_ENABLE_INTERRUPTS 0x00000080 49 #define TWE_CONTROL_DISABLE_INTERRUPTS 0x00000040 50 #define TWE_CONTROL_ISSUE_HOST_INTERRUPT 0x00000020 51 #define TWE_CONTROL_CLEAR_PARITY_ERROR 0x00800000 52 #define TWE_CONTROL_CLEAR_PCI_ABORT 0x00100000 53 54 #define TWE_SOFT_RESET(sc) TWE_CONTROL(sc, TWE_CONTROL_ISSUE_SOFT_RESET | \ 55 TWE_CONTROL_CLEAR_HOST_INTERRUPT | \ 56 TWE_CONTROL_CLEAR_ATTENTION_INTERRUPT | \ 57 TWE_CONTROL_MASK_COMMAND_INTERRUPT | \ 58 TWE_CONTROL_MASK_RESPONSE_INTERRUPT | \ 59 TWE_CONTROL_CLEAR_ERROR_STATUS | \ 60 TWE_CONTROL_DISABLE_INTERRUPTS) 61 62 /* status register bit definitions */ 63 #define TWE_STATUS_MAJOR_VERSION_MASK 0xF0000000 64 #define TWE_STATUS_MINOR_VERSION_MASK 0x0F000000 65 #define TWE_STATUS_PCI_PARITY_ERROR 0x00800000 66 #define TWE_STATUS_QUEUE_ERROR 0x00400000 67 #define TWE_STATUS_MICROCONTROLLER_ERROR 0x00200000 68 #define TWE_STATUS_PCI_ABORT 0x00100000 69 #define TWE_STATUS_HOST_INTERRUPT 0x00080000 70 #define TWE_STATUS_ATTENTION_INTERRUPT 0x00040000 71 #define TWE_STATUS_COMMAND_INTERRUPT 0x00020000 72 #define TWE_STATUS_RESPONSE_INTERRUPT 0x00010000 73 #define TWE_STATUS_COMMAND_QUEUE_FULL 0x00008000 74 #define TWE_STATUS_RESPONSE_QUEUE_EMPTY 0x00004000 75 #define TWE_STATUS_MICROCONTROLLER_READY 0x00002000 76 #define TWE_STATUS_COMMAND_QUEUE_EMPTY 0x00001000 77 #define TWE_STATUS_ALL_INTERRUPTS 0x000F0000 78 #define TWE_STATUS_CLEARABLE_BITS 0x00D00000 79 #define TWE_STATUS_EXPECTED_BITS 0x00002000 80 #define TWE_STATUS_UNEXPECTED_BITS 0x00F80000 81 82 /* XXX this is a little harsh, but necessary to chase down firmware problems */ 83 #define TWE_STATUS_PANIC_BITS (TWE_STATUS_MICROCONTROLLER_ERROR) 84 85 /* for use with the %b printf format */ 86 #define TWE_STATUS_BITS_DESCRIPTION \ 87 "\20\15CQEMPTY\16UCREADY\17RQEMPTY\20CQFULL\21RINTR\22CINTR\23AINTR\24HINTR\25PCIABRT\26MCERR\27QERR\30PCIPERR\n" 88 89 /* detect inconsistencies in the status register */ 90 #define TWE_STATUS_ERRORS(x) \ 91 (((x & TWE_STATUS_PCI_ABORT) || \ 92 (x & TWE_STATUS_PCI_PARITY_ERROR) || \ 93 (x & TWE_STATUS_QUEUE_ERROR) || \ 94 (x & TWE_STATUS_MICROCONTROLLER_ERROR)) && \ 95 (x & TWE_STATUS_MICROCONTROLLER_READY)) 96 97 /* Response queue bit definitions */ 98 #define TWE_RESPONSE_ID_MASK 0x00000FF0 99 100 /* PCI related defines */ 101 #define TWE_IO_CONFIG_REG 0x10 102 #define TWE_DEVICE_NAME "3ware Storage Controller" 103 #define TWE_VENDOR_ID 0x13C1 104 #define TWE_DEVICE_ID 0x1000 105 #define TWE_DEVICE_ID_ASIC 0x1001 106 #define TWE_PCI_CLEAR_PARITY_ERROR 0xc100 107 #define TWE_PCI_CLEAR_PCI_ABORT 0x2000 108 109 /* command packet opcodes */ 110 #define TWE_OP_NOP 0x00 111 #define TWE_OP_INIT_CONNECTION 0x01 112 #define TWE_OP_READ 0x02 113 #define TWE_OP_WRITE 0x03 114 #define TWE_OP_READVERIFY 0x04 115 #define TWE_OP_VERIFY 0x05 116 #define TWE_OP_ZEROUNIT 0x08 117 #define TWE_OP_REPLACEUNIT 0x09 118 #define TWE_OP_HOTSWAP 0x0a 119 #define TWE_OP_SETATAFEATURE 0x0c 120 #define TWE_OP_FLUSH 0x0e 121 #define TWE_OP_ABORT 0x0f 122 #define TWE_OP_CHECKSTATUS 0x10 123 #define TWE_OP_GET_PARAM 0x12 124 #define TWE_OP_SET_PARAM 0x13 125 #define TWE_OP_CREATEUNIT 0x14 126 #define TWE_OP_DELETEUNIT 0x15 127 #define TWE_OP_REBUILDUNIT 0x17 128 #define TWE_OP_SECTOR_INFO 0x1a 129 #define TWE_OP_AEN_LISTEN 0x1c 130 #define TWE_OP_CMD_PACKET 0x1d 131 #define TWE_OP_ATA_PASSTHROUGH 0x1e 132 #define TWE_OP_CMD_WITH_DATA 0x1f 133 134 /* command status values */ 135 #define TWE_STATUS_RESET 0xff /* controller requests reset */ 136 #define TWE_STATUS_FATAL 0xc0 /* fatal errors not requiring reset */ 137 #define TWE_STATUS_WARNING 0x80 /* warnings */ 138 #define TWE_STAUS_INFO 0x40 /* informative status */ 139 140 /* misc defines */ 141 #define TWE_ALIGNMENT 0x200 142 #define TWE_MAX_UNITS 16 143 #define TWE_COMMAND_ALIGNMENT_MASK 0x1ff 144 #define TWE_INIT_MESSAGE_CREDITS 0xff /* older firmware has issues with 256 commands */ 145 #define TWE_SHUTDOWN_MESSAGE_CREDITS 0x001 146 #define TWE_INIT_COMMAND_PACKET_SIZE 0x3 147 #define TWE_MAX_SGL_LENGTH 62 148 #define TWE_MAX_ATA_SGL_LENGTH 60 149 #define TWE_MAX_PASSTHROUGH 4096 150 #define TWE_Q_LENGTH TWE_INIT_MESSAGE_CREDITS 151 #define TWE_Q_START 0 152 #define TWE_MAX_RESET_TRIES 3 153 #define TWE_BLOCK_SIZE 0x200 /* 512-byte blocks */ 154 #define TWE_SECTOR_SIZE 0x200 /* generic I/O bufffer */ 155 #define TWE_IOCTL 0x80 156 #define TWE_MAX_AEN_TRIES 100 157 #define TWE_UNIT_ONLINE 1 158 159 /* scatter/gather list entry */ 160 typedef struct 161 { 162 u_int32_t address; 163 u_int32_t length; 164 } TWE_SG_Entry __attribute__ ((packed)); 165 166 typedef struct { 167 u_int8_t opcode:5; /* TWE_OP_INITCONNECTION */ 168 u_int8_t res1:3; 169 u_int8_t size; 170 u_int8_t request_id; 171 u_int8_t res2:4; 172 u_int8_t host_id:4; 173 u_int8_t status; 174 u_int8_t flags; 175 u_int16_t message_credits; 176 u_int32_t response_queue_pointer; 177 } TWE_Command_INITCONNECTION __attribute__ ((packed)); 178 179 typedef struct 180 { 181 u_int8_t opcode:5; /* TWE_OP_READ/TWE_OP_WRITE */ 182 u_int8_t res1:3; 183 u_int8_t size; 184 u_int8_t request_id; 185 u_int8_t unit:4; 186 u_int8_t host_id:4; 187 u_int8_t status; 188 u_int8_t flags; 189 u_int16_t block_count; 190 u_int32_t lba; 191 TWE_SG_Entry sgl[TWE_MAX_SGL_LENGTH]; 192 } TWE_Command_IO __attribute__ ((packed)); 193 194 typedef struct 195 { 196 u_int8_t opcode:5; /* TWE_OP_HOTSWAP */ 197 u_int8_t res1:3; 198 u_int8_t size; 199 u_int8_t request_id; 200 u_int8_t unit:4; 201 u_int8_t host_id:4; 202 u_int8_t status; 203 u_int8_t flags; 204 u_int8_t action; 205 #define TWE_OP_HOTSWAP_REMOVE 0x00 /* remove assumed-degraded unit */ 206 #define TWE_OP_HOTSWAP_ADD_CBOD 0x01 /* add CBOD to empty port */ 207 #define TWE_OP_HOTSWAP_ADD_SPARE 0x02 /* add spare to empty port */ 208 u_int8_t aport; 209 } TWE_Command_HOTSWAP __attribute__ ((packed)); 210 211 typedef struct 212 { 213 u_int8_t opcode:5; /* TWE_OP_SETATAFEATURE */ 214 u_int8_t res1:3; 215 u_int8_t size; 216 u_int8_t request_id; 217 u_int8_t unit:4; 218 u_int8_t host_id:4; 219 u_int8_t status; 220 u_int8_t flags; 221 u_int8_t feature; 222 #define TWE_OP_SETATAFEATURE_WCE 0x02 223 #define TWE_OP_SETATAFEATURE_DIS_WCE 0x82 224 u_int8_t feature_mode; 225 u_int16_t all_units; 226 u_int16_t persistence; 227 } TWE_Command_SETATAFEATURE __attribute__ ((packed)); 228 229 typedef struct 230 { 231 u_int8_t opcode:5; /* TWE_OP_CHECKSTATUS */ 232 u_int8_t res1:3; 233 u_int8_t size; 234 u_int8_t request_id; 235 u_int8_t unit:4; 236 u_int8_t res2:4; 237 u_int8_t status; 238 u_int8_t flags; 239 u_int16_t target_status; /* set low byte to target request's ID */ 240 } TWE_Command_CHECKSTATUS __attribute__ ((packed)); 241 242 typedef struct 243 { 244 u_int8_t opcode:5; /* TWE_OP_GETPARAM, TWE_OP_SETPARAM */ 245 u_int8_t res1:3; 246 u_int8_t size; 247 u_int8_t request_id; 248 u_int8_t unit:4; 249 u_int8_t host_id:4; 250 u_int8_t status; 251 u_int8_t flags; 252 u_int16_t param_count; 253 TWE_SG_Entry sgl[TWE_MAX_SGL_LENGTH]; 254 } TWE_Command_PARAM __attribute__ ((packed)); 255 256 typedef struct 257 { 258 u_int8_t opcode:5; /* TWE_OP_REBUILDUNIT */ 259 u_int8_t res1:3; 260 u_int8_t size; 261 u_int8_t request_id; 262 u_int8_t src_unit:4; 263 u_int8_t host_id:4; 264 u_int8_t status; 265 u_int8_t flags; 266 u_int8_t action:7; 267 #define TWE_OP_REBUILDUNIT_NOP 0 268 #define TWE_OP_REBUILDUNIT_STOP 2 /* stop all rebuilds */ 269 #define TWE_OP_REBUILDUNIT_START 4 /* start rebuild with lowest unit */ 270 #define TWE_OP_REBUILDUNIT_STARTUNIT 5 /* rebuild src_unit (not supported) */ 271 u_int8_t cs:1; /* request state change on src_unit */ 272 u_int8_t logical_subunit; /* for RAID10 rebuild of logical subunit */ 273 } TWE_Command_REBUILDUNIT __attribute__ ((packed)); 274 275 typedef struct 276 { 277 u_int8_t opcode:5; 278 u_int8_t sgl_offset:3; 279 u_int8_t size; 280 u_int8_t request_id; 281 u_int8_t unit:4; 282 u_int8_t host_id:4; 283 u_int8_t status; 284 u_int16_t param; 285 u_int16_t features; 286 u_int16_t sector_count; 287 u_int16_t sector_num; 288 u_int16_t cylinder_lo; 289 u_int16_t cylinder_hi; 290 u_int8_t drive_head; 291 u_int8_t command; 292 TWE_SG_Entry sgl[TWE_MAX_ATA_SGL_LENGTH]; 293 } TWE_Command_ATA __attribute__ ((packed)); 294 295 typedef struct 296 { 297 u_int8_t opcode:5; 298 u_int8_t sgl_offset:3; 299 u_int8_t size; 300 u_int8_t request_id; 301 u_int8_t unit:4; 302 u_int8_t host_id:4; 303 u_int8_t status; 304 u_int8_t flags; 305 #define TWE_FLAGS_SUCCESS 0x00 306 #define TWE_FLAGS_INFORMATIONAL 0x01 307 #define TWE_FLAGS_WARNING 0x02 308 #define TWE_FLAGS_FATAL 0x03 309 #define TWE_FLAGS_PERCENTAGE (1<<8) /* bits 0-6 indicate completion percentage */ 310 u_int16_t count; /* block count, parameter count, message credits */ 311 } TWE_Command_Generic __attribute__ ((packed)); 312 313 /* command packet - must be TWE_ALIGNMENT aligned */ 314 typedef union 315 { 316 TWE_Command_INITCONNECTION initconnection; 317 TWE_Command_IO io; 318 TWE_Command_PARAM param; 319 TWE_Command_CHECKSTATUS checkstatus; 320 TWE_Command_REBUILDUNIT rebuildunit; 321 TWE_Command_SETATAFEATURE setatafeature; 322 TWE_Command_ATA ata; 323 TWE_Command_Generic generic; 324 u_int8_t pad[512]; 325 } TWE_Command; 326 327 /* response queue entry */ 328 typedef union 329 { 330 struct 331 { 332 u_int32_t undefined_1:4; 333 u_int32_t response_id:8; 334 u_int32_t undefined_2:20; 335 } u; 336 u_int32_t value; 337 } TWE_Response_Queue; 338 339 /* 340 * From 3ware's documentation: 341 * All parameters maintained by the controller are grouped into related tables. 342 * Tables are are accessed indirectly via get and set parameter commands. 343 * To access a specific parameter in a table, the table ID and parameter index 344 * are used to uniquely identify a parameter. Table 0xffff is the directory 345 * table and provides a list of the table IDs and sizes of all other tables. 346 * Index zero in each table specifies the entire table, and index one specifies 347 * the size of the table. An entire table can be read or set by using index zero. 348 */ 349 350 #define TWE_PARAM_PARAM_ALL 0 351 #define TWE_PARAM_PARAM_SIZE 1 352 353 #define TWE_PARAM_DIRECTORY 0xffff /* size is 4 * number of tables */ 354 #define TWE_PARAM_DIRECTORY_TABLES 2 /* 16 bits * number of tables */ 355 #define TWE_PARAM_DIRECTORY_SIZES 3 /* 16 bits * number of tables */ 356 357 #define TWE_PARAM_DRIVESUMMARY 0x0002 358 #define TWE_PARAM_DRIVESUMMARY_Num 2 /* number of physical drives [2] */ 359 #define TWE_PARAM_DRIVESUMMARY_Status 3 /* array giving drive status per aport */ 360 #define TWE_PARAM_DRIVESTATUS_Missing 0x00 361 #define TWE_PARAM_DRIVESTATUS_NotSupp 0xfe 362 #define TWE_PARAM_DRIVESTATUS_Present 0xff 363 364 #define TWE_PARAM_UNITSUMMARY 0x0003 365 #define TWE_PARAM_UNITSUMMARY_Num 2 /* number of logical units [2] */ 366 #define TWE_PARAM_UNITSUMMARY_Status 3 /* array giving unit status [16] */ 367 #define TWE_PARAM_UNITSTATUS_Online (1<<0) 368 #define TWE_PARAM_UNITSTATUS_Complete (1<<1) 369 #define TWE_PARAM_UNITSTATUS_MASK 0xfc 370 #define TWE_PARAM_UNITSTATUS_Normal 0xfc 371 #define TWE_PARAM_UNITSTATUS_Initialising 0xf4 /* cannot be incomplete */ 372 #define TWE_PARAM_UNITSTATUS_Degraded 0xec 373 #define TWE_PARAM_UNITSTATUS_Rebuilding 0xdc /* cannot be incomplete */ 374 #define TWE_PARAM_UNITSTATUS_Verifying 0xcc /* cannot be incomplete */ 375 #define TWE_PARAM_UNITSTATUS_Corrupt 0xbc /* cannot be complete */ 376 #define TWE_PARAM_UNITSTATUS_Missing 0x00 /* cannot be complete or online */ 377 378 #define TWE_PARAM_DRIVEINFO 0x0200 /* add drive number 0x00-0x0f XXX docco confused 0x0100 vs 0x0200 */ 379 #define TWE_PARAM_DRIVEINFO_Size 2 /* size in blocks [4] */ 380 #define TWE_PARAM_DRIVEINFO_Model 3 /* drive model string [40] */ 381 #define TWE_PARAM_DRIVEINFO_Serial 4 /* drive serial number [20] */ 382 #define TWE_PARAM_DRIVEINFO_PhysCylNum 5 /* physical geometry [2] */ 383 #define TWE_PARAM_DRIVEINFO_PhysHeadNum 6 /* [2] */ 384 #define TWE_PARAM_DRIVEINFO_PhysSectorNym 7 /* [2] */ 385 #define TWE_PARAM_DRIVEINFO_LogCylNum 8 /* logical geometry [2] */ 386 #define TWE_PARAM_DRIVEINFO_LogHeadNum 9 /* [2] */ 387 #define TWE_PARAM_DRIVEINFO_LogSectorNum 10 /* [2] */ 388 #define TWE_PARAM_DRIVEINFO_UnitNum 11 /* unit number this drive is associated with or 0xff [1] */ 389 #define TWE_PARAM_DRIVEINFO_DriveFlags 12 /* N/A [1] */ 390 391 #define TWE_PARAM_APORTTIMEOUT 0x02c0 /* add (aport_number * 3) to parameter index */ 392 #define TWE_PARAM_APORTTIMEOUT_READ 2 /* read timeouts last 24hrs [2] */ 393 #define TWE_PARAM_APORTTIMEOUT_WRITE 3 /* write timeouts last 24hrs [2] */ 394 #define TWE_PARAM_APORTTIMEOUT_DEGRADE 4 /* degrade threshold [2] */ 395 396 #define TWE_PARAM_UNITINFO 0x0300 /* add unit number 0x00-0x0f */ 397 #define TWE_PARAM_UNITINFO_Number 2 /* unit number [1] */ 398 #define TWE_PARAM_UNITINFO_Status 3 /* unit status [1] */ 399 #define TWE_PARAM_UNITINFO_Capacity 4 /* unit capacity in blocks [4] */ 400 #define TWE_PARAM_UNITINFO_DescriptorSize 5 /* unit descriptor size + 3 bytes [2] */ 401 #define TWE_PARAM_UNITINFO_Descriptor 6 /* unit descriptor, TWE_UnitDescriptor or TWE_Array_Descriptor */ 402 #define TWE_PARAM_UNITINFO_Flags 7 /* unit flags [1] */ 403 #define TWE_PARAM_UNITFLAGS_WCE (1<<0) 404 405 #define TWE_PARAM_AEN 0x0401 406 #define TWE_PARAM_AEN_UnitCode 2 /* (unit number << 8) | AEN code [2] */ 407 #define TWE_AEN_QUEUE_EMPTY 0x00 408 #define TWE_AEN_SOFT_RESET 0x01 409 #define TWE_AEN_DEGRADED_MIRROR 0x02 /* reports unit */ 410 #define TWE_AEN_CONTROLLER_ERROR 0x03 411 #define TWE_AEN_REBUILD_FAIL 0x04 /* reports unit */ 412 #define TWE_AEN_REBUILD_DONE 0x05 /* reports unit */ 413 #define TWE_AEN_INCOMP_UNIT 0x06 /* reports unit */ 414 #define TWE_AEN_INIT_DONE 0x07 /* reports unit */ 415 #define TWE_AEN_UNCLEAN_SHUTDOWN 0x08 /* reports unit */ 416 #define TWE_AEN_APORT_TIMEOUT 0x09 /* reports unit, rate limited to 1 per 2^16 errors */ 417 #define TWE_AEN_DRIVE_ERROR 0x0a /* reports unit */ 418 #define TWE_AEN_REBUILD_STARTED 0x0b /* reports unit */ 419 #define TWE_AEN_QUEUE_FULL 0xff 420 #define TWE_AEN_TABLE_UNDEFINED 0x15 421 #define TWE_AEN_CODE(x) ((x) & 0xff) 422 #define TWE_AEN_UNIT(x) ((x) >> 8) 423 424 #define TWE_PARAM_VERSION 0x0402 425 #define TWE_PARAM_VERSION_Mon 2 /* monitor version [16] */ 426 #define TWE_PARAM_VERSION_FW 3 /* firmware version [16] */ 427 #define TWE_PARAM_VERSION_BIOS 4 /* BIOSs version [16] */ 428 #define TWE_PARAM_VERSION_PCB 5 /* PCB version [8] */ 429 #define TWE_PARAM_VERSION_ATA 6 /* A-chip version [8] */ 430 #define TWE_PARAM_VERSION_PCI 7 /* P-chip version [8] */ 431 #define TWE_PARAM_VERSION_CtrlModel 8 /* N/A */ 432 #define TWE_PARAM_VERSION_CtrlSerial 9 /* N/A */ 433 #define TWE_PARAM_VERSION_SBufSize 10 /* N/A */ 434 #define TWE_PARAM_VERSION_CompCode 11 /* compatibility code [4] */ 435 436 #define TWE_PARAM_CONTROLLER 0x0403 437 #define TWE_PARAM_CONTROLLER_DCBSectors 2 /* # sectors reserved for DCB per drive [2] */ 438 #define TWE_PARAM_CONTROLLER_PortCount 3 /* number of drive ports [1] */ 439 440 #define TWE_PARAM_FEATURES 0x404 441 #define TWE_PARAM_FEATURES_DriverShutdown 2 /* set to 1 if driver supports shutdown notification [1] */ 442 443 typedef struct 444 { 445 u_int8_t num_subunits; /* must be zero */ 446 u_int8_t configuration; 447 #define TWE_UD_CONFIG_CBOD 0x0c /* JBOD with DCB, used for mirrors */ 448 #define TWE_UD_CONFIG_SPARE 0x0d /* same as CBOD, but firmware will use as spare */ 449 #define TWE_UD_CONFIG_SUBUNIT 0x0e /* drive is a subunit in an array */ 450 #define TWE_UD_CONFIG_JBOD 0x0f /* plain drive */ 451 u_int8_t phys_drv_num; /* may be 0xff if port can't be determined at runtime */ 452 u_int8_t log_drv_num; /* must be zero for configuration == 0x0f */ 453 u_int32_t start_lba; 454 u_int32_t block_count; /* actual drive size if configuration == 0x0f, otherwise less DCB size */ 455 } TWE_Unit_Descriptor __attribute__ ((packed)); 456 457 typedef struct 458 { 459 u_int8_t flag; /* must be 0xff */ 460 u_int8_t res1; 461 u_int8_t mirunit_status[4]; /* bitmap of functional subunits in each mirror */ 462 u_int8_t res2[6]; 463 } TWE_Mirror_Descriptor __attribute__ ((packed)); 464 465 typedef struct 466 { 467 u_int8_t num_subunits; /* number of subunits, or number of mirror units in RAID10 */ 468 u_int8_t configuration; 469 #define TWE_UD_CONFIG_RAID0 0x00 470 #define TWE_UD_CONFIG_RAID1 0x01 471 #define TWE_UD_CONFIG_TwinStor 0x02 472 #define TWE_UD_CONFIG_RAID5 0x05 473 #define TWE_UD_CONFIG_RAID10 0x06 474 u_int8_t stripe_size; 475 #define TWE_UD_STRIPE_4k 0x03 476 #define TWE_UD_STRIPE_8k 0x04 477 #define TWE_UD_STRIPE_16k 0x05 478 #define TWE_UD_STRIPE_32k 0x06 479 #define TWE_UD_STRIPE_64k 0x07 480 u_int8_t log_drv_status; /* bitmap of functional subunits, or mirror units in RAID10 */ 481 u_int32_t start_lba; 482 u_int32_t block_count; /* actual drive size if configuration == 0x0f, otherwise less DCB size */ 483 TWE_Unit_Descriptor subunit[0]; /* subunit descriptors, in RAID10 mode is [mirunit][subunit] */ 484 } TWE_Array_Descriptor __attribute__ ((packed)); 485 486 typedef struct 487 { 488 u_int16_t table_id; 489 u_int8_t parameter_id; 490 u_int8_t parameter_size_bytes; 491 u_int8_t data[0]; 492 } TWE_Param __attribute__ ((packed)); 493 494