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