xref: /linux/Documentation/ABI/testing/sysfs-devices-soc (revision 6fdcba32711044c35c0e1b094cbd8f3f0b4472c9)
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/serial_number
30Date:		January 2019
31contact:	Bjorn Andersson <bjorn.andersson@linaro.org>
32Description:
33		Read-only attribute supported by most SoCs. Contains the SoC's
34		serial number, if available.
35
36What:		/sys/devices/socX/soc_id
37Date:		January 2012
38contact:	Lee Jones <lee.jones@linaro.org>
39Description:
40		Read-only attribute supported by most SoCs. In the case of
41		ST-Ericsson's chips this contains the SoC serial number.
42
43What:		/sys/devices/socX/revision
44Date:		January 2012
45contact:	Lee Jones <lee.jones@linaro.org>
46Description:
47		Read-only attribute supported by most SoCs. Contains the SoC's
48		manufacturing revision number.
49
50What:		/sys/devices/socX/process
51Date:		January 2012
52contact:	Lee Jones <lee.jones@linaro.org>
53Description:
54		Read-only attribute supported ST-Ericsson's silicon. Contains the
55		the process by which the silicon chip was manufactured.
56
57What:		/sys/bus/soc
58Date:		January 2012
59contact:	Lee Jones <lee.jones@linaro.org>
60Description:
61		The /sys/bus/soc/ directory contains the usual sub-folders
62		expected under most buses. /sys/bus/soc/devices is of particular
63		interest, as it contains a symlink for each SoC device found on
64		the system. Each symlink points back into the aforementioned
65		/sys/devices/socX devices.
66