xref: /dragonfly/sys/dev/disk/nvme/nvme_log.h (revision 70394f3fc7eef7464f17a594fdb1761670f93860)
1 /*
2  * Copyright (c) 2016 The DragonFly Project.  All rights reserved.
3  *
4  * This code is derived from software contributed to The DragonFly Project
5  * by Matthew Dillon <dillon@backplane.com>
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in
15  *    the documentation and/or other materials provided with the
16  *    distribution.
17  * 3. Neither the name of The DragonFly Project nor the names of its
18  *    contributors may be used to endorse or promote products derived
19  *    from this software without specific, prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
25  * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  */
34 
35 /*
36  * Get Log Page - Error Information (Log ID 01) (64 bytes)
37  */
38 typedef struct {
39           uint64_t  error_count;
40           uint16_t  subq_id;
41           uint16_t  cmd_id;
42           uint16_t  status;
43           uint16_t  param;
44           uint64_t  lba;
45           uint32_t  nsid;
46           uint8_t             vendor;
47           uint8_t             reserved29;
48           uint8_t             reserved30;
49           uint8_t             reserved31;
50           uint64_t  csi;                /* command specific information */
51           uint8_t             reserved40[24];
52 } __packed nvme_log_error_data_t;
53 
54 /*
55  * Get Log Page - Smart/ Health Information (Log ID 02) (512 bytes)
56  */
57 typedef struct {
58           uint8_t             crit_flags;
59           uint8_t             comp_temp1;
60           uint8_t             comp_temp2;
61           uint8_t             spare_cap;          /* normalized spare capacity 0-100 */
62           uint8_t             spare_thresh;       /* event when cap falls below value */
63           uint8_t             rated_life;         /* 0-100, may exceed capped at 255 */
64           uint8_t             reserved6[26];
65 
66                                                   /* 16-byte fields lo, hi */
67           uint64_t  read_count[2];      /* in 512000 byte units */
68           uint64_t  write_count[2];     /* in 512000 byte units */
69           uint64_t  read_cmds[2];
70           uint64_t  write_cmds[2];
71           uint64_t  busy_time[2];       /* in minutes */
72           uint64_t  power_cycles[2];
73           uint64_t  powon_hours[2];
74           uint64_t  unsafe_shutdowns[2];
75           uint64_t  unrecoverable_errors[2];
76           uint64_t  error_log_entries[2];
77 
78           uint32_t  warn_comp_temp_time; /* minutes temp > warn level */
79           uint32_t  crit_comp_temp_time; /* minutes temp > crit level */
80 
81           uint16_t  temp_sensors[8]; /* sensors 1-8 in kelvin 0=unimp */
82 
83           uint8_t             reserved216[296];
84 } __packed nvme_log_smart_data_t;
85 
86 #define NVME_SMART_CRF_BELOW_THRESH     0x01
87 #define NVME_SMART_CRF_ABOVE_THRESH     0x02      /* or below under-temp thresh*/
88 #define NVME_SMART_CRF_UNRELIABLE       0x04
89 #define NVME_SMART_CRF_MEDIA_RO                   0x08
90 #define NVME_SMART_CRF_VOLTL_BKUP_FAIL  0x10
91 #define NVME_SMART_CRF_RES20            0x20
92 #define NVME_SMART_CRF_RES40            0x40
93 #define NVME_SMART_CRF_RES80            0x80
94 
95 /*
96  * Firmware Slot Information (Log ID 03) (512 bytes)
97  */
98 typedef struct {
99           uint8_t             flags;
100           uint8_t             reserved1[7];
101           uint64_t  revision[7];        /* revision slot 1-7 */
102           uint8_t             reserved64[448];
103 } __packed nvme_fw_slot_data_t;
104 
105 #define NVME_FWSLOT_CRF_RESERVED_80     0x80
106 #define NVME_FWSLOT_CRF_FWNEXT_MASK     0x70
107 #define NVME_FWSLOT_CRF_RESERVED_08     0x08
108 #define NVME_FWSLOT_CRF_FWCURR_MASK     0x07
109 
110 #define NVME_FWSLOT_CRF_FWNEXT_GET(data)          \
111                     (((data) & NVME_FWSLOT_CRF_FWNEXT_MASK) >> 4)
112 #define NVME_FWSLOT_CRF_FWCURR_GET(data)          \
113                     ((data) & NVME_FWSLOT_CRF_FWCURR_MASK)
114 
115 /*
116  * Command Supported and Effects (Log ID 05) (4096 bytes)
117  *
118  * Iterates available admin and I/O commands, one command-effects data
119  * structure for each command, indexed by command id.
120  *
121  * CSE - Indicates whether command must be serialized (i.e. no other
122  *         commands may be pending in the namespace or globally).
123  *
124  * CSUPP - Indicates that the command is supported by the controller
125  *           (use for iteration skip).
126  */
127 typedef struct {
128           uint32_t  admin_cmds[256];
129           uint32_t  io_cmds[256];
130 } __packed nvme_cmdeff_data_t;
131 
132 #define NVME_CMDEFF_RESERVED19                    0xFFF80000U
133 #define NVME_CMDEFF_CSE_MASK            0x00007000U
134 #define NVME_CMDEFF_RESERVED05                    0x00000FE0U
135 #define NVME_CMDEFF_CCC                           0x00000010U
136 #define NVME_CMDEFF_NIC                           0x00000008U
137 #define NVME_CMDEFF_NCC                           0x00000004U
138 #define NVME_CMDEFF_LBCC                0x00000002U
139 #define NVME_CMDEFF_CSUPP               0x00000001U
140 
141 #define NVME_CMDEFF_CSE_NORM            0x00000000U
142 #define NVME_CMDEFF_CSE_NS_SERIALIZE    0x00001000U
143 #define NVME_CMDEFF_CSE_GLOB_SERIALIZE  0x00002000U
144 
145 /*
146  * Reservation Notification (Log ID 0x80) (64 bytes)
147  */
148 typedef struct {
149           uint64_t  logpg_count;
150           uint8_t             type;
151           uint8_t             logpg_avail;
152           uint8_t             reserved10[2];
153           uint32_t  nsid;
154           uint8_t             reserved16[48];
155 } __packed nvme_resnotify_data_t;
156 
157 #define NVME_RESNOTIFY_EMPTY            0x00
158 #define NVME_RESNOTIFY_REG_PREEMPTED    0x01
159 #define NVME_RESNOTIFY_RES_RELEASED     0x02
160 #define NVME_RESNOTIFY_RES_PREEMPTED    0x03
161                                                   /* 04-FF reserved */
162 
163 /* TYPE_CSS status */
164 #define NVME_RESNOTIFY_INVALID                    0x09
165