xref: /linux/Documentation/ABI/testing/sysfs-platform-dfl-fme (revision 71e2f4dd5a65bd8dbca0b77661e75eea471168f8)
1What:		/sys/bus/platform/devices/dfl-fme.0/ports_num
2Date:		June 2018
3KernelVersion:  4.19
4Contact:	Wu Hao <hao.wu@intel.com>
5Description:	Read-only. One DFL FPGA device may have more than 1
6		port/Accelerator Function Unit (AFU). It returns the
7		number of ports on the FPGA device when read it.
8
9What:		/sys/bus/platform/devices/dfl-fme.0/bitstream_id
10Date:		June 2018
11KernelVersion:  4.19
12Contact:	Wu Hao <hao.wu@intel.com>
13Description:	Read-only. It returns Bitstream (static FPGA region)
14		identifier number, which includes the detailed version
15		and other information of this static FPGA region.
16
17What:		/sys/bus/platform/devices/dfl-fme.0/bitstream_metadata
18Date:		June 2018
19KernelVersion:  4.19
20Contact:	Wu Hao <hao.wu@intel.com>
21Description:	Read-only. It returns Bitstream (static FPGA region) meta
22		data, which includes the synthesis date, seed and other
23		information of this static FPGA region.
24
25What:		/sys/bus/platform/devices/dfl-fme.0/cache_size
26Date:		August 2019
27KernelVersion:  5.4
28Contact:	Wu Hao <hao.wu@intel.com>
29Description:	Read-only. It returns cache size of this FPGA device.
30
31What:		/sys/bus/platform/devices/dfl-fme.0/fabric_version
32Date:		August 2019
33KernelVersion:  5.4
34Contact:	Wu Hao <hao.wu@intel.com>
35Description:	Read-only. It returns fabric version of this FPGA device.
36		Userspace applications need this information to select
37		best data channels per different fabric design.
38
39What:		/sys/bus/platform/devices/dfl-fme.0/socket_id
40Date:		August 2019
41KernelVersion:  5.4
42Contact:	Wu Hao <hao.wu@intel.com>
43Description:	Read-only. It returns socket_id to indicate which socket
44		this FPGA belongs to, only valid for integrated solution.
45		User only needs this information, in case standard numa node
46		can't provide correct information.
47
48What:		/sys/bus/platform/devices/dfl-fme.0/errors/pcie0_errors
49Date:		August 2019
50KernelVersion:  5.4
51Contact:	Wu Hao <hao.wu@intel.com>
52Description:	Read-Write. Read this file for errors detected on pcie0 link.
53		Write this file to clear errors logged in pcie0_errors. Write
54		fails with -EINVAL if input parsing fails or input error code
55		doesn't match.
56
57What:		/sys/bus/platform/devices/dfl-fme.0/errors/pcie1_errors
58Date:		August 2019
59KernelVersion:  5.4
60Contact:	Wu Hao <hao.wu@intel.com>
61Description:	Read-Write. Read this file for errors detected on pcie1 link.
62		Write this file to clear errors logged in pcie1_errors. Write
63		fails with -EINVAL if input parsing fails or input error code
64		doesn't match.
65
66What:		/sys/bus/platform/devices/dfl-fme.0/errors/nonfatal_errors
67Date:		August 2019
68KernelVersion:  5.4
69Contact:	Wu Hao <hao.wu@intel.com>
70Description:	Read-only. It returns non-fatal errors detected.
71
72What:		/sys/bus/platform/devices/dfl-fme.0/errors/catfatal_errors
73Date:		August 2019
74KernelVersion:  5.4
75Contact:	Wu Hao <hao.wu@intel.com>
76Description:	Read-only. It returns catastrophic and fatal errors detected.
77
78What:		/sys/bus/platform/devices/dfl-fme.0/errors/inject_errors
79Date:		August 2019
80KernelVersion:  5.4
81Contact:	Wu Hao <hao.wu@intel.com>
82Description:	Read-Write. Read this file to check errors injected. Write this
83		file to inject errors for testing purpose. Write fails with
84		-EINVAL if input parsing fails or input inject error code isn't
85		supported.
86
87What:		/sys/bus/platform/devices/dfl-fme.0/errors/fme_errors
88Date:		August 2019
89KernelVersion:  5.4
90Contact:	Wu Hao <hao.wu@intel.com>
91Description:	Read-Write. Read this file to get errors detected on FME.
92		Write this file to clear errors logged in fme_errors. Write
93		fials with -EINVAL if input parsing fails or input error code
94		doesn't match.
95
96What:		/sys/bus/platform/devices/dfl-fme.0/errors/first_error
97Date:		August 2019
98KernelVersion:  5.4
99Contact:	Wu Hao <hao.wu@intel.com>
100Description:	Read-only. Read this file to get the first error detected by
101		hardware.
102
103What:		/sys/bus/platform/devices/dfl-fme.0/errors/next_error
104Date:		August 2019
105KernelVersion:  5.4
106Contact:	Wu Hao <hao.wu@intel.com>
107Description:	Read-only. Read this file to get the second error detected by
108		hardware.
109