diff mbox series

[2/2] ARM: at91: dts: at91-sama5d2_xplained: Add comments for sama5d29

Message ID 20210812140758.28273-2-Hari.PrasathGE@microchip.com (mailing list archive)
State New, archived
Headers show
Series [1/2] ARM: at91: dts: sama5d29: Add dtsi file for sama5d29 | expand

Commit Message

Hari Prasath Gujulan Elango Aug. 12, 2021, 2:07 p.m. UTC
Add comments for the end user for modifying the DTS file for
instantiating the sama5d29 SoC.

Signed-off-by: Hari Prasath <Hari.PrasathGE@microchip.com>
---
 arch/arm/boot/dts/at91-sama5d2_xplained.dts | 5 +++++
 1 file changed, 5 insertions(+)

Comments

Alexandre Belloni Aug. 12, 2021, 7:26 p.m. UTC | #1
Hello,

On 12/08/2021 19:37:58+0530, Hari Prasath wrote:
> Add comments for the end user for modifying the DTS file for
> instantiating the sama5d29 SoC.
> 
> Signed-off-by: Hari Prasath <Hari.PrasathGE@microchip.com>
> ---
>  arch/arm/boot/dts/at91-sama5d2_xplained.dts | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/arch/arm/boot/dts/at91-sama5d2_xplained.dts b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
> index 627b7bf88d83..faa30063d9a9 100644
> --- a/arch/arm/boot/dts/at91-sama5d2_xplained.dts
> +++ b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
> @@ -6,6 +6,11 @@
>   *                2015 Nicolas Ferre <nicolas.ferre@atmel.com>
>   */
>  /dts-v1/;
> +/*
> + * Replace the line below with "sama5d29.dtsi" in order to instantiate the
> + * sama5d29 SoC of the sama5d2 family.Otherwise, leave it unchanged when
> + * using sama5d27 SoC for instance.
> + */

I guess it would be better to have a at91-sama5d29_xplained.dts (and we
should have had a at91-sama5d27_xplained.dts), else, you can't create an
image that will support both variants.
Hari Prasath Gujulan Elango Aug. 19, 2021, 10:56 a.m. UTC | #2
Hello,

On 13/08/21 12:56 am, Alexandre Belloni wrote:
> EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe
> 
> Hello,
> 
> On 12/08/2021 19:37:58+0530, Hari Prasath wrote:
>> Add comments for the end user for modifying the DTS file for
>> instantiating the sama5d29 SoC.
>>
>> Signed-off-by: Hari Prasath <Hari.PrasathGE@microchip.com>
>> ---
>>   arch/arm/boot/dts/at91-sama5d2_xplained.dts | 5 +++++
>>   1 file changed, 5 insertions(+)
>>
>> diff --git a/arch/arm/boot/dts/at91-sama5d2_xplained.dts b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
>> index 627b7bf88d83..faa30063d9a9 100644
>> --- a/arch/arm/boot/dts/at91-sama5d2_xplained.dts
>> +++ b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
>> @@ -6,6 +6,11 @@
>>    *                2015 Nicolas Ferre <nicolas.ferre@atmel.com>
>>    */
>>   /dts-v1/;
>> +/*
>> + * Replace the line below with "sama5d29.dtsi" in order to instantiate the
>> + * sama5d29 SoC of the sama5d2 family.Otherwise, leave it unchanged when
>> + * using sama5d27 SoC for instance.
>> + */
> 
> I guess it would be better to have a at91-sama5d29_xplained.dts (and we
> should have had a at91-sama5d27_xplained.dts), else, you can't create an
> image that will support both variants.
> 
> 
The new SoC 'sama5d29' belongs to the same sama5d2 family. It is 
essentially a new chip revision of the existing sama5d27 with a new GMAC 
controller IP that addresses few silicon issues. There wouldn't be 
separate evaluation boards that shall be made but we will be using the 
existing sama5d2 XPlained boards itself but with the new SoC populated. 
Hence we have taken this approach of having a separate DTSI file and 
reuse the existing board specific DTS file.

