From patchwork Fri Dec 15 16:42:57 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Detlev Casanova X-Patchwork-Id: 179410 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:3b04:b0:fb:cd0c:d3e with SMTP id c4csp9412850dys; Fri, 15 Dec 2023 08:46:14 -0800 (PST) X-Google-Smtp-Source: AGHT+IElKmWaKmSuzL4OCOUOxYOm7NjHa7yY3hxz4a/GQbHiUKoCjI5hQJ+NdZ1qJx9ObO7Jxji7 X-Received: by 2002:a50:c305:0:b0:552:d277:3c12 with SMTP id a5-20020a50c305000000b00552d2773c12mr592524edb.54.1702658774588; Fri, 15 Dec 2023 08:46:14 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1702658774; cv=none; d=google.com; s=arc-20160816; b=CW50b4tP743u0xstkY2uGfsluLoEOG1CeKHWLV8wRI7BenX1UhLl8CD0Iqq5lwDVhV X2qYT3x3a9K3KYOtSCzwObHj0xaQjqaNwvYlDOmv0sD35y2AiBE2LIHyTb7oKpDUP8VN uNM485uq1uc85GI173qy9ojl/LZ9eXDWqHoclb5AC6LP9xP5Dzkm0FSAp8byiTccFjFM K95tkDLY/PN2Ylv9yxmndNvcfZSinEMjfaFb0S3ByuLIjadpY49ycmgO0db3e4zNA0Pe DlUME0ZpaJRwBK46Hd0NBVlgIgDHxoST8RX2I4oU9imkuUO/fDg30OEdNSenetutvIQ0 Zkxw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=I7P6Vh+qrwZi4CvxU/6iMuIraOWeLwr00/Sl6uQAn0c=; fh=bEUUkxCtcWAoM+0QUmhtNDixjAfHmPTjnsrsFCDjYhU=; b=IKR2zXFF7H4MwXfZELCQiyBLcJ3l+wA//+3swaixP5Pl5JUp2OjNPcg+Z3Sq/cgFXh s1IUnIqLXFYHimxtmSzNtNW4d5Zi1fw1hvBNAPUQPhV6xvTbEUTWuIep+8F+0J7yedW8 UUeA7EnOgYMcGtRUyT05DfB3Meaf9VSJh2Fja9MQTe2mmbKsfWpXlEdUuYygVIQLdriD 3Z8WqWDE5LD2WgPvdFsifjfSeQgVU5Cl6DU6dTF5MZItnGhcaw7kZnD2SL/jJJ2PhngP 9dQiEbKNZyv2DRAMfkTuDt/s7OmBcwYez+hb6Vi6Yjmij6nsi3Cx4cPn9aFV4/I2tccB LDew== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=mWcd45+X; spf=pass (google.com: domain of linux-kernel+bounces-1322-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-1322-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id z12-20020a05640235cc00b0054c9262d892si7946878edc.39.2023.12.15.08.46.14 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Dec 2023 08:46:14 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-1322-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=mWcd45+X; spf=pass (google.com: domain of linux-kernel+bounces-1322-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-1322-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id 297401F234E6 for ; Fri, 15 Dec 2023 16:46:14 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 5BD6541853; Fri, 15 Dec 2023 16:45:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=collabora.com header.i=@collabora.com header.b="mWcd45+X" X-Original-To: linux-kernel@vger.kernel.org Received: from madrid.collaboradmins.com (madrid.collaboradmins.com [46.235.227.194]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4DC593DBA7; Fri, 15 Dec 2023 16:44:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=collabora.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=collabora.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1702658694; bh=Nv+IV+YSuDhGHdPzPSPBxi9UyOR7ZCJuKFQHHIDTm84=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=mWcd45+X2WTCtklfpOHASYBdIDtKwHevwVqabCmBtrtOOHZC3BoDH44B/HyuLf4Kz nIP/li997kYb9lIrU0Cm8+2SpE/mQIHRIgHWVmuhOkX5pJV8MkjxuIwZHCewd19jkq 7quH82RtplF6qubTjCJVfThcGHqanTEcj3ajVM7ieFG4zCqVBBLe1VHFzCGVhJuFoV /7Jm4q4YgUG6wK8IhUlaxSGIcOs9vTn76s/sJMqSXCvQ1tm4rWlWe0D3WX7NG+w+Sf CSydr8wcNiHYK1quojrtjQjqkXiYQDmUB65I3zQcaMpxNj3Uz8+fcKqTIzMD9jx2SH CYgphNuJ8WiAw== Received: from arisu.mtl.collabora.ca (cola.collaboradmins.com [195.201.22.229]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: detlev) by madrid.collaboradmins.com (Postfix) with ESMTPSA id 9A5A53781FE7; Fri, 15 Dec 2023 16:44:53 +0000 (UTC) From: Detlev Casanova To: linux-kernel@vger.kernel.org Cc: linux-media@vger.kernel.org, Daniel Almeida , Mauro Carvalho Chehab , Hans Verkuil , Detlev Casanova Subject: [PATCH v4 3/4] doc: visl: Document tpg_verbose parameter Date: Fri, 15 Dec 2023 11:42:57 -0500 Message-ID: <20231215164447.743787-4-detlev.casanova@collabora.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20231215164447.743787-1-detlev.casanova@collabora.com> References: <20231215164447.743787-1-detlev.casanova@collabora.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1785367127694768114 X-GMAIL-MSGID: 1785367127694768114 Also document stable frames and what it means for testing tools. Signed-off-by: Detlev Casanova --- Documentation/admin-guide/media/visl.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/Documentation/admin-guide/media/visl.rst b/Documentation/admin-guide/media/visl.rst index db1ef29438e1..cd45145cde68 100644 --- a/Documentation/admin-guide/media/visl.rst +++ b/Documentation/admin-guide/media/visl.rst @@ -49,6 +49,10 @@ Module parameters visl_dprintk_frame_start, visl_dprintk_nframes, but controls the dumping of buffer data through debugfs instead. +- tpg_verbose: Write extra information on each output frame to ease debugging + the API. When set to true, the output frames are not stable for a given input + as some information like pointers or queue status will be added to them. + What is the default use case for this driver? --------------------------------------------- @@ -57,8 +61,12 @@ This assumes that a working client is run against visl and that the ftrace and OUTPUT buffer data is subsequently used to debug a work-in-progress implementation. -Information on reference frames, their timestamps, the status of the OUTPUT and -CAPTURE queues and more can be read directly from the CAPTURE buffers. +Even though no video decoding is actually done, the output frames can be used +against a reference for a given input, except if tpg_verbose is set to true. + +Depending on the tpg_verbose parameter value, information on reference frames, +their timestamps, the status of the OUTPUT and CAPTURE queues and more can be +read directly from the CAPTURE buffers. Supported codecs ----------------