From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.1 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 458C6C433E0 for ; Tue, 23 Jun 2020 11:47:37 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 2229D2078E for ; Tue, 23 Jun 2020 11:47:37 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=chromium.org header.i=@chromium.org header.b="AbhjwL6k" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1732513AbgFWLrg (ORCPT ); Tue, 23 Jun 2020 07:47:36 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57566 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1732484AbgFWLrf (ORCPT ); Tue, 23 Jun 2020 07:47:35 -0400 Received: from mail-ed1-x536.google.com (mail-ed1-x536.google.com [IPv6:2a00:1450:4864:20::536]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1704DC061573 for ; Tue, 23 Jun 2020 04:47:35 -0700 (PDT) Received: by mail-ed1-x536.google.com with SMTP id h28so3915039edz.0 for ; Tue, 23 Jun 2020 04:47:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=rfg+eTx38SOH2bj+iaEhdB/6FbC8ETtey+Vu54F6Vw0=; b=AbhjwL6kny0nflNtavl6SxGieKnR5WTHz9cGEpcL2iui/pvIicLt1I5+ZAWRjfxaDS /AuRBkI48qbnOQnHilZ9dDdsBvIkHKke0G8OTRK/s0wRNOIjQnDY/drCJjUilWGYYURq pZ9LmOgt+XUnFweD8yqbNsBSQF9P6Spp4qQsE= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=rfg+eTx38SOH2bj+iaEhdB/6FbC8ETtey+Vu54F6Vw0=; b=K8GKx/uD9b/GFQ4lZZmu9VAVPebn2qaxwkUajkGYfv72RToAyYsMbtfWOE0kEx4zzw ir2+IdHmXFdO7bv/tC+yK7ThroYCriXaX6mCUwuSZ4YLO+MSovH6ZzSn0SYJDP1gfo1Q wfcRiDR9UW1ZqX7SoLaNAvdHZPoIxf6HDYHqxzO2naphrxawqOw8S+KDeOEJwZ9Boa+p snsqWQtD3b+5YtygSMPezbbPQ6twkPsB0GFVSeEFM1zGEOF3m3GjyI/AQvRm/xzyP7RZ S5MlVgfGg8+9QoKvv59/NypDpRqnL5LjArzO4NIOb9gO2OtxySRJBCFnWio7TpJ158Am Jsqw== X-Gm-Message-State: AOAM530mfEYxBJWdjVw138/+GQN+3wH91BOkhGFRnBZ4ytX+V0JnK0KK bZoCIpLVN+u0uWUDN40rvpMMto+yzqyYbQ== X-Google-Smtp-Source: ABdhPJwSmri70r3qJxfCOkWfgmgrE1FxxYDo0XaY5V3tF7uvFuhcBKeqIn8B4DEj1s3lHPjY4HIAHw== X-Received: by 2002:a50:bf4c:: with SMTP id g12mr21848313edk.203.1592912853566; Tue, 23 Jun 2020 04:47:33 -0700 (PDT) Received: from mail-wr1-f51.google.com (mail-wr1-f51.google.com. [209.85.221.51]) by smtp.gmail.com with ESMTPSA id k23sm13340482ejg.89.2020.06.23.04.47.32 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 23 Jun 2020 04:47:32 -0700 (PDT) Received: by mail-wr1-f51.google.com with SMTP id a6so18226227wrm.4 for ; Tue, 23 Jun 2020 04:47:32 -0700 (PDT) X-Received: by 2002:adf:80e6:: with SMTP id 93mr24052047wrl.17.1592912852165; Tue, 23 Jun 2020 04:47:32 -0700 (PDT) MIME-Version: 1.0 References: <20200526100932.2626420-1-hverkuil-cisco@xs4all.nl> <20200526100932.2626420-2-hverkuil-cisco@xs4all.nl> In-Reply-To: From: Tomasz Figa Date: Tue, 23 Jun 2020 13:47:21 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCHv3 1/5] media: docs-rst: Document memory-to-memory video encoder interface To: Hans Verkuil Cc: Linux Media Mailing List , Nicolas Dufresne , Michael Tretter Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org On Tue, Jun 23, 2020 at 12:37 PM Hans Verkuil wr= ote: > > Hi Tomasz, > > On 26/05/2020 12:09, Hans Verkuil wrote: > > From: Tomasz Figa > > > > Due to complexity of the video encoding process, the V4L2 drivers of > > stateful encoder hardware require specific sequences of V4L2 API calls > > to be followed. These include capability enumeration, initialization, > > encoding, encode parameters change, drain and reset. > > > > Specifics of the above have been discussed during Media Workshops at > > LinuxCon Europe 2012 in Barcelona and then later Embedded Linux > > Conference Europe 2014 in D=C3=BCsseldorf. The de facto Codec API that > > originated at those events was later implemented by the drivers we alre= ady > > have merged in mainline, such as s5p-mfc or coda. > > > > The only thing missing was the real specification included as a part of > > Linux Media documentation. Fix it now and document the encoder part of > > the Codec API. > > > > Signed-off-by: Tomasz Figa > > Signed-off-by: Hans Verkuil > > --- > > .../userspace-api/media/v4l/dev-encoder.rst | 728 ++++++++++++++++++ > > .../userspace-api/media/v4l/dev-mem2mem.rst | 1 + > > .../userspace-api/media/v4l/pixfmt-v4l2.rst | 5 + > > .../userspace-api/media/v4l/v4l2.rst | 2 + > > .../media/v4l/vidioc-encoder-cmd.rst | 51 +- > > 5 files changed, 767 insertions(+), 20 deletions(-) > > create mode 100644 Documentation/userspace-api/media/v4l/dev-encoder.r= st > > > > diff --git a/Documentation/userspace-api/media/v4l/dev-encoder.rst b/Do= cumentation/userspace-api/media/v4l/dev-encoder.rst > > new file mode 100644 > > index 000000000000..aace7b812a9c > > --- /dev/null > > +++ b/Documentation/userspace-api/media/v4l/dev-encoder.rst > > @@ -0,0 +1,728 @@ > > +.. SPDX-License-Identifier: GPL-2.0 > > + > > New rst docs should be dual licensed: > > SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-or-later-no-invariants > > It is OK to make this change? No need to repost, if you agree with this > I or Mauro will make the change. > > If you agree, just reply with your Signed-off-by line. Fine with me. Signed-off-by: Tomasz Figa Best regards, Tomasz