Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <abc55598-8833-c4b2-aadc-c4e589aa775a@renesas.com>
Date:   Wed, 16 Nov 2022 13:17:54 -0700
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101
 Thunderbird/102.3.0
Subject: Re: [PATCH v3 1/2] dt-bindings: clock: Add bindings for Renesas ProXO
Content-Language: en-US
To:     Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>,
        linux-kernel@vger.kernel.org, devicetree@vger.kernel.org,
        linux-clk@vger.kernel.org
Cc:     krzysztof.kozlowski+dt@linaro.org, robh+dt@kernel.org,
        sboyd@kernel.org, mturquette@baylibre.com, geert+renesas@glider.be
References: <20221115233749.10161-1-alexander.helms.jy@renesas.com>
 <20221115233749.10161-2-alexander.helms.jy@renesas.com>
 <83492f7f-1217-69aa-8b38-ec1f08995832@linaro.org>
From:   Alex Helms <alexander.helms.jy@renesas.com>
In-Reply-To: <83492f7f-1217-69aa-8b38-ec1f08995832@linaro.org>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?MlZRU1BVY1AzVFZmL3lVV29oUGQxVGpUNHJTcUdURmZzT1JESElEZDloZDNX?=
 =?utf-8?B?VXlSVmMrRWJXa3RRMlFCRkttRUdoV08yTTRQd3RxZXdlNXU5QnkxOXNja1VV?=
 =?utf-8?B?T0F3QlpvNzhzMVdVZ0xqa0hwT1dmMkFHeEVpZ3RtRHBQdUpGR2pOZkk3T01R?=
 =?utf-8?B?UXhrWjdmekFQeHJsd3RLUGVucjd4enlSU2pOL3J1VERsUThTcDVCQnNBTHpk?=
 =?utf-8?B?eUNLdnM3bWxaZ1Z3anY4TGFlMnUzNDdzTExtL2lTUkx1dWY1aHV1a2tncjg2?=
 =?utf-8?B?WTJ3RytEYXRyeVlyMnpVLzRoS1ZvbHoxTllsUkpCSmdTWkhzYXpUdi9rL2Yr?=
 =?utf-8?B?RXpyOVZkdlpQQTZRaUVKajRFc3ZhdklNdk9RblhGNGZLOHBrT1JEcUJEL28r?=
 =?utf-8?B?OENOWkpFYysvaDZpaWhSQTliRVBzNk44dVBYeVFxUjhRU0k0citqOE5vZVV1?=
 =?utf-8?B?OWNkT1JrUXEwZFArdUpzU01zTU5OSVhtVnNFMmFVdUpMamp6OUhzNXJYQ0dJ?=
 =?utf-8?B?N3M1SUdYQ2IrWGVpalhQazRjMEpKelFSSGRVSEtibmpHZXREeU1VRmcvYU5K?=
 =?utf-8?B?YkNXVUhsQVNBTGRMYVlYeFNWZDl4MktKNTNlUGQyWWRZL2ZZOHF6K1hDZTBk?=
 =?utf-8?B?MmpVU3dWUHFUV3M3d0tXYU9za3dnb2lLemNOME85cUxZTEVtcVJ3TkFSWWxp?=
 =?utf-8?B?YnVSQUhRZmJKY3pCTS8yVTIxQW53NDNkVzFZdHBsMVFUQ1RmdFVFK0d5OUpm?=
 =?utf-8?B?VHNwK2RLZ253OTkyQld4RVN2S045MGhKSytydmFuZjdKdHBnZXFrcUE5VG5X?=
 =?utf-8?B?YmtvVWNDY3FsK3ltSythalNCd0Rjc3Q2TjlqL1prbzhwRUVLV3RRNXgyLzlB?=
 =?utf-8?B?QmJJSWh5dGJ4NVI4Yy9RMnRUeTN2S3ZlR1JOUmpWRUxkWFJGK011Y1FyY25K?=
 =?utf-8?B?MDlOR0VZSnpYV243ZGo4bVh0OVc5Z1RzZGZjRVFlL1BCTUU0MWNob3Fqbkcr?=
 =?utf-8?B?RnZ5WTJpUkIreWhkckRrdng0NEltTnI1RlN1NUMxSDdRMm9JK2w4RkN2Mit6?=
 =?utf-8?B?ejkveUxVamdZaThiaGVJNEVWTVl5dGlkQ0xOOUh2TUc3ZnJUSWN6L0R1Z1p6?=
 =?utf-8?B?VFIxcW5pZG0zdmpLU2YvK2YwaTNuSzdaRGVQdzNkVWo5NXVCeVRkbmtEODZq?=
 =?utf-8?B?dGxXOStrZE11QWw2NUkrNUxlaFFFSFM4NUpSQU1VUnBpY1JXU093cW03Z3ho?=
 =?utf-8?B?U0dyZm93SmpUdkk5TjZ4VEtJNlZ3dldGVG9QcW5OY1pvY2h6YTJVeVVYdllr?=
 =?utf-8?B?Vll0U2RVTS84QURmaVZEMkNSY3NuUG9zWm8vbzJtL2lUajY0Z3hBVU1hRkR6?=
 =?utf-8?B?YjZvT2FvbWVlQVpSMFFvbHNOczhrRk0vVnFKUStFa09QU0xjcldYVmN2aTl0?=
 =?utf-8?B?Uit4b1hTeHVVQ2VHQllqUUdyUjdmU2JlQU82Y3RDdnBZQ3JGYVdQVTZPVmdl?=
 =?utf-8?B?c3I2d08zSld1eUZ4L054UHI2QzJ4MHhyME1pOHJMelVCR0NveVRJMkk1citz?=
 =?utf-8?B?dURmb0xBUGdPTmNsSjNuWXJrc3pYY1FUNFd6SG5sck5qWE1ralExWnVsOWpv?=
 =?utf-8?B?QzBYNFVFcU5HME1HbW9uOEx6cnIvMm53RFdhWGRFQnBoMUtzVDBZQWlOT2hF?=
 =?utf-8?B?OFhxTm9aR1VBTEpRTEtubUFyNzBTUHdFOSsySW9xRVBGM0VYUUhhd2R3alc2?=
 =?utf-8?B?aEZOZ0c3NWpXK0JLWnhSNXVpaFFjdWYydW5HZHJvU3UvRXVaUUZSZnd0aUJp?=
 =?utf-8?B?dHdZUlNwaUdmRDZXSjdGZnBSa1krZEVoOTF2K2JOcVd1K2ZEMHhmSHd3RnZU?=
 =?utf-8?B?ZmtVNGVBU205WHFCV0dOQmhGdlFONUhFUEl4U0MvdlR1Y1BBNjh2cFRzNGJX?=
 =?utf-8?B?UGJaM1pDRjhZVXprQ2lYYWI0dDQ1amFBWkp1TmFnMEM5eC9FTEFRdVl6aFRt?=
 =?utf-8?B?dHlucEhKaENEZC9xV2xMWTlrbWNkR29OZHJ1cFNjaUVxR1dBZXNPaXpVa0th?=
 =?utf-8?B?SnFudFFIK3JITkg0NHNWTDRFRExmSEdtK0RXWVJaWDdNcEhTcTd0ejNHbGlh?=
 =?utf-8?B?Qmk0c2o0N3ZDeVlxaDFhcG1zd3Y5Y3R6NXIrZTNpUnU4ak92OXRiK3oxQzJC?=
 =?utf-8?Q?0VAQKgHMkTcBXAzAyZqfkaE=3D?=
