Received-SPF: pass (google.com: domain of linux-kernel+bounces-157302-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161;
Message-ID: <c11194fb-0449-4b36-adf1-c15d7a66344d@blaize.com>
Date: Wed, 24 Apr 2024 17:14:18 +0100
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH v2 4/7] dt-bindings: clock: Add binding constants for
 BLZP1600
To: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>,
        "linux-arm-kernel@lists.infradead.org"
 <linux-arm-kernel@lists.infradead.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>
Cc: James Cowgill <james.cowgill@blaize.com>,
        Matt Redfearn <matthew.redfearn@blaize.com>,
        Neil Jones <neil.jones@blaize.com>,
        Michael Turquette <mturquette@baylibre.com>,
        Stephen Boyd
 <sboyd@kernel.org>, Rob Herring <robh@kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        Conor Dooley <conor+dt@kernel.org>,
        "linux-clk@vger.kernel.org" <linux-clk@vger.kernel.org>,
        "devicetree@vger.kernel.org" <devicetree@vger.kernel.org>
References: <20240424133241.19210-1-nikolaos.pasaloukos@blaize.com>
 <fd4072dc-7cd3-4d13-a15b-d63c675a5994@linaro.org>
Content-Language: en-GB
From: Nikolaos Pasaloukos <nikolaos.pasaloukos@blaize.com>
In-Reply-To: <fd4072dc-7cd3-4d13-a15b-d63c675a5994@linaro.org>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: 
	=?utf-8?B?ZUJYM2s2UnZaNVhrMVprbzgrUWRHRHkzRW9ieEJ5ZDJzWmU2SnNjTzlucVd6?=
 =?utf-8?B?N0pzMll4cWxhSmlFenFXSW55dnluelcvVDk0WHJVQkpWRk5zbzQwRGRsS1Fk?=
 =?utf-8?B?YVd4NTBSbVpFcWFiUnBEWGY0empCZXBiZHZKcWl1aGZPQTA3Nk1UdUN0T1hO?=
 =?utf-8?B?WGNXOGN0YWR2WllVYWcrN3ZHbm9wZExYM3Y0aGwrejBMeld5bnlTNmMwUW9H?=
 =?utf-8?B?ZnhZNmVpcXFUWFVXM1pKL0swY3VFTWtrSC9mU1FGY05UWXRDajNIN240Wk5R?=
 =?utf-8?B?QW0vSk5HdHd4MmQ4NDBiZzJvWmxlK2grdkVsekIzVXBTYUoxVUZnbzgxQXlZ?=
 =?utf-8?B?ZHgwUDk0ZXdxRzRnM3JoSVVkaTVDaTZpU3ZITUU2bi8vL3RMblZxSVRBTFBM?=
 =?utf-8?B?cUNjQmU2dHlXd1puUXpqaGlQdVEzNW9ueWdqZFh4cTA4YVluK0UzUW9TenE1?=
 =?utf-8?B?enVnRDQ2QlBlbS9ITEZUUEZQQTBqbGdEODZVTHRoZER4WEx4ckVCd2ZFNjE3?=
 =?utf-8?B?eDdLenVwZlhHOFRqVTM1Z0ljVDZQSGNaeTZobm1RTGYvSjIyanZUTTlYend0?=
 =?utf-8?B?V1paVzhQTDJRZUlxTTB5aTFITmZHbEx0L2k4WW1RVHU1TkFNQ2xqaGtEOHpY?=
 =?utf-8?B?ekh5QjdUc1NxaXR5N1V5NHdjRHpLTndCbU8yWTR4Qi9NZlplY3k4Ky9Qd1cw?=
 =?utf-8?B?TjkreDJXS2Z0TlZZOTlGSW9mMzJsMzBOc2QyYkhobGRHS0FrM0pZTkpTOEFy?=
 =?utf-8?B?WmVlem42VUhYVXlJelJINTdvbDJYN1ladk1CQW9EYmNYcThLeFIwbEt1S0Fz?=
 =?utf-8?B?d3prOEVHck5mRG12WlA3TmczelZWRmE3QWNzbW5oMVdyZXRGMTdCSVlEMXRq?=
 =?utf-8?B?S1o2c0R5MnhoU3IydHk3R2dNbUZaY2tHQzg5NU1HLzA5dDFNQUR0WUN3WUNl?=
 =?utf-8?B?anVFUmk0ZWdJTi9zN1B0ZkFpUnNYSVhxTEtFWWJCeE9VMmFaRVg5cHIwSU9Z?=
 =?utf-8?B?M1V3a2tUR1hTSVoxMVdTMG5qUlo1UTlxdmZiT0M1aE1mQlRSUjg1eUo1bkdW?=
 =?utf-8?B?UHlhckFkUFVWVllGVzZERlBwM1JPQ2FoSVFLay9MTkpLV3JpbmRLN3pNa2g2?=
 =?utf-8?B?RlhOOE12bHNRRVdTSTNCTlhJRVVDWXBTOTAvL3JDYUNSTC9MV28rc3p4L2o5?=
 =?utf-8?B?ZmIyVUh5R29tb1Y3bkxBWFIxS3NKUHhrM0I3NDZ2YUgwakh1cTM3V0FYV0tV?=
 =?utf-8?B?ZStkSmt0RFlwK3JkM2I2TFNRWWYxeGZLWFVWR3ZTZEpEcTZsdnNUbytLNVI3?=
 =?utf-8?B?OFVmOHdRZ2lmMWdDaytVUWNvd0UvTXA3NTZCZC96R0RNNU03cExZYk1rVjh4?=
 =?utf-8?B?MmVWcUM1eDBNYm9uWnYrdWVjTjlBYjRWZUJwc05OWFNkQ1NHNExudE5xZ3lp?=
 =?utf-8?B?T3NwelZScUZndEtoVWJCSHVUbVRRUE8zNXJCZm5CaGtLQ0VKUytjOWV3T1hz?=
 =?utf-8?B?ODJIV2MxRllUa0VCVHJUQWp6RzYxNUtTSTFyRkhkTVR6eVMwakE4dkdXZU05?=
 =?utf-8?B?ejZ6TnhnK3JVaGdHeGJqWXVWZzhWL0lMMEtEOUR5c2xIeE1JY0hKZW9HdXhy?=
 =?utf-8?B?U1lXODVybG54YU9jVmsvY0dQam5rUm5KV3JpN2NmRFJ3dXBtNXpMRFVRa3Zj?=
 =?utf-8?B?c1RuN2VzZjFlVGNZeXN2aUViYVBHRnZvZ0poWTZIakVlSWc1S3VXdGFNc1JN?=
 =?utf-8?B?MlJ4dXM4Z3JPWlNJbGRxTk5zc1BOQ2tMdXNWQ2RiNzl6d2E3OE0zMDJWSGgx?=
 =?utf-8?B?N2JDUkRSOGsyNXhiZy8vTzFHWndER1oyOU9YTUFnaVd4RGxheDRtWTRiSytC?=
 =?utf-8?B?azRhYm5wRGREbjVxRUROTjVGakp6OG4yWERFUjBsVGd5ekFtQTMvRGlPblh2?=
 =?utf-8?B?VGZnZEtMZFZXNThCdHZIYWdmdE91QmpzNlpWTE50Q0p2RTRXMG50QWpzc1FY?=
 =?utf-8?B?TnZqSEFUdkZCV2hMSGszNllvbG1VWHVlMWc2R3dIejdIcnZpZFdMSEVqcnZr?=
 =?utf-8?B?bkFoK0dRWHpwYXJNaTNoWUhoRUJtVm82VTB4YUtYbm8yQ2JJZ0pYYW9jMGc5?=
 =?utf-8?B?bEVzT1JLZXpZandnbmN1RnNPUTh1akFIV3J6Q1pDVEZseldjYUpjWjdhUDRD?=
 =?utf-8?B?MnlIcFZFY2c1NmxvUzFSSlowdG50OCtqdmFKVW5xaVMrOWd2aFYxdEdQVmNz?=
 =?utf-8?Q?APdWyqmgEjXyaWNGspttO7fJkZSiLm2bvSVJkfpWpg=3D?=
