Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:3 as permitted sender) client-ip=2620:137:e000::3:3;
Message-ID: <cd1e8583-67a5-4b50-b1bb-304d14d3c170@amd.com>
Date:   Fri, 6 Oct 2023 13:24:06 -0500
User-Agent: Mozilla Thunderbird
Subject: Re: [PATCH 1/2] dt-bindings: zynqmp: add destination mailbox
 compatible
Content-Language: en-US
To:     Rob Herring <robh@kernel.org>
Cc:     jassisinghbrar@gmail.com, krzysztof.kozlowski+dt@linaro.org,
        conor+dt@kernel.org, michal.simek@amd.com,
        shubhrajyoti.datta@amd.com, linux-kernel@vger.kernel.org,
        devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org
References: <20231005170825.3521669-1-tanmay.shah@amd.com>
 <20231006175348.GA4076821-robh@kernel.org>
From:   Tanmay Shah <tanmay.shah@amd.com>
In-Reply-To: <20231006175348.GA4076821-robh@kernel.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?M2tPUHZDcU9ycnBCUnF2WkpmeW5GYW9haHBwUVdOWG9LYm92alV5UTBVUFN0?=
 =?utf-8?B?WGlCWlRjNU1BNjYvMUtGM1c2WFNycWdHcU1FbURMaFpwdnBwZlhrY1BKZ01O?=
 =?utf-8?B?QWtOcUNmenU2S01Mc0FpSTRWbXgzRDBnSXh1OWduZUdRNnRlamZqcjJrek95?=
 =?utf-8?B?a0wyeW92cEJKZFd0aVJYTStVQ3psWTNJbHp0ZTVpZXplK0tsWkp4bDhxUXJ2?=
 =?utf-8?B?ZGIvZm14amg3RGp1R2R4TFpub0Z1MWorNFZTU0t4NTFwcWZFcCtPc0dLV1Ay?=
 =?utf-8?B?QklFYktOaE1PZ0k4Z01xM3NhMnFrb2hwZTlWRGY4MUpFRHFRdmE0bFMwWUVy?=
 =?utf-8?B?TGRJTXRLeG1JMTBKczdtOE5tMHlJTkZUK25LWFI4a1RLY0s3KzFwV3F0aFpW?=
 =?utf-8?B?OHJ1UGltZG45WFpoVjY1K29kOHduclhqUVN1OVFLYUVSWDY1clJ1ZVZreVBy?=
 =?utf-8?B?aDdLVmpXRWM2a1h2am9ZSm9jUnhlbnhmVVMzd0MxZnpNalE2bHRSQWQ5YTl4?=
 =?utf-8?B?OWJ6Y1FhM3JpcUgyM0pxUm54U2ppQmo2ZGw3czQ3NFQ1VzVWaFFQOHZzU21L?=
 =?utf-8?B?VGFBWDNXTjhiQ1czL0dxL0tqSHVRdEd5WHdvU2xyYk42ZWFIdkJXeVd0WVpG?=
 =?utf-8?B?T3dkTmQ1cHdmamZaTWV2T3VoK2lGU2ZLL24vL2dzL1dIa0ExaXc3aWJDOWNt?=
 =?utf-8?B?bXRjRjNBekVKbUVJRmlTNG80bXF4ZXcxVmVHaWx5S3FvLzEvYm92TG0yTS9v?=
 =?utf-8?B?Zm5SZWV4UTNzclJVTlBVcHZlcUNwcjdlbDNueHFkcTVuQUZpVEtLRHNaYnlj?=
 =?utf-8?B?bklJTzFLQTlPbWFNai9IczRlQ1VKbWtxeFVnbEwzUmJ5bE5oRUhGYUxTUzhF?=
 =?utf-8?B?bWNzSmtiZGlWRHZXOSsrWTZXL21vNi9wWVhaV25KdXE3eWNPcDVQNHpOakJV?=
 =?utf-8?B?WUhtMHhjVjJCRDhVdE5uWGJWTHl2ZitHeFhzUEZtajNBSE15cHVjbWx4TzBR?=
 =?utf-8?B?UXYwekJLRllPRmdxUGNqUWVxSWRYdkhNQ250Z3dUbXprcllsV2NlOXhZb2cw?=
 =?utf-8?B?b3VyOW5MbXhrdTVGZm4xTlljY2F0UlRzMjZndnZpYlNTSDVzOWgzSVFycUJP?=
 =?utf-8?B?dzRyL3MwemhKQmEzRXNDZ1dFOHI1OE54Q3NySE1xVXJjUHo5R0dFdHd5OVJ2?=
 =?utf-8?B?MytCdFpJOFVCRXVFU25qb1VqMFU0QkwxU2IwZ3ZaVi80K24zOEdTdHRiMlVa?=
 =?utf-8?B?QW40UkszUDFZMCtNMjNPY2hrQU1NQzFGWGpJU0JpWkl5b1JCcmc1UVlTVi9K?=
 =?utf-8?B?OUxPU0dzem9uaHNCNGpOUTZucjRqSGVOSkdQQ1FDckptWkg4M0FueSt3N2Rr?=
 =?utf-8?B?MHNWcmNITWFnTml2dmlVc1ljZ1dmc2d6VVBHTDVyMnhuQXdiSjFzUFdRR1Qr?=
 =?utf-8?B?V1g3ZGx5c1d2bXJ2c0lWRUpDb2sreXhyZ3gzN1U4RFYxOEFqZFRnT0RZbGZQ?=
 =?utf-8?B?NXV1R05STDYvc3FZdThINlNyaU5UK2VSSTBvRllrcGRhUEZDV1VmMnF0aGZm?=
 =?utf-8?B?UUtOMGo2MGNxZDhWM3V5S3h2em5KUXBzK3VBanhteGxINVhVeVNHWERQeUZH?=
 =?utf-8?B?RmFXdDJMYmc5WHdSUzZpZ1NLL05vRE1ZUjJWU0pSMjhGY1lXeDhoQ0NYNEdL?=
 =?utf-8?B?aFY0ZnYzV0tyWHFJa1MwMTZVTDdZL3hHZGQvUjhiSE40d01kK0Q3Z095cWZF?=
 =?utf-8?B?Mm9pdTVTaGIwM3B0RUZUekNJRGlsMlZGRWFqWFJtaXJmNHhQZ3Uvdzk5K3ZE?=
 =?utf-8?B?eGtmaE9UdDRuUXRPVUcrS3NWMktuWlNrc1N1RzhTcEQ3REVVRnJSNVlVdEhm?=
 =?utf-8?B?YnN5U1pFU1cyVWVMRzQyVXNCb2s3ODdQLy9yR2xSc21WR0RodXl3RjB1NXhL?=
 =?utf-8?B?TDBmNVZ3YVBkNHdpTlJIUDd5UzBLOXRGSUZTeHFKZGJ3cloyRDV0VzAzd2U0?=
 =?utf-8?B?ckF3NFBSeHBSVWJZUmFPdUc1R05EMFduOGkxTERDdW81NnlmUXNtZm83aHpV?=
 =?utf-8?B?T25JOTFCRWtUYSt5ZWYwZElLUHdPOUkzbHloUGFWTFRaNmpIZmR6ajdvVGlr?=
 =?utf-8?Q?PlvIFr4zisY/MBwME1s49ojlA?=
