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