Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) What:		/sys/devices/socX
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) 		The /sys/devices/ directory contains a sub-directory for each
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) 		System-on-Chip (SoC) device on a running platform. Information
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 		regarding each SoC can be obtained by reading sysfs files. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) 		functionality is only available if implemented by the platform.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) 		The directory created for each SoC will also house information
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) 		about devices which are commonly contained in /sys/devices/platform.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) 		It has been agreed that if an SoC device exists, its supported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 		devices would be better suited to appear as children of that SoC.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) What:		/sys/devices/socX/machine
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 		Read-only attribute common to all SoCs. Contains the SoC machine
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) 		name (e.g. Ux500).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) What:		/sys/devices/socX/family
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) 		Read-only attribute common to all SoCs. Contains SoC family name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) 		(e.g. DB8500).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 		On many of ARM based silicon with SMCCC v1.2+ compliant firmware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 		this will contain the JEDEC JEP106 manufacturer’s identification
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) 		code. The format is "jep106:XXYY" where XX is identity code and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 		YY is continuation code.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) 		This manufacturer’s identification code is defined by one
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 		or more eight (8) bit fields, each consisting of seven (7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) 		data bits plus one (1) odd parity bit. It is a single field,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 		limiting the possible number of vendors to 126. To expand
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) 		the maximum number of identification codes, a continuation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) 		scheme has been defined.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) 		The specified mechanism is that an identity code of 0x7F
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) 		represents the "continuation code" and implies the presence
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) 		of an additional identity code field, and this mechanism
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) 		may be extended to multiple continuation codes followed
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) 		by the manufacturer's identity code.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) 		For example, ARM has identity code 0x7F 0x7F 0x7F 0x7F 0x3B,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) 		which is code 0x3B on the fifth 'page'. This is shortened
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) 		as JEP106 identity code of 0x3B and a continuation code of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) 		0x4 to represent the four continuation codes preceding the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) 		identity code.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) What:		/sys/devices/socX/serial_number
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) Date:		January 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) contact:	Bjorn Andersson <bjorn.andersson@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 		Read-only attribute supported by most SoCs. Contains the SoC's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 		serial number, if available.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) What:		/sys/devices/socX/soc_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) 		Read-only attribute supported by most SoCs. In the case of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) 		ST-Ericsson's chips this contains the SoC serial number.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) 		On many of ARM based silicon with SMCCC v1.2+ compliant firmware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) 		this will contain the SOC ID appended to the family attribute
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) 		to ensure there is no conflict in this namespace across various
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) 		vendors. The format is "jep106:XXYY:ZZZZ" where XX is identity
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) 		code, YY is continuation code and ZZZZ is the SOC ID.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) What:		/sys/devices/socX/revision
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) 		Read-only attribute supported by most SoCs. Contains the SoC's
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) 		manufacturing revision number.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) What:		/sys/devices/socX/process
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) 		Read-only attribute supported ST-Ericsson's silicon. Contains the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) 		the process by which the silicon chip was manufactured.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) What:		/sys/bus/soc
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) Date:		January 2012
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) contact:	Lee Jones <lee.jones@linaro.org>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) 		The /sys/bus/soc/ directory contains the usual sub-folders
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) 		expected under most buses. /sys/bus/soc/devices is of particular
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) 		interest, as it contains a symlink for each SoC device found on
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) 		the system. Each symlink points back into the aforementioned
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) 		/sys/devices/socX devices.