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 29 What: /sys/devices/socX/serial_number
54 Date: January 2019 30 Date: January 2019
55 contact: Bjorn Andersson <bjorn.andersso 31 contact: Bjorn Andersson <bjorn.andersson@linaro.org>
56 Description: 32 Description:
57 Read-only attribute supported 33 Read-only attribute supported by most SoCs. Contains the SoC's
58 serial number, if available. 34 serial number, if available.
59 35
60 What: /sys/devices/socX/soc_id 36 What: /sys/devices/socX/soc_id
61 Date: January 2012 37 Date: January 2012
62 contact: Lee Jones <lee@kernel.org> !! 38 contact: Lee Jones <lee.jones@linaro.org>
63 Description: 39 Description:
64 Read-only attribute supported 40 Read-only attribute supported by most SoCs. In the case of
65 ST-Ericsson's chips this conta 41 ST-Ericsson's chips this contains the SoC serial number.
66 42
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 43 What: /sys/devices/socX/revision
74 Date: January 2012 44 Date: January 2012
75 contact: Lee Jones <lee@kernel.org> !! 45 contact: Lee Jones <lee.jones@linaro.org>
76 Description: 46 Description:
77 Read-only attribute supported 47 Read-only attribute supported by most SoCs. Contains the SoC's
78 manufacturing revision number. 48 manufacturing revision number.
79 49
80 What: /sys/devices/socX/process 50 What: /sys/devices/socX/process
81 Date: January 2012 51 Date: January 2012
82 contact: Lee Jones <lee@kernel.org> !! 52 contact: Lee Jones <lee.jones@linaro.org>
83 Description: 53 Description:
84 Read-only attribute supported 54 Read-only attribute supported ST-Ericsson's silicon. Contains the
85 the process by which the silic 55 the process by which the silicon chip was manufactured.
86 56
87 What: /sys/bus/soc 57 What: /sys/bus/soc
88 Date: January 2012 58 Date: January 2012
89 contact: Lee Jones <lee@kernel.org> !! 59 contact: Lee Jones <lee.jones@linaro.org>
90 Description: 60 Description:
91 The /sys/bus/soc/ directory co 61 The /sys/bus/soc/ directory contains the usual sub-folders
92 expected under most buses. /sy 62 expected under most buses. /sys/bus/soc/devices is of particular
93 interest, as it contains a sym 63 interest, as it contains a symlink for each SoC device found on
94 the system. Each symlink point 64 the system. Each symlink points back into the aforementioned
95 /sys/devices/socX devices. 65 /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.