From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-9.0 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,T_DKIMWL_WL_HIGH,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 047F8C04AAC for ; Thu, 23 May 2019 05:51:21 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id B64A621773 for ; Thu, 23 May 2019 05:51:20 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="lguYD4HN"; dkim=fail reason="signature verification failed" (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b="s8iIeKRx" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B64A621773 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=nxp.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+infradead-linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:In-Reply-To:References: Message-ID:Date:Subject:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=wJXkmvoAdqdK/Jze68PBH/rWp5RJfNMVTtnRHVT9ZQs=; b=lguYD4HNWy8gs9 +eA9Mv6rVfWMp/xhiak+I2RRWMCAP/cm36YnNUoJBGG/GDOXceVnXRVhB5+NwHtEonNKvlKIPTufC DIgE3ucKeJeLa/eT9qLTZfUNc3OiPL1Fgv16+mMkzDQEiDss6S5l5lx6LDlUs9uDumJghyUe8IMzK /QShoJz7GjUgJ6Lbfr83nNVuVt46bbju8PG2U4xcxkkSUTSoTb99DE5uisa4VQycgJfgtImv+kLm3 of0URWVAsglEPJ6e+9+HlW2ebdm46q7o9ASujxwrv6eVPH4TcdVUr5/Mk6XWfkHv3KNIMxjRGKIOi LreeDXo+yy1Pid8xGqvQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1hTgdH-0007Dx-EO; Thu, 23 May 2019 05:51:15 +0000 Received: from mail-eopbgr10086.outbound.protection.outlook.com ([40.107.1.86] helo=EUR02-HE1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1hTgd5-00070E-7L for linux-arm-kernel@lists.infradead.org; Thu, 23 May 2019 05:51:04 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=mtKNTwaKLzob0itOvH8iWjYzWGHKZZWtULJ1yn3w2II=; b=s8iIeKRx+MBs86dEV1LMbKaBYiwOwHFQcyfjhstPHEJ5j0DNqf+YfqE/lDEqiQPoB0fQgVtoG9TYUTfIDyhyEtFVfbiBIKOhhJdqBZbOJkpIDXZnXhCM/F4F7SaZMb6kAsfAiIUhZzLtZKTzAdXaA3cA9j6fgRr2Qs+sbyqMLAU= Received: from AM0PR04MB4481.eurprd04.prod.outlook.com (52.135.147.15) by AM0PR04MB3956.eurprd04.prod.outlook.com (52.134.93.159) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1900.18; Thu, 23 May 2019 05:50:58 +0000 Received: from AM0PR04MB4481.eurprd04.prod.outlook.com ([fe80::3173:24:d401:2378]) by AM0PR04MB4481.eurprd04.prod.outlook.com ([fe80::3173:24:d401:2378%6]) with mapi id 15.20.1900.020; Thu, 23 May 2019 05:50:58 +0000 From: Peng Fan To: "robh+dt@kernel.org" , "mark.rutland@arm.com" , "jassisinghbrar@gmail.com" , "sudeep.holla@arm.com" Subject: [PATCH 1/2] DT: mailbox: add binding doc for the ARM SMC mailbox Thread-Topic: [PATCH 1/2] DT: mailbox: add binding doc for the ARM SMC mailbox Thread-Index: AQHVESt+5fp+4ZxwMEmNHJCtGp/VNQ== Date: Thu, 23 May 2019 05:50:58 +0000 Message-ID: <20190523060437.11059-2-peng.fan@nxp.com> References: <20190523060437.11059-1-peng.fan@nxp.com> In-Reply-To: <20190523060437.11059-1-peng.fan@nxp.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-mailer: git-send-email 2.16.4 x-clientproxiedby: HK0P153CA0040.APCP153.PROD.OUTLOOK.COM (2603:1096:203:17::28) To AM0PR04MB4481.eurprd04.prod.outlook.com (2603:10a6:208:70::15) authentication-results: spf=none (sender IP is ) smtp.mailfrom=peng.fan@nxp.com; x-ms-exchange-messagesentrepresentingtype: 1 x-originating-ip: [119.31.174.71] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: ecf51b94-0f2d-4601-2daf-08d6df42a0e7 x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600141)(711020)(4605104)(4618075)(2017052603328)(7193020); SRVR:AM0PR04MB3956; x-ms-traffictypediagnostic: AM0PR04MB3956: x-ms-exchange-purlcount: 1 x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-forefront-prvs: 00462943DE x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(136003)(39860400002)(376002)(346002)(396003)(366004)(199004)(189003)(2201001)(86362001)(6512007)(7110500001)(256004)(6436002)(6306002)(44832011)(486006)(2501003)(2906002)(2616005)(476003)(6116002)(3846002)(81166006)(8676002)(25786009)(6486002)(305945005)(81156014)(8936002)(50226002)(2420400007)(4326008)(53936002)(11346002)(15650500001)(7736002)(316002)(446003)(186003)(26005)(14454004)(66066001)(68736007)(1076003)(36756003)(71200400001)(71190400001)(102836004)(5660300002)(347745004)(386003)(54906003)(110136005)(76176011)(6506007)(99286004)(66556008)(66446008)(66476007)(7416002)(66946007)(478600001)(73956011)(52116002)(64756008); DIR:OUT; SFP:1101; SCL:1; SRVR:AM0PR04MB3956; H:AM0PR04MB4481.eurprd04.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; received-spf: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) x-ms-exchange-senderadcheck: 1 x-microsoft-antispam-message-info: JXL3dIoOZdZqNPGrNhAq5vYhmav5WqYMdZ73VFtEXIb+gs1vjXXBmQh4H1LDjWSp1hSCiT4IvIegnoKGYQ7CTmbOrHkIalsRGV5O+fGJZTBr2QjCmsibR8SYut4f5Jb8IA66radeYBcGMv15DKVmDBgqEm/lRHZQ7aN64CGA+cA+RnaO8kMq5cAV5zQWqoUOPUWkK6KoflFPlLZs2U6rHEEUFIryup3QX2GZj2TLkDTZaQDDjhVwrQl0ZTDA2nZcnGrbravQs7NOgP7uCK8ZUTiO3z3bho93/iLPbvVmsP8GzLD05lehLe9r1btRIye7IGpuJyeZqmLTbavcFwRYddPQt2KOz/6EVP5CBCIptqb/deORpcmui+WT1VE+QQtvTDOatxww+ZCcIlUOg8NAGVyBEvAKU6OL1MtRIdxAkyY= MIME-Version: 1.0 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: ecf51b94-0f2d-4601-2daf-08d6df42a0e7 X-MS-Exchange-CrossTenant-originalarrivaltime: 23 May 2019 05:50:58.3462 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR04MB3956 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20190522_225103_266801_A9EA8BFC X-CRM114-Status: GOOD ( 19.37 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: "devicetree@vger.kernel.org" , Peng Fan , "shawnguo@kernel.org" , "linux-kernel@vger.kernel.org" , dl-linux-imx , "kernel@pengutronix.de" , "andre.przywara@arm.com" , "van.freenix@gmail.com" , "festevam@gmail.com" , "linux-arm-kernel@lists.infradead.org" Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+infradead-linux-arm-kernel=archiver.kernel.org@lists.infradead.org The ARM SMC mailbox binding describes a firmware interface to trigger actions in software layers running in the EL2 or EL3 exception levels. The term "ARM" here relates to the SMC instruction as part of the ARM instruction set, not as a standard endorsed by ARM Ltd. Signed-off-by: Peng Fan --- V1: arm,func-ids is still kept as an optional property, because there is no defined SMC funciton id passed from SCMI. So in my test, I still use arm,func-ids for ARM SIP service. .../devicetree/bindings/mailbox/arm-smc.txt | 96 ++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 Documentation/devicetree/bindings/mailbox/arm-smc.txt diff --git a/Documentation/devicetree/bindings/mailbox/arm-smc.txt b/Documentation/devicetree/bindings/mailbox/arm-smc.txt new file mode 100644 index 000000000000..12fc5997933d --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/arm-smc.txt @@ -0,0 +1,96 @@ +ARM SMC Mailbox Interface +========================= + +This mailbox uses the ARM smc (secure monitor call) instruction to +trigger a mailbox-connected activity in firmware, executing on the very same +core as the caller. By nature this operation is synchronous and this +mailbox provides no way for asynchronous messages to be delivered the other +way round, from firmware to the OS. However the value of r0/w0/x0 the firmware +returns after the smc call is delivered as a received message to the +mailbox framework, so a synchronous communication can be established. +The exact meaning of both the action the mailbox triggers as well as the +return value is defined by their users and is not subject to this binding. + +One use case of this mailbox is the SCMI interface, which uses shared memory +to transfer commands and parameters, and a mailbox to trigger a function +call. This allows SoCs without a separate management processor (or +when such a processor is not available or used) to use this standardized +interface anyway. + +This binding describes no hardware, but establishes a firmware interface. +Upon receiving an SMC using one of the described SMC function identifiers, +the firmware is expected to trigger some mailbox connected functionality. +The communication follows the ARM SMC calling convention[1]. +Firmware expects an SMC function identifier in r0 or w0. The supported +identifiers are passed from consumers, or listed in the the arm,func-ids +properties as described below. The firmware can return one value in +the first SMC result register, it is expected to be an error value, +which shall be propagated to the mailbox client. + +Any core which supports the SMC or HVC instruction can be used, as long as +a firmware component running in EL3 or EL2 is handling these calls. + +Mailbox Device Node: +==================== + +This node is expected to be a child of the /firmware node. + +Required properties: +-------------------- +- compatible: Shall be "arm,smc-mbox" +- #mbox-cells Shall be 1 - the index of the channel needed. +- arm,num-chans The number of channels supported. +- method: A string, either: + "hvc": if the driver shall use an HVC call, or + "smc": if the driver shall use an SMC call. + +Optional properties: +- arm,func-ids An array of 32-bit values specifying the function + IDs used by each mailbox channel. Those function IDs + follow the ARM SMC calling convention standard [1]. + There is one identifier per channel and the number + of supported channels is determined by the length + of this array. + +Example: +-------- + + sram@910000 { + compatible = "mmio-sram"; + reg = <0x0 0x93f000 0x0 0x1000>; + #address-cells = <1>; + #size-cells = <1>; + ranges = <0 0x0 0x93f000 0x1000>; + + cpu_scp_lpri: scp-shmem@0 { + compatible = "arm,scmi-shmem"; + reg = <0x0 0x200>; + }; + + cpu_scp_hpri: scp-shmem@200 { + compatible = "arm,scmi-shmem"; + reg = <0x200 0x200>; + }; + }; + + smc_mbox: mailbox { + #mbox-cells = <1>; + compatible = "arm,smc-mbox"; + method = "smc"; + arm,num-chans = <0x2>; + /* Optional */ + arm,func-ids = <0xc20000fe>, <0xc20000ff>; + }; + + firmware { + scmi { + compatible = "arm,scmi"; + mboxes = <&mailbox 0 &mailbox 1>; + mbox-names = "tx", "rx"; + shmem = <&cpu_scp_lpri &cpu_scp_hpri>; + }; + }; + + +[1] +http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.den0028a/index.html -- 2.16.4 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel From mboxrd@z Thu Jan 1 00:00:00 1970 From: Peng Fan Subject: [PATCH 1/2] DT: mailbox: add binding doc for the ARM SMC mailbox Date: Thu, 23 May 2019 05:50:58 +0000 Message-ID: <20190523060437.11059-2-peng.fan@nxp.com> References: <20190523060437.11059-1-peng.fan@nxp.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20190523060437.11059-1-peng.fan@nxp.com> Content-Language: en-US Sender: linux-kernel-owner@vger.kernel.org To: "robh+dt@kernel.org" , "mark.rutland@arm.com" , "jassisinghbrar@gmail.com" , "sudeep.holla@arm.com" Cc: "kernel@pengutronix.de" , dl-linux-imx , "shawnguo@kernel.org" , "festevam@gmail.com" , "devicetree@vger.kernel.org" , "linux-kernel@vger.kernel.org" , "linux-arm-kernel@lists.infradead.org" , "andre.przywara@arm.com" , "van.freenix@gmail.com" , Peng Fan List-Id: devicetree@vger.kernel.org VGhlIEFSTSBTTUMgbWFpbGJveCBiaW5kaW5nIGRlc2NyaWJlcyBhIGZpcm13YXJlIGludGVyZmFj ZSB0byB0cmlnZ2VyCmFjdGlvbnMgaW4gc29mdHdhcmUgbGF5ZXJzIHJ1bm5pbmcgaW4gdGhlIEVM MiBvciBFTDMgZXhjZXB0aW9uIGxldmVscy4KVGhlIHRlcm0gIkFSTSIgaGVyZSByZWxhdGVzIHRv IHRoZSBTTUMgaW5zdHJ1Y3Rpb24gYXMgcGFydCBvZiB0aGUgQVJNCmluc3RydWN0aW9uIHNldCwg bm90IGFzIGEgc3RhbmRhcmQgZW5kb3JzZWQgYnkgQVJNIEx0ZC4KClNpZ25lZC1vZmYtYnk6IFBl bmcgRmFuIDxwZW5nLmZhbkBueHAuY29tPgotLS0KClYxOgphcm0sZnVuYy1pZHMgaXMgc3RpbGwg a2VwdCBhcyBhbiBvcHRpb25hbCBwcm9wZXJ0eSwgYmVjYXVzZSB0aGVyZSBpcyBubwpkZWZpbmVk IFNNQyBmdW5jaXRvbiBpZCBwYXNzZWQgZnJvbSBTQ01JLiBTbyBpbiBteSB0ZXN0LCBJIHN0aWxs IHVzZQphcm0sZnVuYy1pZHMgZm9yIEFSTSBTSVAgc2VydmljZS4KCiAuLi4vZGV2aWNldHJlZS9i aW5kaW5ncy9tYWlsYm94L2FybS1zbWMudHh0ICAgICAgICB8IDk2ICsrKysrKysrKysrKysrKysr KysrKysKIDEgZmlsZSBjaGFuZ2VkLCA5NiBpbnNlcnRpb25zKCspCiBjcmVhdGUgbW9kZSAxMDA2 NDQgRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL21haWxib3gvYXJtLXNtYy50eHQK CmRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvbWFpbGJveC9h cm0tc21jLnR4dCBiL0RvY3VtZW50YXRpb24vZGV2aWNldHJlZS9iaW5kaW5ncy9tYWlsYm94L2Fy bS1zbWMudHh0Cm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IDAwMDAwMDAwMDAwMC4uMTJmYzU5 OTc5MzNkCi0tLSAvZGV2L251bGwKKysrIGIvRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRp bmdzL21haWxib3gvYXJtLXNtYy50eHQKQEAgLTAsMCArMSw5NiBAQAorQVJNIFNNQyBNYWlsYm94 IEludGVyZmFjZQorPT09PT09PT09PT09PT09PT09PT09PT09PQorCitUaGlzIG1haWxib3ggdXNl cyB0aGUgQVJNIHNtYyAoc2VjdXJlIG1vbml0b3IgY2FsbCkgaW5zdHJ1Y3Rpb24gdG8KK3RyaWdn ZXIgYSBtYWlsYm94LWNvbm5lY3RlZCBhY3Rpdml0eSBpbiBmaXJtd2FyZSwgZXhlY3V0aW5nIG9u IHRoZSB2ZXJ5IHNhbWUKK2NvcmUgYXMgdGhlIGNhbGxlci4gQnkgbmF0dXJlIHRoaXMgb3BlcmF0 aW9uIGlzIHN5bmNocm9ub3VzIGFuZCB0aGlzCittYWlsYm94IHByb3ZpZGVzIG5vIHdheSBmb3Ig YXN5bmNocm9ub3VzIG1lc3NhZ2VzIHRvIGJlIGRlbGl2ZXJlZCB0aGUgb3RoZXIKK3dheSByb3Vu ZCwgZnJvbSBmaXJtd2FyZSB0byB0aGUgT1MuIEhvd2V2ZXIgdGhlIHZhbHVlIG9mIHIwL3cwL3gw IHRoZSBmaXJtd2FyZQorcmV0dXJucyBhZnRlciB0aGUgc21jIGNhbGwgaXMgZGVsaXZlcmVkIGFz IGEgcmVjZWl2ZWQgbWVzc2FnZSB0byB0aGUKK21haWxib3ggZnJhbWV3b3JrLCBzbyBhIHN5bmNo cm9ub3VzIGNvbW11bmljYXRpb24gY2FuIGJlIGVzdGFibGlzaGVkLgorVGhlIGV4YWN0IG1lYW5p bmcgb2YgYm90aCB0aGUgYWN0aW9uIHRoZSBtYWlsYm94IHRyaWdnZXJzIGFzIHdlbGwgYXMgdGhl CityZXR1cm4gdmFsdWUgaXMgZGVmaW5lZCBieSB0aGVpciB1c2VycyBhbmQgaXMgbm90IHN1Ympl Y3QgdG8gdGhpcyBiaW5kaW5nLgorCitPbmUgdXNlIGNhc2Ugb2YgdGhpcyBtYWlsYm94IGlzIHRo ZSBTQ01JIGludGVyZmFjZSwgd2hpY2ggdXNlcyBzaGFyZWQgbWVtb3J5Cit0byB0cmFuc2ZlciBj b21tYW5kcyBhbmQgcGFyYW1ldGVycywgYW5kIGEgbWFpbGJveCB0byB0cmlnZ2VyIGEgZnVuY3Rp b24KK2NhbGwuIFRoaXMgYWxsb3dzIFNvQ3Mgd2l0aG91dCBhIHNlcGFyYXRlIG1hbmFnZW1lbnQg cHJvY2Vzc29yIChvcgord2hlbiBzdWNoIGEgcHJvY2Vzc29yIGlzIG5vdCBhdmFpbGFibGUgb3Ig dXNlZCkgdG8gdXNlIHRoaXMgc3RhbmRhcmRpemVkCitpbnRlcmZhY2UgYW55d2F5LgorCitUaGlz IGJpbmRpbmcgZGVzY3JpYmVzIG5vIGhhcmR3YXJlLCBidXQgZXN0YWJsaXNoZXMgYSBmaXJtd2Fy ZSBpbnRlcmZhY2UuCitVcG9uIHJlY2VpdmluZyBhbiBTTUMgdXNpbmcgb25lIG9mIHRoZSBkZXNj cmliZWQgU01DIGZ1bmN0aW9uIGlkZW50aWZpZXJzLAordGhlIGZpcm13YXJlIGlzIGV4cGVjdGVk IHRvIHRyaWdnZXIgc29tZSBtYWlsYm94IGNvbm5lY3RlZCBmdW5jdGlvbmFsaXR5LgorVGhlIGNv bW11bmljYXRpb24gZm9sbG93cyB0aGUgQVJNIFNNQyBjYWxsaW5nIGNvbnZlbnRpb25bMV0uCitG aXJtd2FyZSBleHBlY3RzIGFuIFNNQyBmdW5jdGlvbiBpZGVudGlmaWVyIGluIHIwIG9yIHcwLiBU aGUgc3VwcG9ydGVkCitpZGVudGlmaWVycyBhcmUgcGFzc2VkIGZyb20gY29uc3VtZXJzLCBvciBs aXN0ZWQgaW4gdGhlIHRoZSBhcm0sZnVuYy1pZHMKK3Byb3BlcnRpZXMgYXMgZGVzY3JpYmVkIGJl bG93LiBUaGUgZmlybXdhcmUgY2FuIHJldHVybiBvbmUgdmFsdWUgaW4KK3RoZSBmaXJzdCBTTUMg cmVzdWx0IHJlZ2lzdGVyLCBpdCBpcyBleHBlY3RlZCB0byBiZSBhbiBlcnJvciB2YWx1ZSwKK3do aWNoIHNoYWxsIGJlIHByb3BhZ2F0ZWQgdG8gdGhlIG1haWxib3ggY2xpZW50LgorCitBbnkgY29y ZSB3aGljaCBzdXBwb3J0cyB0aGUgU01DIG9yIEhWQyBpbnN0cnVjdGlvbiBjYW4gYmUgdXNlZCwg YXMgbG9uZyBhcworYSBmaXJtd2FyZSBjb21wb25lbnQgcnVubmluZyBpbiBFTDMgb3IgRUwyIGlz IGhhbmRsaW5nIHRoZXNlIGNhbGxzLgorCitNYWlsYm94IERldmljZSBOb2RlOgorPT09PT09PT09 PT09PT09PT09PT0KKworVGhpcyBub2RlIGlzIGV4cGVjdGVkIHRvIGJlIGEgY2hpbGQgb2YgdGhl IC9maXJtd2FyZSBub2RlLgorCitSZXF1aXJlZCBwcm9wZXJ0aWVzOgorLS0tLS0tLS0tLS0tLS0t LS0tLS0KKy0gY29tcGF0aWJsZToJCVNoYWxsIGJlICJhcm0sc21jLW1ib3giCistICNtYm94LWNl bGxzCQlTaGFsbCBiZSAxIC0gdGhlIGluZGV4IG9mIHRoZSBjaGFubmVsIG5lZWRlZC4KKy0gYXJt LG51bS1jaGFucwkJVGhlIG51bWJlciBvZiBjaGFubmVscyBzdXBwb3J0ZWQuCistIG1ldGhvZDoJ CUEgc3RyaW5nLCBlaXRoZXI6CisJCQkiaHZjIjogaWYgdGhlIGRyaXZlciBzaGFsbCB1c2UgYW4g SFZDIGNhbGwsIG9yCisJCQkic21jIjogaWYgdGhlIGRyaXZlciBzaGFsbCB1c2UgYW4gU01DIGNh bGwuCisKK09wdGlvbmFsIHByb3BlcnRpZXM6CistIGFybSxmdW5jLWlkcwkJQW4gYXJyYXkgb2Yg MzItYml0IHZhbHVlcyBzcGVjaWZ5aW5nIHRoZSBmdW5jdGlvbgorCQkJSURzIHVzZWQgYnkgZWFj aCBtYWlsYm94IGNoYW5uZWwuIFRob3NlIGZ1bmN0aW9uIElEcworCQkJZm9sbG93IHRoZSBBUk0g U01DIGNhbGxpbmcgY29udmVudGlvbiBzdGFuZGFyZCBbMV0uCisJCQlUaGVyZSBpcyBvbmUgaWRl bnRpZmllciBwZXIgY2hhbm5lbCBhbmQgdGhlIG51bWJlcgorCQkJb2Ygc3VwcG9ydGVkIGNoYW5u ZWxzIGlzIGRldGVybWluZWQgYnkgdGhlIGxlbmd0aAorCQkJb2YgdGhpcyBhcnJheS4KKworRXhh bXBsZToKKy0tLS0tLS0tCisKKwlzcmFtQDkxMDAwMCB7CisJCWNvbXBhdGlibGUgPSAibW1pby1z cmFtIjsKKwkJcmVnID0gPDB4MCAweDkzZjAwMCAweDAgMHgxMDAwPjsKKwkJI2FkZHJlc3MtY2Vs bHMgPSA8MT47CisJCSNzaXplLWNlbGxzID0gPDE+OworCQlyYW5nZXMgPSA8MCAweDAgMHg5M2Yw MDAgMHgxMDAwPjsKKworCQljcHVfc2NwX2xwcmk6IHNjcC1zaG1lbUAwIHsKKwkJCWNvbXBhdGli bGUgPSAiYXJtLHNjbWktc2htZW0iOworCQkJcmVnID0gPDB4MCAweDIwMD47CisJCX07CisKKwkJ Y3B1X3NjcF9ocHJpOiBzY3Atc2htZW1AMjAwIHsKKwkJCWNvbXBhdGlibGUgPSAiYXJtLHNjbWkt c2htZW0iOworCQkJcmVnID0gPDB4MjAwIDB4MjAwPjsKKwkJfTsKKwl9OworCisJc21jX21ib3g6 IG1haWxib3ggeworCQkjbWJveC1jZWxscyA9IDwxPjsKKwkJY29tcGF0aWJsZSA9ICJhcm0sc21j LW1ib3giOworCQltZXRob2QgPSAic21jIjsKKwkJYXJtLG51bS1jaGFucyA9IDwweDI+OworCQkv KiBPcHRpb25hbCAqLworCQlhcm0sZnVuYy1pZHMgPSA8MHhjMjAwMDBmZT4sIDwweGMyMDAwMGZm PjsKKwl9OworCisJZmlybXdhcmUgeworCQlzY21pIHsKKwkJCWNvbXBhdGlibGUgPSAiYXJtLHNj bWkiOworCQkJbWJveGVzID0gPCZtYWlsYm94IDAgJm1haWxib3ggMT47CisJCQltYm94LW5hbWVz ID0gInR4IiwgInJ4IjsKKwkJCXNobWVtID0gPCZjcHVfc2NwX2xwcmkgJmNwdV9zY3BfaHByaT47 CisJCX07CisJfTsKKworCitbMV0KK2h0dHA6Ly9pbmZvY2VudGVyLmFybS5jb20vaGVscC9pbmRl eC5qc3A/dG9waWM9L2NvbS5hcm0uZG9jLmRlbjAwMjhhL2luZGV4Lmh0bWwKLS0gCjIuMTYuNAoK