sas.h (13112B)
1/* SPDX-License-Identifier: GPL-2.0-only */ 2/* 3 * SAS structures and definitions header file 4 * 5 * Copyright (C) 2005 Adaptec, Inc. All rights reserved. 6 * Copyright (C) 2005 Luben Tuikov <luben_tuikov@adaptec.com> 7 */ 8 9#ifndef _SAS_H_ 10#define _SAS_H_ 11 12#include <linux/types.h> 13#include <asm/byteorder.h> 14 15#define SAS_ADDR_SIZE 8 16#define HASHED_SAS_ADDR_SIZE 3 17#define SAS_ADDR(_sa) ((unsigned long long) be64_to_cpu(*(__be64 *)(_sa))) 18 19#define SMP_REQUEST 0x40 20#define SMP_RESPONSE 0x41 21 22#define SSP_DATA 0x01 23#define SSP_XFER_RDY 0x05 24#define SSP_COMMAND 0x06 25#define SSP_RESPONSE 0x07 26#define SSP_TASK 0x16 27 28#define SMP_REPORT_GENERAL 0x00 29#define SMP_REPORT_MANUF_INFO 0x01 30#define SMP_READ_GPIO_REG 0x02 31#define SMP_DISCOVER 0x10 32#define SMP_REPORT_PHY_ERR_LOG 0x11 33#define SMP_REPORT_PHY_SATA 0x12 34#define SMP_REPORT_ROUTE_INFO 0x13 35#define SMP_WRITE_GPIO_REG 0x82 36#define SMP_CONF_ROUTE_INFO 0x90 37#define SMP_PHY_CONTROL 0x91 38#define SMP_PHY_TEST_FUNCTION 0x92 39 40#define SMP_RESP_FUNC_ACC 0x00 41#define SMP_RESP_FUNC_UNK 0x01 42#define SMP_RESP_FUNC_FAILED 0x02 43#define SMP_RESP_INV_FRM_LEN 0x03 44#define SMP_RESP_NO_PHY 0x10 45#define SMP_RESP_NO_INDEX 0x11 46#define SMP_RESP_PHY_NO_SATA 0x12 47#define SMP_RESP_PHY_UNK_OP 0x13 48#define SMP_RESP_PHY_UNK_TESTF 0x14 49#define SMP_RESP_PHY_TEST_INPROG 0x15 50#define SMP_RESP_PHY_VACANT 0x16 51 52/* SAM TMFs */ 53#define TMF_ABORT_TASK 0x01 54#define TMF_ABORT_TASK_SET 0x02 55#define TMF_CLEAR_TASK_SET 0x04 56#define TMF_LU_RESET 0x08 57#define TMF_CLEAR_ACA 0x40 58#define TMF_QUERY_TASK 0x80 59 60/* SAS TMF responses */ 61#define TMF_RESP_FUNC_COMPLETE 0x00 62#define TMF_RESP_INVALID_FRAME 0x02 63#define TMF_RESP_FUNC_ESUPP 0x04 64#define TMF_RESP_FUNC_FAILED 0x05 65#define TMF_RESP_FUNC_SUCC 0x08 66#define TMF_RESP_NO_LUN 0x09 67#define TMF_RESP_OVERLAPPED_TAG 0x0A 68 69enum sas_oob_mode { 70 OOB_NOT_CONNECTED, 71 SATA_OOB_MODE, 72 SAS_OOB_MODE 73}; 74 75/* See sas_discover.c if you plan on changing these */ 76enum sas_device_type { 77 /* these are SAS protocol defined (attached device type field) */ 78 SAS_PHY_UNUSED = 0, 79 SAS_END_DEVICE = 1, 80 SAS_EDGE_EXPANDER_DEVICE = 2, 81 SAS_FANOUT_EXPANDER_DEVICE = 3, 82 /* these are internal to libsas */ 83 SAS_HA = 4, 84 SAS_SATA_DEV = 5, 85 SAS_SATA_PM = 7, 86 SAS_SATA_PM_PORT = 8, 87 SAS_SATA_PENDING = 9, 88}; 89 90enum sas_protocol { 91 SAS_PROTOCOL_NONE = 0, 92 SAS_PROTOCOL_SATA = 0x01, 93 SAS_PROTOCOL_SMP = 0x02, 94 SAS_PROTOCOL_STP = 0x04, 95 SAS_PROTOCOL_SSP = 0x08, 96 SAS_PROTOCOL_ALL = 0x0E, 97 SAS_PROTOCOL_STP_ALL = SAS_PROTOCOL_STP|SAS_PROTOCOL_SATA, 98 /* these are internal to libsas */ 99 SAS_PROTOCOL_INTERNAL_ABORT = 0x10, 100}; 101 102/* From the spec; local phys only */ 103enum phy_func { 104 PHY_FUNC_NOP, 105 PHY_FUNC_LINK_RESET, /* Enables the phy */ 106 PHY_FUNC_HARD_RESET, 107 PHY_FUNC_DISABLE, 108 PHY_FUNC_CLEAR_ERROR_LOG = 5, 109 PHY_FUNC_CLEAR_AFFIL, 110 PHY_FUNC_TX_SATA_PS_SIGNAL, 111 PHY_FUNC_RELEASE_SPINUP_HOLD = 0x10, /* LOCAL PORT ONLY! */ 112 PHY_FUNC_SET_LINK_RATE, 113 PHY_FUNC_GET_EVENTS, 114}; 115 116/* SAS LLDD would need to report only _very_few_ of those, like BROADCAST. 117 * Most of those are here for completeness. 118 */ 119enum sas_prim { 120 SAS_PRIM_AIP_NORMAL = 1, 121 SAS_PRIM_AIP_R0 = 2, 122 SAS_PRIM_AIP_R1 = 3, 123 SAS_PRIM_AIP_R2 = 4, 124 SAS_PRIM_AIP_WC = 5, 125 SAS_PRIM_AIP_WD = 6, 126 SAS_PRIM_AIP_WP = 7, 127 SAS_PRIM_AIP_RWP = 8, 128 129 SAS_PRIM_BC_CH = 9, 130 SAS_PRIM_BC_RCH0 = 10, 131 SAS_PRIM_BC_RCH1 = 11, 132 SAS_PRIM_BC_R0 = 12, 133 SAS_PRIM_BC_R1 = 13, 134 SAS_PRIM_BC_R2 = 14, 135 SAS_PRIM_BC_R3 = 15, 136 SAS_PRIM_BC_R4 = 16, 137 138 SAS_PRIM_NOTIFY_ENSP= 17, 139 SAS_PRIM_NOTIFY_R0 = 18, 140 SAS_PRIM_NOTIFY_R1 = 19, 141 SAS_PRIM_NOTIFY_R2 = 20, 142 143 SAS_PRIM_CLOSE_CLAF = 21, 144 SAS_PRIM_CLOSE_NORM = 22, 145 SAS_PRIM_CLOSE_R0 = 23, 146 SAS_PRIM_CLOSE_R1 = 24, 147 148 SAS_PRIM_OPEN_RTRY = 25, 149 SAS_PRIM_OPEN_RJCT = 26, 150 SAS_PRIM_OPEN_ACPT = 27, 151 152 SAS_PRIM_DONE = 28, 153 SAS_PRIM_BREAK = 29, 154 155 SATA_PRIM_DMAT = 33, 156 SATA_PRIM_PMNAK = 34, 157 SATA_PRIM_PMACK = 35, 158 SATA_PRIM_PMREQ_S = 36, 159 SATA_PRIM_PMREQ_P = 37, 160 SATA_SATA_R_ERR = 38, 161}; 162 163enum sas_open_rej_reason { 164 /* Abandon open */ 165 SAS_OREJ_UNKNOWN = 0, 166 SAS_OREJ_BAD_DEST = 1, 167 SAS_OREJ_CONN_RATE = 2, 168 SAS_OREJ_EPROTO = 3, 169 SAS_OREJ_RESV_AB0 = 4, 170 SAS_OREJ_RESV_AB1 = 5, 171 SAS_OREJ_RESV_AB2 = 6, 172 SAS_OREJ_RESV_AB3 = 7, 173 SAS_OREJ_WRONG_DEST= 8, 174 SAS_OREJ_STP_NORES = 9, 175 176 /* Retry open */ 177 SAS_OREJ_NO_DEST = 10, 178 SAS_OREJ_PATH_BLOCKED = 11, 179 SAS_OREJ_RSVD_CONT0 = 12, 180 SAS_OREJ_RSVD_CONT1 = 13, 181 SAS_OREJ_RSVD_INIT0 = 14, 182 SAS_OREJ_RSVD_INIT1 = 15, 183 SAS_OREJ_RSVD_STOP0 = 16, 184 SAS_OREJ_RSVD_STOP1 = 17, 185 SAS_OREJ_RSVD_RETRY = 18, 186}; 187 188enum sas_gpio_reg_type { 189 SAS_GPIO_REG_CFG = 0, 190 SAS_GPIO_REG_RX = 1, 191 SAS_GPIO_REG_RX_GP = 2, 192 SAS_GPIO_REG_TX = 3, 193 SAS_GPIO_REG_TX_GP = 4, 194}; 195 196/* Response frame DATAPRES field */ 197enum { 198 SAS_DATAPRES_NO_DATA = 0, 199 SAS_DATAPRES_RESPONSE_DATA = 1, 200 SAS_DATAPRES_SENSE_DATA = 2, 201}; 202 203struct dev_to_host_fis { 204 u8 fis_type; /* 0x34 */ 205 u8 flags; 206 u8 status; 207 u8 error; 208 209 u8 lbal; 210 union { u8 lbam; u8 byte_count_low; }; 211 union { u8 lbah; u8 byte_count_high; }; 212 u8 device; 213 214 u8 lbal_exp; 215 u8 lbam_exp; 216 u8 lbah_exp; 217 u8 _r_a; 218 219 union { u8 sector_count; u8 interrupt_reason; }; 220 u8 sector_count_exp; 221 u8 _r_b; 222 u8 _r_c; 223 224 u32 _r_d; 225} __attribute__ ((packed)); 226 227struct host_to_dev_fis { 228 u8 fis_type; /* 0x27 */ 229 u8 flags; 230 u8 command; 231 u8 features; 232 233 u8 lbal; 234 union { u8 lbam; u8 byte_count_low; }; 235 union { u8 lbah; u8 byte_count_high; }; 236 u8 device; 237 238 u8 lbal_exp; 239 u8 lbam_exp; 240 u8 lbah_exp; 241 u8 features_exp; 242 243 union { u8 sector_count; u8 interrupt_reason; }; 244 u8 sector_count_exp; 245 u8 _r_a; 246 u8 control; 247 248 u32 _r_b; 249} __attribute__ ((packed)); 250 251/* Prefer to have code clarity over header file clarity. 252 */ 253#ifdef __LITTLE_ENDIAN_BITFIELD 254struct sas_identify_frame { 255 /* Byte 0 */ 256 u8 frame_type:4; 257 u8 dev_type:3; 258 u8 _un0:1; 259 260 /* Byte 1 */ 261 u8 _un1; 262 263 /* Byte 2 */ 264 union { 265 struct { 266 u8 _un20:1; 267 u8 smp_iport:1; 268 u8 stp_iport:1; 269 u8 ssp_iport:1; 270 u8 _un247:4; 271 }; 272 u8 initiator_bits; 273 }; 274 275 /* Byte 3 */ 276 union { 277 struct { 278 u8 _un30:1; 279 u8 smp_tport:1; 280 u8 stp_tport:1; 281 u8 ssp_tport:1; 282 u8 _un347:4; 283 }; 284 u8 target_bits; 285 }; 286 287 /* Byte 4 - 11 */ 288 u8 _un4_11[8]; 289 290 /* Byte 12 - 19 */ 291 u8 sas_addr[SAS_ADDR_SIZE]; 292 293 /* Byte 20 */ 294 u8 phy_id; 295 296 u8 _un21_27[7]; 297 298 __be32 crc; 299} __attribute__ ((packed)); 300 301struct ssp_frame_hdr { 302 u8 frame_type; 303 u8 hashed_dest_addr[HASHED_SAS_ADDR_SIZE]; 304 u8 _r_a; 305 u8 hashed_src_addr[HASHED_SAS_ADDR_SIZE]; 306 __be16 _r_b; 307 308 u8 changing_data_ptr:1; 309 u8 retransmit:1; 310 u8 retry_data_frames:1; 311 u8 _r_c:5; 312 313 u8 num_fill_bytes:2; 314 u8 _r_d:6; 315 316 u32 _r_e; 317 __be16 tag; 318 __be16 tptt; 319 __be32 data_offs; 320} __attribute__ ((packed)); 321 322struct ssp_response_iu { 323 u8 _r_a[10]; 324 325 u8 datapres:2; 326 u8 _r_b:6; 327 328 u8 status; 329 330 u32 _r_c; 331 332 __be32 sense_data_len; 333 __be32 response_data_len; 334 335 union { 336 DECLARE_FLEX_ARRAY(u8, resp_data); 337 DECLARE_FLEX_ARRAY(u8, sense_data); 338 }; 339} __attribute__ ((packed)); 340 341struct ssp_command_iu { 342 u8 lun[8]; 343 u8 _r_a; 344 345 union { 346 struct { 347 u8 attr:3; 348 u8 prio:4; 349 u8 efb:1; 350 }; 351 u8 efb_prio_attr; 352 }; 353 354 u8 _r_b; 355 356 u8 _r_c:2; 357 u8 add_cdb_len:6; 358 359 u8 cdb[16]; 360 u8 add_cdb[]; 361} __attribute__ ((packed)); 362 363struct xfer_rdy_iu { 364 __be32 requested_offset; 365 __be32 write_data_len; 366 __be32 _r_a; 367} __attribute__ ((packed)); 368 369struct ssp_tmf_iu { 370 u8 lun[8]; 371 u16 _r_a; 372 u8 tmf; 373 u8 _r_b; 374 __be16 tag; 375 u8 _r_c[14]; 376} __attribute__ ((packed)); 377 378/* ---------- SMP ---------- */ 379 380struct report_general_resp { 381 __be16 change_count; 382 __be16 route_indexes; 383 u8 _r_a; 384 u8 num_phys; 385 386 u8 conf_route_table:1; 387 u8 configuring:1; 388 u8 config_others:1; 389 u8 orej_retry_supp:1; 390 u8 stp_cont_awt:1; 391 u8 self_config:1; 392 u8 zone_config:1; 393 u8 t2t_supp:1; 394 395 u8 _r_c; 396 397 u8 enclosure_logical_id[8]; 398 399 u8 _r_d[12]; 400} __attribute__ ((packed)); 401 402struct discover_resp { 403 u8 _r_a[5]; 404 405 u8 phy_id; 406 __be16 _r_b; 407 408 u8 _r_c:4; 409 u8 attached_dev_type:3; 410 u8 _r_d:1; 411 412 u8 linkrate:4; 413 u8 _r_e:4; 414 415 u8 attached_sata_host:1; 416 u8 iproto:3; 417 u8 _r_f:4; 418 419 u8 attached_sata_dev:1; 420 u8 tproto:3; 421 u8 _r_g:3; 422 u8 attached_sata_ps:1; 423 424 u8 sas_addr[8]; 425 u8 attached_sas_addr[8]; 426 u8 attached_phy_id; 427 428 u8 _r_h[7]; 429 430 u8 hmin_linkrate:4; 431 u8 pmin_linkrate:4; 432 u8 hmax_linkrate:4; 433 u8 pmax_linkrate:4; 434 435 u8 change_count; 436 437 u8 pptv:4; 438 u8 _r_i:3; 439 u8 virtual:1; 440 441 u8 routing_attr:4; 442 u8 _r_j:4; 443 444 u8 conn_type; 445 u8 conn_el_index; 446 u8 conn_phy_link; 447 448 u8 _r_k[8]; 449} __attribute__ ((packed)); 450 451struct report_phy_sata_resp { 452 u8 _r_a[5]; 453 454 u8 phy_id; 455 u8 _r_b; 456 457 u8 affil_valid:1; 458 u8 affil_supp:1; 459 u8 _r_c:6; 460 461 u32 _r_d; 462 463 u8 stp_sas_addr[8]; 464 465 struct dev_to_host_fis fis; 466 467 u32 _r_e; 468 469 u8 affil_stp_ini_addr[8]; 470 471 __be32 crc; 472} __attribute__ ((packed)); 473 474struct smp_resp { 475 u8 frame_type; 476 u8 function; 477 u8 result; 478 u8 reserved; 479 union { 480 struct report_general_resp rg; 481 struct discover_resp disc; 482 struct report_phy_sata_resp rps; 483 }; 484} __attribute__ ((packed)); 485 486#elif defined(__BIG_ENDIAN_BITFIELD) 487struct sas_identify_frame { 488 /* Byte 0 */ 489 u8 _un0:1; 490 u8 dev_type:3; 491 u8 frame_type:4; 492 493 /* Byte 1 */ 494 u8 _un1; 495 496 /* Byte 2 */ 497 union { 498 struct { 499 u8 _un247:4; 500 u8 ssp_iport:1; 501 u8 stp_iport:1; 502 u8 smp_iport:1; 503 u8 _un20:1; 504 }; 505 u8 initiator_bits; 506 }; 507 508 /* Byte 3 */ 509 union { 510 struct { 511 u8 _un347:4; 512 u8 ssp_tport:1; 513 u8 stp_tport:1; 514 u8 smp_tport:1; 515 u8 _un30:1; 516 }; 517 u8 target_bits; 518 }; 519 520 /* Byte 4 - 11 */ 521 u8 _un4_11[8]; 522 523 /* Byte 12 - 19 */ 524 u8 sas_addr[SAS_ADDR_SIZE]; 525 526 /* Byte 20 */ 527 u8 phy_id; 528 529 u8 _un21_27[7]; 530 531 __be32 crc; 532} __attribute__ ((packed)); 533 534struct ssp_frame_hdr { 535 u8 frame_type; 536 u8 hashed_dest_addr[HASHED_SAS_ADDR_SIZE]; 537 u8 _r_a; 538 u8 hashed_src_addr[HASHED_SAS_ADDR_SIZE]; 539 __be16 _r_b; 540 541 u8 _r_c:5; 542 u8 retry_data_frames:1; 543 u8 retransmit:1; 544 u8 changing_data_ptr:1; 545 546 u8 _r_d:6; 547 u8 num_fill_bytes:2; 548 549 u32 _r_e; 550 __be16 tag; 551 __be16 tptt; 552 __be32 data_offs; 553} __attribute__ ((packed)); 554 555struct ssp_response_iu { 556 u8 _r_a[10]; 557 558 u8 _r_b:6; 559 u8 datapres:2; 560 561 u8 status; 562 563 u32 _r_c; 564 565 __be32 sense_data_len; 566 __be32 response_data_len; 567 568 union { 569 DECLARE_FLEX_ARRAY(u8, resp_data); 570 DECLARE_FLEX_ARRAY(u8, sense_data); 571 }; 572} __attribute__ ((packed)); 573 574struct ssp_command_iu { 575 u8 lun[8]; 576 u8 _r_a; 577 578 union { 579 struct { 580 u8 efb:1; 581 u8 prio:4; 582 u8 attr:3; 583 }; 584 u8 efb_prio_attr; 585 }; 586 587 u8 _r_b; 588 589 u8 add_cdb_len:6; 590 u8 _r_c:2; 591 592 u8 cdb[16]; 593 u8 add_cdb[]; 594} __attribute__ ((packed)); 595 596struct xfer_rdy_iu { 597 __be32 requested_offset; 598 __be32 write_data_len; 599 __be32 _r_a; 600} __attribute__ ((packed)); 601 602struct ssp_tmf_iu { 603 u8 lun[8]; 604 u16 _r_a; 605 u8 tmf; 606 u8 _r_b; 607 __be16 tag; 608 u8 _r_c[14]; 609} __attribute__ ((packed)); 610 611/* ---------- SMP ---------- */ 612 613struct report_general_resp { 614 __be16 change_count; 615 __be16 route_indexes; 616 u8 _r_a; 617 u8 num_phys; 618 619 u8 t2t_supp:1; 620 u8 zone_config:1; 621 u8 self_config:1; 622 u8 stp_cont_awt:1; 623 u8 orej_retry_supp:1; 624 u8 config_others:1; 625 u8 configuring:1; 626 u8 conf_route_table:1; 627 628 u8 _r_c; 629 630 u8 enclosure_logical_id[8]; 631 632 u8 _r_d[12]; 633} __attribute__ ((packed)); 634 635struct discover_resp { 636 u8 _r_a[5]; 637 638 u8 phy_id; 639 __be16 _r_b; 640 641 u8 _r_d:1; 642 u8 attached_dev_type:3; 643 u8 _r_c:4; 644 645 u8 _r_e:4; 646 u8 linkrate:4; 647 648 u8 _r_f:4; 649 u8 iproto:3; 650 u8 attached_sata_host:1; 651 652 u8 attached_sata_ps:1; 653 u8 _r_g:3; 654 u8 tproto:3; 655 u8 attached_sata_dev:1; 656 657 u8 sas_addr[8]; 658 u8 attached_sas_addr[8]; 659 u8 attached_phy_id; 660 661 u8 _r_h[7]; 662 663 u8 pmin_linkrate:4; 664 u8 hmin_linkrate:4; 665 u8 pmax_linkrate:4; 666 u8 hmax_linkrate:4; 667 668 u8 change_count; 669 670 u8 virtual:1; 671 u8 _r_i:3; 672 u8 pptv:4; 673 674 u8 _r_j:4; 675 u8 routing_attr:4; 676 677 u8 conn_type; 678 u8 conn_el_index; 679 u8 conn_phy_link; 680 681 u8 _r_k[8]; 682} __attribute__ ((packed)); 683 684struct report_phy_sata_resp { 685 u8 _r_a[5]; 686 687 u8 phy_id; 688 u8 _r_b; 689 690 u8 _r_c:6; 691 u8 affil_supp:1; 692 u8 affil_valid:1; 693 694 u32 _r_d; 695 696 u8 stp_sas_addr[8]; 697 698 struct dev_to_host_fis fis; 699 700 u32 _r_e; 701 702 u8 affil_stp_ini_addr[8]; 703 704 __be32 crc; 705} __attribute__ ((packed)); 706 707struct smp_resp { 708 u8 frame_type; 709 u8 function; 710 u8 result; 711 u8 reserved; 712 union { 713 struct report_general_resp rg; 714 struct discover_resp disc; 715 struct report_phy_sata_resp rps; 716 }; 717} __attribute__ ((packed)); 718 719#else 720#error "Bitfield order not defined!" 721#endif 722 723#endif /* _SAS_H_ */