From patchwork Mon Oct 17 11:52:55 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 4705 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 B290923DE2 for ; Mon, 17 Oct 2011 11:53:10 +0000 (UTC) Received: from mail-bw0-f52.google.com (mail-bw0-f52.google.com [209.85.214.52]) by fiordland.canonical.com (Postfix) with ESMTP id A2B9FA18493 for ; Mon, 17 Oct 2011 11:53:10 +0000 (UTC) Received: by mail-bw0-f52.google.com with SMTP id zs2so7119162bkb.11 for ; Mon, 17 Oct 2011 04:53:10 -0700 (PDT) Received: by 10.223.85.139 with SMTP id o11mr24056407fal.0.1318852390366; Mon, 17 Oct 2011 04:53:10 -0700 (PDT) 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.152.1.71 with SMTP id 7cs5419lak; Mon, 17 Oct 2011 04:53:10 -0700 (PDT) Received: by 10.216.229.80 with SMTP id g58mr3678027weq.43.1318852389734; Mon, 17 Oct 2011 04:53:09 -0700 (PDT) Received: from mail-wy0-f178.google.com (mail-wy0-f178.google.com [74.125.82.178]) by mx.google.com with ESMTPS id fs2si12670671wbb.68.2011.10.17.04.53.09 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 17 Oct 2011 04:53:09 -0700 (PDT) Received-SPF: neutral (google.com: 74.125.82.178 is neither permitted nor denied by best guess record for domain of lee.jones@linaro.org) client-ip=74.125.82.178; Authentication-Results: mx.google.com; spf=neutral (google.com: 74.125.82.178 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-wy0-f178.google.com with SMTP id 28so2985807wyf.37 for ; Mon, 17 Oct 2011 04:53:09 -0700 (PDT) Received: by 10.227.23.203 with SMTP id s11mr6960564wbb.83.1318852389126; Mon, 17 Oct 2011 04:53:09 -0700 (PDT) Received: from localhost.localdomain (cpc2-aztw13-0-0-cust146.aztw.cable.virginmedia.com. [77.99.12.147]) by mx.google.com with ESMTPS id 11sm20503068wby.15.2011.10.17.04.53.07 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 17 Oct 2011 04:53:08 -0700 (PDT) From: Lee Jones To: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Cc: gregkh@suse.de, linus.walleij@stericsson.com, jamie@jamieiles.com, arnd@arndb.de, Lee Jones Subject: [PATCH 3/6] Documentation: add information for new sysfs soc bus functionality Date: Mon, 17 Oct 2011 12:52:55 +0100 Message-Id: <1318852378-14180-4-git-send-email-lee.jones@linaro.org> X-Mailer: git-send-email 1.7.5.4 In-Reply-To: <1318852378-14180-1-git-send-email-lee.jones@linaro.org> References: <1318852378-14180-1-git-send-email-lee.jones@linaro.org> 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 | 48 +++++++++++++++++++++++++++ 1 files changed, 48 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..549cbda --- /dev/null +++ b/Documentation/ABI/testing/sysfs-devices-soc @@ -0,0 +1,48 @@ +What: /sys/devices/socX +Date: October 2011 +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: October 2011 +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: October 2011 +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: October 2011 +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: October 2011 +contact: Lee Jones +Description: + Read-only attribute supported by most SoCs. Contains the SoC's + manufacturing revision number. + +What: /sys/devices/socX/process +Date: October 2011 +contact: Lee Jones +Description: + Read-only attribute supported ST-Ericsson's silicon. Contains the + the process by which the silicon chip was manufactured.