Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753503AbdDKF2x (ORCPT ); Tue, 11 Apr 2017 01:28:53 -0400 Received: from galahad.ideasonboard.com ([185.26.127.97]:60576 "EHLO galahad.ideasonboard.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751273AbdDKF2v (ORCPT ); Tue, 11 Apr 2017 01:28:51 -0400 From: Laurent Pinchart To: dri-devel@lists.freedesktop.org Cc: Noralf =?ISO-8859-1?Q?Tr=F8nnes?= , devicetree@vger.kernel.org, thomas.petazzoni@free-electrons.com, linux-kernel@vger.kernel.org Subject: Re: [PATCH v4 5/7] dt-bindings: display/panel: Add common rotation property Date: Tue, 11 Apr 2017 08:29:43 +0300 Message-ID: <1802283.9kerWUhyh6@avalon> User-Agent: KMail/4.14.10 (Linux/4.9.16-gentoo; KDE/4.14.29; x86_64; ; ) In-Reply-To: <20170211184858.26421-6-noralf@tronnes.org> References: <20170211184858.26421-1-noralf@tronnes.org> <20170211184858.26421-6-noralf@tronnes.org> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from quoted-printable to 8bit by mail.home.local id v3B5SvFS029311 Content-Length: 2104 Lines: 56 Hi Noralf, On Saturday 11 Feb 2017 19:48:56 Noralf Tr?nnes wrote: > Display panels can be oriented many ways, especially in the embedded > world. The rotation property is a way to describe this orientation. > The counter clockwise direction is chosen because that's what fbdev > and drm use. > > Signed-off-by: Noralf Tr?nnes > Acked-by: Thierry Reding > --- > > Changes since version 3: > - Changed display/display.txt -> display/panel/panel.txt > > Documentation/devicetree/bindings/display/panel/panel.txt | 4 ++++ We now have both Documentation/devicetree/bindings/display/panel/panel.txt and Documentation/devicetree/bindings/display/panel/panel-common.txt as they have been merged concurrently without being aware of each other. Would you mind if I moved this property to panel-common.txt ? I would also like to document the property in a bit more details to avoid confusion about the rotation direction, as "display rotation" could be interpreted as the angle by which the display output has to be rotated to obtain an upside-up image. What would you think of the following, am I overdoing it, or is it even more confusing ? - rotation: Panels are commonly mounted rotated, with their native orientation not aligned with the device's orientation. The rotation property specifies the angle in degrees between the panel's orientation and the device's orientation (corresponding to a counter-clockwise rotation of the panel). Valid values are 0, 90, 180 and 270. > 1 file changed, 4 insertions(+) > create mode 100644 > Documentation/devicetree/bindings/display/panel/panel.txt > > diff --git a/Documentation/devicetree/bindings/display/panel/panel.txt > b/Documentation/devicetree/bindings/display/panel/panel.txt new file mode > 100644 > index 0000000..e2e6867 > --- /dev/null > +++ b/Documentation/devicetree/bindings/display/panel/panel.txt > @@ -0,0 +1,4 @@ > +Common display properties > +------------------------- > + > +- rotation: Display rotation in degrees counter clockwise (0,90,180,270) -- Regards, Laurent Pinchart