We don't want to create single image that will support both variants. In 
fact, we don't want our customers to enable certain features that are 
broken at the silicon level in the existing revision of the SoC i.e 
sama5d27. Instead, they could do this change manually and use it in the 
new SoC i.e sama5d29.

Regards,
Hari

> --
> Alexandre Belloni, co-owner and COO, Bootlin
> Embedded Linux and Kernel engineering
> https://bootlin.com
>
Alexandre Belloni Aug. 19, 2021, 11:20 a.m. UTC | #3
On 19/08/2021 10:56:21+0000, Hari.PrasathGE@microchip.com wrote:
> Hello,
> 
> On 13/08/21 12:56 am, Alexandre Belloni wrote:
> > EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe
> > 
> > Hello,
> > 
> > On 12/08/2021 19:37:58+0530, Hari Prasath wrote:
> >> Add comments for the end user for modifying the DTS file for
> >> instantiating the sama5d29 SoC.
> >>
> >> Signed-off-by: Hari Prasath <Hari.PrasathGE@microchip.com>
> >> ---
> >>   arch/arm/boot/dts/at91-sama5d2_xplained.dts | 5 +++++
> >>   1 file changed, 5 insertions(+)
> >>
> >> diff --git a/arch/arm/boot/dts/at91-sama5d2_xplained.dts b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
> >> index 627b7bf88d83..faa30063d9a9 100644
> >> --- a/arch/arm/boot/dts/at91-sama5d2_xplained.dts
> >> +++ b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
> >> @@ -6,6 +6,11 @@
> >>    *                2015 Nicolas Ferre <nicolas.ferre@atmel.com>
> >>    */
> >>   /dts-v1/;
> >> +/*
> >> + * Replace the line below with "sama5d29.dtsi" in order to instantiate the
> >> + * sama5d29 SoC of the sama5d2 family.Otherwise, leave it unchanged when
> >> + * using sama5d27 SoC for instance.
> >> + */
> > 
> > I guess it would be better to have a at91-sama5d29_xplained.dts (and we
> > should have had a at91-sama5d27_xplained.dts), else, you can't create an
> > image that will support both variants.
> > 
> > 
> The new SoC 'sama5d29' belongs to the same sama5d2 family. It is 
> essentially a new chip revision of the existing sama5d27 with a new GMAC 
> controller IP that addresses few silicon issues. There wouldn't be 
> separate evaluation boards that shall be made but we will be using the 
> existing sama5d2 XPlained boards itself but with the new SoC populated. 

That's what I understood but a board with a different SoC is a
different board.

> Hence we have taken this approach of having a separate DTSI file and 
> reuse the existing board specific DTS file.
> 
> We don't want to create single image that will support both variants. In 
> fact, we don't want our customers to enable certain features that are 
> broken at the silicon level in the existing revision of the SoC i.e 
> sama5d27. Instead, they could do this change manually and use it in the 
> new SoC i.e sama5d29.
> 

This will be confusing to your customers while you could make their
lives simpler by having the bootloader chose the proper dtb instead of
having them change that manually. They will then have to regenerate
images with that change, see how your customers struggle to do that:

