From patchwork Tue Feb 7 13:10:17 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 9560013 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 2C3EB602B1 for ; Tue, 7 Feb 2017 13:13:44 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 1B0C9283ED for ; Tue, 7 Feb 2017 13:13:44 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0D43D28410; Tue, 7 Feb 2017 13:13:44 +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=-6.3 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM, T_DKIM_INVALID autolearn=unavailable version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 6A1B4283ED for ; Tue, 7 Feb 2017 13:13:43 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754762AbdBGNN3 (ORCPT ); Tue, 7 Feb 2017 08:13:29 -0500 Received: from mail-wm0-f45.google.com ([74.125.82.45]:34969 "EHLO mail-wm0-f45.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755145AbdBGNLD (ORCPT ); Tue, 7 Feb 2017 08:11:03 -0500 Received: by mail-wm0-f45.google.com with SMTP id v186so10609088wmd.0 for ; Tue, 07 Feb 2017 05:11:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=e9XsX+abUtZPxBkdbkHR/Ubc05YThJmhcBI/Wv5tufw=; b=a+qwEVMnK71gSo1NFm+zXanOwUvr6PktE04xHsk1UD556BoQGn2pzalyzCPSdwTPfh zVW7TCiQrRu42FCfgS4OOf1FoOTkHrPfpeKUuf02mJ+D20zLBcfo146cL9KtBO9BGdPQ ZI1IODo1aAWn/ichy7shT1R/OWBzgimT8Ig4I= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=e9XsX+abUtZPxBkdbkHR/Ubc05YThJmhcBI/Wv5tufw=; b=Bw9vLfmiGDgne9IXZM/HhJDDpyUk3ie7M0tEes+f6Ys7xL4xJNjdddqqqSH9ZSTiX/ XzbhZ4+xynXzFd93zlZwuwCnMqVWL7EqgDz+kM+SKkCLX6jKJrEcEOtYGwXL/jrRqrBV g/MFhvUfGUE3L+qX+lzkdMQeniMKVQeuLoHXH3W1lbrem6OcYXmlYSUouwj5eDh0rgoA l528zuDeHeqhxtNRjOPDTV/iRWOC6CVV4SxN5iDEf03uRtocX4LHf8nxDRHvZye40hho C61AgNhy11/fm1coZ8Sk4KmXBD7PuB8GmkRJWcJ2RNgdJtYVH9HtzTkUv1yPOsdUcYt7 sDhA== X-Gm-Message-State: AIkVDXK1Qm5F21slwFksi8GfE4aESLY3vfWCUk2K35CTAfherki1YzD3YVIaIQmtrf3aPZZB X-Received: by 10.223.139.12 with SMTP id n12mr13843908wra.176.1486473061655; Tue, 07 Feb 2017 05:11:01 -0800 (PST) Received: from mms-0440.qualcomm.mm-sol.com ([37.157.136.206]) by smtp.gmail.com with ESMTPSA id o81sm18662200wmb.14.2017.02.07.05.11.00 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 07 Feb 2017 05:11:01 -0800 (PST) From: Stanimir Varbanov To: Mauro Carvalho Chehab , Hans Verkuil Cc: Andy Gross , Bjorn Andersson , Stephen Boyd , Srinivas Kandagatla , linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, Stanimir Varbanov , Rob Herring , devicetree@vger.kernel.org Subject: [PATCH v6 2/9] doc: DT: venus: binding document for Qualcomm video driver Date: Tue, 7 Feb 2017 15:10:17 +0200 Message-Id: <1486473024-21705-3-git-send-email-stanimir.varbanov@linaro.org> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1486473024-21705-1-git-send-email-stanimir.varbanov@linaro.org> References: <1486473024-21705-1-git-send-email-stanimir.varbanov@linaro.org> Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add binding document for Venus video encoder/decoder driver Cc: Rob Herring Cc: devicetree@vger.kernel.org Signed-off-by: Stanimir Varbanov Acked-by: Rob Herring --- Changes since previous v5: * dropped rproc phandle (remoteproc is not used anymore) * added subnodes paragraph with descrition of three subnodes: - video-decoder and video-encoder - describes decoder (core0) and encoder (core1) power-domains and clocks (applicable for msm8996 Venus core). - video-firmware - needed to get reserved memory region where the firmware is stored. .../devicetree/bindings/media/qcom,venus.txt | 112 +++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/qcom,venus.txt diff --git a/Documentation/devicetree/bindings/media/qcom,venus.txt b/Documentation/devicetree/bindings/media/qcom,venus.txt new file mode 100644 index 000000000000..4427af3ca5a5 --- /dev/null +++ b/Documentation/devicetree/bindings/media/qcom,venus.txt @@ -0,0 +1,112 @@ +* Qualcomm Venus video encode/decode accelerator + +- compatible: + Usage: required + Value type: + Definition: Value should contain one of: + - "qcom,msm8916-venus" + - "qcom,msm8996-venus" +- reg: + Usage: required + Value type: + Definition: Register base address and length of the register map. +- interrupts: + Usage: required + Value type: + Definition: Should contain interrupt line number. +- clocks: + Usage: required + Value type: + Definition: A List of phandle and clock specifier pairs as listed + in clock-names property. +- clock-names: + Usage: required for msm8916 + Value type: + Definition: Should contain the following entries: + - "core" Core video accelerator clock + - "iface" Video accelerator AHB clock + - "bus" Video accelerator AXI clock +- clock-names: + Usage: required for msm8996 + Value type: + Definition: Should contain the following entries: + - "core" Core video accelerator clock + - "iface" Video accelerator AHB clock + - "bus" Video accelerator AXI clock + - "mbus" Video MAXI clock +- power-domains: + Usage: required + Value type: + Definition: A phandle and power domain specifier pairs to the + power domain which is responsible for collapsing + and restoring power to the peripheral. +- iommus: + Usage: required + Value type: + Definition: A list of phandle and IOMMU specifier pairs. + +* Subnodes +The Venus node must contain three subnodes representing video-decoder, +video-encoder and video-firmware. + +Every of video-encoder or video-decoder subnode should have: + +- compatible: + Usage: required + Value type: + Definition: Value should contain "venus-decoder" or "venus-encoder" +- clocks: + Usage: required for msm8996 + Value type: + Definition: A List of phandle and clock specifier pairs as listed + in clock-names property. +- clock-names: + Usage: required for msm8996 + Value type: + Definition: Should contain the following entries: + - "core" Subcore video accelerator clock + +- power-domains: + Usage: required for msm8996 + Value type: + Definition: A phandle and power domain specifier pairs to the + power domain which is responsible for collapsing + and restoring power to the subcore. + +The video-firmware subnode should contain: + +- memory-region: + Usage: required + Value type: + Definition: reference to the reserved-memory for the memory region + +* An Example + video-codec@1d00000 { + compatible = "qcom,msm8916-venus"; + reg = <0x01d00000 0xff000>; + interrupts = ; + clocks = <&gcc GCC_VENUS0_VCODEC0_CLK>, + <&gcc GCC_VENUS0_AHB_CLK>, + <&gcc GCC_VENUS0_AXI_CLK>; + clock-names = "core", "iface", "bus"; + power-domains = <&gcc VENUS_GDSC>; + iommus = <&apps_iommu 5>; + + video-decoder { + compatible = "venus-decoder"; + clocks = <&mmcc VIDEO_SUBCORE0_CLK>; + clock-names = "core"; + power-domains = <&mmcc VENUS_CORE0_GDSC>; + }; + + video-encoder { + compatible = "venus-encoder"; + clocks = <&mmcc VIDEO_SUBCORE1_CLK>; + clock-names = "core"; + power-domains = <&mmcc VENUS_CORE1_GDSC>; + }; + + video-firmware { + memory-region = <&venus_mem>; + }; + };