tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/* SPDX-License-Identifier: GPL-2.0 */
2/* Copyright(c) 2023 Intel Corporation. */
3#ifndef _LINUX_CXL_EVENT_H
4#define _LINUX_CXL_EVENT_H
5
6#include <linux/types.h>
7#include <linux/uuid.h>
8#include <linux/workqueue_types.h>
9
10/*
11 * Common Event Record Format
12 * CXL rev 3.0 section 8.2.9.2.1; Table 8-42
13 */
14struct cxl_event_record_hdr {
15 u8 length;
16 u8 flags[3];
17 __le16 handle;
18 __le16 related_handle;
19 __le64 timestamp;
20 u8 maint_op_class;
21 u8 maint_op_sub_class;
22 u8 reserved[14];
23} __packed;
24
25struct cxl_event_media_hdr {
26 struct cxl_event_record_hdr hdr;
27 __le64 phys_addr;
28 u8 descriptor;
29 u8 type;
30 u8 transaction_type;
31 /*
32 * The meaning of Validity Flags from bit 2 is
33 * different across DRAM and General Media records
34 */
35 u8 validity_flags[2];
36 u8 channel;
37 u8 rank;
38} __packed;
39
40#define CXL_EVENT_RECORD_DATA_LENGTH 0x50
41struct cxl_event_generic {
42 struct cxl_event_record_hdr hdr;
43 u8 data[CXL_EVENT_RECORD_DATA_LENGTH];
44} __packed;
45
46/*
47 * General Media Event Record
48 * CXL rev 3.1 Section 8.2.9.2.1.1; Table 8-45
49 */
50#define CXL_EVENT_GEN_MED_COMP_ID_SIZE 0x10
51struct cxl_event_gen_media {
52 struct cxl_event_media_hdr media_hdr;
53 u8 device[3];
54 u8 component_id[CXL_EVENT_GEN_MED_COMP_ID_SIZE];
55 u8 cme_threshold_ev_flags;
56 u8 cme_count[3];
57 u8 sub_type;
58 u8 reserved[41];
59} __packed;
60
61/*
62 * DRAM Event Record - DER
63 * CXL rev 3.1 section 8.2.9.2.1.2; Table 8-46
64 */
65#define CXL_EVENT_DER_CORRECTION_MASK_SIZE 0x20
66struct cxl_event_dram {
67 struct cxl_event_media_hdr media_hdr;
68 u8 nibble_mask[3];
69 u8 bank_group;
70 u8 bank;
71 u8 row[3];
72 u8 column[2];
73 u8 correction_mask[CXL_EVENT_DER_CORRECTION_MASK_SIZE];
74 u8 component_id[CXL_EVENT_GEN_MED_COMP_ID_SIZE];
75 u8 sub_channel;
76 u8 cme_threshold_ev_flags;
77 u8 cvme_count[3];
78 u8 sub_type;
79 u8 reserved;
80} __packed;
81
82/*
83 * Get Health Info Record
84 * CXL rev 3.1 section 8.2.9.9.3.1; Table 8-133
85 */
86struct cxl_get_health_info {
87 u8 health_status;
88 u8 media_status;
89 u8 add_status;
90 u8 life_used;
91 u8 device_temp[2];
92 u8 dirty_shutdown_cnt[4];
93 u8 cor_vol_err_cnt[4];
94 u8 cor_per_err_cnt[4];
95} __packed;
96
97/*
98 * Memory Module Event Record
99 * CXL rev 3.1 section 8.2.9.2.1.3; Table 8-47
100 */
101struct cxl_event_mem_module {
102 struct cxl_event_record_hdr hdr;
103 u8 event_type;
104 struct cxl_get_health_info info;
105 u8 validity_flags[2];
106 u8 component_id[CXL_EVENT_GEN_MED_COMP_ID_SIZE];
107 u8 event_sub_type;
108 u8 reserved[0x2a];
109} __packed;
110
111union cxl_event {
112 struct cxl_event_generic generic;
113 struct cxl_event_gen_media gen_media;
114 struct cxl_event_dram dram;
115 struct cxl_event_mem_module mem_module;
116 /* dram & gen_media event header */
117 struct cxl_event_media_hdr media_hdr;
118} __packed;
119
120/*
121 * Common Event Record Format; in event logs
122 * CXL rev 3.0 section 8.2.9.2.1; Table 8-42
123 */
124struct cxl_event_record_raw {
125 uuid_t id;
126 union cxl_event event;
127} __packed;
128
129enum cxl_event_type {
130 CXL_CPER_EVENT_GENERIC,
131 CXL_CPER_EVENT_GEN_MEDIA,
132 CXL_CPER_EVENT_DRAM,
133 CXL_CPER_EVENT_MEM_MODULE,
134};
135
136#define CPER_CXL_DEVICE_ID_VALID BIT(0)
137#define CPER_CXL_DEVICE_SN_VALID BIT(1)
138#define CPER_CXL_COMP_EVENT_LOG_VALID BIT(2)
139struct cxl_cper_event_rec {
140 struct {
141 u32 length;
142 u64 validation_bits;
143 struct cper_cxl_event_devid {
144 u16 vendor_id;
145 u16 device_id;
146 u8 func_num;
147 u8 device_num;
148 u8 bus_num;
149 u16 segment_num;
150 u16 slot_num; /* bits 2:0 reserved */
151 u8 reserved;
152 } __packed device_id;
153 struct cper_cxl_event_sn {
154 u32 lower_dw;
155 u32 upper_dw;
156 } __packed dev_serial_num;
157 } __packed hdr;
158
159 union cxl_event event;
160} __packed;
161
162struct cxl_cper_work_data {
163 enum cxl_event_type event_type;
164 struct cxl_cper_event_rec rec;
165};
166
167#ifdef CONFIG_ACPI_APEI_GHES
168int cxl_cper_register_work(struct work_struct *work);
169int cxl_cper_unregister_work(struct work_struct *work);
170int cxl_cper_kfifo_get(struct cxl_cper_work_data *wd);
171#else
172static inline int cxl_cper_register_work(struct work_struct *work)
173{
174 return 0;
175}
176
177static inline int cxl_cper_unregister_work(struct work_struct *work)
178{
179 return 0;
180}
181static inline int cxl_cper_kfifo_get(struct cxl_cper_work_data *wd)
182{
183 return 0;
184}
185#endif
186
187#endif /* _LINUX_CXL_EVENT_H */