https://stackoverflow.com/questions/68222619/update-custom-device-tree-on-yocto
https://stackoverflow.com/questions/37347808/how-to-use-an-own-device-tree-and-modified-kernel-config-in-yocto
https://stackoverflow.com/questions/63047955/overriding-defconfig-in-bbappend-file
Nicolas Ferre Sept. 21, 2021, 9:44 a.m. UTC | #4
On 19/08/2021 at 13:20, Alexandre Belloni wrote:
> On 19/08/2021 10:56:21+0000, Hari.PrasathGE@microchip.com wrote:
>> Hello,
>>
>> On 13/08/21 12:56 am, Alexandre Belloni wrote:
>>> Hello,
>>>
>>> On 12/08/2021 19:37:58+0530, Hari Prasath wrote:
>>>> Add comments for the end user for modifying the DTS file for
>>>> instantiating the sama5d29 SoC.
>>>>
>>>> Signed-off-by: Hari Prasath <Hari.PrasathGE@microchip.com>
>>>> ---
>>>>    arch/arm/boot/dts/at91-sama5d2_xplained.dts | 5 +++++
>>>>    1 file changed, 5 insertions(+)
>>>>
>>>> diff --git a/arch/arm/boot/dts/at91-sama5d2_xplained.dts b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
>>>> index 627b7bf88d83..faa30063d9a9 100644
>>>> --- a/arch/arm/boot/dts/at91-sama5d2_xplained.dts
>>>> +++ b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
>>>> @@ -6,6 +6,11 @@
>>>>     *                2015 Nicolas Ferre <nicolas.ferre@atmel.com>
>>>>     */
>>>>    /dts-v1/;
>>>> +/*
>>>> + * Replace the line below with "sama5d29.dtsi" in order to instantiate the
>>>> + * sama5d29 SoC of the sama5d2 family.Otherwise, leave it unchanged when
>>>> + * using sama5d27 SoC for instance.
>>>> + */
>>>
>>> I guess it would be better to have a at91-sama5d29_xplained.dts (and we
>>> should have had a at91-sama5d27_xplained.dts), else, you can't create an
>>> image that will support both variants.
>>>
>>>
>> The new SoC 'sama5d29' belongs to the same sama5d2 family. It is
>> essentially a new chip revision of the existing sama5d27 with a new GMAC
>> controller IP that addresses few silicon issues. There wouldn't be
>> separate evaluation boards that shall be made but we will be using the
>> existing sama5d2 XPlained boards itself but with the new SoC populated.
> 
> That's what I understood but a board with a different SoC is a
> different board.

The problem that we have right now is that the official board sama5d2 
Xplained will never be officially released with a sama5d29 SoC. There's 
basically no available board with this chip.

We added this "hint" as a comment to our historical board but it's true 
that it might be confusing.

For now, I'm taking only the first patch of the series. If the need 
arise, we'll create the proper board DTS file.

>> Hence we have taken this approach of having a separate DTSI file and
>> reuse the existing board specific DTS file.
>>
>> We don't want to create single image that will support both variants. In
>> fact, we don't want our customers to enable certain features that are
>> broken at the silicon level in the existing revision of the SoC i.e
>> sama5d27. Instead, they could do this change manually and use it in the
>> new SoC i.e sama5d29.
>>
> 
> This will be confusing to your customers while you could make their
> lives simpler by having the bootloader chose the proper dtb instead of
> having them change that manually. They will then have to regenerate
> images with that change, see how your customers struggle to do that:
> 
> https://stackoverflow.com/questions/68222619/update-custom-device-tree-on-yocto
> https://stackoverflow.com/questions/37347808/how-to-use-an-own-device-tree-and-modified-kernel-config-in-yocto
> https://stackoverflow.com/questions/63047955/overriding-defconfig-in-bbappend-file
Yes, understood. The intention was not to create another different board 
but to give a hint, should customer replace themselves the SoC on 
official sama5d2 xplained board (like we did internally). Use case is 
probably so unlikely that we might just forget about it (for now at least).

Best regards,
   Nicolas
diff mbox series

Patch

diff --git a/arch/arm/boot/dts/at91-sama5d2_xplained.dts b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
index 627b7bf88d83..faa30063d9a9 100644
--- a/arch/arm/boot/dts/at91-sama5d2_xplained.dts
+++ b/arch/arm/boot/dts/at91-sama5d2_xplained.dts
@@ -6,6 +6,11 @@ 
  *                2015 Nicolas Ferre <nicolas.ferre@atmel.com>
  */
 /dts-v1/;
+/*
+ * Replace the line below with "sama5d29.dtsi" in order to instantiate the
+ * sama5d29 SoC of the sama5d2 family.Otherwise, leave it unchanged when
+ * using sama5d27 SoC for instance.
+ */
 #include "sama5d2.dtsi"
 #include "sama5d2-pinfunc.h"
 #include <dt-bindings/mfd/atmel-flexcom.h>