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 */ 14 struct 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 25 struct 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 41 struct 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 51 struct 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 66 struct 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 */ 86 struct 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 */ 101 struct 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 111 union 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 */ 124 struct cxl_event_record_raw { 125 uuid_t id; 126 union cxl_event event; 127 } __packed; 128 129 enum 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) 139 struct 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 162 struct 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 168 int cxl_cper_register_work(struct work_struct *work); 169 int cxl_cper_unregister_work(struct work_struct *work); 170 int cxl_cper_kfifo_get(struct cxl_cper_work_data *wd); 171 #else 172 static inline int cxl_cper_register_work(struct work_struct *work) 173 { 174 return 0; 175 } 176 177 static inline int cxl_cper_unregister_work(struct work_struct *work) 178 { 179 return 0; 180 } 181 static 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 */ 188