X-OriginatorOrg: amd.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 27f8dc21-dafc-409d-6938-08dbc6996e54
X-MS-Exchange-CrossTenant-AuthSource: BY5PR12MB3683.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Oct 2023 18:24:09.1125
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: UcocV7HnSnEKHC337tNzaY/PZF4YZwO16WoCIwLoQswxKbrDx/L0+dBSH2fq+YY2
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR12MB8612
X-Spam-Status: No, score=2.7 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED,
	DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,
	MAILING_LIST_MULTI,RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no
	autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lipwig.vger.email
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (lipwig.vger.email [0.0.0.0]); Fri, 06 Oct 2023 11:24:27 -0700 (PDT)
X-Spam-Level: **


On 10/6/23 12:53 PM, Rob Herring wrote:
> On Thu, Oct 05, 2023 at 10:08:24AM -0700, Tanmay Shah wrote:
> > Current dt-bindings does not contain compatible property
> > for child mailbox node. Child mailbox nodes are used
> > to represent destination (remote) IPI agents. The compatible
> > property for all destination mailboxes must be required.
> > 
> > Signed-off-by: Tanmay Shah <tanmay.shah@amd.com>
> > ---
> >  .../bindings/mailbox/xlnx,zynqmp-ipi-mailbox.yaml           | 6 ++++++
> >  1 file changed, 6 insertions(+)
> > 
> > diff --git a/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.yaml b/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.yaml
> > index aeaddbf574b0..8b15a0532120 100644
> > --- a/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.yaml
> > +++ b/Documentation/devicetree/bindings/mailbox/xlnx,zynqmp-ipi-mailbox.yaml
> > @@ -74,6 +74,10 @@ patternProperties:
> >      type: object  # DT nodes are json objects
> >      additionalProperties: false
> >      properties:
> > +
> > +      compatible:
> > +        const: xlnx,zynqmp-ipi-dest-mailbox
> > +
> >        xlnx,ipi-id:
> >          description:
> >            Remote Xilinx IPI agent ID of which the mailbox is connected to.
> > @@ -95,6 +99,7 @@ patternProperties:
> >            - const: remote_response_region
> >  
> >      required:
> > +      - compatible
>
> A new required property is an ABI break, but nothing about that in the 
> commit msg.


Hi Rob,

Thanks for reviews. This does not break backward compatibility yet as

relative zynqmp mailbox driver isn't expecting compatible property.

But, any new functionality should consider using it.

I will explain this in commit message in next revision. Other than that, I hope it's

correct to add such compatible property to identify the node.


Thanks,

Tanmay

>
> >        - reg
> >        - reg-names
> >        - "#mbox-cells"
> > @@ -124,6 +129,7 @@ examples:
> >          ranges;
> >  
> >          mailbox: mailbox@ff9905c0 {
> > +          compatible = "xlnx,zynqmp-ipi-dest-mailbox";
> >            reg = <0x0 0xff9905c0 0x0 0x20>,
> >                  <0x0 0xff9905e0 0x0 0x20>,
> >                  <0x0 0xff990e80 0x0 0x20>,
> > 
> > base-commit: 7d730f1bf6f39ece2d9f3ae682f12e5b593d534d
> > -- 
> > 2.25.1
> >