From patchwork Tue Jan 16 01:57:04 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hyun Kwon X-Patchwork-Id: 10165657 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 2DA64601E7 for ; Tue, 16 Jan 2018 01:57:59 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1D9571FFDA for ; Tue, 16 Jan 2018 01:57:59 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 11C0C27F8F; Tue, 16 Jan 2018 01:57:59 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED, RCVD_IN_DNSWL_MED, T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id AB8151FFDA for ; Tue, 16 Jan 2018 01:57:57 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 0F9576E17E; Tue, 16 Jan 2018 01:57:55 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from NAM01-BN3-obe.outbound.protection.outlook.com (mail-bn3nam01on0071.outbound.protection.outlook.com [104.47.33.71]) by gabe.freedesktop.org (Postfix) with ESMTPS id F1DAA6E17D for ; Tue, 16 Jan 2018 01:57:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=xilinx.onmicrosoft.com; s=selector1-xilinx-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=SU6+zz35NcNl0z0o0QjfgYe6pDzQ1v55nQ3bzFXLovg=; b=RMyaTnRAIp7AQhtjh5EPr0nrhXumuRkj3HESUsj3iQm3jAlOQ7kI84pAaN79n/PI+SZgKBjWfy50ti15h18Pa0L4Zp1WHeCIBzhpv2x6XS8N40y24kETf5WUz/GlPSCj7trL01RZ4/7nIOD5bv1RzLeHpgTcU6AMxxOWJsJ1v9Q= Received: from SN4PR0201CA0010.namprd02.prod.outlook.com (10.161.238.148) by MWHPR02MB3391.namprd02.prod.outlook.com (10.164.192.10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.407.7; Tue, 16 Jan 2018 01:57:51 +0000 Received: from BL2NAM02FT003.eop-nam02.prod.protection.outlook.com (2a01:111:f400:7e46::203) by SN4PR0201CA0010.outlook.office365.com (2603:10b6:803:2b::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.407.7 via Frontend Transport; Tue, 16 Jan 2018 01:57:51 +0000 Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.60.83 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.83; helo=xsj-pvapsmtpgw01; Received: from xsj-pvapsmtpgw01 (149.199.60.83) by BL2NAM02FT003.mail.protection.outlook.com (10.152.76.204) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.345.12 via Frontend Transport; Tue, 16 Jan 2018 01:57:50 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66] helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1ebGVZ-0006Jb-WA; Mon, 15 Jan 2018 17:57:50 -0800 Received: from [127.0.0.1] (helo=xsj-smtp-dlp1.xlnx.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1ebGVZ-0002t4-IW; Mon, 15 Jan 2018 17:57:49 -0800 Received: from xsj-pvapsmtp01 (xsj-pvapsmtp01.xilinx.com [149.199.38.66]) by xsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id w0G1vmrF010604; Mon, 15 Jan 2018 17:57:48 -0800 Received: from [172.19.2.244] (helo=xsjhyunkubuntu) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1ebGVY-0002sY-EJ; Mon, 15 Jan 2018 17:57:48 -0800 Received: by xsjhyunkubuntu (Postfix, from userid 13638) id 6866E2C6911; Mon, 15 Jan 2018 17:57:48 -0800 (PST) From: Hyun Kwon To: , Subject: [PATCH v3 1/8] dt-bindings: display: xlnx: Add bindings for Xilinx display pipeline Date: Mon, 15 Jan 2018 17:57:04 -0800 Message-ID: <1516067831-11382-1-git-send-email-hyun.kwon@xilinx.com> X-Mailer: git-send-email 2.7.4 X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.2.0.1013-23596.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:149.199.60.83; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(39380400002)(39860400002)(396003)(346002)(376002)(2980300002)(438002)(189003)(199004)(59450400001)(6666003)(356003)(52956003)(50466002)(48376002)(305945005)(110136005)(316002)(90966002)(54906003)(106002)(42186006)(6346003)(26005)(5660300001)(8936002)(8746002)(81166006)(2906002)(50226002)(51416003)(8676002)(81156014)(4326008)(103686004)(36756003)(63266004)(478600001)(47776003)(5890100001)(106466001)(107886003)(6266002)(107986001)(2101003); DIR:OUT; SFP:1101; SCL:1; SRVR:MWHPR02MB3391; H:xsj-pvapsmtpgw01; FPR:; SPF:Pass; PTR:unknown-60-83.xilinx.com; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2NAM02FT003; 1:cB7wFcqm3vn4tSDnSC0fVNRIAkeMm8ROVbx3viDNwa0jJtimKlfpqAgnIH88dp/7MzpF49BzKWXg55SRH1mZJF8LYhZp3FPwvqeG59WaLWDc/urrp+HOD5pC/rmq3V1+ MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: e26d7864-b0d9-41bf-ee2d-08d55c848cc7 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(5600026)(4604075)(4608076)(2017052603307)(7153060); SRVR:MWHPR02MB3391; X-Microsoft-Exchange-Diagnostics: 1; MWHPR02MB3391; 3:hJvwuLNN7D43HDNeOka2E0xNyLBGHlBKEUsR0re2zQNhzETYFqP0gkdsOfQ41ue9CP7xxh4DfkLCSrsTI4RUjwuS9RBmI5hHG9cVcUXxk+xpWPusqPEYguRPoCeB3CW8Av39PgTfprUzsZD6ya4WQrY2MhIu1QtZZKpwv/fGKunrqE48nBVvpxxh9O+OFRFcwLpCItR3DF3t7oK+bu8OGZxQR7HFCKp6d9WUttuminhj+0B6FcZH2rCl2pUKxRUiXdWNZuHgz3XB3Pwkq7bn9vz06i/PkWmBwQrOh/m/jo2hhGnvh0A19ARnm+kes6n8G5oJHqm5BQIVfnEzMwWO/fuHW4mR0BW33PJukZMt3uw=; 25:BM1tNhPTjQ0wanVncGvUB1oXdJAlTFLDI9fBU1tuKqX3B4zepItUDrP2zsOPcxrDaDoxCw99UWQY8U5Q/G6fhNQAQv3OlMs8zJRVhWodTY/x8u2mzwxL4MhfsxwNZqzJunzwYHekfKLfQjiGv/ZE0mnYVtZrIYO9VZOsBeu6MrLLMxci7OyvO6ngR4kUPIBbNI2FAFTaldRJlc6WnNOzdyEX6ouWSA0kA1Bx8iEAvFKXrIMkLk4r4qjfM/8UEbVh0GvT/2yTG0UluzfOUkp6HoRtAFF8nyrRozGPXAouSKBCt9mAUy7jOuJvoCbm5KE14inJwtgTvVRIONiR/wf57g== X-MS-TrafficTypeDiagnostic: MWHPR02MB3391: X-Microsoft-Exchange-Diagnostics: 1; MWHPR02MB3391; 31:ZyO/4fDoFWffSPI5x6QKILkvCWsc3gNpp0vLxNT0LqP/imQHApC5uK9o4F2KlPuNJmZLKo53b6Ix7NQTVHks/WyOVtJcGP0G0bfTLiNtVMSCgqy7NTMAITXtXi2Bk8QakNA5WfA2ofi0wJSoBTnzgz+PfJZIPdyrLMIbq+SZQ//j0zK8ewTeVPB4VMDMK+jzTCOk3eddQKdTd/1qnGSKmCI9FceT0es+3PXOLeGclwI=; 20:WLv+lo3X3axEnLaV5DIZG3AMjcOGzSiQw6Ni+ls+KR7kEkAonJIpTXA+rA07CZGw5oeNCnVr9Bl8Tu64DzWrxEKiyC94zym1Fbp210/Ihj2pFnUMlL1di4Nzm1IJ8CmjOgg/WYaqiEZnffWfLcBWAcAKiehM6ZW9h0Egij6FKN2nWimOhXPWKHlEzpEMqfj7zHHzo8GcjNCkTPcjWhUI3ICrVJikFVl4uBAA53Hcv+pLl0Zk8c5WQo17KHFhTQSyZANhlh5MvRALlBVDNfY0ucFm5CgC9HGV2zLq6c/AxhAJt+dwyrFT6RLy2SZypqtCZeDgaJrATbcMiMt2zRGXMG52BTtQS+a17Wj0konnnG+nRVqqFgPhWkn5PuadpZn6wY5Mg44th2Z64GVIooeRiQnicGMtTPuY9JbgM2pRDadfVFd0e4DAh4NBopaa2QojvAdHtttAbnoLqYExo4gkuzUsavXI9p0tJ2SF5RgEZVi2LNL0fgO/2qlpgKcCLb9o X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(192813158149592); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040470)(2401047)(5005006)(8121501046)(3231023)(944501161)(93006095)(93004095)(10201501046)(3002001)(6055026)(6041268)(20161123564045)(20161123560045)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(6072148)(201708071742011); SRVR:MWHPR02MB3391; BCL:0; PCL:0; RULEID:(100000803101)(100110400095); SRVR:MWHPR02MB3391; X-Microsoft-Exchange-Diagnostics: 1; MWHPR02MB3391; 4:UIC10elg8yGc3y+xc+lXi56K7dd3DijlhaP20CDw+tpPW76u90nXoy28TFFOwf9fNspSeSn7onsA5kzj6k6mxnnLE7E0UGgQxO+kUCWjrWVpRCT0s7EYVIwv3AoIXhUvuYXTLEh6qQ3Zcy6J4B67p9awCsqqXlxBmqPH6Zy2ioW+wNZtURCY+LMIZocnnXY3E+du23KgcXfjRs0Dt4n4kjHXJTn+Pb8jCoDllY0X/gybhmt9ZNCe5OifHfWSYyzxMkCZkL8cCZg95lzRsui+hey03ST6GTJg3Wp6AKED4vazhh5bfC5mOj4GsanMmvq9 X-Forefront-PRVS: 0554B1F54F X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; MWHPR02MB3391; 23:lpGnvd5yMH5y5DG5NpuurTR4BWqGExs3ijjPJvgKt?= =?us-ascii?Q?FrwKBfKzNhcn+fWfgm+GEXidvIZgEtWVQgAbp8fjG3HDXUT2dK+fCqPVltGA?= =?us-ascii?Q?YR0yyQRzbe44R+4oYu+PAX+T4PrbiL6AyABI1yel2L4kkn1rOnuD2gHM1D2G?= =?us-ascii?Q?+5aIf6z0j3tBh/Lcgg+v3I0JYDZgqMdRbYoGCnaDjilN83Y1ZTYq+J6sSWbM?= =?us-ascii?Q?oKY6oqqU9DkbK7w0Zs0XTfQv9JxLS5ZrfLMwDY4eGo/S2ePgMWClPYgox7ry?= =?us-ascii?Q?xbJDTh5zWwDviKdmahCpzFu/TEP3Le/MYiOKEa78p339VQx8hMRiFG+nUPK4?= =?us-ascii?Q?ZWIVY0UKaKnx+sIHkc8czASSgMNf1BH0IkQlzpQx4c0+I6vc3+FCfOxCpNU/?= =?us-ascii?Q?gPQvFR6aUh5scMM16ao1A/ZfGMIdKeAtdxfwgn0Uu5VbpN7YkeFT5mKDPNaZ?= =?us-ascii?Q?Bwl5sxecvL9yNj8rJ30fI2dvTH78jykmw+Ppr2GTVC1XQ10QZ0ZDTr3ufMkl?= =?us-ascii?Q?FPaAFZGAHGO0XLZ+qLhp1dYzop895HymPG2wZxQCexB6o0O6p5Ak2EDLGgtG?= =?us-ascii?Q?SECM6Krw3wvuYuoN4L8L6jUq5dJG7zJjXHCx0tmzhhMfBV3BWfh7yoK1omon?= =?us-ascii?Q?XMp5E2LfCd3CCPwz4mbalqa4sIm4wsskhJVe7U7vhvMkdX7rcdcsTV5SqoHl?= =?us-ascii?Q?cDRn6COpEWvflVQHu8ho9+QDpJmioaEBLPRqB53tBhxoRjhjNynr7/qKcQ8+?= =?us-ascii?Q?wKIU0lZ7+uLClZTs5vH3/UqWrk6cCYoO2XFC6CtxLu8xx6H5XeiXuShRdpvg?= =?us-ascii?Q?u0XnePqp0wyGnRh+FUN64BIdRrNc9YPczo2BSEIKvmin523dPLxnPuPW4AAl?= =?us-ascii?Q?K91hn5H78sLFMMAIvSjnBO4PhQD9qIVgyX/v0s5mEERo3oSFhTQyVV8OMqbH?= =?us-ascii?Q?8PMI3i7zNYQjkPewNH3cwroso2ceq4BCJuohNHtx1Cg963VLjTwQ2iK9n29n?= =?us-ascii?Q?HhV1h4pteQhLvMiAuGDNZEU6q4IL/A6P0DJz5lv63h/FrsQ6HS6toBj/Xlcw?= =?us-ascii?Q?XhS6xg=3D?= X-Microsoft-Exchange-Diagnostics: 1; MWHPR02MB3391; 6:BnO0r7OyVNuh45cnLj+T1EJ2eEdlnJ/O2nSXyzG8PTpW1ZexgYtlbMo76cZ1kGcAg0uBw31iv/bpApKNEyxYa6rqc60IKgZy2cVCgtz7oj1XTZdaqnbUga7Uteu4B0xfHLdtfztAwUFL6YrWfZZkh55LN3myeSKW0yHXtlqSDmLdGzwQM6GDcNI5mgA7CTQD1Cu6PYire2vZ+tpLNqAcXprF00tRNP5GAd0OLne0VunJ3IEqIBgGw3/OGdjuj1CUNb5EFbRDDOwrf6EmHB7a+KyVThdHENry3h6jrb8FcT51HSOU1BAWmMKx0SVelRpqNxgJU143PStb7GroCKUXwPHS6GqHgyNQNNG6Vdlh83Y=; 5:8scLIT9w3L76bCqighpZ3m+P87xu51xUrxXGEXdjUupZz91MZS4hBuPGd2FOb5ckHkLVDVNs8lKxREMPEBpO3PjNzdl/dmivN0mtuXjSstvXbqp70qRF/klzP47rfpsXFakt5E5R+Pc8k7cHZLzhZiQJ27GRO0z2y7Cpfoctt+c=; 24:O94M7bsaLA1aeCnpa3hnzbc4pQ2HlBLcfEK5Jil0QLALYzBz1+l9CVkV/BwzHt2ZRokgL7l363HL2vTTB9tGwA0lrfEOtN/AlUVYUs6j9Ys=; 7:P+8wSAJXDgsQDGNpseN0n0KVPti8Z1I9KZgeFpvxoKpGBeYMiJ2tlotvPS/1a4W5MRhYTJujCj2n79ISEJc/CqodhmkGcHO6jgyQ6UyCBPFvy4B9AuhperctoQ8rP2KaBAR2vRuUVEvmb514VXIDIsr6KG4wk6FR+Qcpq8aE44bmu+BwctuNPMeZuTjaYdwz4J+WQL2IS0TmzZkq+/sPtCvGdoB506OxmNl2jxCdaozqA6ZAJ6vvDKXhaI3wA85W SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 16 Jan 2018 01:57:50.7644 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e26d7864-b0d9-41bf-ee2d-08d55c848cc7 X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.60.83]; Helo=[xsj-pvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MWHPR02MB3391 Cc: Laurent Pinchart , Michal Simek , Hyun Kwon , Daniel Vetter X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP The dt binding for Xilinx display pipeline. The pipeline can be composed with multiple and different types of sub-devices. This node is to represent the entire pipeline as a single entity. Signed-off-by: Hyun Kwon --- v2 - Remove linux specific terms - Elaborate details, ex regarding port binding - Rename xlnx,kms to xlnx,display - Rename the file name to xlnx,display.txt - Add examples of hardware blocks --- --- .../bindings/display/xlnx/xlnx,display.txt | 68 ++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 Documentation/devicetree/bindings/display/xlnx/xlnx,display.txt -- 2.7.4 This email and any attachments are intended for the sole use of the named recipient(s) and contain(s) confidential information that may be proprietary, privileged or copyrighted under applicable law. If you are not the intended recipient, do not read, copy, or forward this email message or any attachments. Delete this email message and any attachments immediately. diff --git a/Documentation/devicetree/bindings/display/xlnx/xlnx,display.txt b/Documentation/devicetree/bindings/display/xlnx/xlnx,display.txt new file mode 100644 index 0000000..fde1a35 --- /dev/null +++ b/Documentation/devicetree/bindings/display/xlnx/xlnx,display.txt @@ -0,0 +1,68 @@ +Xilinx Display Pipeline +----------------------- + +Xilinx display pipeline can be designed with various types of multiple IPs: +IPs hardened on chip, ob board IPs, and soft IPs in programmable logic. +While each component would need its own node, this node represents +a whole display pipeline as a single entity by integrating individual subdevice +with glue logics. + +The following illustrates some examples of topology: + +A linear pipeline with multiple blocks: + + SoC DMA -> SoC display controller -> SoC display enc +or, + FPGA DMA -> FPGA display controller -> FPGA display enc + +A pipeline with branches: + + SoC DMA -> SoC display controller -> SoC display enc + | + FPGA DMA-> +or, + SoC DMA -> SoC display controller -> SoC display enc + | + -> FPAG display enc + +or, + + SoC DMA -> SoC display controller -> SoC display enc + | | + FPGA display controller -> -> FPGA display enc + +Required properties: + +- compatible: Must be "xlnx,display". + +- ports: phandles for ports of display controller subdevice. + In the display controller port nodes, topology for entire pipeline + should be described using the DT bindings defined in + Documentation/devicetree/bindings/graph.txt. + +Example: + + xlnx_display { + compatible = "xlnx,display"; + ports = <&display_controller_port>; + }; + + display_controller { + ... + display_controller_port: port@0 { + display_controller_ep: endpoint { + remote-endpoint = <&dp_controller_ep>; + }; + }; + ... + }; + + dp_controller { + ... + dp_controller_port: port@0 { + dp_controller_ep: endpoint { + remote-endpoint = <&display_controller_ep>; + }; + }; + ... + };