Re: [PATCH v13 1/2] dt-bindings: clock: add loongson-2 boot clock index
From: zhuyinbo
Date: Thu Mar 09 2023 - 07:44:13 EST
在 2023/3/9 下午2:25, Krzysztof Kozlowski 写道:
On 09/03/2023 02:43, zhuyinbo wrote:
在 2023/3/8 下午6:38, Krzysztof Kozlowski 写道:
On 08/03/2023 10:24, zhuyinbo wrote:
That's an ABI break and commit msg does not explain it.
you meaning is that need add a explanation in commit msg that why
You need good explanation to break the ABI. I don't understand the
commit msg, but anyway I could not find there justification for ABI
break. If you do not have good justification, don't break the ABI,
The commit msg is the patch commit log, and I maybe not got it about
break the ABI. You said about "break the ABI"
is whether is location issue about "LOONGSON2_BOOT_CLK"? if yes, the
LOONGSON2_BOOT_CLK was placed
after LOONGSON2_PIX1_PLL that is due to their clock parent is same.
and I whether need add this explanation
in patch commit log description?
Unfortunately I do not understand single thing from this.
Best regards,
Krzysztof
The patch commit log description is patch desription. as follows:
commit 592bc2b4106d787ea166ba16bfde6b3101ab1a8a
Author: Yinbo Zhu <zhuyinbo@xxxxxxxxxxx>
Date: Tue Mar 7 17:18:32 2023 +0800
dt-bindings: clock: add loongson-2 boot clock index
The Loongson-2 boot clock was used to spi and lio peripheral and
this patch was to add boot clock index number.
I cannot understand this either.
I will rework commit msg .
and your advice is "That's an ABI break and commit msg does not explain it."
I got it from your advice that was to add a explanation about
LOONGSON2_BOOT_CLK's
location issue in patch description, right?
ABI break needs justification, why do you think it is fine or who
is/isn't affected etc. Your commit msg does not explain why ABI break is
okay. It doesn't even explain to me why you need it.
#define LOONGSON2_DC_PLL 3
#define LOONGSON2_PIX0_PLL 4
#define LOONGSON2_PIX1_PLL 5
-#define LOONGSON2_NODE_CLK 6
-#define LOONGSON2_HDA_CLK 7
-#define LOONGSON2_GPU_CLK 8
-#define LOONGSON2_DDR_CLK 9
-#define LOONGSON2_GMAC_CLK 10
-#define LOONGSON2_DC_CLK 11
-#define LOONGSON2_APB_CLK 12
-#define LOONGSON2_USB_CLK 13
-#define LOONGSON2_SATA_CLK 14
-#define LOONGSON2_PIX0_CLK 15
-#define LOONGSON2_PIX1_CLK 16
-#define LOONGSON2_CLK_END 17
+#define LOONGSON2_BOOT_CLK 6
+#define LOONGSON2_NODE_CLK 7
after add my patch, if dts still use above macro and not cause any
issue. but
if dts not use macro rather than use original clk number index that will
cause a uncorrect clk,
eg.
-#define LOONGSON2_NODE_CLK 6
+#define LOONGSON2_NODE_CLK 7
this issue is that what you said about "ABI break", isn't it ?
About your advice and question and I will use following description as
patch commit msg, what do you think?
dt-bindings: clock: add loongson-2 boot clock index
The spi need to use boot clock and this patch is to add a boot clock
index about LOONGSON2_BOOT_CLK
and the LOONGSON2_BOOT_CLK was placed in after LOONGSON2_PIX1_PLL that
due to
LOONGSON2_PIX1_PLL, LOONGSON2_PIX0_PLL , LOONGSON2_DC_PLL and
LOONGSON2_BOOT_CLK
has same parent clock. In addition, the Loongson code of the community
is still in the development stage,
so this patch modification will not cause uncorrect clk quote issue at
present.
Best regards,
Krzysztof