1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
/* $OpenBSD: safte.h,v 1.8 2019/09/27 23:07:42 krw Exp $ */
/*
* Copyright (c) 2005 David Gwynne <dlg@openbsd.org>
*
* Permission to use, copy, modify, and distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
#ifndef _SCSI_SAFTE_H
#define _SCSI_SAFTE_H
#define SAFTE_EXTRA_OFFSET 0x05
/* scsi_inquiry_data.extra */
struct safte_inq {
u_int8_t uniqueid[7];
u_int8_t chanid;
u_int8_t ident[6];
#define SAFTE_IDENT "SAF-TE"
u_int8_t revision[4];
#ifdef notyet
u_int8_t reserved[2];
#endif /* notyet */
} __packed;
#define SAFTE_INQ_LEN 54
struct safte_readbuf_cmd {
u_int8_t opcode; /* READ_BUFFER */
u_int8_t flags;
#define SAFTE_RD_LUNMASK 0xe0 /* the lun should always be 0 */
#define SAFTE_RD_MODEMASK 0x07
#define SAFTE_RD_MODE 0x01 /* 0x01 is the SAF-TE command mode */
u_int8_t bufferid;
#define SAFTE_RD_CONFIG 0x00 /* enclosure configuration */
#define SAFTE_RD_ENCSTAT 0x01 /* enclosure status */
#define SAFTE_RD_USAGE 0x02 /* usage statistics */
#define SAFTE_RD_INSERTS 0x03 /* device insertions */
#define SAFTE_RD_SLOTSTAT 0x04 /* slot status */
#define SAFTE_RD_GLOBALS 0x05 /* global flags */
u_int32_t reserved1;
u_int16_t length; /* transfer length (big endian) */
u_int8_t reserved2;
} __packed;
struct safte_writebuf_cmd {
u_int8_t opcode; /* WRITE_BUFFER */
u_int8_t flags;
#define SAFTE_WR_LUNMASK 0xe0 /* the lun should always be 0 */
#define SAFTE_WR_MODEMASK 0x07
#define SAFTE_WR_MODE 0x01 /* 0x01 is the SAF-TE command mode */
u_int8_t reserved1[5];
u_int16_t length; /* transfer length (big endian) */
u_int8_t reserved2;
} __packed;
#define SAFTE_WRITE_SLOTSTAT 0x10 /* write device slot status */
#define SAFTE_WRITE_SETID 0x11 /* set scsi id */
#define SAFTE_WRITE_SLOTOP 0x12 /* perform slot operation */
#define SAFTE_WRITE_FANSPEED 0x13 /* set fan speed */
#define SAFTE_WRITE_PWRSUP 0x14 /* activate power supply */
#define SAFTE_WRITE_GLOBALS 0x15 /* global flags */
/* enclosure configuration */
struct safte_config {
u_int8_t nfans; /* number of fans */
u_int8_t npwrsup; /* number of power supplies */
u_int8_t nslots; /* number of device slots */
u_int8_t doorlock; /* door lock installed */
u_int8_t ntemps; /* number of temp sensors */
u_int8_t alarm; /* audible alarm installed */
u_int8_t therm; /* temps in C and num of thermostats */
#define SAFTE_CFG_CELSIUSMASK 0x80
#define SAFTE_CFG_CELSIUS(a) ((a) & SAFTE_CFG_CELSIUSMASK ? 1 : 0)
#define SAFTE_CFG_NTHERMMASK 0x0f
#define SAFTE_CFG_NTHERM(a) ((a) & SAFTE_CFG_NTHERMMASK)
u_int8_t reserved[56]; /* 7 to 62 */
u_int8_t vendor_bytes; /* number of vendor specific bytes */
} __packed;
#define SAFTE_CONFIG_LEN sizeof(struct safte_config)
/* enclosure status fields */
/* fan status field */
#define SAFTE_FAN_OP 0x00 /* operational */
#define SAFTE_FAN_MF 0x01 /* malfunctioning */
#define SAFTE_FAN_NOTINST 0x02 /* not installed */
#define SAFTE_FAN_UNKNOWN 0x80 /* unknown status or unreportable */
/* power supply status field */
#define SAFTE_PWR_OP_ON 0x00 /* operational and on */
#define SAFTE_PWR_OP_OFF 0x01 /* operational and off */
#define SAFTE_PWR_MF_ON 0x10 /* malfunctioning and on */
#define SAFTE_PWR_MF_OFF 0x11 /* malfunctioning and off */
#define SAFTE_PWR_NOTINST 0x20 /* not present */
#define SAFTE_PWR_PRESENT 0x21 /* present */
#define SAFTE_PWR_UNKNOWN 0x80 /* unknown status or unreportable */
/* scsi id fields */
/* are integers, not bitfields */
/* door lock status */
#define SAFTE_DOOR_LOCKED 0x00 /* locked */
#define SAFTE_DOOR_UNLOCKED 0x01 /* unlocked or uncontrollable */
#define SAFTE_DOOR_UNKNOWN 0x80 /* unknown status or unreportable */
/* speaker status */
#define SAFTE_SPKR_OFF 0x00 /* off or not installed */
#define SAFTE_SPKR_ON 0x01 /* speaker is currently on */
/* temperature */
#define SAFTE_TEMP_OFFSET -10 /* -10 to 245 degrees */
/* temp out of range */
#define SAFTE_TEMP_ETA 0x8000 /* any temp alert */
/* usage statistics */
struct safte_usage {
u_int32_t minutes; /* total number of minutes on */
u_int32_t cycles; /* total number of power cycles */
u_int8_t reserved[7];
u_int8_t vendor_bytes; /* number of vendor specific bytes */
};
/* device insertions */
/* u_int16_t * nslots */
/* device slot status */
#define SAFTE_SLOTSTAT_INSERT (1<<0) /* inserted */
#define SAFTE_SLOTSTAT_SWAP (1<<1) /* ready to be inserted/removed */
#define SAFTE_SLOTSTAT_OPER (1<<2) /* ready for operation */
/* global flags */
struct safte_globals {
u_int8_t flags1;
#define SAFTE_GLOBAL_ALARM (1<<0) /* audible alarm */
#define SAFTE_GLOBAL_FAILURE (1<<1) /* global failure indication */
#define SAFTE_GLOBAL_WARNING (1<<2) /* global warning indication */
#define SAFTE_GLOBAL_POWER (1<<3) /* enclosure power */
#define SAFTE_GLOBAL_COOLING (1<<4) /* cooling failure */
#define SAFTE_GLOBAL_PWRFAIL (1<<5) /* power failure */
#define SAFTE_GLOBAL_DRVFAIL (1<<6) /* drive failure */
#define SAFTE_GLOBAL_DRVWARN (1<<6) /* drive warning */
u_int8_t flags2;
#define SAFTE_GLOBAL_ARRAYFAIL (1<<0) /* array failure */
#define SAFTE_GLOBAL_ARRAYWARN (1<<1) /* array warning */
#define SAFTE_GLOBAL_LOCK (1<<2) /* enclosure lock */
#define SAFTE_GLOBAL_IDENTIFY (1<<3) /* identify enclosure */
u_int8_t flags3;
u_int8_t reserved[13];
};
/* perform slot operation */
struct safte_slotop {
u_int8_t opcode; /* SAFTE_WRITE_SLOTOP */
u_int8_t slot;
u_int8_t flags;
#define SAFTE_SLOTOP_OPERATE (1<<0) /* prepare for operation */
#define SAFTE_SLOTOP_INSREM (1<<1) /* prepare for insert/removal */
#define SAFTE_SLOTOP_IDENTIFY (1<<2) /* identify */
u_int8_t reserved[61]; /* zero these */
} __packed;
#endif /* _SCSI_SAFTE_H */
|
