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