From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.3 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 19B78C11D3D for ; Thu, 27 Feb 2020 20:35:29 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id DCC282468F for ; Thu, 27 Feb 2020 20:35:28 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729421AbgB0Uf2 (ORCPT ); Thu, 27 Feb 2020 15:35:28 -0500 Received: from asavdk3.altibox.net ([109.247.116.14]:51900 "EHLO asavdk3.altibox.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729351AbgB0Uf2 (ORCPT ); Thu, 27 Feb 2020 15:35:28 -0500 Received: from ravnborg.org (unknown [158.248.194.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by asavdk3.altibox.net (Postfix) with ESMTPS id B126920031; Thu, 27 Feb 2020 21:35:22 +0100 (CET) Date: Thu, 27 Feb 2020 21:35:21 +0100 From: Sam Ravnborg To: Sebastian Reichel Cc: Sebastian Reichel , Laurent Pinchart , Tomi Valkeinen , kernel@collabora.com, Tony Lindgren , "H. Nikolaus Schaller" , Merlijn Wajer , dri-devel@lists.freedesktop.org, linux-omap@vger.kernel.org Subject: Re: [PATCHv2 57/56] dt-bindings: display: panel-dsi-cm: convert to YAML Message-ID: <20200227203521.GC27592@ravnborg.org> References: <20200224232126.3385250-1-sebastian.reichel@collabora.com> <20200225115341.3558245-1-sebastian.reichel@collabora.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200225115341.3558245-1-sebastian.reichel@collabora.com> User-Agent: Mutt/1.10.1 (2018-07-13) X-CMAE-Score: 0 X-CMAE-Analysis: v=2.3 cv=eMA9ckh1 c=1 sm=1 tr=0 a=UWs3HLbX/2nnQ3s7vZ42gw==:117 a=UWs3HLbX/2nnQ3s7vZ42gw==:17 a=jpOVt7BSZ2e4Z31A5e1TngXxSK0=:19 a=kj9zAlcOel0A:10 a=QX4gbG5DAAAA:8 a=gEfo2CItAAAA:8 a=sozttTNsAAAA:8 a=VwQbUJbxAAAA:8 a=7gkXJVJtAAAA:8 a=e5mUnYsNAAAA:8 a=U1h6ImBIMqCLHhaAV2QA:9 a=GY7t_A-vK1nk_CmV:21 a=ECjuDdCVLqgy28Y1:21 a=CjuIK1q_8ugA:10 a=AbAUZ8qAyYyZVLSsDulk:22 a=sptkURWiP4Gy88Gu7hUp:22 a=aeg5Gbbo78KNqacMgKqU:22 a=AjGcO6oz07-iQ99wixmX:22 a=E9Po1WZjFZOl8hwRPBS3:22 a=Vxmtnl_E_bksehYqCbjh:22 Sender: linux-omap-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-omap@vger.kernel.org Hi Sebastian. On Tue, Feb 25, 2020 at 12:53:41PM +0100, Sebastian Reichel wrote: > Convert panel-dsi-cm bindings to YAML and add > missing properties while at it. > > Signed-off-by: Sebastian Reichel As saind in previous mail - I prefer to convert ann then patch. But end result is the same so OK. > --- > .../bindings/display/panel/panel-dsi-cm.txt | 31 ------ > .../bindings/display/panel/panel-dsi-cm.yaml | 97 +++++++++++++++++++ > 2 files changed, 97 insertions(+), 31 deletions(-) > delete mode 100644 Documentation/devicetree/bindings/display/panel/panel-dsi-cm.txt > create mode 100644 Documentation/devicetree/bindings/display/panel/panel-dsi-cm.yaml > > diff --git a/Documentation/devicetree/bindings/display/panel/panel-dsi-cm.txt b/Documentation/devicetree/bindings/display/panel/panel-dsi-cm.txt > deleted file mode 100644 > index f92d5c9adfc5..000000000000 > --- a/Documentation/devicetree/bindings/display/panel/panel-dsi-cm.txt > +++ /dev/null > @@ -1,31 +0,0 @@ > -Generic MIPI DSI Command Mode Panel > -=================================== > - > -Required properties: > -- compatible: "panel-dsi-cm" > -- reg: DSI channel number > - > -Optional properties: > -- label: a symbolic name for the panel > -- reset-gpios: panel reset gpio > -- te-gpios: panel TE gpio > - > -Required nodes: > -- Video port for DSI input > - > -Example > -------- > - > -lcd0: panel@0 { > - compatible = "tpo,taal", "panel-dsi-cm"; > - label = "lcd0"; > - reg = <0>; > - > - reset-gpios = <&gpio4 6 GPIO_ACTIVE_HIGH>; > - > - port { > - lcd0_in: endpoint { > - remote-endpoint = <&dsi1_out_ep>; > - }; > - }; > -}; > diff --git a/Documentation/devicetree/bindings/display/panel/panel-dsi-cm.yaml b/Documentation/devicetree/bindings/display/panel/panel-dsi-cm.yaml > new file mode 100644 > index 000000000000..ca61171ae145 > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/panel/panel-dsi-cm.yaml > @@ -0,0 +1,97 @@ > +# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/display/panel/panel-dsi-cm.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: DSI command mode panels > + > +maintainers: > + - Tomi Valkeinen > + - Sebastian Reichel > + > +description: | > + This binding file is a collection of the DSI panels that > + are usually driven in command mode. If no backlight is > + referenced via the optional backlight property, the DSI > + panel is assumed to have native backlight support. > + The panel may use an OF graph binding for the association > + to the display, or it may be a direct child node of the > + display. > + > +allOf: > + - $ref: panel-common.yaml# > + > +properties: > + > + compatible: > + enum: > + # compatible must be listed in alphabetical order, ordered by compatible. > + # The description in the comment is mandatory for each compatible. > + - motorola,droid4-panel, panel-dsi-cm > + - nokia,himalaya, panel-dsi-cm > + - tpo,taal, panel-dsi-cm Please consider to use the following syntax (from memory - may require an enum:): compatible: description: Shall contain a panel specific compatible and "panel-dsi-cm" in that order. items: - oneOf: # Maybe add a short description of this panel - motorola,droid4-panel # Maybe add a short description of this panel - nokia,himalaya # Maybe add a short description of this panel - tpo,taal - const: panel-dsi-cm Then panel-dsi-cm is always specified as a second mandatory compatible. > + > + reg: > + maxItems: 1 > + description: DSI virtual channel > + > + te-gpios: > + maxItems: 1 > + description: > + Specifier for a GPIO connected to the panel TE (tearing event) signal. > + The GPIO informs the system, that data should be sent to the display > + on rising edges of the GPIO to avoid (or reduce) tearing effects. > + Falling edge can be supported by inverting the GPIO specifier polarity > + flag. te-gpios is used by several panels. Please add it to panel-common with your nice description. With the above addressed: Reviewed-by: Sam Ravnborg Sam > + > + vddi-supply: > + description: > + Display panels require power to be supplied. While several panels need > + more than one power supply with panel-specific constraints governing the > + order and timings of the power supplies, in many cases a single power > + supply is sufficient, either because the panel has a single power rail, or > + because all its power rails can be driven by the same supply. In that case > + the vddi-supply property specifies the supply powering the panel as a > + phandle to a regulator. > + > + vpnl-supply: > + description: > + When the display panel needs a second power supply, this property can be > + used in addition to vddi-supply. Both supplies will be enabled at the > + same time before the panel is being accessed. > + > + width-mm: true > + height-mm: true > + label: true > + rotation: true > + panel-timing: true > + port: true > + reset-gpios: true > + backlight: true > + > +additionalProperties: false > + > +required: > + - compatible > + - port > + - reg > + > +examples: > + - | > + dsi1@12345678 { > + #address-cells = <1>; > + #size-cells = <0>; > + panel@0 { > + compatible = "tpo,taal", "panel-dsi-cm"; > + label = "lcd0"; > + reg = <0>; > + reset-gpios = <&gpio4 6 GPIO_ACTIVE_HIGH>; > + > + port { > + panel: endpoint { > + remote-endpoint = <&dsi1_out_ep>; > + }; > + }; > + }; > + }; > -- > 2.25.0 > > _______________________________________________ > dri-devel mailing list > dri-devel@lists.freedesktop.org > https://lists.freedesktop.org/mailman/listinfo/dri-devel