1 What: /sys/devices/socX 1 What: /sys/devices/socX
2 Date: January 2012 2 Date: January 2012
3 contact: Lee Jones <lee@kernel.org> !! 3 contact: Lee Jones <lee.jones@linaro.org>
4 Description: 4 Description:
5 The /sys/devices/ directory co 5 The /sys/devices/ directory contains a sub-directory for each
6 System-on-Chip (SoC) device on 6 System-on-Chip (SoC) device on a running platform. Information
7 regarding each SoC can be obta 7 regarding each SoC can be obtained by reading sysfs files. This
8 functionality is only availabl 8 functionality is only available if implemented by the platform.
9 9
10 The directory created for each 10 The directory created for each SoC will also house information
11 about devices which are common 11 about devices which are commonly contained in /sys/devices/platform.
12 It has been agreed that if an 12 It has been agreed that if an SoC device exists, its supported
13 devices would be better suited 13 devices would be better suited to appear as children of that SoC.
14 14
15 What: /sys/devices/socX/machine 15 What: /sys/devices/socX/machine
16 Date: January 2012 16 Date: January 2012
17 contact: Lee Jones <lee@kernel.org> !! 17 contact: Lee Jones <lee.jones@linaro.org>
18 Description: 18 Description:
19 Read-only attribute common to 19 Read-only attribute common to all SoCs. Contains the SoC machine
20 name (e.g. Ux500). 20 name (e.g. Ux500).
21 21
22 What: /sys/devices/socX/family 22 What: /sys/devices/socX/family
23 Date: January 2012 23 Date: January 2012
24 contact: Lee Jones <lee@kernel.org> !! 24 contact: Lee Jones <lee.jones@linaro.org>
25 Description: 25 Description:
26 Read-only attribute common to 26 Read-only attribute common to all SoCs. Contains SoC family name
27 (e.g. DB8500). 27 (e.g. DB8500).
28 28
29 On many of ARM based silicon w <<
30 this will contain the JEDEC JE <<
31 code. The format is "jep106:XX <<
32 YY is continuation code. <<
33 <<
34 This manufacturer’s identifi <<
35 or more eight (8) bit fields, <<
36 data bits plus one (1) odd par <<
37 limiting the possible number o <<
38 the maximum number of identifi <<
39 scheme has been defined. <<
40 <<
41 The specified mechanism is tha <<
42 represents the "continuation c <<
43 of an additional identity code <<
44 may be extended to multiple co <<
45 by the manufacturer's identity <<
46 <<
47 For example, ARM has identity <<
48 which is code 0x3B on the fift <<
49 as JEP106 identity code of 0x3 <<
50 0x4 to represent the four cont <<
51 identity code. <<
52 <<
53 What: /sys/devices/socX/serial_numbe <<
54 Date: January 2019 <<
55 contact: Bjorn Andersson <bjorn.andersso <<
56 Description: <<
57 Read-only attribute supported <<
58 serial number, if available. <<
59 <<
60 What: /sys/devices/socX/soc_id 29 What: /sys/devices/socX/soc_id
61 Date: January 2012 30 Date: January 2012
62 contact: Lee Jones <lee@kernel.org> !! 31 contact: Lee Jones <lee.jones@linaro.org>
63 Description: 32 Description:
64 Read-only attribute supported 33 Read-only attribute supported by most SoCs. In the case of
65 ST-Ericsson's chips this conta 34 ST-Ericsson's chips this contains the SoC serial number.
66 35
67 On many of ARM based silicon w <<
68 this will contain the SOC ID a <<
69 to ensure there is no conflict <<
70 vendors. The format is "jep106 <<
71 code, YY is continuation code <<
72 <<
73 What: /sys/devices/socX/revision 36 What: /sys/devices/socX/revision
74 Date: January 2012 37 Date: January 2012
75 contact: Lee Jones <lee@kernel.org> !! 38 contact: Lee Jones <lee.jones@linaro.org>
76 Description: 39 Description:
77 Read-only attribute supported 40 Read-only attribute supported by most SoCs. Contains the SoC's
78 manufacturing revision number. 41 manufacturing revision number.
79 42
80 What: /sys/devices/socX/process 43 What: /sys/devices/socX/process
81 Date: January 2012 44 Date: January 2012
82 contact: Lee Jones <lee@kernel.org> !! 45 contact: Lee Jones <lee.jones@linaro.org>
83 Description: 46 Description:
84 Read-only attribute supported 47 Read-only attribute supported ST-Ericsson's silicon. Contains the
85 the process by which the silic 48 the process by which the silicon chip was manufactured.
86 49
87 What: /sys/bus/soc 50 What: /sys/bus/soc
88 Date: January 2012 51 Date: January 2012
89 contact: Lee Jones <lee@kernel.org> !! 52 contact: Lee Jones <lee.jones@linaro.org>
90 Description: 53 Description:
91 The /sys/bus/soc/ directory co 54 The /sys/bus/soc/ directory contains the usual sub-folders
92 expected under most buses. /sy 55 expected under most buses. /sys/bus/soc/devices is of particular
93 interest, as it contains a sym 56 interest, as it contains a symlink for each SoC device found on
94 the system. Each symlink point 57 the system. Each symlink points back into the aforementioned
95 /sys/devices/socX devices. 58 /sys/devices/socX devices.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.