From patchwork Mon Feb 21 19:37:27 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nicolas Dufresne X-Patchwork-Id: 545791 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 231FBC433F5 for ; Mon, 21 Feb 2022 19:38:00 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232499AbiBUTiV (ORCPT ); Mon, 21 Feb 2022 14:38:21 -0500 Received: from mxb-00190b01.gslb.pphosted.com ([23.128.96.19]:56054 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233106AbiBUTiK (ORCPT ); Mon, 21 Feb 2022 14:38:10 -0500 Received: from bhuna.collabora.co.uk (bhuna.collabora.co.uk [IPv6:2a00:1098:0:82:1000:25:2eeb:e3e3]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 810A423BCF; Mon, 21 Feb 2022 11:37:40 -0800 (PST) Received: from [127.0.0.1] (localhost [127.0.0.1]) (Authenticated sender: nicolas) with ESMTPSA id B16341F43D58 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1645472259; bh=ppkjAqsyefNanhA6ebbN+nOWgkrenoU3SYfcyrnCW9U=; h=From:To:Cc:Subject:Date:From; b=UXVJl8OQpjuFzsctC70VXjMowE4u/MClizz+0R07tdlyi4D/ePgvcJ17qe6xyx5L7 RST1wUjyIIezhSv3Wc102bupCZ9AU+lKxqhQHPukmAzg9zNlHOANUsJAztS6siaHE/ mJ42kjp2lpjDzgQOyJEWcszvlY2U8OnPIEVnJPF4PxRinzgM/wR8xH5jxE/0rJOIn3 TDrffNLQBlK3Y+ZxFG4t5lLnIYXoTuuXKGm18ZjCoI/obHr5LCj4o7Q+smY7pYdoGH RczE0mFJffSNF+ixZY2HnnxWzXry75dTH7VRWQtjVA0GuI/cQNEcPwmuCO6OmQ2tkz OqxmFoDJjFNOg== From: Nicolas Dufresne To: Mauro Carvalho Chehab Cc: kernel@collabora.com, Nicolas Dufresne , linux-media@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v1] doc: media: Document VP9 reference_mode miss-placement Date: Mon, 21 Feb 2022 14:37:27 -0500 Message-Id: <20220221193728.808414-1-nicolas.dufresne@collabora.com> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org The reference_mode derived syntax is part of the compressed headers and should have been moved into the corresponding control structure. Document this mistake. The value can be set to 0 if the driver does not require compressed headers information. Signed-off-by: Nicolas Dufresne --- .../userspace-api/media/v4l/ext-ctrls-codec-stateless.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst index cc080c4257d01..ec48e4acb5ece 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst @@ -1692,7 +1692,12 @@ See section '7.3.1 Tx mode semantics' of the :ref:`vp9` specification for more d * - __u8 - ``reference_mode`` - Specifies the type of inter prediction to be used. See - :ref:`Reference Mode` for more details. + :ref:`Reference Mode` for more details. Note that + this is derived as part of the compressed header parsing process and + for this reason should have bee part of + :c:type: `v4l2_ctrl_vp9_compressed_hdr` optional control. It is safe to + set this value to zero if the driver does not require compressed + headers. * - __u8 - ``reserved[7]`` - Applications and drivers must set this to zero.