Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S936502AbdIYXpa (ORCPT ); Mon, 25 Sep 2017 19:45:30 -0400 Received: from mail-wr0-f196.google.com ([209.85.128.196]:33612 "EHLO mail-wr0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933685AbdIYXp1 (ORCPT ); Mon, 25 Sep 2017 19:45:27 -0400 X-Google-Smtp-Source: AOwi7QAzgyrsvECd/BdE66Cd9UAwOUe5fpCNY040Kcfhuln92iYL4uS+uDmgMyFnMSFmRmedkMNifw== Subject: Re: [PATCH v1 1/2] staging: Introduce NVIDIA Tegra20 video decoder driver To: Stephen Warren Cc: Thierry Reding , Jonathan Hunter , Greg Kroah-Hartman , Rob Herring , linux-tegra@vger.kernel.org, devel@driverdev.osuosl.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org References: <5c8b83775b982e6ee851c127444a8e839f422ad0.1506377430.git.digetx@gmail.com> <38daee0d-0595-a7e4-69bb-5a2ddbd832b5@wwwdotorg.org> From: Dmitry Osipenko Message-ID: Date: Tue, 26 Sep 2017 02:45:23 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0 MIME-Version: 1.0 In-Reply-To: <38daee0d-0595-a7e4-69bb-5a2ddbd832b5@wwwdotorg.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1740 Lines: 46 On 26.09.2017 02:01, Stephen Warren wrote: > On 09/25/2017 04:15 PM, Dmitry Osipenko wrote: >> Video decoder, found on NVIDIA Tegra20 SoC, supports a standard set of >> video formats like H.264 / MPEG-4 / WMV / VC1. Currently driver supports >> decoding of CAVLC H.264 only. > > Note: I don't know anything much about video decoding on Tegra (just NV desktop > GPUs, and that was a while ago), but I had a couple small comments on the DT > binding: > >> diff --git >> a/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra20-vde.txt >> b/Documentation/devicetree/bindings/arm/tegra/nvidia,tegra20-vde.txt > >> +NVIDIA Tegra Video Decoder Engine >> + >> +Required properties: >> +- compatible : "nvidia,tegra20-vde" >> +- reg : Must contain 2 register ranges: registers and IRAM area. >> +- reg-names : Must include the following entries: >> +  - regs >> +  - iram > > I think the IRAM region needs more explanation: What is the region used for and > by what? Can it be moved, and if so does the move need to be co-ordinated with > any other piece of SW? > IRAM region is used by Video Decoder HW for internal use and some of decoding parameters are supplied via IRAM, like frames order list. AFAIK IRAM addresses are hardwired in HW and aren't movable, it is not 100% but I'm pretty sure. Should it be explained in the binding? >> +- clocks : Must contain one entry, for the module clock. >> +  See ../clocks/clock-bindings.txt for details. >> +- resets : Must contain an entry for each entry in reset-names. >> +  See ../reset/reset.txt for details. >> +- reset-names : Must include the following entries: >> +  - vde > > Let's require a clock-names property too. Okay, I'll add this property to the binding. -- Dmitry