Documentation/ABI/testing/sysfs-devices-soc

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