X-OriginatorOrg: blaize.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 46b3cc8a-7d37-4d91-4d57-08dc64799dbc
X-MS-Exchange-CrossTenant-AuthSource: MA0PR01MB10184.INDPRD01.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Apr 2024 16:14:28.3377
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 9d1c3c89-8615-4064-88a7-bb1a8537c779
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: 70EKtsorjoB73ABbQVKkOQis74K0LLRupBomM4trruYmcIRgTr3atM8yFGrH4cFN7jsy7Xsegjtnjta9vtibFQ6C3j/Po54m1JkyFnC0e3c=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PN0PR01MB7749
X-Proofpoint-GUID: 2dVSPvehlK-UbKppdgQv9AeWVk7oZ0Mi
X-Proofpoint-ORIG-GUID: 2dVSPvehlK-UbKppdgQv9AeWVk7oZ0Mi
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.293,Aquarius:18.0.1011,Hydra:6.0.650,FMLib:17.11.176.26
 definitions=2024-04-24_13,2024-04-24_01,2023-05-22_02
X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501
 phishscore=0 adultscore=0 mlxscore=0 lowpriorityscore=0 suspectscore=0
 spamscore=0 bulkscore=0 mlxlogscore=982 malwarescore=0 clxscore=1015
 impostorscore=0 classifier=spam adjust=0 reason=mlx scancount=1
 engine=8.21.0-2404010002 definitions=main-2404240066

