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 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id DC38DC677F1 for ; Thu, 12 Jan 2023 13:45:18 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229917AbjALNpP (ORCPT ); Thu, 12 Jan 2023 08:45:15 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45504 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230385AbjALNpH (ORCPT ); Thu, 12 Jan 2023 08:45:07 -0500 Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9C9AB48CC1; Thu, 12 Jan 2023 05:45:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1673531105; x=1705067105; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=GwtsyYXwhfZzSnYE6Nprz8+mxmQ09HgaUB4RIyDN2E0=; b=VVtlZSf53qtGtN6oKo7UnkzBW4NldOpJBEtuPVcu6a86DtslV5s6AHtp AL582fDWqH7PRLX1rxzTay2oNJf6f8Wkd/ooZaenaLtewbVXC5WoIKb+b o42vczjCMYWuMRVIvvraeG4x6IQJj8jzJpskcPgzfO5cibURdee+evuVb vxbzfpLDuKXMnTbbKVYHNxGni/Toh/5Y0KD/y/JlzqYFmN3aLEZ9a7utM yoNAY50JDovf6IkJZ/Re67OdRBViHtthHo3FRtFTsc81cerosXvSVQlyv AJzfX4fYWoDdoYDvp8gqLidZ4ONFCz7N8N1jN/FoMpLTchyAm27K0TmjS A==; X-IronPort-AV: E=McAfee;i="6500,9779,10587"; a="325728888" X-IronPort-AV: E=Sophos;i="5.97,211,1669104000"; d="scan'208";a="325728888" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 12 Jan 2023 05:45:04 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10587"; a="986557375" X-IronPort-AV: E=Sophos;i="5.97,211,1669104000"; d="scan'208";a="986557375" Received: from fmsmsx602.amr.corp.intel.com ([10.18.126.82]) by fmsmga005.fm.intel.com with ESMTP; 12 Jan 2023 05:45:04 -0800 Received: from fmsmsx611.amr.corp.intel.com (10.18.126.91) by fmsmsx602.amr.corp.intel.com (10.18.126.82) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16; Thu, 12 Jan 2023 05:45:03 -0800 Received: from fmsmsx601.amr.corp.intel.com (10.18.126.81) by fmsmsx611.amr.corp.intel.com (10.18.126.91) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16; Thu, 12 Jan 2023 05:45:03 -0800 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16 via Frontend Transport; Thu, 12 Jan 2023 05:45:03 -0800 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (104.47.58.107) by edgegateway.intel.com (192.55.55.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.16; Thu, 12 Jan 2023 05:45:03 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EhucGhfniqVJV9W5D1qpprtJ+TmV18C67WI0hP6/cidqosXnH1rKBGNrTTNUb9xgJVDghkVz9gHsnKgT77KfUcnN+lZ0/XuDQZEbtAWB0DycYC42Fr30hrYgf6o8E+RkGuLh6Ac2azQ7zdDDnuhTPdvDjtpvMIKQ7auCE3BFH57qmOVYf59uteVg5DTK3c6KjZXOZRqFu5gPisdLITelTJernGa9SRnGoWSLZkHWhL3+CBIoeuMMWZW4D72NH+Qq8+KlRtiSVlzN2vMKnDKmhVfOcGqg51XZWdKHzYOANwRtm8G0d42t7lmXbdmlWTi0ctmnLWibuoVIIW8N0WiJPw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=GwtsyYXwhfZzSnYE6Nprz8+mxmQ09HgaUB4RIyDN2E0=; b=FT3FwolRaO2WHeSvJ29KSL2GMKilc3V+qKW5XHVel/Db2ueNSM+KnsWbQ0S/Ezi+YIcAHvaFHhuZZ14l0Kn6sbZDli6nCcH0lJWEUZX6g0WQTUh58E4TupJvZ85xwKA+r5ymSC1HFm7vFvXqF6RuOmwacmNsm1iqq+jEpKIP0oR61Q96ACKErDYVRt6pxZo4ljyRkjhv19Dfx89/L1l87jjiDo+uPr9tQ3n4QRiuFie89W4BeQqcvLvj2SPeDhA67JM9DaPkAv86ZzlTuG31wplCL04yDKzKxSrqDpn/Ky1r5/6monVGCCuLWC3kYuYpVO+zibpmDfvZVIomJsoVdA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from DM6PR11MB4657.namprd11.prod.outlook.com (2603:10b6:5:2a6::7) by SA3PR11MB7528.namprd11.prod.outlook.com (2603:10b6:806:317::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5986.18; Thu, 12 Jan 2023 13:45:01 +0000 Received: from DM6PR11MB4657.namprd11.prod.outlook.com ([fe80::5006:f262:3103:f080]) by DM6PR11MB4657.namprd11.prod.outlook.com ([fe80::5006:f262:3103:f080%8]) with mapi id 15.20.6002.013; Thu, 12 Jan 2023 13:45:01 +0000 From: "Kubalewski, Arkadiusz" To: Paolo Abeni , Vadim Fedorenko , Jakub Kicinski , Jiri Pirko , "Jonathan Lemon" CC: "netdev@vger.kernel.org" , Vadim Fedorenko , "linux-arm-kernel@lists.infradead.org" , "linux-clk@vger.kernel.org" Subject: RE: [RFC PATCH v4 3/4] dpll: documentation on DPLL subsystem interface Thread-Topic: [RFC PATCH v4 3/4] dpll: documentation on DPLL subsystem interface Thread-Index: AQHZBDrykoom+kieX0a3/IkWyCaHua51C70AgCYABwA= Date: Thu, 12 Jan 2023 13:45:00 +0000 Message-ID: References: <20221129213724.10119-1-vfedorenko@novek.ru> <20221129213724.10119-4-vfedorenko@novek.ru> <60c011eb99c1859d4ee7191d4cbc20d11548f327.camel@redhat.com> In-Reply-To: <60c011eb99c1859d4ee7191d4cbc20d11548f327.camel@redhat.com> Accept-Language: pl-PL, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DM6PR11MB4657:EE_|SA3PR11MB7528:EE_ x-ms-office365-filtering-correlation-id: d705321d-3f34-4056-261e-08daf4a333a4 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: /0EcEQtdvIqoV091G/Vca6Z0sAxLMc1UYCNZ/enS2vZ61jL67IMXFdqIS6BIXKkrnimKSfmRsbSDgrFV8Bfe+sSgYY6wu3RK+4VUC4nfvtFXRaV7IA9WCdxKfPgz+tki5X81KpqfS3ZUuKNT+JWQB/sPfpD8CbqZ4UaGY7RiH6lI7i6FqpBAkjfwIa/ULwXmJYd5BDS2M/LW57Lamj8oopfe0eAsSVSn521jmLYMlEprUVVoUEkxmaCuDvFH1mGzfpKWj8l4VPe5sNo3xYOWhRtUbFgGZa5UZDSWeuCFXEr5pPmAmuWW+/x9nZzfWPWfxb9cInuo1GIlIkl0lTVzDCyRiNoTIVfZzuIV+4++L6AgSCI3k4xJGouCIIVBfRXbs67f7W/5PDFljcxT9ulAQuF/8pjsu77FQXFYIv/cZDg4Zys8GtUtKfRKlNLInU9wgBcArdEqopfxjAkxa3yBSbzODasdkmygAKsfk2d5ZUtVx/jKjzTdarL+CquqRaTWNgiY2YHo79HzpotkGEN6yvCbwA+dSjNg8e0tcXgtVj03G68NO0yIhqAj0oLa00cSWF++3t1JLLDb6KFJJ4nQ4gQPuKQiS1ivljVeFTeBI3PWMjqbm/U+Kq0cvGKrhUVXvYrgbQgOcJs5i1w3qEpUGdS2gcV8BWbpoWfacTLLHMTXppUkvdc4P4jpxLL1tqMQdT10FebJBopry6Bd798AKw== x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR11MB4657.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(39860400002)(396003)(376002)(136003)(346002)(366004)(451199015)(122000001)(82960400001)(38100700002)(33656002)(38070700005)(86362001)(83380400001)(54906003)(8676002)(41300700001)(66476007)(110136005)(66556008)(66446008)(66946007)(4326008)(76116006)(2906002)(478600001)(7696005)(55016003)(5660300002)(316002)(8936002)(52536014)(9686003)(6506007)(186003)(26005)(71200400001)(64756008)(4001150100001);DIR:OUT;SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?B?UnBoaUxtSDdveEw5SFBCMStQNlVYWGdxbWtsYWFnbFY0NThlby9BMDdnNm90?= =?utf-8?B?Mk00Z0JpM2l0a1p2TFZDbTE4YWFhUE90Ynp1ZFNEd3lvckpuVmJuSmlmaGMw?= =?utf-8?B?VzlmSzB4b1hJNHBGSnE0QUZxb2F1QmlQbm44UC94WUdpcmdrZ21ESUJHdnBS?= =?utf-8?B?bTR4TXNqVlk4NVBjN0lTMWpXN2JHc1FKYnRRTmd0ekZheUNMYmxCQUlNVVhy?= =?utf-8?B?cVgxZzlaT0RHUHhyR2paM3BZU2EyYnRSTTJ0cFRnSC83UG4rVk4xRzVEV2Q3?= =?utf-8?B?ZHkyc0N5ODlWbGdXY2VZMlVtK0lqSlJoR0xGZkN2eSs1YnVXV3NhMGRVYm5E?= =?utf-8?B?bGE4QjR1cWFtQ1NWZjZ3TDlYK3pWTW90bVpkM25vQXpRUnY5bVdHbFczRVdD?= =?utf-8?B?MGsvR2xza2RWaGFhQ2NZUXNRWVRxc1J0eXFWbHhwUVdSSW42Q3M2TVZ4cXB3?= =?utf-8?B?U0Y3R2NHZEdZeTdzclFmRHY2OTU1b3I4cXFMV2ZLOHI3elJaV3d5ejFLUy9u?= =?utf-8?B?SS9PVnlZYmM4Qk5JT29hUkNtaE9EbXBrVllYc3JHcGdPME9FWG54Z3JrT1J4?= =?utf-8?B?WExncDQzSGxoVGFteWNSL2hHQVNJenk1VFM3VW1xNHJJVEZmSTBhUTVPYS93?= =?utf-8?B?Zit2S05YQ1JTNmxmdG5vcktoY1N1a1JrdEhPM2hPby9wZC8zN2Nzc1c2Ymtr?= =?utf-8?B?MXJqbnpYS2QvU2p0QlY1YzBINHFLcXovUnM5RDhNb2xOcktiVmkvNDJhMlps?= =?utf-8?B?Ym5UMXRPMmQ0MlhrOVQ1MUZ3aGx2UE5vMXUwK2tyQUQ3S2ZaNFZGaVQxZ0c1?= =?utf-8?B?SjJOcmQ5Z2R2SFVlTGNrZUREM2JKdTVrbDF3aDBZeFRhbFQvTjhLYjdQZXJL?= =?utf-8?B?NkFCak9RMnN5eFIrd3lsSUlYT1M2b3VBUEVVVTM1UFZQYytyUW5nYzdTQ1d4?= =?utf-8?B?Ulhqa3l3YjBaUUxHQnRSUXRtbFRpOEt3SGV6RDJ4MVVMbVRkaHZZTXdsZUl6?= =?utf-8?B?UXphc002TlVtVlAwTEtDKzFLVnVNOXdmM1lHRGhHeERseFEwS2FVTFVkdDNE?= =?utf-8?B?Ni9BYmttbGpwd09FRjlyazVqMno0WmVOQUUveTdCSzN6TVVjSVpUSzEyc0Jn?= =?utf-8?B?UDNRT3ZRSDdnaVJ2bnNibjRQOEszUFU5d0tKbWFXV0FuMjVNVlBuTW00UnA3?= =?utf-8?B?UlYvRlBaSk9idHJ5bnlickM4elBpTncvRjBsMExkUGNuYUN3Q2MyN3B6Rjhz?= =?utf-8?B?YUcrZ2tjOWxhMW1YM1VrcG10a1NLcnk5OWY3bzF6Q1F2SjA1SWN3WVFzQVlv?= =?utf-8?B?eUp0bm9GN0wyMFhEdnkzcVpmUThLNTRJbGZNa3ZWZDhwL0JZcmdJQW5nTllN?= =?utf-8?B?bFpGeG5BQTJpRG1OMTIrcUZja0plb1M2L0FDWVNYRXdEYjhSc1MyQTJUelJa?= =?utf-8?B?M0ZVdm10bVNXM0cwT2FqL0Q4eUY4RnovZUF1SGdYc1Ezam11czZLTTZ2UUI0?= =?utf-8?B?T0o0VkhKMU00TU0rSnUrRjNxeUhYZ2p4Zjh0SFFmUk5uNGdPazB2cGxFanZu?= =?utf-8?B?QURNRjBGNmdtVUwvYmZYOHoxRTJSV3pNeUNTdTg0eDM0eXI3bGRGV2hmdlQw?= =?utf-8?B?dDVWenZ3MWpYU0Jldm9NbVB0WkhlVWdPd0dneXQ1QlQ4Zm5qbFhMR3RsdG9m?= =?utf-8?B?dUpVN3JRKzB3ODFRQ3ZMa2dEbnBjang4K1NtRWF4dVVBQVB2bEg2NVk4NDlu?= =?utf-8?B?NUlkT3ZhNVA5V1J0MnpqN3BwTGRVZDRpYXAyeXIweVNWVWloRDdDYlRyWGVa?= =?utf-8?B?TVFkd1RrbEE4ZFNxK2YyOVhRWnY3cDhGWHRtL1lXNi9hQTdwdlNERkNKTzdp?= =?utf-8?B?dm5jYW93SFR1dE9Uem5aTUV2N3VOYzRTQnlBQ0hyMjM0cE5mTjVmbnIwK2FR?= =?utf-8?B?a1lGM3llallqZXU5dG1ndEFQN0kvTW5TY0xabVQzYzFHek1NT3JLem9UcDlV?= =?utf-8?B?SWVxbGN4aktGc25KUVl3NzA2eG12NFFnS0Vrdlc1bGRCVkJOa0hESHNacmNj?= =?utf-8?B?OGRDY1R1Ujcxd1VsTUV4VnJoTVIxdjlKNXk0VDVBRkpmV1lhbHRJemhlZ3N5?= =?utf-8?B?cld5NW8vTlB0VXlJUXQya0hCNm1BM2g4RVMxZll3QzhSbkxmWXROKzF1Vi9K?= =?utf-8?B?WkE9PQ==?= Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM6PR11MB4657.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: d705321d-3f34-4056-261e-08daf4a333a4 X-MS-Exchange-CrossTenant-originalarrivaltime: 12 Jan 2023 13:45:00.8963 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: s1xLwIKPgbNtpL26jSVK3X/cK6drez0sjlr1LuYA1MKcbeX1DDklViZdALFu6DKqAlMZP5B+N524wcMj5JhIdoSar4+iSPkSwV+F1/OEHZk= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA3PR11MB7528 X-OriginatorOrg: intel.com Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org PkZyb206IFBhb2xvIEFiZW5pIDxwYWJlbmlAcmVkaGF0LmNvbT4NCj5TZW50OiBNb25kYXksIERl Y2VtYmVyIDE5LCAyMDIyIDEwOjEzIEFNDQo+DQo+SGVsbG8sDQo+DQo+SSBoYXZlIGEganVzdCBh IGZldyBtaW5vciBub3RlcyBXUlQgdGhlIGRvY3VtZW50YXRpb24gLSB3aGljaCB3YXMgYQ0KPnZl cnkgdXNlZnVsIGVudHJ5IHBvaW50IGZvciBtZSB0byBoZWxwIHVuZGVyc3RhbmRpbmcgdGhlIHN1 YnN5c3RlbS4NCg0KSGkgUGFvbG8sIG1hbnkgdGhhbmtzIGZvciB5b3VyIGZlZWRiYWNrIQ0KDQo+ DQo+T24gV2VkLCAyMDIyLTExLTMwIGF0IDAwOjM3ICswMzAwLCBWYWRpbSBGZWRvcmVua28gd3Jv dGU6DQo+PiBGcm9tOiBWYWRpbSBGZWRvcmVua28gPHZhZGZlZEBmYi5jb20+DQo+Pg0KPj4gQWRk IGRvY3VtZW50YXRpb24gZXhwbGFpbmluZyBjb21tb24gbmV0bGluayBpbnRlcmZhY2UgdG8gY29u ZmlndXJlIERQTEwNCj4+IGRldmljZXMgYW5kIG1vbml0b3JpbmcgZXZlbnRzLiBDb21tb24gd2F5 IHRvIGltcGxlbWVudCBEUExMIGRldmljZSBpbg0KPj4gYSBkcml2ZXIgaXMgYWxzbyBjb3ZlcmVk Lg0KPj4NCj4+IENvLWRldmVsb3BlZC1ieTogQXJrYWRpdXN6IEt1YmFsZXdza2kgPGFya2FkaXVz ei5rdWJhbGV3c2tpQGludGVsLmNvbT4NCj4+IFNpZ25lZC1vZmYtYnk6IEFya2FkaXVzeiBLdWJh bGV3c2tpIDxhcmthZGl1c3oua3ViYWxld3NraUBpbnRlbC5jb20+DQo+PiBTaWduZWQtb2ZmLWJ5 OiBWYWRpbSBGZWRvcmVua28gPHZhZGZlZEBmYi5jb20+DQo+PiAtLS0NCj4+ICBEb2N1bWVudGF0 aW9uL25ldHdvcmtpbmcvZHBsbC5yc3QgIHwgMjcxICsrKysrKysrKysrKysrKysrKysrKysrKysr KysrDQo+PiAgRG9jdW1lbnRhdGlvbi9uZXR3b3JraW5nL2luZGV4LnJzdCB8ICAgMSArDQo+PiAg MiBmaWxlcyBjaGFuZ2VkLCAyNzIgaW5zZXJ0aW9ucygrKQ0KPj4gIGNyZWF0ZSBtb2RlIDEwMDY0 NCBEb2N1bWVudGF0aW9uL25ldHdvcmtpbmcvZHBsbC5yc3QNCj4+DQo+PiBkaWZmIC0tZ2l0IGEv RG9jdW1lbnRhdGlvbi9uZXR3b3JraW5nL2RwbGwucnN0DQo+Yi9Eb2N1bWVudGF0aW9uL25ldHdv cmtpbmcvZHBsbC5yc3QNCj4+IG5ldyBmaWxlIG1vZGUgMTAwNjQ0DQo+PiBpbmRleCAwMDAwMDAw MDAwMDAuLjU4NDAxZTJiNzBhNw0KPj4gLS0tIC9kZXYvbnVsbA0KPj4gKysrIGIvRG9jdW1lbnRh dGlvbi9uZXR3b3JraW5nL2RwbGwucnN0DQo+PiBAQCAtMCwwICsxLDI3MSBAQA0KPj4gKy4uIFNQ RFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wDQo+PiArDQo+PiArPT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PQ0KPj4gK1RoZSBMaW51eCBrZXJuZWwgRFBMTCBzdWJzeXN0ZW0NCj4+ ICs9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQo+PiArDQo+PiArDQo+PiArVGhlIG1h aW4gcHVycG9zZSBvZiBEUExMIHN1YnN5c3RlbSBpcyB0byBwcm92aWRlIGdlbmVyYWwgaW50ZXJm YWNlDQo+PiArdG8gY29uZmlndXJlIGRldmljZXMgdGhhdCB1c2UgYW55IGtpbmQgb2YgRGlnaXRh bCBQTEwgYW5kIGNvdWxkIHVzZQ0KPj4gK2RpZmZlcmVudCBzb3VyY2VzIG9mIHNpZ25hbCB0byBz eW5jaHJvbml6ZSB0byBhcyB3ZWxsIGFzIGRpZmZlcmVudA0KPj4gK3R5cGVzIG9mIG91dHB1dHMu DQo+PiArVGhlIG1haW4gaW50ZXJmYWNlIGlzIE5FVExJTktfR0VORVJJQyBiYXNlZCBwcm90b2Nv bCB3aXRoIGFuIGV2ZW50DQo+PiArbW9uaXRvcmluZyBtdWx0aWNhc3QgZ3JvdXAgZGVmaW5lZC4N Cj4+ICsNCj4+ICsNCj4+ICtQaW4gb2JqZWN0DQo+PiArPT09PT09PT09PQ0KPj4gK0EgcGluIGlz IGFtb3JwaGljIG9iamVjdCB3aGljaCByZXByZXNlbnRzIGVpdGhlciBpbnB1dCBhbmQgb3V0cHV0 LCBpdA0KPj4gK2NvdWxkIGJlIGludGVybmFsIGNvbXBvbmVudCBvZiB0aGUgZGV2aWNlLCBhcyB3 ZWxsIGFzIGV4dGVybmFseQ0KPj4gK2Nvbm5lY3RlZC4NCj4+ICtUaGUgbnVtYmVyIG9mIHBpbnMg cGVyIGRwbGwgdmFyeSwgYnV0IHVzdWFsbHkgbXVsdGlwbGUgcGlucyBzaGFsbCBiZQ0KPj4gK3By b3ZpZGVkIGZvciBhIHNpbmdsZSBkcGxsIGRldmljZS4NCj4+ICtEaXJlY3Rpb24gb2YgYSBwaW4g YW5kIGl0J3MgY2FwYWJpbGl0aWVzIGFyZSBwcm92aWRlZCB0byB0aGUgdXNlciBpbg0KPj4gK3Jl c3BvbnNlIGZvciBuZXRsaW5rIGR1bXAgcmVxdWVzdCBtZXNzYWdlcy4NCj4+ICtQaW4gY2FuIGJl IHNoYXJlZCBieSBtdWx0aXBsZSBkcGxsIGRldmljZXMuIFdoZXJlIGNvbmZpZ3VyYXRpb24gb24g b25lDQo+PiArcGluIGNhbiBhbHRlciBtdWx0aXBsZSBkcGxscyAoaS5lLiBEUExMX1BJTl9TR0lO QUxfVFlQRSwgRFBMTF9QSU5fVFlQRSwNCj4NCj5MaWtlbHkgdHlwbyBhYm92ZTogRFBMTF9QSU5f U0lHTkFMX1RZUEUNCg0KVHJ1ZSwgc2hhbGwgYmUgZml4ZWQgaW4gbmV4dCB2ZXJzaW9uLg0KDQo+ DQo+PiArRFBMTF9QSU5fU1RBVEUpLCBvciBqdXN0IG9uZSBwaW4tZHBsbCBwYWlyIChpLmUuIERQ TExfUElOX1BSSU8pLg0KPj4gK1BpbiBjYW4gYmUgYWxzbyBhIE1VWCB0eXBlLCB3aGVyZSBvbmUg b3IgbW9yZSBwaW5zIGFyZSBhdHRhY2hlZCB0bw0KPj4gK2EgcGFyZW50IHBpbi4gVGhlIHBhcmVu dCBwaW4gaXMgdGhlIG9uZSBkaXJlY3RseSBjb25uZWN0ZWQgdG8gdGhlIGRwbGwsDQo+PiArd2hp Y2ggbWF5IGJlIHVzZWQgYnkgZHBsbHMgaW4gRFBMTF9NT0RFX0FVVE9NQVRJQyBzZWxlY3Rpb24g bW9kZSwgd2hlcmUNCj4+ICtvbmx5IHBpbnMgZGlyZWN0bHkgY29ubmVjdGVkIHRvIHRoZSBkcGxs IGFyZSBjYXBhYmxlIG9mIGF1dG9tYXRpYw0KPj4gK3NvdXJjZSBwaW4gc2VsZWN0aW9uLiBJbiBz dWNoIGNhc2UsIHBpbnMgYXJlIGR1bXBlZCB3aXRoDQo+PiArRFBMTEFfUElOX1BBUkVOVF9JRFgs IGFuZCBhcmUgYWJsZSB0byBiZSBzZWxlY3RlZCBieSB0aGUgdXNlcnNwYWNlIHdpdGgNCj4+ICtu ZXRsaW5rIHJlcXVlc3QuDQo+PiArDQo+PiArQ29uZmlndXJhdGlvbiBjb21tYW5kcyBncm91cA0K Pj4gKz09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCj4+ICsNCj4+ICtDb25maWd1cmF0aW9u IGNvbW1hbmRzIGFyZSB1c2VkIHRvIGdldCBvciBkdW1wIGluZm9ybWF0aW9uIGFib3V0DQo+PiAr cmVnaXN0ZXJlZCBEUExMIGRldmljZXMgKGFuZCBwaW5zKSwgYXMgd2VsbCBhcyBzZXQgY29uZmln dXJhdGlvbiBvZg0KPj4gK2RldmljZSBvciBwaW5zLiBBcyBEUExMIGRldmljZSBjb3VsZCBub3Qg YmUgYWJzdHJhY3QgYW5kIHJlZmxlY3RzIHJlYWwNCj4+ICtoYXJkd2FyZSwgdGhlcmUgaXMgbm8g d2F5IHRvIGFkZCBuZXcgRFBMTCBkZXZpY2UgdmlhIG5ldGxpbmsgZnJvbSB1c2VyDQo+PiArc3Bh Y2UgYW5kIGVhY2ggZGV2aWNlIHNob3VsZCBiZSByZWdpc3RlcmVkIGJ5IGl0J3MgZHJpdmVyLg0K Pg0KPlNpZGUgbm90ZTogaW4gdGhlIGxvbmcgcnVuIHdlIGNvdWxkIGVuZC11cCB3aXRoIGEgdmly dHVhbC9kdW1teSBkcGxsDQo+ZHJpdmVyIGZvciBzZWxmLXRlc3RzIGFuZC9vciByZWZlcmVuY2Un cyBpbXBsZW1lbnRhdGlvbiBzYWtlLg0KPg0KDQpUcnVlLCBzZWVtcyBhIGdvb2QgaWRlYS4NCg0K Pj4gKw0KPj4gK0xpc3Qgb2YgY29tbWFuZCB3aXRoIHBvc3NpYmxlIGF0dHJpYnV0ZXMNCj4+ICs9 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQo+PiArDQo+PiArQWxsIGNv bnN0YW50cyBpZGVudGlmeWluZyBjb21tYW5kIHR5cGVzIHVzZSBgYERQTExfQ01EX2BgIHByZWZp eCBhbmQNCj4+ICtzdWZmaXggYWNjb3JkaW5nIHRvIGNvbW1hbmQgcHVycG9zZS4gQWxsIGF0dHJp YnV0ZXMgdXNlIGBgRFBMTEFfYGANCj4+ICtwcmVmaXggYW5kIHN1ZmZpeCBhY2NvcmRpbmcgdG8g YXR0cmlidXRlIHB1cnBvc2U6DQo+PiArDQo+PiArICA9PT09PT09PT09PT09PT09PT09PT09PT09 PT09ICA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCj4+ICsgIGBgREVW SUNFX0dFVGBgICAgICAgICAgICAgICAgIHVzZXJzcGFjZSB0byBnZXQgZGV2aWNlIGluZm8NCj4+ ICsgICAgYGBJRGBgICAgICAgICAgICAgICAgICAgICAgIGF0dHIgaW50ZXJuYWwgZHBsbCBkZXZp Y2UgaW5kZXgNCj4+ICsgICAgYGBOQU1FYGAgICAgICAgICAgICAgICAgICAgIGF0dHIgZHBsbCBk ZXZpY2UgbmFtZQ0KPj4gKyAgICBgYE1PREVgYCAgICAgICAgICAgICAgICAgICAgYXR0ciBzZWxl Y3Rpb24gbW9kZQ0KPj4gKyAgICBgYE1PREVfU1VQUE9SVEVEYGAgICAgICAgICAgYXR0ciBhdmFp bGFibGUgc2VsZWN0aW9uIG1vZGVzDQo+PiArICAgIGBgU09VUkNFX1BJTl9JRFhgYCAgICAgICAg ICBhdHRyIGluZGV4IG9mIGN1cnJlbnRseSBzZWxlY3RlZCBzb3VyY2UNCj4+ICsgICAgYGBMT0NL X1NUQVRVU2BgICAgICAgICAgICAgIGF0dHIgaW50ZXJuYWwgZnJlcXVlbmN5LWxvY2sgc3RhdHVz DQo+PiArICAgIGBgVEVNUGBgICAgICAgICAgICAgICAgICAgICBhdHRyIGRldmljZSB0ZW1wZXJh dHVyZSBpbmZvcm1hdGlvbg0KPj4gKyAgICBgYE5FVElGSU5ERVhgYCAgICAgICAgICAgICAgYXR0 ciBkcGxsIG93bmVyIExpbnV4IG5ldGRldmljZSBpbmRleA0KPg0KPnNob3VsZCB3ZSBpbmNsdWRl IGFsc28gdGhlIGNvb2tpZSAob3Igd3VoYXRldmVyIHdpbGwgYmUgdXNlZCBmb3INCj5wZXJzaXN0 ZW50IGRldmljZSBpZGVudGlmaWNhdGlvbikgaW50byB0aGUgcmVhZGFibGUgYXR0cmlidXRlcyBs aXN0Pw0KPg0KDQpJbiBuZXh0IHZlcnNpb24gY29va2llIGlzIHJlcGxhY2VkIHdpdGggY2xvY2tf aWQgYW5kIHdpbGwgYmUgYWxzbyBhdmFpbGFibGUNCmZvciB0aGUgdXNlcnNwYWNlLg0KDQo+PiAr ICBgYERFVklDRV9TRVRgYCAgICAgICAgICAgICAgICB1c2Vyc3BhY2UgdG8gc2V0IGRwbGwgZGV2 aWNlDQo+PiArICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBjb25maWd1cmF0aW9uDQo+ PiArICAgIGBgSURgYCAgICAgICAgICAgICAgICAgICAgICBhdHRyIGludGVybmFsIGRwbGwgZGV2 aWNlIGluZGV4DQo+PiArICAgIGBgTU9ERWBgICAgICAgICAgICAgICAgICAgICBhdHRyIHNlbGVj dGlvbiBtb2RlIHRvIGNvbmZpZ3VyZQ0KPj4gKyAgICBgYFBJTl9JRFhgYCAgICAgICAgICAgICAg ICAgYXR0ciBpbmRleCBvZiBzb3VyY2UgcGluIHRvIHNlbGVjdCBhcw0KPj4gKyAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgYWN0aXZlIHNvdXJjZQ0KPg0KPkl0IGxvb2tzIGxpa2UgdGhl IGRlc2NyaXRpb24gZm9yIHRoZSBhYm92ZSBhdHRyaWJ1dGUgKCdQSU5fSURYJykgYW5kDQo+J1NP VVJDRV9QSU5fSURYJyBoYXMgYmVlbiBzd2FwcGVkLg0KDQpHb29kIGNhdGNoLCBmb3IgYGBERVZJ Q0VfU0VUYGAgY29tbWFuZCwgcHJvcGVyIGF0dHJpYnV0ZSBpcyAnU09VUkNFX1BJTl9JRFgnLA0K d2lsbCBmaXggdGhhdC4NCg0KPg0KPj4gKyAgYGBQSU5fU0VUYGAgICAgICAgICAgICAgICAgICAg dXNlcnNwYWNlIHRvIHNldCBwaW5zIGNvbmZpZ3VyYXRpb24NCj4+ICsgICAgYGBJRGBgICAgICAg ICAgICAgICAgICAgICAgIGF0dHIgaW50ZXJuYWwgZHBsbCBkZXZpY2UgaW5kZXgNCj4+ICsgICAg YGBQSU5fSURYYGAgICAgICAgICAgICAgICAgIGF0dHIgaW5kZXggb2YgYSBwaW4gdG8gY29uZmln dXJlDQo+PiArICAgIGBgUElOX1RZUEVgYCAgICAgICAgICAgICAgICBhdHRyIHR5cGUgY29uZmln dXJhdGlvbiB2YWx1ZSBmb3INCj4+ICsgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHNl bGVjdGVkIHBpbg0KPj4gKyAgICBgYFBJTl9TSUdOQUxfVFlQRWBgICAgICAgICAgYXR0ciBzaWdu YWwgdHlwZSBjb25maWd1cmF0aW9uIHZhbHVlDQo+PiArICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICBmb3Igc2VsZWN0ZWQgcGluDQo+PiArICAgIGBgUElOX0NVU1RPTV9GUkVRYGAgICAg ICAgICBhdHRyIHNpZ25hbCBjdXN0b20gZnJlcXVlbmN5IHRvIGJlIHNldA0KPj4gKyAgICBgYFBJ Tl9TVEFURWBgICAgICAgICAgICAgICAgYXR0ciBwaW4gc3RhdGUgdG8gYmUgc2V0DQo+PiArICAg IGBgUElOX1BSSU9gYCAgICAgICAgICAgICAgICBhdHRyIHBpbiBwcmlvcml0eSB0byBiZSBzZXQN Cj4+ICsNCj4+ICtOZXRsaW5rIGR1bXAgcmVxdWVzdHMNCj4+ICs9PT09PT09PT09PT09PT09PT09 PT0NCj4+ICtUaGUgYGBERVZJQ0VfR0VUYGAgY29tbWFuZCBpcyBjYXBhYmxlIG9mIGR1bXAgdHlw ZSBuZXRsaW5rIHJlcXVlc3RzLg0KPj4gK0luIHN1Y2ggY2FzZSB0aGUgdXNlcnNwYWNlIHNoYWxs IHByb3ZpZGUgYGBEVU1QX0ZJTFRFUmBgIGF0dHJpYnV0ZQ0KPj4gK3ZhbHVlIHRvIGZpbHRlciB0 aGUgcmVzcG9uc2UgYXMgcmVxdWlyZWQuDQo+PiArSWYgZmlsdGVyIGlzIG5vdCBwcm92aWRlZCBv bmx5IG5hbWUgYW5kIGlkIG9mIGF2YWlsYWJsZSBkcGxsKHMpIGlzDQo+PiArcHJvdmlkZWQuIElm IHRoZSByZXF1ZXN0IGFsc28gY29udGFpbnMgYGBJRGBgIGF0dHJpYnV0ZSwgb25seSBzZWxlY3Rl ZA0KPj4gK2RwbGwgZGV2aWNlIHNoYWxsIGJlIGR1bXBlZC4NCj4NCj5TaG91bGQgd2UgZXhwbGlj aXRseSBkb2N1bWVudCBldmVuIHRoZSByZXF1aXJlZCBwZXJtaXNzaW9ucz8NCg0KU3VyZSwgZ29p bmcgdG8gYWRkIGEgd29yZCBhYm91dCByZXF1aXJlZCBuZXRsaW5rIHBlcm1pc3Npb24uDQoNCj4N Cj4+ICsNCj4+ICtQb3NzaWJsZSByZXNwb25zZSBtZXNzYWdlIGF0dHJpYnV0ZXMgZm9yIG5ldGxp bmsgcmVxdWVzdHMgZGVwZW5kaW5nIG9uDQo+PiArdGhlIHZhbHVlIG9mIGBgRFBMTEFfRFVNUF9G SUxURVJgYCBhdHRyaWJ1dGU6DQo+PiArDQo+PiArICA9PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09ID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KPj4gKyAgYGBEUExM X0RVTVBfRklMVEVSX1BJTlNgYCAgICAgICB2YWx1ZSBvZiBgYERVTVBfRklMVEVSYGAgYXR0cmli dXRlDQo+PiArICAgIGBgUElOYGAgICAgICAgICAgICAgICAgICAgICAgIGF0dHIgbmVzdGVkIHR5 cGUgY29udGFpbiBzaW5nbGUgcGluDQo+PiArICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgIGF0dHJpYnV0ZXMNCj4+ICsgICAgYGBQSU5fSURYYGAgICAgICAgICAgICAgICAgICAgYXR0 ciBpbmRleCBvZiBkdW1wZWQgcGluDQo+PiArICAgIGBgUElOX0RFU0NSSVBUSU9OYGAgICAgICAg ICAgIGRlc2NyaXB0aW9uIG9mIGEgcGluIHByb3ZpZGVkIGJ5DQo+PiArICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgIGRyaXZlcg0KPj4gKyAgICBgYFBJTl9UWVBFYGAgICAgICAgICAg ICAgICAgICBhdHRyIHZhbHVlIG9mIHBpbiB0eXBlDQo+PiArICAgIGBgUElOX1RZUEVfU1VQUE9S VEVEYGAgICAgICAgIGF0dHIgdmFsdWUgb2Ygc3VwcG9ydGVkIHBpbiB0eXBlDQo+PiArICAgIGBg UElOX1NJR05BTF9UWVBFYGAgICAgICAgICAgIGF0dHIgdmFsdWUgb2YgcGluIHNpZ25hbCB0eXBl DQo+PiArICAgIGBgUElOX1NJR05BTF9UWVBFX1NVUFBPUlRFRGBgIGF0dHIgdmFsdWUgb2Ygc3Vw cG9ydGVkIHBpbiBzaWduYWwNCj4+ICsgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg dHlwZQ0KPj4gKyAgICBgYFBJTl9DVVNUT01fRlJFUWBgICAgICAgICAgICBhdHRyIHZhbHVlIG9m IHBpbiBjdXN0b20gZnJlcXVlbmN5DQo+PiArICAgIGBgUElOX1NUQVRFYGAgICAgICAgICAgICAg ICAgIGF0dHIgdmFsdWUgb2YgcGluIHN0YXRlDQo+PiArICAgIGBgUElOX1NUQVRFX1NVUFBPUlRF RGBgICAgICAgIGF0dHIgdmFsdWUgb2Ygc3VwcG9ydGVkIHBpbiBzdGF0ZQ0KPj4gKyAgICBgYFBJ Tl9QUklPYGAgICAgICAgICAgICAgICAgICBhdHRyIHZhbHVlIG9mIHBpbiBwcmlvDQo+PiArICAg IGBgUElOX1BBUkVOVF9JRFhgYCAgICAgICAgICAgIGF0dHIgdmFsdWUgb2YgcGluIHBhdGVudCBp bmRleA0KPj4gKyAgICBgYFBJTl9ORVRJRklOREVYYGAgICAgICAgICAgICBhdHRyIHZhbHVlIG9m IG5ldGRldmljZSBhc3NvY2FpYXRlZA0KPj4gKyAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICB3aXRoIHRoZSBwaW4NCj4+ICsgIGBgRFBMTF9EVU1QX0ZJTFRFUl9TVEFUVVNgYCAgICAg dmFsdWUgb2YgYGBEVU1QX0ZJTFRFUmBgIGF0dHJpYnV0ZQ0KPj4gKyAgICBgYElEYGAgICAgICAg ICAgICAgICAgICAgICAgICBhdHRyIGludGVybmFsIGRwbGwgZGV2aWNlIGluZGV4DQo+PiArICAg IGBgTkFNRWBgICAgICAgICAgICAgICAgICAgICAgIGF0dHIgZHBsbCBkZXZpY2UgbmFtZQ0KPj4g KyAgICBgYE1PREVgYCAgICAgICAgICAgICAgICAgICAgICBhdHRyIHNlbGVjdGlvbiBtb2RlDQo+ PiArICAgIGBgTU9ERV9TVVBQT1JURURgYCAgICAgICAgICAgIGF0dHIgYXZhaWxhYmxlIHNlbGVj dGlvbiBtb2Rlcw0KPj4gKyAgICBgYFNPVVJDRV9QSU5fSURYYGAgICAgICAgICAgICBhdHRyIGlu ZGV4IG9mIGN1cnJlbnRseSBzZWxlY3RlZA0KPj4gKyAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICBzb3VyY2UNCj4+ICsgICAgYGBMT0NLX1NUQVRVU2BgICAgICAgICAgICAgICAgYXR0 ciBpbnRlcm5hbCBmcmVxdWVuY3ktbG9jayBzdGF0dXMNCj4+ICsgICAgYGBURU1QYGAgICAgICAg ICAgICAgICAgICAgICAgYXR0ciBkZXZpY2UgdGVtcGVyYXR1cmUgaW5mb3JtYXRpb24NCj4+ICsg ICAgYGBORVRJRklOREVYYGAgICAgICAgICAgICAgICAgYXR0ciBkcGxsIG93bmVyIExpbnV4IG5l dGRldmljZSBpbmRleA0KPj4gKw0KPj4gKw0KPj4gK1RoZSBwcmUtZGVmaW5lZCBlbnVtcw0KPj4g Kz09PT09PT09PT09PT09PT09PT09PQ0KPj4gKw0KPj4gK0FsbCB0aGUgZW51bXMgdXNlIHRoZSBg YERQTExfYGAgcHJlZml4Lg0KPj4gKw0KPj4gK1ZhbHVlcyBmb3IgYGBQSU5fVFlQRWBgIGFuZCBg YFBJTl9UWVBFX1NVUFBPUlRFRGBgIGF0dHJpYnV0ZXM6DQo+PiArDQo+PiArICA9PT09PT09PT09 PT09PT09PT09PT09PT09PT09ID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT0NCj4+ICsgIGBgUElOX1RZUEVfTVVYYGAgICAgICAgICAgICAgTVVYIHR5cGUgcGluLCBjb25u ZWN0ZWQgcGlucyBzaGFsbA0KPj4gKyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBoYXZl IHRoZWlyIG93biB0eXBlcw0KPj4gKyAgYGBQSU5fVFlQRV9FWFRgYCAgICAgICAgICAgICBFeHRl cm5hbCBwaW4NCj4+ICsgIGBgUElOX1RZUEVfU1lOQ0VfRVRIX1BPUlRgYCAgU3luY0Ugb24gRXRo ZXJuZXQgcG9ydA0KPj4gKyAgYGBQSU5fVFlQRV9JTlRfT1NDSUxMQVRPUmBgICBJbnRlcm5hbCBP c2NpbGxhdG9yIChpLmUuIEhvbGRvdmVyDQo+PiArICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgIHdpdGggQXRvbWljIENsb2NrIGFzIGEgU291cmNlKQ0KPj4gKyAgYGBQSU5fVFlQRV9HTlNT YGAgICAgICAgICAgICBHTlNTIDFQUFMgc291cmNlDQo+PiArDQo+PiArVmFsdWVzIGZvciBgYFBJ Tl9TSUdOQUxfVFlQRWBgIGFuZCBgYFBJTl9TSUdOQUxfVFlQRV9TVVBQT1JURURgYA0KPj4gK2F0 dHJpYnV0ZXM6DQo+PiArDQo+PiArICA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09ICA9 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KPj4gKyAgYGBQSU5fU0lHTkFMX1RZ UEVfMV9QUFNgYCAgICAgICAgMSBIeiBmcmVxdWVuY3kNCj4+ICsgIGBgUElOX1NJR05BTF9UWVBF XzEwX01IWmBgICAgICAgIDEwIE1IeiBmcmVxdWVuY3kNCj4+ICsgIGBgUElOX1NJR05BTF9UWVBF X0NVU1RPTV9GUkVRYGAgIEZyZXF1ZW5jeSB2YWx1ZSBwcm92aWRlZCBpbiBhdHRyDQo+PiArICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBgYFBJTl9DVVNUT01fRlJFUWBgDQo+PiAr DQo+PiArVmFsdWVzIGZvciBgYExPQ0tfU1RBVFVTYGAgYXR0cmlidXRlOg0KPj4gKw0KPj4gKyAg PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0gPT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT0NCj4+ICsgIGBgTE9DS19TVEFUVVNfVU5MT0NLRURgYCAgICAgIERQTEwgaXMg aW4gZnJlZXJ1biwgbm90IGxvY2tlZCB0byBhbnkNCj4+ICsgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgIHNvdXJjZSBwaW4NCj4+ICsgIGBgTE9DS19TVEFUVVNfQ0FMSUJSQVRJTkdgYCAg IERQTEwgZGV2aWNlIGNhbGlicmF0ZXMgdG8gbG9jayB0byB0aGUNCj4+ICsgICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgIHNvdXJjZSBwaW4gc2lnbmFsDQo+PiArICBgYExPQ0tfU1RBVFVT X0xPQ0tFRGBgICAgICAgICBEUExMIGRldmljZSBpcyBsb2NrZWQgdG8gdGhlIHNvdXJjZQ0KPj4g KyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgcGluIGZyZXF1ZW5jeQ0KPj4gKyAgYGBM T0NLX1NUQVRVU19IT0xET1ZFUmBgICAgICAgRFBMTCBkZXZpY2UgbG9zdCBhIGxvY2ssIHVzaW5n IGl0cw0KPj4gKyAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgZnJlcXVlbmN5IGhvbGRv dmVyIGNhcGFiaWxpdGllcw0KPj4gKw0KPj4gK1ZhbHVlcyBmb3IgYGBQSU5fU1RBVEVgYCBhbmQg YGBQSU5fU1RBVEVfU1VQUE9SVEVEYGAgYXR0cmlidXRlczoNCj4+ICsNCj4+ICs9PT09PT09PT09 PT09PT09PT09PT09PT09PT09PSA9PT09PT09PT09PT09PT09PT09PT09PT09PT09DQo+PiArICBg YFBJTl9TVEFURV9DT05ORUNURURgYCAgICAgUGluIGNvbm5lY3RlZCB0byBhIGRwbGwNCj4+ICsg IGBgUElOX1NUQVRFX0RJU0NPTk5FQ1RFRGBgICBQaW4gZGlzY29ubmVjdGVkIGZyb20gZHBsbA0K Pj4gKyAgYGBQSU5fU1RBVEVfU09VUkNFYGAgICAgICAgIFNvdXJjZSBwaW4NCj4+ICsgIGBgUElO X1NUQVRFX09VVFBVVGBgICAgICAgICBPdXRwdXQgcGluDQo+PiArDQo+PiArUG9zc2libGUgRFBM TCBzb3VyY2Ugc2VsZWN0aW9uIG1vZGUgdmFsdWVzOg0KPj4gKw0KPj4gKyAgPT09PT09PT09PT09 PT09PT09PSA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0N Cj4+ICsgIGBgTU9ERV9GT1JDRURgYCAgICAgc291cmNlIHBpbiBpcyBmb3JjZS1zZWxlY3RlZCBi eQ0KPj4gKyAgICAgICAgICAgICAgICAgICAgICBgYERQTExfQ01EX0RFVklDRV9TRVRgYCB3aXRo IGdpdmVuIHZhbHVlIG9mDQo+PiArICAgICAgICAgICAgICAgICAgICAgIGBgRFBMTEFfU09VUkNF X1BJTl9JRFhgYCBhdHRyaWJ1dGUNCj4+ICsgIGBgTU9ERV9BVVRPTUFUSUNgYCAgc291cmNlIHBp biBpc2UgYXV0byBzZWxlY3RlZCBhY2NvcmRpbmcgdG8NCj4NCj50eXBvIGFib3ZlICdpc2UnIC0+ ICdpcycNCj4NCg0KU3VyZSwgd2lsbCBmaXguDQoNClRoYW5rcyBhZ2FpbiENCg0KQlIsDQpBcmth ZGl1c3oNCg0KPg0KPkNoZWVycywNCj4NCj5QYW9sbw0KDQo= 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 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 smtp.lore.kernel.org (Postfix) with ESMTPS id 28121C54EBC for ; Thu, 12 Jan 2023 13:46:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:In-Reply-To:References: Message-ID:Date:Subject:CC:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=kz2wjEd2w4a7UM3Rm/5kA/4fIA0PYeZfnvUPk3hNZcU=; b=hQQ6zCO0QGyJ+7 li1nEFoQw2b3kGrd36h6ahNff+kLjdi4srsHItQMKcWPHSfN6A/To8CgNqPl/ktH701wfjpKh94AT yxpglpvtFBQSUqZC/jTPLTbcTaoTuYBiEtL+zldVfH03kS61jqRzze7f6AfI6ipCwmh2xagmaY/Io eeytyGeN4mI+k9m08AIL/Y7bfDGOGCBMz5ujde1WbsEe19XSoJa+sZX5K6C9IsmZd3eJ3bgQr5GLE 1PqMi1WYe26L1omn4l+VdMNGAj+PzFnUyKRnIHG+OZbathh85LTMH1wqV3aw0ZCULL4hFU5XqmcTg 9qpiibdg/F0RqVvoVhZw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pFxtI-00FDWz-NX; Thu, 12 Jan 2023 13:45:13 +0000 Received: from mga03.intel.com ([134.134.136.65]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1pFxtB-00FDVG-Rf for linux-arm-kernel@lists.infradead.org; Thu, 12 Jan 2023 13:45:08 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1673531105; x=1705067105; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=GwtsyYXwhfZzSnYE6Nprz8+mxmQ09HgaUB4RIyDN2E0=; b=VVtlZSf53qtGtN6oKo7UnkzBW4NldOpJBEtuPVcu6a86DtslV5s6AHtp AL582fDWqH7PRLX1rxzTay2oNJf6f8Wkd/ooZaenaLtewbVXC5WoIKb+b o42vczjCMYWuMRVIvvraeG4x6IQJj8jzJpskcPgzfO5cibURdee+evuVb vxbzfpLDuKXMnTbbKVYHNxGni/Toh/5Y0KD/y/JlzqYFmN3aLEZ9a7utM yoNAY50JDovf6IkJZ/Re67OdRBViHtthHo3FRtFTsc81cerosXvSVQlyv AJzfX4fYWoDdoYDvp8gqLidZ4ONFCz7N8N1jN/FoMpLTchyAm27K0TmjS A==; X-IronPort-AV: E=McAfee;i="6500,9779,10587"; a="325728889" X-IronPort-AV: E=Sophos;i="5.97,211,1669104000"; d="scan'208";a="325728889" Received: from fmsmga005.fm.intel.com ([10.253.24.32]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 12 Jan 2023 05:45:04 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10587"; a="986557375" X-IronPort-AV: E=Sophos;i="5.97,211,1669104000"; d="scan'208";a="986557375" Received: from fmsmsx602.amr.corp.intel.com ([10.18.126.82]) by fmsmga005.fm.intel.com with ESMTP; 12 Jan 2023 05:45:04 -0800 Received: from fmsmsx611.amr.corp.intel.com (10.18.126.91) by fmsmsx602.amr.corp.intel.com (10.18.126.82) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16; Thu, 12 Jan 2023 05:45:03 -0800 Received: from fmsmsx601.amr.corp.intel.com (10.18.126.81) by fmsmsx611.amr.corp.intel.com (10.18.126.91) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16; Thu, 12 Jan 2023 05:45:03 -0800 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.16 via Frontend Transport; Thu, 12 Jan 2023 05:45:03 -0800 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (104.47.58.107) by edgegateway.intel.com (192.55.55.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.16; Thu, 12 Jan 2023 05:45:03 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EhucGhfniqVJV9W5D1qpprtJ+TmV18C67WI0hP6/cidqosXnH1rKBGNrTTNUb9xgJVDghkVz9gHsnKgT77KfUcnN+lZ0/XuDQZEbtAWB0DycYC42Fr30hrYgf6o8E+RkGuLh6Ac2azQ7zdDDnuhTPdvDjtpvMIKQ7auCE3BFH57qmOVYf59uteVg5DTK3c6KjZXOZRqFu5gPisdLITelTJernGa9SRnGoWSLZkHWhL3+CBIoeuMMWZW4D72NH+Qq8+KlRtiSVlzN2vMKnDKmhVfOcGqg51XZWdKHzYOANwRtm8G0d42t7lmXbdmlWTi0ctmnLWibuoVIIW8N0WiJPw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=GwtsyYXwhfZzSnYE6Nprz8+mxmQ09HgaUB4RIyDN2E0=; b=FT3FwolRaO2WHeSvJ29KSL2GMKilc3V+qKW5XHVel/Db2ueNSM+KnsWbQ0S/Ezi+YIcAHvaFHhuZZ14l0Kn6sbZDli6nCcH0lJWEUZX6g0WQTUh58E4TupJvZ85xwKA+r5ymSC1HFm7vFvXqF6RuOmwacmNsm1iqq+jEpKIP0oR61Q96ACKErDYVRt6pxZo4ljyRkjhv19Dfx89/L1l87jjiDo+uPr9tQ3n4QRiuFie89W4BeQqcvLvj2SPeDhA67JM9DaPkAv86ZzlTuG31wplCL04yDKzKxSrqDpn/Ky1r5/6monVGCCuLWC3kYuYpVO+zibpmDfvZVIomJsoVdA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from DM6PR11MB4657.namprd11.prod.outlook.com (2603:10b6:5:2a6::7) by SA3PR11MB7528.namprd11.prod.outlook.com (2603:10b6:806:317::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5986.18; Thu, 12 Jan 2023 13:45:01 +0000 Received: from DM6PR11MB4657.namprd11.prod.outlook.com ([fe80::5006:f262:3103:f080]) by DM6PR11MB4657.namprd11.prod.outlook.com ([fe80::5006:f262:3103:f080%8]) with mapi id 15.20.6002.013; Thu, 12 Jan 2023 13:45:01 +0000 From: "Kubalewski, Arkadiusz" To: Paolo Abeni , Vadim Fedorenko , Jakub Kicinski , Jiri Pirko , "Jonathan Lemon" CC: "netdev@vger.kernel.org" , Vadim Fedorenko , "linux-arm-kernel@lists.infradead.org" , "linux-clk@vger.kernel.org" Subject: RE: [RFC PATCH v4 3/4] dpll: documentation on DPLL subsystem interface Thread-Topic: [RFC PATCH v4 3/4] dpll: documentation on DPLL subsystem interface Thread-Index: AQHZBDrykoom+kieX0a3/IkWyCaHua51C70AgCYABwA= Date: Thu, 12 Jan 2023 13:45:00 +0000 Message-ID: References: <20221129213724.10119-1-vfedorenko@novek.ru> <20221129213724.10119-4-vfedorenko@novek.ru> <60c011eb99c1859d4ee7191d4cbc20d11548f327.camel@redhat.com> In-Reply-To: <60c011eb99c1859d4ee7191d4cbc20d11548f327.camel@redhat.com> Accept-Language: pl-PL, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DM6PR11MB4657:EE_|SA3PR11MB7528:EE_ x-ms-office365-filtering-correlation-id: d705321d-3f34-4056-261e-08daf4a333a4 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: /0EcEQtdvIqoV091G/Vca6Z0sAxLMc1UYCNZ/enS2vZ61jL67IMXFdqIS6BIXKkrnimKSfmRsbSDgrFV8Bfe+sSgYY6wu3RK+4VUC4nfvtFXRaV7IA9WCdxKfPgz+tki5X81KpqfS3ZUuKNT+JWQB/sPfpD8CbqZ4UaGY7RiH6lI7i6FqpBAkjfwIa/ULwXmJYd5BDS2M/LW57Lamj8oopfe0eAsSVSn521jmLYMlEprUVVoUEkxmaCuDvFH1mGzfpKWj8l4VPe5sNo3xYOWhRtUbFgGZa5UZDSWeuCFXEr5pPmAmuWW+/x9nZzfWPWfxb9cInuo1GIlIkl0lTVzDCyRiNoTIVfZzuIV+4++L6AgSCI3k4xJGouCIIVBfRXbs67f7W/5PDFljcxT9ulAQuF/8pjsu77FQXFYIv/cZDg4Zys8GtUtKfRKlNLInU9wgBcArdEqopfxjAkxa3yBSbzODasdkmygAKsfk2d5ZUtVx/jKjzTdarL+CquqRaTWNgiY2YHo79HzpotkGEN6yvCbwA+dSjNg8e0tcXgtVj03G68NO0yIhqAj0oLa00cSWF++3t1JLLDb6KFJJ4nQ4gQPuKQiS1ivljVeFTeBI3PWMjqbm/U+Kq0cvGKrhUVXvYrgbQgOcJs5i1w3qEpUGdS2gcV8BWbpoWfacTLLHMTXppUkvdc4P4jpxLL1tqMQdT10FebJBopry6Bd798AKw== x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR11MB4657.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(39860400002)(396003)(376002)(136003)(346002)(366004)(451199015)(122000001)(82960400001)(38100700002)(33656002)(38070700005)(86362001)(83380400001)(54906003)(8676002)(41300700001)(66476007)(110136005)(66556008)(66446008)(66946007)(4326008)(76116006)(2906002)(478600001)(7696005)(55016003)(5660300002)(316002)(8936002)(52536014)(9686003)(6506007)(186003)(26005)(71200400001)(64756008)(4001150100001);DIR:OUT;SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?B?UnBoaUxtSDdveEw5SFBCMStQNlVYWGdxbWtsYWFnbFY0NThlby9BMDdnNm90?= =?utf-8?B?Mk00Z0JpM2l0a1p2TFZDbTE4YWFhUE90Ynp1ZFNEd3lvckpuVmJuSmlmaGMw?= =?utf-8?B?VzlmSzB4b1hJNHBGSnE0QUZxb2F1QmlQbm44UC94WUdpcmdrZ21ESUJHdnBS?= =?utf-8?B?bTR4TXNqVlk4NVBjN0lTMWpXN2JHc1FKYnRRTmd0ekZheUNMYmxCQUlNVVhy?= =?utf-8?B?cVgxZzlaT0RHUHhyR2paM3BZU2EyYnRSTTJ0cFRnSC83UG4rVk4xRzVEV2Q3?= =?utf-8?B?ZHkyc0N5ODlWbGdXY2VZMlVtK0lqSlJoR0xGZkN2eSs1YnVXV3NhMGRVYm5E?= =?utf-8?B?bGE4QjR1cWFtQ1NWZjZ3TDlYK3pWTW90bVpkM25vQXpRUnY5bVdHbFczRVdD?= =?utf-8?B?MGsvR2xza2RWaGFhQ2NZUXNRWVRxc1J0eXFWbHhwUVdSSW42Q3M2TVZ4cXB3?= =?utf-8?B?U0Y3R2NHZEdZeTdzclFmRHY2OTU1b3I4cXFMV2ZLOHI3elJaV3d5ejFLUy9u?= =?utf-8?B?SS9PVnlZYmM4Qk5JT29hUkNtaE9EbXBrVllYc3JHcGdPME9FWG54Z3JrT1J4?= =?utf-8?B?WExncDQzSGxoVGFteWNSL2hHQVNJenk1VFM3VW1xNHJJVEZmSTBhUTVPYS93?= =?utf-8?B?Zit2S05YQ1JTNmxmdG5vcktoY1N1a1JrdEhPM2hPby9wZC8zN2Nzc1c2Ymtr?= =?utf-8?B?MXJqbnpYS2QvU2p0QlY1YzBINHFLcXovUnM5RDhNb2xOcktiVmkvNDJhMlps?= =?utf-8?B?Ym5UMXRPMmQ0MlhrOVQ1MUZ3aGx2UE5vMXUwK2tyQUQ3S2ZaNFZGaVQxZ0c1?= =?utf-8?B?SjJOcmQ5Z2R2SFVlTGNrZUREM2JKdTVrbDF3aDBZeFRhbFQvTjhLYjdQZXJL?= =?utf-8?B?NkFCak9RMnN5eFIrd3lsSUlYT1M2b3VBUEVVVTM1UFZQYytyUW5nYzdTQ1d4?= =?utf-8?B?Ulhqa3l3YjBaUUxHQnRSUXRtbFRpOEt3SGV6RDJ4MVVMbVRkaHZZTXdsZUl6?= =?utf-8?B?UXphc002TlVtVlAwTEtDKzFLVnVNOXdmM1lHRGhHeERseFEwS2FVTFVkdDNE?= =?utf-8?B?Ni9BYmttbGpwd09FRjlyazVqMno0WmVOQUUveTdCSzN6TVVjSVpUSzEyc0Jn?= =?utf-8?B?UDNRT3ZRSDdnaVJ2bnNibjRQOEszUFU5d0tKbWFXV0FuMjVNVlBuTW00UnA3?= =?utf-8?B?UlYvRlBaSk9idHJ5bnlickM4elBpTncvRjBsMExkUGNuYUN3Q2MyN3B6Rjhz?= =?utf-8?B?YUcrZ2tjOWxhMW1YM1VrcG10a1NLcnk5OWY3bzF6Q1F2SjA1SWN3WVFzQVlv?= =?utf-8?B?eUp0bm9GN0wyMFhEdnkzcVpmUThLNTRJbGZNa3ZWZDhwL0JZcmdJQW5nTllN?= =?utf-8?B?bFpGeG5BQTJpRG1OMTIrcUZja0plb1M2L0FDWVNYRXdEYjhSc1MyQTJUelJa?= =?utf-8?B?M0ZVdm10bVNXM0cwT2FqL0Q4eUY4RnovZUF1SGdYc1Ezam11czZLTTZ2UUI0?= =?utf-8?B?T0o0VkhKMU00TU0rSnUrRjNxeUhYZ2p4Zjh0SFFmUk5uNGdPazB2cGxFanZu?= =?utf-8?B?QURNRjBGNmdtVUwvYmZYOHoxRTJSV3pNeUNTdTg0eDM0eXI3bGRGV2hmdlQw?= =?utf-8?B?dDVWenZ3MWpYU0Jldm9NbVB0WkhlVWdPd0dneXQ1QlQ4Zm5qbFhMR3RsdG9m?= =?utf-8?B?dUpVN3JRKzB3ODFRQ3ZMa2dEbnBjang4K1NtRWF4dVVBQVB2bEg2NVk4NDlu?= =?utf-8?B?NUlkT3ZhNVA5V1J0MnpqN3BwTGRVZDRpYXAyeXIweVNWVWloRDdDYlRyWGVa?= =?utf-8?B?TVFkd1RrbEE4ZFNxK2YyOVhRWnY3cDhGWHRtL1lXNi9hQTdwdlNERkNKTzdp?= =?utf-8?B?dm5jYW93SFR1dE9Uem5aTUV2N3VOYzRTQnlBQ0hyMjM0cE5mTjVmbnIwK2FR?= =?utf-8?B?a1lGM3llallqZXU5dG1ndEFQN0kvTW5TY0xabVQzYzFHek1NT3JLem9UcDlV?= =?utf-8?B?SWVxbGN4aktGc25KUVl3NzA2eG12NFFnS0Vrdlc1bGRCVkJOa0hESHNacmNj?= =?utf-8?B?OGRDY1R1Ujcxd1VsTUV4VnJoTVIxdjlKNXk0VDVBRkpmV1lhbHRJemhlZ3N5?= =?utf-8?B?cld5NW8vTlB0VXlJUXQya0hCNm1BM2g4RVMxZll3QzhSbkxmWXROKzF1Vi9K?= =?utf-8?B?WkE9PQ==?= MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM6PR11MB4657.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: d705321d-3f34-4056-261e-08daf4a333a4 X-MS-Exchange-CrossTenant-originalarrivaltime: 12 Jan 2023 13:45:00.8963 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: s1xLwIKPgbNtpL26jSVK3X/cK6drez0sjlr1LuYA1MKcbeX1DDklViZdALFu6DKqAlMZP5B+N524wcMj5JhIdoSar4+iSPkSwV+F1/OEHZk= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA3PR11MB7528 X-OriginatorOrg: intel.com X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230112_054506_024708_0E0C444E X-CRM114-Status: GOOD ( 21.64 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org >From: Paolo Abeni >Sent: Monday, December 19, 2022 10:13 AM > >Hello, > >I have a just a few minor notes WRT the documentation - which was a >very useful entry point for me to help understanding the subsystem. Hi Paolo, many thanks for your feedback! > >On Wed, 2022-11-30 at 00:37 +0300, Vadim Fedorenko wrote: >> From: Vadim Fedorenko >> >> Add documentation explaining common netlink interface to configure DPLL >> devices and monitoring events. Common way to implement DPLL device in >> a driver is also covered. >> >> Co-developed-by: Arkadiusz Kubalewski >> Signed-off-by: Arkadiusz Kubalewski >> Signed-off-by: Vadim Fedorenko >> --- >> Documentation/networking/dpll.rst | 271 +++++++++++++++++++++++++++++ >> Documentation/networking/index.rst | 1 + >> 2 files changed, 272 insertions(+) >> create mode 100644 Documentation/networking/dpll.rst >> >> diff --git a/Documentation/networking/dpll.rst >b/Documentation/networking/dpll.rst >> new file mode 100644 >> index 000000000000..58401e2b70a7 >> --- /dev/null >> +++ b/Documentation/networking/dpll.rst >> @@ -0,0 +1,271 @@ >> +.. SPDX-License-Identifier: GPL-2.0 >> + >> +=============================== >> +The Linux kernel DPLL subsystem >> +=============================== >> + >> + >> +The main purpose of DPLL subsystem is to provide general interface >> +to configure devices that use any kind of Digital PLL and could use >> +different sources of signal to synchronize to as well as different >> +types of outputs. >> +The main interface is NETLINK_GENERIC based protocol with an event >> +monitoring multicast group defined. >> + >> + >> +Pin object >> +========== >> +A pin is amorphic object which represents either input and output, it >> +could be internal component of the device, as well as externaly >> +connected. >> +The number of pins per dpll vary, but usually multiple pins shall be >> +provided for a single dpll device. >> +Direction of a pin and it's capabilities are provided to the user in >> +response for netlink dump request messages. >> +Pin can be shared by multiple dpll devices. Where configuration on one >> +pin can alter multiple dplls (i.e. DPLL_PIN_SGINAL_TYPE, DPLL_PIN_TYPE, > >Likely typo above: DPLL_PIN_SIGNAL_TYPE True, shall be fixed in next version. > >> +DPLL_PIN_STATE), or just one pin-dpll pair (i.e. DPLL_PIN_PRIO). >> +Pin can be also a MUX type, where one or more pins are attached to >> +a parent pin. The parent pin is the one directly connected to the dpll, >> +which may be used by dplls in DPLL_MODE_AUTOMATIC selection mode, where >> +only pins directly connected to the dpll are capable of automatic >> +source pin selection. In such case, pins are dumped with >> +DPLLA_PIN_PARENT_IDX, and are able to be selected by the userspace with >> +netlink request. >> + >> +Configuration commands group >> +============================ >> + >> +Configuration commands are used to get or dump information about >> +registered DPLL devices (and pins), as well as set configuration of >> +device or pins. As DPLL device could not be abstract and reflects real >> +hardware, there is no way to add new DPLL device via netlink from user >> +space and each device should be registered by it's driver. > >Side note: in the long run we could end-up with a virtual/dummy dpll >driver for self-tests and/or reference's implementation sake. > True, seems a good idea. >> + >> +List of command with possible attributes >> +======================================== >> + >> +All constants identifying command types use ``DPLL_CMD_`` prefix and >> +suffix according to command purpose. All attributes use ``DPLLA_`` >> +prefix and suffix according to attribute purpose: >> + >> + ============================ ======================================= >> + ``DEVICE_GET`` userspace to get device info >> + ``ID`` attr internal dpll device index >> + ``NAME`` attr dpll device name >> + ``MODE`` attr selection mode >> + ``MODE_SUPPORTED`` attr available selection modes >> + ``SOURCE_PIN_IDX`` attr index of currently selected source >> + ``LOCK_STATUS`` attr internal frequency-lock status >> + ``TEMP`` attr device temperature information >> + ``NETIFINDEX`` attr dpll owner Linux netdevice index > >should we include also the cookie (or wuhatever will be used for >persistent device identification) into the readable attributes list? > In next version cookie is replaced with clock_id and will be also available for the userspace. >> + ``DEVICE_SET`` userspace to set dpll device >> + configuration >> + ``ID`` attr internal dpll device index >> + ``MODE`` attr selection mode to configure >> + ``PIN_IDX`` attr index of source pin to select as >> + active source > >It looks like the descrition for the above attribute ('PIN_IDX') and >'SOURCE_PIN_IDX' has been swapped. Good catch, for ``DEVICE_SET`` command, proper attribute is 'SOURCE_PIN_IDX', will fix that. > >> + ``PIN_SET`` userspace to set pins configuration >> + ``ID`` attr internal dpll device index >> + ``PIN_IDX`` attr index of a pin to configure >> + ``PIN_TYPE`` attr type configuration value for >> + selected pin >> + ``PIN_SIGNAL_TYPE`` attr signal type configuration value >> + for selected pin >> + ``PIN_CUSTOM_FREQ`` attr signal custom frequency to be set >> + ``PIN_STATE`` attr pin state to be set >> + ``PIN_PRIO`` attr pin priority to be set >> + >> +Netlink dump requests >> +===================== >> +The ``DEVICE_GET`` command is capable of dump type netlink requests. >> +In such case the userspace shall provide ``DUMP_FILTER`` attribute >> +value to filter the response as required. >> +If filter is not provided only name and id of available dpll(s) is >> +provided. If the request also contains ``ID`` attribute, only selected >> +dpll device shall be dumped. > >Should we explicitly document even the required permissions? Sure, going to add a word about required netlink permission. > >> + >> +Possible response message attributes for netlink requests depending on >> +the value of ``DPLLA_DUMP_FILTER`` attribute: >> + >> + =============================== ==================================== >> + ``DPLL_DUMP_FILTER_PINS`` value of ``DUMP_FILTER`` attribute >> + ``PIN`` attr nested type contain single pin >> + attributes >> + ``PIN_IDX`` attr index of dumped pin >> + ``PIN_DESCRIPTION`` description of a pin provided by >> + driver >> + ``PIN_TYPE`` attr value of pin type >> + ``PIN_TYPE_SUPPORTED`` attr value of supported pin type >> + ``PIN_SIGNAL_TYPE`` attr value of pin signal type >> + ``PIN_SIGNAL_TYPE_SUPPORTED`` attr value of supported pin signal >> + type >> + ``PIN_CUSTOM_FREQ`` attr value of pin custom frequency >> + ``PIN_STATE`` attr value of pin state >> + ``PIN_STATE_SUPPORTED`` attr value of supported pin state >> + ``PIN_PRIO`` attr value of pin prio >> + ``PIN_PARENT_IDX`` attr value of pin patent index >> + ``PIN_NETIFINDEX`` attr value of netdevice assocaiated >> + with the pin >> + ``DPLL_DUMP_FILTER_STATUS`` value of ``DUMP_FILTER`` attribute >> + ``ID`` attr internal dpll device index >> + ``NAME`` attr dpll device name >> + ``MODE`` attr selection mode >> + ``MODE_SUPPORTED`` attr available selection modes >> + ``SOURCE_PIN_IDX`` attr index of currently selected >> + source >> + ``LOCK_STATUS`` attr internal frequency-lock status >> + ``TEMP`` attr device temperature information >> + ``NETIFINDEX`` attr dpll owner Linux netdevice index >> + >> + >> +The pre-defined enums >> +===================== >> + >> +All the enums use the ``DPLL_`` prefix. >> + >> +Values for ``PIN_TYPE`` and ``PIN_TYPE_SUPPORTED`` attributes: >> + >> + ============================ ======================================== >> + ``PIN_TYPE_MUX`` MUX type pin, connected pins shall >> + have their own types >> + ``PIN_TYPE_EXT`` External pin >> + ``PIN_TYPE_SYNCE_ETH_PORT`` SyncE on Ethernet port >> + ``PIN_TYPE_INT_OSCILLATOR`` Internal Oscillator (i.e. Holdover >> + with Atomic Clock as a Source) >> + ``PIN_TYPE_GNSS`` GNSS 1PPS source >> + >> +Values for ``PIN_SIGNAL_TYPE`` and ``PIN_SIGNAL_TYPE_SUPPORTED`` >> +attributes: >> + >> + =============================== =================================== >> + ``PIN_SIGNAL_TYPE_1_PPS`` 1 Hz frequency >> + ``PIN_SIGNAL_TYPE_10_MHZ`` 10 MHz frequency >> + ``PIN_SIGNAL_TYPE_CUSTOM_FREQ`` Frequency value provided in attr >> + ``PIN_CUSTOM_FREQ`` >> + >> +Values for ``LOCK_STATUS`` attribute: >> + >> + ============================= ====================================== >> + ``LOCK_STATUS_UNLOCKED`` DPLL is in freerun, not locked to any >> + source pin >> + ``LOCK_STATUS_CALIBRATING`` DPLL device calibrates to lock to the >> + source pin signal >> + ``LOCK_STATUS_LOCKED`` DPLL device is locked to the source >> + pin frequency >> + ``LOCK_STATUS_HOLDOVER`` DPLL device lost a lock, using its >> + frequency holdover capabilities >> + >> +Values for ``PIN_STATE`` and ``PIN_STATE_SUPPORTED`` attributes: >> + >> +============================= ============================ >> + ``PIN_STATE_CONNECTED`` Pin connected to a dpll >> + ``PIN_STATE_DISCONNECTED`` Pin disconnected from dpll >> + ``PIN_STATE_SOURCE`` Source pin >> + ``PIN_STATE_OUTPUT`` Output pin >> + >> +Possible DPLL source selection mode values: >> + >> + =================== ================================================ >> + ``MODE_FORCED`` source pin is force-selected by >> + ``DPLL_CMD_DEVICE_SET`` with given value of >> + ``DPLLA_SOURCE_PIN_IDX`` attribute >> + ``MODE_AUTOMATIC`` source pin ise auto selected according to > >typo above 'ise' -> 'is' > Sure, will fix. Thanks again! BR, Arkadiusz > >Cheers, > >Paolo _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel