From patchwork Fri Oct 9 02:23:03 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?b?WW9uZyBXdSAo5ZC05YuHKQ==?= X-Patchwork-Id: 528070 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 04DB31402B7 for ; Fri, 9 Oct 2015 13:26:26 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932622AbbJICXt (ORCPT ); Thu, 8 Oct 2015 22:23:49 -0400 Received: from mailgw02.mediatek.com ([210.61.82.184]:47050 "EHLO mailgw02.mediatek.com" rhost-flags-OK-FAIL-OK-FAIL) by vger.kernel.org with ESMTP id S932607AbbJICXr (ORCPT ); Thu, 8 Oct 2015 22:23:47 -0400 X-Listener-Flag: 11101 Received: from mtkhts09.mediatek.inc [(172.21.101.70)] by mailgw02.mediatek.com (envelope-from ) (mhqrelay.mediatek.com ESMTP with TLS) with ESMTP id 27345016; Fri, 09 Oct 2015 10:23:44 +0800 Received: from localhost.localdomain (10.17.3.153) by mtkhts09.mediatek.inc (172.21.101.73) with Microsoft SMTP Server id 14.3.181.6; Fri, 9 Oct 2015 10:23:42 +0800 From: Yong Wu To: Joerg Roedel , Thierry Reding , Mark Rutland , Matthias Brugger CC: Robin Murphy , Will Deacon , Daniel Kurtz , Tomasz Figa , Lucas Stach , Rob Herring , Catalin Marinas , , Sasha Hauer , , , , , , , , , Sricharan R , , , , Yong Wu Subject: [PATCH v5 1/6] dt-bindings: iommu: Add binding for mediatek IOMMU Date: Fri, 9 Oct 2015 10:23:03 +0800 Message-ID: <1444357388-30257-2-git-send-email-yong.wu@mediatek.com> X-Mailer: git-send-email 1.8.1.1.dirty In-Reply-To: <1444357388-30257-1-git-send-email-yong.wu@mediatek.com> References: <1444357388-30257-1-git-send-email-yong.wu@mediatek.com> MIME-Version: 1.0 X-MTK: N Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This patch add mediatek iommu dts binding document. Signed-off-by: Yong Wu --- .../devicetree/bindings/iommu/mediatek,iommu.txt | 61 ++++++++++++ include/dt-bindings/memory/mt8173-larb-port.h | 105 +++++++++++++++++++++ 2 files changed, 166 insertions(+) create mode 100644 Documentation/devicetree/bindings/iommu/mediatek,iommu.txt create mode 100644 include/dt-bindings/memory/mt8173-larb-port.h diff --git a/Documentation/devicetree/bindings/iommu/mediatek,iommu.txt b/Documentation/devicetree/bindings/iommu/mediatek,iommu.txt new file mode 100644 index 0000000..d515e47 --- /dev/null +++ b/Documentation/devicetree/bindings/iommu/mediatek,iommu.txt @@ -0,0 +1,61 @@ +* Mediatek IOMMU Architecture Implementation + + Mediatek Socs may contain a implementation of Multimedia Memory +Management Unit(M4U),which use ARM Short-descriptor translation table +to achieve address translation. + + The IOMMU Hardware Block Diagram, please check below: + + EMI (External Memory Interface) + | + m4u (Multimedia Memory Management Unit) + | + smi (Smart Multimedia Interface) + | + +---------------+------- + | | + | | + vdec larb disp larb ... SoCs have different local arbiter(larb). + | | + | | + +----+----+ +-----+-----+ + | | | | | | ... + | | | | | | ... + | | | | | | ... + MC PP VLD OVL0 RDMA0 WDMA0 ... There are different ports in each larb. + + As above, The Multimedia HW will go through SMI and M4U while it +access EMI. SMI is a brige between m4u and the Multimedia HW. It contain +smi local arbiter and smi common. It will control whether the Multimedia +HW should go though the m4u for translation or bypass it and talk +directly with EMI. And also SMI help control the clocks for each +local arbiter. + Normally we specify a local arbiter(larb) for each multimedia HW +like display, video decode, and camera. And there are different ports +in each larb. Take a example, There are some ports like MC, PP, VLD in the +video decode local arbiter, all the ports are according to the video HW. + +Required properties: +- compatible : must be "mediatek,mt8173-m4u". +- reg : m4u register base and size. +- interrupts : the interrupt of m4u. +- clocks : must contain one entry for each clock-names. +- clock-names : must be "bclk", It is the block clock of m4u. +- mediatek,larb : List of phandle to the local arbiters in the current Socs. + Refer to bindings/memory-controllers/mediatek,smi-larb.txt. It must sort + according to the local arbiter index, like larb0, larb1, larb2... +- iommu-cells : must be 2. There are 2 cells needed to enable/disable iommu. + The first one is local arbiter index(larbid), and the other is port + index(portid) within local arbiter. Specifies the larbid and portid as + defined in dt-binding/memory/mt8173-larb-port.h. + +Example: + iommu: iommu@10205000 { + compatible = "mediatek,mt8173-m4u"; + reg = <0 0x10205000 0 0x1000>; + interrupts = ; + clocks = <&infracfg CLK_INFRA_M4U>; + clock-names = "bclk"; + mediatek,larb = <&larb0 &larb1 &larb2 &larb3 &larb4 &larb5>; + #iommu-cells = <2>; + }; diff --git a/include/dt-bindings/memory/mt8173-larb-port.h b/include/dt-bindings/memory/mt8173-larb-port.h new file mode 100644 index 0000000..8e5b716 --- /dev/null +++ b/include/dt-bindings/memory/mt8173-larb-port.h @@ -0,0 +1,105 @@ +/* + * Copyright (c) 2014-2015 MediaTek Inc. + * Author: Yong Wu + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License version 2 as + * published by the Free Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + */ +#ifndef __DTS_IOMMU_PORT_MT8173_H +#define __DTS_IOMMU_PORT_MT8173_H + +#define M4U_LARB0_ID 0 +#define M4U_LARB1_ID 1 +#define M4U_LARB2_ID 2 +#define M4U_LARB3_ID 3 +#define M4U_LARB4_ID 4 +#define M4U_LARB5_ID 5 + +/* larb0 */ +#define M4U_PORT_DISP_OVL0 0 +#define M4U_PORT_DISP_RDMA0 1 +#define M4U_PORT_DISP_WDMA0 2 +#define M4U_PORT_DISP_OD_R 3 +#define M4U_PORT_DISP_OD_W 4 +#define M4U_PORT_MDP_RDMA0 5 +#define M4U_PORT_MDP_WDMA 6 +#define M4U_PORT_MDP_WROT0 7 + +/* larb1 */ +#define M4U_PORT_HW_VDEC_MC_EXT 0 +#define M4U_PORT_HW_VDEC_PP_EXT 1 +#define M4U_PORT_HW_VDEC_UFO_EXT 2 +#define M4U_PORT_HW_VDEC_VLD_EXT 3 +#define M4U_PORT_HW_VDEC_VLD2_EXT 4 +#define M4U_PORT_HW_VDEC_AVC_MV_EXT 5 +#define M4U_PORT_HW_VDEC_PRED_RD_EXT 6 +#define M4U_PORT_HW_VDEC_PRED_WR_EXT 7 +#define M4U_PORT_HW_VDEC_PPWRAP_EXT 8 +#define M4U_PORT_HW_VDEC_TILE 9 + +/* larb2 */ +#define M4U_PORT_IMGO 0 +#define M4U_PORT_RRZO 1 +#define M4U_PORT_AAO 2 +#define M4U_PORT_LCSO 3 +#define M4U_PORT_ESFKO 4 +#define M4U_PORT_IMGO_D 5 +#define M4U_PORT_LSCI 6 +#define M4U_PORT_LSCI_D 7 +#define M4U_PORT_BPCI 8 +#define M4U_PORT_BPCI_D 9 +#define M4U_PORT_UFDI 10 +#define M4U_PORT_IMGI 11 +#define M4U_PORT_IMG2O 12 +#define M4U_PORT_IMG3O 13 +#define M4U_PORT_VIPI 14 +#define M4U_PORT_VIP2I 15 +#define M4U_PORT_VIP3I 16 +#define M4U_PORT_LCEI 17 +#define M4U_PORT_RB 18 +#define M4U_PORT_RP 19 +#define M4U_PORT_WR 20 + +/* larb3 */ +#define M4U_PORT_VENC_RCPU 0 +#define M4U_PORT_VENC_REC 1 +#define M4U_PORT_VENC_BSDMA 2 +#define M4U_PORT_VENC_SV_COMV 3 +#define M4U_PORT_VENC_RD_COMV 4 +#define M4U_PORT_JPGENC_RDMA 5 +#define M4U_PORT_JPGENC_BSDMA 6 +#define M4U_PORT_JPGDEC_WDMA 7 +#define M4U_PORT_JPGDEC_BSDMA 8 +#define M4U_PORT_VENC_CUR_LUMA 9 +#define M4U_PORT_VENC_CUR_CHROMA 10 +#define M4U_PORT_VENC_REF_LUMA 11 +#define M4U_PORT_VENC_REF_CHROMA 12 +#define M4U_PORT_VENC_NBM_RDMA 13 +#define M4U_PORT_VENC_NBM_WDMA 14 + +/* larb4 */ +#define M4U_PORT_DISP_OVL1 0 +#define M4U_PORT_DISP_RDMA1 1 +#define M4U_PORT_DISP_RDMA2 2 +#define M4U_PORT_DISP_WDMA1 3 +#define M4U_PORT_MDP_RDMA1 4 +#define M4U_PORT_MDP_WROT1 5 + +/* larb5 */ +#define M4U_PORT_VENC_RCPU_SET2 0 +#define M4U_PORT_VENC_REC_FRM_SET2 1 +#define M4U_PORT_VENC_REF_LUMA_SET2 2 +#define M4U_PORT_VENC_REC_CHROMA_SET2 3 +#define M4U_PORT_VENC_BSDMA_SET2 4 +#define M4U_PORT_VENC_CUR_LUMA_SET2 5 +#define M4U_PORT_VENC_CUR_CHROMA_SET2 6 +#define M4U_PORT_VENC_RD_COMA_SET2 7 +#define M4U_PORT_VENC_SV_COMA_SET2 8 + +#endif