From patchwork Sat Jan 21 17:08:04 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 6336 Return-Path: X-Original-To: patchwork@peony.canonical.com Delivered-To: patchwork@peony.canonical.com Received: from fiordland.canonical.com (fiordland.canonical.com [91.189.94.145]) by peony.canonical.com (Postfix) with ESMTP id DCD3423E16 for ; Sat, 21 Jan 2012 17:08:28 +0000 (UTC) Received: from mail-bk0-f52.google.com (mail-bk0-f52.google.com [209.85.214.52]) by fiordland.canonical.com (Postfix) with ESMTP id C5B30A184AB for ; Sat, 21 Jan 2012 17:08:28 +0000 (UTC) Received: by mail-bk0-f52.google.com with SMTP id r19so1515325bka.11 for ; Sat, 21 Jan 2012 09:08:28 -0800 (PST) Received: by 10.205.139.12 with SMTP id iu12mr847986bkc.2.1327165708642; Sat, 21 Jan 2012 09:08:28 -0800 (PST) X-Forwarded-To: linaro-patchwork@canonical.com X-Forwarded-For: patch@linaro.org linaro-patchwork@canonical.com Delivered-To: patches@linaro.org Received: by 10.204.130.220 with SMTP id u28cs33757bks; Sat, 21 Jan 2012 09:08:28 -0800 (PST) Received: by 10.180.92.101 with SMTP id cl5mr3547529wib.21.1327165707316; Sat, 21 Jan 2012 09:08:27 -0800 (PST) Received: from mail-ww0-f42.google.com (mail-ww0-f42.google.com [74.125.82.42]) by mx.google.com with ESMTPS id bl1si6235679wib.25.2012.01.21.09.08.26 (version=TLSv1/SSLv3 cipher=OTHER); Sat, 21 Jan 2012 09:08:27 -0800 (PST) Received-SPF: neutral (google.com: 74.125.82.42 is neither permitted nor denied by best guess record for domain of lee.jones@linaro.org) client-ip=74.125.82.42; Authentication-Results: mx.google.com; spf=neutral (google.com: 74.125.82.42 is neither permitted nor denied by best guess record for domain of lee.jones@linaro.org) smtp.mail=lee.jones@linaro.org Received: by mail-ww0-f42.google.com with SMTP id gn7so373352wgb.1 for ; Sat, 21 Jan 2012 09:08:26 -0800 (PST) MIME-Version: 1.0 Received: by 10.180.97.166 with SMTP id eb6mr3661537wib.5.1327165706869; Sat, 21 Jan 2012 09:08:26 -0800 (PST) Received: from localhost.localdomain (cpc1-aztw13-0-0-cust473.18-1.cable.virginmedia.com. [77.102.241.218]) by mx.google.com with ESMTPS id em13sm3798591wid.7.2012.01.21.09.08.25 (version=TLSv1/SSLv3 cipher=OTHER); Sat, 21 Jan 2012 09:08:26 -0800 (PST) From: Lee Jones To: linux-arm-kernel@lists.infradead.org, arnd@arndb.de, greg@kroah.com, jamie@jamieiles.com, linus.walleij@stericsson.com Cc: shawn.guo@linaro.org, rnayak@ti.com, ccross@android.com, Lee Jones Subject: [PATCH 3/6] Documentation: add information for new sysfs soc bus functionality Date: Sat, 21 Jan 2012 17:08:04 +0000 Message-Id: <1327165687-4223-4-git-send-email-lee.jones@linaro.org> X-Mailer: git-send-email 1.7.5.4 In-Reply-To: <1327165687-4223-1-git-send-email-lee.jones@linaro.org> References: <1327165687-4223-1-git-send-email-lee.jones@linaro.org> X-Gm-Message-State: ALoCoQl4YELya/DKPqeG0dVYu37k5S9hc1qMfqPIvMnsSCle+9MctOuH9iyDce3/odOFnt4vDbk0 This change applies the required documentation for each new attribute recenty added by the new System-On-Chip (SoC) information export bus driver. Signed-off-by: Lee Jones --- Documentation/ABI/testing/sysfs-devices-soc | 58 +++++++++++++++++++++++++++ 1 files changed, 58 insertions(+), 0 deletions(-) create mode 100644 Documentation/ABI/testing/sysfs-devices-soc diff --git a/Documentation/ABI/testing/sysfs-devices-soc b/Documentation/ABI/testing/sysfs-devices-soc new file mode 100644 index 0000000..6d9cc25 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-devices-soc @@ -0,0 +1,58 @@ +What: /sys/devices/socX +Date: January 2012 +contact: Lee Jones +Description: + The /sys/devices/ directory contains a sub-directory for each + System-on-Chip (SoC) device on a running platform. Information + regarding each SoC can be obtained by reading sysfs files. This + functionality is only available if implemented by the platform. + + The directory created for each SoC will also house information + about devices which are commonly contained in /sys/devices/platform. + It has been agreed that if an SoC device exists, its supported + devices would be better suited to appear as children of that SoC. + +What: /sys/devices/socX/machine +Date: January 2012 +contact: Lee Jones +Description: + Read-only attribute common to all SoCs. Contains the SoC machine + name (e.g. Ux500). + +What: /sys/devices/socX/family +Date: January 2012 +contact: Lee Jones +Description: + Read-only attribute common to all SoCs. Contains SoC family name + (e.g. DB8500). + +What: /sys/devices/socX/soc_id +Date: January 2012 +contact: Lee Jones +Description: + Read-only attribute supported by most SoCs. In the case of + ST-Ericsson's chips this contains the SoC serial number. + +What: /sys/devices/socX/revision +Date: January 2012 +contact: Lee Jones +Description: + Read-only attribute supported by most SoCs. Contains the SoC's + manufacturing revision number. + +What: /sys/devices/socX/process +Date: January 2012 +contact: Lee Jones +Description: + Read-only attribute supported ST-Ericsson's silicon. Contains the + the process by which the silicon chip was manufactured. + +What: /sys/bus/soc +Date: January 2012 +contact: Lee Jones +Description: + The /sys/bus/soc/ directory contains the usual sub-folders + expected under most buses. /sys/bus/soc/devices is of particular + interest, as it contains a symlink for each SoC device found on + the system. Each symlink points back into the aforementioned + /sys/devices/socX devices.