xref: /linux/Documentation/ABI/testing/sysfs-platform-dfl-port (revision f09991adfb3454530598586424ece3082e95fb0b)
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.
17d2ad5ac1SWu Hao
18d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/power_state
19d2ad5ac1SWu HaoDate:		August 2019
20d2ad5ac1SWu HaoKernelVersion:	5.4
21d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
22d2ad5ac1SWu HaoDescription:	Read-only. It reports the APx (AFU Power) state, different APx
23d2ad5ac1SWu Hao		means different throttling level. When reading this file, it
24d2ad5ac1SWu Hao		returns "0" - Normal / "1" - AP1 / "2" - AP2 / "6" - AP6.
25d2ad5ac1SWu Hao
26d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/ap1_event
27d2ad5ac1SWu HaoDate:		August 2019
28d2ad5ac1SWu HaoKernelVersion:	5.4
29d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
30d2ad5ac1SWu HaoDescription:	Read-write. Read this file for AP1 (AFU Power State 1) event.
31d2ad5ac1SWu Hao		It's used to indicate transient AP1 state. Write 1 to this
32d2ad5ac1SWu Hao		file to clear AP1 event.
33d2ad5ac1SWu Hao
34d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/ap2_event
35d2ad5ac1SWu HaoDate:		August 2019
36d2ad5ac1SWu HaoKernelVersion:	5.4
37d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
38d2ad5ac1SWu HaoDescription:	Read-write. Read this file for AP2 (AFU Power State 2) event.
39d2ad5ac1SWu Hao		It's used to indicate transient AP2 state. Write 1 to this
40d2ad5ac1SWu Hao		file to clear AP2 event.
41d2ad5ac1SWu Hao
42d2ad5ac1SWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/ltr
43d2ad5ac1SWu HaoDate:		August 2019
44d2ad5ac1SWu HaoKernelVersion:	5.4
45d2ad5ac1SWu HaoContact:	Wu Hao <hao.wu@intel.com>
46d2ad5ac1SWu HaoDescription:	Read-write. Read or set AFU latency tolerance reporting value.
47d2ad5ac1SWu Hao		Set ltr to 1 if the AFU can tolerate latency >= 40us or set it
48d2ad5ac1SWu Hao		to 0 if it is latency sensitive.
49*f09991adSWu Hao
50*f09991adSWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/userclk_freqcmd
51*f09991adSWu HaoDate:		August 2019
52*f09991adSWu HaoKernelVersion:	5.4
53*f09991adSWu HaoContact:	Wu Hao <hao.wu@intel.com>
54*f09991adSWu HaoDescription:	Write-only. User writes command to this interface to set
55*f09991adSWu Hao		userclock to AFU.
56*f09991adSWu Hao
57*f09991adSWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/userclk_freqsts
58*f09991adSWu HaoDate:		August 2019
59*f09991adSWu HaoKernelVersion:	5.4
60*f09991adSWu HaoContact:	Wu Hao <hao.wu@intel.com>
61*f09991adSWu HaoDescription:	Read-only. Read this file to get the status of issued command
62*f09991adSWu Hao		to userclck_freqcmd.
63*f09991adSWu Hao
64*f09991adSWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrcmd
65*f09991adSWu HaoDate:		August 2019
66*f09991adSWu HaoKernelVersion:	5.4
67*f09991adSWu HaoContact:	Wu Hao <hao.wu@intel.com>
68*f09991adSWu HaoDescription:	Write-only. User writes command to this interface to set
69*f09991adSWu Hao		userclock counter.
70*f09991adSWu Hao
71*f09991adSWu HaoWhat:		/sys/bus/platform/devices/dfl-port.0/userclk_freqcntrsts
72*f09991adSWu HaoDate:		August 2019
73*f09991adSWu HaoKernelVersion:	5.4
74*f09991adSWu HaoContact:	Wu Hao <hao.wu@intel.com>
75*f09991adSWu HaoDescription:	Read-only. Read this file to get the status of issued command
76*f09991adSWu Hao		to userclck_freqcntrcmd.
77