hc
2023-12-06 08f87f769b595151be1afeff53e144f543faa614
kernel/Documentation/ABI/testing/sysfs-devices-soc
....@@ -26,6 +26,37 @@
2626 Read-only attribute common to all SoCs. Contains SoC family name
2727 (e.g. DB8500).
2828
29
+ On many of ARM based silicon with SMCCC v1.2+ compliant firmware
30
+ this will contain the JEDEC JEP106 manufacturer’s identification
31
+ code. The format is "jep106:XXYY" where XX is identity code and
32
+ YY is continuation code.
33
+
34
+ This manufacturer’s identification code is defined by one
35
+ or more eight (8) bit fields, each consisting of seven (7)
36
+ data bits plus one (1) odd parity bit. It is a single field,
37
+ limiting the possible number of vendors to 126. To expand
38
+ the maximum number of identification codes, a continuation
39
+ scheme has been defined.
40
+
41
+ The specified mechanism is that an identity code of 0x7F
42
+ represents the "continuation code" and implies the presence
43
+ of an additional identity code field, and this mechanism
44
+ may be extended to multiple continuation codes followed
45
+ by the manufacturer's identity code.
46
+
47
+ For example, ARM has identity code 0x7F 0x7F 0x7F 0x7F 0x3B,
48
+ which is code 0x3B on the fifth 'page'. This is shortened
49
+ as JEP106 identity code of 0x3B and a continuation code of
50
+ 0x4 to represent the four continuation codes preceding the
51
+ identity code.
52
+
53
+What: /sys/devices/socX/serial_number
54
+Date: January 2019
55
+contact: Bjorn Andersson <bjorn.andersson@linaro.org>
56
+Description:
57
+ Read-only attribute supported by most SoCs. Contains the SoC's
58
+ serial number, if available.
59
+
2960 What: /sys/devices/socX/soc_id
3061 Date: January 2012
3162 contact: Lee Jones <lee.jones@linaro.org>
....@@ -33,6 +64,12 @@
3364 Read-only attribute supported by most SoCs. In the case of
3465 ST-Ericsson's chips this contains the SoC serial number.
3566
67
+ On many of ARM based silicon with SMCCC v1.2+ compliant firmware
68
+ this will contain the SOC ID appended to the family attribute
69
+ to ensure there is no conflict in this namespace across various
70
+ vendors. The format is "jep106:XXYY:ZZZZ" where XX is identity
71
+ code, YY is continuation code and ZZZZ is the SOC ID.
72
+
3673 What: /sys/devices/socX/revision
3774 Date: January 2012
3875 contact: Lee Jones <lee.jones@linaro.org>