From patchwork Tue Jun 16 14:37:35 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 188043 Delivered-To: patch@linaro.org Received: by 2002:a92:cf06:0:0:0:0:0 with SMTP id c6csp3710903ilo; Tue, 16 Jun 2020 07:38:13 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxNg8QNZHk3JSNjiKpKIY7HRHX7SpK1vMt+WxLF41+e45Q1TTBYtME7M6rKBwx9pdzpVdGA X-Received: by 2002:a17:906:768e:: with SMTP id o14mr3228760ejm.497.1592318293049; Tue, 16 Jun 2020 07:38:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1592318293; cv=none; d=google.com; s=arc-20160816; b=NiOOyp0CTQ9OyEwRxF8sI8cRR5aran28LuCJMo7gC5MbBOmhbXIx2OOiGTtML9WYMS jh5Ag1pHfPozWoqzXNDg4JWkDWrXjvL6hPOOGP2UE/2orqtuws3WCqAcFQ36hblKm3D3 kcicWuRT8j/mQy2zdRQS5m1LFqu41HHbNbXDyJaEG+5X8yFtdWR9bdN3fds+DfA3Oc2u xFhznDOEExVRxLNeL6Bi4N+tSM/x0SbLFcGb4cdOez8VrlCZruXo2WYvwwSnt9daaecV 6SNahHkn89DXsUUiMw+wCBHwbqLOXfEg324gOIPTjEKMZxoMfu50YpCyA7mGZt35HlVa u7Lw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :dkim-signature; bh=I0NvXcxMumO5ln1pcxq8IrXZMMunSbwaH93Ozqoo2qY=; b=ILIfVxMp27nVTZ4dQ0vvK+tjxa+2nn1UdypOmD2pvh35Pq/r7nqb/rRgIEHZ4V65Lw nknQQMHwDCHHKvtk3xneBFHsNn/+8NcJwc2FKf0ZYvyRmLAqbjl7Ec/Nza/j+X+TRZBM gqae0f6MpuTrI7lrSbimxIkEGaZhlaVj70q/ncR3+h7i3tODUU2zKvF1ss/Up+QLd+/J heTsT2wd6GUhD3oUXJs5Fdso9XuaJm+Lp7yvrWfab9AFbpzPDlKL/R28drBCywALNt8C 3bkOBAxORs0nKh5qjE2ySd5UlDcq4rfBa479ylJTq+O7sVRCDrnP2/C3HNpB0LT5JSgw GIUw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=D6KvstmS; spf=pass (google.com: domain of linux-media-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-media-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id c10si2969646ejr.522.2020.06.16.07.38.12; Tue, 16 Jun 2020 07:38:13 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-media-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=D6KvstmS; spf=pass (google.com: domain of linux-media-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-media-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728928AbgFPOiK (ORCPT + 4 others); Tue, 16 Jun 2020 10:38:10 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35728 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727804AbgFPOiK (ORCPT ); Tue, 16 Jun 2020 10:38:10 -0400 Received: from mail-ej1-x62b.google.com (mail-ej1-x62b.google.com [IPv6:2a00:1450:4864:20::62b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AC256C06174E for ; Tue, 16 Jun 2020 07:38:09 -0700 (PDT) Received: by mail-ej1-x62b.google.com with SMTP id y13so21781961eju.2 for ; Tue, 16 Jun 2020 07:38:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=I0NvXcxMumO5ln1pcxq8IrXZMMunSbwaH93Ozqoo2qY=; b=D6KvstmSk0YXD0i8uqQdJ61DWUBsCQ27FLB+4FCQRrzhNH+ZCO/wpDxjf7p3BFownW lbmzCSOQpb1IgDGdLNO+U6TQPRAKTYDp3651rvcsLKGWrWunKUKQ8OplQwTTJBzvNY9N hLB2WbtoAVTnYXI4iVoPrH+9agYQ1yRbPiS3PnVQXWRXOmUy5iqOfuRlbb6dgb/NFdFJ llMTwyoip/IQJZ9lqIzC9ZOY/nqmfKBuTfBiPo1cR27g8b4c8yx4Jm+1p9ZPlwpbCPa+ emEwIbYV0iHCJGf/Jwo7xUX0ES4VFzi7MCKZs0R/pUsN+1hSl2PxkOtJXBYNXUsTZ1Ft fVeQ== 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; bh=I0NvXcxMumO5ln1pcxq8IrXZMMunSbwaH93Ozqoo2qY=; b=DUdQ35RzOXc9d1xos494KhS6m4Oem8qXsWOpn80/29HrV6pmwpshB8PYtzN+Awfick sot6W4ccU78B3g8FxkcV82f+1dHqlfvjqf29Q7BH+xx/f6TUtBKpO7bZBboF1Thotnd3 j10ySXVY9LjRz1Cl+L6+n0CBBohOWtaFA4RtgZhXV8/tNRmvug0xhVj6HUQJRiHt1Efy jIT5F4asBOFB7pl6xQG9ZpqZ1fbACdqBCwaJFeSL8MHGpA4fRAWqFVCNfQMtlD7pYrWi 6r6HqdGQPnYVMZH2OpBC3IWxjmBHuH35oJbYRCwY74wsdZ4/8n7FtpH6S4JXU6sx1QpB fKGA== X-Gm-Message-State: AOAM532c2Ux9VkBrEzsbXLAY8sHvECFGL2bMbONVUsqN2nHXNcbm64bI 4Ms0OuktePPa2grpwbPR5Zpb/vj2i+0a8w== X-Received: by 2002:a17:906:cd06:: with SMTP id oz6mr3246023ejb.434.1592318287131; Tue, 16 Jun 2020 07:38:07 -0700 (PDT) Received: from localhost.localdomain (212-5-158-38.ip.btc-net.bg. [212.5.158.38]) by smtp.gmail.com with ESMTPSA id a8sm10163348edb.29.2020.06.16.07.38.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jun 2020 07:38:06 -0700 (PDT) From: Stanimir Varbanov To: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Hans Verkuil , Tomasz Figa , Mauro Carvalho Chehab , Stanimir Varbanov Subject: [PATCH] docs: dev-decoder: Add one more reason for dynamic change Date: Tue, 16 Jun 2020 17:37:35 +0300 Message-Id: <20200616143735.21766-1-stanimir.varbanov@linaro.org> X-Mailer: git-send-email 2.17.1 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Add bit-depth change as one more reason which could change in the middle of the stream. For the worst case the stream is 8bit at the beginning but later in the bit-stream it changes to 10bit. That change should be propagated to the client so that it can take the appropriate action. In that case it has to stop the streaming on the capture queue, re-negotiate the pixel format, allocate new buffers and start the streaming again. Signed-off-by: Stanimir Varbanov --- Documentation/userspace-api/media/v4l/dev-decoder.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) -- 2.17.1 diff --git a/Documentation/userspace-api/media/v4l/dev-decoder.rst b/Documentation/userspace-api/media/v4l/dev-decoder.rst index 606b54947e10..45b31262f360 100644 --- a/Documentation/userspace-api/media/v4l/dev-decoder.rst +++ b/Documentation/userspace-api/media/v4l/dev-decoder.rst @@ -906,7 +906,9 @@ reflected by corresponding queries): * visible resolution (selection rectangles), -* the minimum number of buffers needed for decoding. +* the minimum number of buffers needed for decoding, + +* bit-depth of the bitstream has been changed. Whenever that happens, the decoder must proceed as follows: