summaryrefslogtreecommitdiffstats
path: root/Documentation/ABI/testing/sysfs-bus-cdx
blob: c2c54abffed58cca4b63079620a01f2677c22f3e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
What:		/sys/bus/cdx/rescan
Date:		March 2023
Contact:	nipun.gupta@amd.com
Description:
		Writing y/1/on to this file will cause rescan of the bus
		and devices on the CDX bus. Any new devices are scanned and
		added to the list of Linux devices and any devices removed are
		also deleted from Linux.

		For example::

		  # echo 1 > /sys/bus/cdx/rescan

What:		/sys/bus/cdx/devices/.../vendor
Date:		March 2023
Contact:	nipun.gupta@amd.com
Description:
		Vendor ID for this CDX device, in hexadecimal. Vendor ID is
		16 bit identifier which is specific to the device manufacturer.
		Combination of Vendor ID and Device ID identifies a device.

What:		/sys/bus/cdx/devices/.../device
Date:		March 2023
Contact:	nipun.gupta@amd.com
Description:
		Device ID for this CDX device, in hexadecimal. Device ID is
		16 bit identifier to identify a device type within the range
		of a device manufacturer.
		Combination of Vendor ID and Device ID identifies a device.

What:		/sys/bus/cdx/devices/.../enable
Date:		October 2023
Contact:	abhijit.gangurde@amd.com
Description:
		CDX bus should be disabled before updating the devices in FPGA.
		Writing n/0/off will attempt to disable the CDX bus and.
		writing y/1/on will attempt to enable the CDX bus. Reading this file
		gives the current state of the bus, 1 for enabled and 0 for disabled.

		For example::

		  # echo 1 > /sys/bus/cdx/.../enable

What:		/sys/bus/cdx/devices/.../reset
Date:		March 2023
Contact:	nipun.gupta@amd.com
Description:
		Writing y/1/on to this file resets the CDX device or all devices
		on the bus. On resetting the device, the corresponding driver is
		notified twice, once before the device is being reset, and again
		after the reset has been complete.

		For example::

		  # echo 1 > /sys/bus/cdx/.../reset

What:		/sys/bus/cdx/devices/.../remove
Date:		March 2023
Contact:	tarak.reddy@amd.com
Description:
		Writing y/1/on to this file removes the corresponding
		device from the CDX bus. If the device is to be reconfigured
		reconfigured in the Hardware, the device can be removed, so
		that the device driver does not access the device while it is
		being reconfigured.

		For example::

		  # echo 1 > /sys/bus/cdx/devices/.../remove