From patchwork Wed Feb 4 07:00:50 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neelesh Gupta X-Patchwork-Id: 436162 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 69222140187 for ; Wed, 4 Feb 2015 18:03:49 +1100 (AEDT) Received: from ozlabs.org (ozlabs.org [103.22.144.67]) by lists.ozlabs.org (Postfix) with ESMTP id 5642A1A09D9 for ; Wed, 4 Feb 2015 18:03:49 +1100 (AEDT) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Received: from e23smtp09.au.ibm.com (e23smtp09.au.ibm.com [202.81.31.142]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 79A4F1A09D8 for ; Wed, 4 Feb 2015 18:03:47 +1100 (AEDT) Received: from /spool/local by e23smtp09.au.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Wed, 4 Feb 2015 17:03:46 +1000 Received: from d23dlp03.au.ibm.com (202.81.31.214) by e23smtp09.au.ibm.com (202.81.31.206) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; Wed, 4 Feb 2015 17:03:45 +1000 Received: from d23relay08.au.ibm.com (d23relay08.au.ibm.com [9.185.71.33]) by d23dlp03.au.ibm.com (Postfix) with ESMTP id B1E753578048 for ; Wed, 4 Feb 2015 18:03:44 +1100 (EST) Received: from d23av04.au.ibm.com (d23av04.au.ibm.com [9.190.235.139]) by d23relay08.au.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id t1473ani40763576 for ; Wed, 4 Feb 2015 18:03:44 +1100 Received: from d23av04.au.ibm.com (localhost [127.0.0.1]) by d23av04.au.ibm.com (8.14.4/8.14.4/NCO v10.0 AVout) with ESMTP id t1473BQG006164 for ; Wed, 4 Feb 2015 18:03:11 +1100 Received: from localhost.localdomain ([9.124.35.239]) by d23av04.au.ibm.com (8.14.4/8.14.4/NCO v10.0 AVin) with ESMTP id t1473AcG005511 for ; Wed, 4 Feb 2015 18:03:10 +1100 To: skiboot@lists.ozlabs.org From: Neelesh Gupta Date: Wed, 04 Feb 2015 12:30:50 +0530 Message-ID: <20150204065951.3278.63993.stgit@localhost.localdomain> In-Reply-To: <20150204065108.3278.92169.stgit@localhost.localdomain> References: <20150204065108.3278.92169.stgit@localhost.localdomain> User-Agent: StGit/0.16 MIME-Version: 1.0 X-TM-AS-MML: disable X-Content-Scanned: Fidelis XPS MAILER x-cbid: 15020407-0033-0000-0000-00000104028E Subject: [Skiboot] [PATCH v3 3/3] Document the device-tree entries for the VPD X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Neelesh Gupta --- doc/device-tree/vpd.txt | 64 +++++++++++++++++++++++++++++++++++++++++++++++ doc/vpd-properties.txt | 19 -------------- 2 files changed, 64 insertions(+), 19 deletions(-) create mode 100644 doc/device-tree/vpd.txt delete mode 100644 doc/vpd-properties.txt diff --git a/doc/device-tree/vpd.txt b/doc/device-tree/vpd.txt new file mode 100644 index 0000000..949ee0b --- /dev/null +++ b/doc/device-tree/vpd.txt @@ -0,0 +1,64 @@ +VPD (Vital Product Data) +------------------------ + +VPD provides the information about the FRUs (Field Replaceable Unit) present in +the system. Each vpd node represents a FRU, having properties as below. + +/vpd : VPD root node +@ : Node name +ibm,vpd : VPD data binary blob +ccin : Customer Card Identification Number +fru-type : FRU type label (2 bytes ASCII character) +fru-number : FRU stocking part number +ibm,loc-code : Location code +part-number : Part number +serial-number : Serial number +ibm,chip-id : Processor Id +size : DIMM size (applicable for DIMM VPD only) + +The VPD tree in the device tree depicts the hierarchial structure of the +FRUs having parent-child relationship. + +root-node-vpd@a000 + |-- enclosure@1e00 + | |-- air-mover@3a00 + | |-- air-mover@3a01 + | |-- backplane@800 + | | |-- anchor-card@500 + | | |-- backplane-extender@900 + | | | |-- serial-connector@2a00 + | | | |-- usb-connector@2900 + | | | `-- usb-connector@2901 + | | |-- ethernet-connector@2800 + | | |-- ethernet-connector@2801 + | | |-- ms-dimm@d002 + | | |-- ms-dimm@d003 + | | |-- processor@1000 + | | |-- processor@1001 + | | |-- usb-connector@2902 + | | |-- usb-connector@2903 + | | |-- usb-connector@2904 + | | `-- usb-connector@2905 + | |-- dasd-backplane@2400 + | |-- dasd-backplane@2401 + | |-- power-supply@3103 + | `-- service-processor@200 + |-- enclosure-fault-led@a300 + |-- enclosure-led@a200 + |-- root-node-vpd@a001 + `-- system-vpd@1c00 + +Example vpd node: + +anchor-card@500 { + ccin = "52FE"; + fru-number = "00E2147"; + description = "System Anchor Card - IBM Power 824"; + ibm,loc-code = "U78C9.001.WZS007X-P1-C13"; + serial-number = "YL10113BJ001"; + ibm,vpd = <0x84cc0052 0x54045649 0x4e494452 0x10414e43 0x484f5220 0x20202020 0x20202020 0x20434501 0x31565a02 0x3031464e 0x7303045 0x32313437 0x504e0730 0x30453231 0x3438534e 0xc594c31 0x30313133 0x424a3030 0x31434304 0x35324645 0x50520881 0x300000 0x48 0x45043030 0x31304354 0x440b400 0x485702 0x14233 0x6000000 0x142 0x34010042 0x370c0000 0x0 0x0 0x4239 0x3c435333 0x22071917 0xd1569c53 0x50973c87 0x71f9c40 0x1d4d3142 0x985e80f1 0x5cb3614d 0x32a902cb 0xd9d714ab 0x164d3322 0xdda4f986 0x5a618f4d 0x340b157c 0x2cac0a94 0x6504603 0x78 0x0>; + fru-type = [41 56]; + part-number = "00E2148"; + phandle = <0x8d>; + linux,phandle = <0x8d>; +}; diff --git a/doc/vpd-properties.txt b/doc/vpd-properties.txt deleted file mode 100644 index ae18a7f..0000000 --- a/doc/vpd-properties.txt +++ /dev/null @@ -1,19 +0,0 @@ -VPD properties Description -========================== - -/vpd : VPD root node -Node name : @ -ibm,vpd : VPD data (binary blob) -ccin : Customer Card Identification Number -fru-type : FRU type label (two byte ASCII Char) -fru-number : FRU Stocking Part Number -ibm,loc-code : Location code -part-number : Part Number -serial-number : Serial Number -ibm,chip-id : Process ID -size : DIMM Size (applicable for DIMM VPD only) - -Child Node: -=========== -A child node inherits its parent's VPD information except for the -fru-type and location code.