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 319C4C28D13 for ; Mon, 22 Aug 2022 11:53:27 +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:Content-ID:In-Reply-To: References:Message-ID:Date:Subject:CC:To:From:Reply-To:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=pOfLqnrsb68fxfDNBwLT8pkhsABPmtjAtFcwRTas9Ug=; b=pMykzgLFNbJ8HF y9bLb/rp+sDVQ5JOLynlMqBKw32eovVszNbzhLo5RDj3tAOr/xZY59XMS6ktSfBKXxWQoLBrKNKhu ru7JkYWI0VN3SpBqSwl/zuGbb4oDRFd5fmJyUc6LO7vEtaeBge77ew0Nm9CDlaQv6MiRIi1q2ZfAn /CoPKAbzvEgAh+lbwo4UpjrlEwtmX4YFU7SbVvpeUdGH949uWfP77M7MZpPH07f3/MhCKTAYZdwaC U+Arri/H1OZJiG1virlyPh3xWQ6g7GkPtgPL690yW6dI+lFjnOqaqWCQsm+VyU1jtCkYDpz9MkeZy pnj+xFjpcPtWmWPXbouA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1oQ5zY-008ZDa-Oy; Mon, 22 Aug 2022 11:53:16 +0000 Received: from esa.microchip.iphmx.com ([68.232.153.233]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1oQ5zW-008ZAS-1D for linux-riscv@lists.infradead.org; Mon, 22 Aug 2022 11:53:15 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1661169193; x=1692705193; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=T8/xiZxVzwQetG+rl4nj3cszYckzSQ0hm7zBh/CRI5g=; b=MnMQPYI3Zy9Kgc8ALwexM8+yETtDnlx0F/TXJQOurauRVT0DJ4vuOuET ajuSRqVlLHmtepVqYBuW0iXj75LJ3zH0D9s+cCHmG3iUUDeqyAk7SUFTO DOPCpfL3Y9gWwAQmEEcc+aEbLMn+EMfflV+ZNnNck7vFXPxKQNraLcG2g 7oTW8brfB72WSH5KZjzNOmImyVh0Y/RairrwrzUZA3KFqXQdS1CmWmws/ TdXlmXU0EfALTYijttXW2+hzCmqCleogLTfhud/h7OWb2Kp3AzLVw+gA0 KDLFURln4kFl8sHA9ZiHmC8zVpem4kvWMuEuMum9IcL+oduOb+2xijlW1 A==; X-IronPort-AV: E=Sophos;i="5.93,254,1654585200"; d="scan'208";a="187492617" Received: from unknown (HELO email.microchip.com) ([170.129.1.10]) by esa1.microchip.iphmx.com with ESMTP/TLS/AES256-SHA256; 22 Aug 2022 04:53:12 -0700 Received: from chn-vm-ex01.mchp-main.com (10.10.85.143) by chn-vm-ex04.mchp-main.com (10.10.85.152) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.12; Mon, 22 Aug 2022 04:53:12 -0700 Received: from NAM02-DM3-obe.outbound.protection.outlook.com (10.10.215.89) by email.microchip.com (10.10.87.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.12 via Frontend Transport; Mon, 22 Aug 2022 04:53:12 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IYqeqXWccZJLPClcFCoqFE/b1pZ8v8SKqJIXSgH1LShHsDMRzBr2TU38uK2m3XqqfbD1X19sMsUuyjJN2c4UT4D/G5ko+KbsTYAopnAkRRyKP8ACeXmYN8jfXXo62wEXw0Sw2l6eVRP2ADuVPK0KrHX3DzXt4InrLag+LcC5IvIhzbiRZrL5Y5jO4VZ6Lvf7C80Jy2wqEPv7xGIvXVm4zsjKaiMQ0XWOrFnsgpQLn57FhwAlGc7WrRbJTvLUkw4+J2AGccLnL15NxCBvn1pxa0spEh/xywLouDXM4c2iiQy3F8hbG8ebiQDcmzRbxBlwtV8q5Pu74ot/+FY7Yf90YQ== 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=T8/xiZxVzwQetG+rl4nj3cszYckzSQ0hm7zBh/CRI5g=; b=NiK57Yo7EEsc+U0jVM0fAb5HQ9uGvKKgaq7BRHViOV4YZwtEC7PGKbtxjW+K/oDtzVoJ6aCFqapqlecV9yEL8CDEnVb9Cg7fUp6lcH2GHa9ZiU/kjGI3FMGUe5BJB8uzn611dKmC/BsAGKo53nrCo9K63v84qxb9cm/sQmQ3uBdsUipow3SqjssOammOR0IWLUC39z+LGoepmfMtkdY20LC4KDL5dgC7EDwnxfrQ8hyRV0yDBWZEjbzn9MySzooTAPxqBEFROuGQ+9NQMvC9ttzojl4KO7kTxJui5rrIRsGeIXHgTtGXqrJDSo122u5PmqZxF86yvHUecXD1aVMmvA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=microchip.com; dmarc=pass action=none header.from=microchip.com; dkim=pass header.d=microchip.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=microchiptechnology.onmicrosoft.com; s=selector2-microchiptechnology-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=T8/xiZxVzwQetG+rl4nj3cszYckzSQ0hm7zBh/CRI5g=; b=JwVAHKbR0WXXDL1ODBZnmbXoz+vO5B6qRyHVz6KB5VFqKf5gUNc1R40tptITrUqJbT2I4zvmlFOOw0sGtRmXqclV8VEY2DmZ2CQOGKzDqf21paG/blZWUxTZalLB1WxWGLjIv7mbUz27eZ8+uc/cWfN5GTLR3jxEh/8qF5TkZdo= Received: from CO1PR11MB5154.namprd11.prod.outlook.com (2603:10b6:303:99::15) by BL0PR11MB2930.namprd11.prod.outlook.com (2603:10b6:208:73::25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5546.19; Mon, 22 Aug 2022 11:53:08 +0000 Received: from CO1PR11MB5154.namprd11.prod.outlook.com ([fe80::ac89:75cd:26e0:51c3]) by CO1PR11MB5154.namprd11.prod.outlook.com ([fe80::ac89:75cd:26e0:51c3%9]) with mapi id 15.20.5546.022; Mon, 22 Aug 2022 11:53:07 +0000 From: To: , , , , , , CC: , , , , , Subject: Re: [PATCH v2 2/6] dt-bindings: clk: document PolarFire SoC fabric clocks Thread-Topic: [PATCH v2 2/6] dt-bindings: clk: document PolarFire SoC fabric clocks Thread-Index: AQHYthqSUVtMWR5Ot0GrcHpCiU3dwK26zzSA Date: Mon, 22 Aug 2022 11:53:07 +0000 Message-ID: <470d663f-7150-1df9-9ce0-93087feb7819@microchip.com> References: <20220822112928.2727437-1-conor.dooley@microchip.com> <20220822112928.2727437-3-conor.dooley@microchip.com> In-Reply-To: <20220822112928.2727437-3-conor.dooley@microchip.com> Accept-Language: en-IE, en-US Content-Language: en-IE X-MS-Has-Attach: X-MS-TNEF-Correlator: user-agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.12.0 authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=microchip.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 0b9c512f-6c5b-413f-f421-08da8434e138 x-ms-traffictypediagnostic: BL0PR11MB2930:EE_ x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: L3AHlnDyk5xOCib8o/fY3bJE3/Xfn4YdszZPpRZuiyDWS+IDtgg31CVApLR/r21Eg1g4CW43t1TkXRkdAzRA4Hv3lE4YLunJK4nQ6m6/NC9lWQPkZYvXUqi0EPk1i1v/jW1bLqOYDQseEZ9hqldd9hNz+Ppw1FD0xmMVSXp7ekV9jcRFio5GtRmz1m+8m/EnOTiG9I78kNcTMcYL9/4q91HGKsy9etvnsYWvUe/W4pPPv0C5rKez4KbuLfqb2+zE29zNdJRnXv+7l3vCBC2FMZEMSvdc+epFoAlmJsU9304WI7xp43S884LohiqrmYd3souuc4EkhCoBi2//M699LlgmK4RqAbImAdHs8kuBypLDbUVIgxaXsG6OSS8VGOqldf2J4+kIwqF8MSddUoQFGT8i5B20THbdnX0NIhDZhu77f87pJxoikLLiv+0zRTSKyBZ680Bou+PHHn1AFg8v9qW00Hzkmn//OzN8hk5Hqp9QCg87QZzy2V1yBotFZpOIFpi2/eLSlQG8yCHDCJCcW/fk+AH9LBJb1CojTG1HdQZHGCDwlObmCGfoh265ikrEFx3I5nCjtESK8bdXJezXsO8csN0Tt0xwQykn3pQcDltwNOvfP2R2/1xFw03lPfySLmpamAYCdHtUF8Z1xOsthUxNlkxBXfDtK0NVwAEaY6eUNP5SIZoQAEhhaUxNLmHBxf3wQOo1FxoleGb9I3JsMCeJFyQpKSncTYbXuGaH5/Sl1cdmHBqbiX6JEYkBzuR2AQsG0uAFPkQyJykJQPNiFWKxbutEtfJ9y6hf/KOZ8mH92X0ot8xxVpF4nCIcnqMQYnLB4TLnFGoi+ArI1SiR1w== x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:CO1PR11MB5154.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230016)(376002)(366004)(346002)(39860400002)(136003)(396003)(6512007)(38070700005)(53546011)(122000001)(6506007)(83380400001)(6636002)(110136005)(36756003)(54906003)(31686004)(2906002)(38100700002)(316002)(71200400001)(91956017)(86362001)(7416002)(41300700001)(5660300002)(8936002)(26005)(8676002)(4326008)(66476007)(64756008)(2616005)(66556008)(66946007)(31696002)(66446008)(6486002)(478600001)(76116006)(186003)(43740500002)(45980500001);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?B?U0lSL0VWc2t3cUZRdlJmcnVzRzlEQ0QzeWdNSXBVQUdiWnd4UlRhWlJCTDVG?= =?utf-8?B?K00wV2FTTlJRODdoU2k2OEFlOTd5ZnlsWUhOREQrSTNiYnE4WDFOYUQ1Z1U1?= =?utf-8?B?aXdDUjVuc0V1VlJERjNHU3RRNUlpTlRCeWE5aEk3cVZoaTBFVTc1TUptKy9N?= =?utf-8?B?Q3o2Y0wveVFHZzd5MGtpWGRwUTRsai9tNzZSTzBCRmFHT3NGRnBrK0Z3d2Uw?= =?utf-8?B?aXhNMHRrWHU4ZHY1MzBiMUdBL1EweWYyYXVKazBGTlZqTGdnMlZoc091a2Fk?= =?utf-8?B?RXFYWmNDbmdWUS9RaVAwZEVROERTY2F5QXJxN21qOXRGZjBWekdBazFkRmNr?= =?utf-8?B?S0YreHN0eXQ5b203NzFCdFBPNTZBdkN0RHJjMEE3Sjl6MlB4eUZTWkl3Rk0x?= =?utf-8?B?bjhMdzl1THpWendUUDYwcE82OHVSTjg3NFdyajFhUXN6bGFEVC91anhRN0R0?= =?utf-8?B?UFNad3RCdVhFWHU5bHhLTGFLbW1tQndxY1BQaG16aDVVL2hhV0xRem5kZ0VS?= =?utf-8?B?OEEwZVlzbzdOQkF4dkNYazlDUnlXdVR6d0R1RmNVZFF5RjN2clZMTHo5WlY5?= =?utf-8?B?Smp0UktsaWhTYzRHSVZSL1J4VEE5S1FaMVVacG84czRac1gweGk0ZG1Ua1E1?= =?utf-8?B?c1loaXZGQjd1aFVPdTVpNGZCTTREY01RQXgrNWdzZllpbHBiZ1hHQXB0UzRS?= =?utf-8?B?M1QvTmFEQlpEb1JOc3pNQ3pGOGc0TE50bWxjRlZoWTVpT3pHeTlIYWJpek5C?= =?utf-8?B?c0YrMVBaNFBZTHdQWGYxZHRmMGFtUjNXZHRFYTl6NWtZaURZTkZlK25keVdp?= =?utf-8?B?cnZBMGxndWtPNENyWTYxOTlWZHNRZnEya05mTW9KTUpndEluTjQ1bzNvdUhC?= =?utf-8?B?UEZuenBRSXJmWFgvdU1YaXNZVENoTVpPUFROSkZVY2w3S3Rrc0NwdWlrMDN3?= =?utf-8?B?ZDUzdFYwdnFPQjUxZWtLUS9iNEl0SDRFUGFTaEpBbFZ5cTl3bk5uZmJxYm83?= =?utf-8?B?U1JsWVBUbG9WNktjajY5YzBOVGNYRzIrSTlBclJNTUNXUDRIaUtIQmozR01S?= =?utf-8?B?QjZoeWNJUFJoaU1hclF2UjRXd2tXVnIvYjdYQTBHTFZ4SllZeE5DT3AvdE5O?= =?utf-8?B?YlFCUFlQcEFoZ2hYTWVHWjJlMG9GVjZ6NlA1ZEtxNlp6emNuK3FucGJuSjZU?= =?utf-8?B?Z0RuYjVGYjNKbW8vN0lMNkVnUitIeHNnTEY1NW9nekx0WHppY1UrNEdzajVX?= =?utf-8?B?dElqNG1mUGZjWDF4ckdzZWF4b1dOd1hOVGhHRGJaYmlwUHV2V0RwUlcvUUNM?= =?utf-8?B?OFZsNzROb3ZFOFV6VUMwWERBb0xXUjBzUXVlL25XdDQ5YkFVcEM2d2R5SnFR?= =?utf-8?B?UzlQNDUwbXdlM3ovY3ZPSUNNV1dmWHo0Yk5yVXplZmgyZjZjTU9iUEdkWHA5?= =?utf-8?B?dXhBempUMlkzL0dEeHo5c2FoZzdqYm9LNkFXeXdvR3dCc2I0dUZWemo0MCt0?= =?utf-8?B?M0cvaUxEQ2Z0N29EMzJrYkR3Ujh3Mm5vNktQRFlVekJ4YnU5b1MzMkU5WEhz?= =?utf-8?B?SFlQS2FzQ0VDRWFaMURWL1NOSnlXVUZ3ZWRBVStDWURYTDZsVVRWcVVJSTVY?= =?utf-8?B?YjM1Z25lVkpyc3FhM1B6YURYUExhRXVzTFBKZ0R3dlNrQVd2cXF5UUtLdThy?= =?utf-8?B?eDlyRUxqRjhQVmU1d09OdzFhbDlrc2syM3ZTQW92aGhFenFvUEJ1TGVncEQr?= =?utf-8?B?ak1TRmpWUUFoZ2JyRHZXaDI3akwvV1hEbnExeTgraVRwbm10K3BYL1hKeUZo?= =?utf-8?B?amZsaVRZRnZSblBMalRad1kzY3Q1YTQzc0hLU0twQzVwTkM0aWFNenF2aitO?= =?utf-8?B?eGVaVEIyUVZuSk1IK0ovQmEyV0hIbGZpTTRJTFJIbmF5eHNPR1c1TXkxNUFq?= =?utf-8?B?UDNNQytpQ1dZajlVTmNaNHhCVFQ1QWp5Z3pFeGxVSDF2d29yQW9mRExkOHVX?= =?utf-8?B?dzB0bkdCc2tRRmdPYUxNVHJES2lnZERmdE1LNG1MYkpWaEs3b0xNRDY1OEVh?= =?utf-8?B?ZTh1YnRuRkVaVmFScGh0RHl4UUJScDlZTlkwampMQjQ2WHJjNEZtVXRUUEth?= =?utf-8?Q?V93kwfze76DwjIO9nHg0JLUoo?= Content-ID: <7D4ACE106E4A6E4E8FB656C823257D34@namprd11.prod.outlook.com> MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: CO1PR11MB5154.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 0b9c512f-6c5b-413f-f421-08da8434e138 X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Aug 2022 11:53:07.7962 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 3f4057f3-b418-4d4e-ba84-d55b4e897d88 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: zGrdBaZvpsPEjxGLOi5IePx479HYvONq1Lr0dzz1AMDm9NFW4GD+i+bSZZew2wf/OqvHD47OU5DOaqGU4axtSTbsM7yp/cj/Lcsd2jh13ug= X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL0PR11MB2930 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220822_045314_106087_EBB35926 X-CRM114-Status: GOOD ( 13.97 ) X-BeenThere: linux-riscv@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-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org On 22/08/2022 12:29, Conor Dooley wrote: > On PolarFire SoC there are 4 PLL/DLL blocks, located in each of the > ordinal corners of the chip, which our documentation refers to as > "Clock Conditioning Circuitry". PolarFire SoC is an FPGA, these are > highly configurable & many of the input clocks are optional. > > Signed-off-by: Conor Dooley > + clock-names: > + minItems: 2 > + items: > + - const: pll0_ref0 > + - const: pll0_ref1 > + - const: pll1_ref0 > + - const: pll1_ref1 > + - const: dll0_ref > + - const: dll1_ref > + > + '#clock-cells': > + const: 1 > + description: | > + The clock consumer should specify the desired clock by having the clock > + ID in its "clocks" phandle cell. > + See include/dt-bindings/clock/microchip,mpfs-clock.h for the full list of > + PolarFire clock IDs. > + > +required: > + - compatible > + - reg > + - clocks > + - clock-names > + - clock-output-names Meh, didn't notice I had left this here.. Must've crept back in while I was rebasing my v2 changes. Either way Kryzysztof, I settled on removing the ordinal based naming entirely. I could not get trying the ordinal names & then falling back cleanly enough for my liking, so I dropped the whole thing. > + - '#clock-cells' > + > +additionalProperties: false > + > +examples: > + - | > + clock-controller@38100000 { > + compatible = "microchip,mpfs-ccc"; > + reg = <0x38010000 0x1000>, <0x38020000 0x1000>, > + <0x39010000 0x1000>, <0x39020000 0x1000>; > + #clock-cells = <1>; > + clocks = <&refclk_ccc>, <&refclk_ccc>, <&refclk_ccc>, <&refclk_ccc>, > + <&refclk_ccc>, <&refclk_ccc>; > + clock-names = "pll0_ref0", "pll0_ref1", "pll1_ref0", "pll1_ref1", > + "dll0_ref", "dll1_ref"; > + }; _______________________________________________ linux-riscv mailing list linux-riscv@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-riscv