xref: /linux/Documentation/ABI/testing/sysfs-edac-ecs (revision bbfd5594756011167b8f8de9a00e0c946afda1e6)
1*bcbd069bSShiju JoseWhat:		/sys/bus/edac/devices/<dev-name>/ecs_fruX
2*bcbd069bSShiju JoseDate:		March 2025
3*bcbd069bSShiju JoseKernelVersion:	6.15
4*bcbd069bSShiju JoseContact:	linux-edac@vger.kernel.org
5*bcbd069bSShiju JoseDescription:
6*bcbd069bSShiju Jose		The sysfs EDAC bus devices /<dev-name>/ecs_fruX subdirectory
7*bcbd069bSShiju Jose		pertains to the memory media ECS (Error Check Scrub) control
8*bcbd069bSShiju Jose		feature, where <dev-name> directory corresponds to a device
9*bcbd069bSShiju Jose		registered with the EDAC device driver for the ECS feature.
10*bcbd069bSShiju Jose		/ecs_fruX belongs to the media FRUs (Field Replaceable Unit)
11*bcbd069bSShiju Jose		under the memory device.
12*bcbd069bSShiju Jose
13*bcbd069bSShiju Jose		The sysfs ECS attr nodes are only present if the parent
14*bcbd069bSShiju Jose		driver has implemented the corresponding attr callback
15*bcbd069bSShiju Jose		function and provided the necessary operations to the EDAC
16*bcbd069bSShiju Jose		device driver during registration.
17*bcbd069bSShiju Jose
18*bcbd069bSShiju JoseWhat:		/sys/bus/edac/devices/<dev-name>/ecs_fruX/log_entry_type
19*bcbd069bSShiju JoseDate:		March 2025
20*bcbd069bSShiju JoseKernelVersion:	6.15
21*bcbd069bSShiju JoseContact:	linux-edac@vger.kernel.org
22*bcbd069bSShiju JoseDescription:
23*bcbd069bSShiju Jose		(RW) The log entry type of how the DDR5 ECS log is reported.
24*bcbd069bSShiju Jose
25*bcbd069bSShiju Jose		- 0 - per DRAM.
26*bcbd069bSShiju Jose
27*bcbd069bSShiju Jose		- 1 - per memory media FRU.
28*bcbd069bSShiju Jose
29*bcbd069bSShiju Jose		- All other values are reserved.
30*bcbd069bSShiju Jose
31*bcbd069bSShiju JoseWhat:		/sys/bus/edac/devices/<dev-name>/ecs_fruX/mode
32*bcbd069bSShiju JoseDate:		March 2025
33*bcbd069bSShiju JoseKernelVersion:	6.15
34*bcbd069bSShiju JoseContact:	linux-edac@vger.kernel.org
35*bcbd069bSShiju JoseDescription:
36*bcbd069bSShiju Jose		(RW) The mode of how the DDR5 ECS counts the errors.
37*bcbd069bSShiju Jose		Error count is tracked based on two different modes
38*bcbd069bSShiju Jose		selected by DDR5 ECS Control Feature - Codeword mode and
39*bcbd069bSShiju Jose		Row Count mode. If the ECS is under Codeword mode, then
40*bcbd069bSShiju Jose		the error count increments each time a codeword with check
41*bcbd069bSShiju Jose		bit errors is detected. If the ECS is under Row Count mode,
42*bcbd069bSShiju Jose		then the error counter increments each time a row with
43*bcbd069bSShiju Jose		check bit errors is detected.
44*bcbd069bSShiju Jose
45*bcbd069bSShiju Jose		- 0 - ECS counts rows in the memory media that have ECC errors.
46*bcbd069bSShiju Jose
47*bcbd069bSShiju Jose		- 1 - ECS counts codewords with errors, specifically, it counts
48*bcbd069bSShiju Jose		      the number of ECC-detected errors in the memory media.
49*bcbd069bSShiju Jose
50*bcbd069bSShiju Jose		- All other values are reserved.
51*bcbd069bSShiju Jose
52*bcbd069bSShiju JoseWhat:		/sys/bus/edac/devices/<dev-name>/ecs_fruX/reset
53*bcbd069bSShiju JoseDate:		March 2025
54*bcbd069bSShiju JoseKernelVersion:	6.15
55*bcbd069bSShiju JoseContact:	linux-edac@vger.kernel.org
56*bcbd069bSShiju JoseDescription:
57*bcbd069bSShiju Jose		(WO) ECS reset ECC counter.
58*bcbd069bSShiju Jose
59*bcbd069bSShiju Jose		- 1 - reset ECC counter to the default value.
60*bcbd069bSShiju Jose
61*bcbd069bSShiju Jose		- All other values are reserved.
62*bcbd069bSShiju Jose
63*bcbd069bSShiju JoseWhat:		/sys/bus/edac/devices/<dev-name>/ecs_fruX/threshold
64*bcbd069bSShiju JoseDate:		March 2025
65*bcbd069bSShiju JoseKernelVersion:	6.15
66*bcbd069bSShiju JoseContact:	linux-edac@vger.kernel.org
67*bcbd069bSShiju JoseDescription:
68*bcbd069bSShiju Jose		(RW) DDR5 ECS threshold count per gigabits of memory cells.
69*bcbd069bSShiju Jose		The ECS error count is subject to the ECS Threshold count
70*bcbd069bSShiju Jose		per Gbit, which masks error counts less than the Threshold.
71*bcbd069bSShiju Jose
72*bcbd069bSShiju Jose		Supported values are 256, 1024 and 4096.
73*bcbd069bSShiju Jose
74*bcbd069bSShiju Jose		All other values are reserved.
75