xref: /linux/Documentation/ABI/testing/sysfs-devices-soc (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1What:		/sys/devices/socX
2Date:		January 2012
3contact:	Lee Jones <lee.jones@linaro.org>
4Description:
5		The /sys/devices/ directory contains a sub-directory for each
6		System-on-Chip (SoC) device on a running platform. Information
7		regarding each SoC can be obtained by reading sysfs files. This
8		functionality is only available if implemented by the platform.
9
10		The directory created for each SoC will also house information
11		about devices which are commonly contained in /sys/devices/platform.
12		It has been agreed that if an SoC device exists, its supported
13		devices would be better suited to appear as children of that SoC.
14
15What:		/sys/devices/socX/machine
16Date:		January 2012
17contact:	Lee Jones <lee.jones@linaro.org>
18Description:
19		Read-only attribute common to all SoCs. Contains the SoC machine
20		name (e.g. Ux500).
21
22What:		/sys/devices/socX/family
23Date:		January 2012
24contact:	Lee Jones <lee.jones@linaro.org>
25Description:
26		Read-only attribute common to all SoCs. Contains SoC family name
27		(e.g. DB8500).
28
29What:		/sys/devices/socX/soc_id
30Date:		January 2012
31contact:	Lee Jones <lee.jones@linaro.org>
32Description:
33		Read-only attribute supported by most SoCs. In the case of
34		ST-Ericsson's chips this contains the SoC serial number.
35
36What:		/sys/devices/socX/revision
37Date:		January 2012
38contact:	Lee Jones <lee.jones@linaro.org>
39Description:
40		Read-only attribute supported by most SoCs. Contains the SoC's
41		manufacturing revision number.
42
43What:		/sys/devices/socX/process
44Date:		January 2012
45contact:	Lee Jones <lee.jones@linaro.org>
46Description:
47		Read-only attribute supported ST-Ericsson's silicon. Contains the
48		the process by which the silicon chip was manufactured.
49
50What:		/sys/bus/soc
51Date:		January 2012
52contact:	Lee Jones <lee.jones@linaro.org>
53Description:
54		The /sys/bus/soc/ directory contains the usual sub-folders
55		expected under most buses. /sys/bus/soc/devices is of particular
56		interest, as it contains a symlink for each SoC device found on
57		the system. Each symlink points back into the aforementioned
58		/sys/devices/socX devices.
59