On 24/04/2024 15:13, Krzysztof Kozlowski wrote:
> On 24/04/2024 15:32, Niko Pasaloukos wrote:
>> Add SCMI clock numbers according to the Blaize BLZP1600
>> SoC hardware specifications.
>>
>> Reviewed-by: James Cowgill <james.cowgill@blaize.com>
>> Reviewed-by: Matt Redfearn <matt.redfearn@blaize.com>
>> Reviewed-by: Neil Jones <neil.jones@blaize.com>
>> Signed-off-by: Nikolaos Pasaloukos <nikolaos.pasaloukos@blaize.com>
> This goes to the patch introducing binding doc.

Apologies for the broken threading.

>
>> ---
>>  .../dt-bindings/clock/blaize,blzp1600-clk.h   | 77 +++++++++++++++++++
>>  1 file changed, 77 insertions(+)
>>  create mode 100644 include/dt-bindings/clock/blaize,blzp1600-clk.h
>>
>> diff --git a/include/dt-bindings/clock/blaize,blzp1600-clk.h b/include/dt-bindings/clock/blaize,blzp1600-clk.h
>> new file mode 100644
>> index 000000000000..f1d59849a6e5
>> --- /dev/null
>> +++ b/include/dt-bindings/clock/blaize,blzp1600-clk.h
>> @@ -0,0 +1,77 @@
>> +/* SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause */
>> +/*
>> + * Copyright (C) 2023, Blaize, Inc.
>> + */
>> +
>> +#ifndef DT_BINDING_CLK_BLZP1600_H
>> +#define DT_BINDING_CLK_BLZP1600_H
>> +
>> +/* ARM SCMI clocks */
>> +
>> +/* BLZP1600 clock-gate numbers as defined in the hardware architecture */
>> +
>> +#define BLZP1600_CPU_CLK 0
>> +/* clock-gates 1-6 invalid */
> No, they cannot be invalid. IDs start from 0 and are incremented by one.
> If you have holes, it is not a binding.
>
> Drop the header or use it properly, so as virtual IDs.
>
> Best regards,
> Krzysztof
>
My intention was to avoid using magic numbers on the DeviceTree. That's why I added them here.
Also, we have some custom drivers which we plan to upload and their schemas need those files.
The alternative would be to use magic numbers for our clocks and resets.

In the commit message and on the header file I have mentioned that these are numbers matching
the hardware specification (1 to 1) of the chip not just enums.
Some IDs are invalid because of a hardware gap, some others are invalid because the SCMI
service will return an error that the number is invalid.

Is there another way to prevent the magic numbers in the schemas and device-tree.

Thank you very much for your fast and detailed review.

Best regards,
Niko