xref: /linux/Documentation/ABI/testing/sysfs-platform-dfl-port (revision d2ad5ac1cda7c30c9ded04d0e21aba528f1f96ec)
1e4664c0eSWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/id
2e4664c0eSWu HaoDate:		June 2018
3e4664c0eSWu HaoKernelVersion:	4.19
4e4664c0eSWu HaoContact:	Wu Hao <hao.wu@intel.com>
5e4664c0eSWu HaoDescription:	Read-only. It returns id of this port. One DFL FPGA device
6e4664c0eSWu Hao		may have more than one port. Userspace could use this id to
7e4664c0eSWu Hao		distinguish different ports under same FPGA device.
8857a2622SXiao Guangrong
9857a2622SXiao GuangrongWhat:		/sys/bus/platform/devices/dfl-port.0/afu_id
10857a2622SXiao GuangrongDate:		June 2018
11857a2622SXiao GuangrongKernelVersion:	4.19
12857a2622SXiao GuangrongContact:	Wu Hao <hao.wu@intel.com>
13857a2622SXiao GuangrongDescription:	Read-only. User can program different PR bitstreams to FPGA
14857a2622SXiao Guangrong		Accelerator Function Unit (AFU) for different functions. It
15857a2622SXiao Guangrong		returns uuid which could be used to identify which PR bitstream
16857a2622SXiao Guangrong		is programmed in this AFU.
17*d2ad5ac1SWu Hao
18*d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/power_state
19*d2ad5ac1SWu HaoDate:		August 2019
20*d2ad5ac1SWu HaoKernelVersion:	5.4
21*d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
22*d2ad5ac1SWu HaoDescription:	Read-only. It reports the APx (AFU Power) state, different APx
23*d2ad5ac1SWu Hao		means different throttling level. When reading this file, it
24*d2ad5ac1SWu Hao		returns "0" - Normal / "1" - AP1 / "2" - AP2 / "6" - AP6.
25*d2ad5ac1SWu Hao
26*d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/ap1_event
27*d2ad5ac1SWu HaoDate:		August 2019
28*d2ad5ac1SWu HaoKernelVersion:	5.4
29*d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
30*d2ad5ac1SWu HaoDescription:	Read-write. Read this file for AP1 (AFU Power State 1) event.
31*d2ad5ac1SWu Hao		It's used to indicate transient AP1 state. Write 1 to this
32*d2ad5ac1SWu Hao		file to clear AP1 event.
33*d2ad5ac1SWu Hao
34*d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/ap2_event
35*d2ad5ac1SWu HaoDate:		August 2019
36*d2ad5ac1SWu HaoKernelVersion:	5.4
37*d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
38*d2ad5ac1SWu HaoDescription:	Read-write. Read this file for AP2 (AFU Power State 2) event.
39*d2ad5ac1SWu Hao		It's used to indicate transient AP2 state. Write 1 to this
40*d2ad5ac1SWu Hao		file to clear AP2 event.
41*d2ad5ac1SWu Hao
42*d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/ltr
43*d2ad5ac1SWu HaoDate:		August 2019
44*d2ad5ac1SWu HaoKernelVersion:	5.4
45*d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
46*d2ad5ac1SWu HaoDescription:	Read-write. Read or set AFU latency tolerance reporting value.
47*d2ad5ac1SWu Hao		Set ltr to 1 if the AFU can tolerate latency >= 40us or set it
48*d2ad5ac1SWu Hao		to 0 if it is latency sensitive.
49