X-OriginatorOrg: renesas.com
X-MS-Exchange-CrossTenant-Network-Message-Id: bfd256b1-bb8a-4c45-2772-08dac80fa814
X-MS-Exchange-CrossTenant-AuthSource: OSBPR01MB3894.jpnprd01.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Nov 2022 20:17:59.8647
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 53d82571-da19-47e4-9cb4-625a166a4a2a
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: fSEVlOGOGGRiYLbJx4xrjG6NceQkqth1aqxW4TX23b+USVI6dnz7XOBu3fekbOM9PMWf+SD43zIaZuVokAOoYR/LI7pxfjEr5PeAH68u+lA=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: OS3PR01MB9721
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham
        autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On 11/16/2022 1:50 AM, Krzysztof Kozlowski wrote:
> On 16/11/2022 00:37, Alex Helms wrote:
>> Add dt bindings for the Renesas ProXO oscillator.
>>
>> Signed-off-by: Alex Helms <alexander.helms.jy@renesas.com>
>> ---
>>  .../bindings/clock/renesas,proxo.yaml         | 51 +++++++++++++++++++
>>  MAINTAINERS                                   |  5 ++
>>  2 files changed, 56 insertions(+)
>>  create mode 100644 Documentation/devicetree/bindings/clock/renesas,proxo.yaml
>>
>> diff --git a/Documentation/devicetree/bindings/clock/renesas,proxo.yaml b/Documentation/devicetree/bindings/clock/renesas,proxo.yaml
>> new file mode 100644
>> index 000000000..ff960196d
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/clock/renesas,proxo.yaml
>> @@ -0,0 +1,51 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>> +%YAML 1.2
>> +---
>> +$id: https://jpn01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fdevicetree.org%2Fschemas%2Fclock%2Frenesas%2Cproxo.yaml%23&amp;data=05%7C01%7Calexander.helms.jy%40renesas.com%7C248dc84dbca44a4013d408dac7af9cf1%7C53d82571da1947e49cb4625a166a4a2a%7C0%7C0%7C638041854305996374%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&amp;sdata=iGbtWJLjV%2FM%2Fps0lPk7f40bMzX8qdt8VZBtH9J4LdOw%3D&amp;reserved=0
>> +$schema: https://jpn01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fdevicetree.org%2Fmeta-schemas%2Fcore.yaml%23&amp;data=05%7C01%7Calexander.helms.jy%40renesas.com%7C248dc84dbca44a4013d408dac7af9cf1%7C53d82571da1947e49cb4625a166a4a2a%7C0%7C0%7C638041854305996374%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&amp;sdata=zYh4aHuw6G6A35rXBD7FTKeFrC7Hfcxag60ghkKUaGA%3D&amp;reserved=0
>> +
>> +title: Renesas ProXO Oscillator Device Tree Bindings
> 
> Same comments as for your other patch. All the same...
> 
>> +
>> +maintainers:
>> +  - Alex Helms <alexander.helms.jy@renesas.com>
>> +
>> +description:
>> +  Renesas ProXO is a family of programmable ultra-low phase noise
>> +  quartz-based oscillators.
>> +
>> +properties:
>> +  '#clock-cells':
>> +    const: 0
>> +
>> +  compatible:
>> +    enum:
>> +      - renesas,proxo-xp
>> +
>> +  reg:
>> +    maxItems: 1
>> +
>> +  clock-output-names:
>> +    maxItems: 1
>> +
>> +  renesas,crystal-frequency-hz:
>> +    description: Internal crystal frequency, default is 50000000 (50MHz)
> 
> If it is internal, then it is fixed, right? Embedded in the chip, always
> the same. Why do you need to specify it?
> 

Yes, it is embedded in the package but there are different values
depending on what chip is ordered and therefore must be specified for
some configurations.

I'm also not sure what you mean by me ignoring Rob's comment. I
explained my case for calling it "crystal-frequency-hz" and moved
forward. I can call it "clock-frequency" if you want but I find that
more confusing. Yes it is a built-in name in the schema but it seems to
be used in a variety of ways. Some devices use it as a crystal input,
but most seem to use it as the desired output frequency of the device
which is not how it is used here. Therefore I chose a more clear name
that better reflects what it is doing.

> 
> Best regards,
> Krzysztof
>